@agimon-ai/browse-tool 0.2.8 → 0.2.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.cjs +1 -1
- package/dist/cli.cjs.map +1 -1
- package/dist/cli.mjs +1 -1
- package/dist/cli.mjs.map +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.mjs +1 -1
- package/dist/{playwright-test-CGgt4gB5.cjs → playwright-test-Gy2QgWt3.cjs} +2 -2
- package/dist/{playwright-test-CGgt4gB5.cjs.map → playwright-test-Gy2QgWt3.cjs.map} +1 -1
- package/dist/streamable-http-BF_kFDOr.mjs +13 -0
- package/dist/streamable-http-BF_kFDOr.mjs.map +1 -0
- package/dist/streamable-http-DEnR3pMh.cjs +13 -0
- package/dist/streamable-http-DEnR3pMh.cjs.map +1 -0
- package/dist/stubs/playwright-test.cjs +1 -1
- package/package.json +3 -2
- package/dist/streamable-http-BFbkLZAL.mjs +0 -14
- package/dist/streamable-http-BFbkLZAL.mjs.map +0 -1
- package/dist/streamable-http-CkhxOp5e.cjs +0 -15
- package/dist/streamable-http-CkhxOp5e.cjs.map +0 -1
package/dist/cli.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{C as e,S as t,_ as n,a as r,b as i,c as a,d as o,f as s,g as c,h as l,i as u,l as d,m as f,n as p,o as m,p as h,s as g,t as _,u as v,v as y,x as b,y as x}from"./streamable-http-BFbkLZAL.mjs";import"./playwright-test-BwI7HgW7.mjs";import{stripTypeScriptTypes as S}from"node:module";import"reflect-metadata/lite";import{Command as C,Option as w}from"commander";import{serve as ee}from"@hono/node-server";import{Server as T}from"@modelcontextprotocol/sdk/server/index.js";import{StdioServerTransport as te}from"@modelcontextprotocol/sdk/server/stdio.js";import{CallToolRequestSchema as ne,ListToolsRequestSchema as re}from"@modelcontextprotocol/sdk/types.js";import{Hono as E}from"hono";import{cors as ie}from"hono/cors";import{Container as ae,ContainerModule as oe}from"inversify";import{existsSync as D,readFileSync as se,statSync as ce}from"node:fs";import O from"node:path";import{SpanStatusCode as k}from"@opentelemetry/api";import{PortRegistryService as le}from"@agimon-ai/foundation-port-registry";import{homedir as ue}from"node:os";import{z as A}from"zod";import{readFile as de,stat as fe}from"node:fs/promises";import{createNodeWebSocket as pe}from"@hono/node-ws";import{raw as me}from"hono/html";import{Fragment as he,jsx as j,jsxs as M}from"hono/jsx/jsx-runtime";var ge=`0.2.7`;const _e=process.env.BROWSE_TOOL_DEBUG_EXTENSION_RECORDING===`1`;function ve(e,t){if(!_e)return;let n=t?` ${JSON.stringify(t)}`:``;console.log(`[ExtensionRecordingDebug] ${e}${n}`)}function ye(n){let r=new E,i;try{i=n.get(e.TelemetryService)}catch{i=new b}return r.get(`/telemetry-config`,e=>{try{let n=new URL(e.req.url).origin;return e.json(t(process.env,n))}catch(t){return e.json({enabled:!1,error:t instanceof Error?t.message:String(t)},500)}}),r.get(`/tasks`,t=>{try{let r=n.get(e.ExtensionTaskQueue).getNextTask();return r?t.json({task:{id:r.id,tool:r.tool,arguments:r.arguments,telemetry:r.telemetry}}):t.json({})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/result`,async t=>{try{let r=await t.req.json();if(!r.taskId)return t.json({success:!1,error:`Missing taskId in request body`},400);let i=n.get(e.ExtensionTaskQueue),a=n.get(e.BrowserService),o={taskId:r.taskId,success:r.success,result:r.result,error:r.error},s=i.submitResult(o);return s?(s.browserId&&a.recordBrowserActivity(s.browserId,s.pageId),t.json({success:!0})):t.json({success:!1,error:`Task ${r.taskId} not found or already completed`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.get(`/status`,t=>{try{let r=n.get(e.ExtensionTaskQueue),i=r.getConnectionStatus(),a={connected:i.connected,lastPollAt:i.lastPollAt?.toISOString(),lastResultAt:i.lastResultAt?.toISOString(),pendingTasks:i.pendingTasks,queueSize:r.queueSize};return t.json(a)}catch(e){return t.json({connected:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/register`,async t=>{try{let r=await t.req.json();if(!r.browserId)return t.json({success:!1,error:`Missing browserId in request body`},400);let i=n.get(e.ExtensionSessionRegistry).register(r);return t.json({success:!0,session:{id:i.id,browserId:i.browserId,controlMode:i.controlMode,createdAt:i.createdAt.toISOString()}})}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/heartbeat`,async t=>{try{let r=await t.req.json();if(!r.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let i=n.get(e.ExtensionSessionRegistry).heartbeat(r);return i?t.json({success:!0,session:{id:i.id,controlMode:i.controlMode,handoffRequested:i.handoffRequested,lastHeartbeatAt:i.lastHeartbeatAt.toISOString()}}):t.json({success:!1,error:`Session ${r.sessionId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/tab-mapped`,async t=>{try{let r=await t.req.json();if(!r.pageId||typeof r.tabId!=`number`)return t.json({success:!1,error:`Missing pageId or tabId in request body`},400);let i=n.get(e.PageRegistry),a=n.get(e.BrowserService),o=i.get(r.pageId);return o?(o.extensionTabId=r.tabId,a.recordBrowserActivity(o.browserId,r.pageId),t.json({success:!0})):t.json({success:!1,error:`Page ${r.pageId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/recording`,async t=>{try{let r=await t.req.json();if(!r.browserId)return t.json({success:!1,error:`Missing browserId in request body`},400);let i=n.get(e.BrowserService),a=await i.persistExtensionRecordingArtifact(r.browserId,r.videoBase64);return ve(`artifact received`,{browserId:r.browserId,videoBase64Size:r.videoBase64?.length??0,persisted:a}),a?(i.recordBrowserActivity(r.browserId),t.json({success:!0})):t.json({success:!1,error:`Browser "${r.browserId}" has no active recording target`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/recording/chunk`,async t=>{try{let r=await t.req.json();if(!r.browserId||!r.chunkBase64)return t.json({success:!1,error:`Missing browserId or chunkBase64 in request body`},400);let a=n.get(e.BrowserService),o=await a.persistExtensionRecordingChunk(r.browserId,r.chunkBase64);return ve(`chunk received`,{browserId:r.browserId,chunkIndex:r.chunkIndex,mimeType:r.mimeType,persisted:!!o,chunkBase64Size:r.chunkBase64.length}),o?(i.log(`debug`,`extension recording chunk received`,{attributes:{"browse_tool.extension.recording.chunk_received":!0,"browse_tool.browser.id":r.browserId,"browse_tool.recording.chunk_bytes":o.chunkBytes,"browse_tool.recording.total_bytes":o.totalBytes,"browse_tool.recording.chunk_count":o.chunkCount,...typeof r.chunkIndex==`number`?{"browse_tool.recording.chunk_index":r.chunkIndex}:{},...typeof r.mimeType==`string`?{"browse_tool.recording.mime_type":r.mimeType}:{}}}),a.recordBrowserActivity(r.browserId),t.json({success:!0})):t.json({success:!1,error:`Browser "${r.browserId}" has no active recording target`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/browser-log`,async e=>{try{let t=await e.req.json();return!t.message||typeof t.message!=`string`?e.json({success:!1,error:`Missing message in request body`},400):(i.log(t.level??`info`,t.message,{attributes:{"browse_tool.extension.log_relay":!0,...typeof t.attributes==`object`&&t.attributes!==null?t.attributes:{}}}),ve(`browser log relayed`,{level:t.level??`info`,message:t.message,attributes:t.attributes}),e.json({success:!0}))}catch(t){return e.json({success:!1,error:t instanceof Error?t.message:String(t)},500)}}),r.post(`/handoff`,async t=>{try{let r=await t.req.json();if(!r.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let i=n.get(e.ExtensionSessionRegistry).requestHandoff(r);return i?t.json({success:!0,message:`Handoff requested. AI will take control when ready.`,session:{id:i.id,controlMode:i.controlMode,handoffRequested:i.handoffRequested}}):t.json({success:!1,error:`Session ${r.sessionId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/handoff/acknowledge`,async t=>{try{let r=await t.req.json();if(!r.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let i=n.get(e.ExtensionSessionRegistry).acknowledgeHandoff(r.sessionId);return i?t.json({success:!0,message:`Handoff acknowledged. AI now has control.`,session:{id:i.id,controlMode:i.controlMode,handoffRequested:i.handoffRequested}}):t.json({success:!1,error:`Session ${r.sessionId} not found or no handoff pending`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.get(`/sessions`,t=>{try{let r=n.get(e.ExtensionSessionRegistry).listSessions();return t.json({sessions:r.map(e=>({id:e.id,browserId:e.browserId,tabId:e.tabId,currentUrl:e.currentUrl,controlMode:e.controlMode,activeSpecPath:e.activeSpecPath,handoffRequested:e.handoffRequested,createdAt:e.createdAt.toISOString(),lastHeartbeatAt:e.lastHeartbeatAt.toISOString()}))})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}}),r}function be(){return new oe(t=>{t.bind(e.ExtensionTaskQueue).to(i).inSingletonScope(),t.bind(e.ExtensionToolDelegator).to(x).inSingletonScope()})}function xe(e){let t=new T({name:`browse-tool-chrome`,version:`0.1.0`},{capabilities:{tools:{}}}),n=e.getSupportedTools().map(e=>({name:e,description:`Browser automation tool (Chrome extension mode): ${e}`,inputSchema:{type:`object`,properties:{},additionalProperties:!0}}));return t.setRequestHandler(re,async()=>({tools:n})),t.setRequestHandler(ne,async t=>{let{name:n,arguments:r}=t.params;return await e.executeTool(n,r||{})}),t}const Se=new C(`chrome-serve`).description(`[DEPRECATED] Start MCP server with Chrome extension HTTP polling for bot-detection-free browser automation`).option(`-p, --port <port>`,`HTTP server port for extension polling`,`3200`).option(`-v, --verbose`,`Enable verbose output`,!1).option(`--wait-for-extension`,`Wait for extension to connect before accepting MCP requests`,!1).action(async t=>{console.error(``),console.error(`╔════════════════════════════════════════════════════════════════╗`),console.error(`║ DEPRECATED: chrome-serve is deprecated. ║`),console.error(`║ Use mcp-serve instead - extension routes are now ║`),console.error(`║ automatically available in the HTTP server at /extension/*. ║`),console.error(`╚════════════════════════════════════════════════════════════════╝`),console.error(``);try{let n=typeof t.port==`string`?Number.parseInt(t.port,10):t.port;t.verbose&&(console.error(`Chrome Extension MCP Server starting...`),console.error(` HTTP Port: ${n}`),console.error(` Wait for extension: ${t.waitForExtension}`));let r=new ae({defaultScope:`Singleton`});r.load(be());let i=r.get(e.ExtensionTaskQueue),a=r.get(e.ExtensionToolDelegator),o=new E;o.use(`*`,ie({origin:e=>e??null,credentials:!0,allowMethods:[`GET`,`POST`,`OPTIONS`],allowHeaders:[`Content-Type`,`Accept`]}));let s=ye(r);o.route(`/extension`,s),o.get(`/health`,e=>{let t=i.getConnectionStatus();return e.json({status:`healthy`,service:`browse-tool-chrome`,extension:t})});let c=ee({fetch:o.fetch,port:n});c.on(`error`,e=>{e.code===`EADDRINUSE`?(console.error(`Error [PORT_IN_USE]: Port ${n} is already in use.`),console.error(`Recovery: Try a different port with --port <port>`)):console.error(`Error [SERVER_ERROR]: HTTP server error: ${e.message}`),process.exit(1)}),console.error(`HTTP server started on port ${n}`),console.error(`Waiting for Chrome extension to connect...`),console.error(`Extension should poll: http://localhost:${n}/extension/tasks`),t.waitForExtension&&(console.error(`Waiting for extension connection before starting MCP...`),await new Promise(e=>{let t=setInterval(()=>{i.getConnectionStatus().connected&&(clearInterval(t),console.error(`Extension connected!`),e())},500)}));let l=xe(a),u=new te;await l.connect(u),console.error(`Chrome extension MCP server started on stdio`);let d=async e=>{console.error(`\nReceived ${e}, shutting down gracefully...`);try{i.clearAllTasks(`Server shutting down`),await u.close(),c.close(),process.exit(0)}catch(e){console.error(`Error during shutdown:`,e),process.exit(1)}};process.on(`SIGINT`,()=>d(`SIGINT`)),process.on(`SIGTERM`,()=>d(`SIGTERM`))}catch(e){let t=e instanceof Error?e.message:String(e);console.error(`Error [SERVER_ERROR]: Failed to start Chrome extension MCP server: ${t}`),console.error(`Recovery: Check that the port is available and try again.`),process.exit(1)}}),Ce=`BROWSE_TOOL_CONFIG`,we=`.browse-tool`,Te=`config.json`,Ee=[`json`,`text`,`quiet`],De={commands:{},tools:{}},Oe=A.record(A.string(),A.unknown()),ke=A.object({mcpServe:A.object({type:A.string().optional(),browser:A.string().optional(),headless:A.boolean().optional(),profile:A.string().optional(),mode:A.string().optional(),host:A.string().optional(),port:A.coerce.number().int().positive().optional(),tags:A.string().optional(),exclude:A.string().optional(),customTools:A.string().optional(),snippetsDir:A.string().optional(),registryPath:A.string().optional(),registryDir:A.string().optional(),pidsDir:A.string().optional(),profilesDir:A.string().optional()}).partial().optional(),httpServe:A.object({port:A.coerce.number().int().positive().optional(),headless:A.boolean().optional(),idleTimeout:A.coerce.number().positive().optional(),host:A.string().optional(),registryDir:A.string().optional(),registryPath:A.string().optional(),pidsDir:A.string().optional(),profilesDir:A.string().optional(),snippetsDir:A.string().optional()}).partial().optional(),exec:A.object({format:A.enum(Ee).optional(),color:A.boolean().optional(),port:A.coerce.number().int().positive().optional()}).partial().optional(),tools:A.object({format:A.enum(Ee).optional(),color:A.boolean().optional(),port:A.coerce.number().int().positive().optional()}).partial().optional(),status:A.record(A.string(),A.unknown()).optional(),stop:A.record(A.string(),A.unknown()).optional()}),Ae=A.object({commands:ke.default({}),tools:A.record(A.string(),Oe).default({})});let N={config:De};function je(e){for(let t=0;t<e.length;t+=1){let n=e[t];if(n===`--config`)return e[t+1];if(n.startsWith(`--config=`))return n.slice(9)}}function Me(e){let t=O.resolve(e);if(!D(t))throw Error(`Config path not found: ${t}`);return ce(t).isDirectory()?O.join(t,Te):t}function Ne(e,t){let n=t.env??process.env,r=t.cwd??process.cwd(),i=t.homeDir??ue(),a=je(e);if(a)return Me(a);if(n[Ce])return Me(n[Ce]);let o=O.join(r,we,Te);if(D(o))return o;let s=O.join(i,we,Te);if(D(s))return s}function Pe(e){let t=se(e,`utf8`),n=JSON.parse(t);return Ae.parse(n)}function Fe(e,t={}){let n=Ne(e,t);return n?{configPath:n,config:Pe(n)}:{config:De}}function Ie(e,t={}){return N=Fe(e,t),N}function P(e){return(N.config.commands??{})[e]??{}}function Le(e){return N.config.tools?.[e]??{}}function F(e,t,n,r,i){let a=e.getOptionValueSourceWithGlobals(t);return a!==void 0&&a!==`default`&&a!==`implied`?n:i===void 0?r===void 0?n:r:i}var Re=class{port;exactPort;timeout;serverPort=null;constructor(e={}){this.port=e.port??3200,this.exactPort=e.exactPort??!1,this.timeout=e.timeout??6e4}async ensureServer(){if(this.serverPort!==null)return this.serverPort;let t=await m().get(e.HttpServerManager).ensureRunning(this.port,{exactPort:this.exactPort});if(!t.running||!t.port)throw Error(t.error??`Failed to start HTTP server. Try running "browse-tool http-serve" manually.`);return this.serverPort=t.port,t.port}async getBaseUrl(){return`http://localhost:${await this.ensureServer()}`}async listTools(){let e=await this.getBaseUrl(),t=new AbortController,n=setTimeout(()=>t.abort(),this.timeout);try{let n=await fetch(`${e}/tools`,{method:`GET`,headers:{Accept:`application/json`},signal:t.signal});if(!n.ok)throw Error(`HTTP ${n.status}: ${n.statusText}`);let r=await n.json();if(r.error)throw Error(r.error);return r.tools}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(n)}}async listCustomTools(e){let t=await this.getBaseUrl(),n=new AbortController,r=setTimeout(()=>n.abort(),this.timeout);try{let r=new URL(`/custom-tools`,t);r.searchParams.set(`dir`,e);let i=await fetch(r,{method:`GET`,headers:{Accept:`application/json`},signal:n.signal});if(!i.ok)throw Error(`HTTP ${i.status}: ${i.statusText}`);let a=await i.json();if(a.error)throw Error(a.error);return a.tools}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(r)}}async listBrowsers(){let e=await this.getBaseUrl(),t=new AbortController,n=setTimeout(()=>t.abort(),this.timeout);try{let n=await fetch(`${e}/browsers`,{method:`GET`,headers:{Accept:`application/json`},signal:t.signal});if(!n.ok)throw Error(`HTTP ${n.status}: ${n.statusText}`);let r=await n.json();if(r.error)throw Error(r.error);return r.browsers}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(n)}}async execute(e,t){let n=await this.getBaseUrl(),r=e===`run_spec`?void 0:this.timeout,i=new AbortController,a=r===void 0?void 0:setTimeout(()=>i.abort(),r);try{let a=await fetch(`${n}/execute`,{method:`POST`,headers:{"Content-Type":`application/json`,Accept:`application/json`},body:JSON.stringify({tool:e,arguments:t}),signal:r===void 0?void 0:i.signal});if(!a.ok){let e=await a.text();throw Error(`HTTP ${a.status}: ${e||a.statusText}`)}let o=await a.json();return o.success?o.result??{content:[{type:`text`,text:`No result returned`}]}:{content:[{type:`text`,text:o.error??`Unknown error`}],isError:!0}}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{a&&clearTimeout(a)}}async executeCustomTool(e,t,n){let r=await this.getBaseUrl(),i=new AbortController,a=setTimeout(()=>i.abort(),this.timeout);try{let a=new URL(`/custom-tools`,r);a.searchParams.set(`dir`,e);let o=await fetch(a,{method:`POST`,headers:{"Content-Type":`application/json`,Accept:`application/json`},body:JSON.stringify({tool:t,arguments:n}),signal:i.signal});if(!o.ok){let e=await o.text();throw Error(`HTTP ${o.status}: ${e||o.statusText}`)}let s=await o.json();return s.success?s.result??{content:[{type:`text`,text:`No result returned`}]}:{content:[{type:`text`,text:s.error??`Unknown error`}],isError:!0}}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(a)}}wrapConnectionError(e){return e instanceof Error?e.message.includes(`ECONNREFUSED`)||e.message.includes(`fetch failed`)?Error(`Cannot connect to browse-tool HTTP server.\n\nTry one of the following:\n 1. Start the server: browse-tool http-serve\n 2. Check if another process is using port ${this.port}\n 3. Run with a different port: browse-tool --port 3201 <command>\n\nOriginal error: ${e.message}`,{cause:e}):e:Error(String(e),{cause:e})}};function I(e){return new Re(e)}const ze={reset:`\x1B[0m`,red:`\x1B[31m`,green:`\x1B[32m`,yellow:`\x1B[33m`,blue:`\x1B[34m`,magenta:`\x1B[35m`,cyan:`\x1B[36m`,gray:`\x1B[90m`,bold:`\x1B[1m`};function L(e,t,n){return n?`${ze[t]}${e}${ze.reset}`:e}function R(e,t){let{format:n,color:r}=t;return n===`quiet`?``:n===`json`?Be(e):Ve(e,r)}function Be(e){return JSON.stringify(e,null,2)}function Ve(e,t){let n=[];e.isError&&n.push(L(`Error:`,`red`,t));for(let r of e.content)r.type===`text`?n.push(He(r,t)):r.type===`image`?n.push(Ge(r,t)):n.push(L(`[Unknown content type: ${r.type}]`,`yellow`,t));return n.join(`
|
|
2
|
+
import{C as e,S as t,_ as n,a as r,b as i,c as a,d as o,f as s,g as c,h as l,i as u,l as d,m as f,n as p,o as m,p as h,s as g,t as _,u as v,v as y,x as b,y as x}from"./streamable-http-BF_kFDOr.mjs";import"./playwright-test-BwI7HgW7.mjs";import{stripTypeScriptTypes as S}from"node:module";import"reflect-metadata/lite";import{Command as C,Option as w}from"commander";import{serve as ee}from"@hono/node-server";import{Server as T}from"@modelcontextprotocol/sdk/server/index.js";import{StdioServerTransport as te}from"@modelcontextprotocol/sdk/server/stdio.js";import{CallToolRequestSchema as ne,ListToolsRequestSchema as re}from"@modelcontextprotocol/sdk/types.js";import{Hono as E}from"hono";import{cors as ie}from"hono/cors";import{Container as ae,ContainerModule as oe}from"inversify";import{existsSync as D,readFileSync as se,statSync as ce}from"node:fs";import O from"node:path";import{SpanStatusCode as k}from"@opentelemetry/api";import{PortRegistryService as le}from"@agimon-ai/foundation-port-registry";import{homedir as ue}from"node:os";import{z as A}from"zod";import{readFile as de,stat as fe}from"node:fs/promises";import{createNodeWebSocket as pe}from"@hono/node-ws";import{raw as me}from"hono/html";import{Fragment as he,jsx as j,jsxs as M}from"hono/jsx/jsx-runtime";var ge=`0.2.8`;const _e=process.env.BROWSE_TOOL_DEBUG_EXTENSION_RECORDING===`1`;function ve(e,t){if(!_e)return;let n=t?` ${JSON.stringify(t)}`:``;console.log(`[ExtensionRecordingDebug] ${e}${n}`)}function ye(n){let r=new E,i;try{i=n.get(e.TelemetryService)}catch{i=new b}return r.get(`/telemetry-config`,e=>{try{let n=new URL(e.req.url).origin;return e.json(t(process.env,n))}catch(t){return e.json({enabled:!1,error:t instanceof Error?t.message:String(t)},500)}}),r.get(`/tasks`,t=>{try{let r=n.get(e.ExtensionTaskQueue).getNextTask();return r?t.json({task:{id:r.id,tool:r.tool,arguments:r.arguments,telemetry:r.telemetry}}):t.json({})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/result`,async t=>{try{let r=await t.req.json();if(!r.taskId)return t.json({success:!1,error:`Missing taskId in request body`},400);let i=n.get(e.ExtensionTaskQueue),a=n.get(e.BrowserService),o={taskId:r.taskId,success:r.success,result:r.result,error:r.error},s=i.submitResult(o);return s?(s.browserId&&a.recordBrowserActivity(s.browserId,s.pageId),t.json({success:!0})):t.json({success:!1,error:`Task ${r.taskId} not found or already completed`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.get(`/status`,t=>{try{let r=n.get(e.ExtensionTaskQueue),i=r.getConnectionStatus(),a={connected:i.connected,lastPollAt:i.lastPollAt?.toISOString(),lastResultAt:i.lastResultAt?.toISOString(),pendingTasks:i.pendingTasks,queueSize:r.queueSize};return t.json(a)}catch(e){return t.json({connected:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/register`,async t=>{try{let r=await t.req.json();if(!r.browserId)return t.json({success:!1,error:`Missing browserId in request body`},400);let i=n.get(e.ExtensionSessionRegistry).register(r);return t.json({success:!0,session:{id:i.id,browserId:i.browserId,controlMode:i.controlMode,createdAt:i.createdAt.toISOString()}})}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/heartbeat`,async t=>{try{let r=await t.req.json();if(!r.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let i=n.get(e.ExtensionSessionRegistry).heartbeat(r);return i?t.json({success:!0,session:{id:i.id,controlMode:i.controlMode,handoffRequested:i.handoffRequested,lastHeartbeatAt:i.lastHeartbeatAt.toISOString()}}):t.json({success:!1,error:`Session ${r.sessionId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/tab-mapped`,async t=>{try{let r=await t.req.json();if(!r.pageId||typeof r.tabId!=`number`)return t.json({success:!1,error:`Missing pageId or tabId in request body`},400);let i=n.get(e.PageRegistry),a=n.get(e.BrowserService),o=i.get(r.pageId);return o?(o.extensionTabId=r.tabId,a.recordBrowserActivity(o.browserId,r.pageId),t.json({success:!0})):t.json({success:!1,error:`Page ${r.pageId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/recording`,async t=>{try{let r=await t.req.json();if(!r.browserId)return t.json({success:!1,error:`Missing browserId in request body`},400);let i=n.get(e.BrowserService),a=await i.persistExtensionRecordingArtifact(r.browserId,r.videoBase64);return ve(`artifact received`,{browserId:r.browserId,videoBase64Size:r.videoBase64?.length??0,persisted:a}),a?(i.recordBrowserActivity(r.browserId),t.json({success:!0})):t.json({success:!1,error:`Browser "${r.browserId}" has no active recording target`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/recording/chunk`,async t=>{try{let r=await t.req.json();if(!r.browserId||!r.chunkBase64)return t.json({success:!1,error:`Missing browserId or chunkBase64 in request body`},400);let a=n.get(e.BrowserService),o=await a.persistExtensionRecordingChunk(r.browserId,r.chunkBase64);return ve(`chunk received`,{browserId:r.browserId,chunkIndex:r.chunkIndex,mimeType:r.mimeType,persisted:!!o,chunkBase64Size:r.chunkBase64.length}),o?(i.log(`debug`,`extension recording chunk received`,{attributes:{"browse_tool.extension.recording.chunk_received":!0,"browse_tool.browser.id":r.browserId,"browse_tool.recording.chunk_bytes":o.chunkBytes,"browse_tool.recording.total_bytes":o.totalBytes,"browse_tool.recording.chunk_count":o.chunkCount,...typeof r.chunkIndex==`number`?{"browse_tool.recording.chunk_index":r.chunkIndex}:{},...typeof r.mimeType==`string`?{"browse_tool.recording.mime_type":r.mimeType}:{}}}),a.recordBrowserActivity(r.browserId),t.json({success:!0})):t.json({success:!1,error:`Browser "${r.browserId}" has no active recording target`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/browser-log`,async e=>{try{let t=await e.req.json();return!t.message||typeof t.message!=`string`?e.json({success:!1,error:`Missing message in request body`},400):(i.log(t.level??`info`,t.message,{attributes:{"browse_tool.extension.log_relay":!0,...typeof t.attributes==`object`&&t.attributes!==null?t.attributes:{}}}),ve(`browser log relayed`,{level:t.level??`info`,message:t.message,attributes:t.attributes}),e.json({success:!0}))}catch(t){return e.json({success:!1,error:t instanceof Error?t.message:String(t)},500)}}),r.post(`/handoff`,async t=>{try{let r=await t.req.json();if(!r.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let i=n.get(e.ExtensionSessionRegistry).requestHandoff(r);return i?t.json({success:!0,message:`Handoff requested. AI will take control when ready.`,session:{id:i.id,controlMode:i.controlMode,handoffRequested:i.handoffRequested}}):t.json({success:!1,error:`Session ${r.sessionId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.post(`/handoff/acknowledge`,async t=>{try{let r=await t.req.json();if(!r.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let i=n.get(e.ExtensionSessionRegistry).acknowledgeHandoff(r.sessionId);return i?t.json({success:!0,message:`Handoff acknowledged. AI now has control.`,session:{id:i.id,controlMode:i.controlMode,handoffRequested:i.handoffRequested}}):t.json({success:!1,error:`Session ${r.sessionId} not found or no handoff pending`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),r.get(`/sessions`,t=>{try{let r=n.get(e.ExtensionSessionRegistry).listSessions();return t.json({sessions:r.map(e=>({id:e.id,browserId:e.browserId,tabId:e.tabId,currentUrl:e.currentUrl,controlMode:e.controlMode,activeSpecPath:e.activeSpecPath,handoffRequested:e.handoffRequested,createdAt:e.createdAt.toISOString(),lastHeartbeatAt:e.lastHeartbeatAt.toISOString()}))})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}}),r}function be(){return new oe(t=>{t.bind(e.ExtensionTaskQueue).to(i).inSingletonScope(),t.bind(e.ExtensionToolDelegator).to(x).inSingletonScope()})}function xe(e){let t=new T({name:`browse-tool-chrome`,version:`0.1.0`},{capabilities:{tools:{}}}),n=e.getSupportedTools().map(e=>({name:e,description:`Browser automation tool (Chrome extension mode): ${e}`,inputSchema:{type:`object`,properties:{},additionalProperties:!0}}));return t.setRequestHandler(re,async()=>({tools:n})),t.setRequestHandler(ne,async t=>{let{name:n,arguments:r}=t.params;return await e.executeTool(n,r||{})}),t}const Se=new C(`chrome-serve`).description(`[DEPRECATED] Start MCP server with Chrome extension HTTP polling for bot-detection-free browser automation`).option(`-p, --port <port>`,`HTTP server port for extension polling`,`3200`).option(`-v, --verbose`,`Enable verbose output`,!1).option(`--wait-for-extension`,`Wait for extension to connect before accepting MCP requests`,!1).action(async t=>{console.error(``),console.error(`╔════════════════════════════════════════════════════════════════╗`),console.error(`║ DEPRECATED: chrome-serve is deprecated. ║`),console.error(`║ Use mcp-serve instead - extension routes are now ║`),console.error(`║ automatically available in the HTTP server at /extension/*. ║`),console.error(`╚════════════════════════════════════════════════════════════════╝`),console.error(``);try{let n=typeof t.port==`string`?Number.parseInt(t.port,10):t.port;t.verbose&&(console.error(`Chrome Extension MCP Server starting...`),console.error(` HTTP Port: ${n}`),console.error(` Wait for extension: ${t.waitForExtension}`));let r=new ae({defaultScope:`Singleton`});r.load(be());let i=r.get(e.ExtensionTaskQueue),a=r.get(e.ExtensionToolDelegator),o=new E;o.use(`*`,ie({origin:e=>e??null,credentials:!0,allowMethods:[`GET`,`POST`,`OPTIONS`],allowHeaders:[`Content-Type`,`Accept`]}));let s=ye(r);o.route(`/extension`,s),o.get(`/health`,e=>{let t=i.getConnectionStatus();return e.json({status:`healthy`,service:`browse-tool-chrome`,extension:t})});let c=ee({fetch:o.fetch,port:n});c.on(`error`,e=>{e.code===`EADDRINUSE`?(console.error(`Error [PORT_IN_USE]: Port ${n} is already in use.`),console.error(`Recovery: Try a different port with --port <port>`)):console.error(`Error [SERVER_ERROR]: HTTP server error: ${e.message}`),process.exit(1)}),console.error(`HTTP server started on port ${n}`),console.error(`Waiting for Chrome extension to connect...`),console.error(`Extension should poll: http://localhost:${n}/extension/tasks`),t.waitForExtension&&(console.error(`Waiting for extension connection before starting MCP...`),await new Promise(e=>{let t=setInterval(()=>{i.getConnectionStatus().connected&&(clearInterval(t),console.error(`Extension connected!`),e())},500)}));let l=xe(a),u=new te;await l.connect(u),console.error(`Chrome extension MCP server started on stdio`);let d=async e=>{console.error(`\nReceived ${e}, shutting down gracefully...`);try{i.clearAllTasks(`Server shutting down`),await u.close(),c.close(),process.exit(0)}catch(e){console.error(`Error during shutdown:`,e),process.exit(1)}};process.on(`SIGINT`,()=>d(`SIGINT`)),process.on(`SIGTERM`,()=>d(`SIGTERM`))}catch(e){let t=e instanceof Error?e.message:String(e);console.error(`Error [SERVER_ERROR]: Failed to start Chrome extension MCP server: ${t}`),console.error(`Recovery: Check that the port is available and try again.`),process.exit(1)}}),Ce=`BROWSE_TOOL_CONFIG`,we=`.browse-tool`,Te=`config.json`,Ee=[`json`,`text`,`quiet`],De={commands:{},tools:{}},Oe=A.record(A.string(),A.unknown()),ke=A.object({mcpServe:A.object({type:A.string().optional(),browser:A.string().optional(),headless:A.boolean().optional(),profile:A.string().optional(),mode:A.string().optional(),host:A.string().optional(),port:A.coerce.number().int().positive().optional(),tags:A.string().optional(),exclude:A.string().optional(),customTools:A.string().optional(),snippetsDir:A.string().optional(),registryPath:A.string().optional(),registryDir:A.string().optional(),pidsDir:A.string().optional(),profilesDir:A.string().optional()}).partial().optional(),httpServe:A.object({port:A.coerce.number().int().positive().optional(),headless:A.boolean().optional(),idleTimeout:A.coerce.number().positive().optional(),host:A.string().optional(),registryDir:A.string().optional(),registryPath:A.string().optional(),pidsDir:A.string().optional(),profilesDir:A.string().optional(),snippetsDir:A.string().optional()}).partial().optional(),exec:A.object({format:A.enum(Ee).optional(),color:A.boolean().optional(),port:A.coerce.number().int().positive().optional()}).partial().optional(),tools:A.object({format:A.enum(Ee).optional(),color:A.boolean().optional(),port:A.coerce.number().int().positive().optional()}).partial().optional(),status:A.record(A.string(),A.unknown()).optional(),stop:A.record(A.string(),A.unknown()).optional()}),Ae=A.object({commands:ke.default({}),tools:A.record(A.string(),Oe).default({})});let N={config:De};function je(e){for(let t=0;t<e.length;t+=1){let n=e[t];if(n===`--config`)return e[t+1];if(n.startsWith(`--config=`))return n.slice(9)}}function Me(e){let t=O.resolve(e);if(!D(t))throw Error(`Config path not found: ${t}`);return ce(t).isDirectory()?O.join(t,Te):t}function Ne(e,t){let n=t.env??process.env,r=t.cwd??process.cwd(),i=t.homeDir??ue(),a=je(e);if(a)return Me(a);if(n[Ce])return Me(n[Ce]);let o=O.join(r,we,Te);if(D(o))return o;let s=O.join(i,we,Te);if(D(s))return s}function Pe(e){let t=se(e,`utf8`),n=JSON.parse(t);return Ae.parse(n)}function Fe(e,t={}){let n=Ne(e,t);return n?{configPath:n,config:Pe(n)}:{config:De}}function Ie(e,t={}){return N=Fe(e,t),N}function P(e){return(N.config.commands??{})[e]??{}}function Le(e){return N.config.tools?.[e]??{}}function F(e,t,n,r,i){let a=e.getOptionValueSourceWithGlobals(t);return a!==void 0&&a!==`default`&&a!==`implied`?n:i===void 0?r===void 0?n:r:i}var Re=class{port;exactPort;timeout;serverPort=null;constructor(e={}){this.port=e.port??3200,this.exactPort=e.exactPort??!1,this.timeout=e.timeout??6e4}async ensureServer(){if(this.serverPort!==null)return this.serverPort;let t=await m().get(e.HttpServerManager).ensureRunning(this.port,{exactPort:this.exactPort});if(!t.running||!t.port)throw Error(t.error??`Failed to start HTTP server. Try running "browse-tool http-serve" manually.`);return this.serverPort=t.port,t.port}async getBaseUrl(){return`http://localhost:${await this.ensureServer()}`}async listTools(){let e=await this.getBaseUrl(),t=new AbortController,n=setTimeout(()=>t.abort(),this.timeout);try{let n=await fetch(`${e}/tools`,{method:`GET`,headers:{Accept:`application/json`},signal:t.signal});if(!n.ok)throw Error(`HTTP ${n.status}: ${n.statusText}`);let r=await n.json();if(r.error)throw Error(r.error);return r.tools}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(n)}}async listCustomTools(e){let t=await this.getBaseUrl(),n=new AbortController,r=setTimeout(()=>n.abort(),this.timeout);try{let r=new URL(`/custom-tools`,t);r.searchParams.set(`dir`,e);let i=await fetch(r,{method:`GET`,headers:{Accept:`application/json`},signal:n.signal});if(!i.ok)throw Error(`HTTP ${i.status}: ${i.statusText}`);let a=await i.json();if(a.error)throw Error(a.error);return a.tools}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(r)}}async listBrowsers(){let e=await this.getBaseUrl(),t=new AbortController,n=setTimeout(()=>t.abort(),this.timeout);try{let n=await fetch(`${e}/browsers`,{method:`GET`,headers:{Accept:`application/json`},signal:t.signal});if(!n.ok)throw Error(`HTTP ${n.status}: ${n.statusText}`);let r=await n.json();if(r.error)throw Error(r.error);return r.browsers}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(n)}}async execute(e,t){let n=await this.getBaseUrl(),r=e===`run_spec`?void 0:this.timeout,i=new AbortController,a=r===void 0?void 0:setTimeout(()=>i.abort(),r);try{let a=await fetch(`${n}/execute`,{method:`POST`,headers:{"Content-Type":`application/json`,Accept:`application/json`},body:JSON.stringify({tool:e,arguments:t}),signal:r===void 0?void 0:i.signal});if(!a.ok){let e=await a.text();throw Error(`HTTP ${a.status}: ${e||a.statusText}`)}let o=await a.json();return o.success?o.result??{content:[{type:`text`,text:`No result returned`}]}:{content:[{type:`text`,text:o.error??`Unknown error`}],isError:!0}}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{a&&clearTimeout(a)}}async executeCustomTool(e,t,n){let r=await this.getBaseUrl(),i=new AbortController,a=setTimeout(()=>i.abort(),this.timeout);try{let a=new URL(`/custom-tools`,r);a.searchParams.set(`dir`,e);let o=await fetch(a,{method:`POST`,headers:{"Content-Type":`application/json`,Accept:`application/json`},body:JSON.stringify({tool:t,arguments:n}),signal:i.signal});if(!o.ok){let e=await o.text();throw Error(`HTTP ${o.status}: ${e||o.statusText}`)}let s=await o.json();return s.success?s.result??{content:[{type:`text`,text:`No result returned`}]}:{content:[{type:`text`,text:s.error??`Unknown error`}],isError:!0}}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(a)}}wrapConnectionError(e){return e instanceof Error?e.message.includes(`ECONNREFUSED`)||e.message.includes(`fetch failed`)?Error(`Cannot connect to browse-tool HTTP server.\n\nTry one of the following:\n 1. Start the server: browse-tool http-serve\n 2. Check if another process is using port ${this.port}\n 3. Run with a different port: browse-tool --port 3201 <command>\n\nOriginal error: ${e.message}`,{cause:e}):e:Error(String(e),{cause:e})}};function I(e){return new Re(e)}const ze={reset:`\x1B[0m`,red:`\x1B[31m`,green:`\x1B[32m`,yellow:`\x1B[33m`,blue:`\x1B[34m`,magenta:`\x1B[35m`,cyan:`\x1B[36m`,gray:`\x1B[90m`,bold:`\x1B[1m`};function L(e,t,n){return n?`${ze[t]}${e}${ze.reset}`:e}function R(e,t){let{format:n,color:r}=t;return n===`quiet`?``:n===`json`?Be(e):Ve(e,r)}function Be(e){return JSON.stringify(e,null,2)}function Ve(e,t){let n=[];e.isError&&n.push(L(`Error:`,`red`,t));for(let r of e.content)r.type===`text`?n.push(He(r,t)):r.type===`image`?n.push(Ge(r,t)):n.push(L(`[Unknown content type: ${r.type}]`,`yellow`,t));return n.join(`
|
|
3
3
|
`)}function He(e,t){let n=e.text;try{return Ue(JSON.parse(n),t)}catch{return n}}function Ue(e,t){if(typeof e!=`object`||!e)return String(e);let n=[];for(let[r,i]of Object.entries(e)){let e=L(r,`cyan`,t),a=We(i,t);n.push(`${e}: ${a}`)}return n.join(`
|
|
4
4
|
`)}function We(e,t){return e===null?L(`null`,`gray`,t):e===void 0?L(`undefined`,`gray`,t):typeof e==`boolean`?L(String(e),e?`green`:`red`,t):typeof e==`number`?L(String(e),`yellow`,t):typeof e==`string`?e.startsWith(`http://`)||e.startsWith(`https://`)?L(e,`blue`,t):e:Array.isArray(e)?e.length===0?L(`[]`,`gray`,t):JSON.stringify(e,null,2):typeof e==`object`?JSON.stringify(e,null,2):String(e)}function Ge(e,t){let{mimeType:n,data:r}=e;return L(`[Image: ${n}, ~${Math.round(r.length*3/4/1024)}KB base64 data]`,`magenta`,t)}function z(e,t){return L(`Error: ${e instanceof Error?e.message:e}`,`red`,t)}function Ke(e,t){let n=Math.max(...e.map(e=>e.name.length)),r=[];for(let i of e){let e=L(i.name.padEnd(n),`cyan`,t);r.push(` ${e} ${i.description}`)}return r.join(`
|
|
5
5
|
`)}function qe(e,t){let n=P(`tools`),r=F(e,`format`,t.format,n.format),i=F(e,`color`,t.color,n.color);return{port:F(e,`port`,t.port,n.port===void 0?void 0:String(n.port),process.env.PLAYWRIGHT_PORT),formatterOptions:{format:r,color:i}}}const Je=new C(`list-custom-tools`).description(`List custom tools from a tools directory`).argument(`<dir>`,`Path to the tools directory containing tools.yaml`).option(`-f, --format <format>`,`Output format: json, text, quiet`,`json`).option(`--no-color`,`Disable colored output`).option(`-p, --port <port>`,`HTTP server port`,String(d)).action(async function(e,t){let{port:n,formatterOptions:r}=qe(this,t);try{let t=await I({port:Number.parseInt(n,10)}).listCustomTools(e),i=r.format===`text`?Ke(t,r.color):r.format===`quiet`?``:JSON.stringify(t,null,2);i&&console.log(i)}catch(e){console.error(z(e instanceof Error?e:String(e),r.color)),process.exit(1)}}),Ye=new C(`exec-custom-tool`).description(`Execute a custom tool from a tools directory`).argument(`<dir>`,`Path to the tools directory containing tools.yaml`).argument(`<tool>`,`Custom tool name to execute`).argument(`[args]`,`JSON arguments for the tool`,`{}`).option(`-f, --format <format>`,`Output format: json, text, quiet`,`json`).option(`--no-color`,`Disable colored output`).option(`-p, --port <port>`,`HTTP server port`,String(d)).action(async function(e,t,n,r){let{port:i,formatterOptions:a}=qe(this,r);try{let r;try{r=JSON.parse(n)}catch{console.error(z(`Invalid JSON arguments: ${n}`,a.color)),process.exit(1);return}let o=await I({port:Number.parseInt(i,10)}).executeCustomTool(e,t,r),s=R(o,a);s&&console.log(s),o.isError&&process.exit(1)}catch(e){console.error(z(e instanceof Error?e:String(e),a.color)),process.exit(1)}});new C(`custom-tools`).description(`List and execute custom tools through the HTTP server`).addCommand(Je).addCommand(Ye);const Xe=new C(`docker-build-cft`).description(`Build the Chrome for Testing Docker image used by vm mode`).option(`--cft-version <version>`,`Chrome for Testing version to build`,y).option(`--image <image>`,`Docker image tag to produce`,c).option(`--platform <platform>`,`Docker target platform`,n).action(async e=>{try{let t=await f({version:e.cftVersion,image:e.image,platform:e.platform,stdio:`inherit`});console.log(`Built Docker image ${t.image}`),console.log(` Version: ${t.version}`),console.log(` Platform: ${t.platform}`),console.log(` Archive: ${l(t.platform)}`)}catch(e){console.error(e instanceof Error?e.message:String(e)),process.exit(1)}}),Ze=new C(`exec`).description(`Execute a tool directly with JSON arguments`).argument(`<tool>`,`Tool name to execute (e.g., browser_launch)`).argument(`[args]`,`JSON arguments for the tool`,`{}`).option(`-f, --format <format>`,`Output format: json, text, quiet`,`json`).option(`--no-color`,`Disable colored output`).option(`-p, --port <port>`,`HTTP server port`,String(d)).action(async function(e,t,n){let r=P(`exec`),i=F(this,`format`,n.format,r.format),a=F(this,`color`,n.color,r.color),o=F(this,`port`,n.port,r.port===void 0?void 0:String(r.port),process.env.PLAYWRIGHT_PORT),s=this.getOptionValueSourceWithGlobals(`port`),c=s!==void 0&&s!==`default`&&s!==`implied`,l={format:i,color:a};try{let n;try{n=JSON.parse(t)}catch{console.error(z(`Invalid JSON arguments: ${t}`,l.color)),process.exit(1)}let r=await I({port:Number.parseInt(o,10),exactPort:c}).execute(e,n),i=R(r,l);i&&console.log(i),r.isError&&process.exit(1)}catch(e){console.error(z(e instanceof Error?e:String(e),l.color)),process.exit(1)}}),B=`pageId`,V=`browserId`,Qe=A.record(A.string(),A.unknown()),$e=A.object({type:A.literal(`object`),properties:A.record(A.string(),A.unknown()).optional(),required:A.array(A.string()).optional(),additionalProperties:A.boolean().optional()}).passthrough(),et=A.object({name:A.string().min(1),description:A.string().min(1),script:A.string().min(1),suggestionActions:A.string().min(1).optional(),capabilities:Qe,inputSchema:$e}),tt=A.object({tools:A.array(et)}),nt=process.env.BROWSE_TOOL_DEBUG_CUSTOM_TOOLS===`1`;function rt(e){return JSON.stringify(e,(e,t)=>typeof t==`string`&&t.length>240?`${t.slice(0,240)}...<trimmed>`:t)}function it(e,t){if(nt){if(t){console.error(`[CustomToolService] ${e}`,t);return}console.error(`[CustomToolService] ${e}`)}}function H(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function at(e){return H(e)&&Array.isArray(e.content)}function U(e){let t=e.trim();return t===``?``:t.startsWith(`"`)&&t.endsWith(`"`)||t.startsWith(`[`)&&t.endsWith(`]`)||t.startsWith(`{`)&&t.endsWith(`}`)?JSON.parse(t):t.startsWith(`'`)&&t.endsWith(`'`)?t.slice(1,-1):t===`true`?!0:t===`false`?!1:t===`null`?null:/^-?\d+(\.\d+)?$/.test(t)?Number(t):t}function ot(e){if(!e||Object.keys(e).length===0)return;let t={};for(let[n,r]of Object.entries(e))if(r!=null){if(typeof r==`string`||typeof r==`number`||typeof r==`boolean`){t[n]=r;continue}t[n]=JSON.stringify(r)}return Object.keys(t).length>0?t:void 0}function st(e){return e.replace(/^\uFEFF/,``).split(/\r?\n/).map(e=>{if(e.includes(` `))throw Error(`Tab indentation is not supported in tools.yaml`);let t=e.replace(/\s+#.*$/,``);return t.trim().length===0?null:{indent:t.match(/^ */)?.[0].length??0,text:t.trim()}}).filter(e=>e!==null)}function W(e,t,n){let r=e[t];if(!r||r.indent!==n)throw Error(`Invalid indentation in tools.yaml at line ${t+1}`);return r.text.startsWith(`-`)?ct(e,t,n):lt(e,t,n)}function ct(e,t,n){let r=[],i=t;for(;i<e.length;){let t=e[i];if(t.indent<n||t.indent!==n||!t.text.startsWith(`-`))break;let a=t.text.slice(1).trim();if(a===``){let t=e[i+1];if(!t||t.indent<=n){r.push(null),i+=1;continue}let[a,o]=W(e,i+1,t.indent);r.push(a),i=o;continue}if(a.includes(`:`)){let[t,o]=ut(a),s={};if(o===void 0){let r=e[i+1];if(!r||r.indent<=n)throw Error(`Expected nested value for "${t}" in tools.yaml`);let[a,o]=W(e,i+1,r.indent);s[t]=a,i=o}else s[t]=U(o),i+=1;for(;i<e.length&&e[i].indent>n;){let t=e[i];if(t.indent!==n+2||t.text.startsWith(`-`)){let[n,r]=W(e,i,t.indent);if(!H(n))throw Error(`Expected object entry in tools.yaml at line ${i+1}`);Object.assign(s,n),i=r;continue}let[r,a]=ut(t.text);if(a===void 0){let n=e[i+1];if(!n||n.indent<=t.indent)throw Error(`Expected nested value for "${r}" in tools.yaml`);let[a,o]=W(e,i+1,n.indent);s[r]=a,i=o;continue}s[r]=U(a),i+=1}r.push(s);continue}r.push(U(a)),i+=1}return[r,i]}function lt(e,t,n){let r={},i=t;for(;i<e.length;){let t=e[i];if(t.indent<n||t.indent!==n||t.text.startsWith(`-`))break;let[a,o]=ut(t.text);if(o===void 0){let t=e[i+1];if(!t||t.indent<=n){r[a]=null,i+=1;continue}let[o,s]=W(e,i+1,t.indent);r[a]=o,i=s;continue}r[a]=U(o),i+=1}return[r,i]}function ut(e){let t=e.indexOf(`:`);if(t===-1)throw Error(`Invalid tools.yaml entry: "${e}"`);let n=e.slice(0,t).trim(),r=e.slice(t+1).trim();return[n,r===``?void 0:r]}function dt(e){let t=st(e);if(t.length===0)return{};let[n]=W(t,0,t[0].indent);return n}function ft(e){let t=e.inputSchema.properties;if(!t||!H(t))throw Error(`Custom tool "${e.name}" must define inputSchema.properties`);let n=t[B],r=t[V],i=n!==void 0&&H(n)&&n.type===`string`,a=r!==void 0&&H(r)&&r.type===`string`;if(!i&&!a)throw Error(`Custom tool "${e.name}" must define inputSchema.properties.pageId and/or inputSchema.properties.browserId as type "string"`);if(n!==void 0&&!i)throw Error(`Custom tool "${e.name}" must define inputSchema.properties.pageId as type "string"`);if(r!==void 0&&!a)throw Error(`Custom tool "${e.name}" must define inputSchema.properties.browserId as type "string"`)}async function pt(e){let t=S(await de(e,`utf8`),{mode:`strip`});return await import(`data:text/javascript;base64,${Buffer.from(t,`utf8`).toString(`base64`)}`)}function mt(e,t){let n=typeof t.run==`function`?t.run:void 0;if(!n)throw Error(`Custom tool script "${e}" must export a "run" function`);return{execute:n}}function ht(e,t){return typeof e.suggestionActions==`string`&&e.suggestionActions.trim().length>0?e:{...e,suggestionActions:t}}function gt(e,t){let n=e.content[0];if(n?.type===`text`&&typeof n.text==`string`)try{let r=JSON.parse(n.text);if(H(r)){let i=ht(r,t);return{...e,content:[{...n,text:JSON.stringify(i,null,2)},...e.content.slice(1)]}}}catch{}return{...e,content:[...e.content,{type:`text`,text:`suggestionActions: ${t}`}]}}function _t(e,t,n){if(at(t))return n?gt(t,n):t;if(typeof t==`string`)return n?{content:[{type:`text`,text:JSON.stringify({result:t,suggestionActions:n},null,2)}]}:{content:[{type:`text`,text:t}]};if(t===void 0)return n?{content:[{type:`text`,text:JSON.stringify({result:`Custom tool "${e}" completed successfully`,suggestionActions:n},null,2)}]}:{content:[{type:`text`,text:`Custom tool "${e}" completed successfully`}]};let r=H(t)&&n?ht(t,n):t;return{content:[{type:`text`,text:JSON.stringify(r,null,2)}]}}var vt=class{constructor(e,t,n=new b,r){this.pageRegistry=e,this.extensionTaskQueue=t,this.telemetry=n,this.browserService=r}resolveToolPage(e,t,n){if(n.page)return n.page;if(n.mode===`extension`&&this.extensionTaskQueue){let e=new h(this.extensionTaskQueue);return e.setTarget(t,n.browserId),e}throw Error(`Custom tool "${e}" requires a supported page context`)}toPageSummary(e,t){return{pageId:t.id,url:t.url,title:t.title,active:e===t.id}}async createPageForBrowser(e,t,n){if(!this.browserService)throw Error(`Custom tool "${e}" requires browser service support to create a page`);let r=this.browserService.getBrowser(t);if(!r)throw Error(`Browser "${t}" not found`);let i=n?.setAsCurrent!==!1;if(r.mode===`extension`||r.mode===`vm`){if(!this.extensionTaskQueue)throw Error(`Custom tool "${e}" requires extension task support to create a page`);let a=this.pageRegistry.registerExtensionPage(t,void 0,n?.url,!1);try{let o=await this.extensionTaskQueue.queueTask(`browser_new_page`,{browserId:t,pageId:a,url:n?.url,setAsCurrent:i},1e4,t);if(!o.success)throw Error(o.error??`Custom tool "${e}" failed to create a page`);let s=o.result?.content[0]?.type===`text`?o.result.content[0].text:void 0,c={};if(typeof s==`string`&&s.length>0)try{c=JSON.parse(s)}catch{c={}}let l=this.pageRegistry.get(a);if(!l)throw Error(`Page "${a}" was not registered`);l.url=c.url??l.url,l.title=c.title??l.title,l.extensionTabId=c.tabId??l.extensionTabId;let u=await this.waitForResolvedPageMetadata(a);return r.pageIds.add(a),(i||!r.currentPageId)&&this.browserService.setCurrentPage(t,a),this.browserService.recordBrowserActivity(t,a),{...this.toPageSummary(r.currentPageId,u),page:this.resolveToolPage(e,a,u)}}catch(e){throw this.pageRegistry.remove(a),e}}let{pageId:a,page:o}=await this.browserService.newPage(t);n?.url&&(await o.goto(n.url),await this.pageRegistry.updateMetadata(a)),i&&this.browserService.setCurrentPage(t,a),this.browserService.recordBrowserActivity(t,a);let s=this.pageRegistry.get(a);if(!s)throw Error(`Page "${a}" was not registered`);return{...this.toPageSummary(r.currentPageId,s),page:this.resolveToolPage(e,a,s)}}async waitForResolvedPageMetadata(e){let t=Date.now(),n=this.pageRegistry.get(e);for(;n&&Date.now()-t<1500;){let t=typeof n.url==`string`&&n.url.length>0,r=typeof n.title==`string`&&n.title.length>0&&n.title!==`Extension Tab`;if(t&&r)return n;await new Promise(e=>setTimeout(e,50)),n=this.pageRegistry.get(e)}if(!n)throw Error(`Page "${e}" was not registered`);return n}async resolveExecutionContext(e,t){let n=typeof t[B]==`string`&&t[B].length>0?t[B]:void 0,r=typeof t[V]==`string`&&t[V].length>0?t[V]:void 0;if(!n&&!r)throw Error(`Custom tool "${e}" requires a string pageId or browserId`);if(n){let t=this.pageRegistry.get(n);if(!t)throw Error(`Page "${n}" not found`);if(r&&t.browserId!==r)throw Error(`Custom tool "${e}" received pageId "${n}" for browser "${t.browserId}", not "${r}"`);let i=this.createBrowserHelper(e,t.browserId);return{pageId:n,pageEntry:t,page:this.resolveToolPage(e,n,t),browser:i}}let i=this.createBrowserHelper(e,r);try{let e=await i.getCurrentPage(),t=this.pageRegistry.get(e.pageId);if(!t)throw Error(`Page "${e.pageId}" not found`);return{pageId:e.pageId,pageEntry:t,page:e.page,browser:i}}catch(e){if(!(e instanceof Error?e.message:String(e)).includes(`has no pages`))throw e;let t=await i.newPage(),n=this.pageRegistry.get(t.pageId);if(!n)throw Error(`Page "${t.pageId}" not found`,{cause:e});return{pageId:t.pageId,pageEntry:n,page:t.page,browser:i}}}createBrowserHelper(e,t){return{browserId:t,mode:this.browserService?.getBrowser(t)?.mode??`extension`,listPages:async()=>{let e=this.browserService?.getBrowser(t);if(!e)throw Error(`Browser "${t}" not found`);return this.pageRegistry.findByBrowser(t).map(t=>this.toPageSummary(e.currentPageId,t))},getPage:async n=>{let r=this.pageRegistry.get(n);if(!r||r.browserId!==t)throw Error(`Page "${n}" not found in browser "${t}"`);let i=this.browserService?.getBrowser(t);return{...this.toPageSummary(i?.currentPageId??null,r),page:this.resolveToolPage(e,n,r)}},getCurrentPage:async()=>{let n=this.browserService?.getBrowser(t);if(!n)throw Error(`Browser "${t}" not found`);let r=n.currentPageId??this.pageRegistry.findByBrowser(t)[0]?.id??void 0;if(!r)throw Error(`Browser "${t}" has no pages`);let i=this.pageRegistry.get(r);if(!i)throw Error(`Page "${r}" not found`);return{...this.toPageSummary(n.currentPageId,i),page:this.resolveToolPage(e,r,i)}},newPage:async n=>this.createPageForBrowser(e,t,n)}}createToolLogger(e,t,n){let r={"browse_tool.tool.name":e,"browse_tool.page.id":t,"browse_tool.browser.id":n.browserId,"browse_tool.execution.mode":n.mode},i=(e,t,n)=>{this.telemetry.log(e,t,{attributes:ot({...r,...n?.attributes??{}}),exception:n?.exception})};return{getTraceContext:()=>this.telemetry.getActiveTraceContext(),trace:(e,t)=>i(`trace`,e,t),debug:(e,t)=>i(`debug`,e,t),info:(e,t)=>i(`info`,e,t),warn:(e,t)=>i(`warn`,e,t),error:(e,t)=>i(`error`,e,t),fatal:(e,t)=>i(`fatal`,e,t)}}async listTools(e){return(await this.loadTools(e)).map(({name:e,description:t,suggestionActions:n,inputSchema:r,capabilities:i})=>({name:e,description:t,suggestionActions:n,inputSchema:r,capabilities:i}))}async executeTool(e,t,n){let r=typeof n[B]==`string`?n[B]:void 0,i=typeof n[V]==`string`?n[V]:void 0;return this.telemetry.runInSpan(`browse_tool.custom_tool.execute`,{attributes:{"browse_tool.tool.name":t,"browse_tool.custom_tools.directory":O.resolve(e),"browse_tool.page.id":r,"browse_tool.browser.id":i}},async r=>{let i=(await this.loadTools(e)).find(e=>e.name===t);if(!i)throw r?.setStatus({code:k.ERROR,message:`Custom tool "${t}" not found`}),Error(`Custom tool "${t}" not found`);let{pageId:a,pageEntry:o,page:s,browser:c}=await this.resolveExecutionContext(t,n),l=this.createToolLogger(t,a,o);r?.setAttributes({"browse_tool.browser.id":o.browserId,"browse_tool.execution.mode":o.mode,"browse_tool.page.id":a}),it(`Executing custom tool`,{toolName:t,directory:O.resolve(e),pageId:a,browserId:o.browserId,mode:o.mode,input:rt(n),scriptPath:i.scriptPath});let u;try{u=await i.execute?.({page:s,browser:c,input:n,logger:l})}catch(e){let n=e instanceof Error?e.message:String(e);throw it(`Custom tool execution failed`,{toolName:t,pageId:a,browserId:o.browserId,mode:o.mode,error:n,stack:e instanceof Error?e.stack:void 0}),Error(`Custom tool "${t}" failed on page "${a}": ${n}`,{cause:e})}it(`Custom tool execution completed`,{toolName:t,pageId:a,browserId:o.browserId,mode:o.mode,result:rt(u)});let d=_t(t,u,i.suggestionActions),f=d.isError?d.content[0]?.text:void 0;return f&&r?.setStatus({code:k.ERROR,message:f}),d})}async loadTools(e){let t=O.resolve(e),n=O.join(t,`tools.yaml`),r=dt(await de(n,`utf8`).catch(e=>{throw Error(`Failed to read custom tool manifest at "${n}": ${e instanceof Error?e.message:String(e)}`)})),i=tt.parse(r);return Promise.all(i.tools.map(async e=>{ft(e);let n=O.resolve(t,e.script);await fe(n).catch(t=>{throw Error(`Custom tool "${e.name}" script not found at "${n}": ${t instanceof Error?t.message:String(t)}`)});let r=mt(n,await pt(n));return{name:e.name,description:e.description,suggestionActions:e.suggestionActions,inputSchema:e.inputSchema,capabilities:e.capabilities,scriptPath:n,...r}}))}};function yt(t){let n=new E;return n.get(`/browsers`,async n=>{try{let r=t.get(e.BrowserService),i=t.get(e.PageRegistry),a=r.listBrowsers(),o=i.list(),s=a.map(e=>{let t=o.filter(t=>t.browserId===e.id);return{id:e.id,profileName:e.profileName,currentPageId:e.currentPageId,createdAt:e.createdAt.toISOString(),pages:t.map(e=>({id:e.id,url:e.url,title:e.title,createdAt:e.createdAt.toISOString()}))}}),c={totalBrowsers:a.length,totalPages:o.length};return n.json({browsers:s,stats:c})}catch(e){return console.error(`Failed to list browsers:`,e),n.json({error:`Failed to list browsers`,message:e instanceof Error?e.message:String(e)},500)}}),n.delete(`/browsers`,async n=>{try{return await t.get(e.BrowserService).closeAll(),n.json({success:!0,message:`All browsers closed`})}catch(e){return console.error(`Failed to close all browsers:`,e),n.json({error:`Failed to close all browsers`,message:e instanceof Error?e.message:String(e)},500)}}),n.delete(`/browsers/:id`,async n=>{try{let r=n.req.param(`id`),i=t.get(e.BrowserService);return i.getBrowser(r)?(await i.closeBrowser(r),n.json({success:!0,message:`Browser "${r}" closed`})):n.json({error:`Browser "${r}" not found`},404)}catch(e){return console.error(`Failed to close browser:`,e),n.json({error:`Failed to close browser`,message:e instanceof Error?e.message:String(e)},500)}}),n.delete(`/pages/:id`,async n=>{try{let r=n.req.param(`id`),i=t.get(e.PageRegistry).get(r);return i?i.page?(await i.page.close(),n.json({success:!0,message:`Page "${r}" closed`})):n.json({error:`Page "${r}" is in extension mode and cannot be closed via API`},400):n.json({error:`Page "${r}" not found`},404)}catch(e){return console.error(`Failed to close page:`,e),n.json({error:`Failed to close page`,message:e instanceof Error?e.message:String(e)},500)}}),n}function bt(e){return e.toLocaleString(`en-US`,{year:`numeric`,month:`2-digit`,day:`2-digit`,hour:`2-digit`,minute:`2-digit`,second:`2-digit`,hour12:!1})}function xt(e){let t=Math.floor(e/1e3),n=Math.floor(t/60),r=Math.floor(n/60);return r>0?`${r}h ${n%60}m`:n>0?`${n}m ${t%60}s`:`${t}s`}function St(e){return xt(new Date().getTime()-e.getTime())}const Ct=`table-container`,wt=`stat-card`,Tt=`browser-row`,Et=`page-row`,G=`status-active`,Dt=`url-cell`,K=`timestamp-cell`,q=`actions-cell`,J=`kill-btn`,Ot=`empty-state`;function kt({browsers:e}){return e.length===0?j(`div`,{class:Ct,children:M(`div`,{class:Ot,children:[j(`h3`,{children:`No Active Browsers`}),j(`p`,{children:`Launch a browser using MCP tools to see it here.`})]})}):j(`div`,{class:Ct,children:M(`table`,{class:`browser-table`,children:[j(`thead`,{children:M(`tr`,{children:[j(`th`,{children:`ID`}),j(`th`,{children:`Status`}),j(`th`,{children:`URL / Title`}),j(`th`,{children:`Created`}),j(`th`,{children:`Age`}),j(`th`,{children:`Actions`})]})}),j(`tbody`,{id:`browser-table-body`,children:e.map(e=>M(he,{children:[M(`tr`,{class:Tt,children:[j(`td`,{children:e.id}),j(`td`,{children:M(`span`,{class:G,children:[e.pages.length,` page`,e.pages.length===1?``:`s`]})}),j(`td`,{children:e.profileName||`Default Profile`}),j(`td`,{class:K,children:bt(e.createdAt)}),j(`td`,{class:K,children:St(e.createdAt)}),j(`td`,{class:q,children:j(`button`,{class:J,onclick:`dashboard.killBrowser('${e.id}')`,children:`Kill`})})]}),e.pages.map(t=>M(`tr`,{class:Et,children:[M(`td`,{children:[t.id,e.currentPageId===t.id&&` (active)`]}),j(`td`,{children:j(`span`,{class:G,children:`Open`})}),j(`td`,{class:Dt,title:t.url,children:t.title||t.url||`about:blank`}),j(`td`,{class:K,children:bt(t.createdAt)}),j(`td`,{class:K,children:St(t.createdAt)}),j(`td`,{class:q,children:j(`button`,{class:J,onclick:`dashboard.killPage('${t.id}')`,children:`Close`})})]}))]}))})]})})}function At({stats:e}){return M(`div`,{class:`stats-container`,children:[M(`div`,{class:wt,children:[j(`h3`,{children:`Active Browsers`}),j(`div`,{class:`value`,children:e.totalBrowsers})]}),M(`div`,{class:wt,children:[j(`h3`,{children:`Active Pages`}),j(`div`,{class:`value`,children:e.totalPages})]})]})}function jt({browsers:e,stats:t}){return M(`div`,{class:`dashboard-container`,children:[M(`div`,{class:`dashboard-header`,children:[M(`div`,{children:[j(`h1`,{children:`Playwright MCP Dashboard`}),j(`p`,{children:`Browser automation management (auto-refresh every 3 seconds)`})]}),M(`div`,{children:[j(`button`,{id:`refresh-btn`,class:`btn refresh-btn`,onclick:`dashboard.manualRefresh()`,children:`Refresh Now`}),j(`button`,{id:`kill-all-btn`,class:`btn btn-danger`,onclick:`dashboard.killAllBrowsers()`,children:`Kill All Browsers`})]})]}),j(At,{stats:t}),j(kt,{browsers:e}),j(`script`,{children:me(`
|