@prompteryx/mcp-server 1.0.1

package/dist/server.js

@@ -0,0 +1,104 @@
+/**
+ * Prompteryx MCP Server
+ *
+ * Sets up the McpServer instance, authenticates the user,
+ * registers all tool categories, resources, and handles lifecycle.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { authenticate, refreshAuthContext } from './auth/api-key-auth.js';
+import { BrowserSessionManager } from './tools/browser-session-manager.js';
+import { registerBrowserTools } from './tools/browser-tools.js';
+import { registerWorkflowTools } from './tools/workflow-tools.js';
+import { registerWorkflowBuilderTools } from './tools/workflow-builder-tools.js';
+import { registerIntegrationTools } from './tools/integration-tools.js';
+import { registerAiBrowserTools } from './tools/ai-browser-tools.js';
+import { registerDataTools } from './tools/data-tools.js';
+import { registerResources } from './resources/workflow-resources.js';
+const AUTH_REFRESH_INTERVAL_MS = 60_000; // Refresh auth context every 60 seconds
+export async function createPrompterxServer(config) {
+    const { apiKey, apiUrl, executionMode, sessionTimeout, } = config;
+    // Authenticate and get user context
+    let authContext;
+    try {
+        authContext = await authenticate(apiKey, apiUrl);
+    }
+    catch (err) {
+        process.stderr.write(`[Prompteryx MCP] Authentication failed: ${err.message}\n`);
+        throw err;
+    }
+    process.stderr.write(`[Prompteryx MCP] Authenticated as ${authContext.email} (${authContext.subscriptionTier} plan)\n`);
+    process.stderr.write(`[Prompteryx MCP] Execution mode: ${executionMode}\n`);
+    // Periodic auth refresh to keep usage stats current
+    const refreshInterval = setInterval(async () => {
+        try {
+            authContext = await refreshAuthContext(apiKey, apiUrl);
+        }
+        catch {
+            // Keep the old context if refresh fails
+        }
+    }, AUTH_REFRESH_INTERVAL_MS);
+    // Never keep the process alive just for the refresh timer (cleanup() clears it).
+    refreshInterval.unref?.();
+    const getAuth = () => authContext;
+    // Create MCP server
+    const server = new McpServer({
+        name: 'prompteryx',
+        version: '1.0.1',
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+        },
+    });
+    // Browser session manager (shared across browser tools and AI browser)
+    const sessionManager = new BrowserSessionManager(sessionTimeout ?? 300_000);
+    const cloudConfig = () => ({
+        apiKey,
+        apiUrl,
+        browserbaseProjectId: process.env.BROWSERBASE_PROJECT_ID ?? '',
+        browserbaseApiKey: process.env.BROWSERBASE_API_KEY ?? '',
+        browserbaseContextId: authContext.browserbaseContextId,
+        stealth: config.stealthMode,
+        videoRecording: config.videoRecording,
+    });
+    // Shared context objects for tool modules
+    const browserCtx = {
+        getAuth,
+        sessionManager,
+        apiKey,
+        apiUrl,
+        executionMode,
+        cloudConfig,
+    };
+    const workflowCtx = { getAuth, apiKey, apiUrl };
+    // Register all tool categories
+    registerBrowserTools(server, browserCtx);
+    registerWorkflowTools(server, workflowCtx);
+    registerWorkflowBuilderTools(server, workflowCtx);
+    registerAiBrowserTools(server, browserCtx);
+    registerDataTools(server);
+    registerResources(server, workflowCtx);
+    // Dynamic integration tools (async — registers based on user's credentials)
+    const integrationCount = await registerIntegrationTools(server, workflowCtx);
+    process.stderr.write(`[Prompteryx MCP] Registered ${integrationCount} integration tools\n`);
+    const credentialServices = authContext.credentials
+        .filter((c) => c.isValid)
+        .map((c) => c.connectorId);
+    if (credentialServices.length > 0) {
+        process.stderr.write(`[Prompteryx MCP] Connected services: ${credentialServices.join(', ')}\n`);
+    }
+    // Cleanup on exit
+    const cleanup = async () => {
+        clearInterval(refreshInterval);
+        const { minutesUsed } = await sessionManager.close();
+        if (minutesUsed > 0) {
+            process.stderr.write(`[Prompteryx MCP] Session closed. Cloud minutes used: ${minutesUsed}\n`);
+        }
+    };
+    if (config.registerSignalHandlers !== false) {
+        process.on('SIGINT', async () => { await cleanup(); process.exit(0); });
+        process.on('SIGTERM', async () => { await cleanup(); process.exit(0); });
+    }
+    return { server, cleanup };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/ai-browser-tools.d.ts

@@ -0,0 +1,21 @@
+/**
+ * AI Browser Agent Tool
+ *
+ * Provides the browser_ai_action tool that uses Google's Gemini
+ * Computer Use model to perform complex visual tasks on web pages.
+ * Consumes AI credits from the user's account.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AuthContext } from '../auth/api-key-auth.js';
+import { BrowserSessionManager, type CloudSessionConfig } from './browser-session-manager.js';
+interface AiBrowserContext {
+    getAuth: () => AuthContext;
+    sessionManager: BrowserSessionManager;
+    apiKey: string;
+    apiUrl: string;
+    executionMode: 'cloud' | 'local';
+    cloudConfig: () => CloudSessionConfig;
+}
+export declare function registerAiBrowserTools(server: McpServer, ctx: AiBrowserContext): void;
+export {};
+//# sourceMappingURL=ai-browser-tools.d.ts.map

package/dist/tools/ai-browser-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-browser-tools.d.ts","sourceRoot":"","sources":["../../src/tools/ai-browser-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAG9F,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,WAAW,CAAC;IAC3B,cAAc,EAAE,qBAAqB,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC;IACjC,WAAW,EAAE,MAAM,kBAAkB,CAAC;CACvC;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,QA4F9E"}

package/dist/tools/ai-browser-tools.js

@@ -0,0 +1,88 @@
+/**
+ * AI Browser Agent Tool
+ *
+ * Provides the browser_ai_action tool that uses Google's Gemini
+ * Computer Use model to perform complex visual tasks on web pages.
+ * Consumes AI credits from the user's account.
+ */
+import { z } from 'zod';
+import { enforceUsageLimits, recordUsage, formatUsageRemaining } from '../auth/usage-enforcer.js';
+import { formatError } from '../utils/output-formatter.js';
+export function registerAiBrowserTools(server, ctx) {
+    // browser_ai_action
+    server.tool('browser_ai_action', 'AI Browser Agent: Give a natural language instruction and the AI will see the screen and perform complex multi-step browser actions. Uses Gemini Computer Use model. Consumes AI credits.', {
+        instruction: z.string().describe('Natural language instruction (e.g. "Log into my dashboard and download the monthly report")'),
+        maxSteps: z.number().optional().describe('Maximum number of AI actions to perform (default: 10)'),
+        cloudProfileId: z.string().optional().describe('Reuse a saved cloud profile (its cookies/logins). Omit to use your default cloud profile; pass persistContext:false for a clean throwaway browser.'),
+        persistContext: z.boolean().optional().describe('Persist cookies/logins at session close. Defaults true; set false for an ephemeral run.'),
+        viewport: z.object({ width: z.number(), height: z.number() }).optional().describe('Viewport size (default 1440x900).'),
+        model: z.string().optional().describe('Vision model id (e.g. gemini-3-flash-preview).'),
+        aiVision: z.string().optional().describe('Screenshot resolution "WxH" (e.g. 320x200). Lower = fewer tokens = cheaper.'),
+        recordSession: z.boolean().optional().describe('Record the run to an MP4.'),
+    }, async ({ instruction, maxSteps, cloudProfileId, persistContext, viewport, model, aiVision, recordSession }) => {
+        // Check AI agent credits
+        const check = enforceUsageLimits(ctx.getAuth(), 'ai-agent', ctx.executionMode);
+        if (!check.allowed) {
+            return formatError(check.reason, undefined, { usageRemaining: formatUsageRemaining(ctx.getAuth()) });
+        }
+        try {
+            // Execute via the platform API which handles Gemini interaction. Forward
+            // the full option set the endpoint now supports (profile rule, viewport,
+            // model, AI-vision downscale, recording) — see app/api/v1/ai-browser/execute.
+            const res = await fetch(`${ctx.apiUrl}/api/v1/ai-browser/execute`, {
+                method: 'POST',
+                headers: {
+                    'X-API-Key': ctx.apiKey,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    instruction,
+                    maxSteps: maxSteps ?? 10,
+                    sessionId: ctx.sessionManager.activeSession?.sessionId,
+                    mode: ctx.executionMode,
+                    ...(cloudProfileId ? { cloudProfileId } : {}),
+                    ...(typeof persistContext === 'boolean' ? { persistContext } : {}),
+                    ...(viewport ? { viewport } : {}),
+                    ...(model ? { model } : {}),
+                    ...(aiVision ? { aiVision } : {}),
+                    ...(typeof recordSession === 'boolean' ? { recordSession } : {}),
+                }),
+            });
+            if (!res.ok) {
+                const errData = await res.json().catch(() => ({}));
+                return formatError(errData.error?.message ?? `AI Browser Agent failed (${res.status})`, 'Ensure you have AI credits available. Check usage at prompteryx.ai/settings.');
+            }
+            const data = await res.json();
+            // Record AI credit usage
+            if (data.creditsUsed) {
+                await recordUsage(ctx.apiKey, ctx.apiUrl, { aiCreditsUsed: data.creditsUsed });
+            }
+            const content = [];
+            // Action summary
+            content.push({
+                type: 'text',
+                text: JSON.stringify({
+                    success: true,
+                    instruction,
+                    stepsPerformed: data.steps?.length ?? 0,
+                    actions: data.steps?.map((s) => s.action) ?? [],
+                    creditsUsed: data.creditsUsed ?? 0,
+                    creditsRemaining: ctx.getAuth().aiCreditsIncluded - ctx.getAuth().aiCreditsUsedThisMonth - (data.creditsUsed ?? 0),
+                }, null, 2),
+            });
+            // Final screenshot if available
+            if (data.finalScreenshot) {
+                content.push({
+                    type: 'image',
+                    data: data.finalScreenshot,
+                    mimeType: 'image/png',
+                });
+            }
+            return { content };
+        }
+        catch (err) {
+            return formatError(`AI Browser Agent error: ${err.message}`);
+        }
+    });
+}
+//# sourceMappingURL=ai-browser-tools.js.map

