@fusengine/browser-mcp 0.1.0

package/dist/server/result.js

@@ -0,0 +1,18 @@
+/** Text + structured JSON result. */
+export function jsonResult(payload) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        structuredContent: payload,
+    };
+}
+/** Error result (isError flag set). */
+export function errorResult(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+/** Image result (PNG base64) with an optional text note. */
+export function imageResult(base64, note) {
+    const image = { type: "image", data: base64, mimeType: "image/png" };
+    const text = note ? [{ type: "text", text: note }] : [];
+    return { content: [image, ...text] };
+}
+//# sourceMappingURL=result.js.map

package/dist/server/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/server/result.ts"],"names":[],"mappings":"AAMA,qCAAqC;AACrC,MAAM,UAAU,UAAU,CAAC,OAAgC;IACzD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACnE,iBAAiB,EAAE,OAAO;KAC3B,CAAC;AACJ,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,IAAa;IACvD,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;AACvC,CAAC"}

package/dist/server/schemas.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Zod raw-shape schemas for MCP tool inputs.
+ * @module server/schemas
+ */
+import { z } from "zod";
+/** Shared browser identity / profile options. */
+export declare const agentOptionShape: {
+    engine: z.ZodOptional<z.ZodEnum<{
+        playwright: "playwright";
+        patchright: "patchright";
+        firefox: "firefox";
+        webkit: "webkit";
+    }>>;
+    channel: z.ZodOptional<z.ZodEnum<{
+        chrome: "chrome";
+        "chrome-beta": "chrome-beta";
+        "chrome-dev": "chrome-dev";
+        "chrome-canary": "chrome-canary";
+        msedge: "msedge";
+        "msedge-beta": "msedge-beta";
+        "msedge-dev": "msedge-dev";
+        "msedge-canary": "msedge-canary";
+    }>>;
+    executablePath: z.ZodOptional<z.ZodString>;
+    cdpEndpoint: z.ZodOptional<z.ZodString>;
+    headless: z.ZodOptional<z.ZodBoolean>;
+    humanMode: z.ZodOptional<z.ZodBoolean>;
+    locale: z.ZodOptional<z.ZodString>;
+    timezoneId: z.ZodOptional<z.ZodString>;
+    countryCode: z.ZodOptional<z.ZodString>;
+    currency: z.ZodOptional<z.ZodString>;
+    userDataDir: z.ZodOptional<z.ZodString>;
+    proxyUrl: z.ZodOptional<z.ZodString>;
+    proxyMapPath: z.ZodOptional<z.ZodString>;
+    storageStatePath: z.ZodOptional<z.ZodString>;
+    realisticProfile: z.ZodOptional<z.ZodBoolean>;
+    replayEnabled: z.ZodOptional<z.ZodBoolean>;
+    replayDir: z.ZodOptional<z.ZodString>;
+    siteMemoryDir: z.ZodOptional<z.ZodString>;
+    outputDir: z.ZodOptional<z.ZodString>;
+    retry: z.ZodOptional<z.ZodObject<{
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        baseMs: z.ZodOptional<z.ZodNumber>;
+        capMs: z.ZodOptional<z.ZodNumber>;
+        throttleMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    captcha: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodEnum<{
+            "2captcha": "2captcha";
+            anticaptcha: "anticaptcha";
+            capmonster: "capmonster";
+        }>;
+        apiKey: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        pollMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+};
+/** A single action (loose: type + arbitrary fields). */
+export declare const actionSchema: z.ZodObject<{
+    type: z.ZodString;
+}, z.core.$catchall<z.ZodUnknown>>;
+/** `browser_probe` input shape. */
+export declare const probeShape: {
+    autoConsent: z.ZodOptional<z.ZodBoolean>;
+    extractPrices: z.ZodOptional<z.ZodBoolean>;
+    detectChallenges: z.ZodOptional<z.ZodBoolean>;
+    observeVisual: z.ZodOptional<z.ZodBoolean>;
+    waitMs: z.ZodOptional<z.ZodNumber>;
+    humanApproved: z.ZodOptional<z.ZodBoolean>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+    }, z.core.$catchall<z.ZodUnknown>>>>;
+    solveCaptcha: z.ZodOptional<z.ZodBoolean>;
+    engine: z.ZodOptional<z.ZodEnum<{
+        playwright: "playwright";
+        patchright: "patchright";
+        firefox: "firefox";
+        webkit: "webkit";
+    }>>;
+    channel: z.ZodOptional<z.ZodEnum<{
+        chrome: "chrome";
+        "chrome-beta": "chrome-beta";
+        "chrome-dev": "chrome-dev";
+        "chrome-canary": "chrome-canary";
+        msedge: "msedge";
+        "msedge-beta": "msedge-beta";
+        "msedge-dev": "msedge-dev";
+        "msedge-canary": "msedge-canary";
+    }>>;
+    executablePath: z.ZodOptional<z.ZodString>;
+    cdpEndpoint: z.ZodOptional<z.ZodString>;
+    headless: z.ZodOptional<z.ZodBoolean>;
+    humanMode: z.ZodOptional<z.ZodBoolean>;
+    locale: z.ZodOptional<z.ZodString>;
+    timezoneId: z.ZodOptional<z.ZodString>;
+    countryCode: z.ZodOptional<z.ZodString>;
+    currency: z.ZodOptional<z.ZodString>;
+    userDataDir: z.ZodOptional<z.ZodString>;
+    proxyUrl: z.ZodOptional<z.ZodString>;
+    proxyMapPath: z.ZodOptional<z.ZodString>;
+    storageStatePath: z.ZodOptional<z.ZodString>;
+    realisticProfile: z.ZodOptional<z.ZodBoolean>;
+    replayEnabled: z.ZodOptional<z.ZodBoolean>;
+    replayDir: z.ZodOptional<z.ZodString>;
+    siteMemoryDir: z.ZodOptional<z.ZodString>;
+    outputDir: z.ZodOptional<z.ZodString>;
+    retry: z.ZodOptional<z.ZodObject<{
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        baseMs: z.ZodOptional<z.ZodNumber>;
+        capMs: z.ZodOptional<z.ZodNumber>;
+        throttleMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    captcha: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodEnum<{
+            "2captcha": "2captcha";
+            anticaptcha: "anticaptcha";
+            capmonster: "capmonster";
+        }>;
+        apiKey: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        pollMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    url: z.ZodString;
+};
+/** `browser_probe_html` input shape. */
+export declare const probeHtmlShape: {
+    autoConsent: z.ZodOptional<z.ZodBoolean>;
+    extractPrices: z.ZodOptional<z.ZodBoolean>;
+    detectChallenges: z.ZodOptional<z.ZodBoolean>;
+    observeVisual: z.ZodOptional<z.ZodBoolean>;
+    waitMs: z.ZodOptional<z.ZodNumber>;
+    humanApproved: z.ZodOptional<z.ZodBoolean>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+    }, z.core.$catchall<z.ZodUnknown>>>>;
+    solveCaptcha: z.ZodOptional<z.ZodBoolean>;
+    engine: z.ZodOptional<z.ZodEnum<{
+        playwright: "playwright";
+        patchright: "patchright";
+        firefox: "firefox";
+        webkit: "webkit";
+    }>>;
+    channel: z.ZodOptional<z.ZodEnum<{
+        chrome: "chrome";
+        "chrome-beta": "chrome-beta";
+        "chrome-dev": "chrome-dev";
+        "chrome-canary": "chrome-canary";
+        msedge: "msedge";
+        "msedge-beta": "msedge-beta";
+        "msedge-dev": "msedge-dev";
+        "msedge-canary": "msedge-canary";
+    }>>;
+    executablePath: z.ZodOptional<z.ZodString>;
+    cdpEndpoint: z.ZodOptional<z.ZodString>;
+    headless: z.ZodOptional<z.ZodBoolean>;
+    humanMode: z.ZodOptional<z.ZodBoolean>;
+    locale: z.ZodOptional<z.ZodString>;
+    timezoneId: z.ZodOptional<z.ZodString>;
+    countryCode: z.ZodOptional<z.ZodString>;
+    currency: z.ZodOptional<z.ZodString>;
+    userDataDir: z.ZodOptional<z.ZodString>;
+    proxyUrl: z.ZodOptional<z.ZodString>;
+    proxyMapPath: z.ZodOptional<z.ZodString>;
+    storageStatePath: z.ZodOptional<z.ZodString>;
+    realisticProfile: z.ZodOptional<z.ZodBoolean>;
+    replayEnabled: z.ZodOptional<z.ZodBoolean>;
+    replayDir: z.ZodOptional<z.ZodString>;
+    siteMemoryDir: z.ZodOptional<z.ZodString>;
+    outputDir: z.ZodOptional<z.ZodString>;
+    retry: z.ZodOptional<z.ZodObject<{
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        baseMs: z.ZodOptional<z.ZodNumber>;
+        capMs: z.ZodOptional<z.ZodNumber>;
+        throttleMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    captcha: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodEnum<{
+            "2captcha": "2captcha";
+            anticaptcha: "anticaptcha";
+            capmonster: "capmonster";
+        }>;
+        apiKey: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        pollMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    html: z.ZodString;
+};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/server/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/server/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,iDAAiD;AACjD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqC5B,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,YAAY;;kCAAuD,CAAC;AAajF,mCAAmC;AACnC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAA0D,CAAC;AAElF,wCAAwC;AACxC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAA2D,CAAC"}

package/dist/server/schemas.js

@@ -0,0 +1,72 @@
+/**
+ * Zod raw-shape schemas for MCP tool inputs.
+ * @module server/schemas
+ */
+import { z } from "zod";
+/** Installed-browser channels (real Chrome/Edge). */
+const CHANNELS = [
+    "chrome",
+    "chrome-beta",
+    "chrome-dev",
+    "chrome-canary",
+    "msedge",
+    "msedge-beta",
+    "msedge-dev",
+    "msedge-canary",
+];
+/** Shared browser identity / profile options. */
+export const agentOptionShape = {
+    engine: z.enum(["playwright", "patchright", "firefox", "webkit"]).optional(),
+    channel: z.enum(CHANNELS).optional(),
+    executablePath: z.string().optional(),
+    cdpEndpoint: z.string().optional(),
+    headless: z.boolean().optional(),
+    humanMode: z.boolean().optional(),
+    locale: z.string().optional(),
+    timezoneId: z.string().optional(),
+    countryCode: z.string().optional(),
+    currency: z.string().optional(),
+    userDataDir: z.string().optional(),
+    proxyUrl: z.string().optional(),
+    proxyMapPath: z.string().optional(),
+    storageStatePath: z.string().optional(),
+    realisticProfile: z.boolean().optional(),
+    replayEnabled: z.boolean().optional(),
+    replayDir: z.string().optional(),
+    siteMemoryDir: z.string().optional(),
+    outputDir: z.string().optional(),
+    retry: z
+        .object({
+        maxAttempts: z.number().int().optional(),
+        baseMs: z.number().int().optional(),
+        capMs: z.number().int().optional(),
+        throttleMs: z.number().int().optional(),
+    })
+        .optional(),
+    captcha: z
+        .object({
+        provider: z.enum(["2captcha", "anticaptcha", "capmonster"]),
+        apiKey: z.string(),
+        baseUrl: z.string().optional(),
+        timeoutMs: z.number().int().optional(),
+        pollMs: z.number().int().optional(),
+    })
+        .optional(),
+};
+/** A single action (loose: type + arbitrary fields). */
+export const actionSchema = z.object({ type: z.string() }).catchall(z.unknown());
+const probeFlags = {
+    autoConsent: z.boolean().optional(),
+    extractPrices: z.boolean().optional(),
+    detectChallenges: z.boolean().optional(),
+    observeVisual: z.boolean().optional(),
+    waitMs: z.number().int().optional(),
+    humanApproved: z.boolean().optional(),
+    actions: z.array(actionSchema).optional(),
+    solveCaptcha: z.boolean().optional(),
+};
+/** `browser_probe` input shape. */
+export const probeShape = { url: z.string(), ...agentOptionShape, ...probeFlags };
+/** `browser_probe_html` input shape. */
+export const probeHtmlShape = { html: z.string(), ...agentOptionShape, ...probeFlags };
+//# sourceMappingURL=schemas.js.map

package/dist/server/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/server/schemas.ts"],"names":[],"mappings":"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"}

package/dist/server/server.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Build the MCP server with all tools and resources registered.
+ * @module server/server
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SessionManager } from "../session/manager.js";
+/** The built server and its session manager (for shutdown). */
+export interface BuiltServer {
+    server: McpServer;
+    sessions: SessionManager;
+}
+/** Create the fuse-browser MCP server with every tool and resource wired. */
+export declare function createServer(): BuiltServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAcvD,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,IAAI,WAAW,CAgB1C"}

package/dist/server/server.js

@@ -0,0 +1,37 @@
+/**
+ * Build the MCP server with all tools and resources registered.
+ * @module server/server
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SessionManager } from "../session/manager.js";
+import { registerResources } from "./resources.js";
+import { registerActTools } from "./tools/act.js";
+import { registerConnectTool } from "./tools/connect.js";
+import { registerExtractTool } from "./tools/extract.js";
+import { registerExtractSchemaTool } from "./tools/extract-schema.js";
+import { registerNavigateTool } from "./tools/navigate.js";
+import { registerProbeTools } from "./tools/probe.js";
+import { registerRunTool } from "./tools/run.js";
+import { registerScreenshotTool } from "./tools/screenshot.js";
+import { registerSessionTools } from "./tools/session.js";
+import { registerSnapshotTools } from "./tools/snapshot.js";
+import { registerWaitTool } from "./tools/wait.js";
+/** Create the fuse-browser MCP server with every tool and resource wired. */
+export function createServer() {
+    const server = new McpServer({ name: "fuse-browser", version: "0.1.0" });
+    const sessions = new SessionManager();
+    registerProbeTools(server);
+    registerSessionTools(server, sessions);
+    registerConnectTool(server, sessions);
+    registerNavigateTool(server, sessions);
+    registerActTools(server, sessions);
+    registerSnapshotTools(server, sessions);
+    registerWaitTool(server, sessions);
+    registerRunTool(server, sessions);
+    registerExtractTool(server, sessions);
+    registerExtractSchemaTool(server, sessions);
+    registerScreenshotTool(server, sessions);
+    registerResources(server);
+    return { server, sessions };
+}
+//# sourceMappingURL=server.js.map

package/dist/server/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAQnD,6EAA6E;AAC7E,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IACtC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvC,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtC,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnC,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClC,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtC,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5C,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

package/dist/server/tools/act.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Action tools for a live session: click / fill / login / wait / scroll /
+ * press / select / back / forward.
+ * @module server/tools/act
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SessionManager } from "../../session/manager.js";
+/** Register every per-session action tool. */
+export declare function registerActTools(server: McpServer, sessions: SessionManager): void;
+//# sourceMappingURL=act.d.ts.map

