@canaryai/cli 0.2.8 → 0.2.12

package/dist/mcp-ZF5G5DCB.js

@@ -0,0 +1,377 @@
+import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
+import {
+  LocalBrowserHost
+} from "./chunk-Q7WFBG5C.js";
+import {
+  callTool,
+  createSession,
+  deleteAllSessions,
+  deleteSession,
+  resolveTargetSession
+} from "./chunk-CEW4BDXD.js";
+import {
+  readStoredToken
+} from "./chunk-PWWQGYFG.js";
+import {
+  getBrowserToolDefinitionsWithLifecycle
+} from "./chunk-MSMC6UXW.js";
+import "./chunk-XAA5VQ5N.js";
+import "./chunk-P5Z2Y5VV.js";
+import "./chunk-VKVL7WBN.js";
+
+// src/mcp/index.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+
+// src/mcp/tool-helpers.ts
+function toolText(text) {
+  return { content: [{ type: "text", text }] };
+}
+function toolJson(data) {
+  return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+function formatMCPContent(result) {
+  if (typeof result === "string") {
+    return { content: [{ type: "text", text: result }] };
+  }
+  const content = [];
+  if (result.text) {
+    content.push({ type: "text", text: result.text });
+  }
+  for (const img of result.images ?? []) {
+    content.push({ type: "image", data: img.data, mimeType: img.mimeType });
+  }
+  return { content };
+}
+
+// src/mcp/session-tools.ts
+import process from "process";
+var browserSessions = /* @__PURE__ */ new Map();
+var DEFAULT_API_URL = "https://api.trycanary.ai";
+function resolveApiUrl(input) {
+  return input ?? process.env.CANARY_API_URL ?? DEFAULT_API_URL;
+}
+async function resolveToken() {
+  const token = process.env.CANARY_API_TOKEN ?? await readStoredToken();
+  if (!token) {
+    throw new Error("Missing token. Run `canary login` first or set CANARY_API_TOKEN.");
+  }
+  return token;
+}
+function getSessionToolDefinitions() {
+  return [
+    {
+      name: "local_browser_start",
+      description: "Start a local browser session that connects to the cloud agent. The cloud agent can then control this browser to test local applications. Returns sessionId for tracking.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          mode: {
+            type: "string",
+            enum: ["playwright", "cdp"],
+            description: "Browser mode: 'playwright' for fresh browser, 'cdp' to connect to existing Chrome"
+          },
+          cdpUrl: {
+            type: "string",
+            description: "CDP endpoint URL when mode is 'cdp' (e.g. http://localhost:9222)"
+          },
+          headless: {
+            type: "boolean",
+            description: "Run browser headless (default: true for playwright mode)"
+          },
+          storageStatePath: {
+            type: "string",
+            description: "Path to Playwright storage state JSON for pre-authenticated sessions"
+          },
+          instructions: {
+            type: "string",
+            description: "Instructions for the cloud agent on what to test"
+          }
+        }
+      }
+    },
+    {
+      name: "local_browser_status",
+      description: "Check the status of a local browser session.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          sessionId: { type: "string" }
+        },
+        required: ["sessionId"]
+      }
+    },
+    {
+      name: "local_browser_stop",
+      description: "Stop a local browser session and close the browser.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          sessionId: { type: "string" }
+        },
+        required: ["sessionId"]
+      }
+    },
+    {
+      name: "local_browser_list",
+      description: "List all active local browser sessions.",
+      inputSchema: {
+        type: "object",
+        properties: {}
+      }
+    },
+    {
+      name: "local_browser_run",
+      description: "Start a test run on an active local browser session. The cloud agent will control the local browser according to the instructions.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          sessionId: {
+            type: "string",
+            description: "The session ID from local_browser_start"
+          },
+          instructions: {
+            type: "string",
+            description: "Instructions for the cloud agent on what to test"
+          },
+          startUrl: {
+            type: "string",
+            description: "Optional URL to navigate to before starting"
+          }
+        },
+        required: ["sessionId", "instructions"]
+      }
+    }
+  ];
+}
+async function handleSessionTool(tool, args) {
+  const token = await resolveToken();
+  if (tool === "local_browser_start") {
+    const input = args;
+    const apiUrl = resolveApiUrl();
+    const mode = input.mode ?? "playwright";
+    const sessionResponse = await fetch(`${apiUrl}/local-browser/sessions`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${token}`
+      },
+      body: JSON.stringify({
+        browserMode: mode,
+        instructions: input.instructions ?? null
+      })
+    });
+    if (!sessionResponse.ok) {
+      const text = await sessionResponse.text();
+      return toolJson({ ok: false, error: `Failed to create session: ${text}` });
+    }
+    const session = await sessionResponse.json();
+    const host = new LocalBrowserHost({
+      apiUrl,
+      wsToken: session.wsToken,
+      sessionId: session.sessionId,
+      browserMode: mode,
+      cdpUrl: input.cdpUrl,
+      headless: input.headless ?? true,
+      storageStatePath: input.storageStatePath,
+      onLog: (level, message) => {
+        if (level === "error") {
+          console.error(`[LocalBrowser] ${message}`);
+        }
+      }
+    });
+    host.start().catch((err) => {
+      console.error("Failed to start local browser:", err);
+      browserSessions.delete(session.sessionId);
+    });
+    browserSessions.set(session.sessionId, {
+      sessionId: session.sessionId,
+      host,
+      startedAt: Date.now(),
+      mode
+    });
+    return toolJson({
+      ok: true,
+      sessionId: session.sessionId,
+      mode,
+      expiresAt: session.expiresAt,
+      note: "Browser session started. The cloud agent can now control this browser. Use local_browser_stop to end the session."
+    });
+  }
+  if (tool === "local_browser_status") {
+    const input = args;
+    const session = browserSessions.get(input.sessionId);
+    if (!session) {
+      return toolJson({ ok: false, error: "Session not found", sessionId: input.sessionId });
+    }
+    return toolJson({
+      ok: true,
+      sessionId: session.sessionId,
+      mode: session.mode,
+      startedAt: new Date(session.startedAt).toISOString(),
+      uptimeMs: Date.now() - session.startedAt
+    });
+  }
+  if (tool === "local_browser_stop") {
+    const input = args;
+    const session = browserSessions.get(input.sessionId);
+    if (!session) {
+      return toolJson({ ok: false, error: "Session not found", sessionId: input.sessionId });
+    }
+    await session.host.stop();
+    browserSessions.delete(input.sessionId);
+    return toolJson({
+      ok: true,
+      sessionId: input.sessionId,
+      note: "Browser session stopped and browser closed."
+    });
+  }
+  if (tool === "local_browser_list") {
+    const sessions = Array.from(browserSessions.values()).map((s) => ({
+      sessionId: s.sessionId,
+      mode: s.mode,
+      startedAt: new Date(s.startedAt).toISOString(),
+      uptimeMs: Date.now() - s.startedAt
+    }));
+    return toolJson({
+      ok: true,
+      count: sessions.length,
+      sessions
+    });
+  }
+  if (tool === "local_browser_run") {
+    const input = args;
+    const apiUrl = resolveApiUrl();
+    const session = browserSessions.get(input.sessionId);
+    if (!session) {
+      return toolJson({
+        ok: false,
+        error: "Session not found locally. Make sure you started it with local_browser_start.",
+        sessionId: input.sessionId
+      });
+    }
+    const response = await fetch(`${apiUrl}/local-browser/sessions/${input.sessionId}/run`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${token}`
+      },
+      body: JSON.stringify({
+        instructions: input.instructions,
+        startUrl: input.startUrl ?? null
+      })
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      return toolJson({ ok: false, error: `Failed to start run: ${text}` });
+    }
+    const result = await response.json();
+    return toolJson({
+      ok: true,
+      jobId: result.jobId,
+      sessionId: result.sessionId,
+      note: "Test run started. The cloud agent is now controlling your local browser. You can watch the browser to see the test in action."
+    });
+  }
+  return null;
+}
+
+// src/mcp/browser-tools.ts
+var activeSessionId = null;
+function getBrowserMCPToolDefinitions() {
+  return getBrowserToolDefinitionsWithLifecycle();
+}
+async function handleBrowserTool(name, args) {
+  if (name === "browser_start") {
+    try {
+      const result = await createSession({
+        headless: args.headless ?? false,
+        storageStatePath: args.storageStatePath
+      });
+      if (!result.ok) {
+        return toolJson({ ok: false, error: result.error });
+      }
+      activeSessionId = result.data.id;
+      return toolJson({
+        ok: true,
+        sessionId: activeSessionId,
+        note: "Browser started. You can now use browser_navigate, browser_click, and other browser tools."
+      });
+    } catch (err) {
+      return toolJson({ ok: false, error: err instanceof Error ? err.message : String(err) });
+    }
+  }
+  if (name === "browser_stop") {
+    try {
+      if (activeSessionId) {
+        await deleteSession(activeSessionId);
+        activeSessionId = null;
+      } else {
+        await deleteAllSessions();
+      }
+      return toolJson({ ok: true, note: "Browser stopped and cleaned up." });
+    } catch (err) {
+      return toolJson({ ok: false, error: err instanceof Error ? err.message : String(err) });
+    }
+  }
+  if (!name.startsWith("browser_")) return null;
+  try {
+    let sessionId = activeSessionId;
+    if (!sessionId) {
+      try {
+        const target = await resolveTargetSession();
+        sessionId = target.id;
+        activeSessionId = sessionId;
+      } catch {
+        return toolJson({
+          ok: false,
+          error: "No active browser session. Start one with browser_start first."
+        });
+      }
+    }
+    const toolName = name.replace(/^browser_/, "");
+    const result = await callTool(sessionId, toolName, args);
+    if (!result.ok) {
+      if (result.error?.includes("not found")) {
+        activeSessionId = null;
+      }
+      return toolJson({ ok: false, error: result.error, tool: name });
+    }
+    const toolResult = result.images?.length ? { text: result.text ?? "", images: result.images } : result.text ?? "";
+    return formatMCPContent(toolResult);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return toolJson({ ok: false, error: message, tool: name });
+  }
+}
+
+// src/mcp/index.ts
+async function runMcp(argv) {
+  const server = new Server(
+    { name: "canary-cli", version: "0.1.0" },
+    { capabilities: { tools: {} } }
+  );
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+      ...getSessionToolDefinitions(),
+      ...getBrowserMCPToolDefinitions()
+    ]
+  }));
+  server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const tool = req.params.name;
+    const args = req.params.arguments ?? {};
+    const browserResult = await handleBrowserTool(tool, args);
+    if (browserResult) return browserResult;
+    const sessionResult = await handleSessionTool(tool, args);
+    if (sessionResult) return sessionResult;
+    return toolText(`Unknown tool: ${tool}`);
+  });
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  return new Promise(() => void 0);
+}
+export {
+  runMcp
+};
+//# sourceMappingURL=mcp-ZF5G5DCB.js.map

