@n8n/mcp-browser 0.1.0-rc1

package/dist/tools/navigation.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNavigationTools = createNavigationTools;
+const zod_1 = require("zod");
+const utils_1 = require("../utils");
+const helpers_1 = require("./helpers");
+const waitUntilField = zod_1.z
+    .enum(['load', 'domcontentloaded', 'networkidle'])
+    .optional()
+    .describe('When to consider navigation done (default: "load")');
+function createNavigationTools(connection) {
+    return [
+        browserNavigate(connection),
+        browserBack(connection),
+        browserForward(connection),
+        browserReload(connection),
+    ];
+}
+const browserNavigateSchema = zod_1.z.object({
+    url: zod_1.z.string().describe('Full URL to navigate to'),
+    waitUntil: waitUntilField,
+    pageId: helpers_1.pageIdField,
+});
+const browserNavigateOutputSchema = (0, helpers_1.withSnapshotEnvelope)({
+    title: zod_1.z.string(),
+    url: zod_1.z.string(),
+    status: zod_1.z.number(),
+});
+function browserNavigate(connection) {
+    return (0, helpers_1.createConnectedTool)(connection, 'browser_navigate', 'Navigate to a URL and wait for the page to load.', browserNavigateSchema, async (state, input, pageId) => {
+        const result = await state.adapter.navigate(pageId, input.url, input.waitUntil);
+        return (0, utils_1.formatCallToolResult)({ title: result.title, url: result.url, status: result.status });
+    }, browserNavigateOutputSchema, { autoSnapshot: true, waitForCompletion: true }, (args) => (0, helpers_1.extractDomain)(args.url));
+}
+const browserBackSchema = zod_1.z.object({
+    pageId: helpers_1.pageIdField,
+});
+const browserBackOutputSchema = (0, helpers_1.withSnapshotEnvelope)({
+    title: zod_1.z.string(),
+    url: zod_1.z.string(),
+});
+function browserBack(connection) {
+    return (0, helpers_1.createConnectedTool)(connection, 'browser_back', 'Navigate back in browser history.', browserBackSchema, async (state, _input, pageId) => {
+        const result = await state.adapter.back(pageId);
+        return (0, utils_1.formatCallToolResult)({ title: result.title, url: result.url });
+    }, browserBackOutputSchema, { autoSnapshot: true, waitForCompletion: true });
+}
+const browserForwardSchema = zod_1.z.object({
+    pageId: helpers_1.pageIdField,
+});
+const browserForwardOutputSchema = (0, helpers_1.withSnapshotEnvelope)({
+    title: zod_1.z.string(),
+    url: zod_1.z.string(),
+});
+function browserForward(connection) {
+    return (0, helpers_1.createConnectedTool)(connection, 'browser_forward', 'Navigate forward in browser history.', browserForwardSchema, async (state, _input, pageId) => {
+        const result = await state.adapter.forward(pageId);
+        return (0, utils_1.formatCallToolResult)({ title: result.title, url: result.url });
+    }, browserForwardOutputSchema, { autoSnapshot: true, waitForCompletion: true });
+}
+const browserReloadSchema = zod_1.z.object({
+    waitUntil: waitUntilField,
+    pageId: helpers_1.pageIdField,
+});
+const browserReloadOutputSchema = (0, helpers_1.withSnapshotEnvelope)({
+    title: zod_1.z.string(),
+    url: zod_1.z.string(),
+});
+function browserReload(connection) {
+    return (0, helpers_1.createConnectedTool)(connection, 'browser_reload', 'Reload the current page.', browserReloadSchema, async (state, input, pageId) => {
+        const result = await state.adapter.reload(pageId, input.waitUntil);
+        return (0, utils_1.formatCallToolResult)({ title: result.title, url: result.url });
+    }, browserReloadOutputSchema, { autoSnapshot: true, waitForCompletion: true });
+}
+//# sourceMappingURL=navigation.js.map

package/dist/tools/navigation.js.map

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

package/dist/tools/response-envelope.d.ts

@@ -0,0 +1,13 @@
+import type { BrowserConnection } from '../connection';
+import type { CallToolResult, ConnectionState } from '../types';
+import type { ConnectedToolOptions } from './helpers';
+export declare function resolvePageContext(connection: BrowserConnection, args: {
+    pageId?: string;
+}): {
+    state: ConnectionState;
+    pageId: string;
+};
+export declare function enrichResponse(result: CallToolResult, state: ConnectionState, pageId: string, options: ConnectedToolOptions, tabsBefore?: Set<string>): Promise<void>;
+export declare function buildErrorResponse(error: unknown, connection: BrowserConnection, args: {
+    pageId?: string;
+}, options: ConnectedToolOptions): Promise<CallToolResult>;