package/dist/tools/ai-browser-tools.js.map

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

package/dist/tools/browser-session-manager.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Browser Session Manager
+ *
+ * Manages the lifecycle of Playwright browser sessions.
+ * - Cloud mode: creates and reuses Browserbase sessions via CDP.
+ * - Local mode: connects to the Electron desktop app at localhost:61337.
+ *
+ * Sessions persist across tool calls within a single MCP conversation
+ * and are released on browser_close or process exit.
+ */
+import type { Browser, Page, BrowserContext } from 'playwright-core';
+export interface SessionInfo {
+    browser: Browser;
+    context: BrowserContext;
+    page: Page;
+    sessionId: string;
+    mode: 'cloud' | 'local';
+    createdAt: number;
+    lastUsedAt: number;
+    debugUrl?: string;
+    connectUrl?: string;
+}
+export interface CloudSessionConfig {
+    apiKey: string;
+    apiUrl: string;
+    browserbaseProjectId: string;
+    browserbaseApiKey: string;
+    browserbaseContextId?: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    stealth?: boolean;
+    videoRecording?: boolean;
+}
+export interface LocalSessionConfig {
+    electronUrl: string;
+    chromeProfile?: string;
+}
+export declare class BrowserSessionManager {
+    private session;
+    private timeoutTimer;
+    private timeoutMs;
+    constructor(timeoutMs?: number);
+    get activeSession(): SessionInfo | null;
+    get hasSession(): boolean;
+    /**
+     * Returns the current page, creating a cloud session if needed.
+     */
+    getOrCreateCloudPage(config: CloudSessionConfig): Promise<SessionInfo>;
+    /**
+     * Creates a Browserbase session via their REST API.
+     */
+    private createBrowserbaseSession;
+    /**
+     * Connects to a local Electron instance.
+     */
+    getOrCreateLocalPage(config: LocalSessionConfig): Promise<SessionInfo>;
+    /**
+     * Gets the active page. Throws if no session exists.
+     */
+    getPage(): Page;
+    /**
+     * Returns elapsed minutes since session creation.
+     */
+    getSessionMinutes(): number;
+    /**
+     * Closes the session and releases all resources.
+     */
+    close(): Promise<{
+        minutesUsed: number;
+    }>;
+    private resetTimeout;
+}
+//# sourceMappingURL=browser-session-manager.d.ts.map

