ai-browser 0.1.0

package/dist/api/mcp-sse.js

@@ -0,0 +1,45 @@
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { CookieStore } from '../browser/CookieStore.js';
+import { createBrowserMcpServer } from '../mcp/browser-mcp-server.js';
+export function registerMcpSseRoutes(app, sessionManager) {
+    const cookieStore = new CookieStore();
+    // sessionId -> SSEServerTransport
+    const transports = new Map();
+    // GET /mcp/sse — 建立 SSE 连接
+    app.get('/mcp/sse', (request, reply) => {
+        reply.hijack();
+        const transport = new SSEServerTransport('/mcp/message', reply.raw);
+        const mcpServer = createBrowserMcpServer(sessionManager, cookieStore);
+        const sessionId = transport.sessionId;
+        transports.set(sessionId, transport);
+        transport.onclose = () => {
+            transports.delete(sessionId);
+            mcpServer.close().catch(() => { });
+        };
+        mcpServer.connect(transport).catch((err) => {
+            app.log.error('MCP SSE connect error:', err);
+            transports.delete(sessionId);
+        });
+        request.raw.on('close', () => {
+            transports.delete(sessionId);
+            transport.close().catch(() => { });
+            mcpServer.close().catch(() => { });
+        });
+    });
+    // POST /mcp/message?sessionId=xxx — 接收 MCP 客户端消息
+    app.post('/mcp/message', async (request, reply) => {
+        const sessionId = request.query.sessionId;
+        if (!sessionId) {
+            reply.status(400).send({ error: 'sessionId query parameter required' });
+            return;
+        }
+        const transport = transports.get(sessionId);
+        if (!transport) {
+            reply.status(404).send({ error: 'SSE session not found' });
+            return;
+        }
+        // 使用 raw req/res 调用 handlePostMessage
+        await transport.handlePostMessage(request.raw, reply.raw, request.body);
+    });
+}
+//# sourceMappingURL=mcp-sse.js.map

package/dist/api/mcp-sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-sse.js","sourceRoot":"","sources":["../../src/api/mcp-sse.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAE7E,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,MAAM,UAAU,oBAAoB,CAClC,GAAoB,EACpB,cAA8B;IAE9B,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IAEtC,kCAAkC;IAClC,MAAM,UAAU,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEzD,2BAA2B;IAC3B,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACrC,KAAK,CAAC,MAAM,EAAE,CAAC;QAEf,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,sBAAsB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAEtE,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;QACtC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAErC,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE;YACvB,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7B,SAAS,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC;QAEF,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACzC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;YAC7C,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAC3B,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7B,SAAS,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAClC,SAAS,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,iDAAiD;IACjD,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAChD,MAAM,SAAS,GAAI,OAAO,CAAC,KAAa,CAAC,SAAmB,CAAC;QAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;YAC3D,OAAO;QACT,CAAC;QAED,sCAAsC;QACtC,MAAM,SAAS,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/api/routes.d.ts

@@ -0,0 +1,4 @@
+import { FastifyInstance } from 'fastify';
+import { SessionManager } from '../browser/index.js';
+export declare function registerRoutes(app: FastifyInstance, sessionManager: SessionManager): void;
+//# sourceMappingURL=routes.d.ts.map

package/dist/api/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/api/routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAmBrD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,eAAe,EACpB,cAAc,EAAE,cAAc,QA8rB/B"}

package/dist/api/routes.js