package/dist/tools/response-envelope.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePageContext = resolvePageContext;
+exports.enrichResponse = enrichResponse;
+exports.buildErrorResponse = buildErrorResponse;
+const errors_1 = require("../errors");
+const logger_1 = require("../logger");
+const log = (0, logger_1.createLogger)('response-envelope');
+function resolvePageContext(connection, args) {
+    const state = connection.getConnection();
+    const pageId = args.pageId ?? state.activePageId;
+    return { state, pageId };
+}
+async function enrichResponse(result, state, pageId, options, tabsBefore) {
+    const data = result.structuredContent;
+    if (!data || typeof data !== 'object')
+        return;
+    const record = data;
+    if (options.autoSnapshot) {
+        try {
+            const snap = await state.adapter.snapshot(pageId);
+            record.snapshot = snap.tree;
+        }
+        catch {
+        }
+    }
+    try {
+        const modals = state.adapter.getModalStates(pageId);
+        if (modals.length > 0)
+            record.modalStates = modals;
+    }
+    catch {
+    }
+    if (options.autoSnapshot) {
+        try {
+            const summary = state.adapter.getConsoleSummary(pageId);
+            if (summary.errors > 0 || summary.warnings > 0)
+                record.consoleSummary = summary;
+        }
+        catch {
+        }
+    }
+    if (tabsBefore) {
+        try {
+            const tabsNow = await state.adapter.listTabs();
+            log.debug(`tab diff: before=${tabsBefore.size}, now=${tabsNow.length}`);
+            const newTabs = tabsNow
+                .filter((t) => !tabsBefore.has(t.id))
+                .map((t) => ({ id: t.id, title: t.title, url: t.url }));
+            if (newTabs.length > 0) {
+                log.debug(`detected ${newTabs.length} new tab(s): ${JSON.stringify(newTabs.map((t) => t.url))}`);
+                record.newTabs = newTabs;
+            }
+        }
+        catch {
+        }
+    }
+}
+async function buildErrorResponse(error, connection, args, options) {
+    const mcpError = error instanceof errors_1.McpBrowserError
+        ? error
+        : new errors_1.McpBrowserError(error instanceof Error ? error.message : String(error));
+    const errorData = { error: mcpError.message };
+    if (mcpError.hint)
+        errorData.hint = mcpError.hint;
+    try {
+        const { state, pageId } = resolvePageContext(connection, args);
+        if (options.autoSnapshot) {
+            try {
+                const snap = await state.adapter.snapshot(pageId);
+                errorData.snapshot = snap.tree;
+            }
+            catch {
+            }
+        }
+        try {
+            const modals = state.adapter.getModalStates(pageId);
+            if (modals.length > 0)
+                errorData.modalStates = modals;
+        }
+        catch {
+        }
+    }
+    catch {
+    }
+    return {
+        content: [{ type: 'text', text: JSON.stringify(errorData, null, 2) }],
+        structuredContent: errorData,
+        isError: true,
+    };
+}
+//# sourceMappingURL=response-envelope.js.map

package/dist/tools/response-envelope.js.map

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

package/dist/tools/schemas.d.ts

