Pilot

Instructions

Implementation Reference

• src/tools/settings.ts:174-187 (handler)

  Implementation of the 'pilot_handoff' tool handler. It calls `bm.handoff()` to open a visible browser.

  server.tool(
    'pilot_handoff',
    'Open a visible (headed) Chrome window with all current state — cookies, tabs, localStorage. Use when headless mode is blocked by CAPTCHAs, bot detection, or complex auth. The user can solve it manually, then call pilot_resume to continue.',
    {},
    async () => {
      await bm.ensureBrowser();
      try {
        const result = await bm.handoff();
        return { content: [{ type: 'text' as const, text: result }] };
      } catch (err) {
        return { content: [{ type: 'text' as const, text: wrapError(err) }], isError: true };
      }
    }
  );