package/dist/server/tools/act.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"act.d.ts","sourceRoot":"","sources":["../../../src/server/tools/act.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAwB/D,8CAA8C;AAC9C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAqDlF"}

package/dist/server/tools/act.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { performAction } from "../../actions/perform.js";
+import { jsonResult } from "../result.js";
+import { withSession } from "./with-session.js";
+function actTool(server, sessions, name, description, inputSchema, build) {
+    server.registerTool(name, { title: name, description, inputSchema }, async (args) => {
+        const a = args;
+        return withSession(sessions, String(a.sessionId), async (s) => {
+            const result = await performAction(s.page, build(a), s.config.humanMode);
+            return jsonResult({ result, url: s.page.url() });
+        });
+    });
+}
+/** Register every per-session action tool. */
+export function registerActTools(server, sessions) {
+    const sessionId = z.string();
+    actTool(server, sessions, "browser_click", "Click a target in the session.", { sessionId, target: z.string() }, (a) => ({
+        type: "click",
+        target: String(a.target),
+    }));
+    actTool(server, sessions, "browser_fill", "Fill a field in the session.", { sessionId, target: z.string(), value: z.string() }, (a) => ({
+        type: "fill",
+        target: String(a.target),
+        value: String(a.value),
+    }));
+    actTool(server, sessions, "browser_scroll", "Scroll the page by a pixel delta (positive deltaY scrolls down).", { sessionId, deltaY: z.number().optional(), deltaX: z.number().optional() }, (a) => ({
+        type: "scroll",
+        deltaY: a.deltaY ?? 600,
+        deltaX: a.deltaX ?? 0,
+    }));
+    actTool(server, sessions, "browser_press", "Press a key or shortcut (Enter, ArrowDown, Control+a...).", { sessionId, key: z.string() }, (a) => ({
+        type: "press",
+        key: String(a.key),
+    }));
+    actTool(server, sessions, "browser_select", "Select an option in a <select> by value, label or index.", { sessionId, target: z.string(), value: z.string() }, (a) => ({
+        type: "select",
+        target: String(a.target),
+        value: String(a.value),
+    }));
+    actTool(server, sessions, "browser_back", "Navigate back in session history.", { sessionId }, () => ({ type: "back" }));
+    actTool(server, sessions, "browser_forward", "Navigate forward in session history.", { sessionId }, () => ({ type: "forward" }));
+    actTool(server, sessions, "browser_wait", "Wait for a number of milliseconds.", { sessionId, ms: z.number().int() }, (a) => ({
+        type: "wait",
+        ms: Number(a.ms),
+    }));
+    actTool(server, sessions, "browser_login", "Structured login (username + password + submit).", {
+        sessionId,
+        username: z.string(),
+        password: z.string(),
+        usernameTarget: z.string().optional(),
+        passwordTarget: z.string().optional(),
+        submitTarget: z.string().optional(),
+    }, (a) => ({
+        type: "login",
+        username: String(a.username),
+        password: String(a.password),
+        usernameTarget: a.usernameTarget,
+        passwordTarget: a.passwordTarget,
+        submitTarget: a.submitTarget,
+    }));
+}
+//# sourceMappingURL=act.js.map

