Custom Actions

import { HyperAgent, AgentActionDefinition, ActionContext, ActionOutput } from "@hyperbrowser/agent";
import { z } from "zod";

const SendEmailAction: AgentActionDefinition = {
  type: "send_email",
  actionParams: z.object({
    to: z.string().describe("Email recipient address"),
    subject: z.string().describe("Email subject line"),
    body: z.string().describe("Email body content"),
  }).describe("Send an email to a specified recipient"),
  
  run: async function(
    ctx: ActionContext,
    params: { to: string; subject: string; body: string }
  ): Promise<ActionOutput> {
    // Your email sending logic here
    await sendEmail(params.to, params.subject, params.body);
    
    return {
      success: true,
      message: `Successfully sent email to ${params.to}`,
    };
  },
};

const agent = new HyperAgent({
  customActions: [SendEmailAction],
});

const result = await agent.executeTask(
  "Go to my inbox, find the latest newsletter, summarize it, and send the summary to [email protected]"
);

import Exa from "exa-js";

const exaClient = new Exa(process.env.EXA_API_KEY);

const WebSearchAction: AgentActionDefinition = {
  type: "web_search",
  actionParams: z.object({
    query: z.string().describe("Search query - keep it concise and specific"),
  }).describe("Search the web and return relevant results"),
  
  run: async function(ctx, params): Promise<ActionOutput> {
    const results = await exaClient.search(params.query, {
      numResults: 5,
    });
    
    const formatted = results.results
      .map(r => `- ${r.title}: ${r.url}`)
      .join("\n");
    
    return {
      success: true,
      message: `Search results for "${params.query}":\n${formatted}`,
    };
  },
};

const agent = new HyperAgent({
  customActions: [WebSearchAction],
});

await agent.executeTask(
  "Search for the latest news about AI and summarize the top 3 stories"
);

interface ActionContext {
  page: Page;           // Current Playwright page
  agent: HyperAgent;    // Agent instance
  taskId: string;       // Current task ID
}

const SaveScreenshotAction: AgentActionDefinition = {
  type: "save_screenshot",
  actionParams: z.object({
    filename: z.string().describe("Filename to save the screenshot as"),
  }),
  
  run: async function(ctx, params): Promise<ActionOutput> {
    await ctx.page.screenshot({ path: params.filename });
    
    return {
      success: true,
      message: `Screenshot saved to ${params.filename}`,
    };
  },
};

interface ActionOutput {
  success: boolean;  // Whether the action succeeded
  message: string;   // Result message shown to the AI
}

const agent = new HyperAgent({
  customActions: [
    WebSearchAction,
    SendEmailAction,
    SaveToNotionAction,
    SlackNotifyAction,
  ],
});

await agent.executeTask(
  "Research competitors, save findings to Notion, and notify the team on Slack"
);