@@ -0,0 +1,236 @@
+import { z } from 'zod';
+export declare const pageIdField: z.ZodOptional<z.ZodString>;
+export declare const elementTargetSchema: z.ZodUnion<[z.ZodObject<{
+    ref: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    ref: string;
+}, {
+    ref: string;
+}>, z.ZodObject<{
+    selector: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    selector: string;
+}, {
+    selector: string;
+}>]>;
+export type ElementTargetInput = z.infer<typeof elementTargetSchema>;
+export declare const modalStateSchema: z.ZodObject<{
+    type: z.ZodEnum<["dialog", "filechooser"]>;
+    description: z.ZodString;
+    clearedBy: z.ZodString;
+    dialogType: z.ZodOptional<z.ZodEnum<["alert", "confirm", "prompt", "beforeunload"]>>;
+    message: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "dialog" | "filechooser";
+    description: string;
+    clearedBy: string;
+    message?: string | undefined;
+    dialogType?: "alert" | "confirm" | "prompt" | "beforeunload" | undefined;
+}, {
+    type: "dialog" | "filechooser";
+    description: string;
+    clearedBy: string;
+    message?: string | undefined;
+    dialogType?: "alert" | "confirm" | "prompt" | "beforeunload" | undefined;
+}>;
+export declare const consoleSummarySchema: z.ZodObject<{
+    errors: z.ZodNumber;
+    warnings: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    errors: number;
+    warnings: number;
+}, {
+    errors: number;
+    warnings: number;
+}>;
+export declare const newTabSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    url: string;
+}, {
+    id: string;
+    title: string;
+    url: string;
+}>;
+export declare const snapshotEnvelopeFields: {
+    readonly snapshot: z.ZodOptional<z.ZodString>;
+    readonly modalStates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["dialog", "filechooser"]>;
+        description: z.ZodString;
+        clearedBy: z.ZodString;
+        dialogType: z.ZodOptional<z.ZodEnum<["alert", "confirm", "prompt", "beforeunload"]>>;
+        message: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "dialog" | "filechooser";
+        description: string;
+        clearedBy: string;
+        message?: string | undefined;
+        dialogType?: "alert" | "confirm" | "prompt" | "beforeunload" | undefined;
+    }, {
+        type: "dialog" | "filechooser";
+        description: string;
+        clearedBy: string;
+        message?: string | undefined;
+        dialogType?: "alert" | "confirm" | "prompt" | "beforeunload" | undefined;
+    }>, "many">>;
+    readonly consoleSummary: z.ZodOptional<z.ZodObject<{
+        errors: z.ZodNumber;
+        warnings: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        errors: number;
+        warnings: number;
+    }, {
+        errors: number;
+        warnings: number;
+    }>>;
+    readonly newTabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        url: string;
+    }, {
+        id: string;
+        title: string;
+        url: string;
+    }>, "many">>;
+};
+export declare function withSnapshotEnvelope<T extends z.ZodRawShape>(shape: T): z.ZodObject<T & {
+    readonly snapshot: z.ZodOptional<z.ZodString>;
+    readonly modalStates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["dialog", "filechooser"]>;
+        description: z.ZodString;
+        clearedBy: z.ZodString;
+        dialogType: z.ZodOptional<z.ZodEnum<["alert", "confirm", "prompt", "beforeunload"]>>;
+        message: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "dialog" | "filechooser";
+        description: string;
+        clearedBy: string;
+        message?: string | undefined;
+        dialogType?: "alert" | "confirm" | "prompt" | "beforeunload" | undefined;
+    }, {
+        type: "dialog" | "filechooser";
+        description: string;
+        clearedBy: string;
+        message?: string | undefined;
+        dialogType?: "alert" | "confirm" | "prompt" | "beforeunload" | undefined;
+    }>, "many">>;
+    readonly consoleSummary: z.ZodOptional<z.ZodObject<{
+        errors: z.ZodNumber;
+        warnings: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        errors: number;
+        warnings: number;
+    }, {
+        errors: number;
+        warnings: number;
+    }>>;
+    readonly newTabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        url: string;
+    }, {
+        id: string;
+        title: string;
+        url: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<T & {
+    readonly snapshot: z.ZodOptional<z.ZodString>;
+    readonly modalStates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["dialog", "filechooser"]>;
+        description: z.ZodString;
+        clearedBy: z.ZodString;
+        dialogType: z.ZodOptional<z.ZodEnum<["alert", "confirm", "prompt", "beforeunload"]>>;
+        message: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "dialog" | "filechooser";
+        description: string;
+        clearedBy: string;
+        message?: string | undefined;
+        dialogType?: "alert" | "confirm" | "prompt" | "beforeunload" | undefined;
+    }, {
+        type: "dialog" | "filechooser";
+        description: string;
+        clearedBy: string;
+        message?: string | undefined;
+        dialogType?: "alert" | "confirm" | "prompt" | "beforeunload" | undefined;
+    }>, "many">>;
+    readonly consoleSummary: z.ZodOptional<z.ZodObject<{
+        errors: z.ZodNumber;
+        warnings: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        errors: number;
+        warnings: number;
+    }, {
+        errors: number;
+        warnings: number;
+    }>>;
+    readonly newTabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        url: string;
+    }, {
+        id: string;
+        title: string;
+        url: string;
+    }>, "many">>;
+}>, any> extends infer T_1 ? { [k in keyof T_1]: T_1[k]; } : never, z.baseObjectInputType<T & {
+    readonly snapshot: z.ZodOptional<z.ZodString>;
+    readonly modalStates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["dialog", "filechooser"]>;
+        description: z.ZodString;
+        clearedBy: z.ZodString;
+        dialogType: z.ZodOptional<z.ZodEnum<["alert", "confirm", "prompt", "beforeunload"]>>;
+        message: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "dialog" | "filechooser";
+        description: string;
+        clearedBy: string;
+        message?: string | undefined;
+        dialogType?: "alert" | "confirm" | "prompt" | "beforeunload" | undefined;
+    }, {
+        type: "dialog" | "filechooser";
+        description: string;
+        clearedBy: string;
+        message?: string | undefined;
+        dialogType?: "alert" | "confirm" | "prompt" | "beforeunload" | undefined;
+    }>, "many">>;
+    readonly consoleSummary: z.ZodOptional<z.ZodObject<{
+        errors: z.ZodNumber;
+        warnings: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        errors: number;
+        warnings: number;
+    }, {
+        errors: number;
+        warnings: number;
+    }>>;
+    readonly newTabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        url: string;
+    }, {
+        id: string;
+        title: string;
+        url: string;
+    }>, "many">>;
+}> extends infer T_2 ? { [k_1 in keyof T_2]: T_2[k_1]; } : never>;

