mcp-scraper 0.1.9 → 0.2.0

package/dist/bin/api-server.js

@@ -17,8 +17,8 @@ loadDotEnv();
 async function main() {
   const [{ serve }, { app }, { startWorker }, { migrate }] = await Promise.all([
     import("@hono/node-server"),
-    import("../server-MTXAJG5J.js"),
-    import("../worker-AUCXFHEL.js"),
+    import("../server-ASCMKUQ5.js"),
+    import("../worker-KJ4A7WIR.js"),
     import("../db-YWCNHBLH.js")
   ]);
   const PORT = parseInt(process.env.PORT ?? "3001");

package/dist/bin/browser-agent-stdio-server.cjs

@@ -0,0 +1,314 @@
+#!/usr/bin/env node
+"use strict";
+
+// bin/browser-agent-stdio-server.ts
+var import_node_fs = require("fs");
+var import_node_os = require("os");
+var import_node_path = require("path");
+var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
+
+// src/mcp/browser-agent-mcp-server.ts
+var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+
+// src/version.ts
+var PACKAGE_VERSION = "0.2.0";
+
+// src/mcp/browser-agent-tool-schemas.ts
+var import_zod = require("zod");
+var BrowserOpenInputSchema = {
+  label: import_zod.z.string().optional().describe("Optional human label for this session, shown in the watch console."),
+  url: import_zod.z.string().url().optional().describe("Optional URL to navigate to immediately after opening."),
+  profile: import_zod.z.string().optional().describe("Optional saved profile name to load a logged-in session for a site."),
+  timeout_seconds: import_zod.z.number().int().min(60).max(259200).optional().describe("How long the session may live before auto-termination. Defaults to 600. The browser idles into a zero-cost standby between actions, so a longer timeout is cheap.")
+};
+var BrowserSessionInputSchema = {
+  session_id: import_zod.z.string().describe("The session id returned by browser_open.")
+};
+var BrowserGotoInputSchema = {
+  session_id: import_zod.z.string().describe("The session id returned by browser_open."),
+  url: import_zod.z.string().url().describe("URL to navigate the browser to.")
+};
+var BrowserClickInputSchema = {
+  session_id: import_zod.z.string().describe("The session id returned by browser_open."),
+  x: import_zod.z.number().describe("X coordinate to click, in screenshot pixels. Use the x of an element from the latest screenshot."),
+  y: import_zod.z.number().describe("Y coordinate to click, in screenshot pixels."),
+  button: import_zod.z.enum(["left", "right", "middle"]).default("left").describe("Mouse button."),
+  num_clicks: import_zod.z.number().int().min(1).max(3).optional().describe("Number of clicks, e.g. 2 for double-click.")
+};
+var BrowserTypeInputSchema = {
+  session_id: import_zod.z.string().describe("The session id returned by browser_open."),
+  text: import_zod.z.string().describe("Text to type at the current focus. Click a field first to focus it."),
+  delay: import_zod.z.number().int().min(0).max(500).optional().describe("Optional per-keystroke delay in ms for human-like typing.")
+};
+var BrowserScrollInputSchema = {
+  session_id: import_zod.z.string().describe("The session id returned by browser_open."),
+  delta_y: import_zod.z.number().default(5).describe("Vertical scroll in wheel units. Positive scrolls down, negative up."),
+  delta_x: import_zod.z.number().default(0).describe("Horizontal scroll in wheel units."),
+  x: import_zod.z.number().optional().describe("X position to scroll at. Defaults to screen center."),
+  y: import_zod.z.number().optional().describe("Y position to scroll at. Defaults to screen center.")
+};
+var BrowserPressInputSchema = {
+  session_id: import_zod.z.string().describe("The session id returned by browser_open."),
+  keys: import_zod.z.array(import_zod.z.string()).min(1).describe('Keys or combinations to press, e.g. ["Return"], ["Ctrl+a"], ["Ctrl+Shift+Tab"].')
+};
+var BrowserReplayStopInputSchema = {
+  session_id: import_zod.z.string().describe("The session id returned by browser_open."),
+  replay_id: import_zod.z.string().describe("The replay id returned by browser_replay_start.")
+};
+var BrowserListInputSchema = {
+  include_closed: import_zod.z.boolean().default(false).describe("Include closed sessions in the list.")
+};
+
+// src/mcp/browser-agent-mcp-server.ts
+function textResult(value, isError = false) {
+  return { content: [{ type: "text", text: JSON.stringify(value) }], isError };
+}
+function buildBrowserAgentMcpServer(opts) {
+  const baseUrl2 = opts.baseUrl.replace(/\/$/, "");
+  const consoleBase = (opts.consoleBaseUrl ?? opts.baseUrl).replace(/\/$/, "");
+  const timeoutMs = opts.timeoutMs ?? 9e4;
+  async function req(method, path, body) {
+    try {
+      const res = await fetch(`${baseUrl2}${path}`, {
+        method,
+        headers: { "Content-Type": "application/json", "x-api-key": opts.apiKey },
+        body: body ? JSON.stringify(body) : void 0,
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      const data = await res.json().catch(() => ({}));
+      return { ok: res.ok, data };
+    } catch (err) {
+      return { ok: false, data: { error: err instanceof Error ? err.message : String(err) } };
+    }
+  }
+  const server2 = new import_mcp.McpServer({ name: "browser-agent", version: PACKAGE_VERSION });
+  const annotations = (title, readOnly = false) => ({
+    title,
+    readOnlyHint: readOnly,
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: true
+  });
+  server2.registerTool(
+    "browser_open",
+    {
+      title: "Open Browser Session",
+      description: "Open a fresh cloud browser you can drive. Returns a session_id used by all other browser_* tools, and a watch_url where a human can watch live or take over. Anti-bot stealth and automatic CAPTCHA/Cloudflare solving are on by default: if a Cloudflare or CAPTCHA challenge appears, do NOT click it \u2014 wait a few seconds and call browser_screenshot again; it is solved automatically. Billing: metered per second of active browser work at ~4 credits per minute; idle and standby time are free. Call browser_close when done to stop the meter. After opening, call browser_screenshot to see the page.",
+      inputSchema: BrowserOpenInputSchema,
+      annotations: annotations("Open Browser Session")
+    },
+    async (input) => {
+      const open = await req("POST", "/agent/sessions", {
+        label: input.label,
+        profile: input.profile,
+        timeout_seconds: input.timeout_seconds
+      });
+      if (!open.ok) return textResult(open.data, true);
+      const session = open.data;
+      if (input.url) {
+        await req("POST", `/agent/sessions/${session.session_id}/goto`, { url: input.url });
+      }
+      return textResult({
+        session_id: session.session_id,
+        watch_url: `${consoleBase}/console/${session.session_id}`,
+        hint: "Call browser_screenshot to see the page. Click by the x,y of an element from the snapshot."
+      });
+    }
+  );
+  server2.registerTool(
+    "browser_screenshot",
+    {
+      title: "See Page (Screenshot + Elements)",
+      description: "Capture what the browser currently shows. Returns a screenshot image PLUS a text snapshot listing interactive elements with their center x,y coordinates, the page url and title, and visible text. This is your primary way to perceive the page. Click elements by their listed x,y. If a Cloudflare/CAPTCHA challenge is visible, wait and screenshot again rather than clicking it.",
+      inputSchema: BrowserSessionInputSchema,
+      annotations: annotations("See Page", true)
+    },
+    async (input) => {
+      const res = await req("POST", `/agent/sessions/${input.session_id}/screenshot`);
+      if (!res.ok) return textResult(res.data, true);
+      const { image_base64, mime_type, url, title, elements, text } = res.data;
+      const content = [];
+      if (image_base64) content.push({ type: "image", data: image_base64, mimeType: mime_type ?? "image/png" });
+      content.push({
+        type: "text",
+        text: JSON.stringify({ url, title, elements, text })
+      });
+      return { content };
+    }
+  );
+  server2.registerTool(
+    "browser_read",
+    {
+      title: "Read Page Text + Elements",
+      description: "Return the page url, title, visible text, and the list of interactive elements (with x,y) without an image. Cheaper than browser_screenshot when you only need to read content or find a target element to click.",
+      inputSchema: BrowserSessionInputSchema,
+      annotations: annotations("Read Page", true)
+    },
+    async (input) => {
+      const res = await req("POST", `/agent/sessions/${input.session_id}/read`);
+      return textResult(res.data, !res.ok);
+    }
+  );
+  server2.registerTool(
+    "browser_goto",
+    {
+      title: "Navigate To URL",
+      description: "Navigate the browser to a URL. Follow with browser_screenshot to see the result.",
+      inputSchema: BrowserGotoInputSchema,
+      annotations: annotations("Navigate To URL")
+    },
+    async (input) => {
+      const res = await req("POST", `/agent/sessions/${input.session_id}/goto`, { url: input.url });
+      return textResult(res.data, !res.ok);
+    }
+  );
+  server2.registerTool(
+    "browser_click",
+    {
+      title: "Click",
+      description: "Click at x,y (screenshot pixel coordinates). Use the x,y of a target element from the latest browser_screenshot or browser_read.",
+      inputSchema: BrowserClickInputSchema,
+      annotations: annotations("Click")
+    },
+    async (input) => {
+      const res = await req("POST", `/agent/sessions/${input.session_id}/click`, {
+        x: input.x,
+        y: input.y,
+        button: input.button,
+        num_clicks: input.num_clicks
+      });
+      return textResult(res.data, !res.ok);
+    }
+  );
+  server2.registerTool(
+    "browser_type",
+    {
+      title: "Type Text",
+      description: 'Type text at the current focus. Click an input field first to focus it. Use browser_press with ["Return"] to submit.',
+      inputSchema: BrowserTypeInputSchema,
+      annotations: annotations("Type Text")
+    },
+    async (input) => {
+      const res = await req("POST", `/agent/sessions/${input.session_id}/type`, { text: input.text, delay: input.delay });
+      return textResult(res.data, !res.ok);
+    }
+  );
+  server2.registerTool(
+    "browser_scroll",
+    {
+      title: "Scroll",
+      description: "Scroll the page. Positive delta_y scrolls down. Follow with browser_screenshot to see newly revealed content.",
+      inputSchema: BrowserScrollInputSchema,
+      annotations: annotations("Scroll")
+    },
+    async (input) => {
+      const res = await req("POST", `/agent/sessions/${input.session_id}/scroll`, {
+        delta_y: input.delta_y,
+        delta_x: input.delta_x,
+        x: input.x,
+        y: input.y
+      });
+      return textResult(res.data, !res.ok);
+    }
+  );
+  server2.registerTool(
+    "browser_press",
+    {
+      title: "Press Keys",
+      description: 'Press keys or combinations, e.g. ["Return"] to submit, ["Ctrl+a"] to select all, ["Ctrl+Shift+Tab"] to switch tabs.',
+      inputSchema: BrowserPressInputSchema,
+      annotations: annotations("Press Keys")
+    },
+    async (input) => {
+      const res = await req("POST", `/agent/sessions/${input.session_id}/press`, { keys: input.keys });
+      return textResult(res.data, !res.ok);
+    }
+  );
+  server2.registerTool(
+    "browser_replay_start",
+    {
+      title: "Start Recording",
+      description: "Start recording an MP4 replay of the session. Returns a replay_id. Use to capture a task for later review; stop with browser_replay_stop.",
+      inputSchema: BrowserSessionInputSchema,
+      annotations: annotations("Start Recording")
+    },
+    async (input) => {
+      const res = await req("POST", `/agent/sessions/${input.session_id}/replay/start`);
+      return textResult(res.data, !res.ok);
+    }
+  );
+  server2.registerTool(
+    "browser_replay_stop",
+    {
+      title: "Stop Recording",
+      description: "Stop a replay recording and persist the video. The recording becomes viewable in the watch console.",
+      inputSchema: BrowserReplayStopInputSchema,
+      annotations: annotations("Stop Recording")
+    },
+    async (input) => {
+      const res = await req("POST", `/agent/sessions/${input.session_id}/replay/stop`, { replay_id: input.replay_id });
+      return textResult(res.data, !res.ok);
+    }
+  );
+  server2.registerTool(
+    "browser_close",
+    {
+      title: "Close Browser Session",
+      description: "Close and release the browser session when the task is done.",
+      inputSchema: BrowserSessionInputSchema,
+      annotations: { title: "Close Browser Session", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
+    },
+    async (input) => {
+      const res = await req("DELETE", `/agent/sessions/${input.session_id}`);
+      return textResult(res.data, !res.ok);
+    }
+  );
+  server2.registerTool(
+    "browser_list_sessions",
+    {
+      title: "List Browser Sessions",
+      description: "List your browser sessions and their status, with a watch_url for each.",
+      inputSchema: BrowserListInputSchema,
+      annotations: annotations("List Browser Sessions", true)
+    },
+    async (input) => {
+      const res = await req("GET", `/agent/sessions${input.include_closed ? "?all=1" : ""}`);
+      if (!res.ok) return textResult(res.data, true);
+      const sessions = (res.data.sessions ?? []).map((s) => ({ ...s, watch_url: `${consoleBase}/console/${s.session_id}` }));
+      return textResult({ sessions });
+    }
+  );
+  return server2;
+}
+
+// bin/browser-agent-stdio-server.ts
+function readApiKeyFile() {
+  const explicitPath = process.env.MCP_SCRAPER_KEY_PATH?.trim();
+  const paths = [explicitPath, (0, import_node_path.join)((0, import_node_os.homedir)(), ".mcp-scraper-key")].filter(Boolean);
+  for (const path of paths) {
+    try {
+      const value = (0, import_node_fs.readFileSync)(path, "utf8").trim();
+      if (value) return value;
+    } catch {
+    }
+  }
+  return void 0;
+}
+var apiKey = (process.env.MCP_SCRAPER_API_KEY ?? process.env.MCP_SCRAPER_KEY ?? process.env.MCP_API_KEY ?? readApiKeyFile())?.trim();
+if (!apiKey) {
+  process.stderr.write("MCP_SCRAPER_API_KEY env var or ~/.mcp-scraper-key is required\n");
+  process.exit(1);
+}
+var baseUrl = process.env.MCP_SCRAPER_BASE_URL?.trim() ?? process.env.MCP_BASE_URL?.trim() ?? "https://mcpscraper.dev";
+var consoleBaseUrl = process.env.BROWSER_AGENT_CONSOLE_URL?.trim() ?? baseUrl;
+var server = buildBrowserAgentMcpServer({ baseUrl, apiKey, consoleBaseUrl });
+var transport = new import_stdio.StdioServerTransport();
+async function main() {
+  await server.connect(transport);
+}
+main().catch((err) => {
+  process.stderr.write(`${err instanceof Error ? err.message : String(err)}
+`);
+  process.exit(1);
+});
+//# sourceMappingURL=browser-agent-stdio-server.cjs.map

package/dist/bin/browser-agent-stdio-server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../bin/browser-agent-stdio-server.ts","../../src/mcp/browser-agent-mcp-server.ts","../../src/version.ts","../../src/mcp/browser-agent-tool-schemas.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { buildBrowserAgentMcpServer } from '../src/mcp/browser-agent-mcp-server.js'\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.MCP_SCRAPER_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.mcp-scraper-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      void 0\n    }\n  }\n  return undefined\n}\n\nconst apiKey = (\n  process.env.MCP_SCRAPER_API_KEY ??\n  process.env.MCP_SCRAPER_KEY ??\n  process.env.MCP_API_KEY ??\n  readApiKeyFile()\n)?.trim()\nif (!apiKey) {\n  process.stderr.write('MCP_SCRAPER_API_KEY env var or ~/.mcp-scraper-key is required\\n')\n  process.exit(1)\n}\n\nconst baseUrl = process.env.MCP_SCRAPER_BASE_URL?.trim() ?? process.env.MCP_BASE_URL?.trim() ?? 'https://mcpscraper.dev'\nconst consoleBaseUrl = process.env.BROWSER_AGENT_CONSOLE_URL?.trim() ?? baseUrl\nconst server = buildBrowserAgentMcpServer({ baseUrl, apiKey, consoleBaseUrl })\nconst transport = new StdioServerTransport()\n\nasync function main() {\n  await server.connect(transport)\n}\n\nmain().catch(err => {\n  process.stderr.write(`${err instanceof Error ? err.message : String(err)}\\n`)\n  process.exit(1)\n})\n","import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport { PACKAGE_VERSION } from '../version.js'\nimport {\n  BrowserOpenInputSchema,\n  BrowserSessionInputSchema,\n  BrowserGotoInputSchema,\n  BrowserClickInputSchema,\n  BrowserTypeInputSchema,\n  BrowserScrollInputSchema,\n  BrowserPressInputSchema,\n  BrowserReplayStopInputSchema,\n  BrowserListInputSchema,\n} from './browser-agent-tool-schemas.js'\n\nexport interface BrowserAgentHttpOptions {\n  baseUrl: string\n  apiKey: string\n  consoleBaseUrl?: string\n  timeoutMs?: number\n}\n\nfunction textResult(value: unknown, isError = false): CallToolResult {\n  return { content: [{ type: 'text', text: JSON.stringify(value) }], isError }\n}\n\nexport function buildBrowserAgentMcpServer(opts: BrowserAgentHttpOptions): McpServer {\n  const baseUrl = opts.baseUrl.replace(/\\/$/, '')\n  const consoleBase = (opts.consoleBaseUrl ?? opts.baseUrl).replace(/\\/$/, '')\n  const timeoutMs = opts.timeoutMs ?? 90_000\n\n  async function req(method: string, path: string, body?: Record<string, unknown>): Promise<{ ok: boolean; data: any }> {\n    try {\n      const res = await fetch(`${baseUrl}${path}`, {\n        method,\n        headers: { 'Content-Type': 'application/json', 'x-api-key': opts.apiKey },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: AbortSignal.timeout(timeoutMs),\n      })\n      const data = await res.json().catch(() => ({}))\n      return { ok: res.ok, data }\n    } catch (err) {\n      return { ok: false, data: { error: err instanceof Error ? err.message : String(err) } }\n    }\n  }\n\n  const server = new McpServer({ name: 'browser-agent', version: PACKAGE_VERSION })\n\n  const annotations = (title: string, readOnly = false) => ({\n    title,\n    readOnlyHint: readOnly,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint: true,\n  })\n\n  server.registerTool(\n    'browser_open',\n    {\n      title: 'Open Browser Session',\n      description:\n        'Open a fresh cloud browser you can drive. Returns a session_id used by all other browser_* tools, and a watch_url where a human can watch live or take over. Anti-bot stealth and automatic CAPTCHA/Cloudflare solving are on by default: if a Cloudflare or CAPTCHA challenge appears, do NOT click it — wait a few seconds and call browser_screenshot again; it is solved automatically. Billing: metered per second of active browser work at ~4 credits per minute; idle and standby time are free. Call browser_close when done to stop the meter. After opening, call browser_screenshot to see the page.',\n      inputSchema: BrowserOpenInputSchema,\n      annotations: annotations('Open Browser Session'),\n    },\n    async input => {\n      const open = await req('POST', '/agent/sessions', {\n        label: input.label,\n        profile: input.profile,\n        timeout_seconds: input.timeout_seconds,\n      })\n      if (!open.ok) return textResult(open.data, true)\n      const session = open.data\n      if (input.url) {\n        await req('POST', `/agent/sessions/${session.session_id}/goto`, { url: input.url })\n      }\n      return textResult({\n        session_id: session.session_id,\n        watch_url: `${consoleBase}/console/${session.session_id}`,\n        hint: 'Call browser_screenshot to see the page. Click by the x,y of an element from the snapshot.',\n      })\n    },\n  )\n\n  server.registerTool(\n    'browser_screenshot',\n    {\n      title: 'See Page (Screenshot + Elements)',\n      description:\n        'Capture what the browser currently shows. Returns a screenshot image PLUS a text snapshot listing interactive elements with their center x,y coordinates, the page url and title, and visible text. This is your primary way to perceive the page. Click elements by their listed x,y. If a Cloudflare/CAPTCHA challenge is visible, wait and screenshot again rather than clicking it.',\n      inputSchema: BrowserSessionInputSchema,\n      annotations: annotations('See Page', true),\n    },\n    async input => {\n      const res = await req('POST', `/agent/sessions/${input.session_id}/screenshot`)\n      if (!res.ok) return textResult(res.data, true)\n      const { image_base64, mime_type, url, title, elements, text } = res.data\n      const content: CallToolResult['content'] = []\n      if (image_base64) content.push({ type: 'image', data: image_base64, mimeType: mime_type ?? 'image/png' })\n      content.push({\n        type: 'text',\n        text: JSON.stringify({ url, title, elements, text }),\n      })\n      return { content }\n    },\n  )\n\n  server.registerTool(\n    'browser_read',\n    {\n      title: 'Read Page Text + Elements',\n      description:\n        'Return the page url, title, visible text, and the list of interactive elements (with x,y) without an image. Cheaper than browser_screenshot when you only need to read content or find a target element to click.',\n      inputSchema: BrowserSessionInputSchema,\n      annotations: annotations('Read Page', true),\n    },\n    async input => {\n      const res = await req('POST', `/agent/sessions/${input.session_id}/read`)\n      return textResult(res.data, !res.ok)\n    },\n  )\n\n  server.registerTool(\n    'browser_goto',\n    {\n      title: 'Navigate To URL',\n      description: 'Navigate the browser to a URL. Follow with browser_screenshot to see the result.',\n      inputSchema: BrowserGotoInputSchema,\n      annotations: annotations('Navigate To URL'),\n    },\n    async input => {\n      const res = await req('POST', `/agent/sessions/${input.session_id}/goto`, { url: input.url })\n      return textResult(res.data, !res.ok)\n    },\n  )\n\n  server.registerTool(\n    'browser_click',\n    {\n      title: 'Click',\n      description: 'Click at x,y (screenshot pixel coordinates). Use the x,y of a target element from the latest browser_screenshot or browser_read.',\n      inputSchema: BrowserClickInputSchema,\n      annotations: annotations('Click'),\n    },\n    async input => {\n      const res = await req('POST', `/agent/sessions/${input.session_id}/click`, {\n        x: input.x,\n        y: input.y,\n        button: input.button,\n        num_clicks: input.num_clicks,\n      })\n      return textResult(res.data, !res.ok)\n    },\n  )\n\n  server.registerTool(\n    'browser_type',\n    {\n      title: 'Type Text',\n      description: 'Type text at the current focus. Click an input field first to focus it. Use browser_press with [\"Return\"] to submit.',\n      inputSchema: BrowserTypeInputSchema,\n      annotations: annotations('Type Text'),\n    },\n    async input => {\n      const res = await req('POST', `/agent/sessions/${input.session_id}/type`, { text: input.text, delay: input.delay })\n      return textResult(res.data, !res.ok)\n    },\n  )\n\n  server.registerTool(\n    'browser_scroll',\n    {\n      title: 'Scroll',\n      description: 'Scroll the page. Positive delta_y scrolls down. Follow with browser_screenshot to see newly revealed content.',\n      inputSchema: BrowserScrollInputSchema,\n      annotations: annotations('Scroll'),\n    },\n    async input => {\n      const res = await req('POST', `/agent/sessions/${input.session_id}/scroll`, {\n        delta_y: input.delta_y,\n        delta_x: input.delta_x,\n        x: input.x,\n        y: input.y,\n      })\n      return textResult(res.data, !res.ok)\n    },\n  )\n\n  server.registerTool(\n    'browser_press',\n    {\n      title: 'Press Keys',\n      description: 'Press keys or combinations, e.g. [\"Return\"] to submit, [\"Ctrl+a\"] to select all, [\"Ctrl+Shift+Tab\"] to switch tabs.',\n      inputSchema: BrowserPressInputSchema,\n      annotations: annotations('Press Keys'),\n    },\n    async input => {\n      const res = await req('POST', `/agent/sessions/${input.session_id}/press`, { keys: input.keys })\n      return textResult(res.data, !res.ok)\n    },\n  )\n\n  server.registerTool(\n    'browser_replay_start',\n    {\n      title: 'Start Recording',\n      description: 'Start recording an MP4 replay of the session. Returns a replay_id. Use to capture a task for later review; stop with browser_replay_stop.',\n      inputSchema: BrowserSessionInputSchema,\n      annotations: annotations('Start Recording'),\n    },\n    async input => {\n      const res = await req('POST', `/agent/sessions/${input.session_id}/replay/start`)\n      return textResult(res.data, !res.ok)\n    },\n  )\n\n  server.registerTool(\n    'browser_replay_stop',\n    {\n      title: 'Stop Recording',\n      description: 'Stop a replay recording and persist the video. The recording becomes viewable in the watch console.',\n      inputSchema: BrowserReplayStopInputSchema,\n      annotations: annotations('Stop Recording'),\n    },\n    async input => {\n      const res = await req('POST', `/agent/sessions/${input.session_id}/replay/stop`, { replay_id: input.replay_id })\n      return textResult(res.data, !res.ok)\n    },\n  )\n\n  server.registerTool(\n    'browser_close',\n    {\n      title: 'Close Browser Session',\n      description: 'Close and release the browser session when the task is done.',\n      inputSchema: BrowserSessionInputSchema,\n      annotations: { title: 'Close Browser Session', readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },\n    },\n    async input => {\n      const res = await req('DELETE', `/agent/sessions/${input.session_id}`)\n      return textResult(res.data, !res.ok)\n    },\n  )\n\n  server.registerTool(\n    'browser_list_sessions',\n    {\n      title: 'List Browser Sessions',\n      description: 'List your browser sessions and their status, with a watch_url for each.',\n      inputSchema: BrowserListInputSchema,\n      annotations: annotations('List Browser Sessions', true),\n    },\n    async input => {\n      const res = await req('GET', `/agent/sessions${input.include_closed ? '?all=1' : ''}`)\n      if (!res.ok) return textResult(res.data, true)\n      const sessions = (res.data.sessions ?? []).map((s: any) => ({ ...s, watch_url: `${consoleBase}/console/${s.session_id}` }))\n      return textResult({ sessions })\n    },\n  )\n\n  return server\n}\n","export const PACKAGE_VERSION = '0.2.0'\n","import { z } from 'zod'\n\nexport const BrowserOpenInputSchema = {\n  label: z.string().optional().describe('Optional human label for this session, shown in the watch console.'),\n  url: z.string().url().optional().describe('Optional URL to navigate to immediately after opening.'),\n  profile: z.string().optional().describe('Optional saved profile name to load a logged-in session for a site.'),\n  timeout_seconds: z.number().int().min(60).max(259200).optional().describe('How long the session may live before auto-termination. Defaults to 600. The browser idles into a zero-cost standby between actions, so a longer timeout is cheap.'),\n}\nexport type BrowserOpenInput = z.infer<ReturnType<typeof z.object<typeof BrowserOpenInputSchema>>>\n\nexport const BrowserSessionInputSchema = {\n  session_id: z.string().describe('The session id returned by browser_open.'),\n}\nexport type BrowserSessionInput = z.infer<ReturnType<typeof z.object<typeof BrowserSessionInputSchema>>>\n\nexport const BrowserGotoInputSchema = {\n  session_id: z.string().describe('The session id returned by browser_open.'),\n  url: z.string().url().describe('URL to navigate the browser to.'),\n}\nexport type BrowserGotoInput = z.infer<ReturnType<typeof z.object<typeof BrowserGotoInputSchema>>>\n\nexport const BrowserClickInputSchema = {\n  session_id: z.string().describe('The session id returned by browser_open.'),\n  x: z.number().describe('X coordinate to click, in screenshot pixels. Use the x of an element from the latest screenshot.'),\n  y: z.number().describe('Y coordinate to click, in screenshot pixels.'),\n  button: z.enum(['left', 'right', 'middle']).default('left').describe('Mouse button.'),\n  num_clicks: z.number().int().min(1).max(3).optional().describe('Number of clicks, e.g. 2 for double-click.'),\n}\nexport type BrowserClickInput = z.infer<ReturnType<typeof z.object<typeof BrowserClickInputSchema>>>\n\nexport const BrowserTypeInputSchema = {\n  session_id: z.string().describe('The session id returned by browser_open.'),\n  text: z.string().describe('Text to type at the current focus. Click a field first to focus it.'),\n  delay: z.number().int().min(0).max(500).optional().describe('Optional per-keystroke delay in ms for human-like typing.'),\n}\nexport type BrowserTypeInput = z.infer<ReturnType<typeof z.object<typeof BrowserTypeInputSchema>>>\n\nexport const BrowserScrollInputSchema = {\n  session_id: z.string().describe('The session id returned by browser_open.'),\n  delta_y: z.number().default(5).describe('Vertical scroll in wheel units. Positive scrolls down, negative up.'),\n  delta_x: z.number().default(0).describe('Horizontal scroll in wheel units.'),\n  x: z.number().optional().describe('X position to scroll at. Defaults to screen center.'),\n  y: z.number().optional().describe('Y position to scroll at. Defaults to screen center.'),\n}\nexport type BrowserScrollInput = z.infer<ReturnType<typeof z.object<typeof BrowserScrollInputSchema>>>\n\nexport const BrowserPressInputSchema = {\n  session_id: z.string().describe('The session id returned by browser_open.'),\n  keys: z.array(z.string()).min(1).describe('Keys or combinations to press, e.g. [\"Return\"], [\"Ctrl+a\"], [\"Ctrl+Shift+Tab\"].'),\n}\nexport type BrowserPressInput = z.infer<ReturnType<typeof z.object<typeof BrowserPressInputSchema>>>\n\nexport const BrowserReplayStopInputSchema = {\n  session_id: z.string().describe('The session id returned by browser_open.'),\n  replay_id: z.string().describe('The replay id returned by browser_replay_start.'),\n}\nexport type BrowserReplayStopInput = z.infer<ReturnType<typeof z.object<typeof BrowserReplayStopInputSchema>>>\n\nexport const BrowserListInputSchema = {\n  include_closed: z.boolean().default(false).describe('Include closed sessions in the list.'),\n}\nexport type BrowserListInput = z.infer<ReturnType<typeof z.object<typeof BrowserListInputSchema>>>\n"],"mappings":"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","names":["baseUrl","server"]}

package/dist/bin/browser-agent-stdio-server.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin/browser-agent-stdio-server.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node