@agimon-ai/browse-tool 0.2.13 → 0.2.15
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 +16 -16
- package/dist/cli.cjs.map +1 -1
- package/dist/cli.mjs +23 -23
- package/dist/cli.mjs.map +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.mjs +1 -1
- package/dist/{playwright-test-DfpyCIc0.cjs → playwright-test-jbz0wL4w.cjs} +2 -2
- package/dist/{playwright-test-DfpyCIc0.cjs.map → playwright-test-jbz0wL4w.cjs.map} +1 -1
- package/dist/{streamable-http-O6YYT3Yr.cjs → streamable-http-BAKht810.cjs} +8 -8
- package/dist/{streamable-http-O6YYT3Yr.cjs.map → streamable-http-BAKht810.cjs.map} +1 -1
- package/dist/streamable-http-Beq9pCY3.mjs +15 -0
- package/dist/{streamable-http-_UIJOzAB.mjs.map → streamable-http-Beq9pCY3.mjs.map} +1 -1
- package/dist/stubs/playwright-test.cjs +1 -1
- package/package.json +4 -4
- package/dist/streamable-http-_UIJOzAB.mjs +0 -15
package/dist/cli.mjs
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
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-_UIJOzAB.mjs";import"./playwright-test-yNsP599T.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 E}from"@modelcontextprotocol/sdk/server/stdio.js";import{CallToolRequestSchema as D,ListToolsRequestSchema as te}from"@modelcontextprotocol/sdk/types.js";import{Hono as O}from"hono";import{cors as k}from"hono/cors";import{Container as ne,ContainerModule as re}from"inversify";import{existsSync as A,readFileSync as ie,statSync as ae}from"node:fs";import j from"node:path";import{SpanStatusCode as M}from"@opentelemetry/api";import{PortRegistryService as oe}from"@agimon-ai/foundation-port-registry";import{homedir as se}from"node:os";import{z as N}from"zod";import{readFile as ce,stat as le}from"node:fs/promises";import{createNodeWebSocket as ue}from"@hono/node-ws";import{raw as de}from"hono/html";import{Fragment as fe,jsx as P,jsxs as F}from"hono/jsx/jsx-runtime";var pe=`0.2.12`;const me=process.env.BROWSE_TOOL_DEBUG_EXTENSION_RECORDING===`1`;function he(e,t){if(!me)return;let n=t?` ${JSON.stringify(t)}`:``;console.log(`[ExtensionRecordingDebug] ${e}${n}`)}function ge(n){let r=new O,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 he(`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 he(`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:{}}}),he(`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 _e(){return new re(t=>{t.bind(e.ExtensionTaskQueue).to(i).inSingletonScope(),t.bind(e.ExtensionToolDelegator).to(x).inSingletonScope()})}function ve(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(te,async()=>({tools:n})),t.setRequestHandler(D,async t=>{let{name:n,arguments:r}=t.params;return await e.executeTool(n,r||{})}),t}const ye=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 ne({defaultScope:`Singleton`});r.load(_e());let i=r.get(e.ExtensionTaskQueue),a=r.get(e.ExtensionToolDelegator),o=new O;o.use(`*`,k({origin:e=>e??null,credentials:!0,allowMethods:[`GET`,`POST`,`OPTIONS`],allowHeaders:[`Content-Type`,`Accept`]}));let s=ge(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=ve(a),u=new E;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)}}),be=`BROWSE_TOOL_CONFIG`,xe=`.browse-tool`,Se=`config.json`,Ce=[`json`,`text`,`quiet`],we={commands:{},tools:{}},Te=N.record(N.string(),N.unknown()),Ee=N.object({mcpServe:N.object({type:N.string().optional(),browser:N.string().optional(),headless:N.boolean().optional(),profile:N.string().optional(),mode:N.string().optional(),host:N.string().optional(),port:N.coerce.number().int().positive().optional(),tags:N.string().optional(),exclude:N.string().optional(),customTools:N.string().optional(),snippetsDir:N.string().optional(),registryPath:N.string().optional(),registryDir:N.string().optional(),pidsDir:N.string().optional(),profilesDir:N.string().optional()}).partial().optional(),httpServe:N.object({port:N.coerce.number().int().positive().optional(),headless:N.boolean().optional(),idleTimeout:N.coerce.number().positive().optional(),host:N.string().optional(),registryDir:N.string().optional(),registryPath:N.string().optional(),pidsDir:N.string().optional(),profilesDir:N.string().optional(),snippetsDir:N.string().optional()}).partial().optional(),exec:N.object({format:N.enum(Ce).optional(),color:N.boolean().optional(),port:N.coerce.number().int().positive().optional()}).partial().optional(),tools:N.object({format:N.enum(Ce).optional(),color:N.boolean().optional(),port:N.coerce.number().int().positive().optional()}).partial().optional(),status:N.record(N.string(),N.unknown()).optional(),stop:N.record(N.string(),N.unknown()).optional()}),De=N.object({commands:Ee.default({}),tools:N.record(N.string(),Te).default({})});let I={config:we};function Oe(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 ke(e){let t=j.resolve(e);if(!A(t))throw Error(`Config path not found: ${t}`);return ae(t).isDirectory()?j.join(t,Se):t}function Ae(e,t){let n=t.env??process.env,r=t.cwd??process.cwd(),i=t.homeDir??se(),a=Oe(e);if(a)return ke(a);if(n[be])return ke(n[be]);let o=j.join(r,xe,Se);if(A(o))return o;let s=j.join(i,xe,Se);if(A(s))return s}function je(e){let t=ie(e,`utf8`),n=JSON.parse(t);return De.parse(n)}function Me(e,t={}){let n=Ae(e,t);return n?{configPath:n,config:je(n)}:{config:we}}function Ne(e,t={}){return I=Me(e,t),I}function L(e){return(I.config.commands??{})[e]??{}}function Pe(e){return I.config.tools?.[e]??{}}function R(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 Fe=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 z(e){return new Fe(e)}const Ie={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 B(e,t,n){return n?`${Ie[t]}${e}${Ie.reset}`:e}function Le(e,t){let{format:n,color:r}=t;return n===`quiet`?``:n===`json`?Re(e):ze(e,r)}function Re(e){return JSON.stringify(e,null,2)}function ze(e,t){let n=[];e.isError&&n.push(B(`Error:`,`red`,t));for(let r of e.content)r.type===`text`?n.push(Be(r,t)):r.type===`image`?n.push(Ue(r,t)):n.push(B(`[Unknown content type: ${r.type}]`,`yellow`,t));return n.join(`
|
|
3
|
-
`)}function
|
|
4
|
-
`)}function
|
|
5
|
-
`)}function Ge(e,t){let n=L(`tools`),r=R(e,`format`,t.format,n.format),i=R(e,`color`,t.color,n.color);return{port:R(e,`port`,t.port,n.port===void 0?void 0:String(n.port),process.env.PLAYWRIGHT_PORT),formatterOptions:{format:r,color:i}}}const Ke=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}=Ge(this,t);try{let t=await z({port:Number.parseInt(n,10)}).listCustomTools(e),i=r.format===`text`?We(t,r.color):r.format===`quiet`?``:JSON.stringify(t,null,2);i&&console.log(i)}catch(e){console.error(V(e instanceof Error?e:String(e),r.color)),process.exit(1)}}),qe=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}=Ge(this,r);try{let r;try{r=JSON.parse(n)}catch{console.error(V(`Invalid JSON arguments: ${n}`,a.color)),process.exit(1);return}let o=await z({port:Number.parseInt(i,10)}).executeCustomTool(e,t,r),s=Le(o,a);s&&console.log(s),o.isError&&process.exit(1)}catch(e){console.error(V(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(Ke).addCommand(qe);const Je=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)}}),Ye=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=L(`exec`),i=R(this,`format`,n.format,r.format),a=R(this,`color`,n.color,r.color),o=R(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(V(`Invalid JSON arguments: ${t}`,l.color)),process.exit(1)}let r=await z({port:Number.parseInt(o,10),exactPort:c}).execute(e,n),i=Le(r,l);i&&console.log(i),r.isError&&process.exit(1)}catch(e){console.error(V(e instanceof Error?e:String(e),l.color)),process.exit(1)}}),H=`pageId`,U=`browserId`,Xe=N.record(N.string(),N.unknown()),Ze=N.object({type:N.literal(`object`),properties:N.record(N.string(),N.unknown()).optional(),required:N.array(N.string()).optional(),additionalProperties:N.boolean().optional()}).passthrough(),Qe=N.object({name:N.string().min(1),description:N.string().min(1),script:N.string().min(1),suggestionActions:N.string().min(1).optional(),capabilities:Xe,inputSchema:Ze}),$e=N.object({tools:N.array(Qe)}),et=process.env.BROWSE_TOOL_DEBUG_CUSTOM_TOOLS===`1`;function tt(e){return JSON.stringify(e,(e,t)=>typeof t==`string`&&t.length>240?`${t.slice(0,240)}...<trimmed>`:t)}function nt(e,t){if(et){if(t){console.error(`[CustomToolService] ${e}`,t);return}console.error(`[CustomToolService] ${e}`)}}function W(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function rt(e){return W(e)&&Array.isArray(e.content)}function G(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 it(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 at(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 K(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(`-`)?ot(e,t,n):st(e,t,n)}function ot(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]=K(e,i+1,t.indent);r.push(a),i=o;continue}if(a.includes(`:`)){let[t,o]=ct(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]=K(e,i+1,r.indent);s[t]=a,i=o}else s[t]=G(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]=K(e,i,t.indent);if(!W(n))throw Error(`Expected object entry in tools.yaml at line ${i+1}`);Object.assign(s,n),i=r;continue}let[r,a]=ct(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]=K(e,i+1,n.indent);s[r]=a,i=o;continue}s[r]=G(a),i+=1}r.push(s);continue}r.push(G(a)),i+=1}return[r,i]}function st(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]=ct(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]=K(e,i+1,t.indent);r[a]=o,i=s;continue}r[a]=G(o),i+=1}return[r,i]}function ct(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 lt(e){let t=at(e);if(t.length===0)return{};let[n]=K(t,0,t[0].indent);return n}function ut(e){let t=e.inputSchema.properties;if(!t||!W(t))throw Error(`Custom tool "${e.name}" must define inputSchema.properties`);let n=t[H],r=t[U],i=n!==void 0&&W(n)&&n.type===`string`,a=r!==void 0&&W(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 dt(e){let t=S(await ce(e,`utf8`),{mode:`strip`});return await import(`data:text/javascript;base64,${Buffer.from(t,`utf8`).toString(`base64`)}`)}function ft(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 pt(e,t){return typeof e.suggestionActions==`string`&&e.suggestionActions.trim().length>0?e:{...e,suggestionActions:t}}function mt(e,t){let n=e.content[0];if(n?.type===`text`&&typeof n.text==`string`)try{let r=JSON.parse(n.text);if(W(r)){let i=pt(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 ht(e,t,n){if(rt(t))return n?mt(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=W(t)&&n?pt(t,n):t;return{content:[{type:`text`,text:JSON.stringify(r,null,2)}]}}var gt=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[H]==`string`&&t[H].length>0?t[H]:void 0,r=typeof t[U]==`string`&&t[U].length>0?t[U]: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:it({...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[H]==`string`?n[H]:void 0,i=typeof n[U]==`string`?n[U]:void 0;return this.telemetry.runInSpan(`browse_tool.custom_tool.execute`,{attributes:{"browse_tool.tool.name":t,"browse_tool.custom_tools.directory":j.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:M.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}),nt(`Executing custom tool`,{toolName:t,directory:j.resolve(e),pageId:a,browserId:o.browserId,mode:o.mode,input:tt(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 nt(`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})}nt(`Custom tool execution completed`,{toolName:t,pageId:a,browserId:o.browserId,mode:o.mode,result:tt(u)});let d=ht(t,u,i.suggestionActions),f=d.isError?d.content[0]?.text:void 0;return f&&r?.setStatus({code:M.ERROR,message:f}),d})}async loadTools(e){let t=j.resolve(e),n=j.join(t,`tools.yaml`),r=lt(await ce(n,`utf8`).catch(e=>{throw Error(`Failed to read custom tool manifest at "${n}": ${e instanceof Error?e.message:String(e)}`)})),i=$e.parse(r);return Promise.all(i.tools.map(async e=>{ut(e);let n=j.resolve(t,e.script);await le(n).catch(t=>{throw Error(`Custom tool "${e.name}" script not found at "${n}": ${t instanceof Error?t.message:String(t)}`)});let r=ft(n,await dt(n));return{name:e.name,description:e.description,suggestionActions:e.suggestionActions,inputSchema:e.inputSchema,capabilities:e.capabilities,scriptPath:n,...r}}))}};function _t(t){let n=new O;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 vt(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 yt(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 bt(e){return yt(new Date().getTime()-e.getTime())}const xt=`table-container`,St=`stat-card`,Ct=`browser-row`,wt=`page-row`,Tt=`status-active`,Et=`url-cell`,q=`timestamp-cell`,J=`actions-cell`,Y=`kill-btn`,Dt=`empty-state`;function Ot({browsers:e}){return e.length===0?P(`div`,{class:xt,children:F(`div`,{class:Dt,children:[P(`h3`,{children:`No Active Browsers`}),P(`p`,{children:`Launch a browser using MCP tools to see it here.`})]})}):P(`div`,{class:xt,children:F(`table`,{class:`browser-table`,children:[P(`thead`,{children:F(`tr`,{children:[P(`th`,{children:`ID`}),P(`th`,{children:`Status`}),P(`th`,{children:`URL / Title`}),P(`th`,{children:`Created`}),P(`th`,{children:`Age`}),P(`th`,{children:`Actions`})]})}),P(`tbody`,{id:`browser-table-body`,children:e.map(e=>F(fe,{children:[F(`tr`,{class:Ct,children:[P(`td`,{children:e.id}),P(`td`,{children:F(`span`,{class:Tt,children:[e.pages.length,` page`,e.pages.length===1?``:`s`]})}),P(`td`,{children:e.profileName||`Default Profile`}),P(`td`,{class:q,children:vt(e.createdAt)}),P(`td`,{class:q,children:bt(e.createdAt)}),P(`td`,{class:J,children:P(`button`,{class:Y,onclick:`dashboard.killBrowser('${e.id}')`,children:`Kill`})})]}),e.pages.map(t=>F(`tr`,{class:wt,children:[F(`td`,{children:[t.id,e.currentPageId===t.id&&` (active)`]}),P(`td`,{children:P(`span`,{class:Tt,children:`Open`})}),P(`td`,{class:Et,title:t.url,children:t.title||t.url||`about:blank`}),P(`td`,{class:q,children:vt(t.createdAt)}),P(`td`,{class:q,children:bt(t.createdAt)}),P(`td`,{class:J,children:P(`button`,{class:Y,onclick:`dashboard.killPage('${t.id}')`,children:`Close`})})]}))]}))})]})})}function kt({stats:e}){return F(`div`,{class:`stats-container`,children:[F(`div`,{class:St,children:[P(`h3`,{children:`Active Browsers`}),P(`div`,{class:`value`,children:e.totalBrowsers})]}),F(`div`,{class:St,children:[P(`h3`,{children:`Active Pages`}),P(`div`,{class:`value`,children:e.totalPages})]})]})}function At({browsers:e,stats:t}){return F(`div`,{class:`dashboard-container`,children:[F(`div`,{class:`dashboard-header`,children:[F(`div`,{children:[P(`h1`,{children:`Playwright MCP Dashboard`}),P(`p`,{children:`Browser automation management (auto-refresh every 3 seconds)`})]}),F(`div`,{children:[P(`button`,{id:`refresh-btn`,class:`btn refresh-btn`,onclick:`dashboard.manualRefresh()`,children:`Refresh Now`}),P(`button`,{id:`kill-all-btn`,class:`btn btn-danger`,onclick:`dashboard.killAllBrowsers()`,children:`Kill All Browsers`})]})]}),P(kt,{stats:t}),P(Ot,{browsers:e}),P(`script`,{children:de(`
|
|
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-Beq9pCY3.mjs";import"./playwright-test-yNsP599T.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{ProcessRegistryService as T}from"@agimon-ai/foundation-process-registry";import{DEFAULT_PORT_RANGE as E,PortRegistryService as te}from"@agimon-ai/foundation-port-registry";import{Server as D}from"@modelcontextprotocol/sdk/server/index.js";import{StdioServerTransport as ne}from"@modelcontextprotocol/sdk/server/stdio.js";import{CallToolRequestSchema as O,ListToolsRequestSchema as k}from"@modelcontextprotocol/sdk/types.js";import{existsSync as A,readFileSync as re,statSync as ie}from"node:fs";import j from"node:path";import{Hono as M}from"hono";import{cors as ae}from"hono/cors";import{Container as oe,ContainerModule as se}from"inversify";import{SpanStatusCode as N}from"@opentelemetry/api";import{homedir as ce}from"node:os";import{z as P}from"zod";import{readFile as le,stat as ue}from"node:fs/promises";import{createNodeWebSocket as de}from"@hono/node-ws";import{raw as fe}from"hono/html";import{Fragment as pe,jsx as F,jsxs as I}from"hono/jsx/jsx-runtime";var me=`0.2.14`;const he=process.env.BROWSE_TOOL_DEBUG_EXTENSION_RECORDING===`1`;function ge(e,t){if(!he)return;let n=t?` ${JSON.stringify(t)}`:``;console.log(`[ExtensionRecordingDebug] ${e}${n}`)}function _e(n){let r=new M,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 ge(`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 ge(`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:{}}}),ge(`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 ve(e){if(e==null||e===``)return;let t=typeof e==`number`?e:typeof e==`string`?Number.parseInt(e,10):NaN;if(!Number.isInteger(t)||t<=0||t>65535)throw Error(`Invalid port: ${e}`);return t}const ye=[`pnpm-workspace.yaml`,`nx.json`,`.git`],be=`browse-tool-chrome`,xe=`tool`,L=process.env.NODE_ENV||`development`,Se=`127.0.0.1`;function Ce(e=process.cwd()){let t=j.resolve(e);for(;;){for(let e of ye)if(A(j.join(t,e)))return t;let e=j.dirname(t);if(e===t)return process.cwd();t=e}}function we(e,t){if(!e)return;let n=j.resolve(e);return j.extname(n)===`.json`?j.join(j.dirname(n),t):j.join(n,t)}function Te(){return new te(process.env.PORT_REGISTRY_PATH)}function Ee(){return new T(process.env.PROCESS_REGISTRY_PATH)}async function De(e,t,n){let r=Te(),i=await r.reservePort({repositoryPath:e,serviceName:be,serviceType:xe,environment:L,preferredPort:t,portRange:n,pid:process.pid,host:Se,force:!0,metadata:{transport:`stdio`,mode:`chrome-serve`}});if(!i.success||!i.record)throw Error(i.error||`Failed to reserve port ${t}`);let a=!1;return{port:i.record.port,release:async()=>{if(a)return;a=!0;let n=await r.releasePort({repositoryPath:e,serviceName:be,serviceType:xe,environment:L,pid:process.pid});if(!n.success&&!n.error?.includes(`No matching registry entry`))throw Error(n.error||`Failed to release port ${t}`)}}}async function Oe(e,t,n){let r=Ee(),i=await r.registerProcess({repositoryPath:e,serviceName:be,serviceType:xe,environment:L,pid:process.pid,port:n,host:Se,command:process.argv[1],args:process.argv.slice(2),metadata:t,force:!0});if(!i.success||!i.record)throw Error(i.error||`Failed to register process`);let a=!1;return{release:async()=>{if(a)return;a=!0;let t=await r.releaseProcess({repositoryPath:e,serviceName:be,serviceType:xe,environment:L,pid:process.pid,kill:!1,releasePort:!1});if(!t.success&&!t.error?.includes(`No matching process entry`))throw Error(t.error||`Failed to release process`)}}}function ke(){return new se(t=>{t.bind(e.ExtensionTaskQueue).to(i).inSingletonScope(),t.bind(e.ExtensionToolDelegator).to(x).inSingletonScope()})}function Ae(e){let t=new D({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(k,async()=>({tools:n})),t.setRequestHandler(O,async t=>{let{name:n,arguments:r}=t.params;return await e.executeTool(n,r||{})}),t}const je=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`).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(``);let n,r;try{let i=ve(t.port),a=Ce(process.cwd()),o=process.env.PORT_REGISTRY_PATH;o&&(process.env.PROCESS_REGISTRY_PATH=we(o,`processes.json`)),n=await De(a,i??E.min,i?{min:i,max:i}:E);let s=n.port;r=await Oe(a,{transport:`stdio`,command:`chrome-serve`,waitForExtension:t.waitForExtension},s),t.verbose&&(console.error(`Chrome Extension MCP Server starting...`),console.error(` HTTP Port: ${s}`),console.error(` Wait for extension: ${t.waitForExtension}`));let c=new oe({defaultScope:`Singleton`});c.load(ke());let l=c.get(e.ExtensionTaskQueue),u=c.get(e.ExtensionToolDelegator),d=new M;d.use(`*`,ae({origin:e=>e??null,credentials:!0,allowMethods:[`GET`,`POST`,`OPTIONS`],allowHeaders:[`Content-Type`,`Accept`]}));let f=_e(c);d.route(`/extension`,f),d.get(`/health`,e=>{let t=l.getConnectionStatus();return e.json({status:`healthy`,service:`browse-tool-chrome`,extension:t})});let p=ee({fetch:d.fetch,port:s});p.on(`error`,e=>{e.code===`EADDRINUSE`?(console.error(`Error [PORT_IN_USE]: Port ${s} 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 ${s}`),console.error(`Waiting for Chrome extension to connect...`),console.error(`Extension should poll: http://localhost:${s}/extension/tasks`),t.waitForExtension&&(console.error(`Waiting for extension connection before starting MCP...`),await new Promise(e=>{let t=setInterval(()=>{l.getConnectionStatus().connected&&(clearInterval(t),console.error(`Extension connected!`),e())},500)}));let m=Ae(u),h=new ne;await m.connect(h),console.error(`Chrome extension MCP server started on stdio`);let g=async e=>{console.error(`\nReceived ${e}, shutting down gracefully...`);try{l.clearAllTasks(`Server shutting down`),await h.close(),p.close(),await r.release(),await n.release(),process.exit(0)}catch(e){console.error(`Error during shutdown:`,e),process.exit(1)}};process.on(`SIGINT`,()=>g(`SIGINT`)),process.on(`SIGTERM`,()=>g(`SIGTERM`))}catch(e){if(r||n)try{await r?.release(),await n?.release()}catch{}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)}}),Me=`BROWSE_TOOL_CONFIG`,Ne=`.browse-tool`,Pe=`config.json`,Fe=[`json`,`text`,`quiet`],Ie={commands:{},tools:{}},Le=P.record(P.string(),P.unknown()),Re=P.object({mcpServe:P.object({type:P.string().optional(),browser:P.string().optional(),headless:P.boolean().optional(),profile:P.string().optional(),mode:P.string().optional(),host:P.string().optional(),port:P.coerce.number().int().positive().optional(),tags:P.string().optional(),exclude:P.string().optional(),customTools:P.string().optional(),snippetsDir:P.string().optional(),registryPath:P.string().optional(),registryDir:P.string().optional(),pidsDir:P.string().optional(),profilesDir:P.string().optional()}).partial().optional(),httpServe:P.object({port:P.coerce.number().int().positive().optional(),headless:P.boolean().optional(),idleTimeout:P.coerce.number().positive().optional(),host:P.string().optional(),registryDir:P.string().optional(),registryPath:P.string().optional(),pidsDir:P.string().optional(),profilesDir:P.string().optional(),snippetsDir:P.string().optional()}).partial().optional(),exec:P.object({format:P.enum(Fe).optional(),color:P.boolean().optional(),port:P.coerce.number().int().positive().optional()}).partial().optional(),tools:P.object({format:P.enum(Fe).optional(),color:P.boolean().optional(),port:P.coerce.number().int().positive().optional()}).partial().optional(),status:P.record(P.string(),P.unknown()).optional(),stop:P.record(P.string(),P.unknown()).optional()}),ze=P.object({commands:Re.default({}),tools:P.record(P.string(),Le).default({})});let R={config:Ie};function Be(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 Ve(e){let t=j.resolve(e);if(!A(t))throw Error(`Config path not found: ${t}`);return ie(t).isDirectory()?j.join(t,Pe):t}function He(e,t){let n=t.env??process.env,r=t.cwd??process.cwd(),i=t.homeDir??ce(),a=Be(e);if(a)return Ve(a);if(n[Me])return Ve(n[Me]);let o=j.join(r,Ne,Pe);if(A(o))return o;let s=j.join(i,Ne,Pe);if(A(s))return s}function Ue(e){let t=re(e,`utf8`),n=JSON.parse(t);return ze.parse(n)}function We(e,t={}){let n=He(e,t);return n?{configPath:n,config:Ue(n)}:{config:Ie}}function Ge(e,t={}){return R=We(e,t),R}function z(e){return(R.config.commands??{})[e]??{}}function Ke(e){return R.config.tools?.[e]??{}}function B(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 qe=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 V(e){return new qe(e)}const Je={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 H(e,t,n){return n?`${Je[t]}${e}${Je.reset}`:e}function Ye(e,t){let{format:n,color:r}=t;return n===`quiet`?``:n===`json`?Xe(e):Ze(e,r)}function Xe(e){return JSON.stringify(e,null,2)}function Ze(e,t){let n=[];e.isError&&n.push(H(`Error:`,`red`,t));for(let r of e.content)r.type===`text`?n.push(Qe(r,t)):r.type===`image`?n.push(tt(r,t)):n.push(H(`[Unknown content type: ${r.type}]`,`yellow`,t));return n.join(`
|
|
3
|
+
`)}function Qe(e,t){let n=e.text;try{return $e(JSON.parse(n),t)}catch{return n}}function $e(e,t){if(typeof e!=`object`||!e)return String(e);let n=[];for(let[r,i]of Object.entries(e)){let e=H(r,`cyan`,t),a=et(i,t);n.push(`${e}: ${a}`)}return n.join(`
|
|
4
|
+
`)}function et(e,t){return e===null?H(`null`,`gray`,t):e===void 0?H(`undefined`,`gray`,t):typeof e==`boolean`?H(String(e),e?`green`:`red`,t):typeof e==`number`?H(String(e),`yellow`,t):typeof e==`string`?e.startsWith(`http://`)||e.startsWith(`https://`)?H(e,`blue`,t):e:Array.isArray(e)?e.length===0?H(`[]`,`gray`,t):JSON.stringify(e,null,2):typeof e==`object`?JSON.stringify(e,null,2):String(e)}function tt(e,t){let{mimeType:n,data:r}=e;return H(`[Image: ${n}, ~${Math.round(r.length*3/4/1024)}KB base64 data]`,`magenta`,t)}function U(e,t){return H(`Error: ${e instanceof Error?e.message:e}`,`red`,t)}function nt(e,t){let n=Math.max(...e.map(e=>e.name.length)),r=[];for(let i of e){let e=H(i.name.padEnd(n),`cyan`,t);r.push(` ${e} ${i.description}`)}return r.join(`
|
|
5
|
+
`)}function rt(e,t){let n=z(`tools`),r=B(e,`format`,t.format,n.format),i=B(e,`color`,t.color,n.color);return{port:B(e,`port`,t.port,n.port===void 0?void 0:String(n.port),process.env.PLAYWRIGHT_PORT),formatterOptions:{format:r,color:i}}}const it=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}=rt(this,t);try{let t=await V({port:Number.parseInt(n,10)}).listCustomTools(e),i=r.format===`text`?nt(t,r.color):r.format===`quiet`?``:JSON.stringify(t,null,2);i&&console.log(i)}catch(e){console.error(U(e instanceof Error?e:String(e),r.color)),process.exit(1)}}),at=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}=rt(this,r);try{let r;try{r=JSON.parse(n)}catch{console.error(U(`Invalid JSON arguments: ${n}`,a.color)),process.exit(1);return}let o=await V({port:Number.parseInt(i,10)}).executeCustomTool(e,t,r),s=Ye(o,a);s&&console.log(s),o.isError&&process.exit(1)}catch(e){console.error(U(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(it).addCommand(at);const ot=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)}}),st=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=z(`exec`),i=B(this,`format`,n.format,r.format),a=B(this,`color`,n.color,r.color),o=B(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(U(`Invalid JSON arguments: ${t}`,l.color)),process.exit(1)}let r=await V({port:Number.parseInt(o,10),exactPort:c}).execute(e,n),i=Ye(r,l);i&&console.log(i),r.isError&&process.exit(1)}catch(e){console.error(U(e instanceof Error?e:String(e),l.color)),process.exit(1)}}),W=`pageId`,G=`browserId`,ct=P.record(P.string(),P.unknown()),lt=P.object({type:P.literal(`object`),properties:P.record(P.string(),P.unknown()).optional(),required:P.array(P.string()).optional(),additionalProperties:P.boolean().optional()}).passthrough(),ut=P.object({name:P.string().min(1),description:P.string().min(1),script:P.string().min(1),suggestionActions:P.string().min(1).optional(),capabilities:ct,inputSchema:lt}),dt=P.object({tools:P.array(ut)}),ft=process.env.BROWSE_TOOL_DEBUG_CUSTOM_TOOLS===`1`;function pt(e){return JSON.stringify(e,(e,t)=>typeof t==`string`&&t.length>240?`${t.slice(0,240)}...<trimmed>`:t)}function mt(e,t){if(ft){if(t){console.error(`[CustomToolService] ${e}`,t);return}console.error(`[CustomToolService] ${e}`)}}function K(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function ht(e){return K(e)&&Array.isArray(e.content)}function q(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 gt(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 _t(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 J(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(`-`)?vt(e,t,n):yt(e,t,n)}function vt(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]=J(e,i+1,t.indent);r.push(a),i=o;continue}if(a.includes(`:`)){let[t,o]=bt(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]=J(e,i+1,r.indent);s[t]=a,i=o}else s[t]=q(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]=J(e,i,t.indent);if(!K(n))throw Error(`Expected object entry in tools.yaml at line ${i+1}`);Object.assign(s,n),i=r;continue}let[r,a]=bt(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]=J(e,i+1,n.indent);s[r]=a,i=o;continue}s[r]=q(a),i+=1}r.push(s);continue}r.push(q(a)),i+=1}return[r,i]}function yt(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]=bt(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]=J(e,i+1,t.indent);r[a]=o,i=s;continue}r[a]=q(o),i+=1}return[r,i]}function bt(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 xt(e){let t=_t(e);if(t.length===0)return{};let[n]=J(t,0,t[0].indent);return n}function St(e){let t=e.inputSchema.properties;if(!t||!K(t))throw Error(`Custom tool "${e.name}" must define inputSchema.properties`);let n=t[W],r=t[G],i=n!==void 0&&K(n)&&n.type===`string`,a=r!==void 0&&K(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 Ct(e){let t=S(await le(e,`utf8`),{mode:`strip`});return await import(`data:text/javascript;base64,${Buffer.from(t,`utf8`).toString(`base64`)}`)}function wt(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 Tt(e,t){return typeof e.suggestionActions==`string`&&e.suggestionActions.trim().length>0?e:{...e,suggestionActions:t}}function Et(e,t){let n=e.content[0];if(n?.type===`text`&&typeof n.text==`string`)try{let r=JSON.parse(n.text);if(K(r)){let i=Tt(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 Dt(e,t,n){if(ht(t))return n?Et(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=K(t)&&n?Tt(t,n):t;return{content:[{type:`text`,text:JSON.stringify(r,null,2)}]}}var Ot=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[W]==`string`&&t[W].length>0?t[W]:void 0,r=typeof t[G]==`string`&&t[G].length>0?t[G]: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:gt({...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[W]==`string`?n[W]:void 0,i=typeof n[G]==`string`?n[G]:void 0;return this.telemetry.runInSpan(`browse_tool.custom_tool.execute`,{attributes:{"browse_tool.tool.name":t,"browse_tool.custom_tools.directory":j.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:N.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}),mt(`Executing custom tool`,{toolName:t,directory:j.resolve(e),pageId:a,browserId:o.browserId,mode:o.mode,input:pt(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 mt(`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})}mt(`Custom tool execution completed`,{toolName:t,pageId:a,browserId:o.browserId,mode:o.mode,result:pt(u)});let d=Dt(t,u,i.suggestionActions),f=d.isError?d.content[0]?.text:void 0;return f&&r?.setStatus({code:N.ERROR,message:f}),d})}async loadTools(e){let t=j.resolve(e),n=j.join(t,`tools.yaml`),r=xt(await le(n,`utf8`).catch(e=>{throw Error(`Failed to read custom tool manifest at "${n}": ${e instanceof Error?e.message:String(e)}`)})),i=dt.parse(r);return Promise.all(i.tools.map(async e=>{St(e);let n=j.resolve(t,e.script);await ue(n).catch(t=>{throw Error(`Custom tool "${e.name}" script not found at "${n}": ${t instanceof Error?t.message:String(t)}`)});let r=wt(n,await Ct(n));return{name:e.name,description:e.description,suggestionActions:e.suggestionActions,inputSchema:e.inputSchema,capabilities:e.capabilities,scriptPath:n,...r}}))}};function kt(t){let n=new M;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 At(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 jt(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 Mt(e){return jt(new Date().getTime()-e.getTime())}const Nt=`table-container`,Pt=`stat-card`,Ft=`browser-row`,It=`page-row`,Y=`status-active`,Lt=`url-cell`,X=`timestamp-cell`,Z=`actions-cell`,Rt=`kill-btn`,zt=`empty-state`;function Bt({browsers:e}){return e.length===0?F(`div`,{class:Nt,children:I(`div`,{class:zt,children:[F(`h3`,{children:`No Active Browsers`}),F(`p`,{children:`Launch a browser using MCP tools to see it here.`})]})}):F(`div`,{class:Nt,children:I(`table`,{class:`browser-table`,children:[F(`thead`,{children:I(`tr`,{children:[F(`th`,{children:`ID`}),F(`th`,{children:`Status`}),F(`th`,{children:`URL / Title`}),F(`th`,{children:`Created`}),F(`th`,{children:`Age`}),F(`th`,{children:`Actions`})]})}),F(`tbody`,{id:`browser-table-body`,children:e.map(e=>I(pe,{children:[I(`tr`,{class:Ft,children:[F(`td`,{children:e.id}),F(`td`,{children:I(`span`,{class:Y,children:[e.pages.length,` page`,e.pages.length===1?``:`s`]})}),F(`td`,{children:e.profileName||`Default Profile`}),F(`td`,{class:X,children:At(e.createdAt)}),F(`td`,{class:X,children:Mt(e.createdAt)}),F(`td`,{class:Z,children:F(`button`,{class:Rt,onclick:`dashboard.killBrowser('${e.id}')`,children:`Kill`})})]}),e.pages.map(t=>I(`tr`,{class:It,children:[I(`td`,{children:[t.id,e.currentPageId===t.id&&` (active)`]}),F(`td`,{children:F(`span`,{class:Y,children:`Open`})}),F(`td`,{class:Lt,title:t.url,children:t.title||t.url||`about:blank`}),F(`td`,{class:X,children:At(t.createdAt)}),F(`td`,{class:X,children:Mt(t.createdAt)}),F(`td`,{class:Z,children:F(`button`,{class:Rt,onclick:`dashboard.killPage('${t.id}')`,children:`Close`})})]}))]}))})]})})}function Vt({stats:e}){return I(`div`,{class:`stats-container`,children:[I(`div`,{class:Pt,children:[F(`h3`,{children:`Active Browsers`}),F(`div`,{class:`value`,children:e.totalBrowsers})]}),I(`div`,{class:Pt,children:[F(`h3`,{children:`Active Pages`}),F(`div`,{class:`value`,children:e.totalPages})]})]})}function Ht({browsers:e,stats:t}){return I(`div`,{class:`dashboard-container`,children:[I(`div`,{class:`dashboard-header`,children:[I(`div`,{children:[F(`h1`,{children:`Playwright MCP Dashboard`}),F(`p`,{children:`Browser automation management (auto-refresh every 3 seconds)`})]}),I(`div`,{children:[F(`button`,{id:`refresh-btn`,class:`btn refresh-btn`,onclick:`dashboard.manualRefresh()`,children:`Refresh Now`}),F(`button`,{id:`kill-all-btn`,class:`btn btn-danger`,onclick:`dashboard.killAllBrowsers()`,children:`Kill All Browsers`})]})]}),F(Vt,{stats:t}),F(Bt,{browsers:e}),F(`script`,{children:fe(`
|
|
6
6
|
class DashboardManager {
|
|
7
7
|
constructor() {
|
|
8
8
|
this.autoRefreshInterval = null;
|
|
@@ -40,7 +40,7 @@ class DashboardManager {
|
|
|
40
40
|
}
|
|
41
41
|
|
|
42
42
|
updateStats(stats) {
|
|
43
|
-
const cards = document.querySelectorAll('.${
|
|
43
|
+
const cards = document.querySelectorAll('.${Pt} .value');
|
|
44
44
|
if (cards.length >= 2) {
|
|
45
45
|
cards[0].textContent = stats.totalBrowsers;
|
|
46
46
|
cards[1].textContent = stats.totalPages;
|
|
@@ -52,10 +52,10 @@ class DashboardManager {
|
|
|
52
52
|
if (!tbody) return;
|
|
53
53
|
|
|
54
54
|
if (browsers.length === 0) {
|
|
55
|
-
const container = tbody.closest('.${
|
|
55
|
+
const container = tbody.closest('.${Nt}');
|
|
56
56
|
if (container) {
|
|
57
57
|
container.innerHTML = \`
|
|
58
|
-
<div class="${
|
|
58
|
+
<div class="${zt}">
|
|
59
59
|
<h3>No Active Browsers</h3>
|
|
60
60
|
<p>Launch a browser using MCP tools to see it here.</p>
|
|
61
61
|
</div>
|
|
@@ -69,29 +69,29 @@ class DashboardManager {
|
|
|
69
69
|
browsers.forEach(browser => {
|
|
70
70
|
// Browser row
|
|
71
71
|
const browserRow = document.createElement('tr');
|
|
72
|
-
browserRow.className = '${
|
|
72
|
+
browserRow.className = '${Ft}';
|
|
73
73
|
browserRow.innerHTML = \`
|
|
74
74
|
<td>\${browser.id}</td>
|
|
75
|
-
<td><span class="${
|
|
75
|
+
<td><span class="${Y}">\${browser.pages.length} page\${browser.pages.length !== 1 ? 's' : ''}</span></td>
|
|
76
76
|
<td>\${browser.profileName || 'Default Profile'}</td>
|
|
77
|
-
<td class="${
|
|
78
|
-
<td class="${
|
|
79
|
-
<td class="${
|
|
77
|
+
<td class="${X}">\${this.formatTimestamp(browser.createdAt)}</td>
|
|
78
|
+
<td class="${X}">\${this.formatAge(browser.createdAt)}</td>
|
|
79
|
+
<td class="${Z}"><button class="${Rt}" onclick="dashboard.killBrowser('\${browser.id}')">Kill</button></td>
|
|
80
80
|
\`;
|
|
81
81
|
tbody.appendChild(browserRow);
|
|
82
82
|
|
|
83
83
|
// Page rows
|
|
84
84
|
browser.pages.forEach(page => {
|
|
85
85
|
const pageRow = document.createElement('tr');
|
|
86
|
-
pageRow.className = '${
|
|
86
|
+
pageRow.className = '${It}';
|
|
87
87
|
const isActive = browser.currentPageId === page.id;
|
|
88
88
|
pageRow.innerHTML = \`
|
|
89
89
|
<td>\${page.id}\${isActive ? ' (active)' : ''}</td>
|
|
90
|
-
<td><span class="${
|
|
91
|
-
<td class="${
|
|
92
|
-
<td class="${
|
|
93
|
-
<td class="${
|
|
94
|
-
<td class="${
|
|
90
|
+
<td><span class="${Y}">Open</span></td>
|
|
91
|
+
<td class="${Lt}" title="\${this.escapeHtml(page.url)}">\${this.escapeHtml(page.title || page.url || 'about:blank')}</td>
|
|
92
|
+
<td class="${X}">\${this.formatTimestamp(page.createdAt)}</td>
|
|
93
|
+
<td class="${X}">\${this.formatAge(page.createdAt)}</td>
|
|
94
|
+
<td class="${Z}"><button class="${Rt}" onclick="dashboard.killPage('\${page.id}')">Close</button></td>
|
|
95
95
|
\`;
|
|
96
96
|
tbody.appendChild(pageRow);
|
|
97
97
|
});
|
|
@@ -187,7 +187,7 @@ const dashboard = new DashboardManager();
|
|
|
187
187
|
window.addEventListener('beforeunload', () => {
|
|
188
188
|
dashboard.stopAutoRefresh();
|
|
189
189
|
});
|
|
190
|
-
`)})]})}function
|
|
190
|
+
`)})]})}function Ut({title:e,children:t}){return I(`html`,{lang:`en`,children:[I(`head`,{children:[F(`meta`,{charset:`UTF-8`}),F(`meta`,{name:`viewport`,content:`width=device-width, initial-scale=1.0`}),F(`title`,{children:e}),F(`style`,{children:fe(`
|
|
191
191
|
* {
|
|
192
192
|
margin: 0;
|
|
193
193
|
padding: 0;
|
|
@@ -428,8 +428,8 @@ window.addEventListener('beforeunload', () => {
|
|
|
428
428
|
margin-bottom: 0.5rem;
|
|
429
429
|
color: #999;
|
|
430
430
|
}
|
|
431
|
-
`)})]}),P(`body`,{children:t})]})}function Mt(t){let n=new O;return n.get(`/`,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,pages:t.map(e=>({id:e.id,url:e.url,title:e.title,createdAt:e.createdAt}))}}),c={totalBrowsers:a.length,totalPages:o.length};return n.html(P(jt,{title:`Playwright MCP Dashboard`,children:P(At,{browsers:s,stats:c})}))}catch(e){return console.error(`Failed to render dashboard:`,e),n.html(P(jt,{title:`Playwright MCP Dashboard - Error`,children:F(`div`,{style:`padding: 2rem; text-align: center;`,children:[P(`h1`,{children:`Failed to load dashboard`}),P(`p`,{children:e instanceof Error?e.message:String(e)}),P(`a`,{href:`/`,style:`color: #2196f3; text-decoration: underline;`,children:`Retry`})]})}),500)}}),n}function Nt(e){if(!e.isError)return;let t=e.content[0];return t?.type===`text`&&typeof t.text==`string`?t.text:`Unknown tool execution error`}function Pt(t){try{return t.get(e.TelemetryService)}catch{return new b}}function Ft(t){let n=new O,r=t.get(e.PageRegistry),i=t.get(e.BrowserService),a=t.get(e.ExtensionTaskQueue),o=Pt(t),s=new gt(r,a,o,i);n.use(`*`,k({origin:e=>e??null,credentials:!0,allowMethods:[`GET`,`POST`,`DELETE`,`OPTIONS`],allowHeaders:[`Content-Type`,`Accept`,`Authorization`]})),n.get(`/health`,e=>{try{let t=i.listBrowsers(),n={status:`healthy`,service:`browse-tool-http`,serviceName:`browse-tool-http`,timestamp:new Date().toISOString(),browsers:{count:t.length,instances:t.map(e=>({id:e.id,pageCount:e.pageIds.size,createdAt:e.createdAt.toISOString()}))}};return e.json(n)}catch(t){return e.json({status:`unhealthy`,service:`browse-tool-http`,serviceName:`browse-tool-http`,error:t instanceof Error?t.message:String(t)},503)}}),n.post(`/execute`,async n=>{try{let i=await n.req.json();if(!i.tool)return n.json({success:!1,error:`Missing "tool" field in request body`},400);let a=typeof i.arguments?.pageId==`string`?i.arguments.pageId:void 0;return await o.runInSpan(`browse_tool.http.execute`,{attributes:{"http.method":`POST`,"http.route":`/execute`,"browse_tool.tool.name":i.tool,"browse_tool.page.id":a}},async a=>{let s=t.getAll(e.Tool).find(e=>e.getDefinition().name===i.tool);if(process.env.BROWSE_TOOL_DEBUG_EXTENSION_RECORDING===`1`&&i.tool===`browser_launch`){let e=typeof i.arguments?.videoDir==`string`?i.arguments.videoDir:typeof i.arguments?.video_dir==`string`?i.arguments.video_dir:``;console.log(`[ExtensionRecordingDebug] http execute browser_launch mode=${String(i.arguments?.mode??``)} videoDir=${e}`)}if(!s)return a?.setStatus({code:M.ERROR,message:`Tool "${i.tool}" not found`}),o.log(`warn`,`browse-tool HTTP execute rejected unknown tool`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":i.tool}}),n.json({success:!1,error:`Tool "${i.tool}" not found`},404);let c=await s.execute(i.arguments||{}),l=i.arguments||{},u=typeof l.pageId==`string`?l.pageId:void 0;if(u){let n=t.get(e.BrowserService),i=r.get(u);i&&n.recordBrowserActivity(i.browserId,u)}let d=Nt(c);return d?(a?.setStatus({code:M.ERROR,message:d}),o.log(`error`,`browse-tool HTTP execute failed`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":i.tool,"browse_tool.page.id":u}})):o.log(`info`,`browse-tool HTTP execute succeeded`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":i.tool,"browse_tool.page.id":u}}),n.json({success:!c.isError,result:c,error:d})})}catch(e){return o.log(`error`,`browse-tool HTTP execute request crashed`,{attributes:{"http.route":`/execute`},exception:e}),n.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),n.get(`/browsers`,n=>{try{let r=t.get(e.BrowserService).listBrowsers();return n.json({browsers:r.map(e=>({id:e.id,profileName:e.profileName,pageIds:Array.from(e.pageIds),currentPageId:e.currentPageId,createdAt:e.createdAt.toISOString()}))})}catch(e){return n.json({error:e instanceof Error?e.message:String(e)},500)}}),n.get(`/tools`,n=>{try{let r=t.getAll(e.Tool);return n.json({tools:r.map(e=>e.getDefinition())})}catch(e){return n.json({error:e instanceof Error?e.message:String(e)},500)}}),n.get(`/custom-tools`,async e=>{let t=e.req.query(`dir`);if(!t)return e.json({tools:[],error:`Missing "dir" query parameter`},400);try{let n=await s.listTools(t);return e.json({tools:n})}catch(t){return e.json({tools:[],error:t instanceof Error?t.message:String(t)},400)}}),n.post(`/custom-tools`,async n=>{let i=n.req.query(`dir`);if(!i)return n.json({success:!1,error:`Missing "dir" query parameter`},400);try{let a=await n.req.json();if(!a.tool)return n.json({success:!1,error:`Missing "tool" field in request body`},400);let c=typeof a.arguments?.pageId==`string`?a.arguments.pageId:void 0;return await o.runInSpan(`browse_tool.http.custom_tool.execute`,{attributes:{"http.method":`POST`,"http.route":`/custom-tools`,"browse_tool.tool.name":a.tool,"browse_tool.page.id":c,"browse_tool.custom_tools.directory":i}},async l=>{let u=await s.executeTool(i,a.tool,a.arguments||{});if(c){let n=t.get(e.BrowserService),i=r.get(c);i&&n.recordBrowserActivity(i.browserId,c)}let d=Nt(u);return d?(l?.setStatus({code:M.ERROR,message:d}),o.log(`error`,`browse-tool custom tool execution failed`,{attributes:{"http.route":`/custom-tools`,"browse_tool.tool.name":a.tool,"browse_tool.page.id":c}})):o.log(`info`,`browse-tool custom tool execution succeeded`,{attributes:{"http.route":`/custom-tools`,"browse_tool.tool.name":a.tool,"browse_tool.page.id":c}}),n.json({success:!u.isError,result:u,error:d})})}catch(e){return o.log(`error`,`browse-tool custom tool request crashed`,{attributes:{"http.route":`/custom-tools`,"browse_tool.custom_tools.directory":i},exception:e}),n.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}});let c=ge(t);n.route(`/extension`,c);let l=_t(t);n.route(`/api`,l);let u=Mt(t);return n.route(`/`,u),n}function It(t,n,r){t.get(`/ws/extension/:browserId`,r(t=>{let r=t.req.param(`browserId`),i=null;return{onOpen(t,a){try{i=n.get(e.WebSocketHub).addConnection(a,r)}catch{a.close(1011,`Internal server error`)}},onMessage(t){if(i)try{let r=n.get(e.WebSocketHub),a=typeof t.data==`string`?t.data:t.data.toString();r.handleMessage(i,a)}catch{}},onClose(){if(i)try{n.get(e.WebSocketHub).removeConnection(i)}catch{}},onError(){if(i)try{n.get(e.WebSocketHub).removeConnection(i)}catch{}}}})),t.get(`/ws/stats`,t=>{try{let r=n.get(e.WebSocketHub).getStats();return t.json({totalConnections:r.totalConnections,browserCount:r.browserCount,connections:r.connections.map(e=>({id:e.id,browserId:e.browserId,connectedAt:e.connectedAt.toISOString()}))})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}})}const Lt=[`pnpm-workspace.yaml`,`nx.json`,`.git`];function Rt(e=process.cwd()){let t=j.resolve(e);for(;;){for(let e of Lt)if(A(j.join(t,e)))return t;let e=j.dirname(t);if(e===t)return process.cwd();t=e}}function zt(e,t){let n=j.resolve(e),r=j.extname(n)===`.json`?j.dirname(n):n;return j.join(r,t)}async function Bt(e,t){let n=await e.registerProcess({...t,force:!0});if(!n.success||!n.record)throw Error(n.error||`Failed to register process ${t.serviceName}`);let r=!1;return{release:async()=>{if(r)return;r=!0;let n=await e.releaseProcess({repositoryPath:t.repositoryPath,serviceName:t.serviceName,serviceType:t.serviceType,environment:t.environment,pid:t.pid,kill:!1,releasePort:!1});!n.success&&!n.error?.includes(`No matching process entry`)&&console.error(`Failed to release process registry entry for ${t.serviceName}: ${n.error}`)}}}const Vt=new C(`http-serve`).description(`Start HTTP server for browser automation`).option(`-p, --port <port>`,`Port to listen on`,String(d)).option(`--host <host>`,`Host to bind`,o()).option(`--headless`,`Run browsers in headless mode by default`,!0).option(`--idle-timeout <minutes>`,`Idle timeout in minutes before closing browsers`,`30`).option(`--registry-dir <path>`,`Custom registry path or directory for service discovery`).option(`--registry-path <path>`,`Custom registry path or directory for service discovery`).option(`--pids-dir <path>`,`Custom PIDs directory for process tracking (deprecated)`).option(`--profiles-dir <path>`,`Custom profiles directory for browser profiles`).option(`--snippets-dir <path>`,`Directory used by browser_run_code to save and load reusable snippets`).action(async function(t){let n=L(`httpServe`),i={port:R(this,`port`,t.port,n.port===void 0?void 0:String(n.port),process.env.PLAYWRIGHT_PORT),headless:R(this,`headless`,t.headless,n.headless),idleTimeout:R(this,`idleTimeout`,t.idleTimeout,n.idleTimeout===void 0?void 0:String(n.idleTimeout),process.env[a]),host:R(this,`host`,t.host,n.host,process.env.PLAYWRIGHT_HOST),registryDir:R(this,`registryDir`,t.registryDir,n.registryDir,process.env.PLAYWRIGHT_REGISTRY_DIR),registryPath:R(this,`registryPath`,t.registryPath,n.registryPath,process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH),pidsDir:R(this,`pidsDir`,t.pidsDir,n.pidsDir,process.env.PLAYWRIGHT_PIDS_DIR),profilesDir:R(this,`profilesDir`,t.profilesDir,n.profilesDir,process.env.PLAYWRIGHT_PROFILES_DIR),snippetsDir:R(this,`snippetsDir`,t.snippetsDir,n.snippetsDir,process.env.BROWSE_TOOL_SNIPPETS_DIR)},o;try{let t=Number.parseInt(i.port,10),n=`browse-tool-http`,s=process.env.NODE_ENV||`development`,c=Rt(process.cwd()),l=i.registryPath||i.registryDir||process.env.PLAYWRIGHT_REGISTRY_PATH;l&&(process.env.PLAYWRIGHT_REGISTRY_DIR=l,process.env.PORT_REGISTRY_PATH=l,process.env.PROCESS_REGISTRY_PATH=zt(l,`processes.json`)),process.env.PLAYWRIGHT_HOST=i.host,process.env.PLAYWRIGHT_PORT=i.port,process.env[a]=i.idleTimeout,i.pidsDir&&(process.env.PLAYWRIGHT_PIDS_DIR=i.pidsDir),i.profilesDir&&(process.env.PLAYWRIGHT_PROFILES_DIR=i.profilesDir),i.snippetsDir&&(process.env.BROWSE_TOOL_SNIPPETS_DIR=j.resolve(i.snippetsDir)),console.log(`Starting HTTP server for browser automation...`),console.log(` Port: ${t}`),console.log(` Host: ${i.host}`),console.log(` Headless: ${i.headless}`),console.log(` Idle Timeout: ${i.idleTimeout} minutes`),process.env.BROWSE_TOOL_SNIPPETS_DIR&&console.log(` Snippets Dir: ${process.env.BROWSE_TOOL_SNIPPETS_DIR}`);let u=r(),d=u.get(e.ProcessRegistryService),f=Ft(u),{injectWebSocket:p,upgradeWebSocket:m}=ue({app:f});It(f,u,m);let h=u.get(e.WebSocketHub),g=u.get(e.ExtensionTaskQueue),_=u.get(e.BrowserService),y=u.get(e.ExtensionSessionRegistry),b=u.get(e.PageRegistry),x=u.get(e.IdleCleanupService);x.start(),h.setEventHandlers({onSessionRegister:(e,t)=>{if(t.type===`session:register`){let n=t.payload.browserId||e.browserId,r=_.getBrowser(n),i,a;if(r&&(r.mode===`extension`||r.mode===`vm`)){i=r.id;let t=b.findByBrowser(i);a=r.currentPageId||t[0]?.id||``,h.reassignConnection(e.id,i),a||(a=b.registerExtensionPage(i),r.pageIds.add(a),r.currentPageId=a),console.log(`[WebSocket] Extension connected to existing browser: ${i}, pageId: ${a}`)}else{i=n,_.registerExtensionBrowserWithId(i),a=b.registerExtensionPage(i);let e=_.getBrowser(i);e&&(e.pageIds.add(a),e.currentPageId=a),console.log(`[WebSocket] Extension connected with new browser: ${i}, pageId: ${a}`)}let o=b.get(a);o&&(o.extensionTabId=t.payload.tabId,o.url=t.payload.url??o.url);let s=y.register({browserId:i,tabId:t.payload.tabId,url:t.payload.url,metadata:{transport:`websocket`}});h.sendSessionAck(e,t.id??``,s.id,s.controlMode),h.broadcastPageCreated(i,a,b.get(a)?.url)}},onTaskResult:(e,t)=>{if(t.type===`task:result`){let e=g.submitResult({taskId:t.payload.taskId,success:t.payload.success,result:t.payload.result,error:t.payload.error});e?.browserId&&_.recordBrowserActivity(e.browserId,e.pageId)}},onTabMapped:(e,t)=>{if(t.type===`tab:mapped`){let e=b.get(t.payload.pageId);if(!e)return;e.extensionTabId=t.payload.tabId,_.recordBrowserActivity(e.browserId,e.id)}},onDisconnect:e=>{e.sessionId&&y.removeSession(e.sessionId),console.log(`[WebSocket] Extension disconnected: ${e.browserId}`)}});let S=new oe(process.env.PORT_REGISTRY_PATH);l?console.log(` Registry path: ${l}`):console.log(` Registry path: default (~/.port-registry/ports.json)`);let C=await S.reservePort({repositoryPath:c,serviceName:n,serviceType:`tool`,environment:s,preferredPort:t,pid:process.pid,host:i.host,force:!0,portRange:{min:t,max:t},metadata:{healthCheckUrl:`${v(i.host,t)}/health`,headless:i.headless,idleTimeout:i.idleTimeout}});if(!C.success||!C.record)throw Error(C.error||`Failed to reserve port ${t} in global registry`);let w=t,T;try{T=ee({fetch:f.fetch,port:w,hostname:i.host})}catch(e){throw await S.releasePort({repositoryPath:c,serviceName:n,serviceType:`tool`,environment:s,pid:process.pid}),e}p(T),o=await Bt(d,{repositoryPath:c,serviceName:n,serviceType:`service`,environment:s,pid:process.pid,port:w,host:i.host,metadata:{healthCheckUrl:`${v(i.host,w)}/health`,headless:i.headless,idleTimeout:i.idleTimeout,transport:`http`}});let E=v(i.host,w);console.log(`HTTP server listening on ${E}`),console.log(` Health check: ${E}/health`),console.log(` Execute tool: POST ${E}/execute`),console.log(`
|
|
432
|
-
Press Ctrl+C to stop the server`);let D=async t=>{console.log(`\n\n${t} received. Shutting down gracefully...`);try{x.stop(),T.close(),console.log(`Server closed`);try{await u.get(e.BrowserService).closeAll(),console.log(`All browsers closed`)}catch{}try{o&&await o.release()}catch(e){console.error(`Process registry cleanup error:`,e)}try{await S.releasePort({repositoryPath:c,serviceName:n,serviceType:`tool`,environment:s,pid:process.pid}),console.log(`Service deregistered`)}catch{}console.log(`Goodbye!`),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){if(o)try{await o.release()}catch(e){console.error(`Process registry cleanup error:`,e)}console.error(`Error starting HTTP server:`,e),process.exit(1)}}),Ht={browser_click:[`input`],browser_fill:[`input`],browser_type:[`input`],browser_select:[`input`],browser_hover:[`input`],browser_drag:[`input`],browser_press_key:[`input`],browser_upload_file:[`input`],browser_navigate:[`navigation`],browser_go_back:[`navigation`],browser_go_forward:[`navigation`],browser_reload:[`navigation`],browser_wait_for:[`navigation`],browser_snapshot:[`snapshot`],browser_screenshot:[`snapshot`],browser_pdf:[`snapshot`],browser_list_pages:[`page`],browser_new_page:[`page`],browser_select_page:[`page`],browser_close_page:[`page`],browser_resize_page:[`page`,`emulation`],browser_handle_dialog:[`dialog`],browser_list_network_requests:[`network`],browser_get_network_request:[`network`],browser_list_console_messages:[`console`],browser_evaluate_script:[`script`],browser_emulate:[`emulation`],browser_expect:[`testing`],browser_start_trace:[`tracing`],browser_stop_trace:[`tracing`],browser_list_profiles:[`profile`],browser_delete_profile:[`profile`],run_spec:[`spec`,`testing`],discover_specs:[`spec`,`testing`],browser_launch:[`browser`],browser_close:[`browser`],browser_run_code:[`code`,`script`]};function Ut(e){let t=new Set;for(let[n,r]of Object.entries(Ht))r.some(t=>e.includes(t))&&t.add(n);return t}const Wt=3e3,Gt=[`browser_launch`],Kt=[`browser_new_page`];function qt(e){if(!e?.content?.[0]?.text)return null;try{let t=JSON.parse(e.content[0].text);return{browserId:t.browserId,pageId:t.pageId,mode:t.mode,url:t.url}}catch{return null}}async function Jt(e){await new Promise(t=>setTimeout(t,e))}async function Yt(e){let t=new AbortController,n=setTimeout(()=>t.abort(),Wt);try{let n=await fetch(`${e}/tools`,{signal:t.signal});if(!n.ok)throw Error(`HTTP error ${n.status}: ${n.statusText}`);let r=await n.json();if(r.error)throw Error(r.error);if(!Array.isArray(r.tools))throw Error(`Invalid /tools response: missing tools array`);if(r.tools.length===0)throw Error(`HTTP server returned an empty tool list`);return r.tools}finally{clearTimeout(n)}}function Xt(e,t){let n=new URL(`/custom-tools`,e);return n.searchParams.set(`dir`,t),n.toString()}async function Zt(e,t){let n=new AbortController,r=setTimeout(()=>n.abort(),Wt);try{let r=await fetch(Xt(e,t),{signal:n.signal});if(!r.ok)throw Error(`HTTP error ${r.status}: ${r.statusText}`);let i=await r.json();if(i.error)throw Error(i.error);if(!Array.isArray(i.tools))throw Error(`Invalid /custom-tools response: missing tools array`);return i.tools}finally{clearTimeout(r)}}async function Qt(e){let t;for(let n=1;n<=4;n+=1)try{return await Yt(e)}catch(e){t=e instanceof Error?e:Error(String(e)),n<4&&await Jt(150*n)}throw Error(`Failed to fetch tools after 4 attempts: ${t?.message??`Unknown error`}`,{cause:t})}async function $t(e,t){let n;for(let r=1;r<=4;r+=1)try{return await Zt(e,t)}catch(e){n=e instanceof Error?e:Error(String(e)),r<4&&await Jt(150*r)}throw Error(`Failed to fetch custom tools after 4 attempts: ${n?.message??`Unknown error`}`,{cause:n})}function en(e){if(!e?.tags?.length&&!e?.exclude?.length)return null;let t=e.tags?.length?Ut(e.tags):null,n=new Set(e.exclude??[]);if(!t)return n.size>0?n:null;for(let e of n)t.delete(e);return t}function tn(e){let{httpBaseUrl:t,sessionTracker:n,defaultMode:r,toolFilter:i,customToolsDir:a,enforcedProfileName:o}=e,s=i?.tags?.length?en(i):null,c=new Set(i?.exclude??[]),l=s!==null||c.size>0,u=new T({name:`browse-tool`,version:`0.1.0`},{capabilities:{tools:{}}}),d={name:`browser_list_session`,description:`List all browsers and pages created in this MCP session. Use this to see what resources you have available.`,inputSchema:{type:`object`,properties:{},required:[],additionalProperties:!1}},f=[],p=[],m=new Set;function h(e){return l?e.filter(e=>c.has(e.name)?!1:s===null?!0:s.has(e.name)):e}function g(e){return e.filter(e=>!c.has(e.name))}function _(e){return o?{...e,profileName:o}:e}function v(e){if(!o)return e;let t=e?.content?.[0]?.text;if(!t)return e;try{let n=JSON.parse(t),r=(Array.isArray(n.profiles)?n.profiles:[]).filter(e=>e?.name===o);return{...e,content:[{...e.content[0],text:JSON.stringify({...n,profileCount:r.length,profiles:r},null,2)},...e.content.slice(1)]}}catch{return e}}function y(e){return{name:e.name,description:e.description,inputSchema:e.inputSchema,annotations:e.capabilities}}function b(e){return c.has(e)?!1:s===null?!0:s.has(e)}return u.setRequestHandler(te,async()=>{try{let e=await Qt(t);f=e,m=new Set(e.map(e=>e.name));let r=a?await $t(t,a):[];p=r;let i=[...h(e),...g(r).map(e=>y(e))];return n&&i.push(d),{tools:i}}catch(e){if(f.length>0||p.length>0){console.error(`Failed to refresh tools from HTTP server. Returning cached tools:`,e instanceof Error?e.message:String(e));let t=[...h(f),...g(p).map(e=>y(e))];return n&&t.push(d),{tools:t}}let r=e instanceof Error?e.message:String(e);throw Error(`Failed to list tools from HTTP server at ${t}: ${r}`,{cause:e})}}),u.setRequestHandler(D,async e=>{let{name:i,arguments:o}=e.params,s=new Set(p.map(e=>e.name));if(i!==`browser_list_session`&&!b(i))return{content:[{type:`text`,text:`Tool "${i}" is not available (filtered by --tags or --exclude)`}],isError:!0};if(i===`browser_list_session`&&n){let e=n.getSessionState();return{content:[{type:`text`,text:JSON.stringify(e,null,2)}]}}let c=o||{};i===`browser_launch`&&r&&(c={...c,mode:r}),i===`browser_launch`&&(c=_(c));try{if(a&&!s.has(i)&&!m.has(i))try{p=await $t(t,a),s=new Set(p.map(e=>e.name))}catch(e){console.error(`Failed to refresh custom tools, using cached list: ${e instanceof Error?e.message:String(e)}`)}let e=s.has(i),r=await fetch(e&&a?Xt(t,a):`${t}/execute`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({tool:i,arguments:c})});if(!r.ok){let e=await r.text();return{content:[{type:`text`,text:`HTTP error ${r.status}: ${e}`}],isError:!0}}let o=await r.json();if(!o.success)return{content:[{type:`text`,text:o.error||o.result?.content?.[0]?.text||`Unknown error from HTTP server`}],isError:!0};if(n&&o.result){if(Gt.includes(i)){let e=qt(o.result);e?.browserId&&(n.trackBrowser(e.browserId,e.mode||`playwright`),e.pageId&&n.trackPage(e.pageId,e.browserId,e.url))}else if(Kt.includes(i)){let e=qt(o.result);e?.pageId&&e?.browserId&&n.trackPage(e.pageId,e.browserId,e.url)}}return i===`browser_list_profiles`&&o.result?v(o.result):o.result||{content:[{type:`text`,text:`No result returned`}]}}catch(e){return{content:[{type:`text`,text:`Failed to execute tool via HTTP server: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}}),u}const X=`stdio`,nn=`http`,Z=`streamable-http`,rn=new Set([X,nn,Z]),an=`chromium`,on=new Set([an,`firefox`,`webkit`]),sn=new Set([`playwright`,`extension`,`vm`,`stealth`]),Q=`SIGINT`,$=`SIGTERM`,cn=[`pnpm-workspace.yaml`,`nx.json`,`.git`],ln=`browse-tool-mcp-http`,un=`tool`,dn=`service`;var fn=class extends Error{code=`INVALID_TRANSPORT`;recovery=`Use --type ${[...rn].join(`, `)}`;transportType;constructor(e,t){super(`Unknown transport type: ${e}`,t),this.name=`InvalidTransportError`,this.transportType=e}},pn=class extends Error{code=`INVALID_BROWSER_TYPE`;recovery=`Use --browser ${[...on].join(`, `)}`;browserType;constructor(e,t){super(`Unknown browser type: ${e}`,t),this.name=`InvalidBrowserTypeError`,this.browserType=e}},mn=class extends Error{code=`INVALID_LAUNCH_MODE`;recovery=`Use --mode ${[...sn].join(`, `)}`;launchMode;constructor(e,t){super(`Unknown launch mode: ${e}`,t),this.name=`InvalidLaunchModeError`,this.launchMode=e}};function hn(e){let t=e.toLowerCase();if(!on.has(t))throw new pn(e);return t}function gn(e){let t=e.toLowerCase();if(!sn.has(t))throw new mn(e);return t}function _n(e){let t=typeof e==`number`?e:Number.parseInt(e,10);if(!Number.isInteger(t)||t<=0||t>65535)throw Error(`Invalid port: ${e}`);return t}function vn(e){let t=e.toLowerCase();return t===nn?Z:t}function yn(e,t){let n=e[t];return(Array.isArray(n)?n[0]:n)?.trim()||void 0}function bn(e=process.cwd()){let t=j.resolve(e);for(;;){for(let e of cn)if(A(j.join(t,e)))return t;let e=j.dirname(t);if(e===t)return process.cwd();t=e}}function xn(e,t){let n=j.resolve(e),r=j.extname(n)===`.json`?j.dirname(n):n;return j.join(r,t)}async function Sn(e,t){let n=await e.registerProcess({...t,force:!0});if(!n.success||!n.record)throw Error(n.error||`Failed to register process ${t.serviceName}`);let r=!1;return{release:async()=>{if(r)return;r=!0;let n=await e.releaseProcess({repositoryPath:t.repositoryPath,serviceName:t.serviceName,serviceType:t.serviceType,environment:t.environment,pid:t.pid,kill:!1,releasePort:!1});!n.success&&!n.error?.includes(`No matching process entry`)&&console.error(`Failed to release process registry entry for ${t.serviceName}: ${n.error}`)}}}function Cn(e){return e.split(`,`).map(e=>e.trim()).filter(e=>e.length>0)}function wn(e){let t=e.tags?Cn(e.tags):void 0,n=e.exclude?Cn(e.exclude):void 0;if(!(!t?.length&&!n?.length))return{tags:t,exclude:n}}var Tn=class extends Error{code=`BROWSER_CLEANUP_FAILED`;recovery=`Browsers may still be running; check the HTTP server or kill processes manually`;failedBrowserIds;httpBaseUrl;constructor(e,t,n){super(`Failed to close ${e.length} browser(s): ${e.join(`, `)}`,n),this.name=`BrowserCleanupError`,this.failedBrowserIds=e,this.httpBaseUrl=t}},En=class extends Error{code=`SESSION_SHUTDOWN_FAILED`;recovery=`Check logs for cleanup and transport errors; processes may need manual cleanup`;signal;constructor(e,t){super(`Shutdown failed for signal ${e}`,t),this.name=`SessionShutdownError`,this.signal=e}},Dn=class extends Error{code=`HTTP_SERVER_START_FAILED`;recovery=`Check if the HTTP server binary exists and the port is available`;constructor(e){super(`Failed to start HTTP server`,e),this.name=`HttpServerStartError`}},On=class extends Error{code=`MCP_SERVER_BOOTSTRAP_FAILED`;recovery=`Check if all dependencies are installed and try again`;constructor(e){super(`Failed to start MCP server`,e),this.name=`McpServerBootstrapError`}};async function kn(e,t){let n=e.getBrowserIds(),r=[],i;for(let e of n)try{let n=await fetch(`${t}/execute`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({tool:`browser_close`,arguments:{browserId:e}})});if(!n.ok){let e=await n.text().catch(()=>``);throw Error(`HTTP ${n.status} from ${t}/execute: ${e}`)}console.error(` Closed browser: ${e}`)}catch(t){let n=t instanceof Error?t:Error(String(t));console.error(` Failed to close browser: ${e}`,n),r.push(e),i??=n}if(r.length>0)throw new Tn(r,t,{cause:i});e.clear()}async function An(e,t,n,r){await e.start();let i=!1,a=async a=>{if(i)return;i=!0,console.error(`\nReceived ${a}, shutting down gracefully...`);let o;try{let e=t.getSessionState();e.totalBrowsers>0&&(console.error(` Cleaning up ${e.totalBrowsers} browser(s) from this session...`),await kn(t,n))}catch(e){o=e instanceof Error?e:Error(String(e)),console.error(`Browser cleanup error:`,o)}finally{try{await e.stop()}catch(e){let t=e instanceof Error?e:Error(String(e));console.error(`Transport stop error:`,t),o??=t}try{await r?.()}catch(e){let t=e instanceof Error?e:Error(String(e));console.error(`Process registry cleanup error:`,t),o??=t}if(o){let e=new En(a,{cause:o});console.error(`Error during shutdown:`,e),process.exit(1)}process.exit(0)}};process.once(Q,()=>a(Q)),process.once($,()=>a($))}const jn=new C(`mcp-serve`).description(`Start Playwright MCP server for browser automation`).option(`-t, --type <type>`,`Transport type: ${[X,Z].join(`, `)}`,X).option(`-b, --browser <browser>`,`Default browser type: ${[...on].join(`, `)}`,an).option(`--headless`,`Run browsers in headless mode by default`,!1).option(`--no-headless`,`Run browsers in headed mode (visible window)`).option(`--host <host>`,`Default host for HTTP services`,o()).option(`--port <port>`,`Port for streamable HTTP transport`,`3201`).option(`-p, --profile <name>`,`Default profile name for browser sessions`).option(`-m, --mode <mode>`,`Default launch mode: ${[...sn].join(`, `)}`).option(`--tags <tags>`,`Comma-separated tags to filter tools (e.g. input,navigation,snapshot)`).option(`--exclude <tools>`,`Comma-separated tool names to exclude (applied after --tags)`).option(`--custom-tools <path>`,`Path to a folder containing tools.yaml and custom tool scripts`).option(`--snippets-dir <path>`,`Path to a folder where browser_run_code snippets are stored`).option(`--idle-timeout <minutes>`,`Idle timeout in minutes before auto-closing browsers`).option(`--registry-path <path>`,`Custom registry path or directory for service discovery`).option(`--registry-dir <path>`,`Custom registry directory for service discovery`).option(`--pids-dir <path>`,`Custom PIDs directory for process tracking`).option(`--profiles-dir <path>`,`Custom profiles directory for browser profiles`).action(async function(t){let n=L(`mcpServe`),r={type:R(this,`type`,t.type,n.type),browser:R(this,`browser`,t.browser,n.browser),headless:R(this,`headless`,t.headless,n.headless),profile:R(this,`profile`,t.profile,n.profile),mode:R(this,`mode`,t.mode,n.mode),host:R(this,`host`,t.host,n.host,process.env.PLAYWRIGHT_HOST),port:R(this,`port`,t.port,n.port,process.env.PLAYWRIGHT_MCP_PORT),tags:R(this,`tags`,t.tags,n.tags),exclude:R(this,`exclude`,t.exclude,n.exclude),customTools:R(this,`customTools`,t.customTools,n.customTools),snippetsDir:R(this,`snippetsDir`,t.snippetsDir,n.snippetsDir),idleTimeout:R(this,`idleTimeout`,t.idleTimeout,n.idleTimeout===void 0?void 0:String(n.idleTimeout),process.env[a]),registryPath:R(this,`registryPath`,t.registryPath,n.registryPath,process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH),registryDir:R(this,`registryDir`,t.registryDir,n.registryDir,process.env.PLAYWRIGHT_REGISTRY_DIR),pidsDir:R(this,`pidsDir`,t.pidsDir,n.pidsDir,process.env.PLAYWRIGHT_PIDS_DIR),profilesDir:R(this,`profilesDir`,t.profilesDir,n.profilesDir,process.env.PLAYWRIGHT_PROFILES_DIR)},i=vn(r.type),c=bn(process.cwd()),l=process.env.NODE_ENV||`development`,u;try{if(!rn.has(i))throw new fn(i);let t=hn(r.browser),n=r.mode?gn(r.mode):void 0,d=_n(r.port??3201),f=wn(r),h=r.customTools?j.resolve(r.customTools):void 0,y=r.snippetsDir?j.resolve(r.snippetsDir):void 0;console.error(`Playwright MCP Server starting...`),console.error(` Transport: ${i}`),i===Z&&console.error(` MCP endpoint: http://${r.host??o()}:${d}/mcp`),console.error(` Default browser: ${t}`),console.error(` Headless: ${r.headless}`),n&&console.error(` Default mode: ${n}`),r.profile&&console.error(` Profile: ${r.profile}`),f?.tags?.length&&console.error(` Tags: ${f.tags.join(`, `)}`),f?.exclude?.length&&console.error(` Exclude: ${f.exclude.join(`, `)}`),h&&console.error(` Custom tools: ${h}`),y&&console.error(` Snippets dir: ${y}`),r.idleTimeout&&console.error(` Idle timeout: ${r.idleTimeout} minutes`);let b=r.registryPath||r.registryDir;b&&(process.env.PLAYWRIGHT_REGISTRY_DIR=b,process.env.PORT_REGISTRY_PATH=b,process.env.PROCESS_REGISTRY_PATH=xn(b,`processes.json`),console.error(` Registry path: ${b}`)),r.pidsDir&&(process.env.PLAYWRIGHT_PIDS_DIR=r.pidsDir,console.error(` PIDs dir: ${r.pidsDir}`)),r.profilesDir&&(process.env.PLAYWRIGHT_PROFILES_DIR=r.profilesDir,console.error(` Profiles dir: ${r.profilesDir}`)),y&&(process.env.BROWSE_TOOL_SNIPPETS_DIR=y),r.idleTimeout&&(process.env[a]=r.idleTimeout),r.host&&(process.env.PLAYWRIGHT_HOST=r.host),process.env.PLAYWRIGHT_PORT=s().toString();let x=m(),S=x.get(e.ProcessRegistryService),C=await x.get(e.HttpServerManager).ensureRunning();if(!C.running)throw new Dn;let w=v(o(),C.port),ee=C.spawned?`spawned`:`reused`;if(console.error(` HTTP server: ${ee} on port ${C.port}`),i===X){let e=new g,i=new p(tn({httpBaseUrl:w,sessionTracker:e,defaultMode:n,toolFilter:f,customToolsDir:h,enforcedProfileName:r.profile}));u=await Sn(S,{repositoryPath:c,serviceName:`browse-tool-mcp`,serviceType:dn,environment:l,pid:process.pid,metadata:{transport:X,browser:t,mode:n}}),await An(i,e,w,async()=>{await u?.release()});return}let T=new oe(process.env.PORT_REGISTRY_PATH),E=await T.reservePort({repositoryPath:c,serviceName:ln,serviceType:un,environment:l,preferredPort:d,pid:process.pid,host:r.host??o(),force:!0,portRange:{min:d,max:d},metadata:{healthCheckUrl:`${v(r.host??o(),d)}/health`,transport:Z}});if(!E.success||!E.record)throw Error(E.error||`Failed to reserve ${Z} port ${d}`);let D=E.record.port;u=await Sn(S,{repositoryPath:c,serviceName:ln,serviceType:dn,environment:l,pid:process.pid,port:D,host:r.host??o(),metadata:{healthCheckUrl:`${v(r.host??o(),D)}/health`,transport:Z}});let te=new _(({headers:e})=>{let t=yn(e,`x-profile`)??r.profile,i=new g;return{server:tn({httpBaseUrl:w,sessionTracker:i,defaultMode:n,toolFilter:f,customToolsDir:h,enforcedProfileName:t}),onClose:async()=>{i.getSessionState().totalBrowsers>0&&await kn(i,w)}}},{host:r.host??o(),port:D});try{await te.start()}catch(e){try{await u.release()}catch(e){console.error(`Process registry cleanup error:`,e)}throw await T.releasePort({repositoryPath:c,serviceName:ln,serviceType:un,environment:l,pid:process.pid}),e}let O=!1,k=async e=>{if(!O){O=!0,console.error(`\nReceived ${e}, shutting down gracefully...`);try{await te.stop();try{await u?.release()}catch(e){console.error(`Process registry cleanup error:`,e)}await T.releasePort({repositoryPath:c,serviceName:ln,serviceType:un,environment:l,pid:process.pid}),process.exit(0)}catch(e){console.error(`Transport stop error:`,e),process.exit(1)}}};process.once(Q,()=>k(Q)),process.once($,()=>k($))}catch(e){if(u)try{await u.release()}catch(e){console.error(`Process registry cleanup error:`,e)}(e instanceof fn||e instanceof pn||e instanceof mn||e instanceof Dn)&&(console.error(`Error [${e.code}]: ${e.message}`),console.error(`Recovery: ${e.recovery}`),process.exit(1));let t=new On({cause:e instanceof Error?e:Error(String(e))});console.error(`Error [${t.code}]: ${t.message}`,t.cause),console.error(`Recovery: ${t.recovery}`),process.exit(1)}}),Mn=new C(`status`).description(`Show status of HTTP server and diagnostics`).action(async()=>{try{let t=L(`httpServe`),n=process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH??t.registryPath??t.registryDir;n&&(process.env.PLAYWRIGHT_REGISTRY_DIR=n,process.env.PLAYWRIGHT_REGISTRY_PATH=n,process.env.PORT_REGISTRY_PATH=n),!process.env.PLAYWRIGHT_PIDS_DIR&&t.pidsDir&&(process.env.PLAYWRIGHT_PIDS_DIR=t.pidsDir),console.log(`browse-tool Status
|
|
433
|
-
`),console.log(`-`.repeat(50));let r=await u().get(e.HttpServerManager).getStatus();if(r.running){let e=process.env.PLAYWRIGHT_HOST??t.host??o();console.log(`HTTP Server: Running`),console.log(` PID: ${r.pid}`),console.log(` Port: ${r.port}`),console.log(` Health: ${v(e,r.port)}/health`),r.browserCount!==void 0&&console.log(` Browsers: ${r.browserCount}`)}else console.log(`HTTP Server: Not Running`),r.error&&console.log(` Error: ${r.error}`);console.log(``),console.log(`-`.repeat(50)),process.exit(0)}catch(e){console.error(`Error getting status:`,e),process.exit(1)}}),
|
|
434
|
-
`)}}function
|
|
431
|
+
`)})]}),F(`body`,{children:t})]})}function Wt(t){let n=new M;return n.get(`/`,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,pages:t.map(e=>({id:e.id,url:e.url,title:e.title,createdAt:e.createdAt}))}}),c={totalBrowsers:a.length,totalPages:o.length};return n.html(F(Ut,{title:`Playwright MCP Dashboard`,children:F(Ht,{browsers:s,stats:c})}))}catch(e){return console.error(`Failed to render dashboard:`,e),n.html(F(Ut,{title:`Playwright MCP Dashboard - Error`,children:I(`div`,{style:`padding: 2rem; text-align: center;`,children:[F(`h1`,{children:`Failed to load dashboard`}),F(`p`,{children:e instanceof Error?e.message:String(e)}),F(`a`,{href:`/`,style:`color: #2196f3; text-decoration: underline;`,children:`Retry`})]})}),500)}}),n}function Gt(e){if(!e.isError)return;let t=e.content[0];return t?.type===`text`&&typeof t.text==`string`?t.text:`Unknown tool execution error`}function Kt(t){try{return t.get(e.TelemetryService)}catch{return new b}}function qt(t){let n=new M,r=t.get(e.PageRegistry),i=t.get(e.BrowserService),a=t.get(e.ExtensionTaskQueue),o=Kt(t),s=new Ot(r,a,o,i);n.use(`*`,ae({origin:e=>e??null,credentials:!0,allowMethods:[`GET`,`POST`,`DELETE`,`OPTIONS`],allowHeaders:[`Content-Type`,`Accept`,`Authorization`]})),n.get(`/health`,e=>{try{let t=i.listBrowsers(),n={status:`healthy`,service:`browse-tool-http`,serviceName:`browse-tool-http`,timestamp:new Date().toISOString(),browsers:{count:t.length,instances:t.map(e=>({id:e.id,pageCount:e.pageIds.size,createdAt:e.createdAt.toISOString()}))}};return e.json(n)}catch(t){return e.json({status:`unhealthy`,service:`browse-tool-http`,serviceName:`browse-tool-http`,error:t instanceof Error?t.message:String(t)},503)}}),n.post(`/execute`,async n=>{try{let i=await n.req.json();if(!i.tool)return n.json({success:!1,error:`Missing "tool" field in request body`},400);let a=typeof i.arguments?.pageId==`string`?i.arguments.pageId:void 0;return await o.runInSpan(`browse_tool.http.execute`,{attributes:{"http.method":`POST`,"http.route":`/execute`,"browse_tool.tool.name":i.tool,"browse_tool.page.id":a}},async a=>{let s=t.getAll(e.Tool).find(e=>e.getDefinition().name===i.tool);if(process.env.BROWSE_TOOL_DEBUG_EXTENSION_RECORDING===`1`&&i.tool===`browser_launch`){let e=typeof i.arguments?.videoDir==`string`?i.arguments.videoDir:typeof i.arguments?.video_dir==`string`?i.arguments.video_dir:``;console.log(`[ExtensionRecordingDebug] http execute browser_launch mode=${String(i.arguments?.mode??``)} videoDir=${e}`)}if(!s)return a?.setStatus({code:N.ERROR,message:`Tool "${i.tool}" not found`}),o.log(`warn`,`browse-tool HTTP execute rejected unknown tool`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":i.tool}}),n.json({success:!1,error:`Tool "${i.tool}" not found`},404);let c=await s.execute(i.arguments||{}),l=i.arguments||{},u=typeof l.pageId==`string`?l.pageId:void 0;if(u){let n=t.get(e.BrowserService),i=r.get(u);i&&n.recordBrowserActivity(i.browserId,u)}let d=Gt(c);return d?(a?.setStatus({code:N.ERROR,message:d}),o.log(`error`,`browse-tool HTTP execute failed`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":i.tool,"browse_tool.page.id":u}})):o.log(`info`,`browse-tool HTTP execute succeeded`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":i.tool,"browse_tool.page.id":u}}),n.json({success:!c.isError,result:c,error:d})})}catch(e){return o.log(`error`,`browse-tool HTTP execute request crashed`,{attributes:{"http.route":`/execute`},exception:e}),n.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),n.get(`/browsers`,n=>{try{let r=t.get(e.BrowserService).listBrowsers();return n.json({browsers:r.map(e=>({id:e.id,profileName:e.profileName,pageIds:Array.from(e.pageIds),currentPageId:e.currentPageId,createdAt:e.createdAt.toISOString()}))})}catch(e){return n.json({error:e instanceof Error?e.message:String(e)},500)}}),n.get(`/tools`,n=>{try{let r=t.getAll(e.Tool);return n.json({tools:r.map(e=>e.getDefinition())})}catch(e){return n.json({error:e instanceof Error?e.message:String(e)},500)}}),n.get(`/custom-tools`,async e=>{let t=e.req.query(`dir`);if(!t)return e.json({tools:[],error:`Missing "dir" query parameter`},400);try{let n=await s.listTools(t);return e.json({tools:n})}catch(t){return e.json({tools:[],error:t instanceof Error?t.message:String(t)},400)}}),n.post(`/custom-tools`,async n=>{let i=n.req.query(`dir`);if(!i)return n.json({success:!1,error:`Missing "dir" query parameter`},400);try{let a=await n.req.json();if(!a.tool)return n.json({success:!1,error:`Missing "tool" field in request body`},400);let c=typeof a.arguments?.pageId==`string`?a.arguments.pageId:void 0;return await o.runInSpan(`browse_tool.http.custom_tool.execute`,{attributes:{"http.method":`POST`,"http.route":`/custom-tools`,"browse_tool.tool.name":a.tool,"browse_tool.page.id":c,"browse_tool.custom_tools.directory":i}},async l=>{let u=await s.executeTool(i,a.tool,a.arguments||{});if(c){let n=t.get(e.BrowserService),i=r.get(c);i&&n.recordBrowserActivity(i.browserId,c)}let d=Gt(u);return d?(l?.setStatus({code:N.ERROR,message:d}),o.log(`error`,`browse-tool custom tool execution failed`,{attributes:{"http.route":`/custom-tools`,"browse_tool.tool.name":a.tool,"browse_tool.page.id":c}})):o.log(`info`,`browse-tool custom tool execution succeeded`,{attributes:{"http.route":`/custom-tools`,"browse_tool.tool.name":a.tool,"browse_tool.page.id":c}}),n.json({success:!u.isError,result:u,error:d})})}catch(e){return o.log(`error`,`browse-tool custom tool request crashed`,{attributes:{"http.route":`/custom-tools`,"browse_tool.custom_tools.directory":i},exception:e}),n.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}});let c=_e(t);n.route(`/extension`,c);let l=kt(t);n.route(`/api`,l);let u=Wt(t);return n.route(`/`,u),n}function Jt(t,n,r){t.get(`/ws/extension/:browserId`,r(t=>{let r=t.req.param(`browserId`),i=null;return{onOpen(t,a){try{i=n.get(e.WebSocketHub).addConnection(a,r)}catch{a.close(1011,`Internal server error`)}},onMessage(t){if(i)try{let r=n.get(e.WebSocketHub),a=typeof t.data==`string`?t.data:t.data.toString();r.handleMessage(i,a)}catch{}},onClose(){if(i)try{n.get(e.WebSocketHub).removeConnection(i)}catch{}},onError(){if(i)try{n.get(e.WebSocketHub).removeConnection(i)}catch{}}}})),t.get(`/ws/stats`,t=>{try{let r=n.get(e.WebSocketHub).getStats();return t.json({totalConnections:r.totalConnections,browserCount:r.browserCount,connections:r.connections.map(e=>({id:e.id,browserId:e.browserId,connectedAt:e.connectedAt.toISOString()}))})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}})}const Yt=[`pnpm-workspace.yaml`,`nx.json`,`.git`];function Xt(e=process.cwd()){let t=j.resolve(e);for(;;){for(let e of Yt)if(A(j.join(t,e)))return t;let e=j.dirname(t);if(e===t)return process.cwd();t=e}}function Zt(e,t){let n=j.resolve(e),r=j.extname(n)===`.json`?j.dirname(n):n;return j.join(r,t)}async function Qt(e,t){let n=await e.registerProcess({...t,force:!0});if(!n.success||!n.record)throw Error(n.error||`Failed to register process ${t.serviceName}`);let r=!1;return{release:async()=>{if(r)return;r=!0;let n=await e.releaseProcess({repositoryPath:t.repositoryPath,serviceName:t.serviceName,serviceType:t.serviceType,environment:t.environment,pid:t.pid,kill:!1,releasePort:!1});!n.success&&!n.error?.includes(`No matching process entry`)&&console.error(`Failed to release process registry entry for ${t.serviceName}: ${n.error}`)}}}const $t=new C(`http-serve`).description(`Start HTTP server for browser automation`).option(`-p, --port <port>`,`Port to listen on`,String(d)).option(`--host <host>`,`Host to bind`,o()).option(`--headless`,`Run browsers in headless mode by default`,!0).option(`--idle-timeout <minutes>`,`Idle timeout in minutes before closing browsers`,`30`).option(`--registry-dir <path>`,`Custom registry path or directory for service discovery`).option(`--registry-path <path>`,`Custom registry path or directory for service discovery`).option(`--pids-dir <path>`,`Custom PIDs directory for process tracking (deprecated)`).option(`--profiles-dir <path>`,`Custom profiles directory for browser profiles`).option(`--snippets-dir <path>`,`Directory used by browser_run_code to save and load reusable snippets`).action(async function(t){let n=z(`httpServe`),i={port:B(this,`port`,t.port,n.port===void 0?void 0:String(n.port),process.env.PLAYWRIGHT_PORT),headless:B(this,`headless`,t.headless,n.headless),idleTimeout:B(this,`idleTimeout`,t.idleTimeout,n.idleTimeout===void 0?void 0:String(n.idleTimeout),process.env[a]),host:B(this,`host`,t.host,n.host,process.env.PLAYWRIGHT_HOST),registryDir:B(this,`registryDir`,t.registryDir,n.registryDir,process.env.PLAYWRIGHT_REGISTRY_DIR),registryPath:B(this,`registryPath`,t.registryPath,n.registryPath,process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH),pidsDir:B(this,`pidsDir`,t.pidsDir,n.pidsDir,process.env.PLAYWRIGHT_PIDS_DIR),profilesDir:B(this,`profilesDir`,t.profilesDir,n.profilesDir,process.env.PLAYWRIGHT_PROFILES_DIR),snippetsDir:B(this,`snippetsDir`,t.snippetsDir,n.snippetsDir,process.env.BROWSE_TOOL_SNIPPETS_DIR)},o;try{let t=Number.parseInt(i.port,10),n=`browse-tool-http`,s=process.env.NODE_ENV||`development`,c=Xt(process.cwd()),l=i.registryPath||i.registryDir||process.env.PLAYWRIGHT_REGISTRY_PATH;l&&(process.env.PLAYWRIGHT_REGISTRY_DIR=l,process.env.PORT_REGISTRY_PATH=l,process.env.PROCESS_REGISTRY_PATH=Zt(l,`processes.json`)),process.env.PLAYWRIGHT_HOST=i.host,process.env.PLAYWRIGHT_PORT=i.port,process.env[a]=i.idleTimeout,i.pidsDir&&(process.env.PLAYWRIGHT_PIDS_DIR=i.pidsDir),i.profilesDir&&(process.env.PLAYWRIGHT_PROFILES_DIR=i.profilesDir),i.snippetsDir&&(process.env.BROWSE_TOOL_SNIPPETS_DIR=j.resolve(i.snippetsDir)),console.log(`Starting HTTP server for browser automation...`),console.log(` Port: ${t}`),console.log(` Host: ${i.host}`),console.log(` Headless: ${i.headless}`),console.log(` Idle Timeout: ${i.idleTimeout} minutes`),process.env.BROWSE_TOOL_SNIPPETS_DIR&&console.log(` Snippets Dir: ${process.env.BROWSE_TOOL_SNIPPETS_DIR}`);let u=r(),d=u.get(e.ProcessRegistryService),f=qt(u),{injectWebSocket:p,upgradeWebSocket:m}=de({app:f});Jt(f,u,m);let h=u.get(e.WebSocketHub),g=u.get(e.ExtensionTaskQueue),_=u.get(e.BrowserService),y=u.get(e.ExtensionSessionRegistry),b=u.get(e.PageRegistry),x=u.get(e.IdleCleanupService);x.start(),h.setEventHandlers({onSessionRegister:(e,t)=>{if(t.type===`session:register`){let n=t.payload.browserId||e.browserId,r=_.getBrowser(n),i,a;if(r&&(r.mode===`extension`||r.mode===`vm`)){i=r.id;let t=b.findByBrowser(i);a=r.currentPageId||t[0]?.id||``,h.reassignConnection(e.id,i),a||(a=b.registerExtensionPage(i),r.pageIds.add(a),r.currentPageId=a),console.log(`[WebSocket] Extension connected to existing browser: ${i}, pageId: ${a}`)}else{i=n,_.registerExtensionBrowserWithId(i),a=b.registerExtensionPage(i);let e=_.getBrowser(i);e&&(e.pageIds.add(a),e.currentPageId=a),console.log(`[WebSocket] Extension connected with new browser: ${i}, pageId: ${a}`)}let o=b.get(a);o&&(o.extensionTabId=t.payload.tabId,o.url=t.payload.url??o.url);let s=y.register({browserId:i,tabId:t.payload.tabId,url:t.payload.url,metadata:{transport:`websocket`}});h.sendSessionAck(e,t.id??``,s.id,s.controlMode),h.broadcastPageCreated(i,a,b.get(a)?.url)}},onTaskResult:(e,t)=>{if(t.type===`task:result`){let e=g.submitResult({taskId:t.payload.taskId,success:t.payload.success,result:t.payload.result,error:t.payload.error});e?.browserId&&_.recordBrowserActivity(e.browserId,e.pageId)}},onTabMapped:(e,t)=>{if(t.type===`tab:mapped`){let e=b.get(t.payload.pageId);if(!e)return;e.extensionTabId=t.payload.tabId,_.recordBrowserActivity(e.browserId,e.id)}},onDisconnect:e=>{e.sessionId&&y.removeSession(e.sessionId),console.log(`[WebSocket] Extension disconnected: ${e.browserId}`)}});let S=new te(process.env.PORT_REGISTRY_PATH);l?console.log(` Registry path: ${l}`):console.log(` Registry path: default (~/.port-registry/ports.json)`);let C=await S.reservePort({repositoryPath:c,serviceName:n,serviceType:`tool`,environment:s,preferredPort:t,pid:process.pid,host:i.host,force:!0,portRange:{min:t,max:t},metadata:{healthCheckUrl:`${v(i.host,t)}/health`,headless:i.headless,idleTimeout:i.idleTimeout}});if(!C.success||!C.record)throw Error(C.error||`Failed to reserve port ${t} in global registry`);let w=t,T;try{T=ee({fetch:f.fetch,port:w,hostname:i.host})}catch(e){throw await S.releasePort({repositoryPath:c,serviceName:n,serviceType:`tool`,environment:s,pid:process.pid}),e}p(T),o=await Qt(d,{repositoryPath:c,serviceName:n,serviceType:`service`,environment:s,pid:process.pid,port:w,host:i.host,metadata:{healthCheckUrl:`${v(i.host,w)}/health`,headless:i.headless,idleTimeout:i.idleTimeout,transport:`http`}});let E=v(i.host,w);console.log(`HTTP server listening on ${E}`),console.log(` Health check: ${E}/health`),console.log(` Execute tool: POST ${E}/execute`),console.log(`
|
|
432
|
+
Press Ctrl+C to stop the server`);let D=async t=>{console.log(`\n\n${t} received. Shutting down gracefully...`);try{x.stop(),T.close(),console.log(`Server closed`);try{await u.get(e.BrowserService).closeAll(),console.log(`All browsers closed`)}catch{}try{o&&await o.release()}catch(e){console.error(`Process registry cleanup error:`,e)}try{await S.releasePort({repositoryPath:c,serviceName:n,serviceType:`tool`,environment:s,pid:process.pid}),console.log(`Service deregistered`)}catch{}console.log(`Goodbye!`),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){if(o)try{await o.release()}catch(e){console.error(`Process registry cleanup error:`,e)}console.error(`Error starting HTTP server:`,e),process.exit(1)}}),en={browser_click:[`input`],browser_fill:[`input`],browser_type:[`input`],browser_select:[`input`],browser_hover:[`input`],browser_drag:[`input`],browser_press_key:[`input`],browser_upload_file:[`input`],browser_navigate:[`navigation`],browser_go_back:[`navigation`],browser_go_forward:[`navigation`],browser_reload:[`navigation`],browser_wait_for:[`navigation`],browser_snapshot:[`snapshot`],browser_screenshot:[`snapshot`],browser_pdf:[`snapshot`],browser_list_pages:[`page`],browser_new_page:[`page`],browser_select_page:[`page`],browser_close_page:[`page`],browser_resize_page:[`page`,`emulation`],browser_handle_dialog:[`dialog`],browser_list_network_requests:[`network`],browser_get_network_request:[`network`],browser_list_console_messages:[`console`],browser_evaluate_script:[`script`],browser_emulate:[`emulation`],browser_expect:[`testing`],browser_start_trace:[`tracing`],browser_stop_trace:[`tracing`],browser_list_profiles:[`profile`],browser_delete_profile:[`profile`],run_spec:[`spec`,`testing`],discover_specs:[`spec`,`testing`],browser_launch:[`browser`],browser_close:[`browser`],browser_run_code:[`code`,`script`]};function tn(e){let t=new Set;for(let[n,r]of Object.entries(en))r.some(t=>e.includes(t))&&t.add(n);return t}const nn=3e3,rn=[`browser_launch`],an=[`browser_new_page`];function on(e){if(!e?.content?.[0]?.text)return null;try{let t=JSON.parse(e.content[0].text);return{browserId:t.browserId,pageId:t.pageId,mode:t.mode,url:t.url}}catch{return null}}async function sn(e){await new Promise(t=>setTimeout(t,e))}async function cn(e){let t=new AbortController,n=setTimeout(()=>t.abort(),nn);try{let n=await fetch(`${e}/tools`,{signal:t.signal});if(!n.ok)throw Error(`HTTP error ${n.status}: ${n.statusText}`);let r=await n.json();if(r.error)throw Error(r.error);if(!Array.isArray(r.tools))throw Error(`Invalid /tools response: missing tools array`);if(r.tools.length===0)throw Error(`HTTP server returned an empty tool list`);return r.tools}finally{clearTimeout(n)}}function ln(e,t){let n=new URL(`/custom-tools`,e);return n.searchParams.set(`dir`,t),n.toString()}async function un(e,t){let n=new AbortController,r=setTimeout(()=>n.abort(),nn);try{let r=await fetch(ln(e,t),{signal:n.signal});if(!r.ok)throw Error(`HTTP error ${r.status}: ${r.statusText}`);let i=await r.json();if(i.error)throw Error(i.error);if(!Array.isArray(i.tools))throw Error(`Invalid /custom-tools response: missing tools array`);return i.tools}finally{clearTimeout(r)}}async function dn(e){let t;for(let n=1;n<=4;n+=1)try{return await cn(e)}catch(e){t=e instanceof Error?e:Error(String(e)),n<4&&await sn(150*n)}throw Error(`Failed to fetch tools after 4 attempts: ${t?.message??`Unknown error`}`,{cause:t})}async function fn(e,t){let n;for(let r=1;r<=4;r+=1)try{return await un(e,t)}catch(e){n=e instanceof Error?e:Error(String(e)),r<4&&await sn(150*r)}throw Error(`Failed to fetch custom tools after 4 attempts: ${n?.message??`Unknown error`}`,{cause:n})}function pn(e){if(!e?.tags?.length&&!e?.exclude?.length)return null;let t=e.tags?.length?tn(e.tags):null,n=new Set(e.exclude??[]);if(!t)return n.size>0?n:null;for(let e of n)t.delete(e);return t}function mn(e){let{httpBaseUrl:t,sessionTracker:n,defaultMode:r,toolFilter:i,customToolsDir:a,enforcedProfileName:o}=e,s=i?.tags?.length?pn(i):null,c=new Set(i?.exclude??[]),l=s!==null||c.size>0,u=new D({name:`browse-tool`,version:`0.1.0`},{capabilities:{tools:{}}}),d={name:`browser_list_session`,description:`List all browsers and pages created in this MCP session. Use this to see what resources you have available.`,inputSchema:{type:`object`,properties:{},required:[],additionalProperties:!1}},f=[],p=[],m=new Set;function h(e){return l?e.filter(e=>c.has(e.name)?!1:s===null?!0:s.has(e.name)):e}function g(e){return e.filter(e=>!c.has(e.name))}function _(e){return o?{...e,profileName:o}:e}function v(e){if(!o)return e;let t=e?.content?.[0]?.text;if(!t)return e;try{let n=JSON.parse(t),r=(Array.isArray(n.profiles)?n.profiles:[]).filter(e=>e?.name===o);return{...e,content:[{...e.content[0],text:JSON.stringify({...n,profileCount:r.length,profiles:r},null,2)},...e.content.slice(1)]}}catch{return e}}function y(e){return{name:e.name,description:e.description,inputSchema:e.inputSchema,annotations:e.capabilities}}function b(e){return c.has(e)?!1:s===null?!0:s.has(e)}return u.setRequestHandler(k,async()=>{try{let e=await dn(t);f=e,m=new Set(e.map(e=>e.name));let r=a?await fn(t,a):[];p=r;let i=[...h(e),...g(r).map(e=>y(e))];return n&&i.push(d),{tools:i}}catch(e){if(f.length>0||p.length>0){console.error(`Failed to refresh tools from HTTP server. Returning cached tools:`,e instanceof Error?e.message:String(e));let t=[...h(f),...g(p).map(e=>y(e))];return n&&t.push(d),{tools:t}}let r=e instanceof Error?e.message:String(e);throw Error(`Failed to list tools from HTTP server at ${t}: ${r}`,{cause:e})}}),u.setRequestHandler(O,async e=>{let{name:i,arguments:o}=e.params,s=new Set(p.map(e=>e.name));if(i!==`browser_list_session`&&!b(i))return{content:[{type:`text`,text:`Tool "${i}" is not available (filtered by --tags or --exclude)`}],isError:!0};if(i===`browser_list_session`&&n){let e=n.getSessionState();return{content:[{type:`text`,text:JSON.stringify(e,null,2)}]}}let c=o||{};i===`browser_launch`&&r&&(c={...c,mode:r}),i===`browser_launch`&&(c=_(c));try{if(a&&!s.has(i)&&!m.has(i))try{p=await fn(t,a),s=new Set(p.map(e=>e.name))}catch(e){console.error(`Failed to refresh custom tools, using cached list: ${e instanceof Error?e.message:String(e)}`)}let e=s.has(i),r=await fetch(e&&a?ln(t,a):`${t}/execute`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({tool:i,arguments:c})});if(!r.ok){let e=await r.text();return{content:[{type:`text`,text:`HTTP error ${r.status}: ${e}`}],isError:!0}}let o=await r.json();if(!o.success)return{content:[{type:`text`,text:o.error||o.result?.content?.[0]?.text||`Unknown error from HTTP server`}],isError:!0};if(n&&o.result){if(rn.includes(i)){let e=on(o.result);e?.browserId&&(n.trackBrowser(e.browserId,e.mode||`playwright`),e.pageId&&n.trackPage(e.pageId,e.browserId,e.url))}else if(an.includes(i)){let e=on(o.result);e?.pageId&&e?.browserId&&n.trackPage(e.pageId,e.browserId,e.url)}}return i===`browser_list_profiles`&&o.result?v(o.result):o.result||{content:[{type:`text`,text:`No result returned`}]}}catch(e){return{content:[{type:`text`,text:`Failed to execute tool via HTTP server: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}}),u}const Q=`stdio`,hn=`http`,$=`streamable-http`,gn=new Set([Q,hn,$]),_n=`chromium`,vn=new Set([_n,`firefox`,`webkit`]),yn=new Set([`playwright`,`extension`,`vm`,`stealth`]),bn=`SIGINT`,xn=`SIGTERM`,Sn=[`pnpm-workspace.yaml`,`nx.json`,`.git`],Cn=`browse-tool-mcp-http`,wn=`tool`,Tn=`service`;var En=class extends Error{code=`INVALID_TRANSPORT`;recovery=`Use --type ${[...gn].join(`, `)}`;transportType;constructor(e,t){super(`Unknown transport type: ${e}`,t),this.name=`InvalidTransportError`,this.transportType=e}},Dn=class extends Error{code=`INVALID_BROWSER_TYPE`;recovery=`Use --browser ${[...vn].join(`, `)}`;browserType;constructor(e,t){super(`Unknown browser type: ${e}`,t),this.name=`InvalidBrowserTypeError`,this.browserType=e}},On=class extends Error{code=`INVALID_LAUNCH_MODE`;recovery=`Use --mode ${[...yn].join(`, `)}`;launchMode;constructor(e,t){super(`Unknown launch mode: ${e}`,t),this.name=`InvalidLaunchModeError`,this.launchMode=e}};function kn(e){let t=e.toLowerCase();if(!vn.has(t))throw new Dn(e);return t}function An(e){let t=e.toLowerCase();if(!yn.has(t))throw new On(e);return t}function jn(e){let t=typeof e==`number`?e:Number.parseInt(e,10);if(!Number.isInteger(t)||t<=0||t>65535)throw Error(`Invalid port: ${e}`);return t}function Mn(e){let t=e.toLowerCase();return t===hn?$:t}function Nn(e,t){let n=e[t];return(Array.isArray(n)?n[0]:n)?.trim()||void 0}function Pn(e=process.cwd()){let t=j.resolve(e);for(;;){for(let e of Sn)if(A(j.join(t,e)))return t;let e=j.dirname(t);if(e===t)return process.cwd();t=e}}function Fn(e,t){let n=j.resolve(e),r=j.extname(n)===`.json`?j.dirname(n):n;return j.join(r,t)}async function In(e,t){let n=await e.registerProcess({...t,force:!0});if(!n.success||!n.record)throw Error(n.error||`Failed to register process ${t.serviceName}`);let r=!1;return{release:async()=>{if(r)return;r=!0;let n=await e.releaseProcess({repositoryPath:t.repositoryPath,serviceName:t.serviceName,serviceType:t.serviceType,environment:t.environment,pid:t.pid,kill:!1,releasePort:!1});!n.success&&!n.error?.includes(`No matching process entry`)&&console.error(`Failed to release process registry entry for ${t.serviceName}: ${n.error}`)}}}function Ln(e){return e.split(`,`).map(e=>e.trim()).filter(e=>e.length>0)}function Rn(e){let t=e.tags?Ln(e.tags):void 0,n=e.exclude?Ln(e.exclude):void 0;if(!(!t?.length&&!n?.length))return{tags:t,exclude:n}}var zn=class extends Error{code=`BROWSER_CLEANUP_FAILED`;recovery=`Browsers may still be running; check the HTTP server or kill processes manually`;failedBrowserIds;httpBaseUrl;constructor(e,t,n){super(`Failed to close ${e.length} browser(s): ${e.join(`, `)}`,n),this.name=`BrowserCleanupError`,this.failedBrowserIds=e,this.httpBaseUrl=t}},Bn=class extends Error{code=`SESSION_SHUTDOWN_FAILED`;recovery=`Check logs for cleanup and transport errors; processes may need manual cleanup`;signal;constructor(e,t){super(`Shutdown failed for signal ${e}`,t),this.name=`SessionShutdownError`,this.signal=e}},Vn=class extends Error{code=`HTTP_SERVER_START_FAILED`;recovery=`Check if the HTTP server binary exists and the port is available`;constructor(e){super(`Failed to start HTTP server`,e),this.name=`HttpServerStartError`}},Hn=class extends Error{code=`MCP_SERVER_BOOTSTRAP_FAILED`;recovery=`Check if all dependencies are installed and try again`;constructor(e){super(`Failed to start MCP server`,e),this.name=`McpServerBootstrapError`}};async function Un(e,t){let n=e.getBrowserIds(),r=[],i;for(let e of n)try{let n=await fetch(`${t}/execute`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({tool:`browser_close`,arguments:{browserId:e}})});if(!n.ok){let e=await n.text().catch(()=>``);throw Error(`HTTP ${n.status} from ${t}/execute: ${e}`)}console.error(` Closed browser: ${e}`)}catch(t){let n=t instanceof Error?t:Error(String(t));console.error(` Failed to close browser: ${e}`,n),r.push(e),i??=n}if(r.length>0)throw new zn(r,t,{cause:i});e.clear()}async function Wn(e,t,n,r){await e.start();let i=!1,a=async a=>{if(i)return;i=!0,console.error(`\nReceived ${a}, shutting down gracefully...`);let o;try{let e=t.getSessionState();e.totalBrowsers>0&&(console.error(` Cleaning up ${e.totalBrowsers} browser(s) from this session...`),await Un(t,n))}catch(e){o=e instanceof Error?e:Error(String(e)),console.error(`Browser cleanup error:`,o)}finally{try{await e.stop()}catch(e){let t=e instanceof Error?e:Error(String(e));console.error(`Transport stop error:`,t),o??=t}try{await r?.()}catch(e){let t=e instanceof Error?e:Error(String(e));console.error(`Process registry cleanup error:`,t),o??=t}if(o){let e=new Bn(a,{cause:o});console.error(`Error during shutdown:`,e),process.exit(1)}process.exit(0)}};process.once(bn,()=>a(bn)),process.once(xn,()=>a(xn))}const Gn=new C(`mcp-serve`).description(`Start Playwright MCP server for browser automation`).option(`-t, --type <type>`,`Transport type: ${[Q,$].join(`, `)}`,Q).option(`-b, --browser <browser>`,`Default browser type: ${[...vn].join(`, `)}`,_n).option(`--headless`,`Run browsers in headless mode by default`,!1).option(`--no-headless`,`Run browsers in headed mode (visible window)`).option(`--host <host>`,`Default host for HTTP services`,o()).option(`--port <port>`,`Port for streamable HTTP transport`,`3201`).option(`-p, --profile <name>`,`Default profile name for browser sessions`).option(`-m, --mode <mode>`,`Default launch mode: ${[...yn].join(`, `)}`).option(`--tags <tags>`,`Comma-separated tags to filter tools (e.g. input,navigation,snapshot)`).option(`--exclude <tools>`,`Comma-separated tool names to exclude (applied after --tags)`).option(`--custom-tools <path>`,`Path to a folder containing tools.yaml and custom tool scripts`).option(`--snippets-dir <path>`,`Path to a folder where browser_run_code snippets are stored`).option(`--idle-timeout <minutes>`,`Idle timeout in minutes before auto-closing browsers`).option(`--registry-path <path>`,`Custom registry path or directory for service discovery`).option(`--registry-dir <path>`,`Custom registry directory for service discovery`).option(`--pids-dir <path>`,`Custom PIDs directory for process tracking`).option(`--profiles-dir <path>`,`Custom profiles directory for browser profiles`).action(async function(t){let n=z(`mcpServe`),r={type:B(this,`type`,t.type,n.type),browser:B(this,`browser`,t.browser,n.browser),headless:B(this,`headless`,t.headless,n.headless),profile:B(this,`profile`,t.profile,n.profile),mode:B(this,`mode`,t.mode,n.mode),host:B(this,`host`,t.host,n.host,process.env.PLAYWRIGHT_HOST),port:B(this,`port`,t.port,n.port,process.env.PLAYWRIGHT_MCP_PORT),tags:B(this,`tags`,t.tags,n.tags),exclude:B(this,`exclude`,t.exclude,n.exclude),customTools:B(this,`customTools`,t.customTools,n.customTools),snippetsDir:B(this,`snippetsDir`,t.snippetsDir,n.snippetsDir),idleTimeout:B(this,`idleTimeout`,t.idleTimeout,n.idleTimeout===void 0?void 0:String(n.idleTimeout),process.env[a]),registryPath:B(this,`registryPath`,t.registryPath,n.registryPath,process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH),registryDir:B(this,`registryDir`,t.registryDir,n.registryDir,process.env.PLAYWRIGHT_REGISTRY_DIR),pidsDir:B(this,`pidsDir`,t.pidsDir,n.pidsDir,process.env.PLAYWRIGHT_PIDS_DIR),profilesDir:B(this,`profilesDir`,t.profilesDir,n.profilesDir,process.env.PLAYWRIGHT_PROFILES_DIR)},i=Mn(r.type),c=Pn(process.cwd()),l=process.env.NODE_ENV||`development`,u;try{if(!gn.has(i))throw new En(i);let t=kn(r.browser),n=r.mode?An(r.mode):void 0,d=jn(r.port??3201),f=Rn(r),h=r.customTools?j.resolve(r.customTools):void 0,y=r.snippetsDir?j.resolve(r.snippetsDir):void 0;console.error(`Playwright MCP Server starting...`),console.error(` Transport: ${i}`),i===$&&console.error(` MCP endpoint: http://${r.host??o()}:${d}/mcp`),console.error(` Default browser: ${t}`),console.error(` Headless: ${r.headless}`),n&&console.error(` Default mode: ${n}`),r.profile&&console.error(` Profile: ${r.profile}`),f?.tags?.length&&console.error(` Tags: ${f.tags.join(`, `)}`),f?.exclude?.length&&console.error(` Exclude: ${f.exclude.join(`, `)}`),h&&console.error(` Custom tools: ${h}`),y&&console.error(` Snippets dir: ${y}`),r.idleTimeout&&console.error(` Idle timeout: ${r.idleTimeout} minutes`);let b=r.registryPath||r.registryDir;b&&(process.env.PLAYWRIGHT_REGISTRY_DIR=b,process.env.PORT_REGISTRY_PATH=b,process.env.PROCESS_REGISTRY_PATH=Fn(b,`processes.json`),console.error(` Registry path: ${b}`)),r.pidsDir&&(process.env.PLAYWRIGHT_PIDS_DIR=r.pidsDir,console.error(` PIDs dir: ${r.pidsDir}`)),r.profilesDir&&(process.env.PLAYWRIGHT_PROFILES_DIR=r.profilesDir,console.error(` Profiles dir: ${r.profilesDir}`)),y&&(process.env.BROWSE_TOOL_SNIPPETS_DIR=y),r.idleTimeout&&(process.env[a]=r.idleTimeout),r.host&&(process.env.PLAYWRIGHT_HOST=r.host),process.env.PLAYWRIGHT_PORT=s().toString();let x=m(),S=x.get(e.ProcessRegistryService),C=await x.get(e.HttpServerManager).ensureRunning();if(!C.running)throw new Vn;let w=v(o(),C.port),ee=C.spawned?`spawned`:`reused`;if(console.error(` HTTP server: ${ee} on port ${C.port}`),i===Q){let e=new g,i=new p(mn({httpBaseUrl:w,sessionTracker:e,defaultMode:n,toolFilter:f,customToolsDir:h,enforcedProfileName:r.profile}));u=await In(S,{repositoryPath:c,serviceName:`browse-tool-mcp`,serviceType:Tn,environment:l,pid:process.pid,metadata:{transport:Q,browser:t,mode:n}}),await Wn(i,e,w,async()=>{await u?.release()});return}let T=new te(process.env.PORT_REGISTRY_PATH),E=await T.reservePort({repositoryPath:c,serviceName:Cn,serviceType:wn,environment:l,preferredPort:d,pid:process.pid,host:r.host??o(),force:!0,portRange:{min:d,max:d},metadata:{healthCheckUrl:`${v(r.host??o(),d)}/health`,transport:$}});if(!E.success||!E.record)throw Error(E.error||`Failed to reserve ${$} port ${d}`);let D=E.record.port;u=await In(S,{repositoryPath:c,serviceName:Cn,serviceType:Tn,environment:l,pid:process.pid,port:D,host:r.host??o(),metadata:{healthCheckUrl:`${v(r.host??o(),D)}/health`,transport:$}});let ne=new _(({headers:e})=>{let t=Nn(e,`x-profile`)??r.profile,i=new g;return{server:mn({httpBaseUrl:w,sessionTracker:i,defaultMode:n,toolFilter:f,customToolsDir:h,enforcedProfileName:t}),onClose:async()=>{i.getSessionState().totalBrowsers>0&&await Un(i,w)}}},{host:r.host??o(),port:D});try{await ne.start()}catch(e){try{await u.release()}catch(e){console.error(`Process registry cleanup error:`,e)}throw await T.releasePort({repositoryPath:c,serviceName:Cn,serviceType:wn,environment:l,pid:process.pid}),e}let O=!1,k=async e=>{if(!O){O=!0,console.error(`\nReceived ${e}, shutting down gracefully...`);try{await ne.stop();try{await u?.release()}catch(e){console.error(`Process registry cleanup error:`,e)}await T.releasePort({repositoryPath:c,serviceName:Cn,serviceType:wn,environment:l,pid:process.pid}),process.exit(0)}catch(e){console.error(`Transport stop error:`,e),process.exit(1)}}};process.once(bn,()=>k(bn)),process.once(xn,()=>k(xn))}catch(e){if(u)try{await u.release()}catch(e){console.error(`Process registry cleanup error:`,e)}(e instanceof En||e instanceof Dn||e instanceof On||e instanceof Vn)&&(console.error(`Error [${e.code}]: ${e.message}`),console.error(`Recovery: ${e.recovery}`),process.exit(1));let t=new Hn({cause:e instanceof Error?e:Error(String(e))});console.error(`Error [${t.code}]: ${t.message}`,t.cause),console.error(`Recovery: ${t.recovery}`),process.exit(1)}}),Kn=new C(`status`).description(`Show status of HTTP server and diagnostics`).action(async()=>{try{let t=z(`httpServe`),n=process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH??t.registryPath??t.registryDir;n&&(process.env.PLAYWRIGHT_REGISTRY_DIR=n,process.env.PLAYWRIGHT_REGISTRY_PATH=n,process.env.PORT_REGISTRY_PATH=n),!process.env.PLAYWRIGHT_PIDS_DIR&&t.pidsDir&&(process.env.PLAYWRIGHT_PIDS_DIR=t.pidsDir),console.log(`browse-tool Status
|
|
433
|
+
`),console.log(`-`.repeat(50));let r=await u().get(e.HttpServerManager).getStatus();if(r.running){let e=process.env.PLAYWRIGHT_HOST??t.host??o();console.log(`HTTP Server: Running`),console.log(` PID: ${r.pid}`),console.log(` Port: ${r.port}`),console.log(` Health: ${v(e,r.port)}/health`),r.browserCount!==void 0&&console.log(` Browsers: ${r.browserCount}`)}else console.log(`HTTP Server: Not Running`),r.error&&console.log(` Error: ${r.error}`);console.log(``),console.log(`-`.repeat(50)),process.exit(0)}catch(e){console.error(`Error getting status:`,e),process.exit(1)}}),qn=new C(`stop`).description(`Stop HTTP server and clean up registry/PID files`).action(async()=>{try{let t=z(`httpServe`),n=process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH??t.registryPath??t.registryDir;n&&(process.env.PLAYWRIGHT_REGISTRY_DIR=n,process.env.PLAYWRIGHT_REGISTRY_PATH=n,process.env.PORT_REGISTRY_PATH=n),!process.env.PLAYWRIGHT_PIDS_DIR&&t.pidsDir&&(process.env.PLAYWRIGHT_PIDS_DIR=t.pidsDir),console.log(`Stopping browse-tool services...`),await u().get(e.HttpServerManager).stop()?(console.log(`HTTP server stopped`),console.log(`Registry and PID files cleaned up`)):console.log(`No HTTP server was running`),console.log(`Done!`),process.exit(0)}catch(e){console.error(`Error stopping services:`,e),process.exit(1)}}),Jn=new Set([`--config`]);function Yn(e){for(let t=0;t<e.length;t+=1){let n=e[t];if(Jn.has(n)){t+=1;continue}if(![...Jn].some(e=>n.startsWith(`${e}=`))&&!n.startsWith(`-`))return n}}function Xn(e,t=!1){if(t)return!1;let n=Yn(e);return n?n===`tools`?!0:n===`help`&&e.includes(`tools`):!1}function Zn(e){return e.replace(/_/g,`-`)}function Qn(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).toLowerCase()}function $n(e){let t=new Set;e.type&&t.add(e.type);for(let n of e.oneOf??[])n.type&&t.add(n.type);return t}function er(e,t){let n=$n(t);if(t.type===`number`||t.type===`integer`){let t=Number(e);if(Number.isNaN(t))throw Error(`Invalid number: ${e}`);return t}if(t.type===`boolean`){if(e===`true`||e===`1`)return!0;if(e===`false`||e===`0`)return!1;throw Error(`Invalid boolean: ${e}`)}if(n.has(`array`)||n.has(`object`))try{return JSON.parse(e)}catch{if(t.type===`array`||t.type===`object`)throw Error(`Invalid JSON: ${e}`)}if(n.has(`number`)||n.has(`integer`)){let t=Number(e);if(!Number.isNaN(t)&&e.trim()!==``)return t}return e}function tr(e,t){let n=Qn(e);return t.type===`boolean`?`--${n}`:`--${n} <value>`}function nr(e){let{definition:t,execute:n}=e,r=new C(Zn(t.name));r.description(t.description);let i=t.inputSchema,a=i.properties||{},o=new Set(i.required||[]);for(let[e,t]of Object.entries(a)){let n=t,i=tr(e,n),a=n.description||``;n.enum&&n.enum.length>0&&(a+=` (choices: ${n.enum.join(`, `)})`),n.default!==void 0&&(a+=` (default: ${JSON.stringify(n.default)})`),o.has(e)&&(a+=` [required]`),n.type===`boolean`?n.default===!0?r.option(`--no-${Qn(e)}`,`Disable ${a}`):r.option(i,a,n.default):n.enum&&n.enum.length>0?r.addOption(new w(i,a).choices(n.enum)):r.option(i,a)}return r.action(async function(){let e=this.optsWithGlobals(),r=z(`tools`),i=B(this,`format`,e.format??`json`,r.format),s=B(this,`color`,e.color??!0,r.color),c=B(this,`port`,String(e.port??d),r.port===void 0?void 0:String(r.port),process.env.PLAYWRIGHT_PORT),l={format:i,color:s},u=Ke(t.name);try{let r={};for(let[t,n]of Object.entries(a)){let i=n,a=Qn(t).replace(/-([a-z])/g,(e,t)=>t.toUpperCase()),o=this.getOptionValueSourceWithGlobals(a),s=e[a];i.type===`boolean`&&i.default===!0&&(s=e[a]),(o===void 0||o===`default`||o===`implied`)&&u[t]!==void 0&&(s=u[t]),s!==void 0&&(typeof s==`string`&&i.type!==`string`?r[t]=er(s,i):r[t]=s)}for(let e of o)if(r[e]===void 0){let t=Qn(e);console.error(U(`Missing required option: --${t}`,l.color)),process.exit(1)}let i=Number.parseInt(c,10),s=V({port:i}),d=n?await n(r,{command:this,formatterOptions:l,port:i}):await s.execute(t.name,r),f=Ye(d,l);f&&console.log(f),d.isError&&process.exit(1)}catch(e){console.error(U(e instanceof Error?e:String(e),l.color)),process.exit(1)}}),r}function rr(e){return e.map(nr)}const ir={name:`browser_list_session`,description:`List browsers and pages currently tracked by the browse-tool HTTP server.`,inputSchema:{type:`object`,properties:{},required:[],additionalProperties:!1}};function ar(){return new C(`tools`).description(`Execute browser automation tools`).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))}function or(e){return{browserCount:e.length,browsers:e.map(e=>({browserId:e.id,profileName:e.profileName,currentPageId:e.currentPageId,pageIds:e.pageIds,createdAt:e.createdAt}))}}function sr(){return{definition:ir,execute:async(e,t)=>{let n=await V({port:t.port}).listBrowsers();return{content:[{type:`text`,text:JSON.stringify(or(n),null,2)}]}}}}function cr(e){return[...e.map(e=>({definition:e})),sr()]}async function lr(e,t){let n=z(`tools`),r=Number(t?.port??process.env.PLAYWRIGHT_PORT??n.port??d);try{let t=rr(cr(await V({port:r}).listTools()));for(let n of t)e.addCommand(n)}catch(e){let t=e instanceof Error?e.message:String(e);process.stderr.write(`${U(`Failed to load tool commands: ${t}`,!0)}\n`),process.stderr.write(`Make sure the HTTP server is running: browse-tool http-serve
|
|
434
|
+
`)}}function ur(e,t){let n=[...e];for(let e=0;e<n.length;e+=1){let t=n[e];if(t===`--port`||t===`-p`){let t=n[e+1],r=Number(t);if(!Number.isNaN(r)&&t)return r;continue}if(t.startsWith(`--port=`)){let e=Number(t.slice(7));if(!Number.isNaN(e))return e;continue}if(t.startsWith(`-p=`)){let e=Number(t.slice(3));if(!Number.isNaN(e))return e}}return Number(t)}async function dr(){let e=Ge(process.argv.slice(2)),t=process.env.PLAYWRIGHT_PORT??e.config.commands.tools?.port??e.config.commands.exec?.port??d,n=new C;n.name(`browse-tool`).description(`MCP server for browser automation using Playwright with profile management, page registry, and multi-browser support`).option(`--config <path>`,`Path to browse-tool config file or config directory`).version(me),n.addCommand(Gn),n.addCommand($t),n.addCommand(je),n.addCommand(ot),n.addCommand(qn),n.addCommand(Kn),n.addCommand(st),n.addCommand(it),n.addCommand(at);let r=ar();Xn(process.argv.slice(2),process.env.PLAYWRIGHT_SKIP_DYNAMIC_TOOL_COMMANDS===`1`)&&await lr(r,{port:ur(process.argv.slice(2),t)}),n.addCommand(r),await n.parseAsync(process.argv)}dr().catch(e=>{console.error(e instanceof Error?e.message:String(e)),process.exit(1)});export{};
|
|
435
435
|
//# sourceMappingURL=cli.mjs.map
|