package/dist/server/tools/act.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"act.js","sourceRoot":"","sources":["../../../src/server/tools/act.ts"],"names":[],"mappings":"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"}

package/dist/server/tools/connect.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `browser_connect`: launch an installed browser (by name or path) with a
+ * remote-debugging port, wait for CDP, then open an attached session.
+ * @module server/tools/connect
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SessionManager } from "../../session/manager.js";
+/** Register `browser_connect`. */
+export declare function registerConnectTool(server: McpServer, sessions: SessionManager): void;
+//# sourceMappingURL=connect.d.ts.map

package/dist/server/tools/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../../src/server/tools/connect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAK/D,kCAAkC;AAClC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CA+BrF"}

package/dist/server/tools/connect.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { resolveConfig } from "../../agent/config.js";
+import { KNOWN_BROWSERS, spawnBrowser, waitForCdp } from "../../engine/cdp-launch.js";
+import { errorResult, jsonResult } from "../result.js";
+const BROWSERS = ["dia", "chrome", "edge", "brave", "arc"];
+/** Register `browser_connect`. */
+export function registerConnectTool(server, sessions) {
+    server.registerTool("browser_connect", {
+        title: "Connect to installed browser",
+        description: "Launch an installed browser (dia/chrome/edge/brave/arc or executablePath) with remote debugging, attach to it, and return a session id. Drives the user's real browser.",
+        inputSchema: {
+            browser: z.enum(BROWSERS).optional(),
+            executablePath: z.string().optional(),
+            port: z.number().int().optional(),
+            userDataDir: z.string().optional(),
+            launch: z.boolean().optional(),
+        },
+    }, async (args) => {
+        const a = args;
+        const port = a.port ?? 9222;
+        const binary = a.executablePath ?? KNOWN_BROWSERS[a.browser ?? "chrome"];
+        if (!binary)
+            return errorResult(`Unknown browser: ${String(a.browser)}`);
+        if (a.launch !== false)
+            spawnBrowser(binary, port, a.userDataDir);
+        let endpoint;
+        try {
+            endpoint = await waitForCdp(port);
+        }
+        catch (err) {
+            return errorResult(String(err));
+        }
+        const s = await sessions.open(resolveConfig({ cdpEndpoint: endpoint }));
+        return jsonResult({ sessionId: s.id, endpoint, url: s.page.url(), connected: s.connected });
+    });
+}
+//# sourceMappingURL=connect.js.map

