@agimon-ai/browse-tool 0.20.0 → 0.20.2
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 +5 -5
- package/dist/cli.mjs +23 -23
- package/dist/extension/background.js +16 -0
- package/dist/extension/background.js.map +1 -1
- package/dist/extension/content.js +1 -0
- package/dist/extension/content.js.map +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.mjs +1 -1
- package/dist/{playwright-test-DuyeBPh3.cjs → playwright-test-Cv_VY8VH.cjs} +1 -1
- package/dist/streamable-http-AtkbCdt-.mjs +53 -0
- package/dist/streamable-http-BLUtoU2x.cjs +53 -0
- package/dist/stubs/playwright-test.cjs +1 -1
- package/package.json +5 -5
- package/dist/streamable-http-BPEGdTS4.mjs +0 -53
- package/dist/streamable-http-u32a2By0.cjs +0 -53
package/dist/cli.mjs
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{A as e,C as t,D as n,E as r,M as i,O as a,S as o,T as s,_ as c,a as l,b as u,c as d,d as f,f as p,g as m,h,i as g,j as _,k as v,l as y,m as b,n as x,o as S,p as C,s as w,t as T,u as E,v as ee,w as D,x as O,y as k}from"./streamable-http-BPEGdTS4.mjs";import{stripTypeScriptTypes as A}from"node:module";import"reflect-metadata/lite";import{DEFAULT_PORT_RANGE as j,PortRegistryService as te}from"@agimon-ai/foundation-port-registry";import{createProcessLease as M,resolveSiblingRegistryPath as ne}from"@agimon-ai/foundation-process-registry";import{Container as N,ContainerModule as re}from"inversify";import P from"node:path";import{existsSync as ie,readFileSync as ae,statSync as oe}from"node:fs";import{readFile as se,stat as ce}from"node:fs/promises";import{homedir as le}from"node:os";import{randomUUID as ue}from"node:crypto";import{z as F}from"zod";import{SpanStatusCode as I}from"@opentelemetry/api";import{coerceArgs as de,formatZodError as fe}from"@agimon-ai/foundation-validator";import{Server as pe}from"@modelcontextprotocol/sdk/server/index.js";import{CallToolRequestSchema as me,ListToolsRequestSchema as he}from"@modelcontextprotocol/sdk/types.js";import{StdioServerTransport as ge}from"@modelcontextprotocol/sdk/server/stdio.js";import{Command as L,Option as _e}from"commander";import{serve as ve}from"@hono/node-server";import{Hono as R}from"hono";import{cors as ye}from"hono/cors";import{createNodeWebSocket as be}from"@hono/node-ws";import{raw as xe}from"hono/html";import{Fragment as Se}from"hono/jsx";import{jsx as z,jsxs as B}from"hono/jsx/jsx-runtime";var Ce=`0.19.1`;const we=process.env.BROWSE_TOOL_DEBUG_EXTENSION_RECORDING===`1`;function Te(e,t){if(!we)return;let n=t?` ${JSON.stringify(t)}`:``;console.log(`[ExtensionRecordingDebug] ${e}${n}`)}function Ee(e){let t=new R,n;try{n=e.get(i.TelemetryService)}catch{n=new m}return t.get(`/telemetry-config`,async e=>{try{let t=new URL(e.req.url).origin;return e.json(await c(process.env,t))}catch(t){return e.json({enabled:!1,error:t instanceof Error?t.message:String(t)},500)}}),t.get(`/tasks`,t=>{try{let n=e.get(i.ExtensionTaskQueue).getNextTask();return n?t.json({task:{id:n.id,tool:n.tool,arguments:n.arguments,telemetry:n.telemetry}}):t.json({})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/result`,async t=>{try{let n=await t.req.json();if(!n.taskId)return t.json({success:!1,error:`Missing taskId in request body`},400);let r=e.get(i.ExtensionTaskQueue),a=e.get(i.BrowserService),o={taskId:n.taskId,success:n.success,result:n.result,error:n.error},s=r.submitResult(o);return s?(s.browserId&&a.recordBrowserActivity(s.browserId,s.pageId),t.json({success:!0})):t.json({success:!1,error:`Task ${n.taskId} not found or already completed`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.get(`/status`,t=>{try{let n=e.get(i.ExtensionTaskQueue),r=n.getConnectionStatus(),a={connected:r.connected,lastPollAt:r.lastPollAt?.toISOString(),lastResultAt:r.lastResultAt?.toISOString(),pendingTasks:r.pendingTasks,queueSize:n.queueSize};return t.json(a)}catch(e){return t.json({connected:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/register`,async t=>{try{let n=await t.req.json();if(!n.browserId)return t.json({success:!1,error:`Missing browserId in request body`},400);let r=e.get(i.ExtensionSessionRegistry).register(n);return t.json({success:!0,session:{id:r.id,browserId:r.browserId,controlMode:r.controlMode,createdAt:r.createdAt.toISOString()}})}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/heartbeat`,async t=>{try{let n=await t.req.json();if(!n.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let r=e.get(i.ExtensionSessionRegistry).heartbeat(n);return r?t.json({success:!0,session:{id:r.id,controlMode:r.controlMode,handoffRequested:r.handoffRequested,lastHeartbeatAt:r.lastHeartbeatAt.toISOString()}}):t.json({success:!1,error:`Session ${n.sessionId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/tab-mapped`,async t=>{try{let n=await t.req.json();if(!n.pageId||typeof n.tabId!=`number`)return t.json({success:!1,error:`Missing pageId or tabId in request body`},400);let r=e.get(i.PageRegistry),a=e.get(i.BrowserService),o=r.get(n.pageId);return o?(o.extensionTabId=n.tabId,a.recordBrowserActivity(o.browserId,n.pageId),t.json({success:!0})):t.json({success:!1,error:`Page ${n.pageId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/recording`,async t=>{try{let n=await t.req.json();if(!n.browserId)return t.json({success:!1,error:`Missing browserId in request body`},400);let r=e.get(i.BrowserService),a=await r.persistExtensionRecordingArtifact(n.browserId,n.videoBase64);return Te(`artifact received`,{browserId:n.browserId,videoBase64Size:n.videoBase64?.length??0,persisted:a}),a?(r.recordBrowserActivity(n.browserId),t.json({success:!0})):t.json({success:!1,error:`Browser "${n.browserId}" has no active recording target`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.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=e.get(i.BrowserService),o=await a.persistExtensionRecordingChunk(r.browserId,r.chunkBase64);return Te(`chunk received`,{browserId:r.browserId,chunkIndex:r.chunkIndex,mimeType:r.mimeType,persisted:!!o,chunkBase64Size:r.chunkBase64.length}),o?(n.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)}}),t.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):(n.log(t.level??`info`,t.message,{attributes:{"browse_tool.extension.log_relay":!0,...typeof t.attributes==`object`&&t.attributes!==null?t.attributes:{}}}),Te(`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)}}),t.post(`/handoff`,async t=>{try{let n=await t.req.json();if(!n.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let r=e.get(i.ExtensionSessionRegistry).requestHandoff(n);return r?t.json({success:!0,message:`Handoff requested. AI will take control when ready.`,session:{id:r.id,controlMode:r.controlMode,handoffRequested:r.handoffRequested}}):t.json({success:!1,error:`Session ${n.sessionId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/handoff/acknowledge`,async t=>{try{let n=await t.req.json();if(!n.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let r=e.get(i.ExtensionSessionRegistry).acknowledgeHandoff(n.sessionId);return r?t.json({success:!0,message:`Handoff acknowledged. AI now has control.`,session:{id:r.id,controlMode:r.controlMode,handoffRequested:r.handoffRequested}}):t.json({success:!1,error:`Session ${n.sessionId} not found or no handoff pending`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.get(`/sessions`,t=>{try{let n=e.get(i.ExtensionSessionRegistry).listSessions();return t.json({sessions:n.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)}}),t}function De(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 Oe=`browse-tool-chrome`,ke=`tool`,Ae=process.env.NODE_ENV||`development`,je=`127.0.0.1`;function Me(){return new te(process.env.PORT_REGISTRY_PATH)}async function Ne(e,t,n){let r=Me(),i=await r.reservePort({repositoryPath:e,serviceName:Oe,serviceType:ke,environment:Ae,preferredPort:t,portRange:n,pid:process.pid,host:je,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:Oe,serviceType:ke,environment:Ae,pid:process.pid});if(!n.success&&!n.error?.includes(`No matching registry entry`))throw Error(n.error||`Failed to release port ${t}`)}}}function Pe(){return new re(e=>{e.bind(i.ExtensionTaskQueue).to(h).inSingletonScope(),e.bind(i.ExtensionToolDelegator).to(b).inSingletonScope()})}function Fe(e){let t=new pe({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(he,async()=>({tools:n})),t.setRequestHandler(me,async t=>{let{name:n,arguments:r}=t.params;return await e.executeTool(n,r||{})}),t}const Ie=new L(`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 a=De(t.port),o=e(),s=process.env.PORT_REGISTRY_PATH;s&&(process.env.PROCESS_REGISTRY_PATH=ne(s,`processes.json`)),n=await Ne(o,a??j.min,a?{min:a,max:a}:j);let c=n.port;r=await M({repositoryPath:o,serviceName:Oe,serviceType:ke,environment:Ae,pid:process.pid,port:c,host:je,command:process.argv[1],args:process.argv.slice(2),metadata:{transport:`stdio`,command:`chrome-serve`,waitForExtension:t.waitForExtension}}),t.verbose&&(console.error(`Chrome Extension MCP Server starting...`),console.error(` HTTP Port: ${c}`),console.error(` Wait for extension: ${t.waitForExtension}`));let l=new N({defaultScope:`Singleton`});l.load(Pe());let u=l.get(i.ExtensionTaskQueue),d=l.get(i.ExtensionToolDelegator),f=new R;f.use(`*`,ye({origin:e=>e??null,credentials:!0,allowMethods:[`GET`,`POST`,`OPTIONS`],allowHeaders:[`Content-Type`,`Accept`]}));let p=Ee(l);f.route(`/extension`,p),f.get(`/health`,e=>{let t=u.getConnectionStatus();return e.json({status:`healthy`,service:`browse-tool-chrome`,extension:t})});let m=ve({fetch:f.fetch,port:c});m.on(`error`,e=>{e.code===`EADDRINUSE`?(console.error(`Error [PORT_IN_USE]: Port ${c} 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 ${c}`),console.error(`Waiting for Chrome extension to connect...`),console.error(`Extension should poll: http://localhost:${c}/extension/tasks`),t.waitForExtension&&(console.error(`Waiting for extension connection before starting MCP...`),await new Promise(e=>{let t=setInterval(()=>{u.getConnectionStatus().connected&&(clearInterval(t),console.error(`Extension connected!`),e())},500)}));let h=Fe(d),g=new ge;await h.connect(g),console.error(`Chrome extension MCP server started on stdio`);let _=async e=>{console.error(`\nReceived ${e}, shutting down gracefully...`);try{u.clearAllTasks(`Server shutting down`),await g.close(),m.close(),await r.release({kill:!1}),await n.release(),process.exit(0)}catch(e){console.error(`Error during shutdown:`,e),process.exit(1)}};process.on(`SIGINT`,()=>_(`SIGINT`)),process.on(`SIGTERM`,()=>_(`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)}}),Le=`BROWSE_TOOL_CONFIG`,Re=`.browse-tool`,ze=`config.json`,Be=[`json`,`text`,`quiet`],Ve={commands:{},tools:{}},He=F.record(F.string(),F.unknown()),Ue=F.object({mcpServe:F.object({type:F.string().optional(),browser:F.string().optional(),headless:F.boolean().optional(),profile:F.string().optional(),mode:F.string().optional(),host:F.string().optional(),port:F.coerce.number().int().positive().optional(),httpPort:F.coerce.number().int().positive().optional(),tags:F.string().optional(),exclude:F.string().optional(),customTools:F.string().optional(),chromeForTestingPath:F.string().optional(),snippetsDir:F.string().optional(),registryPath:F.string().optional(),registryDir:F.string().optional(),pidsDir:F.string().optional(),profilesDir:F.string().optional(),proxyConfigDir:F.string().optional()}).partial().optional(),httpServe:F.object({port:F.coerce.number().int().positive().optional(),headless:F.boolean().optional(),idleTimeout:F.coerce.number().positive().optional(),host:F.string().optional(),registryDir:F.string().optional(),registryPath:F.string().optional(),pidsDir:F.string().optional(),profilesDir:F.string().optional(),snippetsDir:F.string().optional(),proxyConfigDir:F.string().optional()}).partial().optional(),exec:F.object({format:F.enum(Be).optional(),color:F.boolean().optional(),port:F.coerce.number().int().positive().optional()}).partial().optional(),tools:F.object({format:F.enum(Be).optional(),color:F.boolean().optional(),port:F.coerce.number().int().positive().optional()}).partial().optional(),status:F.record(F.string(),F.unknown()).optional(),stop:F.record(F.string(),F.unknown()).optional()}),We=F.object({commands:Ue.default({}),tools:F.record(F.string(),He).default({})});let V={config:Ve};function Ge(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=P.resolve(e);if(!ie(t))throw Error(`Config path not found: ${t}`);return oe(t).isDirectory()?P.join(t,ze):t}function qe(t,n){let r=n.env??process.env,i=n.cwd??e({argv:t,env:r,startPath:process.cwd()}),a=n.homeDir??le(),o=Ge(t);if(o)return Ke(o);if(r[Le])return Ke(r[Le]);let s=P.join(i,Re,ze);if(ie(s))return s;let c=P.join(a,Re,ze);if(ie(c))return c}function Je(e){let t=ae(e,`utf8`),n=JSON.parse(t);return We.parse(n)}function Ye(e,t={}){let n=qe(e,t);return n?{configPath:n,config:Je(n)}:{config:Ve}}function Xe(e,t={}){return V=Ye(e,t),V}function H(e){return(V.config.commands??{})[e]??{}}function Ze(e){return V.config.tools?.[e]??{}}function U(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;ownerId;timeout;serverPort=null;constructor(e={}){this.port=e.port??f,this.exactPort=e.exactPort??!1,this.ownerId=n({ownerId:e.ownerId}),this.timeout=e.timeout??6e4}async ensureServer(){if(this.serverPort!==null)return this.serverPort;let e=await S().get(i.HttpServerManager).ensureRunning(this.port,{exactPort:this.exactPort});if(!e.running||!e.port)throw Error(e.error??`Failed to start HTTP server. Try running "browse-tool http-serve" manually.`);return this.serverPort=e.port,e.port}async getBaseUrl(){return`http://localhost:${await this.ensureServer()}`}jsonHeaders(){return{"Content-Type":`application/json`,Accept:`application/json`,[s]:this.ownerId}}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:this.jsonHeaders(),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:this.jsonHeaders(),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 W(e){return new Qe(e)}const $e={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 G(e,t,n){return n?`${$e[t]}${e}${$e.reset}`:e}function et(e,t){let{format:n,color:r}=t;return n===`quiet`?``:n===`json`?tt(e):nt(e,r)}function tt(e){return JSON.stringify(e,null,2)}function nt(e,t){let n=[];e.isError&&n.push(G(`Error:`,`red`,t));for(let r of e.content)r.type===`text`?n.push(rt(r,t)):r.type===`image`?n.push(ot(r,t)):n.push(G(`[Unknown content type: ${r.type}]`,`yellow`,t));return n.join(`
|
|
3
|
-
`)}function
|
|
4
|
-
`)}function
|
|
5
|
-
`)}function ct(e,t){let n=H(`tools`),r=U(e,`format`,t.format,n.format),i=U(e,`color`,t.color,n.color);return{port:U(e,`port`,t.port,n.port===void 0?void 0:String(n.port),process.env.PLAYWRIGHT_PORT),formatterOptions:{format:r,color:i}}}const lt=new L(`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(f)).action(async function(e,t){let{port:n,formatterOptions:r}=ct(this,t);try{let t=await W({port:Number.parseInt(n,10)}).listCustomTools(e),i=r.format===`text`?st(t,r.color):r.format===`quiet`?``:JSON.stringify(t,null,2);i&&console.log(i)}catch(e){console.error(K(e instanceof Error?e:String(e),r.color)),process.exit(1)}}),ut=new L(`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(f)).option(`--owner <owner>`,`Owner id used to scope browser resources for direct CLI calls`).action(async function(e,t,n,r){let{port:i,formatterOptions:a}=ct(this,r);try{let o;try{o=JSON.parse(n)}catch{console.error(K(`Invalid JSON arguments: ${n}`,a.color)),process.exit(1);return}let s=await W({port:Number.parseInt(i,10),ownerId:r.owner}).executeCustomTool(e,t,o),c=et(s,a);c&&console.log(c),s.isError&&process.exit(1)}catch(e){console.error(K(e instanceof Error?e:String(e),a.color)),process.exit(1)}});new L(`custom-tools`).description(`List and execute custom tools through the HTTP server`).addCommand(lt).addCommand(ut);const dt=new L(`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`,D).option(`--image <image>`,`Docker image tag to produce`,o).option(`--platform <platform>`,`Docker target platform`,t).action(async e=>{try{let t=await k({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: ${u(t.platform)}`)}catch(e){console.error(e instanceof Error?e.message:String(e)),process.exit(1)}}),ft=new L(`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(f)).option(`--owner <owner>`,`Owner id used to scope browser resources for direct CLI calls`).action(async function(e,t,n){let r=H(`exec`),i=U(this,`format`,n.format,r.format),a=U(this,`color`,n.color,r.color),o=U(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 r;try{r=JSON.parse(t)}catch{console.error(K(`Invalid JSON arguments: ${t}`,l.color)),process.exit(1)}let i=await W({port:Number.parseInt(o,10),exactPort:c,ownerId:n.owner}).execute(e,r),a=et(i,l);a&&console.log(a),i.isError&&process.exit(1)}catch(e){console.error(K(e instanceof Error?e:String(e),l.color)),process.exit(1)}}),q=`pageId`,J=`browserId`,pt=F.record(F.string(),F.unknown()),mt=F.object({type:F.literal(`object`),properties:F.record(F.string(),F.unknown()).optional(),required:F.array(F.string()).optional(),additionalProperties:F.boolean().optional()}).passthrough(),ht=F.object({name:F.string().min(1),description:F.string().min(1),script:F.string().min(1),suggestionActions:F.string().min(1).optional(),capabilities:pt,inputSchema:mt}),gt=F.object({tools:F.array(ht)}),_t=process.env.BROWSE_TOOL_DEBUG_CUSTOM_TOOLS===`1`;function vt(e){return JSON.stringify(e,(e,t)=>typeof t==`string`&&t.length>240?`${t.slice(0,240)}...<trimmed>`:t)}function yt(e,t){if(_t){if(t){console.error(`[CustomToolService] ${e}`,t);return}console.error(`[CustomToolService] ${e}`)}}function Y(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function bt(e){return Y(e)&&Array.isArray(e.content)}function xt(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 St(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 Ct(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 X(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(`-`)?wt(e,t,n):Tt(e,t,n)}function wt(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]=X(e,i+1,t.indent);r.push(a),i=o;continue}if(a.includes(`:`)){let[t,o]=Et(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]=X(e,i+1,r.indent);s[t]=a,i=o}else s[t]=xt(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]=X(e,i,t.indent);if(!Y(n))throw Error(`Expected object entry in tools.yaml at line ${i+1}`);Object.assign(s,n),i=r;continue}let[r,a]=Et(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]=X(e,i+1,n.indent);s[r]=a,i=o;continue}s[r]=xt(a),i+=1}r.push(s);continue}r.push(xt(a)),i+=1}return[r,i]}function Tt(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]=Et(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]=X(e,i+1,t.indent);r[a]=o,i=s;continue}r[a]=xt(o),i+=1}return[r,i]}function Et(e){let t=e.indexOf(`:`);if(t===-1)throw Error(`Invalid tools.yaml entry: "${e}"`);let n=e.slice(0,t).trim(),r=e.slice(t+1).trim();return[n,r===``?void 0:r]}function Dt(e){let t=Ct(e);if(t.length===0)return{};let[n]=X(t,0,t[0].indent);return n}function Ot(e){e.inputSchema.properties===void 0&&(e.inputSchema.properties={});let t=e.inputSchema.properties;if(!Y(t))throw Error(`Custom tool "${e.name}" inputSchema.properties must be an object`);let n=t[q],r=t[J];if(n!==void 0&&!(Y(n)&&n.type===`string`))throw Error(`Custom tool "${e.name}" must define inputSchema.properties.pageId as type "string"`);if(r!==void 0&&!(Y(r)&&r.type===`string`))throw Error(`Custom tool "${e.name}" must define inputSchema.properties.browserId as type "string"`);n===void 0&&(t[q]={type:`string`,description:`Browse-tool page ID to run this custom tool against. Either pageId or browserId is required at call time.`}),r===void 0&&(t[J]={type:`string`,description:`Browse-tool browser ID to run this custom tool against when no pageId is supplied. The tool will use the browser's current page or open a new one.`})}async function kt(e){let t=A(await se(e,`utf8`),{mode:`strip`});return await import(`data:text/javascript;base64,${Buffer.from(t,`utf8`).toString(`base64`)}`)}function At(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 jt(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(Y(r)){let i=jt(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 Nt(e,t,n){if(bt(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=Y(t)&&n?jt(t,n):t;return{content:[{type:`text`,text:JSON.stringify(r,null,2)}]}}var Pt=class{constructor(e,t,n=new m,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 ee(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[q]==`string`&&t[q].length>0?t[q]:void 0,i=typeof t[J]==`string`&&t[J].length>0?t[J]:void 0;if(!n&&!i)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`);let a=r();if(a&&t.ownerId&&t.ownerId!==a)throw Error(`Custom tool "${e}" cannot use page "${n}" owned by another session`);if(i&&t.browserId!==i)throw Error(`Custom tool "${e}" received pageId "${n}" for browser "${t.browserId}", not "${i}"`);let o=this.createBrowserHelper(e,t.browserId);return{pageId:n,pageEntry:t,page:this.resolveToolPage(e,n,t),browser:o}}let a=this.createBrowserHelper(e,i);try{let e=await a.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:a}}catch(e){if(!(e instanceof Error?e.message:String(e)).includes(`has no pages`))throw e;let t=await a.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:a}}}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 i=r(),a;if(i){let e=this.pageRegistry.findByOwner(i).filter(e=>e.browserId===t);if(a=e[e.length-1]?.id,!a)throw Error(`Browser "${t}" has no pages owned by this session`)}else a=n.currentPageId??this.pageRegistry.findByBrowser(t)[0]?.id??void 0;if(!a)throw Error(`Browser "${t}" has no pages`);let o=this.pageRegistry.get(a);if(!o)throw Error(`Page "${a}" not found`);return{...this.toPageSummary(n.currentPageId,o),page:this.resolveToolPage(e,a,o)}},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:St({...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[q]==`string`?n[q]:void 0,i=typeof n[J]==`string`?n[J]:void 0;return this.telemetry.runInSpan(`browse_tool.custom_tool.execute`,{attributes:{"browse_tool.tool.name":t,"browse_tool.custom_tools.directory":P.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:I.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}),yt(`Executing custom tool`,{toolName:t,directory:P.resolve(e),pageId:a,browserId:o.browserId,mode:o.mode,input:vt(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 yt(`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})}yt(`Custom tool execution completed`,{toolName:t,pageId:a,browserId:o.browserId,mode:o.mode,result:vt(u)});let d=Nt(t,u,i.suggestionActions),f=d.isError?d.content[0]?.text:void 0;return f&&r?.setStatus({code:I.ERROR,message:f}),d})}async loadTools(e){let t=P.resolve(e),n=P.join(t,`tools.yaml`),r=Dt(await se(n,`utf8`).catch(e=>{throw Error(`Failed to read custom tool manifest at "${n}": ${e instanceof Error?e.message:String(e)}`)})),i=gt.parse(r);return Promise.all(i.tools.map(async e=>{Ot(e);let n=P.resolve(t,e.script);await ce(n).catch(t=>{throw Error(`Custom tool "${e.name}" script not found at "${n}": ${t instanceof Error?t.message:String(t)}`)});let r=At(n,await kt(n));return{name:e.name,description:e.description,suggestionActions:e.suggestionActions,inputSchema:e.inputSchema,capabilities:e.capabilities,scriptPath:n,...r}}))}};function Ft(e){let t=new R;return t.get(`/browsers`,async t=>{try{let n=e.get(i.BrowserService),r=e.get(i.PageRegistry),a=n.listBrowsers(),o=r.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 t.json({browsers:s,stats:c})}catch(e){return console.error(`Failed to list browsers:`,e),t.json({error:`Failed to list browsers`,message:e instanceof Error?e.message:String(e)},500)}}),t.delete(`/browsers`,async t=>{try{return await e.get(i.BrowserService).closeAll(),t.json({success:!0,message:`All browsers closed`})}catch(e){return console.error(`Failed to close all browsers:`,e),t.json({error:`Failed to close all browsers`,message:e instanceof Error?e.message:String(e)},500)}}),t.delete(`/browsers/:id`,async t=>{try{let n=t.req.param(`id`),r=e.get(i.BrowserService);return r.getBrowser(n)?(await r.closeBrowser(n),t.json({success:!0,message:`Browser "${n}" closed`})):t.json({error:`Browser "${n}" not found`},404)}catch(e){return console.error(`Failed to close browser:`,e),t.json({error:`Failed to close browser`,message:e instanceof Error?e.message:String(e)},500)}}),t.delete(`/pages/:id`,async t=>{try{let n=t.req.param(`id`),r=e.get(i.PageRegistry).get(n);return r?r.page?(await r.page.close(),t.json({success:!0,message:`Page "${n}" closed`})):t.json({error:`Page "${n}" is in extension mode and cannot be closed via API`},400):t.json({error:`Page "${n}" not found`},404)}catch(e){return console.error(`Failed to close page:`,e),t.json({error:`Failed to close page`,message:e instanceof Error?e.message:String(e)},500)}}),t}function It(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 Lt(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 Rt(e){return Lt(new Date().getTime()-e.getTime())}const zt=`table-container`,Bt=`stat-card`,Vt=`browser-row`,Ht=`page-row`,Ut=`status-active`,Wt=`url-cell`,Z=`timestamp-cell`,Gt=`actions-cell`,Kt=`kill-btn`,qt=`empty-state`;function Jt({browsers:e}){return e.length===0?z(`div`,{class:zt,children:B(`div`,{class:qt,children:[z(`h3`,{children:`No Active Browsers`}),z(`p`,{children:`Launch a browser using MCP tools to see it here.`})]})}):z(`div`,{class:zt,children:B(`table`,{class:`browser-table`,children:[z(`thead`,{children:B(`tr`,{children:[z(`th`,{children:`ID`}),z(`th`,{children:`Status`}),z(`th`,{children:`URL / Title`}),z(`th`,{children:`Created`}),z(`th`,{children:`Age`}),z(`th`,{children:`Actions`})]})}),z(`tbody`,{id:`browser-table-body`,children:e.map(e=>B(Se,{children:[B(`tr`,{class:Vt,children:[z(`td`,{children:e.id}),z(`td`,{children:B(`span`,{class:Ut,children:[e.pages.length,` page`,e.pages.length===1?``:`s`]})}),z(`td`,{children:e.profileName||`Default Profile`}),z(`td`,{class:Z,children:It(e.createdAt)}),z(`td`,{class:Z,children:Rt(e.createdAt)}),z(`td`,{class:Gt,children:z(`button`,{type:`button`,class:Kt,onclick:`dashboard.killBrowser('${e.id}')`,children:`Kill`})})]}),e.pages.map(t=>B(`tr`,{class:Ht,children:[B(`td`,{children:[t.id,e.currentPageId===t.id&&` (active)`]}),z(`td`,{children:z(`span`,{class:Ut,children:`Open`})}),z(`td`,{class:Wt,title:t.url,children:t.title||t.url||`about:blank`}),z(`td`,{class:Z,children:It(t.createdAt)}),z(`td`,{class:Z,children:Rt(t.createdAt)}),z(`td`,{class:Gt,children:z(`button`,{type:`button`,class:Kt,onclick:`dashboard.killPage('${t.id}')`,children:`Close`})})]},t.id))]},e.id))})]})})}function Yt({stats:e}){return B(`div`,{class:`stats-container`,children:[B(`div`,{class:Bt,children:[z(`h3`,{children:`Active Browsers`}),z(`div`,{class:`value`,children:e.totalBrowsers})]}),B(`div`,{class:Bt,children:[z(`h3`,{children:`Active Pages`}),z(`div`,{class:`value`,children:e.totalPages})]})]})}function Xt({browsers:e,stats:t}){return B(`div`,{class:`dashboard-container`,children:[B(`div`,{class:`dashboard-header`,children:[B(`div`,{children:[z(`h1`,{children:`Playwright MCP Dashboard`}),z(`p`,{children:`Browser automation management (auto-refresh every 3 seconds)`})]}),B(`div`,{children:[z(`button`,{type:`button`,id:`refresh-btn`,class:`btn refresh-btn`,onclick:`dashboard.manualRefresh()`,children:`Refresh Now`}),z(`button`,{type:`button`,id:`kill-all-btn`,class:`btn btn-danger`,onclick:`dashboard.killAllBrowsers()`,children:`Kill All Browsers`})]})]}),z(Yt,{stats:t}),z(Jt,{browsers:e}),z(`script`,{children:xe(`
|
|
2
|
+
import{A as e,C as t,D as n,E as r,M as i,O as a,S as o,T as s,_ as c,a as l,b as u,c as d,d as f,f as p,g as m,h,i as g,j as _,k as v,l as y,m as b,n as x,o as S,p as C,s as w,t as T,u as E,v as ee,w as D,x as O,y as k}from"./streamable-http-AtkbCdt-.mjs";import{stripTypeScriptTypes as A}from"node:module";import"reflect-metadata/lite";import{DEFAULT_PORT_RANGE as j,PortRegistryService as te}from"@agimon-ai/foundation-port-registry";import{createProcessLease as ne,resolveSiblingRegistryPath as re}from"@agimon-ai/foundation-process-registry";import{Container as M,ContainerModule as ie}from"inversify";import N from"node:path";import{existsSync as ae,readFileSync as oe,statSync as se}from"node:fs";import{readFile as ce,stat as le}from"node:fs/promises";import{homedir as ue}from"node:os";import{randomUUID as de}from"node:crypto";import{z as P}from"zod";import{SpanStatusCode as F}from"@opentelemetry/api";import{coerceArgs as fe,formatZodError as pe}from"@agimon-ai/foundation-validator";import{Server as me}from"@modelcontextprotocol/sdk/server/index.js";import{CallToolRequestSchema as he,ListToolsRequestSchema as ge}from"@modelcontextprotocol/sdk/types.js";import{StdioServerTransport as _e}from"@modelcontextprotocol/sdk/server/stdio.js";import{Command as I,Option as ve}from"commander";import{serve as ye}from"@hono/node-server";import{Hono as L}from"hono";import{cors as be}from"hono/cors";import{createNodeWebSocket as xe}from"@hono/node-ws";import{raw as Se}from"hono/html";import{Fragment as Ce}from"hono/jsx";import{jsx as R,jsxs as z}from"hono/jsx/jsx-runtime";var we=`0.20.1`;const Te=process.env.BROWSE_TOOL_DEBUG_EXTENSION_RECORDING===`1`;function Ee(e,t){if(!Te)return;let n=t?` ${JSON.stringify(t)}`:``;console.log(`[ExtensionRecordingDebug] ${e}${n}`)}function De(e){let t=new L,n;try{n=e.get(i.TelemetryService)}catch{n=new m}return t.get(`/telemetry-config`,async e=>{try{let t=new URL(e.req.url).origin;return e.json(await c(process.env,t))}catch(t){return e.json({enabled:!1,error:t instanceof Error?t.message:String(t)},500)}}),t.get(`/tasks`,t=>{try{let n=e.get(i.ExtensionTaskQueue).getNextTask();return n?t.json({task:{id:n.id,tool:n.tool,arguments:n.arguments,telemetry:n.telemetry}}):t.json({})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/result`,async t=>{try{let n=await t.req.json();if(!n.taskId)return t.json({success:!1,error:`Missing taskId in request body`},400);let r=e.get(i.ExtensionTaskQueue),a=e.get(i.BrowserService),o={taskId:n.taskId,success:n.success,result:n.result,error:n.error},s=r.submitResult(o);return s?(s.browserId&&a.recordBrowserActivity(s.browserId,s.pageId),t.json({success:!0})):t.json({success:!1,error:`Task ${n.taskId} not found or already completed`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.get(`/status`,t=>{try{let n=e.get(i.ExtensionTaskQueue),r=n.getConnectionStatus(),a={connected:r.connected,lastPollAt:r.lastPollAt?.toISOString(),lastResultAt:r.lastResultAt?.toISOString(),pendingTasks:r.pendingTasks,queueSize:n.queueSize};return t.json(a)}catch(e){return t.json({connected:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/register`,async t=>{try{let n=await t.req.json();if(!n.browserId)return t.json({success:!1,error:`Missing browserId in request body`},400);let r=e.get(i.ExtensionSessionRegistry).register(n);return t.json({success:!0,session:{id:r.id,browserId:r.browserId,controlMode:r.controlMode,createdAt:r.createdAt.toISOString()}})}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/heartbeat`,async t=>{try{let n=await t.req.json();if(!n.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let r=e.get(i.ExtensionSessionRegistry).heartbeat(n);return r?t.json({success:!0,session:{id:r.id,controlMode:r.controlMode,handoffRequested:r.handoffRequested,lastHeartbeatAt:r.lastHeartbeatAt.toISOString()}}):t.json({success:!1,error:`Session ${n.sessionId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/tab-mapped`,async t=>{try{let n=await t.req.json();if(!n.pageId||typeof n.tabId!=`number`)return t.json({success:!1,error:`Missing pageId or tabId in request body`},400);let r=e.get(i.PageRegistry),a=e.get(i.BrowserService),o=r.get(n.pageId);return o?(o.extensionTabId=n.tabId,a.recordBrowserActivity(o.browserId,n.pageId),t.json({success:!0})):t.json({success:!1,error:`Page ${n.pageId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/recording`,async t=>{try{let n=await t.req.json();if(!n.browserId)return t.json({success:!1,error:`Missing browserId in request body`},400);let r=e.get(i.BrowserService),a=await r.persistExtensionRecordingArtifact(n.browserId,n.videoBase64);return Ee(`artifact received`,{browserId:n.browserId,videoBase64Size:n.videoBase64?.length??0,persisted:a}),a?(r.recordBrowserActivity(n.browserId),t.json({success:!0})):t.json({success:!1,error:`Browser "${n.browserId}" has no active recording target`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.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=e.get(i.BrowserService),o=await a.persistExtensionRecordingChunk(r.browserId,r.chunkBase64);return Ee(`chunk received`,{browserId:r.browserId,chunkIndex:r.chunkIndex,mimeType:r.mimeType,persisted:!!o,chunkBase64Size:r.chunkBase64.length}),o?(n.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)}}),t.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):(n.log(t.level??`info`,t.message,{attributes:{"browse_tool.extension.log_relay":!0,...typeof t.attributes==`object`&&t.attributes!==null?t.attributes:{}}}),Ee(`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)}}),t.post(`/handoff`,async t=>{try{let n=await t.req.json();if(!n.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let r=e.get(i.ExtensionSessionRegistry).requestHandoff(n);return r?t.json({success:!0,message:`Handoff requested. AI will take control when ready.`,session:{id:r.id,controlMode:r.controlMode,handoffRequested:r.handoffRequested}}):t.json({success:!1,error:`Session ${n.sessionId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/handoff/acknowledge`,async t=>{try{let n=await t.req.json();if(!n.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let r=e.get(i.ExtensionSessionRegistry).acknowledgeHandoff(n.sessionId);return r?t.json({success:!0,message:`Handoff acknowledged. AI now has control.`,session:{id:r.id,controlMode:r.controlMode,handoffRequested:r.handoffRequested}}):t.json({success:!1,error:`Session ${n.sessionId} not found or no handoff pending`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.get(`/sessions`,t=>{try{let n=e.get(i.ExtensionSessionRegistry).listSessions();return t.json({sessions:n.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)}}),t}function Oe(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 ke=`browse-tool-chrome`,Ae=`tool`,je=process.env.NODE_ENV||`development`,Me=`127.0.0.1`;function Ne(){return new te(process.env.PORT_REGISTRY_PATH)}async function Pe(e,t,n){let r=Ne(),i=await r.reservePort({repositoryPath:e,serviceName:ke,serviceType:Ae,environment:je,preferredPort:t,portRange:n,pid:process.pid,host:Me,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:ke,serviceType:Ae,environment:je,pid:process.pid});if(!n.success&&!n.error?.includes(`No matching registry entry`))throw Error(n.error||`Failed to release port ${t}`)}}}function Fe(){return new ie(e=>{e.bind(i.ExtensionTaskQueue).to(h).inSingletonScope(),e.bind(i.ExtensionToolDelegator).to(b).inSingletonScope()})}function Ie(e){let t=new me({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(ge,async()=>({tools:n})),t.setRequestHandler(he,async t=>{let{name:n,arguments:r}=t.params;return await e.executeTool(n,r||{})}),t}const Le=new I(`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 a=Oe(t.port),o=e(),s=process.env.PORT_REGISTRY_PATH;s&&(process.env.PROCESS_REGISTRY_PATH=re(s,`processes.json`)),n=await Pe(o,a??j.min,a?{min:a,max:a}:j);let c=n.port;r=await ne({repositoryPath:o,serviceName:ke,serviceType:Ae,environment:je,pid:process.pid,port:c,host:Me,command:process.argv[1],args:process.argv.slice(2),metadata:{transport:`stdio`,command:`chrome-serve`,waitForExtension:t.waitForExtension}}),t.verbose&&(console.error(`Chrome Extension MCP Server starting...`),console.error(` HTTP Port: ${c}`),console.error(` Wait for extension: ${t.waitForExtension}`));let l=new M({defaultScope:`Singleton`});l.load(Fe());let u=l.get(i.ExtensionTaskQueue),d=l.get(i.ExtensionToolDelegator),f=new L;f.use(`*`,be({origin:e=>e??null,credentials:!0,allowMethods:[`GET`,`POST`,`OPTIONS`],allowHeaders:[`Content-Type`,`Accept`]}));let p=De(l);f.route(`/extension`,p),f.get(`/health`,e=>{let t=u.getConnectionStatus();return e.json({status:`healthy`,service:`browse-tool-chrome`,extension:t})});let m=ye({fetch:f.fetch,port:c});m.on(`error`,e=>{e.code===`EADDRINUSE`?(console.error(`Error [PORT_IN_USE]: Port ${c} 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 ${c}`),console.error(`Waiting for Chrome extension to connect...`),console.error(`Extension should poll: http://localhost:${c}/extension/tasks`),t.waitForExtension&&(console.error(`Waiting for extension connection before starting MCP...`),await new Promise(e=>{let t=setInterval(()=>{u.getConnectionStatus().connected&&(clearInterval(t),console.error(`Extension connected!`),e())},500)}));let h=Ie(d),g=new _e;await h.connect(g),console.error(`Chrome extension MCP server started on stdio`);let _=async e=>{console.error(`\nReceived ${e}, shutting down gracefully...`);try{u.clearAllTasks(`Server shutting down`),await g.close(),m.close(),await r.release({kill:!1}),await n.release(),process.exit(0)}catch(e){console.error(`Error during shutdown:`,e),process.exit(1)}};process.on(`SIGINT`,()=>_(`SIGINT`)),process.on(`SIGTERM`,()=>_(`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)}}),Re=`BROWSE_TOOL_CONFIG`,ze=`.browse-tool`,Be=`config.json`,Ve=[`json`,`text`,`quiet`],He={commands:{},tools:{}},Ue=P.record(P.string(),P.unknown()),We=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(),httpPort:P.coerce.number().int().positive().optional(),tags:P.string().optional(),exclude:P.string().optional(),customTools:P.string().optional(),chromeForTestingPath:P.string().optional(),snippetsDir:P.string().optional(),registryPath:P.string().optional(),registryDir:P.string().optional(),pidsDir:P.string().optional(),profilesDir:P.string().optional(),proxyConfigDir: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(),proxyConfigDir:P.string().optional()}).partial().optional(),exec:P.object({format:P.enum(Ve).optional(),color:P.boolean().optional(),port:P.coerce.number().int().positive().optional()}).partial().optional(),tools:P.object({format:P.enum(Ve).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()}),Ge=P.object({commands:We.default({}),tools:P.record(P.string(),Ue).default({})});let B={config:He};function Ke(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 qe(e){let t=N.resolve(e);if(!ae(t))throw Error(`Config path not found: ${t}`);return se(t).isDirectory()?N.join(t,Be):t}function Je(t,n){let r=n.env??process.env,i=n.cwd??e({argv:t,env:r,startPath:process.cwd()}),a=n.homeDir??ue(),o=Ke(t);if(o)return qe(o);if(r[Re])return qe(r[Re]);let s=N.join(i,ze,Be);if(ae(s))return s;let c=N.join(a,ze,Be);if(ae(c))return c}function Ye(e){let t=oe(e,`utf8`),n=JSON.parse(t);return Ge.parse(n)}function Xe(e,t={}){let n=Je(e,t);return n?{configPath:n,config:Ye(n)}:{config:He}}function Ze(e,t={}){return B=Xe(e,t),B}function V(e){return(B.config.commands??{})[e]??{}}function Qe(e){return B.config.tools?.[e]??{}}function H(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 $e=class{port;exactPort;ownerId;timeout;serverPort=null;constructor(e={}){this.port=e.port??f,this.exactPort=e.exactPort??!1,this.ownerId=n({ownerId:e.ownerId}),this.timeout=e.timeout??6e4}async ensureServer(){if(this.serverPort!==null)return this.serverPort;let e=await S().get(i.HttpServerManager).ensureRunning(this.port,{exactPort:this.exactPort});if(!e.running||!e.port)throw Error(e.error??`Failed to start HTTP server. Try running "browse-tool http-serve" manually.`);return this.serverPort=e.port,e.port}async getBaseUrl(){return`http://localhost:${await this.ensureServer()}`}jsonHeaders(){return{"Content-Type":`application/json`,Accept:`application/json`,[s]:this.ownerId}}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:this.jsonHeaders(),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:this.jsonHeaders(),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 U(e){return new $e(e)}const et={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 W(e,t,n){return n?`${et[t]}${e}${et.reset}`:e}function tt(e,t){let{format:n,color:r}=t;return n===`quiet`?``:n===`json`?nt(e):rt(e,r)}function nt(e){return JSON.stringify(e,null,2)}function rt(e,t){let n=[];e.isError&&n.push(W(`Error:`,`red`,t));for(let r of e.content)r.type===`text`?n.push(it(r,t)):r.type===`image`?n.push(st(r,t)):n.push(W(`[Unknown content type: ${r.type}]`,`yellow`,t));return n.join(`
|
|
3
|
+
`)}function it(e,t){let n=e.text;try{return at(JSON.parse(n),t)}catch{return n}}function at(e,t){if(typeof e!=`object`||!e)return String(e);let n=[];for(let[r,i]of Object.entries(e)){let e=W(r,`cyan`,t),a=ot(i,t);n.push(`${e}: ${a}`)}return n.join(`
|
|
4
|
+
`)}function ot(e,t){return e===null?W(`null`,`gray`,t):e===void 0?W(`undefined`,`gray`,t):typeof e==`boolean`?W(String(e),e?`green`:`red`,t):typeof e==`number`?W(String(e),`yellow`,t):typeof e==`string`?e.startsWith(`http://`)||e.startsWith(`https://`)?W(e,`blue`,t):e:Array.isArray(e)?e.length===0?W(`[]`,`gray`,t):JSON.stringify(e,null,2):typeof e==`object`?JSON.stringify(e,null,2):String(e)}function st(e,t){let{mimeType:n,data:r}=e;return W(`[Image: ${n}, ~${Math.round(r.length*3/4/1024)}KB base64 data]`,`magenta`,t)}function G(e,t){return W(`Error: ${e instanceof Error?e.message:e}`,`red`,t)}function ct(e,t){let n=Math.max(...e.map(e=>e.name.length)),r=[];for(let i of e){let e=W(i.name.padEnd(n),`cyan`,t);r.push(` ${e} ${i.description}`)}return r.join(`
|
|
5
|
+
`)}function lt(e,t){let n=V(`tools`),r=H(e,`format`,t.format,n.format),i=H(e,`color`,t.color,n.color);return{port:H(e,`port`,t.port,n.port===void 0?void 0:String(n.port),process.env.PLAYWRIGHT_PORT),formatterOptions:{format:r,color:i}}}const ut=new I(`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(f)).action(async function(e,t){let{port:n,formatterOptions:r}=lt(this,t);try{let t=await U({port:Number.parseInt(n,10)}).listCustomTools(e),i=r.format===`text`?ct(t,r.color):r.format===`quiet`?``:JSON.stringify(t,null,2);i&&console.log(i)}catch(e){console.error(G(e instanceof Error?e:String(e),r.color)),process.exit(1)}}),dt=new I(`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(f)).option(`--owner <owner>`,`Owner id used to scope browser resources for direct CLI calls`).action(async function(e,t,n,r){let{port:i,formatterOptions:a}=lt(this,r);try{let o;try{o=JSON.parse(n)}catch{console.error(G(`Invalid JSON arguments: ${n}`,a.color)),process.exit(1);return}let s=await U({port:Number.parseInt(i,10),ownerId:r.owner}).executeCustomTool(e,t,o),c=tt(s,a);c&&console.log(c),s.isError&&process.exit(1)}catch(e){console.error(G(e instanceof Error?e:String(e),a.color)),process.exit(1)}});new I(`custom-tools`).description(`List and execute custom tools through the HTTP server`).addCommand(ut).addCommand(dt);const ft=new I(`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`,D).option(`--image <image>`,`Docker image tag to produce`,o).option(`--platform <platform>`,`Docker target platform`,t).action(async e=>{try{let t=await k({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: ${u(t.platform)}`)}catch(e){console.error(e instanceof Error?e.message:String(e)),process.exit(1)}}),pt=new I(`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(f)).option(`--owner <owner>`,`Owner id used to scope browser resources for direct CLI calls`).action(async function(e,t,n){let r=V(`exec`),i=H(this,`format`,n.format,r.format),a=H(this,`color`,n.color,r.color),o=H(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 r;try{r=JSON.parse(t)}catch{console.error(G(`Invalid JSON arguments: ${t}`,l.color)),process.exit(1)}let i=await U({port:Number.parseInt(o,10),exactPort:c,ownerId:n.owner}).execute(e,r),a=tt(i,l);a&&console.log(a),i.isError&&process.exit(1)}catch(e){console.error(G(e instanceof Error?e:String(e),l.color)),process.exit(1)}}),K=`pageId`,q=`browserId`,mt=P.record(P.string(),P.unknown()),ht=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(),gt=P.object({name:P.string().min(1),description:P.string().min(1),script:P.string().min(1),suggestionActions:P.string().min(1).optional(),capabilities:mt,inputSchema:ht}),_t=P.object({tools:P.array(gt)}),vt=process.env.BROWSE_TOOL_DEBUG_CUSTOM_TOOLS===`1`;function yt(e){return JSON.stringify(e,(e,t)=>typeof t==`string`&&t.length>240?`${t.slice(0,240)}...<trimmed>`:t)}function bt(e,t){if(vt){if(t){console.error(`[CustomToolService] ${e}`,t);return}console.error(`[CustomToolService] ${e}`)}}function J(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function xt(e){return J(e)&&Array.isArray(e.content)}function St(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 Ct(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 wt(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 Y(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(`-`)?Tt(e,t,n):Et(e,t,n)}function Tt(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]=Y(e,i+1,t.indent);r.push(a),i=o;continue}if(a.includes(`:`)){let[t,o]=Dt(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]=Y(e,i+1,r.indent);s[t]=a,i=o}else s[t]=St(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]=Y(e,i,t.indent);if(!J(n))throw Error(`Expected object entry in tools.yaml at line ${i+1}`);Object.assign(s,n),i=r;continue}let[r,a]=Dt(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]=Y(e,i+1,n.indent);s[r]=a,i=o;continue}s[r]=St(a),i+=1}r.push(s);continue}r.push(St(a)),i+=1}return[r,i]}function Et(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]=Dt(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]=Y(e,i+1,t.indent);r[a]=o,i=s;continue}r[a]=St(o),i+=1}return[r,i]}function Dt(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 Ot(e){let t=wt(e);if(t.length===0)return{};let[n]=Y(t,0,t[0].indent);return n}function kt(e){e.inputSchema.properties===void 0&&(e.inputSchema.properties={});let t=e.inputSchema.properties;if(!J(t))throw Error(`Custom tool "${e.name}" inputSchema.properties must be an object`);let n=t[K],r=t[q];if(n!==void 0&&!(J(n)&&n.type===`string`))throw Error(`Custom tool "${e.name}" must define inputSchema.properties.pageId as type "string"`);if(r!==void 0&&!(J(r)&&r.type===`string`))throw Error(`Custom tool "${e.name}" must define inputSchema.properties.browserId as type "string"`);n===void 0&&(t[K]={type:`string`,description:`Browse-tool page ID to run this custom tool against. Either pageId or browserId is required at call time.`}),r===void 0&&(t[q]={type:`string`,description:`Browse-tool browser ID to run this custom tool against when no pageId is supplied. The tool will use the browser's current page or open a new one.`})}async function At(e){let t=A(await ce(e,`utf8`),{mode:`strip`});return await import(`data:text/javascript;base64,${Buffer.from(t,`utf8`).toString(`base64`)}`)}function jt(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 Mt(e,t){return typeof e.suggestionActions==`string`&&e.suggestionActions.trim().length>0?e:{...e,suggestionActions:t}}function Nt(e,t){let n=e.content[0];if(n?.type===`text`&&typeof n.text==`string`)try{let r=JSON.parse(n.text);if(J(r)){let i=Mt(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 Pt(e,t,n){if(xt(t))return n?Nt(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=J(t)&&n?Mt(t,n):t;return{content:[{type:`text`,text:JSON.stringify(r,null,2)}]}}var Ft=class{constructor(e,t,n=new m,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 ee(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[K]==`string`&&t[K].length>0?t[K]:void 0,i=typeof t[q]==`string`&&t[q].length>0?t[q]:void 0;if(!n&&!i)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`);let a=r();if(a&&t.ownerId&&t.ownerId!==a)throw Error(`Custom tool "${e}" cannot use page "${n}" owned by another session`);if(i&&t.browserId!==i)throw Error(`Custom tool "${e}" received pageId "${n}" for browser "${t.browserId}", not "${i}"`);let o=this.createBrowserHelper(e,t.browserId);return{pageId:n,pageEntry:t,page:this.resolveToolPage(e,n,t),browser:o}}let a=this.createBrowserHelper(e,i);try{let e=await a.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:a}}catch(e){if(!(e instanceof Error?e.message:String(e)).includes(`has no pages`))throw e;let t=await a.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:a}}}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 i=r(),a;if(i){let e=this.pageRegistry.findByOwner(i).filter(e=>e.browserId===t);if(a=e[e.length-1]?.id,!a)throw Error(`Browser "${t}" has no pages owned by this session`)}else a=n.currentPageId??this.pageRegistry.findByBrowser(t)[0]?.id??void 0;if(!a)throw Error(`Browser "${t}" has no pages`);let o=this.pageRegistry.get(a);if(!o)throw Error(`Page "${a}" not found`);return{...this.toPageSummary(n.currentPageId,o),page:this.resolveToolPage(e,a,o)}},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:Ct({...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[K]==`string`?n[K]:void 0,i=typeof n[q]==`string`?n[q]:void 0;return this.telemetry.runInSpan(`browse_tool.custom_tool.execute`,{attributes:{"browse_tool.tool.name":t,"browse_tool.custom_tools.directory":N.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:F.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}),bt(`Executing custom tool`,{toolName:t,directory:N.resolve(e),pageId:a,browserId:o.browserId,mode:o.mode,input:yt(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 bt(`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})}bt(`Custom tool execution completed`,{toolName:t,pageId:a,browserId:o.browserId,mode:o.mode,result:yt(u)});let d=Pt(t,u,i.suggestionActions),f=d.isError?d.content[0]?.text:void 0;return f&&r?.setStatus({code:F.ERROR,message:f}),d})}async loadTools(e){let t=N.resolve(e),n=N.join(t,`tools.yaml`),r=Ot(await ce(n,`utf8`).catch(e=>{throw Error(`Failed to read custom tool manifest at "${n}": ${e instanceof Error?e.message:String(e)}`)})),i=_t.parse(r);return Promise.all(i.tools.map(async e=>{kt(e);let n=N.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=jt(n,await At(n));return{name:e.name,description:e.description,suggestionActions:e.suggestionActions,inputSchema:e.inputSchema,capabilities:e.capabilities,scriptPath:n,...r}}))}};function It(e){let t=new L;return t.get(`/browsers`,async t=>{try{let n=e.get(i.BrowserService),r=e.get(i.PageRegistry),a=n.listBrowsers(),o=r.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 t.json({browsers:s,stats:c})}catch(e){return console.error(`Failed to list browsers:`,e),t.json({error:`Failed to list browsers`,message:e instanceof Error?e.message:String(e)},500)}}),t.delete(`/browsers`,async t=>{try{return await e.get(i.BrowserService).closeAll(),t.json({success:!0,message:`All browsers closed`})}catch(e){return console.error(`Failed to close all browsers:`,e),t.json({error:`Failed to close all browsers`,message:e instanceof Error?e.message:String(e)},500)}}),t.delete(`/browsers/:id`,async t=>{try{let n=t.req.param(`id`),r=e.get(i.BrowserService);return r.getBrowser(n)?(await r.closeBrowser(n),t.json({success:!0,message:`Browser "${n}" closed`})):t.json({error:`Browser "${n}" not found`},404)}catch(e){return console.error(`Failed to close browser:`,e),t.json({error:`Failed to close browser`,message:e instanceof Error?e.message:String(e)},500)}}),t.delete(`/pages/:id`,async t=>{try{let n=t.req.param(`id`),r=e.get(i.PageRegistry).get(n);return r?r.page?(await r.page.close(),t.json({success:!0,message:`Page "${n}" closed`})):t.json({error:`Page "${n}" is in extension mode and cannot be closed via API`},400):t.json({error:`Page "${n}" not found`},404)}catch(e){return console.error(`Failed to close page:`,e),t.json({error:`Failed to close page`,message:e instanceof Error?e.message:String(e)},500)}}),t}function Lt(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 Rt(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 zt(e){return Rt(new Date().getTime()-e.getTime())}const Bt=`table-container`,Vt=`stat-card`,Ht=`browser-row`,Ut=`page-row`,Wt=`status-active`,Gt=`url-cell`,X=`timestamp-cell`,Kt=`actions-cell`,qt=`kill-btn`,Jt=`empty-state`;function Yt({browsers:e}){return e.length===0?R(`div`,{class:Bt,children:z(`div`,{class:Jt,children:[R(`h3`,{children:`No Active Browsers`}),R(`p`,{children:`Launch a browser using MCP tools to see it here.`})]})}):R(`div`,{class:Bt,children:z(`table`,{class:`browser-table`,children:[R(`thead`,{children:z(`tr`,{children:[R(`th`,{children:`ID`}),R(`th`,{children:`Status`}),R(`th`,{children:`URL / Title`}),R(`th`,{children:`Created`}),R(`th`,{children:`Age`}),R(`th`,{children:`Actions`})]})}),R(`tbody`,{id:`browser-table-body`,children:e.map(e=>z(Ce,{children:[z(`tr`,{class:Ht,children:[R(`td`,{children:e.id}),R(`td`,{children:z(`span`,{class:Wt,children:[e.pages.length,` page`,e.pages.length===1?``:`s`]})}),R(`td`,{children:e.profileName||`Default Profile`}),R(`td`,{class:X,children:Lt(e.createdAt)}),R(`td`,{class:X,children:zt(e.createdAt)}),R(`td`,{class:Kt,children:R(`button`,{type:`button`,class:qt,onclick:`dashboard.killBrowser('${e.id}')`,children:`Kill`})})]}),e.pages.map(t=>z(`tr`,{class:Ut,children:[z(`td`,{children:[t.id,e.currentPageId===t.id&&` (active)`]}),R(`td`,{children:R(`span`,{class:Wt,children:`Open`})}),R(`td`,{class:Gt,title:t.url,children:t.title||t.url||`about:blank`}),R(`td`,{class:X,children:Lt(t.createdAt)}),R(`td`,{class:X,children:zt(t.createdAt)}),R(`td`,{class:Kt,children:R(`button`,{type:`button`,class:qt,onclick:`dashboard.killPage('${t.id}')`,children:`Close`})})]},t.id))]},e.id))})]})})}function Xt({stats:e}){return z(`div`,{class:`stats-container`,children:[z(`div`,{class:Vt,children:[R(`h3`,{children:`Active Browsers`}),R(`div`,{class:`value`,children:e.totalBrowsers})]}),z(`div`,{class:Vt,children:[R(`h3`,{children:`Active Pages`}),R(`div`,{class:`value`,children:e.totalPages})]})]})}function Zt({browsers:e,stats:t}){return z(`div`,{class:`dashboard-container`,children:[z(`div`,{class:`dashboard-header`,children:[z(`div`,{children:[R(`h1`,{children:`Playwright MCP Dashboard`}),R(`p`,{children:`Browser automation management (auto-refresh every 3 seconds)`})]}),z(`div`,{children:[R(`button`,{type:`button`,id:`refresh-btn`,class:`btn refresh-btn`,onclick:`dashboard.manualRefresh()`,children:`Refresh Now`}),R(`button`,{type:`button`,id:`kill-all-btn`,class:`btn btn-danger`,onclick:`dashboard.killAllBrowsers()`,children:`Kill All Browsers`})]})]}),R(Xt,{stats:t}),R(Yt,{browsers:e}),R(`script`,{children:Se(`
|
|
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('.${Vt} .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('.${Bt}');
|
|
56
56
|
if (container) {
|
|
57
57
|
container.innerHTML = \`
|
|
58
|
-
<div class="${
|
|
58
|
+
<div class="${Jt}">
|
|
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 = '${Ht}';
|
|
73
73
|
browserRow.innerHTML = \`
|
|
74
74
|
<td>\${browser.id}</td>
|
|
75
|
-
<td><span class="${
|
|
75
|
+
<td><span class="${Wt}">\${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="${Kt}"><button class="${qt}" 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 = '${Ut}';
|
|
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="${Wt}">Open</span></td>
|
|
91
|
+
<td class="${Gt}" 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="${Kt}"><button class="${qt}" 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 Qt({title:e,children:t}){return z(`html`,{lang:`en`,children:[z(`head`,{children:[R(`meta`,{charset:`UTF-8`}),R(`meta`,{name:`viewport`,content:`width=device-width, initial-scale=1.0`}),R(`title`,{children:e}),R(`style`,{children:Se(`
|
|
191
191
|
* {
|
|
192
192
|
margin: 0;
|
|
193
193
|
padding: 0;
|
|
@@ -428,7 +428,7 @@ window.addEventListener('beforeunload', () => {
|
|
|
428
428
|
margin-bottom: 0.5rem;
|
|
429
429
|
color: #999;
|
|
430
430
|
}
|
|
431
|
-
`)})]}),z(`body`,{children:t})]})}function Qt(e){let t=new R;return t.get(`/`,async t=>{try{let n=e.get(i.BrowserService),r=e.get(i.PageRegistry),a=n.listBrowsers(),o=r.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 t.html(z(Zt,{title:`Playwright MCP Dashboard`,children:z(Xt,{browsers:s,stats:c})}))}catch(e){return console.error(`Failed to render dashboard:`,e),t.html(z(Zt,{title:`Playwright MCP Dashboard - Error`,children:B(`div`,{style:`padding: 2rem; text-align: center;`,children:[z(`h1`,{children:`Failed to load dashboard`}),z(`p`,{children:e instanceof Error?e.message:String(e)}),z(`a`,{href:`/`,style:`color: #2196f3; text-decoration: underline;`,children:`Retry`})]})}),500)}}),t}function $t(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 en(e){try{return e.get(i.TelemetryService)}catch{return new m}}function tn(e){return e.startsWith(`browser-`)||e===`run-spec`||e===`discover-specs`?e.replaceAll(`-`,`_`):e}function nn(e){return{browser_console_logs:`browser_list_console_messages`,browser_console_messages:`browser_list_console_messages`,browser_evaluate:`browser_evaluate_script`,browser_get_console_logs:`browser_list_console_messages`,browser_resize:`browser_resize_page`}[e]}function rn(e){let t=new R,n=e.get(i.PageRegistry),r=e.get(i.BrowserService),o=e.get(i.ExtensionTaskQueue),c=en(e),l=new Pt(n,o,c,r);t.use(`*`,ye({origin:e=>e??null,credentials:!0,allowMethods:[`GET`,`POST`,`DELETE`,`OPTIONS`],allowHeaders:[`Content-Type`,`Accept`,`Authorization`]})),t.get(`/health`,e=>{try{let t=r.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)}}),t.post(`/execute`,async t=>{try{let r=await t.req.json();if(!r.tool)return t.json({success:!1,error:`Missing "tool" field in request body`},400);let o=typeof r.arguments?.pageId==`string`?r.arguments.pageId:void 0;return await c.runInSpan(`browse_tool.http.execute`,{attributes:{"http.method":`POST`,"http.route":`/execute`,"browse_tool.tool.name":r.tool,"browse_tool.page.id":o}},async o=>{let l=e.getAll(i.Tool),u=tn(r.tool),d=l.find(e=>e.getDefinition().name===u);if(process.env.BROWSE_TOOL_DEBUG_EXTENSION_RECORDING===`1`&&r.tool===`browser_launch`){let e=typeof r.arguments?.videoDir==`string`?r.arguments.videoDir:typeof r.arguments?.video_dir==`string`?r.arguments.video_dir:``;console.log(`[ExtensionRecordingDebug] http execute browser_launch mode=${String(r.arguments?.mode??``)} videoDir=${e}`)}if(!d){let e=nn(u),n=e?`Tool "${r.tool}" not found. Use "${e}" instead.`:`Tool "${r.tool}" not found`;return o?.setStatus({code:I.ERROR,message:n}),c.log(`warn`,`browse-tool HTTP execute rejected unknown tool`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":r.tool,"browse_tool.tool.normalized_name":u,"browse_tool.tool.suggested_name":e}}),t.json({success:!1,error:n},404)}let f=r.arguments||{},p;try{p=d.getInputSchema().parse(de(f,d.getInputSchema()))}catch(e){if(e instanceof F.ZodError){let n=fe(e,{schemaName:u,schema:d.getInputSchema()});return o?.setStatus({code:I.ERROR,message:n}),t.json({success:!1,result:{content:[{type:`text`,text:n}],isError:!0},error:n})}throw e}let m=await a(t.req.header(s),()=>d.execute(p)),h=p,g=typeof h.pageId==`string`?h.pageId:void 0;if(g){let t=e.get(i.BrowserService),r=n.get(g);r&&t.recordBrowserActivity(r.browserId,g)}let _=$t(m);return _?(o?.setStatus({code:I.ERROR,message:_}),c.log(`warn`,`browse-tool HTTP execute returned tool error`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":u,"browse_tool.page.id":g,"tool.result.error":!0,"tool.name":u,"error.message":_}})):c.log(`debug`,`browse-tool HTTP execute succeeded`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":u,"browse_tool.page.id":g}}),t.json({success:!m.isError,result:m,error:_})})}catch(e){return c.log(`error`,`browse-tool HTTP execute request crashed`,{attributes:{"http.route":`/execute`},exception:e}),t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.get(`/browsers`,t=>{try{let n=e.get(i.BrowserService).listBrowsers();return t.json({browsers:n.map(e=>({id:e.id,profileName:e.profileName,pageIds:Array.from(e.pageIds),currentPageId:e.currentPageId,createdAt:e.createdAt.toISOString()}))})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}}),t.get(`/tools`,t=>{try{let n=e.getAll(i.Tool);return t.json({tools:n.map(e=>e.getDefinition())})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}}),t.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 l.listTools(t);return e.json({tools:n})}catch(t){return e.json({tools:[],error:t instanceof Error?t.message:String(t)},400)}}),t.post(`/custom-tools`,async t=>{let r=t.req.query(`dir`);if(!r)return t.json({success:!1,error:`Missing "dir" query parameter`},400);try{let o=await t.req.json();if(!o.tool)return t.json({success:!1,error:`Missing "tool" field in request body`},400);let u=typeof o.arguments?.pageId==`string`?o.arguments.pageId:void 0;return await c.runInSpan(`browse_tool.http.custom_tool.execute`,{attributes:{"http.method":`POST`,"http.route":`/custom-tools`,"browse_tool.tool.name":o.tool,"browse_tool.page.id":u,"browse_tool.custom_tools.directory":r}},async d=>{let f=await a(t.req.header(s),()=>l.executeTool(r,o.tool,o.arguments||{}));if(u){let t=e.get(i.BrowserService),r=n.get(u);r&&t.recordBrowserActivity(r.browserId,u)}let p=$t(f);return p?(d?.setStatus({code:I.ERROR,message:p}),c.log(`warn`,`browse-tool custom tool execution returned tool error`,{attributes:{"http.route":`/custom-tools`,"browse_tool.tool.name":o.tool,"browse_tool.page.id":u,"tool.result.error":!0,"tool.name":o.tool,"error.message":p}})):c.log(`debug`,`browse-tool custom tool execution succeeded`,{attributes:{"http.route":`/custom-tools`,"browse_tool.tool.name":o.tool,"browse_tool.page.id":u}}),t.json({success:!f.isError,result:f,error:p})})}catch(e){return c.log(`error`,`browse-tool custom tool request crashed`,{attributes:{"http.route":`/custom-tools`,"browse_tool.custom_tools.directory":r},exception:e}),t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}});let u=Ee(e);t.route(`/extension`,u);let d=Ft(e);t.route(`/api`,d);let f=Qt(e);return t.route(`/`,f),t}function an(e,t,n){e.get(`/ws/extension/:browserId`,n(e=>{let n=e.req.param(`browserId`),r=null;return{onOpen(e,a){if(!n){a.close(1008,`Missing browserId`);return}try{r=t.get(i.WebSocketHub).addConnection(a,n)}catch{a.close(1011,`Internal server error`)}},onMessage(e){if(r)try{let n=t.get(i.WebSocketHub),a=typeof e.data==`string`?e.data:e.data.toString();n.handleMessage(r,a)}catch{}},onClose(){if(r)try{t.get(i.WebSocketHub).removeConnection(r)}catch{}},onError(){if(r)try{t.get(i.WebSocketHub).removeConnection(r)}catch{}}}})),e.get(`/ws/stats`,e=>{try{let n=t.get(i.WebSocketHub).getStats();return e.json({totalConnections:n.totalConnections,browserCount:n.browserCount,connections:n.connections.map(e=>({id:e.id,browserId:e.browserId,connectedAt:e.connectedAt.toISOString()}))})}catch(t){return e.json({error:t instanceof Error?t.message:String(t)},500)}})}const on=new L(`http-serve`).description(`Start HTTP server for browser automation`).option(`-p, --port <port>`,`Port to listen on`,String(f)).option(`--host <host>`,`Host to bind`,C()).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`).option(`--proxy-config-dir <path>`,`Custom proxy config directory`).option(`--workspace-root <path>`,`Canonical workspace root for registry scoping (${v})`).action(async function(t){let n=H(`httpServe`),r={port:U(this,`port`,t.port,n.port===void 0?void 0:String(n.port),process.env.PLAYWRIGHT_PORT),headless:U(this,`headless`,t.headless,n.headless),idleTimeout:U(this,`idleTimeout`,t.idleTimeout,n.idleTimeout===void 0?void 0:String(n.idleTimeout),process.env[E]),host:U(this,`host`,t.host,n.host,process.env.PLAYWRIGHT_HOST),registryDir:U(this,`registryDir`,t.registryDir,n.registryDir,process.env.PLAYWRIGHT_REGISTRY_DIR),registryPath:U(this,`registryPath`,t.registryPath,n.registryPath,process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH),pidsDir:U(this,`pidsDir`,t.pidsDir,n.pidsDir,process.env.PLAYWRIGHT_PIDS_DIR),profilesDir:U(this,`profilesDir`,t.profilesDir,n.profilesDir,process.env.PLAYWRIGHT_PROFILES_DIR),snippetsDir:U(this,`snippetsDir`,t.snippetsDir,n.snippetsDir,process.env.BROWSE_TOOL_SNIPPETS_DIR),proxyConfigDir:U(this,`proxyConfigDir`,t.proxyConfigDir,n.proxyConfigDir,process.env[w]),workspaceRoot:U(this,`workspaceRoot`,t.workspaceRoot,n.workspaceRoot,process.env[v])},a;try{let t=Number.parseInt(r.port,10),n=`browse-tool-http`,o=process.env.NODE_ENV||`development`,s=_(e({startPath:process.cwd(),env:{...process.env,[v]:r.workspaceRoot}})),c=r.registryPath||r.registryDir||process.env.PLAYWRIGHT_REGISTRY_PATH;c&&(process.env.PLAYWRIGHT_REGISTRY_DIR=c,process.env.PORT_REGISTRY_PATH=c,process.env.PROCESS_REGISTRY_PATH=ne(c,`processes.json`)),process.env.PLAYWRIGHT_HOST=r.host,process.env.PLAYWRIGHT_PORT=r.port,process.env[E]=r.idleTimeout,r.pidsDir&&(process.env.PLAYWRIGHT_PIDS_DIR=r.pidsDir),r.profilesDir&&(process.env.PLAYWRIGHT_PROFILES_DIR=r.profilesDir),r.snippetsDir&&(process.env.BROWSE_TOOL_SNIPPETS_DIR=P.resolve(r.snippetsDir)),r.proxyConfigDir&&(process.env[w]=P.resolve(r.proxyConfigDir)),console.log(`Starting HTTP server for browser automation...`),console.log(` Port: ${t}`),console.log(` Host: ${r.host}`),console.log(` Headless: ${r.headless}`),console.log(` Idle Timeout: ${r.idleTimeout} minutes`),process.env.BROWSE_TOOL_SNIPPETS_DIR&&console.log(` Snippets Dir: ${process.env.BROWSE_TOOL_SNIPPETS_DIR}`),process.env.BROWSE_TOOL_PROXY_CONFIG_DIR&&console.log(` Proxy Config Dir: ${process.env[w]}`);let u=l(),d=u.get(i.ProcessRegistryService),f=u.get(i.BrowserProcessRegistry),m=rn(u),{injectWebSocket:h,upgradeWebSocket:g}=be({app:m});an(m,u,g);let y=u.get(i.WebSocketHub),b=u.get(i.ExtensionTaskQueue),x=u.get(i.BrowserService),S=u.get(i.ExtensionSessionRegistry),C=u.get(i.PageRegistry),T=u.get(i.IdleCleanupService);T.start(),y.setEventHandlers({onSessionRegister:(e,t)=>{if(t.type===`session:register`){let n=t.payload.browserId||e.browserId,r=x.getBrowser(n),i,a;if(r&&(r.mode===`extension`||r.mode===`vm`)){i=r.id;let t=C.findByBrowser(i);a=r.currentPageId||t[0]?.id||``,y.reassignConnection(e.id,i),a||(a=C.registerExtensionPage(i),r.pageIds.add(a),r.currentPageId=a),console.log(`[WebSocket] Extension connected to existing browser: ${i}, pageId: ${a}`)}else{i=n,x.registerExtensionBrowserWithId(i),a=C.registerExtensionPage(i);let e=x.getBrowser(i);e&&(e.pageIds.add(a),e.currentPageId=a),console.log(`[WebSocket] Extension connected with new browser: ${i}, pageId: ${a}`)}let o=C.get(a);o&&(o.extensionTabId=t.payload.tabId,o.url=t.payload.url??o.url);let s=S.register({browserId:i,tabId:t.payload.tabId,url:t.payload.url,metadata:{transport:`websocket`}});y.sendSessionAck(e,t.id??``,s.id,s.controlMode),y.broadcastPageCreated(i,a,C.get(a)?.url)}},onTaskResult:(e,t)=>{if(t.type===`task:result`){let e=b.submitResult({taskId:t.payload.taskId,success:t.payload.success,result:t.payload.result,error:t.payload.error});e?.browserId&&x.recordBrowserActivity(e.browserId,e.pageId)}},onTabMapped:(e,t)=>{if(t.type===`tab:mapped`){let e=C.get(t.payload.pageId);if(!e)return;e.extensionTabId=t.payload.tabId,x.recordBrowserActivity(e.browserId,e.id)}},onDisconnect:e=>{e.sessionId&&S.removeSession(e.sessionId),console.log(`[WebSocket] Extension disconnected: ${e.browserId}`)}});let ee=new te(process.env.PORT_REGISTRY_PATH);console.log(c?` Registry path: ${c}`:` Registry path: default (~/.port-registry/ports.json)`);let D=await ee.reservePort({repositoryPath:s,serviceName:n,serviceType:`tool`,environment:o,preferredPort:t,pid:process.pid,host:r.host,force:!0,portRange:j,metadata:{headless:r.headless,idleTimeout:r.idleTimeout}});if(!D.success||D.port===void 0)throw Error(D.error||`Failed to reserve port in range ${j.min}-${j.max}`);let O=D.port;D.record.metadata={...D.record.metadata,healthCheckUrl:`${p(r.host,O)}/health`};let k=ve({fetch:m.fetch,port:O,hostname:r.host});h(k),await f.reconcileOrphanedBrowsers({currentServerPid:process.pid,currentPort:O,reconnectGraceMs:0}),a=await M({repositoryPath:s,serviceName:n,serviceType:`service`,environment:o,pid:process.pid,port:O,host:r.host,metadata:{healthCheckUrl:`${p(r.host,O)}/health`,headless:r.headless,idleTimeout:r.idleTimeout,transport:`http`}},d);let A=p(r.host,O);console.log(`HTTP server listening on ${A}`),console.log(` Health check: ${A}/health`),console.log(` Execute tool: POST ${A}/execute`),console.log(`
|
|
432
|
-
Press Ctrl+C to stop the server`);let N=async e=>{console.log(`\n\n${e} received. Shutting down gracefully...`);try{T.stop(),k.close(),console.log(`Server closed`);try{await u.get(i.BrowserService).closeAll(),console.log(`All browsers closed`)}catch{}try{a&&await a.release({kill:!1}),console.log(`Service deregistered`)}catch(e){console.error(`Process registry cleanup error:`,e)}console.log(`Goodbye!`),process.exit(0)}catch(e){console.error(`Error during shutdown:`,e),process.exit(1)}};process.on(`SIGINT`,()=>N(`SIGINT`)),process.on(`SIGTERM`,()=>N(`SIGTERM`)),await new Promise(()=>{})}catch(e){if(a)try{await a.release({kill:!1})}catch(e){console.error(`Process registry cleanup error:`,e)}console.error(`Error starting HTTP server:`,e),process.exit(1)}}),sn={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 cn(e){let t=new Set;for(let[n,r]of Object.entries(sn))r.some(t=>e.includes(t))&&t.add(n);return t}const ln=3e3,un=[`browser_launch`],dn=[`browser_new_page`],fn=[`browser_close`],pn=[`browser_close_page`];function mn(e,t){let n=e.replaceAll(`-`,`_`);return t&&(n===`browser_list`||n===`browser_list_session`||n===`browser_list_sessions`)?`browser_list_session`:e.startsWith(`browser-`)||e===`run-spec`||e===`discover-specs`?n:e}function hn(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,closedBrowserId:t.closedBrowserId,closedPageId:t.closedPageId,browserKeptOpen:t.browserKeptOpen}}catch{return null}}async function gn(e){await new Promise(t=>setTimeout(t,e))}async function _n(e){let t=new AbortController,n=setTimeout(()=>t.abort(),ln);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 vn(e,t){let n=new URL(`/custom-tools`,e);return n.searchParams.set(`dir`,t),n.toString()}async function yn(e,t){let n=new AbortController,r=setTimeout(()=>n.abort(),ln);try{let r=await fetch(vn(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 bn(e){let t;for(let n=1;n<=4;n+=1)try{return await _n(e)}catch(e){t=e instanceof Error?e:Error(String(e)),n<4&&await gn(150*n)}throw Error(`Failed to fetch tools after 4 attempts: ${t?.message??`Unknown error`}`,{cause:t})}async function xn(e,t){let n;for(let r=1;r<=4;r+=1)try{return await yn(e,t)}catch(e){n=e instanceof Error?e:Error(String(e)),r<4&&await gn(150*r)}throw Error(`Failed to fetch custom tools after 4 attempts: ${n?.message??`Unknown error`}`,{cause:n})}function Sn(e){if(!e?.tags?.length&&!e?.exclude?.length)return null;let t=e.tags?.length?cn(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 Cn(e){let t=new Map,n=(e,n)=>{let r=t.get(e)??new Set;r.add(n),t.set(e,r)};return e.defaultMode&&n(`browser_launch`,`mode`),e.enforcedProfileName&&n(`browser_launch`,`profileName`),t}function wn(e,t){let n=t.get(e.name);if(!n?.size)return e;let r=e.inputSchema;if(!r.properties||typeof r.properties!=`object`)return e;let i=Object.fromEntries(Object.entries(r.properties).filter(([e])=>!n.has(e))),a={...r,properties:i};return Array.isArray(r.required)&&(a.required=r.required.filter(e=>typeof e!=`string`||!n.has(e))),{...e,inputSchema:a}}function Tn(e){let{httpBaseUrl:t,sessionTracker:n,defaultMode:r,toolFilter:i,customToolsDir:a,enforcedProfileName:o,proxyConfigDir:c,ownerId:l}=e,u=i?.tags?.length?Sn(i):null,f=new Set(i?.exclude??[]),p=u!==null||f.size>0,m=Cn({defaultMode:r,enforcedProfileName:o}),h=new pe({name:`browse-tool`,version:`0.1.0`},{capabilities:{tools:{}}}),g={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}},_=[],v=[],y=new Set;function b(e){return p?e.filter(e=>f.has(e.name)?!1:u===null?!0:u.has(e.name)):e}function x(e){return e.filter(e=>!f.has(e.name))}function S(e){return o?{...e,profileName:o}:e}function C(e){let t=d({proxy:e.proxy,profileName:typeof e.profileName==`string`?e.profileName:void 0,proxyConfigDir:c});if(!t){let t={...e};return delete t.proxy,t}return{...e,proxy:t}}function w(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 T(e){return{name:e.name,description:e.description,inputSchema:e.inputSchema,annotations:e.capabilities}}function E(e){return f.has(e)?!1:u===null?!0:u.has(e)}return h.setRequestHandler(he,async()=>{try{let e=await bn(t);_=e,y=new Set(e.map(e=>e.name));let r=a?await xn(t,a):[];v=r;let i=[...b(e).map(e=>wn(e,m)),...x(r).map(e=>T(e))];return n&&i.push(g),{tools:i}}catch(e){if(_.length>0||v.length>0){console.error(`Failed to refresh tools from HTTP server. Returning cached tools:`,e instanceof Error?e.message:String(e));let t=[...b(_).map(e=>wn(e,m)),...x(v).map(e=>T(e))];return n&&t.push(g),{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})}}),h.setRequestHandler(me,async e=>{let{name:i,arguments:o}=e.params,c=mn(i,!!n),u=new Set(v.map(e=>e.name));if(c!==`browser_list_session`&&!E(c))return{content:[{type:`text`,text:`Tool "${c}" is not available (filtered by --tags or --exclude)`}],isError:!0};if(c===`browser_list_session`&&n){let e=n.getSessionState();return{content:[{type:`text`,text:JSON.stringify(e,null,2)}]}}let d=o||{};c===`browser_launch`&&r&&d.mode===void 0&&(d={...d,mode:r}),c===`browser_launch`&&(d=S(d),d=C(d));try{if(a&&!u.has(c)&&!y.has(c))try{v=await xn(t,a),u=new Set(v.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=u.has(c),r=await fetch(e&&a?vn(t,a):`${t}/execute`,{method:`POST`,headers:l?{"Content-Type":`application/json`,[s]:l}:{"Content-Type":`application/json`},body:JSON.stringify({tool:c,arguments:d})});if(!r.ok){let e=await r.text();return{content:[{type:`text`,text:`HTTP error ${r.status}: ${e}`}],isError:!0}}let i=await r.json();if(!i.success)return{content:[{type:`text`,text:i.error||i.result?.content?.[0]?.text||`Unknown error from HTTP server`}],isError:!0};if(n&&i.result){if(un.includes(c)){let e=hn(i.result);e?.browserId&&(n.trackBrowser(e.browserId,e.mode||`playwright`),e.pageId&&n.trackPage(e.pageId,e.browserId,e.url))}else if(dn.includes(c)){let e=hn(i.result);e?.pageId&&e?.browserId&&n.trackPage(e.pageId,e.browserId,e.url)}else if(fn.includes(c)){let e=hn(i.result);e?.closedBrowserId&&n.untrackBrowser(e.closedBrowserId)}else if(pn.includes(c)){let e=hn(i.result);e?.closedPageId&&n.untrackPage(e.closedPageId),e?.browserId&&e.browserKeptOpen===!1&&n.untrackBrowser(e.browserId)}}return c===`browser_list_profiles`&&i.result?w(i.result):i.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}}}),h}const Q=`stdio`,En=`http`,$=`streamable-http`,Dn=new Set([Q,En,$]),On=`chromium`,kn=new Set([On,`firefox`,`webkit`]),An=new Set([`playwright`,`extension`,`vm`,`stealth`]),jn=`SIGINT`,Mn=`SIGTERM`,Nn=`PLAYWRIGHT_PORT`,Pn=`browse-tool-mcp-http`,Fn=`service`,In=j.min;var Ln=class extends Error{code=`INVALID_TRANSPORT`;recovery=`Use --type ${[...Dn].join(`, `)}`;transportType;constructor(e,t){super(`Unknown transport type: ${e}`,t),this.name=`InvalidTransportError`,this.transportType=e}},Rn=class extends Error{code=`INVALID_BROWSER_TYPE`;recovery=`Use --browser ${[...kn].join(`, `)}`;browserType;constructor(e,t){super(`Unknown browser type: ${e}`,t),this.name=`InvalidBrowserTypeError`,this.browserType=e}},zn=class extends Error{code=`INVALID_LAUNCH_MODE`;recovery=`Use --mode ${[...An].join(`, `)}`;launchMode;constructor(e,t){super(`Unknown launch mode: ${e}`,t),this.name=`InvalidLaunchModeError`,this.launchMode=e}};function Bn(e){let t=e.toLowerCase();if(!kn.has(t))throw new Rn(e);return t}function Vn(e){let t=e.toLowerCase();if(!An.has(t))throw new zn(e);return t}function Hn(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 Un(e){return e!=null&&String(e).trim()!==``}function Wn(e){let t=e.toLowerCase();return t===En?$:t}function Gn(e,t){let n=e[t];return(Array.isArray(n)?n[0]:n)?.trim()||void 0}function Kn(e){return e.split(`,`).map(e=>e.trim()).filter(e=>e.length>0)}function qn(e){let t=e.tags?Kn(e.tags):void 0,n=e.exclude?Kn(e.exclude):void 0;if(!(!t?.length&&!n?.length))return{tags:t,exclude:n}}var Jn=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}},Yn=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}},Xn=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`}},Zn=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 Qn(e,t,n){let r=e.getBrowserIds(),i=[],a;for(let e of r)try{let r=await fetch(`${t}/execute`,{method:`POST`,headers:n?{"Content-Type":`application/json`,[s]:n}:{"Content-Type":`application/json`},body:JSON.stringify({tool:`browser_close`,arguments:{browserId:e}})});if(!r.ok){let e=await r.text().catch(()=>``);throw Error(`HTTP ${r.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),i.push(e),a??=n}if(i.length>0)throw new Jn(i,t,{cause:a});e.clear()}async function $n(e,t,n,r,i){await e.start();let a=!1,o=async o=>{if(a)return;a=!0,console.error(`\nReceived ${o}, shutting down gracefully...`);let s;try{let e=t.getSessionState();e.totalBrowsers>0&&(console.error(` Cleaning up ${e.totalBrowsers} browser(s) from this session...`),await Qn(t,n,r))}catch(e){s=e instanceof Error?e:Error(String(e)),console.error(`Browser cleanup error:`,s)}finally{try{await e.stop()}catch(e){let t=e instanceof Error?e:Error(String(e));console.error(`Transport stop error:`,t),s??=t}try{await i?.()}catch(e){let t=e instanceof Error?e:Error(String(e));console.error(`Process registry cleanup error:`,t),s??=t}if(s){let e=new Yn(o,{cause:s});console.error(`Error during shutdown:`,e),process.exit(1)}process.exit(0)}};process.once(jn,()=>o(jn)),process.once(Mn,()=>o(Mn))}const er=new L(`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: ${[...kn].join(`, `)}`,On).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`,C()).option(`--port <port>`,`Port for streamable HTTP transport`,String(In)).option(`--http-port <port>`,`Port for the inner browse-tool HTTP service`).option(`-p, --profile <name>`,`Default profile name for browser sessions`).option(`-m, --mode <mode>`,`Default launch mode: ${[...An].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(`--chrome-for-testing-path <path>`,`Path to a Chrome for Testing executable for the inner HTTP server`).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`).option(`--proxy-config-dir <path>`,`Custom proxy config directory`).action(async function(t){let n=H(`mcpServe`),r={type:U(this,`type`,t.type,n.type),browser:U(this,`browser`,t.browser,n.browser),headless:U(this,`headless`,t.headless,n.headless),profile:U(this,`profile`,t.profile,n.profile),mode:U(this,`mode`,t.mode,n.mode),host:U(this,`host`,t.host,n.host,process.env.PLAYWRIGHT_HOST),port:U(this,`port`,t.port,n.port,process.env.PLAYWRIGHT_MCP_PORT),httpPort:U(this,`httpPort`,t.httpPort,n.httpPort,process.env[Nn]),tags:U(this,`tags`,t.tags,n.tags),exclude:U(this,`exclude`,t.exclude,n.exclude),customTools:U(this,`customTools`,t.customTools,n.customTools),chromeForTestingPath:U(this,`chromeForTestingPath`,t.chromeForTestingPath,n.chromeForTestingPath,process.env[O]),snippetsDir:U(this,`snippetsDir`,t.snippetsDir,n.snippetsDir),idleTimeout:U(this,`idleTimeout`,t.idleTimeout,n.idleTimeout===void 0?void 0:String(n.idleTimeout),process.env[E]),registryPath:U(this,`registryPath`,t.registryPath,n.registryPath,process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH),registryDir:U(this,`registryDir`,t.registryDir,n.registryDir,process.env.PLAYWRIGHT_REGISTRY_DIR),pidsDir:U(this,`pidsDir`,t.pidsDir,n.pidsDir,process.env.PLAYWRIGHT_PIDS_DIR),profilesDir:U(this,`profilesDir`,t.profilesDir,n.profilesDir,process.env.PLAYWRIGHT_PROFILES_DIR),proxyConfigDir:U(this,`proxyConfigDir`,t.proxyConfigDir,n.proxyConfigDir,process.env[w])},a=Wn(r.type),o=e(),s=process.env.NODE_ENV||`development`,c,l;try{if(!Dn.has(a))throw new Ln(a);let e=Bn(r.browser),t=r.mode?Vn(r.mode):void 0,n=Hn(r.port??In),u=Un(r.httpPort),d=u?Hn(r.httpPort):void 0,f=qn(r),m=r.customTools?P.resolve(r.customTools):void 0,h=r.chromeForTestingPath?P.resolve(r.chromeForTestingPath):void 0,g=r.snippetsDir?P.resolve(r.snippetsDir):void 0;console.error(`Playwright MCP Server starting...`),console.error(` Transport: ${a}`),a===$&&console.error(` MCP endpoint: http://${r.host??C()}:${n}/mcp`),console.error(` Default browser: ${e}`),console.error(` Headless: ${r.headless}`),t&&console.error(` Default mode: ${t}`),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(`, `)}`),m&&console.error(` Custom tools: ${m}`),h&&console.error(` Chrome for Testing path: ${h}`),g&&console.error(` Snippets dir: ${g}`),r.idleTimeout&&console.error(` Idle timeout: ${r.idleTimeout} minutes`);let _=r.registryPath||r.registryDir;_&&(process.env.PLAYWRIGHT_REGISTRY_DIR=_,process.env.PORT_REGISTRY_PATH=_,process.env.PROCESS_REGISTRY_PATH=ne(_,`processes.json`),console.error(` Registry path: ${_}`)),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}`)),r.proxyConfigDir&&(process.env[w]=P.resolve(r.proxyConfigDir),console.error(` Proxy config dir: ${process.env[w]}`)),g&&(process.env.BROWSE_TOOL_SNIPPETS_DIR=g),h&&(process.env[O]=h),r.idleTimeout&&(process.env[E]=r.idleTimeout),r.host&&(process.env.PLAYWRIGHT_HOST=r.host);let v=S(),b=v.get(i.ProcessRegistryService);l=await v.get(i.McpPortAllocationService).acquirePorts({repositoryPath:o,environment:s,host:r.host??C(),pid:process.pid,preferredMcpPort:a===$?n:void 0,preferredHttpPort:d,exactHttpPort:u,reserveMcpPort:a===$,mcpServiceName:Pn,mcpServiceType:`tool`,mcpMetadata:a===$?{healthCheckUrl:`${p(r.host??C(),n)}/health`,transport:$}:void 0});let ee=l.httpPort;process.env[Nn]=ee.toString();let D=await v.get(i.HttpServerManager).ensureRunning(ee,{exactPort:!0});if(!D.running)throw new Xn;let k=p(C(),D.port),A=D.spawned?`spawned`:`reused`;if(console.error(` HTTP server: ${A} on port ${D.port}`),a===Q){let n=new y,i=ue(),a=new x(Tn({httpBaseUrl:k,sessionTracker:n,defaultMode:t,toolFilter:f,customToolsDir:m,enforcedProfileName:r.profile,proxyConfigDir:process.env[w],ownerId:i}));c=await M({repositoryPath:o,serviceName:`browse-tool-mcp`,serviceType:Fn,environment:s,pid:process.pid,metadata:{transport:Q,browser:e,mode:t}},b),await $n(a,n,k,i,async()=>{await c?.release({kill:!1}),await l?.release()});return}let j=l.mcpPort;if(!j)throw Error(`Failed to reserve ${$} port ${n}`);c=await M({repositoryPath:o,serviceName:Pn,serviceType:Fn,environment:s,pid:process.pid,port:j,host:r.host??C(),metadata:{healthCheckUrl:`${p(r.host??C(),j)}/health`,transport:$}},b);let te=new T(({headers:e})=>{let n=Gn(e,`x-profile`)??r.profile,i=new y,a=ue();return{server:Tn({httpBaseUrl:k,sessionTracker:i,defaultMode:t,toolFilter:f,customToolsDir:m,enforcedProfileName:n,proxyConfigDir:process.env[w],ownerId:a}),onClose:async()=>{i.getSessionState().totalBrowsers>0&&await Qn(i,k,a)}}},{host:r.host??C(),port:j});try{await te.start()}catch(e){try{await c.release({kill:!1})}catch(e){console.error(`Process registry cleanup error:`,e)}throw await l.release(),l=void 0,e}let N=!1,re=async e=>{if(!N){N=!0,console.error(`\nReceived ${e}, shutting down gracefully...`);try{await te.stop();try{await c?.release({kill:!1})}catch(e){console.error(`Process registry cleanup error:`,e)}await l?.release(),l=void 0,process.exit(0)}catch(e){console.error(`Transport stop error:`,e),process.exit(1)}}};process.once(jn,()=>re(jn)),process.once(Mn,()=>re(Mn))}catch(e){if(c)try{await c.release({kill:!1})}catch(e){console.error(`Process registry cleanup error:`,e)}if(l)try{await l.release()}catch(e){console.error(`Port allocation cleanup error:`,e)}(e instanceof Ln||e instanceof Rn||e instanceof zn||e instanceof Xn)&&(console.error(`Error [${e.code}]: ${e.message}`),console.error(`Recovery: ${e.recovery}`),process.exit(1));let t=new Zn({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)}}),tr=new L(`status`).description(`Show status of HTTP server and diagnostics`).action(async()=>{try{let e=H(`httpServe`),t=process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH??e.registryPath??e.registryDir;t&&(process.env.PLAYWRIGHT_REGISTRY_DIR=t,process.env.PLAYWRIGHT_REGISTRY_PATH=t,process.env.PORT_REGISTRY_PATH=t),!process.env.PLAYWRIGHT_PIDS_DIR&&e.pidsDir&&(process.env.PLAYWRIGHT_PIDS_DIR=e.pidsDir),console.log(`browse-tool Status
|
|
433
|
-
`),console.log(`-`.repeat(50));let n=await g().get(i.HttpServerManager).getStatus();if(n.running){let t=process.env.PLAYWRIGHT_HOST??e.host??C();console.log(`HTTP Server: Running`),console.log(` PID: ${n.pid}`),console.log(` Port: ${n.port}`),console.log(` Health: ${p(t,n.port)}/health`),n.browserCount!==void 0&&console.log(` Browsers: ${n.browserCount}`)}else console.log(`HTTP Server: Not Running`),n.error&&console.log(` Error: ${n.error}`);console.log(``),console.log(`-`.repeat(50)),process.exit(0)}catch(e){console.error(`Error getting status:`,e),process.exit(1)}}),
|
|
434
|
-
`)}}function
|
|
431
|
+
`)})]}),R(`body`,{children:t})]})}function $t(e){let t=new L;return t.get(`/`,async t=>{try{let n=e.get(i.BrowserService),r=e.get(i.PageRegistry),a=n.listBrowsers(),o=r.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 t.html(R(Qt,{title:`Playwright MCP Dashboard`,children:R(Zt,{browsers:s,stats:c})}))}catch(e){return console.error(`Failed to render dashboard:`,e),t.html(R(Qt,{title:`Playwright MCP Dashboard - Error`,children:z(`div`,{style:`padding: 2rem; text-align: center;`,children:[R(`h1`,{children:`Failed to load dashboard`}),R(`p`,{children:e instanceof Error?e.message:String(e)}),R(`a`,{href:`/`,style:`color: #2196f3; text-decoration: underline;`,children:`Retry`})]})}),500)}}),t}function en(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 tn(e){let t=e.structuredContent?.error;if(!(typeof t!=`object`||!t||!(`code`in t)||typeof t.code!=`string`||!(`retryable`in t)||typeof t.retryable!=`boolean`||!(`targetState`in t)||typeof t.targetState!=`string`||!(`retryAfterMs`in t)||typeof t.retryAfterMs!=`number`))return{code:t.code,retryable:t.retryable,targetKey:`targetKey`in t&&typeof t.targetKey==`string`?t.targetKey:void 0,targetState:t.targetState,retryAfterMs:t.retryAfterMs}}function nn(e){try{return e.get(i.TelemetryService)}catch{return new m}}function rn(e){return e.startsWith(`browser-`)||e===`run-spec`||e===`discover-specs`?e.replaceAll(`-`,`_`):e}function an(e){return{browser_console_logs:`browser_list_console_messages`,browser_console_messages:`browser_list_console_messages`,browser_evaluate:`browser_evaluate_script`,browser_get_console_logs:`browser_list_console_messages`,browser_resize:`browser_resize_page`,browser_take_screenshot:`browser_screenshot`,browser_list_session:`browser_list_pages`}[e]}function on(e){let t=new L,n=e.get(i.PageRegistry),r=e.get(i.BrowserService),o=e.get(i.ExtensionTaskQueue),c=nn(e),l=new Ft(n,o,c,r);t.use(`*`,be({origin:e=>e??null,credentials:!0,allowMethods:[`GET`,`POST`,`DELETE`,`OPTIONS`],allowHeaders:[`Content-Type`,`Accept`,`Authorization`]})),t.get(`/health`,e=>{try{let t=r.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)}}),t.post(`/execute`,async t=>{try{let r=await t.req.json();if(!r.tool)return t.json({success:!1,error:`Missing "tool" field in request body`},400);let o=typeof r.arguments?.pageId==`string`?r.arguments.pageId:void 0;return await c.runInSpan(`browse_tool.http.execute`,{attributes:{"http.method":`POST`,"http.route":`/execute`,"browse_tool.tool.name":r.tool,"browse_tool.page.id":o}},async o=>{let l=e.getAll(i.Tool),u=rn(r.tool),d=l.find(e=>e.getDefinition().name===u);if(process.env.BROWSE_TOOL_DEBUG_EXTENSION_RECORDING===`1`&&r.tool===`browser_launch`){let e=typeof r.arguments?.videoDir==`string`?r.arguments.videoDir:typeof r.arguments?.video_dir==`string`?r.arguments.video_dir:``;console.log(`[ExtensionRecordingDebug] http execute browser_launch mode=${String(r.arguments?.mode??``)} videoDir=${e}`)}if(!d){let e=an(u),n=e?`Tool "${r.tool}" not found. Use "${e}" instead.`:`Tool "${r.tool}" not found`;return o?.setStatus({code:F.ERROR,message:n}),c.log(`warn`,`browse-tool HTTP execute rejected unknown tool`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":r.tool,"browse_tool.tool.normalized_name":u,"browse_tool.tool.suggested_name":e}}),t.json({success:!1,error:n},404)}let f=r.arguments||{},p;try{p=d.getInputSchema().parse(fe(f,d.getInputSchema()))}catch(e){if(e instanceof P.ZodError){let n=pe(e,{schemaName:u,schema:d.getInputSchema()});return o?.setStatus({code:F.ERROR,message:n}),t.json({success:!1,result:{content:[{type:`text`,text:n}],isError:!0},error:n})}throw e}let m=await a(t.req.header(s),()=>d.execute(p)),h=p,g=typeof h.pageId==`string`?h.pageId:void 0;if(g){let t=e.get(i.BrowserService),r=n.get(g);r&&t.recordBrowserActivity(r.browserId,g)}let _=en(m);if(_){let e=tn(m),t=e?{"browser.error.code":e.code,"browser.error.retryable":e.retryable,"browser.error.retry_after_ms":e.retryAfterMs,"browser.target.key":e.targetKey,"browser.target.state":e.targetState}:{};o?.setAttributes(t),o?.setStatus({code:F.ERROR,message:_}),c.log(`warn`,`browse-tool HTTP execute returned tool error`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":u,"browse_tool.page.id":g,"tool.result.error":!0,"tool.name":u,"error.message":_,...t}})}else c.log(`debug`,`browse-tool HTTP execute succeeded`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":u,"browse_tool.page.id":g}});return t.json({success:!m.isError,result:m,error:_})})}catch(e){return c.log(`error`,`browse-tool HTTP execute request crashed`,{attributes:{"http.route":`/execute`},exception:e}),t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.get(`/browsers`,t=>{try{let n=e.get(i.BrowserService).listBrowsers();return t.json({browsers:n.map(e=>({id:e.id,profileName:e.profileName,pageIds:Array.from(e.pageIds),currentPageId:e.currentPageId,createdAt:e.createdAt.toISOString()}))})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}}),t.get(`/tools`,t=>{try{let n=e.getAll(i.Tool);return t.json({tools:n.map(e=>e.getDefinition())})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}}),t.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 l.listTools(t);return e.json({tools:n})}catch(t){return e.json({tools:[],error:t instanceof Error?t.message:String(t)},400)}}),t.post(`/custom-tools`,async t=>{let r=t.req.query(`dir`);if(!r)return t.json({success:!1,error:`Missing "dir" query parameter`},400);try{let o=await t.req.json();if(!o.tool)return t.json({success:!1,error:`Missing "tool" field in request body`},400);let u=typeof o.arguments?.pageId==`string`?o.arguments.pageId:void 0;return await c.runInSpan(`browse_tool.http.custom_tool.execute`,{attributes:{"http.method":`POST`,"http.route":`/custom-tools`,"browse_tool.tool.name":o.tool,"browse_tool.page.id":u,"browse_tool.custom_tools.directory":r}},async d=>{let f=await a(t.req.header(s),()=>l.executeTool(r,o.tool,o.arguments||{}));if(u){let t=e.get(i.BrowserService),r=n.get(u);r&&t.recordBrowserActivity(r.browserId,u)}let p=en(f);return p?(d?.setStatus({code:F.ERROR,message:p}),c.log(`warn`,`browse-tool custom tool execution returned tool error`,{attributes:{"http.route":`/custom-tools`,"browse_tool.tool.name":o.tool,"browse_tool.page.id":u,"tool.result.error":!0,"tool.name":o.tool,"error.message":p}})):c.log(`debug`,`browse-tool custom tool execution succeeded`,{attributes:{"http.route":`/custom-tools`,"browse_tool.tool.name":o.tool,"browse_tool.page.id":u}}),t.json({success:!f.isError,result:f,error:p})})}catch(e){return c.log(`error`,`browse-tool custom tool request crashed`,{attributes:{"http.route":`/custom-tools`,"browse_tool.custom_tools.directory":r},exception:e}),t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}});let u=De(e);t.route(`/extension`,u);let d=It(e);t.route(`/api`,d);let f=$t(e);return t.route(`/`,f),t}function sn(e,t,n){e.get(`/ws/extension/:browserId`,n(e=>{let n=e.req.param(`browserId`),r=null;return{onOpen(e,a){if(!n){a.close(1008,`Missing browserId`);return}try{r=t.get(i.WebSocketHub).addConnection(a,n)}catch{a.close(1011,`Internal server error`)}},onMessage(e){if(r)try{let n=t.get(i.WebSocketHub),a=typeof e.data==`string`?e.data:e.data.toString();n.handleMessage(r,a)}catch{}},onClose(){if(r)try{t.get(i.WebSocketHub).removeConnection(r)}catch{}},onError(){if(r)try{t.get(i.WebSocketHub).removeConnection(r)}catch{}}}})),e.get(`/ws/stats`,e=>{try{let n=t.get(i.WebSocketHub).getStats();return e.json({totalConnections:n.totalConnections,browserCount:n.browserCount,connections:n.connections.map(e=>({id:e.id,browserId:e.browserId,connectedAt:e.connectedAt.toISOString()}))})}catch(t){return e.json({error:t instanceof Error?t.message:String(t)},500)}})}const cn=new I(`http-serve`).description(`Start HTTP server for browser automation`).option(`-p, --port <port>`,`Port to listen on`,String(f)).option(`--host <host>`,`Host to bind`,C()).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`).option(`--proxy-config-dir <path>`,`Custom proxy config directory`).option(`--workspace-root <path>`,`Canonical workspace root for registry scoping (${v})`).action(async function(t){let n=V(`httpServe`),r={port:H(this,`port`,t.port,n.port===void 0?void 0:String(n.port),process.env.PLAYWRIGHT_PORT),headless:H(this,`headless`,t.headless,n.headless),idleTimeout:H(this,`idleTimeout`,t.idleTimeout,n.idleTimeout===void 0?void 0:String(n.idleTimeout),process.env[E]),host:H(this,`host`,t.host,n.host,process.env.PLAYWRIGHT_HOST),registryDir:H(this,`registryDir`,t.registryDir,n.registryDir,process.env.PLAYWRIGHT_REGISTRY_DIR),registryPath:H(this,`registryPath`,t.registryPath,n.registryPath,process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH),pidsDir:H(this,`pidsDir`,t.pidsDir,n.pidsDir,process.env.PLAYWRIGHT_PIDS_DIR),profilesDir:H(this,`profilesDir`,t.profilesDir,n.profilesDir,process.env.PLAYWRIGHT_PROFILES_DIR),snippetsDir:H(this,`snippetsDir`,t.snippetsDir,n.snippetsDir,process.env.BROWSE_TOOL_SNIPPETS_DIR),proxyConfigDir:H(this,`proxyConfigDir`,t.proxyConfigDir,n.proxyConfigDir,process.env[w]),workspaceRoot:H(this,`workspaceRoot`,t.workspaceRoot,n.workspaceRoot,process.env[v])},a;try{let t=Number.parseInt(r.port,10),n=`browse-tool-http`,o=process.env.NODE_ENV||`development`,s=_(e({startPath:process.cwd(),env:{...process.env,[v]:r.workspaceRoot}})),c=r.registryPath||r.registryDir||process.env.PLAYWRIGHT_REGISTRY_PATH;c&&(process.env.PLAYWRIGHT_REGISTRY_DIR=c,process.env.PORT_REGISTRY_PATH=c,process.env.PROCESS_REGISTRY_PATH=re(c,`processes.json`)),process.env.PLAYWRIGHT_HOST=r.host,process.env.PLAYWRIGHT_PORT=r.port,process.env[E]=r.idleTimeout,r.pidsDir&&(process.env.PLAYWRIGHT_PIDS_DIR=r.pidsDir),r.profilesDir&&(process.env.PLAYWRIGHT_PROFILES_DIR=r.profilesDir),r.snippetsDir&&(process.env.BROWSE_TOOL_SNIPPETS_DIR=N.resolve(r.snippetsDir)),r.proxyConfigDir&&(process.env[w]=N.resolve(r.proxyConfigDir)),console.log(`Starting HTTP server for browser automation...`),console.log(` Port: ${t}`),console.log(` Host: ${r.host}`),console.log(` Headless: ${r.headless}`),console.log(` Idle Timeout: ${r.idleTimeout} minutes`),process.env.BROWSE_TOOL_SNIPPETS_DIR&&console.log(` Snippets Dir: ${process.env.BROWSE_TOOL_SNIPPETS_DIR}`),process.env.BROWSE_TOOL_PROXY_CONFIG_DIR&&console.log(` Proxy Config Dir: ${process.env[w]}`);let u=l(),d=u.get(i.ProcessRegistryService),f=u.get(i.BrowserProcessRegistry),m=on(u),{injectWebSocket:h,upgradeWebSocket:g}=xe({app:m});sn(m,u,g);let y=u.get(i.WebSocketHub),b=u.get(i.ExtensionTaskQueue),x=u.get(i.BrowserService),S=u.get(i.ExtensionSessionRegistry),C=u.get(i.PageRegistry),T=u.get(i.IdleCleanupService);T.start(),y.setEventHandlers({onSessionRegister:(e,t)=>{if(t.type===`session:register`){let n=t.payload.browserId||e.browserId,r=x.getBrowser(n),i,a;if(r&&(r.mode===`extension`||r.mode===`vm`)){i=r.id;let t=C.findByBrowser(i);a=r.currentPageId||t[0]?.id||``,y.reassignConnection(e.id,i),a||(a=C.registerExtensionPage(i),r.pageIds.add(a),r.currentPageId=a),console.log(`[WebSocket] Extension connected to existing browser: ${i}, pageId: ${a}`)}else{i=n,x.registerExtensionBrowserWithId(i),a=C.registerExtensionPage(i);let e=x.getBrowser(i);e&&(e.pageIds.add(a),e.currentPageId=a),console.log(`[WebSocket] Extension connected with new browser: ${i}, pageId: ${a}`)}let o=C.get(a);o&&(o.extensionTabId=t.payload.tabId,o.url=t.payload.url??o.url);let s=S.register({browserId:i,tabId:t.payload.tabId,url:t.payload.url,metadata:{transport:`websocket`}});y.sendSessionAck(e,t.id??``,s.id,s.controlMode),y.broadcastPageCreated(i,a,C.get(a)?.url)}},onTaskResult:(e,t)=>{if(t.type===`task:result`){let e=b.submitResult({taskId:t.payload.taskId,success:t.payload.success,result:t.payload.result,error:t.payload.error});e?.browserId&&x.recordBrowserActivity(e.browserId,e.pageId)}},onTabMapped:(e,t)=>{if(t.type===`tab:mapped`){let e=C.get(t.payload.pageId);if(!e)return;e.extensionTabId=t.payload.tabId,x.recordBrowserActivity(e.browserId,e.id)}},onDisconnect:e=>{e.sessionId&&S.removeSession(e.sessionId),console.log(`[WebSocket] Extension disconnected: ${e.browserId}`)}});let ee=new te(process.env.PORT_REGISTRY_PATH);console.log(c?` Registry path: ${c}`:` Registry path: default (~/.port-registry/ports.json)`);let D=await ee.reservePort({repositoryPath:s,serviceName:n,serviceType:`tool`,environment:o,preferredPort:t,pid:process.pid,host:r.host,force:!0,portRange:j,metadata:{headless:r.headless,idleTimeout:r.idleTimeout}});if(!D.success||D.port===void 0)throw Error(D.error||`Failed to reserve port in range ${j.min}-${j.max}`);let O=D.port;D.record.metadata={...D.record.metadata,healthCheckUrl:`${p(r.host,O)}/health`};let k=ye({fetch:m.fetch,port:O,hostname:r.host});h(k),await f.reconcileOrphanedBrowsers({currentServerPid:process.pid,currentPort:O,reconnectGraceMs:0}),a=await ne({repositoryPath:s,serviceName:n,serviceType:`service`,environment:o,pid:process.pid,port:O,host:r.host,metadata:{healthCheckUrl:`${p(r.host,O)}/health`,headless:r.headless,idleTimeout:r.idleTimeout,transport:`http`}},d);let A=p(r.host,O);console.log(`HTTP server listening on ${A}`),console.log(` Health check: ${A}/health`),console.log(` Execute tool: POST ${A}/execute`),console.log(`
|
|
432
|
+
Press Ctrl+C to stop the server`);let M=async e=>{console.log(`\n\n${e} received. Shutting down gracefully...`);try{T.stop(),k.close(),console.log(`Server closed`);try{await u.get(i.BrowserService).closeAll(),console.log(`All browsers closed`)}catch{}try{a&&await a.release({kill:!1}),console.log(`Service deregistered`)}catch(e){console.error(`Process registry cleanup error:`,e)}console.log(`Goodbye!`),process.exit(0)}catch(e){console.error(`Error during shutdown:`,e),process.exit(1)}};process.on(`SIGINT`,()=>M(`SIGINT`)),process.on(`SIGTERM`,()=>M(`SIGTERM`)),await new Promise(()=>{})}catch(e){if(a)try{await a.release({kill:!1})}catch(e){console.error(`Process registry cleanup error:`,e)}console.error(`Error starting HTTP server:`,e),process.exit(1)}}),ln={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 un(e){let t=new Set;for(let[n,r]of Object.entries(ln))r.some(t=>e.includes(t))&&t.add(n);return t}const dn=3e3,fn=[`browser_launch`],pn=[`browser_new_page`],mn=[`browser_close`],hn=[`browser_close_page`];function gn(e,t){let n=e.replaceAll(`-`,`_`);return t&&(n===`browser_list`||n===`browser_list_session`||n===`browser_list_sessions`)?`browser_list_session`:e.startsWith(`browser-`)||e===`run-spec`||e===`discover-specs`?n:e}function _n(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,closedBrowserId:t.closedBrowserId,closedPageId:t.closedPageId,browserKeptOpen:t.browserKeptOpen}}catch{return null}}async function vn(e){await new Promise(t=>setTimeout(t,e))}async function yn(e){let t=new AbortController,n=setTimeout(()=>t.abort(),dn);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 bn(e,t){let n=new URL(`/custom-tools`,e);return n.searchParams.set(`dir`,t),n.toString()}async function xn(e,t){let n=new AbortController,r=setTimeout(()=>n.abort(),dn);try{let r=await fetch(bn(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 Sn(e){let t;for(let n=1;n<=4;n+=1)try{return await yn(e)}catch(e){t=e instanceof Error?e:Error(String(e)),n<4&&await vn(150*n)}throw Error(`Failed to fetch tools after 4 attempts: ${t?.message??`Unknown error`}`,{cause:t})}async function Cn(e,t){let n;for(let r=1;r<=4;r+=1)try{return await xn(e,t)}catch(e){n=e instanceof Error?e:Error(String(e)),r<4&&await vn(150*r)}throw Error(`Failed to fetch custom tools after 4 attempts: ${n?.message??`Unknown error`}`,{cause:n})}function wn(e){if(!e?.tags?.length&&!e?.exclude?.length)return null;let t=e.tags?.length?un(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 t=new Map,n=(e,n)=>{let r=t.get(e)??new Set;r.add(n),t.set(e,r)};return e.defaultMode&&n(`browser_launch`,`mode`),e.enforcedProfileName&&n(`browser_launch`,`profileName`),t}function En(e,t){let n=t.get(e.name);if(!n?.size)return e;let r=e.inputSchema;if(!r.properties||typeof r.properties!=`object`)return e;let i=Object.fromEntries(Object.entries(r.properties).filter(([e])=>!n.has(e))),a={...r,properties:i};return Array.isArray(r.required)&&(a.required=r.required.filter(e=>typeof e!=`string`||!n.has(e))),{...e,inputSchema:a}}function Dn(e){let{httpBaseUrl:t,sessionTracker:n,defaultMode:r,toolFilter:i,customToolsDir:a,enforcedProfileName:o,proxyConfigDir:c,ownerId:l}=e,u=i?.tags?.length?wn(i):null,f=new Set(i?.exclude??[]),p=u!==null||f.size>0,m=Tn({defaultMode:r,enforcedProfileName:o}),h=new me({name:`browse-tool`,version:`0.1.0`},{capabilities:{tools:{}}}),g={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}},_=[],v=[],y=new Set;function b(e){return p?e.filter(e=>f.has(e.name)?!1:u===null?!0:u.has(e.name)):e}function x(e){return e.filter(e=>!f.has(e.name))}function S(e){return o?{...e,profileName:o}:e}function C(e){let t=d({proxy:e.proxy,profileName:typeof e.profileName==`string`?e.profileName:void 0,proxyConfigDir:c});if(!t){let t={...e};return delete t.proxy,t}return{...e,proxy:t}}function w(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 T(e){return{name:e.name,description:e.description,inputSchema:e.inputSchema,annotations:e.capabilities}}function E(e){return f.has(e)?!1:u===null?!0:u.has(e)}return h.setRequestHandler(ge,async()=>{try{let e=await Sn(t);_=e,y=new Set(e.map(e=>e.name));let r=a?await Cn(t,a):[];v=r;let i=[...b(e).map(e=>En(e,m)),...x(r).map(e=>T(e))];return n&&i.push(g),{tools:i}}catch(e){if(_.length>0||v.length>0){console.error(`Failed to refresh tools from HTTP server. Returning cached tools:`,e instanceof Error?e.message:String(e));let t=[...b(_).map(e=>En(e,m)),...x(v).map(e=>T(e))];return n&&t.push(g),{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})}}),h.setRequestHandler(he,async e=>{let{name:i,arguments:o}=e.params,c=gn(i,!!n),u=new Set(v.map(e=>e.name));if(c!==`browser_list_session`&&!E(c))return{content:[{type:`text`,text:`Tool "${c}" is not available (filtered by --tags or --exclude)`}],isError:!0};if(c===`browser_list_session`&&n){let e=n.getSessionState();return{content:[{type:`text`,text:JSON.stringify(e,null,2)}]}}let d=o||{};c===`browser_launch`&&r&&d.mode===void 0&&(d={...d,mode:r}),c===`browser_launch`&&(d=S(d),d=C(d));try{if(a&&!u.has(c)&&!y.has(c))try{v=await Cn(t,a),u=new Set(v.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=u.has(c),r=await fetch(e&&a?bn(t,a):`${t}/execute`,{method:`POST`,headers:l?{"Content-Type":`application/json`,[s]:l}:{"Content-Type":`application/json`},body:JSON.stringify({tool:c,arguments:d})});if(!r.ok){let e=await r.text();return{content:[{type:`text`,text:`HTTP error ${r.status}: ${e}`}],isError:!0}}let i=await r.json();if(!i.success)return{content:[{type:`text`,text:i.error||i.result?.content?.[0]?.text||`Unknown error from HTTP server`}],isError:!0};if(n&&i.result){if(fn.includes(c)){let e=_n(i.result);e?.browserId&&(n.trackBrowser(e.browserId,e.mode||`playwright`),e.pageId&&n.trackPage(e.pageId,e.browserId,e.url))}else if(pn.includes(c)){let e=_n(i.result);e?.pageId&&e?.browserId&&n.trackPage(e.pageId,e.browserId,e.url)}else if(mn.includes(c)){let e=_n(i.result);e?.closedBrowserId&&n.untrackBrowser(e.closedBrowserId)}else if(hn.includes(c)){let e=_n(i.result);e?.closedPageId&&n.untrackPage(e.closedPageId),e?.browserId&&e.browserKeptOpen===!1&&n.untrackBrowser(e.browserId)}}return c===`browser_list_profiles`&&i.result?w(i.result):i.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}}}),h}const Z=`stdio`,On=`http`,Q=`streamable-http`,kn=new Set([Z,On,Q]),An=`chromium`,jn=new Set([An,`firefox`,`webkit`]),Mn=new Set([`playwright`,`extension`,`vm`,`stealth`]),Nn=`SIGINT`,Pn=`SIGTERM`,Fn=`PLAYWRIGHT_PORT`,In=`browse-tool-mcp-http`,Ln=`service`,Rn=j.min;var zn=class extends Error{code=`INVALID_TRANSPORT`;recovery=`Use --type ${[...kn].join(`, `)}`;transportType;constructor(e,t){super(`Unknown transport type: ${e}`,t),this.name=`InvalidTransportError`,this.transportType=e}},Bn=class extends Error{code=`INVALID_BROWSER_TYPE`;recovery=`Use --browser ${[...jn].join(`, `)}`;browserType;constructor(e,t){super(`Unknown browser type: ${e}`,t),this.name=`InvalidBrowserTypeError`,this.browserType=e}},Vn=class extends Error{code=`INVALID_LAUNCH_MODE`;recovery=`Use --mode ${[...Mn].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(!jn.has(t))throw new Bn(e);return t}function Un(e){let t=e.toLowerCase();if(!Mn.has(t))throw new Vn(e);return t}function Wn(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 Gn(e){return e!=null&&String(e).trim()!==``}function Kn(e){let t=e.toLowerCase();return t===On?Q:t}function qn(e,t){let n=e[t];return(Array.isArray(n)?n[0]:n)?.trim()||void 0}function Jn(e){return e.split(`,`).map(e=>e.trim()).filter(e=>e.length>0)}function Yn(e){let t=e.tags?Jn(e.tags):void 0,n=e.exclude?Jn(e.exclude):void 0;if(!(!t?.length&&!n?.length))return{tags:t,exclude:n}}var Xn=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}},Zn=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}},Qn=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`}},$n=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 er(e,t,n){let r=e.getBrowserIds(),i=[],a;for(let e of r)try{let r=await fetch(`${t}/execute`,{method:`POST`,headers:n?{"Content-Type":`application/json`,[s]:n}:{"Content-Type":`application/json`},body:JSON.stringify({tool:`browser_close`,arguments:{browserId:e}})});if(!r.ok){let e=await r.text().catch(()=>``);throw Error(`HTTP ${r.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),i.push(e),a??=n}if(i.length>0)throw new Xn(i,t,{cause:a});e.clear()}async function tr(e,t,n,r,i){await e.start();let a=!1,o=async o=>{if(a)return;a=!0,console.error(`\nReceived ${o}, shutting down gracefully...`);let s;try{let e=t.getSessionState();e.totalBrowsers>0&&(console.error(` Cleaning up ${e.totalBrowsers} browser(s) from this session...`),await er(t,n,r))}catch(e){s=e instanceof Error?e:Error(String(e)),console.error(`Browser cleanup error:`,s)}finally{try{await e.stop()}catch(e){let t=e instanceof Error?e:Error(String(e));console.error(`Transport stop error:`,t),s??=t}try{await i?.()}catch(e){let t=e instanceof Error?e:Error(String(e));console.error(`Process registry cleanup error:`,t),s??=t}if(s){let e=new Zn(o,{cause:s});console.error(`Error during shutdown:`,e),process.exit(1)}process.exit(0)}};process.once(Nn,()=>o(Nn)),process.once(Pn,()=>o(Pn))}const nr=new I(`mcp-serve`).description(`Start Playwright MCP server for browser automation`).option(`-t, --type <type>`,`Transport type: ${[Z,Q].join(`, `)}`,Z).option(`-b, --browser <browser>`,`Default browser type: ${[...jn].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`,C()).option(`--port <port>`,`Port for streamable HTTP transport`,String(Rn)).option(`--http-port <port>`,`Port for the inner browse-tool HTTP service`).option(`-p, --profile <name>`,`Default profile name for browser sessions`).option(`-m, --mode <mode>`,`Default launch mode: ${[...Mn].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(`--chrome-for-testing-path <path>`,`Path to a Chrome for Testing executable for the inner HTTP server`).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`).option(`--proxy-config-dir <path>`,`Custom proxy config directory`).action(async function(t){let n=V(`mcpServe`),r={type:H(this,`type`,t.type,n.type),browser:H(this,`browser`,t.browser,n.browser),headless:H(this,`headless`,t.headless,n.headless),profile:H(this,`profile`,t.profile,n.profile),mode:H(this,`mode`,t.mode,n.mode),host:H(this,`host`,t.host,n.host,process.env.PLAYWRIGHT_HOST),port:H(this,`port`,t.port,n.port,process.env.PLAYWRIGHT_MCP_PORT),httpPort:H(this,`httpPort`,t.httpPort,n.httpPort,process.env[Fn]),tags:H(this,`tags`,t.tags,n.tags),exclude:H(this,`exclude`,t.exclude,n.exclude),customTools:H(this,`customTools`,t.customTools,n.customTools),chromeForTestingPath:H(this,`chromeForTestingPath`,t.chromeForTestingPath,n.chromeForTestingPath,process.env[O]),snippetsDir:H(this,`snippetsDir`,t.snippetsDir,n.snippetsDir),idleTimeout:H(this,`idleTimeout`,t.idleTimeout,n.idleTimeout===void 0?void 0:String(n.idleTimeout),process.env[E]),registryPath:H(this,`registryPath`,t.registryPath,n.registryPath,process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH),registryDir:H(this,`registryDir`,t.registryDir,n.registryDir,process.env.PLAYWRIGHT_REGISTRY_DIR),pidsDir:H(this,`pidsDir`,t.pidsDir,n.pidsDir,process.env.PLAYWRIGHT_PIDS_DIR),profilesDir:H(this,`profilesDir`,t.profilesDir,n.profilesDir,process.env.PLAYWRIGHT_PROFILES_DIR),proxyConfigDir:H(this,`proxyConfigDir`,t.proxyConfigDir,n.proxyConfigDir,process.env[w])},a=Kn(r.type),o=e(),s=process.env.NODE_ENV||`development`,c,l;try{if(!kn.has(a))throw new zn(a);let e=Hn(r.browser),t=r.mode?Un(r.mode):void 0,n=Wn(r.port??Rn),u=Gn(r.httpPort),d=u?Wn(r.httpPort):void 0,f=Yn(r),m=r.customTools?N.resolve(r.customTools):void 0,h=r.chromeForTestingPath?N.resolve(r.chromeForTestingPath):void 0,g=r.snippetsDir?N.resolve(r.snippetsDir):void 0;console.error(`Playwright MCP Server starting...`),console.error(` Transport: ${a}`),a===Q&&console.error(` MCP endpoint: http://${r.host??C()}:${n}/mcp`),console.error(` Default browser: ${e}`),console.error(` Headless: ${r.headless}`),t&&console.error(` Default mode: ${t}`),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(`, `)}`),m&&console.error(` Custom tools: ${m}`),h&&console.error(` Chrome for Testing path: ${h}`),g&&console.error(` Snippets dir: ${g}`),r.idleTimeout&&console.error(` Idle timeout: ${r.idleTimeout} minutes`);let _=r.registryPath||r.registryDir;_&&(process.env.PLAYWRIGHT_REGISTRY_DIR=_,process.env.PORT_REGISTRY_PATH=_,process.env.PROCESS_REGISTRY_PATH=re(_,`processes.json`),console.error(` Registry path: ${_}`)),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}`)),r.proxyConfigDir&&(process.env[w]=N.resolve(r.proxyConfigDir),console.error(` Proxy config dir: ${process.env[w]}`)),g&&(process.env.BROWSE_TOOL_SNIPPETS_DIR=g),h&&(process.env[O]=h),r.idleTimeout&&(process.env[E]=r.idleTimeout),r.host&&(process.env.PLAYWRIGHT_HOST=r.host);let v=S(),b=v.get(i.ProcessRegistryService);l=await v.get(i.McpPortAllocationService).acquirePorts({repositoryPath:o,environment:s,host:r.host??C(),pid:process.pid,preferredMcpPort:a===Q?n:void 0,preferredHttpPort:d,exactHttpPort:u,reserveMcpPort:a===Q,mcpServiceName:In,mcpServiceType:`tool`,mcpMetadata:a===Q?{healthCheckUrl:`${p(r.host??C(),n)}/health`,transport:Q}:void 0});let ee=l.httpPort;process.env[Fn]=ee.toString();let D=await v.get(i.HttpServerManager).ensureRunning(ee,{exactPort:!0});if(!D.running)throw new Qn;let k=p(C(),D.port),A=D.spawned?`spawned`:`reused`;if(console.error(` HTTP server: ${A} on port ${D.port}`),a===Z){let n=new y,i=de(),a=new x(Dn({httpBaseUrl:k,sessionTracker:n,defaultMode:t,toolFilter:f,customToolsDir:m,enforcedProfileName:r.profile,proxyConfigDir:process.env[w],ownerId:i}));c=await ne({repositoryPath:o,serviceName:`browse-tool-mcp`,serviceType:Ln,environment:s,pid:process.pid,metadata:{transport:Z,browser:e,mode:t}},b),await tr(a,n,k,i,async()=>{await c?.release({kill:!1}),await l?.release()});return}let j=l.mcpPort;if(!j)throw Error(`Failed to reserve ${Q} port ${n}`);c=await ne({repositoryPath:o,serviceName:In,serviceType:Ln,environment:s,pid:process.pid,port:j,host:r.host??C(),metadata:{healthCheckUrl:`${p(r.host??C(),j)}/health`,transport:Q}},b);let te=new T(({headers:e})=>{let n=qn(e,`x-profile`)??r.profile,i=new y,a=de();return{server:Dn({httpBaseUrl:k,sessionTracker:i,defaultMode:t,toolFilter:f,customToolsDir:m,enforcedProfileName:n,proxyConfigDir:process.env[w],ownerId:a}),onClose:async()=>{i.getSessionState().totalBrowsers>0&&await er(i,k,a)}}},{host:r.host??C(),port:j});try{await te.start()}catch(e){try{await c.release({kill:!1})}catch(e){console.error(`Process registry cleanup error:`,e)}throw await l.release(),l=void 0,e}let M=!1,ie=async e=>{if(!M){M=!0,console.error(`\nReceived ${e}, shutting down gracefully...`);try{await te.stop();try{await c?.release({kill:!1})}catch(e){console.error(`Process registry cleanup error:`,e)}await l?.release(),l=void 0,process.exit(0)}catch(e){console.error(`Transport stop error:`,e),process.exit(1)}}};process.once(Nn,()=>ie(Nn)),process.once(Pn,()=>ie(Pn))}catch(e){if(c)try{await c.release({kill:!1})}catch(e){console.error(`Process registry cleanup error:`,e)}if(l)try{await l.release()}catch(e){console.error(`Port allocation cleanup error:`,e)}(e instanceof zn||e instanceof Bn||e instanceof Vn||e instanceof Qn)&&(console.error(`Error [${e.code}]: ${e.message}`),console.error(`Recovery: ${e.recovery}`),process.exit(1));let t=new $n({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)}}),rr=new I(`status`).description(`Show status of HTTP server and diagnostics`).action(async()=>{try{let e=V(`httpServe`),t=process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH??e.registryPath??e.registryDir;t&&(process.env.PLAYWRIGHT_REGISTRY_DIR=t,process.env.PLAYWRIGHT_REGISTRY_PATH=t,process.env.PORT_REGISTRY_PATH=t),!process.env.PLAYWRIGHT_PIDS_DIR&&e.pidsDir&&(process.env.PLAYWRIGHT_PIDS_DIR=e.pidsDir),console.log(`browse-tool Status
|
|
433
|
+
`),console.log(`-`.repeat(50));let n=await g().get(i.HttpServerManager).getStatus();if(n.running){let t=process.env.PLAYWRIGHT_HOST??e.host??C();console.log(`HTTP Server: Running`),console.log(` PID: ${n.pid}`),console.log(` Port: ${n.port}`),console.log(` Health: ${p(t,n.port)}/health`),n.browserCount!==void 0&&console.log(` Browsers: ${n.browserCount}`)}else console.log(`HTTP Server: Not Running`),n.error&&console.log(` Error: ${n.error}`);console.log(``),console.log(`-`.repeat(50)),process.exit(0)}catch(e){console.error(`Error getting status:`,e),process.exit(1)}}),ir=new I(`stop`).description(`Stop HTTP server and clean up registry/PID files`).action(async()=>{try{let e=V(`httpServe`),t=process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH??e.registryPath??e.registryDir;t&&(process.env.PLAYWRIGHT_REGISTRY_DIR=t,process.env.PLAYWRIGHT_REGISTRY_PATH=t,process.env.PORT_REGISTRY_PATH=t),!process.env.PLAYWRIGHT_PIDS_DIR&&e.pidsDir&&(process.env.PLAYWRIGHT_PIDS_DIR=e.pidsDir),console.log(`Stopping browse-tool services...`),await g().get(i.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)}}),ar=new Set([`--config`]);function or(e){for(let t=0;t<e.length;t+=1){let n=e[t];if(ar.has(n)){t+=1;continue}if(![...ar].some(e=>n.startsWith(`${e}=`))&&!n.startsWith(`-`))return n}}function sr(e,t=!1){if(t)return!1;let n=or(e);return n?n===`tools`?!0:n===`help`&&e.includes(`tools`):!1}function cr(e){return e.replace(/_/g,`-`)}function $(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).toLowerCase()}function lr(e){let t=new Set;e.type&&t.add(e.type);for(let n of e.oneOf??[])n.type&&t.add(n.type);for(let n of e.anyOf??[])n.type&&t.add(n.type);return t}function ur(e,t){let n=lr(t);if(n.has(`boolean`)){if(e===`true`||e===`1`)return!0;if(e===`false`||e===`0`)return!1}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 dr(e,t){let n=$(e),r=lr(t);return t.type===`boolean`?`--${n}`:r.has(`boolean`)&&r.has(`object`)?`--${n} [value]`:`--${n} <value>`}function fr(e){let{definition:t,execute:n}=e,r=new I(cr(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=dr(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-${$(e)}`,`Disable ${a}`):r.option(i,a,n.default):n.enum&&n.enum.length>0?r.addOption(new ve(i,a).choices(n.enum)):r.option(i,a)}return r.action(async function(){let e=this.optsWithGlobals(),r=V(`tools`),i=H(this,`format`,e.format??`json`,r.format),s=H(this,`color`,e.color??!0,r.color),c=H(this,`port`,String(e.port??f),r.port===void 0?void 0:String(r.port),process.env.PLAYWRIGHT_PORT),l={format:i,color:s},u=Qe(t.name);try{let r={};for(let[t,n]of Object.entries(a)){let i=n,a=$(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&&i.default!==void 0&&(s=i.default),s!==void 0&&(typeof s==`string`&&i.type!==`string`?r[t]=ur(s,i):r[t]=s)}for(let e of o)if(r[e]===void 0){let t=$(e);console.error(G(`Missing required option: --${t}`,l.color)),process.exit(1)}let i=Number.parseInt(c,10),s=U({port:i}),d=n?await n(r,{command:this,formatterOptions:l,port:i}):await s.execute(t.name,r),f=tt(d,l);f&&console.log(f),d.isError&&process.exit(1)}catch(e){console.error(G(e instanceof Error?e:String(e),l.color)),process.exit(1)}}),r}function pr(e){return e.map(fr)}const mr={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 hr(){return new I(`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(f))}function gr(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 _r(){return{definition:mr,execute:async(e,t)=>{let n=await U({port:t.port}).listBrowsers();return{content:[{type:`text`,text:JSON.stringify(gr(n),null,2)}]}}}}function vr(e){return[...e.map(e=>({definition:e})),_r()]}async function yr(e,t){let n=V(`tools`),r=Number(t?.port??process.env.PLAYWRIGHT_PORT??n.port??f);try{let t=pr(vr(await U({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(`${G(`Failed to load tool commands: ${t}`,!0)}\n`),process.stderr.write(`Make sure the HTTP server is running: browse-tool http-serve
|
|
434
|
+
`)}}function br(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 xr(){let t=process.argv.slice(2),n=Ze(t,{cwd:_(e({argv:t}))}),r=process.env.PLAYWRIGHT_PORT??n.config.commands.tools?.port??n.config.commands.exec?.port??f,i=new I;i.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`).option(`--workspace-root <path>`,`Canonical workspace root for registry scoping (${v})`).version(we),i.addCommand(nr),i.addCommand(cn),i.addCommand(Le),i.addCommand(ft),i.addCommand(ir),i.addCommand(rr),i.addCommand(pt),i.addCommand(ut),i.addCommand(dt);let a=hr();sr(t,process.env.PLAYWRIGHT_SKIP_DYNAMIC_TOOL_COMMANDS===`1`)&&await yr(a,{port:br(t,r)}),i.addCommand(a),await i.parseAsync(process.argv)}xr().catch(e=>{console.error(e instanceof Error?e.message:String(e)),process.exit(1)});export{};
|
|
@@ -7289,6 +7289,13 @@ var ServerMessageSchema = discriminatedUnion("type", [
|
|
|
7289
7289
|
telemetry: TaskTelemetryContextSchema.optional()
|
|
7290
7290
|
})
|
|
7291
7291
|
}),
|
|
7292
|
+
object({
|
|
7293
|
+
type: literal("task:cancel"),
|
|
7294
|
+
payload: object({
|
|
7295
|
+
taskId: string(),
|
|
7296
|
+
reason: string()
|
|
7297
|
+
})
|
|
7298
|
+
}),
|
|
7292
7299
|
object({
|
|
7293
7300
|
type: literal("page:created"),
|
|
7294
7301
|
payload: object({
|
|
@@ -7469,6 +7476,9 @@ var WebSocketClient = class {
|
|
|
7469
7476
|
case "task:push":
|
|
7470
7477
|
this.events.onTaskReceived?.(message);
|
|
7471
7478
|
break;
|
|
7479
|
+
case "task:cancel":
|
|
7480
|
+
this.events.onTaskCancelled?.(message);
|
|
7481
|
+
break;
|
|
7472
7482
|
case "page:created":
|
|
7473
7483
|
this.events.onPageCreated?.(message.payload.pageId, message.payload.browserId, message.payload.url);
|
|
7474
7484
|
break;
|
|
@@ -7601,6 +7611,7 @@ var taskPollerService = new class TaskPollerService {
|
|
|
7601
7611
|
serverUrl;
|
|
7602
7612
|
webSocketTaskLanes = /* @__PURE__ */ new Map();
|
|
7603
7613
|
activeWebSocketTasks = 0;
|
|
7614
|
+
cancelledWebSocketTasks = /* @__PURE__ */ new Set();
|
|
7604
7615
|
toolContext = { tabRegistry };
|
|
7605
7616
|
constructor(serverUrl = "http://localhost:3200", pollIntervalMs = 100) {
|
|
7606
7617
|
this.serverUrl = serverUrl;
|
|
@@ -7631,6 +7642,9 @@ var taskPollerService = new class TaskPollerService {
|
|
|
7631
7642
|
onTaskReceived: (task) => {
|
|
7632
7643
|
this.handleWebSocketTask(task);
|
|
7633
7644
|
},
|
|
7645
|
+
onTaskCancelled: (task) => {
|
|
7646
|
+
this.cancelledWebSocketTasks.add(task.payload.taskId);
|
|
7647
|
+
},
|
|
7634
7648
|
onPageCreated: async (pageId, _browserId, _url) => {
|
|
7635
7649
|
await this.mapPageToActiveTab(pageId, _url);
|
|
7636
7650
|
},
|
|
@@ -7672,6 +7686,7 @@ var taskPollerService = new class TaskPollerService {
|
|
|
7672
7686
|
};
|
|
7673
7687
|
const laneKey = this.getWebSocketExecutionLane(serverTask);
|
|
7674
7688
|
const tracked = (this.webSocketTaskLanes.get(laneKey) ?? Promise.resolve()).catch(() => {}).then(async () => {
|
|
7689
|
+
if (this.cancelledWebSocketTasks.delete(serverTask.id)) return;
|
|
7675
7690
|
this.activeWebSocketTasks += 1;
|
|
7676
7691
|
this.status = "executing";
|
|
7677
7692
|
try {
|
|
@@ -7696,6 +7711,7 @@ var taskPollerService = new class TaskPollerService {
|
|
|
7696
7711
|
}
|
|
7697
7712
|
async executeTaskWithWebSocket(task) {
|
|
7698
7713
|
const result = await this.executeTaskCore(task);
|
|
7714
|
+
if (this.cancelledWebSocketTasks.delete(task.id)) return;
|
|
7699
7715
|
const resultContent = {
|
|
7700
7716
|
content: result.content.map((c) => ({
|
|
7701
7717
|
type: c.type,
|