package/dist/mcp-ZF5G5DCB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp/index.ts","../src/mcp/tool-helpers.ts","../src/mcp/session-tools.ts","../src/mcp/browser-tools.ts"],"sourcesContent":["/**\n * MCP Server for Canary CLI.\n *\n * Combines cloud-relay session tools and direct browser tools\n * into a single MCP server.\n *\n * @module\n */\n\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';\nimport { toolText } from './tool-helpers';\nimport { getSessionToolDefinitions, handleSessionTool } from './session-tools';\nimport { getBrowserMCPToolDefinitions, handleBrowserTool } from './browser-tools';\n\nexport async function runMcp(argv: string[]) {\n  const server = new Server(\n    { name: 'canary-cli', version: '0.1.0' },\n    { capabilities: { tools: {} } }\n  );\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: [\n      ...getSessionToolDefinitions(),\n      ...getBrowserMCPToolDefinitions(),\n    ],\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (req) => {\n    const tool = req.params.name;\n    const args = (req.params.arguments ?? {}) as Record<string, unknown>;\n\n    // Try browser tools first (browser_* prefix)\n    const browserResult = await handleBrowserTool(tool, args);\n    if (browserResult) return browserResult;\n\n    // Try session tools (local_* prefix)\n    const sessionResult = await handleSessionTool(tool, args);\n    if (sessionResult) return sessionResult;\n\n    return toolText(`Unknown tool: ${tool}`);\n  });\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n  return new Promise<void>(() => undefined);\n}\n","/**\n * MCP tool response helpers.\n *\n * @module\n */\n\nimport type { ToolResult } from '@chatsdet/browser-core';\n\nexport function toolText(text: string) {\n  return { content: [{ type: 'text' as const, text }] };\n}\n\nexport function toolJson(data: unknown) {\n  return { content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }] };\n}\n\n/**\n * Convert a BrowserToolExecutor result to MCP SDK content blocks.\n */\nexport function formatMCPContent(result: ToolResult) {\n  if (typeof result === 'string') {\n    return { content: [{ type: 'text' as const, text: result }] };\n  }\n\n  // MCPContentResult with text and optional images\n  const content: Array<{ type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string }> = [];\n\n  if (result.text) {\n    content.push({ type: 'text', text: result.text });\n  }\n\n  for (const img of result.images ?? []) {\n    content.push({ type: 'image', data: img.data, mimeType: img.mimeType });\n  }\n\n  return { content };\n}\n","/**\n * Cloud-relay session tools for the MCP server.\n *\n * These tools proxy browser control through the cloud API via WebSocket.\n *\n * @module\n */\n\nimport { readStoredToken } from '../auth';\nimport { LocalBrowserHost } from '../local-browser/host';\nimport type { LocalBrowserMode } from '../local-browser/protocol';\nimport { toolText, toolJson } from './tool-helpers';\n\nimport process from 'node:process';\n\ntype LocalBrowserStartInput = {\n  mode?: LocalBrowserMode;\n  cdpUrl?: string;\n  headless?: boolean;\n  storageStatePath?: string;\n  instructions?: string;\n};\n\ntype LocalBrowserStopInput = {\n  sessionId: string;\n};\n\ntype LocalBrowserStatusInput = {\n  sessionId: string;\n};\n\ninterface BrowserSession {\n  sessionId: string;\n  host: LocalBrowserHost;\n  startedAt: number;\n  mode: LocalBrowserMode;\n}\n\n// Global browser sessions managed by MCP\nconst browserSessions = new Map<string, BrowserSession>();\n\nconst DEFAULT_API_URL = 'https://api.trycanary.ai';\n\nfunction resolveApiUrl(input?: string): string {\n  return input ?? process.env.CANARY_API_URL ?? DEFAULT_API_URL;\n}\n\nasync function resolveToken(): Promise<string> {\n  const token = process.env.CANARY_API_TOKEN ?? (await readStoredToken());\n  if (!token) {\n    throw new Error('Missing token. Run `canary login` first or set CANARY_API_TOKEN.');\n  }\n  return token;\n}\n\nexport function getSessionToolDefinitions() {\n  return [\n    {\n      name: 'local_browser_start',\n      description:\n        'Start a local browser session that connects to the cloud agent. The cloud agent can then control this browser to test local applications. Returns sessionId for tracking.',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          mode: {\n            type: 'string',\n            enum: ['playwright', 'cdp'],\n            description: \"Browser mode: 'playwright' for fresh browser, 'cdp' to connect to existing Chrome\",\n          },\n          cdpUrl: {\n            type: 'string',\n            description: 'CDP endpoint URL when mode is \\'cdp\\' (e.g. http://localhost:9222)',\n          },\n          headless: {\n            type: 'boolean',\n            description: 'Run browser headless (default: true for playwright mode)',\n          },\n          storageStatePath: {\n            type: 'string',\n            description: 'Path to Playwright storage state JSON for pre-authenticated sessions',\n          },\n          instructions: {\n            type: 'string',\n            description: 'Instructions for the cloud agent on what to test',\n          },\n        },\n      },\n    },\n    {\n      name: 'local_browser_status',\n      description: 'Check the status of a local browser session.',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          sessionId: { type: 'string' },\n        },\n        required: ['sessionId'],\n      },\n    },\n    {\n      name: 'local_browser_stop',\n      description: 'Stop a local browser session and close the browser.',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          sessionId: { type: 'string' },\n        },\n        required: ['sessionId'],\n      },\n    },\n    {\n      name: 'local_browser_list',\n      description: 'List all active local browser sessions.',\n      inputSchema: {\n        type: 'object',\n        properties: {},\n      },\n    },\n    {\n      name: 'local_browser_run',\n      description:\n        'Start a test run on an active local browser session. The cloud agent will control the local browser according to the instructions.',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          sessionId: {\n            type: 'string',\n            description: 'The session ID from local_browser_start',\n          },\n          instructions: {\n            type: 'string',\n            description: 'Instructions for the cloud agent on what to test',\n          },\n          startUrl: {\n            type: 'string',\n            description: 'Optional URL to navigate to before starting',\n          },\n        },\n        required: ['sessionId', 'instructions'],\n      },\n    },\n  ];\n}\n\nexport async function handleSessionTool(tool: string, args: Record<string, unknown>) {\n  const token = await resolveToken();\n\n  if (tool === 'local_browser_start') {\n    const input = args as unknown as LocalBrowserStartInput;\n    const apiUrl = resolveApiUrl();\n    const mode = input.mode ?? 'playwright';\n\n    const sessionResponse = await fetch(`${apiUrl}/local-browser/sessions`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${token}`,\n      },\n      body: JSON.stringify({\n        browserMode: mode,\n        instructions: input.instructions ?? null,\n      }),\n    });\n\n    if (!sessionResponse.ok) {\n      const text = await sessionResponse.text();\n      return toolJson({ ok: false, error: `Failed to create session: ${text}` });\n    }\n\n    const session = (await sessionResponse.json()) as {\n      ok: boolean;\n      sessionId: string;\n      wsToken: string;\n      expiresAt: string;\n    };\n\n    const host = new LocalBrowserHost({\n      apiUrl,\n      wsToken: session.wsToken,\n      sessionId: session.sessionId,\n      browserMode: mode,\n      cdpUrl: input.cdpUrl,\n      headless: input.headless ?? true,\n      storageStatePath: input.storageStatePath,\n      onLog: (level, message) => {\n        if (level === 'error') {\n          console.error(`[LocalBrowser] ${message}`);\n        }\n      },\n    });\n\n    host.start().catch((err) => {\n      console.error('Failed to start local browser:', err);\n      browserSessions.delete(session.sessionId);\n    });\n\n    browserSessions.set(session.sessionId, {\n      sessionId: session.sessionId,\n      host,\n      startedAt: Date.now(),\n      mode,\n    });\n\n    return toolJson({\n      ok: true,\n      sessionId: session.sessionId,\n      mode,\n      expiresAt: session.expiresAt,\n      note: 'Browser session started. The cloud agent can now control this browser. Use local_browser_stop to end the session.',\n    });\n  }\n\n  if (tool === 'local_browser_status') {\n    const input = args as unknown as LocalBrowserStatusInput;\n    const session = browserSessions.get(input.sessionId);\n\n    if (!session) {\n      return toolJson({ ok: false, error: 'Session not found', sessionId: input.sessionId });\n    }\n\n    return toolJson({\n      ok: true,\n      sessionId: session.sessionId,\n      mode: session.mode,\n      startedAt: new Date(session.startedAt).toISOString(),\n      uptimeMs: Date.now() - session.startedAt,\n    });\n  }\n\n  if (tool === 'local_browser_stop') {\n    const input = args as unknown as LocalBrowserStopInput;\n    const session = browserSessions.get(input.sessionId);\n\n    if (!session) {\n      return toolJson({ ok: false, error: 'Session not found', sessionId: input.sessionId });\n    }\n\n    await session.host.stop();\n    browserSessions.delete(input.sessionId);\n\n    return toolJson({\n      ok: true,\n      sessionId: input.sessionId,\n      note: 'Browser session stopped and browser closed.',\n    });\n  }\n\n  if (tool === 'local_browser_list') {\n    const sessions = Array.from(browserSessions.values()).map((s) => ({\n      sessionId: s.sessionId,\n      mode: s.mode,\n      startedAt: new Date(s.startedAt).toISOString(),\n      uptimeMs: Date.now() - s.startedAt,\n    }));\n\n    return toolJson({\n      ok: true,\n      count: sessions.length,\n      sessions,\n    });\n  }\n\n  if (tool === 'local_browser_run') {\n    const input = args as unknown as {\n      sessionId: string;\n      instructions: string;\n      startUrl?: string;\n    };\n    const apiUrl = resolveApiUrl();\n\n    const session = browserSessions.get(input.sessionId);\n    if (!session) {\n      return toolJson({\n        ok: false,\n        error: 'Session not found locally. Make sure you started it with local_browser_start.',\n        sessionId: input.sessionId,\n      });\n    }\n\n    const response = await fetch(`${apiUrl}/local-browser/sessions/${input.sessionId}/run`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${token}`,\n      },\n      body: JSON.stringify({\n        instructions: input.instructions,\n        startUrl: input.startUrl ?? null,\n      }),\n    });\n\n    if (!response.ok) {\n      const text = await response.text();\n      return toolJson({ ok: false, error: `Failed to start run: ${text}` });\n    }\n\n    const result = (await response.json()) as { ok: boolean; jobId: string; sessionId: string };\n\n    return toolJson({\n      ok: true,\n      jobId: result.jobId,\n      sessionId: result.sessionId,\n      note: 'Test run started. The cloud agent is now controlling your local browser. You can watch the browser to see the test in action.',\n    });\n  }\n\n  return null; // Not handled\n}\n","/**\n * Browser MCP tool registration — daemon adapter.\n *\n * Thin layer that maps MCP tool calls to the session daemon,\n * ensuring the CLI gets the SAME semantic diff, snapshot formatting,\n * click validation, auto-snapshot, and recovery notices as the cloud agent.\n *\n * The daemon owns all browser sessions. MCP is just a protocol adapter.\n *\n * @module\n */\n\nimport { getBrowserToolDefinitionsWithLifecycle } from '@chatsdet/browser-core';\nimport {\n  createSession,\n  deleteSession,\n  deleteAllSessions,\n  callTool,\n  resolveTargetSession,\n  listSessions,\n} from '../session/daemon-client.js';\nimport { formatMCPContent, toolJson } from './tool-helpers';\nimport type { ToolResult } from '@chatsdet/browser-core';\n\n/** Track the active session ID within this MCP server instance */\nlet activeSessionId: string | null = null;\n\n/**\n * Get tool definitions for browser MCP tools (including lifecycle).\n */\nexport function getBrowserMCPToolDefinitions() {\n  return getBrowserToolDefinitionsWithLifecycle();\n}\n\n/**\n * Handle a browser tool call.\n * Returns null if the tool name is not a browser tool.\n */\nexport async function handleBrowserTool(name: string, args: Record<string, unknown>) {\n  // Lifecycle tools\n  if (name === 'browser_start') {\n    try {\n      const result = await createSession({\n        headless: (args.headless as boolean) ?? false,\n        storageStatePath: args.storageStatePath as string | undefined,\n      });\n\n      if (!result.ok) {\n        return toolJson({ ok: false, error: result.error });\n      }\n\n      activeSessionId = result.data!.id;\n      return toolJson({\n        ok: true,\n        sessionId: activeSessionId,\n        note: 'Browser started. You can now use browser_navigate, browser_click, and other browser tools.',\n      });\n    } catch (err) {\n      return toolJson({ ok: false, error: err instanceof Error ? err.message : String(err) });\n    }\n  }\n\n  if (name === 'browser_stop') {\n    try {\n      if (activeSessionId) {\n        await deleteSession(activeSessionId);\n        activeSessionId = null;\n      } else {\n        // Stop all sessions if no specific one tracked\n        await deleteAllSessions();\n      }\n      return toolJson({ ok: true, note: 'Browser stopped and cleaned up.' });\n    } catch (err) {\n      return toolJson({ ok: false, error: err instanceof Error ? err.message : String(err) });\n    }\n  }\n\n  // All other browser_* tools require an active session\n  if (!name.startsWith('browser_')) return null;\n\n  try {\n    // Resolve target session: prefer tracked MCP session, then auto-resolve\n    let sessionId = activeSessionId;\n    if (!sessionId) {\n      try {\n        const target = await resolveTargetSession();\n        sessionId = target.id;\n        activeSessionId = sessionId;\n      } catch {\n        return toolJson({\n          ok: false,\n          error: 'No active browser session. Start one with browser_start first.',\n        });\n      }\n    }\n\n    // Strip 'browser_' prefix for the daemon tool name\n    const toolName = name.replace(/^browser_/, '');\n    const result = await callTool(sessionId, toolName, args);\n\n    if (!result.ok) {\n      // If session not found, clear tracking and report error\n      if (result.error?.includes('not found')) {\n        activeSessionId = null;\n      }\n      return toolJson({ ok: false, error: result.error, tool: name });\n    }\n\n    // Convert daemon response back to ToolResult format for MCP formatting\n    const toolResult: ToolResult = result.images?.length\n      ? { text: result.text ?? '', images: result.images }\n      : result.text ?? '';\n\n    return formatMCPContent(toolResult);\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    return toolJson({ ok: false, error: message, tool: name });\n  }\n}\n"],"mappings":"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","names":[]}