package/dist/tools/schemas.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snapshotEnvelopeFields = exports.newTabSchema = exports.consoleSummarySchema = exports.modalStateSchema = exports.elementTargetSchema = exports.pageIdField = void 0;
+exports.withSnapshotEnvelope = withSnapshotEnvelope;
+const zod_1 = require("zod");
+exports.pageIdField = zod_1.z
+    .string()
+    .optional()
+    .describe('Target page/tab ID. Defaults to active page');
+const refTargetSchema = zod_1.z
+    .object({
+    ref: zod_1.z.string().describe('Element ref from browser_snapshot (preferred)'),
+})
+    .strict();
+const selectorTargetSchema = zod_1.z
+    .object({
+    selector: zod_1.z.string().describe('CSS/text/role/XPath selector (fallback — prefer ref)'),
+})
+    .strict();
+exports.elementTargetSchema = zod_1.z.union([refTargetSchema, selectorTargetSchema]);
+exports.modalStateSchema = zod_1.z.object({
+    type: zod_1.z.enum(['dialog', 'filechooser']),
+    description: zod_1.z.string(),
+    clearedBy: zod_1.z.string(),
+    dialogType: zod_1.z.enum(['alert', 'confirm', 'prompt', 'beforeunload']).optional(),
+    message: zod_1.z.string().optional(),
+});
+exports.consoleSummarySchema = zod_1.z.object({
+    errors: zod_1.z.number(),
+    warnings: zod_1.z.number(),
+});
+exports.newTabSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    title: zod_1.z.string(),
+    url: zod_1.z.string(),
+});
+exports.snapshotEnvelopeFields = {
+    snapshot: zod_1.z.string().optional(),
+    modalStates: zod_1.z.array(exports.modalStateSchema).optional(),
+    consoleSummary: exports.consoleSummarySchema.optional(),
+    newTabs: zod_1.z.array(exports.newTabSchema).optional().describe('Tabs opened as a result of this action'),
+};
+function withSnapshotEnvelope(shape) {
+    return zod_1.z.object({ ...shape, ...exports.snapshotEnvelopeFields });
+}
+//# sourceMappingURL=schemas.js.map

package/dist/tools/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":";;;AAwEA,oDAEC;AA1ED,6BAAwB;AAMX,QAAA,WAAW,GAAG,OAAC;KAC1B,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CAAC,6CAA6C,CAAC,CAAC;AAE1D,MAAM,eAAe,GAAG,OAAC;KACvB,MAAM,CAAC;IACP,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;CACzE,CAAC;KACD,MAAM,EAAE,CAAC;AACX,MAAM,oBAAoB,GAAG,OAAC;KAC5B,MAAM,CAAC;IACP,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;CACrF,CAAC;KACD,MAAM,EAAE,CAAC;AAGE,QAAA,mBAAmB,GAAG,OAAC,CAAC,KAAK,CAAC,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAQvE,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACvC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,UAAU,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7E,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEU,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAMU,QAAA,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;CACf,CAAC,CAAC;AAGU,QAAA,sBAAsB,GAAG;IACrC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,WAAW,EAAE,OAAC,CAAC,KAAK,CAAC,wBAAgB,CAAC,CAAC,QAAQ,EAAE;IACjD,cAAc,EAAE,4BAAoB,CAAC,QAAQ,EAAE;IAC/C,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,oBAAY,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;CACnF,CAAC;AAYX,SAAgB,oBAAoB,CAA0B,KAAQ;IACrE,OAAO,OAAC,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,8BAAsB,EAAE,CAAC,CAAC;AAC1D,CAAC"}

