Method execute

src/tools/browser/tools.ts:49–115

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

  argsSchema = NavigateArgs;

  async execute(args: z.infer<typeof NavigateArgs>, _ctx: ToolContext): Promise<ToolResult> {
    const waitUntil = args.wait_until ?? 'domcontentloaded';
    const timeout = args.timeout_ms ?? 30_000;
    const s = await getSession();
    clearBuffers(s);

    // Try the navigation. Catch Playwright's TimeoutError and fall through to a
    // best-effort recovery — many real pages never finish according to `load`
    // (trackers, analytics, prefetch beacons), and even `domcontentloaded` can
    // hang on giant SPAs. The user almost always prefers a partial render they
    // can inspect over a hard error.
    let status: number | undefined;
    let timedOut = false;
    let phaseError: string | undefined;
    try {
      const r = await s.page.goto(args.url, { waitUntil, timeout });
      status = r?.status();
    } catch (e: any) {
      const msg = e?.message ?? String(e);
      const isTimeout =
        e?.name === 'TimeoutError' ||
        /Timeout \d+ms exceeded/i.test(msg) ||
        /navigation timeout/i.test(msg);
      if (!isTimeout) {
        return { content: `[BROWSER_ERROR] navigate failed: ${msg}`, isError: true };
      }
      timedOut = true;
      phaseError = msg.split('\n')[0];
      logger.info('browser_navigate timed out; returning partial state', { url: args.url, waitUntil, timeout });
    }

    // Each accessor can itself fail if the page is in a weird state; wrap individually
    // so one failure doesn't wipe out the others.
    let title = '';
    try { title = await s.page.title(); } catch { /* keep '' */ }
    const finalUrl = (() => { try { return s.page.url(); } catch { return args.url; } })();

    let htmlSection = '';
    if (args.return_html === true || timedOut) {
      try {
        const html = await s.page.content();
        const max = 25_000;
        const slice = html.length > max
          ? html.slice(0, max) + `\n\n…[truncated, ${html.length - max} more chars]`
          : html;
        htmlSection = `\n\n--- HTML (${html.length} chars) ---\n${slice}`;
      } catch (e: any) {
        htmlSection = `\n\n--- HTML unavailable: ${e?.message ?? String(e)} ---`;
      }
    }

    const banner = timedOut
      ? `[PARTIAL_LOAD] navigation timed out after ${timeout}ms (waitUntil=${waitUntil}); returning whatever the DOM has so far. Reason: ${phaseError ?? 'timeout'}`
      : `Loaded ${finalUrl}`;

    return {
      content:
        `${banner}\n` +