package/dist/server/tools/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../../src/server/tools/connect.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAEtF,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAU,CAAC;AAEpE,kCAAkC;AAClC,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,QAAwB;IAC7E,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,yKAAyK;QAC3K,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE;YACpC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;YACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAC/B;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,CAAC,GAAG,IAA+B,CAAC;QAC1C,MAAM,IAAI,GAAI,CAAC,CAAC,IAA2B,IAAI,IAAI,CAAC;QACpD,MAAM,MAAM,GAAI,CAAC,CAAC,cAAqC,IAAI,cAAc,CAAE,CAAC,CAAC,OAAkB,IAAI,QAAQ,CAAC,CAAC;QAC7G,IAAI,CAAC,MAAM;YAAE,OAAO,WAAW,CAAC,oBAAoB,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK;YAAE,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,WAAiC,CAAC,CAAC;QACxF,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QACxE,OAAO,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAC9F,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server/tools/extract-schema.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `browser_extract_schema`: deterministic structured extraction by CSS selectors.
+ * @module server/tools/extract-schema
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SessionManager } from "../../session/manager.js";
+/** Register `browser_extract_schema`. */
+export declare function registerExtractSchemaTool(server: McpServer, sessions: SessionManager): void;
+//# sourceMappingURL=extract-schema.d.ts.map