package/dist/tools/session.d.ts

@@ -0,0 +1,3 @@
+import type { BrowserConnection } from '../connection';
+import type { ToolDefinition } from '../types';
+export declare function createSessionTools(connection: BrowserConnection): ToolDefinition[];

package/dist/tools/session.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSessionTools = createSessionTools;
+const zod_1 = require("zod");
+const errors_1 = require("../errors");
+const types_1 = require("../types");
+const utils_1 = require("../utils");
+function createSessionTools(connection) {
+    return [browserConnect(connection), browserDisconnect(connection)];
+}
+const browserConnectSchema = zod_1.z.object({
+    browser: types_1.browserNameSchema
+        .optional()
+        .describe('Chromium-based browser to connect to. Options: chrome, brave, edge, chromium. ' +
+        'Defaults to chrome. Only Chromium-based browsers are supported (they provide the CDP protocol required by the browser bridge extension).'),
+});
+const browserConnectOutputSchema = zod_1.z.object({
+    browser: zod_1.z.string(),
+    pages: zod_1.z.array(zod_1.z.object({
+        id: zod_1.z.string(),
+        title: zod_1.z.string(),
+        url: zod_1.z.string(),
+    })),
+});
+function browserConnect(connection) {
+    return {
+        name: 'browser_connect',
+        description: "Connect to the user's browser for web automation. " +
+            'Optionally specify a Chromium-based browser (chrome, brave, edge, chromium). ' +
+            'Requires the n8n AI Browser Bridge extension to be installed. ' +
+            'Must be called before using any other browser tools.',
+        inputSchema: browserConnectSchema,
+        outputSchema: browserConnectOutputSchema,
+        async execute(args, _context) {
+            try {
+                const result = await connection.connect(args.browser);
+                return (0, utils_1.formatCallToolResult)({
+                    browser: result.browser,
+                    pages: result.pages,
+                });
+            }
+            catch (error) {
+                if (error instanceof errors_1.McpBrowserError)
+                    return (0, utils_1.formatErrorResponse)(error);
+                return (0, utils_1.formatErrorResponse)(new errors_1.McpBrowserError(error instanceof Error ? error.message : String(error)));
+            }
+        },
+        getAffectedResources(_args, _context) {
+            return [{ toolGroup: 'browser', resource: 'browser', description: 'Connect to browser' }];
+        },
+    };
+}
+const browserDisconnectSchema = zod_1.z.object({});
+const browserDisconnectOutputSchema = zod_1.z.object({
+    disconnected: zod_1.z.boolean(),
+});
+function browserDisconnect(connection) {
+    return {
+        name: 'browser_disconnect',
+        description: 'Disconnect from the browser and release all resources.',
+        inputSchema: browserDisconnectSchema,
+        outputSchema: browserDisconnectOutputSchema,
+        async execute(_args, _context) {
+            try {
+                await connection.disconnect();
+                return (0, utils_1.formatCallToolResult)({ disconnected: true });
+            }
+            catch (error) {
+                if (error instanceof errors_1.McpBrowserError)
+                    return (0, utils_1.formatErrorResponse)(error);
+                return (0, utils_1.formatErrorResponse)(new errors_1.McpBrowserError(error instanceof Error ? error.message : String(error)));
+            }
+        },
+        getAffectedResources(_args, _context) {
+            return [
+                { toolGroup: 'browser', resource: 'browser', description: 'Disconnect from browser' },
+            ];
+        },
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/tools/session.js.map

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

package/dist/tools/state.d.ts

@@ -0,0 +1,3 @@
+import type { BrowserConnection } from '../connection';
+import type { ToolDefinition } from '../types';
+export declare function createStateTools(connection: BrowserConnection): ToolDefinition[];