@@ -0,0 +1,628 @@
+import { randomUUID } from 'node:crypto';
+import { executeAction } from '../browser/actions.js';
+import { ElementCollector, PageAnalyzer, RegionDetector, ContentExtractor, IframeHandler, ElementMatcher, } from '../semantic/index.js';
+import { ApiError, ErrorCode } from './errors.js';
+import { BrowsingAgent } from '../agent/agent-loop.js';
+import { createBrowserMcpServer } from '../mcp/browser-mcp-server.js';
+import { CookieStore } from '../browser/CookieStore.js';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
+const MAX_BATCH_ACTIONS = 50;
+export function registerRoutes(app, sessionManager) {
+    const elementCollector = new ElementCollector();
+    const pageAnalyzer = new PageAnalyzer();
+    const regionDetector = new RegionDetector();
+    const contentExtractor = new ContentExtractor();
+    const iframeHandler = new IframeHandler();
+    const elementMatcher = new ElementMatcher();
+    // 健康检查
+    app.get('/health', async () => {
+        return { status: 'healthy', version: '0.1.0' };
+    });
+    // 内存使用情况（用于测试监控）
+    app.get('/v1/memory', async () => {
+        const mem = process.memoryUsage();
+        return {
+            rss: mem.rss,
+            heapUsed: mem.heapUsed,
+            heapTotal: mem.heapTotal,
+            external: mem.external,
+            arrayBuffers: mem.arrayBuffers,
+        };
+    });
+    // 服务信息
+    app.get('/v1/info', async () => {
+        return {
+            version: '0.1.0',
+            capabilities: ['semantic', 'action'],
+        };
+    });
+    // 创建会话
+    app.post('/v1/sessions', async (request) => {
+        const { options } = request.body || {};
+        const session = await sessionManager.create(options);
+        return {
+            sessionId: session.id,
+            status: 'created',
+        };
+    });
+    // 获取会话详情
+    app.get('/v1/sessions/:sessionId', async (request) => {
+        const { sessionId } = request.params;
+        const session = sessionManager.get(sessionId);
+        if (!session) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        const tabs = sessionManager.listTabs(sessionId);
+        return {
+            sessionId: session.id,
+            status: 'active',
+            activeTabId: session.activeTabId,
+            tabs: tabs.map(t => ({ id: t.id, url: t.url })),
+            createdAt: session.createdAt,
+            lastActivityAt: session.lastActivityAt,
+            expiresAt: session.expiresAt,
+        };
+    });
+    // 关闭会话
+    app.delete('/v1/sessions/:sessionId', async (request) => {
+        const { sessionId } = request.params;
+        const closed = await sessionManager.close(sessionId);
+        if (!closed) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        return { success: true };
+    });
+    // ========== Tab管理API ==========
+    // 创建新Tab
+    app.post('/v1/sessions/:sessionId/tabs', async (request) => {
+        const { sessionId } = request.params;
+        const { url } = request.body;
+        const session = sessionManager.get(sessionId);
+        if (!session) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        // URL验证（如果提供了URL）
+        if (url) {
+            if (typeof url !== 'string') {
+                throw new ApiError(ErrorCode.INVALID_REQUEST, 'URL must be a string', 400);
+            }
+            let parsedUrl;
+            try {
+                parsedUrl = new URL(url);
+            }
+            catch {
+                throw new ApiError(ErrorCode.INVALID_REQUEST, 'Invalid URL format', 400);
+            }
+            const allowedProtocols = ['http:', 'https:', 'file:'];
+            if (!allowedProtocols.includes(parsedUrl.protocol)) {
+                throw new ApiError(ErrorCode.INVALID_REQUEST, 'Only http/https/file URLs allowed', 400);
+            }
+        }
+        let tab;
+        try {
+            tab = await sessionManager.createTab(sessionId);
+        }
+        catch (err) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, err.message, 400);
+        }
+        if (!tab) {
+            throw new ApiError(ErrorCode.INTERNAL_ERROR, 'Failed to create tab', 500);
+        }
+        // 如果提供了URL，直接导航
+        if (url) {
+            await tab.page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30000 });
+            tab.url = tab.page.url();
+        }
+        return {
+            tabId: tab.id,
+            url: tab.url,
+            title: await tab.page.title(),
+        };
+    });
+    // 列出所有Tab
+    app.get('/v1/sessions/:sessionId/tabs', async (request) => {
+        const { sessionId } = request.params;
+        const session = sessionManager.get(sessionId);
+        if (!session) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        const tabs = sessionManager.listTabs(sessionId);
+        const tabInfos = await Promise.all(tabs.map(async (t) => ({
+            id: t.id,
+            url: t.page.url(),
+            title: await t.page.title(),
+            isActive: t.id === session.activeTabId,
+        })));
+        return { tabs: tabInfos, activeTabId: session.activeTabId };
+    });
+    // 关闭Tab
+    app.delete('/v1/sessions/:sessionId/tabs/:tabId', async (request) => {
+        const { sessionId, tabId } = request.params;
+        const closed = await sessionManager.closeTab(sessionId, tabId);
+        if (!closed) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Tab not found', 404);
+        }
+        return { success: true };
+    });
+    // 切换活动Tab
+    app.post('/v1/sessions/:sessionId/tabs/:tabId/activate', async (request) => {
+        const { sessionId, tabId } = request.params;
+        const success = sessionManager.switchTab(sessionId, tabId);
+        if (!success) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Tab not found', 404);
+        }
+        return { success: true, activeTabId: tabId };
+    });
+    // 页面导航（支持指定tabId）
+    app.post('/v1/sessions/:sessionId/navigate', async (request) => {
+        const { sessionId } = request.params;
+        const { url, tabId } = request.body;
+        // URL验证
+        if (!url || typeof url !== 'string') {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'URL is required', 400);
+        }
+        let parsedUrl;
+        try {
+            parsedUrl = new URL(url);
+        }
+        catch {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Invalid URL format', 400);
+        }
+        const allowedProtocols = ['http:', 'https:', 'file:'];
+        if (!allowedProtocols.includes(parsedUrl.protocol)) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Only http/https/file URLs allowed', 400);
+        }
+        const session = sessionManager.get(sessionId);
+        if (!session) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        // 获取目标Tab（默认使用活动Tab）
+        const tab = tabId
+            ? sessionManager.getTab(sessionId, tabId)
+            : sessionManager.getActiveTab(sessionId);
+        if (!tab) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Tab not found', 404);
+        }
+        try {
+            await tab.page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30000 });
+        }
+        catch (err) {
+            if (err.name === 'TimeoutError') {
+                throw new ApiError(ErrorCode.PAGE_LOAD_TIMEOUT, `Navigation timeout: ${url}`, 504);
+            }
+            throw new ApiError(ErrorCode.ACTION_FAILED, err.message || 'Navigation failed', 502);
+        }
+        tab.url = tab.page.url();
+        sessionManager.updateActivity(sessionId);
+        return {
+            success: true,
+            tabId: tab.id,
+            page: {
+                url: tab.page.url(),
+                title: await tab.page.title(),
+            },
+        };
+    });
+    // 获取语义元素（支持tabId参数）
+    app.get('/v1/sessions/:sessionId/semantic', async (request) => {
+        const { sessionId } = request.params;
+        const { tabId } = request.query;
+        const session = sessionManager.get(sessionId);
+        if (!session) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        const tab = tabId
+            ? sessionManager.getTab(sessionId, tabId)
+            : sessionManager.getActiveTab(sessionId);
+        if (!tab) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Tab not found', 404);
+        }
+        const [elements, analysis, regions] = await Promise.all([
+            elementCollector.collect(tab.page),
+            pageAnalyzer.analyze(tab.page),
+            regionDetector.detect(tab.page),
+        ]);
+        sessionManager.updateActivity(sessionId);
+        return {
+            tabId: tab.id,
+            page: {
+                url: tab.page.url(),
+                title: await tab.page.title(),
+                type: analysis.pageType,
+                summary: analysis.summary,
+            },
+            elements,
+            regions,
+            intents: analysis.intents,
+        };
+    });
+    // 执行操作（支持tabId）
+    app.post('/v1/sessions/:sessionId/action', async (request) => {
+        const { sessionId } = request.params;
+        const { action, elementId, value, tabId } = request.body;
+        if (!action || typeof action !== 'string') {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Action is required', 400);
+        }
+        const session = sessionManager.get(sessionId);
+        if (!session) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        const tab = tabId
+            ? sessionManager.getTab(sessionId, tabId)
+            : sessionManager.getActiveTab(sessionId);
+        if (!tab) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Tab not found', 404);
+        }
+        try {
+            await executeAction(tab.page, action, elementId, value);
+            tab.url = tab.page.url();
+            sessionManager.updateActivity(sessionId);
+            return {
+                success: true,
+                tabId: tab.id,
+                page: {
+                    url: tab.page.url(),
+                    title: await tab.page.title(),
+                },
+            };
+        }
+        catch (err) {
+            throw new ApiError(ErrorCode.ACTION_FAILED, err.message || 'Action failed', 400);
+        }
+    });
+    // 批量操作（支持tabId）
+    app.post('/v1/sessions/:sessionId/actions', async (request) => {
+        const { sessionId } = request.params;
+        const { actions, tabId } = request.body;
+        if (!Array.isArray(actions) || actions.length === 0) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Actions array required', 400);
+        }
+        if (actions.length > MAX_BATCH_ACTIONS) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, `Max ${MAX_BATCH_ACTIONS} actions allowed`, 400);
+        }
+        const session = sessionManager.get(sessionId);
+        if (!session) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        const tab = tabId
+            ? sessionManager.getTab(sessionId, tabId)
+            : sessionManager.getActiveTab(sessionId);
+        if (!tab) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Tab not found', 404);
+        }
+        const results = [];
+        for (const act of actions) {
+            if (!act || typeof act.action !== 'string') {
+                results.push({ success: false, error: 'Invalid action object' });
+                continue;
+            }
+            try {
+                await executeAction(tab.page, act.action, act.elementId, act.value);
+                results.push({ success: true });
+            }
+            catch (err) {
+                results.push({ success: false, error: err.message });
+            }
+        }
+        tab.url = tab.page.url();
+        sessionManager.updateActivity(sessionId);
+        return {
+            results,
+            tabId: tab.id,
+            page: {
+                url: tab.page.url(),
+                title: await tab.page.title(),
+            },
+        };
+    });
+    // 内容提取（支持tabId）
+    app.get('/v1/sessions/:sessionId/content', async (request) => {
+        const { sessionId } = request.params;
+        const { tabId } = request.query;
+        const session = sessionManager.get(sessionId);
+        if (!session) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        const tab = tabId
+            ? sessionManager.getTab(sessionId, tabId)
+            : sessionManager.getActiveTab(sessionId);
+        if (!tab) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Tab not found', 404);
+        }
+        const content = await contentExtractor.extract(tab.page);
+        sessionManager.updateActivity(sessionId);
+        return { tabId: tab.id, ...content };
+    });
+    // iframe信息（支持tabId）
+    app.get('/v1/sessions/:sessionId/frames', async (request) => {
+        const { sessionId } = request.params;
+        const { tabId } = request.query;
+        const session = sessionManager.get(sessionId);
+        if (!session) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        const tab = tabId
+            ? sessionManager.getTab(sessionId, tabId)
+            : sessionManager.getActiveTab(sessionId);
+        if (!tab) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Tab not found', 404);
+        }
+        const frames = await iframeHandler.detectFrames(tab.page);
+        sessionManager.updateActivity(sessionId);
+        return { tabId: tab.id, frames };
+    });
+    // 模糊匹配元素（支持tabId）
+    app.post('/v1/sessions/:sessionId/match', async (request) => {
+        const { sessionId } = request.params;
+        const { query, limit, tabId } = request.body;
+        if (!query) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Query required', 400);
+        }
+        const session = sessionManager.get(sessionId);
+        if (!session) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        const tab = tabId
+            ? sessionManager.getTab(sessionId, tabId)
+            : sessionManager.getActiveTab(sessionId);
+        if (!tab) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Tab not found', 404);
+        }
+        const elements = await elementCollector.collect(tab.page);
+        const candidates = elementMatcher.findByQuery(elements, query, limit || 5);
+        sessionManager.updateActivity(sessionId);
+        return {
+            tabId: tab.id,
+            query,
+            candidates: candidates.map((c) => ({
+                id: c.element.id,
+                label: c.element.label,
+                type: c.element.type,
+                score: c.score,
+                matchReason: c.matchReason,
+            })),
+        };
+    });
+    // 并发获取多个Tab的内容（AI批量浏览场景）
+    app.post('/v1/sessions/:sessionId/tabs/batch-content', async (request) => {
+        const { sessionId } = request.params;
+        const { tabIds } = request.body;
+        const session = sessionManager.get(sessionId);
+        if (!session) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        const tabs = tabIds
+            ? tabIds.map((id) => sessionManager.getTab(sessionId, id)).filter(Boolean)
+            : sessionManager.listTabs(sessionId);
+        const results = await Promise.all(tabs.map(async (tab) => {
+            try {
+                const [content, elements] = await Promise.all([
+                    contentExtractor.extract(tab.page),
+                    elementCollector.collect(tab.page),
+                ]);
+                return {
+                    tabId: tab.id,
+                    url: tab.page.url(),
+                    title: await tab.page.title(),
+                    content,
+                    elementCount: elements.length,
+                    success: true,
+                };
+            }
+            catch (err) {
+                return {
+                    tabId: tab.id,
+                    success: false,
+                    error: err.message,
+                };
+            }
+        }));
+        return { results };
+    });
+    // 在页面中执行JavaScript（用于精确提取数据）
+    app.post('/v1/sessions/:sessionId/evaluate', async (request) => {
+        const { sessionId } = request.params;
+        const { expression, tabId } = request.body;
+        if (!expression || typeof expression !== 'string') {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Expression is required', 400);
+        }
+        const session = sessionManager.get(sessionId);
+        if (!session) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        const tab = tabId
+            ? sessionManager.getTab(sessionId, tabId)
+            : sessionManager.getActiveTab(sessionId);
+        if (!tab) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Tab not found', 404);
+        }
+        try {
+            const result = await tab.page.evaluate(expression);
+            sessionManager.updateActivity(sessionId);
+            return { success: true, tabId: tab.id, result };
+        }
+        catch (err) {
+            throw new ApiError(ErrorCode.ACTION_FAILED, err.message || 'Evaluate failed', 400);
+        }
+    });
+    // 等待指定时间（配合动态内容加载）
+    app.post('/v1/sessions/:sessionId/wait', async (request) => {
+        const { sessionId } = request.params;
+        const { milliseconds, selector, tabId } = request.body;
+        const session = sessionManager.get(sessionId);
+        if (!session) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        const tab = tabId
+            ? sessionManager.getTab(sessionId, tabId)
+            : sessionManager.getActiveTab(sessionId);
+        if (!tab) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Tab not found', 404);
+        }
+        try {
+            if (selector) {
+                await tab.page.waitForSelector(selector, { timeout: milliseconds || 10000 });
+            }
+            else {
+                await new Promise(r => setTimeout(r, Math.min(milliseconds || 1000, 30000)));
+            }
+            sessionManager.updateActivity(sessionId);
+            return { success: true, tabId: tab.id };
+        }
+        catch (err) {
+            throw new ApiError(ErrorCode.ACTION_FAILED, err.message || 'Wait failed', 400);
+        }
+    });
+    // ========== Screenshot API ==========
+    app.get('/v1/sessions/:sessionId/screenshot', async (request) => {
+        const { sessionId } = request.params;
+        const session = sessionManager.get(sessionId);
+        if (!session) {
+            throw new ApiError(ErrorCode.SESSION_NOT_FOUND, 'Session not found', 404);
+        }
+        const tab = sessionManager.getActiveTab(sessionId);
+        if (!tab) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'No active tab', 404);
+        }
+        const base64 = await tab.page.screenshot({ type: 'png', encoding: 'base64' });
+        return { image: `data:image/png;base64,${base64}` };
+    });
+    // ========== Agent API ==========
+    const MAX_CONCURRENT_AGENTS = 5;
+    const AGENT_HARD_TIMEOUT = 10 * 60 * 1000; // 10 minutes
+    const AGENT_CLEANUP_DELAY = 60 * 1000; // 60s after done
+    const runningAgents = new Map();
+    // 进程级 CookieStore，跨 agent 共享，保持登录状态
+    const cookieStore = new CookieStore();
+    app.post('/v1/agent/run', async (request) => {
+        const { task, apiKey, baseURL, model, messages, maxIterations, headless } = request.body;
+        if (!task || typeof task !== 'string') {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'task is required', 400);
+        }
+        // Concurrency limit
+        const activeCount = [...runningAgents.values()].filter(e => !e.finished).length;
+        if (activeCount >= MAX_CONCURRENT_AGENTS) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, `Max ${MAX_CONCURRENT_AGENTS} concurrent agents`, 429);
+        }
+        // Create MCP Server + InMemoryTransport + MCP Client
+        const mcpHeadless = headless !== undefined ? { headless: headless } : {};
+        const mcpServer = createBrowserMcpServer(sessionManager, cookieStore, mcpHeadless);
+        const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+        await mcpServer.connect(serverTransport);
+        const mcpClient = new Client({ name: 'agent', version: '0.1.0' });
+        await mcpClient.connect(clientTransport);
+        const agent = new BrowsingAgent({
+            apiKey: apiKey || undefined,
+            baseURL: baseURL || undefined,
+            model: model || undefined,
+            mcpClient,
+            maxIterations: maxIterations || undefined,
+            initialMessages: messages || undefined,
+        });
+        const agentId = randomUUID();
+        const entry = { agent, buffer: [], finished: false };
+        // Buffer all events so SSE client can replay them on connect
+        // Skip duplicate done events (hard timeout may race with agent completion)
+        agent.on('event', (event) => {
+            if (entry.finished && event.type === 'done')
+                return;
+            entry.buffer.push(event);
+            if (event.type === 'done') {
+                entry.finished = true;
+                if (entry.cleanupTimer)
+                    clearTimeout(entry.cleanupTimer);
+                entry.cleanupTimer = setTimeout(() => runningAgents.delete(agentId), AGENT_CLEANUP_DELAY);
+            }
+        });
+        runningAgents.set(agentId, entry);
+        // Hard timeout: force cleanup if agent runs too long
+        entry.cleanupTimer = setTimeout(async () => {
+            if (!entry.finished) {
+                entry.finished = true;
+                entry.buffer.push({ type: 'done', success: false, error: 'Agent timeout', iterations: 0 });
+                agent.emit('event', { type: 'done', success: false, error: 'Agent timeout', iterations: 0 });
+            }
+            try {
+                await mcpClient.close();
+            }
+            catch { }
+            try {
+                await mcpServer.close();
+            }
+            catch { }
+            setTimeout(() => runningAgents.delete(agentId), AGENT_CLEANUP_DELAY);
+        }, AGENT_HARD_TIMEOUT);
+        // Fire-and-forget with error handling + MCP cleanup
+        agent.run(task).catch((err) => {
+            if (!entry.finished) {
+                entry.finished = true;
+                const errEvent = { type: 'done', success: false, error: err.message, iterations: 0 };
+                entry.buffer.push(errEvent);
+                agent.emit('event', errEvent);
+            }
+        }).finally(async () => {
+            try {
+                await mcpClient.close();
+            }
+            catch { }
+            try {
+                await mcpServer.close();
+            }
+            catch { }
+        });
+        return { agentId };
+    });
+    app.get('/v1/agent/:agentId/events', (request, reply) => {
+        const { agentId } = request.params;
+        const entry = runningAgents.get(agentId);
+        if (!entry) {
+            reply.status(404).send({ error: { code: 'INVALID_REQUEST', message: 'Agent not found' } });
+            return;
+        }
+        reply.hijack();
+        reply.raw.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            'Connection': 'keep-alive',
+        });
+        const onEvent = (event) => {
+            reply.raw.write(`data: ${JSON.stringify(event)}\n\n`);
+            if (event.type === 'done') {
+                reply.raw.end();
+            }
+        };
+        // Replay buffered events first (synchronous, no events can interleave)
+        for (const event of entry.buffer) {
+            reply.raw.write(`data: ${JSON.stringify(event)}\n\n`);
+        }
+        // If agent already finished, close stream immediately
+        if (entry.finished) {
+            reply.raw.end();
+            return;
+        }
+        // Only now attach live listener for future events
+        entry.agent.on('event', onEvent);
+        request.raw.on('close', () => {
+            entry.agent.removeListener('event', onEvent);
+        });
+    });
+    // ========== Agent Input (ask_human response) ==========
+    app.post('/v1/agent/:agentId/input', async (request) => {
+        const { agentId: aid } = request.params;
+        const { requestId, response } = request.body;
+        if (!requestId || !response || typeof response !== 'object') {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'requestId and response are required', 400);
+        }
+        const entry = runningAgents.get(aid);
+        if (!entry) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'Agent not found', 404);
+        }
+        const resolved = entry.agent.resolveInput(requestId, response);
+        if (!resolved) {
+            throw new ApiError(ErrorCode.INVALID_REQUEST, 'No pending input with this requestId', 400);
+        }
+        return { success: true };
+    });
+}
+//# sourceMappingURL=routes.js.map