package/dist/server/tools/extract-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-schema.d.ts","sourceRoot":"","sources":["../../../src/server/tools/extract-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAW/D,yCAAyC;AACzC,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAqB3F"}

package/dist/server/tools/extract-schema.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { extractStructured } from "../../extraction/structured.js";
+import { jsonResult } from "../result.js";
+import { withSession } from "./with-session.js";
+const fieldSpec = z.object({
+    selector: z.string(),
+    attr: z.string().optional(),
+    all: z.boolean().optional(),
+    abs: z.boolean().optional(),
+});
+/** Register `browser_extract_schema`. */
+export function registerExtractSchemaTool(server, sessions) {
+    server.registerTool("browser_extract_schema", {
+        title: "Extract by schema",
+        description: "Extract typed data from the live page via a field map (field -> {selector, attr?, all?, abs?}). Deterministic; reads the rendered DOM, so it works on Next.js/SPA pages.",
+        inputSchema: {
+            sessionId: z.string(),
+            schema: z.record(z.string(), fieldSpec),
+        },
+    }, async (args) => {
+        const a = args;
+        const schema = a.schema;
+        return withSession(sessions, String(a.sessionId), async (s) => {
+            const data = await extractStructured(s.page, schema);
+            return jsonResult({ url: s.page.url(), data });
+        });
+    });
+}
+//# sourceMappingURL=extract-schema.js.map