package/dist/tools/browser-session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-session-manager.d.ts","sourceRoot":"","sources":["../../src/tools/browser-session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAKD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,GAAE,MAA2B;IAIlD,IAAI,aAAa,IAAI,WAAW,GAAG,IAAI,CAEtC;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACG,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAiD5E;;OAEG;YACW,wBAAwB;IAuCtC;;OAEG;IACG,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAwC5E;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAK3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAuC/C,OAAO,CAAC,YAAY;CAMrB"}

package/dist/tools/browser-session-manager.js

@@ -0,0 +1,206 @@
+/**
+ * Browser Session Manager
+ *
+ * Manages the lifecycle of Playwright browser sessions.
+ * - Cloud mode: creates and reuses Browserbase sessions via CDP.
+ * - Local mode: connects to the Electron desktop app at localhost:61337.
+ *
+ * Sessions persist across tool calls within a single MCP conversation
+ * and are released on browser_close or process exit.
+ */
+const BROWSERBASE_API = 'https://api.browserbase.com/v1';
+const SESSION_TIMEOUT_MS = 300_000; // 5 minutes default idle timeout
+export class BrowserSessionManager {
+    session = null;
+    timeoutTimer = null;
+    timeoutMs;
+    constructor(timeoutMs = SESSION_TIMEOUT_MS) {
+        this.timeoutMs = timeoutMs;
+    }
+    get activeSession() {
+        return this.session;
+    }
+    get hasSession() {
+        return this.session !== null;
+    }
+    /**
+     * Returns the current page, creating a cloud session if needed.
+     */
+    async getOrCreateCloudPage(config) {
+        if (this.session && this.session.mode === 'cloud') {
+            this.session.lastUsedAt = Date.now();
+            this.resetTimeout();
+            return this.session;
+        }
+        // Clean up any existing session first
+        await this.close();
+        const { chromium } = await import('playwright-core');
+        // Create Browserbase session
+        const bbSession = await this.createBrowserbaseSession(config);
+        const browser = await chromium.connectOverCDP(bbSession.connectUrl);
+        const contexts = browser.contexts();
+        const context = contexts[0] || await browser.newContext();
+        const pages = context.pages();
+        const page = pages[0] || await context.newPage();
+        // Get debug URL for live viewing
+        let debugUrl;
+        try {
+            const debugRes = await fetch(`${BROWSERBASE_API}/sessions/${bbSession.id}/debug`, {
+                headers: { 'x-bb-api-key': config.browserbaseApiKey },
+            });
+            if (debugRes.ok) {
+                const debugData = await debugRes.json();
+                debugUrl = debugData.debuggerFullscreenUrl;
+            }
+        }
+        catch { /* non-critical */ }
+        this.session = {
+            browser,
+            context,
+            page,
+            sessionId: bbSession.id,
+            mode: 'cloud',
+            createdAt: Date.now(),
+            lastUsedAt: Date.now(),
+            debugUrl,
+            connectUrl: bbSession.connectUrl,
+        };
+        this.resetTimeout();
+        return this.session;
+    }
+    /**
+     * Creates a Browserbase session via their REST API.
+     */
+    async createBrowserbaseSession(config) {
+        const browserSettings = {};
+        if (config.browserbaseContextId) {
+            browserSettings.context = {
+                id: config.browserbaseContextId,
+                persist: true,
+            };
+        }
+        if (config.viewport) {
+            browserSettings.viewport = config.viewport;
+        }
+        const body = {
+            projectId: config.browserbaseProjectId,
+        };
+        if (Object.keys(browserSettings).length > 0) {
+            body.browserSettings = browserSettings;
+        }
+        const res = await fetch(`${BROWSERBASE_API}/sessions`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-bb-api-key': config.browserbaseApiKey,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Browserbase session creation failed (${res.status}): ${text}`);
+        }
+        const data = await res.json();
+        return { id: data.id, connectUrl: data.connectUrl };
+    }
+    /**
+     * Connects to a local Electron instance.
+     */
+    async getOrCreateLocalPage(config) {
+        if (this.session && this.session.mode === 'local') {
+            this.session.lastUsedAt = Date.now();
+            this.resetTimeout();
+            return this.session;
+        }
+        await this.close();
+        // Health check
+        const healthRes = await fetch(`${config.electronUrl}/status`).catch(() => null);
+        if (!healthRes || !healthRes.ok) {
+            throw new Error('Prompteryx Desktop App is not running. Start it or switch to cloud mode (remove PROMPTERYX_EXECUTION_MODE=local).');
+        }
+        const { chromium } = await import('playwright-core');
+        // The Electron app exposes a CDP endpoint
+        const browser = await chromium.connectOverCDP(`${config.electronUrl}`);
+        const contexts = browser.contexts();
+        const context = contexts[0] || await browser.newContext();
+        const pages = context.pages();
+        const page = pages[0] || await context.newPage();
+        this.session = {
+            browser,
+            context,
+            page,
+            sessionId: `local-${Date.now()}`,
+            mode: 'local',
+            createdAt: Date.now(),
+            lastUsedAt: Date.now(),
+        };
+        this.resetTimeout();
+        return this.session;
+    }
+    /**
+     * Gets the active page. Throws if no session exists.
+     */
+    getPage() {
+        if (!this.session) {
+            throw new Error('No active browser session. Call a browser tool first to create one.');
+        }
+        this.session.lastUsedAt = Date.now();
+        this.resetTimeout();
+        return this.session.page;
+    }
+    /**
+     * Returns elapsed minutes since session creation.
+     */
+    getSessionMinutes() {
+        if (!this.session)
+            return 0;
+        return (Date.now() - this.session.createdAt) / 60_000;
+    }
+    /**
+     * Closes the session and releases all resources.
+     */
+    async close() {
+        if (this.timeoutTimer) {
+            clearTimeout(this.timeoutTimer);
+            this.timeoutTimer = null;
+        }
+        if (!this.session)
+            return { minutesUsed: 0 };
+        const minutesUsed = this.getSessionMinutes();
+        const sessionId = this.session.sessionId;
+        const mode = this.session.mode;
+        try {
+            await this.session.page.close().catch(() => { });
+            await this.session.context.close().catch(() => { });
+            await this.session.browser.close().catch(() => { });
+        }
+        catch { /* best effort */ }
+        // Release Browserbase session
+        if (mode === 'cloud') {
+            try {
+                await fetch(`${BROWSERBASE_API}/sessions/${sessionId}`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'x-bb-api-key': process.env.BROWSERBASE_API_KEY || '',
+                    },
+                    body: JSON.stringify({
+                        status: 'REQUEST_RELEASE',
+                        projectId: process.env.BROWSERBASE_PROJECT_ID || '',
+                    }),
+                });
+            }
+            catch { /* best effort */ }
+        }
+        this.session = null;
+        return { minutesUsed: Math.ceil(minutesUsed) };
+    }
+    resetTimeout() {
+        if (this.timeoutTimer)
+            clearTimeout(this.timeoutTimer);
+        this.timeoutTimer = setTimeout(() => {
+            this.close().catch(() => { });
+        }, this.timeoutMs);
+    }
+}
+//# sourceMappingURL=browser-session-manager.js.map

package/dist/tools/browser-session-manager.js.map

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

package/dist/tools/browser-tools.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Browser Automation Tools
+ *
+ * 20+ MCP tools that wrap Playwright browser actions.
+ * Each tool maps to node types in lib/node-executor.ts.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AuthContext } from '../auth/api-key-auth.js';
+import { BrowserSessionManager, type CloudSessionConfig } from './browser-session-manager.js';
+interface BrowserToolsContext {
+    getAuth: () => AuthContext;
+    sessionManager: BrowserSessionManager;
+    apiKey: string;
+    apiUrl: string;
+    executionMode: 'cloud' | 'local';
+    cloudConfig: () => CloudSessionConfig;
+}
+export declare function registerBrowserTools(server: McpServer, ctx: BrowserToolsContext): void;
+export {};
+//# sourceMappingURL=browser-tools.d.ts.map

package/dist/tools/browser-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tools.d.ts","sourceRoot":"","sources":["../../src/tools/browser-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAI9F,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,WAAW,CAAC;IAC3B,cAAc,EAAE,qBAAqB,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC;IACjC,WAAW,EAAE,MAAM,kBAAkB,CAAC;CACvC;AA4BD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,QAwV/E"}