@natchs/browser-mcp 2.0.0

package/dist/index.js

@@ -0,0 +1,192 @@
+import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { fileURLToPath } from 'url';
+import { SessionManager } from './core/session.js';
+import { ToolRegistry } from './core/registry.js';
+import { PluginManager } from './core/plugin.js';
+import { createMetricsPlugin } from './core/metrics.js';
+import { createToolContext } from './core/context.js';
+import { getConfig } from './core/config.js';
+import { RateLimiter } from './core/rate-limit.js';
+import { ResultCache } from './core/cache.js';
+import { formatOutput } from './core/output.js';
+import { ErrorCode } from './core/errors.js';
+import { Pipeline, createLoggingMiddleware } from './core/pipeline.js';
+import { logger } from './core/logger.js';
+import { createAuthMiddleware } from './core/auth.js';
+import { registerPrompts } from './prompts/index.js';
+import { registerNavigationTools } from './tools/navigation/index.js';
+import { registerInteractionTools } from './tools/interaction/index.js';
+import { registerExtractionTools } from './tools/extraction/index.js';
+import { registerNetworkTools } from './tools/network/index.js';
+import { registerBrowserTools } from './tools/browser/index.js';
+import { registerSessionTools } from './tools/session/index.js';
+import { registerAdminTools } from './tools/admin/index.js';
+import { registerRETools } from './tools/re/index.js';
+import { registerStealthTools } from './tools/stealth/index.js';
+const SESSION_ID = 'default';
+function buildDefaultRegistry() {
+    const pluginManager = new PluginManager();
+    pluginManager.register(createMetricsPlugin());
+    const registry = new ToolRegistry(pluginManager);
+    registerNavigationTools(registry);
+    registerInteractionTools(registry);
+    registerExtractionTools(registry);
+    registerNetworkTools(registry);
+    registerBrowserTools(registry);
+    registerSessionTools(registry);
+    registerAdminTools(registry);
+    registerRETools(registry);
+    registerStealthTools(registry);
+    return registry;
+}
+export function createServer(registry, sessionManager, apiKey) {
+    const reg = registry ?? buildDefaultRegistry();
+    const sm = sessionManager ?? new SessionManager({
+        maxSessions: getConfig().security.maxSessions,
+    });
+    const config = getConfig();
+    const rateLimiter = new RateLimiter(config.rateLimit);
+    const cache = new ResultCache({
+        maxEntries: config.cache.maxEntries,
+        ttlMs: config.cache.ttlSeconds * 1000,
+    });
+    const server = new McpServer({ name: 'browser-mcp', version: '1.0.0' }, { capabilities: { tools: {}, prompts: {}, resources: {} } });
+    registerPrompts(server);
+    // Build middleware pipeline: log -> auth -> rate-limit
+    const pipeline = new Pipeline();
+    pipeline.use(createLoggingMiddleware());
+    pipeline.use(createAuthMiddleware(apiKey));
+    pipeline.use(async (pc, next) => {
+        if (!rateLimiter.check(pc.toolName)) {
+            return {
+                ...pc,
+                response: {
+                    content: [{ type: 'text', text: JSON.stringify({
+                                ok: false,
+                                error: { code: ErrorCode.RATE_LIMITED, message: `Rate limit exceeded for tool: ${pc.toolName}` },
+                            }) }],
+                },
+            };
+        }
+        return next();
+    });
+    const sessionProxy = {
+        getNetworkRequests: () => sm.getNetworkRequests(SESSION_ID),
+        getNetworkEntries: () => sm.getNetworkEntries(SESSION_ID),
+        getWebSocketFrames: (wsId) => sm.getWebSocketFrames(SESSION_ID, wsId),
+        flushNetworkCaptures: () => sm.flushNetworkCaptures(SESSION_ID),
+        exportNetworkLog: (format, outputPath) => sm.exportNetworkLog(SESSION_ID, format, outputPath),
+        clearNetworkRequests: () => sm.clearNetworkRequests(SESSION_ID),
+        getPendingDialog: () => sm.getPendingDialog(SESSION_ID),
+        clearPendingDialog: () => sm.clearPendingDialog(SESSION_ID),
+        getConsoleMessages: () => sm.getConsoleMessages(SESSION_ID),
+        clearConsoleMessages: () => sm.clearConsoleMessages(SESSION_ID),
+    };
+    for (const tool of reg.getAllTools()) {
+        const toolConfig = reg.getToolConfig(tool.name);
+        const needsBrowser = toolConfig?.needsBrowser !== false;
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        }, async (args) => {
+            // Cache check (before pipeline to avoid unnecessary work)
+            const isCacheable = reg.getCacheable(tool.name);
+            const cacheKey = cache.makeKey(tool.name, args);
+            if (isCacheable) {
+                const cached = cache.get(cacheKey);
+                if (cached)
+                    return JSON.parse(cached);
+            }
+            // Session
+            if (needsBrowser) {
+                await sm.getOrCreateSession(SESSION_ID);
+            }
+            // Create context
+            const ctx = createToolContext({
+                getPage: needsBrowser
+                    ? () => sm.getPage(SESSION_ID)
+                    : () => { throw new Error('This tool does not use a browser session'); },
+            }, { config, cache, rateLimiter }, needsBrowser ? sessionProxy : undefined, sm);
+            // Run pipeline (auth -> rate-limit)
+            const pc = await pipeline.run({
+                toolName: tool.name,
+                args,
+                registry: reg,
+                ctx,
+            });
+            // If middleware short-circuited (auth fail, rate limit, etc.)
+            if (pc.response) {
+                logger.warn('Handler blocked by middleware', { event: 'tool.blocked', tool: tool.name });
+                return formatOutput(pc.response, args.response_format);
+            }
+            // Execute via registry
+            const execStart = Date.now();
+            const result = await reg.execute(tool.name, args, ctx);
+            const execDuration = Date.now() - execStart;
+            const parsed = JSON.parse(result.content[0].text);
+            if (parsed.ok === false) {
+                logger.warn('Handler error', { event: 'tool.handler.error', tool: tool.name, duration: execDuration, error: parsed.error?.message ?? parsed.error });
+            }
+            else {
+                logger.info('Handler complete', { event: 'tool.handler.complete', tool: tool.name, duration: execDuration });
+            }
+            // Cache
+            if (isCacheable) {
+                cache.put(cacheKey, JSON.stringify(result));
+            }
+            return formatOutput(result, args.response_format);
+        });
+    }
+    // Register binary resource template
+    registerResourceTemplate(server, sm);
+    return server;
+}
+function registerResourceTemplate(server, sm) {
+    const binaryTemplate = new ResourceTemplate('binary://{hash}', {
+        list: async () => ({
+            resources: sm.listResources(SESSION_ID).map(r => ({
+                uri: r.uri,
+                name: r.name,
+                description: r.description,
+                mimeType: r.mimeType,
+                size: r.size,
+            })),
+        }),
+    });
+    server.resource('binary', binaryTemplate, { description: 'Binary resources captured during browser sessions (screenshots, PDFs, downloads)' }, async (uri, _variables, _extra) => {
+        const resource = sm.getResource(SESSION_ID, uri.href);
+        if (!resource)
+            throw new Error(`Resource not found: ${uri.href}`);
+        return {
+            contents: [{
+                    uri: resource.uri,
+                    mimeType: resource.mimeType,
+                    blob: resource.data.toString('base64'),
+                }],
+        };
+    });
+}
+async function main() {
+    const config = getConfig();
+    const reg = buildDefaultRegistry();
+    const networkHarEnabled = process.env.NETWORK_HAR_ENABLED !== '0';
+    const sm = new SessionManager({
+        maxSessions: config.security.maxSessions,
+        networkConfig: networkHarEnabled ? config.network : undefined,
+    });
+    const sessionApiKey = config.security.apiKey || undefined;
+    const server = createServer(reg, sm, sessionApiKey);
+    sm.startTTLChecker();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+const __filename = fileURLToPath(import.meta.url);
+const isEntry = process.argv[1] === __filename || process.argv[1] === __filename.replace(/\\/g, '/');
+if (isEntry) {
+    main().catch((err) => {
+        logger.error('Fatal error', { error: String(err) });
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAqB,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,UAAU,GAAG,SAAS,CAAC;AAE7B,SAAS,oBAAoB;IAC3B,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;IAC1C,aAAa,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,aAAa,CAAC,CAAC;IACjD,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IACnC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/B,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/B,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/B,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC7B,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC1B,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,QAAuB,EACvB,cAA+B,EAC/B,MAAe;IAEf,MAAM,GAAG,GAAG,QAAQ,IAAI,oBAAoB,EAAE,CAAC;IAC/C,MAAM,EAAE,GAAG,cAAc,IAAI,IAAI,cAAc,CAAC;QAC9C,WAAW,EAAE,SAAS,EAAE,CAAC,QAAQ,CAAC,WAAW;KAC9C,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC;QAC5B,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU;QACnC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI;KACtC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,EACzC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAC5D,CAAC;IAEF,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,uDAAuD;IACvD,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;IAE3C,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;QAC9B,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAO;gBACL,GAAG,EAAE;gBACL,QAAQ,EAAE;oBACR,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCAC7C,EAAE,EAAE,KAAK;gCACT,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,QAAQ,EAAE,EAAE;6BACjG,CAAC,EAAE,CAAC;iBACN;aACF,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAiB;QACjC,kBAAkB,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,kBAAkB,CAAC,UAAU,CAAC;QAC3D,iBAAiB,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC;QACzD,kBAAkB,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,EAAE,CAAC,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC;QAC9E,oBAAoB,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,oBAAoB,CAAC,UAAU,CAAC;QAC/D,gBAAgB,EAAE,CAAC,MAAM,EAAE,UAAmB,EAAE,EAAE,CAAC,EAAE,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC;QACtG,oBAAoB,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,oBAAoB,CAAC,UAAU,CAAC;QAC/D,gBAAgB,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,gBAAgB,CAAC,UAAU,CAAC;QACvD,kBAAkB,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,kBAAkB,CAAC,UAAU,CAAC;QAC3D,kBAAkB,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,kBAAkB,CAAC,UAAU,CAAC;QAC3D,oBAAoB,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,oBAAoB,CAAC,UAAU,CAAC;KAChE,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,UAAU,EAAE,YAAY,KAAK,KAAK,CAAC;QAExD,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;YACE,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAkB;SACrC,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;YACtC,0DAA0D;YAC1D,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAChD,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACnC,IAAI,MAAM;oBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAgB,CAAC,CAAC;YAClD,CAAC;YAED,UAAU;YACV,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,EAAE,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;YAC1C,CAAC;YAED,iBAAiB;YACjB,MAAM,GAAG,GAAG,iBAAiB,CAC3B;gBACE,OAAO,EAAE,YAAY;oBACnB,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;oBAC9B,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC,CAAC,CAAC;aAC3E,EACD,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,EAC9B,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,EACvC,EAAE,CACH,CAAC;YAEF,oCAAoC;YACpC,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC;gBAC5B,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,IAAI;gBACJ,QAAQ,EAAE,GAAG;gBACb,GAAG;aACJ,CAAC,CAAC;YAEH,8DAA8D;YAC9D,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACzF,OAAO,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAqC,CAAC,CAAC;YAC/E,CAAC;YAED,uBAAuB;YACvB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;YACvD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,MAAM,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACvJ,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;YAC/G,CAAC;YAED,QAAQ;YACR,IAAI,WAAW,EAAE,CAAC;gBAChB,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;YAC9C,CAAC;YAED,OAAO,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,eAAqC,CAAC,CAAC;QAC1E,CAAC,CACF,CAAC;IACJ,CAAC;IAED,oCAAoC;IACpC,wBAAwB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAErC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAiB,EAAE,EAAkB;IACrE,MAAM,cAAc,GAAG,IAAI,gBAAgB,CAAC,iBAAiB,EAAE;QAC7D,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACjB,SAAS,EAAE,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAChD,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;aACb,CAAC,CAAC;SACJ,CAAC;KACH,CAAC,CAAC;IAEH,MAAM,CAAC,QAAQ,CACb,QAAQ,EACR,cAAc,EACd,EAAE,WAAW,EAAE,kFAAkF,EAAE,EACnG,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE;QAChC,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,QAAQ,CAAC,GAAG;oBACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;iBACvC,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;IACnC,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,GAAG,CAAC;IAClE,MAAM,EAAE,GAAG,IAAI,cAAc,CAAC;QAC5B,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW;QACxC,aAAa,EAAE,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;KAC9D,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,SAAS,CAAC;IAC1D,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,EAAE,EAAE,aAAa,CAAC,CAAC;IACpD,EAAE,CAAC,eAAe,EAAE,CAAC;IACrB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACrG,IAAI,OAAO,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,11 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ZodTypeAny } from 'zod';
+export interface PromptDef {
+    name: string;
+    title: string;
+    description: string;
+    argsSchema?: Record<string, ZodTypeAny>;
+}
+export declare const promptDefinitions: PromptDef[];
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAK,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAEzC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACzC;AAsDD,eAAO,MAAM,iBAAiB,EAAE,SAAS,EAMxC,CAAC;AAkEF,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CASvD"}

package/dist/prompts/index.js

@@ -0,0 +1,121 @@
+import { z } from 'zod';
+const analyzePage = {
+    name: 'analyze-page',
+    title: 'Analyze Page',
+    description: 'Analyze the current page structure, metadata, and extract all useful information',
+    argsSchema: { depth: z.number().min(1).max(3).default(2).describe('Analysis depth: 1=basic, 2=detailed, 3=full') },
+};
+const scrapePage = {
+    name: 'scrape-page',
+    title: 'Scrape Page',
+    description: 'Extract structured content from the current page: text, tables, lists, images',
+    argsSchema: {
+        includeImages: z.boolean().default(false).describe('Include image URLs'),
+        includeTables: z.boolean().default(true).describe('Extract table data'),
+    },
+};
+const fillForm = {
+    name: 'fill-form',
+    title: 'Fill Form',
+    description: 'Find and fill form fields on the current page with provided data',
+    argsSchema: {
+        fields: z.string().describe('JSON object mapping field names/selectors to values'),
+        submitAfter: z.boolean().default(true).describe('Submit the form after filling'),
+    },
+};
+const bypassAuth = {
+    name: 'bypass-auth',
+    title: 'Bypass Auth',
+    description: 'Handle authentication and login forms automatically',
+    argsSchema: {
+        loginType: z.enum(['form', 'basic', 'oauth', 'token']).default('form').describe('Type of authentication'),
+        credentials: z.string().describe('JSON with username/password or token value'),
+        url: z.string().optional().describe('Login page URL if not current page'),
+    },
+};
+const pageStructure = {
+    name: 'page-structure',
+    title: 'Page Structure',
+    description: 'Analyze the DOM structure, accessibility tree, and layout of the current page',
+};
+export const promptDefinitions = [
+    analyzePage,
+    scrapePage,
+    fillForm,
+    bypassAuth,
+    pageStructure,
+];
+const handlers = {
+    'analyze-page': async (args) => {
+        const d = args.depth;
+        return {
+            description: 'Page analysis workflow',
+            messages: [
+                {
+                    role: 'user',
+                    content: { type: 'text', text: `Analyze the current page at depth ${d}:\n1. Extract page title and meta description\n2. List all headings (h1-h6) structure\n3. ${d >= 2 ? 'Extract all links and their types (internal/external)\n4. ' : ''}${d >= 3 ? 'Extract all data attributes, JSON-LD schemas, and Open Graph tags\n5. ' : ''}Identify the main content area and its structure` },
+                },
+            ],
+        };
+    },
+    'scrape-page': async (args) => {
+        const includeTables = args.includeTables;
+        const includeImages = args.includeImages;
+        return {
+            description: 'Page scraping workflow',
+            messages: [
+                {
+                    role: 'user',
+                    content: { type: 'text', text: `Scrape the current page with these options:\n- Extract all visible text content\n- ${includeTables ? 'Extract all table data as structured rows' : 'Skip tables'}\n- ${includeImages ? 'Extract all image URLs and alt texts' : 'Skip images'}\n- List all links with their href and visible text\n- Detect the primary content type (article, product, listing, form, etc.)` },
+                },
+            ],
+        };
+    },
+    'fill-form': async (args) => {
+        const fields = args.fields;
+        const submitAfter = args.submitAfter;
+        return {
+            description: 'Form filling workflow',
+            messages: [
+                {
+                    role: 'user',
+                    content: { type: 'text', text: `Fill the form on the current page:\n1. Find all form fields (input, select, textarea, button)\n2. Match fields to provided data: ${fields}\n3. Fill each field with its corresponding value\n4. ${submitAfter ? 'Click the submit button after filling' : 'Do not submit'}\n5. Return the filled field summary` },
+                },
+            ],
+        };
+    },
+    'bypass-auth': async (args) => {
+        const loginType = args.loginType;
+        const credentials = args.credentials;
+        const url = args.url;
+        return {
+            description: 'Authentication bypass workflow',
+            messages: [
+                {
+                    role: 'user',
+                    content: { type: 'text', text: `Handle ${loginType} authentication:\n${url ? `1. Navigate to ${url}\n` : '1. Current page is the login page\n'}2. Detect authentication method: ${loginType}\n3. Apply credentials: ***\n4. Submit/login\n5. Verify authentication succeeded\n6. Return session/cookie status` },
+                },
+            ],
+        };
+    },
+    'page-structure': async () => ({
+        description: 'Page structure analysis',
+        messages: [
+            {
+                role: 'user',
+                content: { type: 'text', text: 'Analyze the current page DOM structure:\n1. Document type and doctype\n2. Viewport meta tag and responsive setup\n3. Semantic HTML5 elements (header, nav, main, article, section, aside, footer)\n4. ARIA roles and accessibility attributes\n5. Iframe and embed elements\n6. Shadow DOM usage\n7. CSS framework detection (Bootstrap, Tailwind, etc.)\n8. JavaScript framework detection (React, Vue, Angular, etc.)' },
+            },
+        ],
+    }),
+};
+export function registerPrompts(server) {
+    for (const def of promptDefinitions) {
+        const handler = handlers[def.name];
+        server.registerPrompt(def.name, {
+            title: def.title,
+            description: def.description,
+            argsSchema: def.argsSchema,
+        }, handler);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

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

package/dist/tools/admin/cache.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../../core/registry.js';
+export declare const CacheStatsArgs: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const cacheStatsHandler: ToolHandler;
+export declare const ClearCacheArgs: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const clearCacheHandler: ToolHandler;
+//# sourceMappingURL=cache.d.ts.map

package/dist/tools/admin/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/tools/admin/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,eAAO,MAAM,cAAc,gDAAe,CAAC;AAE3C,eAAO,MAAM,iBAAiB,EAAE,WAQ/B,CAAC;AAEF,eAAO,MAAM,cAAc,gDAAe,CAAC;AAE3C,eAAO,MAAM,iBAAiB,EAAE,WAS/B,CAAC"}

package/dist/tools/admin/cache.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { errorResult, okResult } from '../../core/output.js';
+import { ErrorCode } from '../../core/errors.js';
+export const CacheStatsArgs = z.object({});
+export const cacheStatsHandler = async (_args, ctx) => {
+    try {
+        const stats = ctx.cache?.stats() ?? null;
+        return okResult({ stats });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.CACHE_STATS_FAILED, message);
+    }
+};
+export const ClearCacheArgs = z.object({});
+export const clearCacheHandler = async (_args, ctx) => {
+    try {
+        const before = ctx.cache?.stats() ?? { size: 0 };
+        ctx.cache?.clear();
+        return okResult({ cleared: true, removedEntries: before.size });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.CLEAR_CACHE_FAILED, message);
+    }
+};
+//# sourceMappingURL=cache.js.map

package/dist/tools/admin/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/tools/admin/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,iBAAiB,GAAgB,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IACjE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC;QACzC,OAAO,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,iBAAiB,GAAgB,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IACjE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;QACnB,OAAO,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC,CAAC"}

package/dist/tools/admin/index.d.ts

@@ -0,0 +1,3 @@
+import type { ToolRegistry } from '../../core/registry.js';
+export declare function registerAdminTools(registry: ToolRegistry): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/admin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/admin/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAK3D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAa/D"}

package/dist/tools/admin/index.js

@@ -0,0 +1,9 @@
+import { serverStatusHandler, ServerStatusArgs } from './server-status.js';
+import { cacheStatsHandler, CacheStatsArgs } from './cache.js';
+import { clearCacheHandler, ClearCacheArgs } from './cache.js';
+export function registerAdminTools(registry) {
+    registry.register({ name: 'browser_server_status', description: 'Get server status, version, session/cache/rate-limit stats', category: 'admin', schema: ServerStatusArgs }, serverStatusHandler);
+    registry.register({ name: 'browser_cache_stats', description: 'Get cache statistics (hits, misses, size)', category: 'admin', schema: CacheStatsArgs }, cacheStatsHandler);
+    registry.register({ name: 'browser_clear_cache', description: 'Clear the entire result cache', category: 'admin', schema: ClearCacheArgs }, clearCacheHandler);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/admin/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,UAAU,kBAAkB,CAAC,QAAsB;IACvD,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,uBAAuB,EAAE,WAAW,EAAE,4DAA4D,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,EACzJ,mBAAmB,CACpB,CAAC;IACF,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,qBAAqB,EAAE,WAAW,EAAE,2CAA2C,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,EACpI,iBAAiB,CAClB,CAAC;IACF,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,qBAAqB,EAAE,WAAW,EAAE,+BAA+B,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,EACxH,iBAAiB,CAClB,CAAC;AACJ,CAAC"}

package/dist/tools/admin/server-status.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../../core/registry.js';
+export declare const ServerStatusArgs: z.ZodObject<{
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, {
+    offset?: number | undefined;
+    limit?: number | undefined;
+}>;
+export declare const serverStatusHandler: ToolHandler;
+//# sourceMappingURL=server-status.d.ts.map

package/dist/tools/admin/server-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-status.d.ts","sourceRoot":"","sources":["../../../src/tools/admin/server-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1D,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AAEH,eAAO,MAAM,mBAAmB,EAAE,WAqBjC,CAAC"}

package/dist/tools/admin/server-status.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { errorResult, okResult } from '../../core/output.js';
+import { ErrorCode } from '../../core/errors.js';
+import pkg from '../../../package.json' with { type: 'json' };
+const SERVER_VERSION = pkg.version;
+export const ServerStatusArgs = z.object({
+    offset: z.number().int().min(0).optional(),
+    limit: z.number().int().min(1).max(100).optional(),
+});
+export const serverStatusHandler = async (args, ctx) => {
+    try {
+        const parsed = ServerStatusArgs.safeParse(args);
+        if (!parsed.success)
+            return errorResult(ErrorCode.INVALID_ARGS, parsed.error.message);
+        const { offset, limit } = parsed.data;
+        const cacheStats = ctx.cache?.stats() ?? null;
+        const rateLimitStats = ctx.rateLimiter?.stats() ?? null;
+        const sessions = ctx.sessionManager?.listSessions() ?? [];
+        const sessionsTotal = sessions.length;
+        return okResult({
+            version: SERVER_VERSION,
+            uptime: process.uptime(),
+            sessionsTotal,
+            cache: cacheStats,
+            rateLimiter: rateLimitStats,
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.SERVER_STATUS_FAILED, message);
+    }
+};
+//# sourceMappingURL=server-status.js.map

package/dist/tools/admin/server-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-status.js","sourceRoot":"","sources":["../../../src/tools/admin/server-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,GAAG,MAAM,uBAAuB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9D,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC;AAEnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAgB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAClE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtF,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;QACtC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC;QAC9C,MAAM,cAAc,GAAG,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC;QACxD,MAAM,QAAQ,GAAG,GAAG,CAAC,cAAc,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QAC1D,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC;QAEtC,OAAO,QAAQ,CAAC;YACd,OAAO,EAAE,cAAc;YACvB,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;YACxB,aAAa;YACb,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,cAAc;SAC5B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../../core/registry.js';
+import type { Page } from 'playwright';
+export declare const GetCookiesArgs: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const getCookiesHandler: ToolHandler<Page>;
+export declare const SetCookieArgs: z.ZodObject<{
+    name: z.ZodString;
+    value: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    domain: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    httpOnly: z.ZodOptional<z.ZodBoolean>;
+    secure: z.ZodOptional<z.ZodBoolean>;
+    sameSite: z.ZodOptional<z.ZodEnum<["Strict", "Lax", "None"]>>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    name: string;
+    path?: string | undefined;
+    url?: string | undefined;
+    domain?: string | undefined;
+    httpOnly?: boolean | undefined;
+    secure?: boolean | undefined;
+    sameSite?: "Strict" | "Lax" | "None" | undefined;
+}, {
+    value: string;
+    name: string;
+    path?: string | undefined;
+    url?: string | undefined;
+    domain?: string | undefined;
+    httpOnly?: boolean | undefined;
+    secure?: boolean | undefined;
+    sameSite?: "Strict" | "Lax" | "None" | undefined;
+}>;
+export declare const setCookieHandler: ToolHandler<Page>;
+export declare const DeleteCookiesArgs: z.ZodObject<{
+    name: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    url?: string | undefined;
+}, {
+    name: string;
+    url?: string | undefined;
+}>;
+export declare const deleteCookieHandler: ToolHandler<Page>;
+//# sourceMappingURL=cookies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/cookies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,eAAO,MAAM,cAAc,gDAAe,CAAC;AAE3C,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,IAAI,CAS/C,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;EASxB,CAAC;AAEH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,IAAI,CAiB9C,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,IAAI,CAWjD,CAAC"}

package/dist/tools/browser/cookies.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { validateUrl } from '../../core/sandbox.js';
+import { errorResult, okResult } from '../../core/output.js';
+import { ErrorCode } from '../../core/errors.js';
+export const GetCookiesArgs = z.object({});
+export const getCookiesHandler = async (_args, ctx) => {
+    try {
+        const page = await ctx.getPage();
+        const cookies = await page.context().cookies();
+        return okResult({ cookies, count: cookies.length });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.GET_COOKIES_FAILED, message);
+    }
+};
+export const SetCookieArgs = z.object({
+    name: z.string().min(1),
+    value: z.string(),
+    url: z.string().optional(),
+    domain: z.string().optional(),
+    path: z.string().optional(),
+    httpOnly: z.boolean().optional(),
+    secure: z.boolean().optional(),
+    sameSite: z.enum(['Strict', 'Lax', 'None']).optional(),
+});
+export const setCookieHandler = async (args, ctx) => {
+    const parsed = SetCookieArgs.safeParse(args);
+    if (!parsed.success)
+        return errorResult(ErrorCode.INVALID_ARGS, parsed.error.message);
+    if (parsed.data.url) {
+        const urlCheck = validateUrl(parsed.data.url);
+        if (!urlCheck.valid) {
+            return errorResult(ErrorCode.URL_BLOCKED, urlCheck.error);
+        }
+    }
+    try {
+        const page = await ctx.getPage();
+        await page.context().addCookies([parsed.data]);
+        return okResult({ set: parsed.data.name });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.SET_COOKIE_FAILED, message);
+    }
+};
+export const DeleteCookiesArgs = z.object({
+    name: z.string().min(1),
+    url: z.string().optional(),
+});
+export const deleteCookieHandler = async (args, ctx) => {
+    const parsed = DeleteCookiesArgs.safeParse(args);
+    if (!parsed.success)
+        return errorResult(ErrorCode.INVALID_ARGS, parsed.error.message);
+    try {
+        const page = await ctx.getPage();
+        await page.context().clearCookies({ name: parsed.data.name, url: parsed.data.url });
+        return okResult({ deleted: parsed.data.name });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.DELETE_COOKIE_FAILED, message);
+    }
+};
+//# sourceMappingURL=cookies.js.map

package/dist/tools/browser/cookies.js.map

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

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

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../../core/registry.js';
+import type { Page } from 'playwright';
+export declare const EvaluateArgs: z.ZodObject<{
+    code: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+}, {
+    code: string;
+}>;
+export declare const evaluateHandler: ToolHandler<Page>;
+//# sourceMappingURL=evaluate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAkBvC,eAAO,MAAM,YAAY;;;;;;EAEvB,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,IAAI,CAuC7C,CAAC"}