package/dist/server/tools/extract-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-schema.js","sourceRoot":"","sources":["../../../src/server/tools/extract-schema.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAyB,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAE1F,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC3B,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAEH,yCAAyC;AACzC,MAAM,UAAU,yBAAyB,CAAC,MAAiB,EAAE,QAAwB;IACnF,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,0KAA0K;QAC5K,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,CAAC;SACxC;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,CAAC,GAAG,IAA+B,CAAC;QAC1C,MAAM,MAAM,GAAG,CAAC,CAAC,MAA0B,CAAC;QAC5C,OAAO,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC5D,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACrD,OAAO,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server/tools/extract.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Extraction tool for a live session: text / prices / hotels / challenges.
+ * @module server/tools/extract
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SessionManager } from "../../session/manager.js";
+/** Register `browser_extract`. */
+export declare function registerExtractTool(server: McpServer, sessions: SessionManager): void;
+//# sourceMappingURL=extract.d.ts.map

package/dist/server/tools/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../src/server/tools/extract.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAM/D,kCAAkC;AAClC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAyBrF"}

package/dist/server/tools/extract.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { detectChallenges } from "../../extraction/challenges.js";
+import { extractHotelOffers } from "../../extraction/hotel-offers.js";
+import { mainText } from "../../extraction/main-text.js";
+import { extractPrices } from "../../extraction/prices.js";
+import { jsonResult } from "../result.js";
+import { withSession } from "./with-session.js";
+const KIND = z.enum(["text", "prices", "hotels", "challenges", "all"]);
+/** Register `browser_extract`. */
+export function registerExtractTool(server, sessions) {
+    server.registerTool("browser_extract", {
+        title: "Extract",
+        description: "Extract text, prices, hotel offers and/or challenges from the live page.",
+        inputSchema: { sessionId: z.string(), kind: KIND.optional() },
+    }, async (args) => {
+        const a = args;
+        const kind = a.kind ?? "all";
+        return withSession(sessions, String(a.sessionId), async (s) => {
+            const text = await mainText(s.page);
+            const out = { url: s.page.url() };
+            if (kind === "text" || kind === "all")
+                out.text = text;
+            if (kind === "prices" || kind === "all") {
+                out.prices = extractPrices(text);
+                out.hotelOffers = extractHotelOffers(text);
+            }
+            if (kind === "hotels")
+                out.hotelOffers = extractHotelOffers(text);
+            if (kind === "challenges" || kind === "all")
+                out.challenges = await detectChallenges(s.page, text);
+            return jsonResult(out);
+        });
+    });
+}
+//# sourceMappingURL=extract.js.map

