Method execute

src/tools/browser/tools.ts:321–345

(args: z.infer<typeof WaitForArgs>, _ctx: ToolContext)

  argsSchema = WaitForArgs;

  async execute(args: z.infer<typeof WaitForArgs>, _ctx: ToolContext): Promise<ToolResult> {
    try {
      const s = await getSession();
      const timeout = args.timeout_ms ?? 10_000;
      if (args.kind === 'selector') {
        if (!args.value) return { content: '[BROWSER_ERROR] selector kind requires `value`', isError: true };
        await s.page.waitForSelector(args.value, { timeout });
        return { content: `Selector visible: ${args.value}` };
      } else if (args.kind === 'url') {
        if (!args.value) return { content: '[BROWSER_ERROR] url kind requires `value`', isError: true };
        await s.page.waitForURL(args.value, { timeout });
        return { content: `URL matched: ${s.page.url()}` };
      } else if (args.kind === 'networkidle') {
        await s.page.waitForLoadState('networkidle', { timeout });
        return { content: 'Network idle reached' };
      } else if (args.kind === 'function') {
        if (!args.value) return { content: '[BROWSER_ERROR] function kind requires `value`', isError: true };
        await s.page.waitForFunction(args.value, undefined, { timeout });
        return { content: `Predicate satisfied: ${args.value.slice(0, 80)}` };
      }
      return { content: '[BROWSER_ERROR] unknown wait kind', isError: true };
    } catch (e: any) {
      return { content: `[BROWSER_ERROR] wait_for failed: ${e?.message ?? String(e)}`, isError: true };
    }
  }
}

const CloseArgs = z.object({});