package/dist/server/tools/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../../src/server/tools/extract.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;AAEvE,kCAAkC;AAClC,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,QAAwB;IAC7E,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,0EAA0E;QACvF,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE;KAC9D,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,CAAC,GAAG,IAA+B,CAAC;QAC1C,MAAM,IAAI,GAAI,CAAC,CAAC,IAAe,IAAI,KAAK,CAAC;QACzC,OAAO,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC5D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,GAAG,GAA4B,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC3D,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,KAAK;gBAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;YACvD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBACxC,GAAG,CAAC,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;gBACjC,GAAG,CAAC,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAC7C,CAAC;YACD,IAAI,IAAI,KAAK,QAAQ;gBAAE,GAAG,CAAC,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAClE,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,KAAK;gBAAE,GAAG,CAAC,UAAU,GAAG,MAAM,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACnG,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server/tools/navigate.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Navigation tool for a live session.
+ * @module server/tools/navigate
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SessionManager } from "../../session/manager.js";
+/** Register `browser_navigate`. */
+export declare function registerNavigateTool(server: McpServer, sessions: SessionManager): void;
+//# sourceMappingURL=navigate.d.ts.map

package/dist/server/tools/navigate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../../src/server/tools/navigate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAK/D,mCAAmC;AACnC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAsBtF"}