@agimon-ai/browse-tool 0.14.2 → 0.15.0
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 +15 -15
- package/dist/cli.mjs +19 -19
- package/dist/index.cjs +1 -1
- package/dist/index.mjs +1 -1
- package/dist/{playwright-test-D2-s0LpN.cjs → playwright-test-uOtnRPlc.cjs} +1 -1
- package/dist/streamable-http-CZoE_y6A.mjs +53 -0
- package/dist/{streamable-http-khiDB7Cd.cjs → streamable-http-UNuTiSXW.cjs} +11 -11
- package/dist/stubs/playwright-test.cjs +1 -1
- package/package.json +5 -5
- package/dist/streamable-http-CJeeA9N3.mjs +0 -53
package/dist/cli.mjs
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{C as e,S as t,T as n,_ as r,a as i,b as a,c as o,d as s,f as c,g as l,h as u,i as d,l as f,m as p,n as m,o as h,p as g,s as _,t as v,u as y,v as b,w as x,x as S,y as C}from"./streamable-http-CJeeA9N3.mjs";import{stripTypeScriptTypes as w}from"node:module";import"reflect-metadata/lite";import{DEFAULT_PORT_RANGE as T,PortRegistryService as E}from"@agimon-ai/foundation-port-registry";import{createProcessLease as ee,resolveSiblingRegistryPath as te}from"@agimon-ai/foundation-process-registry";import{Container as D,ContainerModule as O}from"inversify";import k from"node:path";import{existsSync as A,readFileSync as j,statSync as ne}from"node:fs";import{readFile as M,stat as re}from"node:fs/promises";import{homedir as ie}from"node:os";import{z as N}from"zod";import{SpanStatusCode as P}from"@opentelemetry/api";import{Server as ae}from"@modelcontextprotocol/sdk/server/index.js";import{CallToolRequestSchema as oe,ListToolsRequestSchema as se}from"@modelcontextprotocol/sdk/types.js";import{StdioServerTransport as ce}from"@modelcontextprotocol/sdk/server/stdio.js";import{Command as F,Option as le}from"commander";import{serve as ue}from"@hono/node-server";import{Hono as I}from"hono";import{cors as de}from"hono/cors";import{createNodeWebSocket as fe}from"@hono/node-ws";import{raw as pe}from"hono/html";import{Fragment as me}from"hono/jsx";import{jsx as L,jsxs as R}from"hono/jsx/jsx-runtime";var he=`0.14.1`;const ge=process.env.BROWSE_TOOL_DEBUG_EXTENSION_RECORDING===`1`;function _e(e,t){if(!ge)return;let n=t?` ${JSON.stringify(t)}`:``;console.log(`[ExtensionRecordingDebug] ${e}${n}`)}function ve(e){let t=new I,i;try{i=e.get(n.TelemetryService)}catch{i=new l}return t.get(`/telemetry-config`,e=>{try{let t=new URL(e.req.url).origin;return e.json(r(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 r=e.get(n.ExtensionTaskQueue).getNextTask();return r?t.json({task:{id:r.id,tool:r.tool,arguments:r.arguments,telemetry:r.telemetry}}):t.json({})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/result`,async t=>{try{let r=await t.req.json();if(!r.taskId)return t.json({success:!1,error:`Missing taskId in request body`},400);let i=e.get(n.ExtensionTaskQueue),a=e.get(n.BrowserService),o={taskId:r.taskId,success:r.success,result:r.result,error:r.error},s=i.submitResult(o);return s?(s.browserId&&a.recordBrowserActivity(s.browserId,s.pageId),t.json({success:!0})):t.json({success:!1,error:`Task ${r.taskId} not found or already completed`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.get(`/status`,t=>{try{let r=e.get(n.ExtensionTaskQueue),i=r.getConnectionStatus(),a={connected:i.connected,lastPollAt:i.lastPollAt?.toISOString(),lastResultAt:i.lastResultAt?.toISOString(),pendingTasks:i.pendingTasks,queueSize:r.queueSize};return t.json(a)}catch(e){return t.json({connected:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/register`,async t=>{try{let r=await t.req.json();if(!r.browserId)return t.json({success:!1,error:`Missing browserId in request body`},400);let i=e.get(n.ExtensionSessionRegistry).register(r);return t.json({success:!0,session:{id:i.id,browserId:i.browserId,controlMode:i.controlMode,createdAt:i.createdAt.toISOString()}})}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/heartbeat`,async t=>{try{let r=await t.req.json();if(!r.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let i=e.get(n.ExtensionSessionRegistry).heartbeat(r);return i?t.json({success:!0,session:{id:i.id,controlMode:i.controlMode,handoffRequested:i.handoffRequested,lastHeartbeatAt:i.lastHeartbeatAt.toISOString()}}):t.json({success:!1,error:`Session ${r.sessionId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/tab-mapped`,async t=>{try{let r=await t.req.json();if(!r.pageId||typeof r.tabId!=`number`)return t.json({success:!1,error:`Missing pageId or tabId in request body`},400);let i=e.get(n.PageRegistry),a=e.get(n.BrowserService),o=i.get(r.pageId);return o?(o.extensionTabId=r.tabId,a.recordBrowserActivity(o.browserId,r.pageId),t.json({success:!0})):t.json({success:!1,error:`Page ${r.pageId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/recording`,async t=>{try{let r=await t.req.json();if(!r.browserId)return t.json({success:!1,error:`Missing browserId in request body`},400);let i=e.get(n.BrowserService),a=await i.persistExtensionRecordingArtifact(r.browserId,r.videoBase64);return _e(`artifact received`,{browserId:r.browserId,videoBase64Size:r.videoBase64?.length??0,persisted:a}),a?(i.recordBrowserActivity(r.browserId),t.json({success:!0})):t.json({success:!1,error:`Browser "${r.browserId}" has no active recording target`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),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(n.BrowserService),o=await a.persistExtensionRecordingChunk(r.browserId,r.chunkBase64);return _e(`chunk received`,{browserId:r.browserId,chunkIndex:r.chunkIndex,mimeType:r.mimeType,persisted:!!o,chunkBase64Size:r.chunkBase64.length}),o?(i.log(`debug`,`extension recording chunk received`,{attributes:{"browse_tool.extension.recording.chunk_received":!0,"browse_tool.browser.id":r.browserId,"browse_tool.recording.chunk_bytes":o.chunkBytes,"browse_tool.recording.total_bytes":o.totalBytes,"browse_tool.recording.chunk_count":o.chunkCount,...typeof r.chunkIndex==`number`?{"browse_tool.recording.chunk_index":r.chunkIndex}:{},...typeof r.mimeType==`string`?{"browse_tool.recording.mime_type":r.mimeType}:{}}}),a.recordBrowserActivity(r.browserId),t.json({success:!0})):t.json({success:!1,error:`Browser "${r.browserId}" has no active recording target`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),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):(i.log(t.level??`info`,t.message,{attributes:{"browse_tool.extension.log_relay":!0,...typeof t.attributes==`object`&&t.attributes!==null?t.attributes:{}}}),_e(`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 r=await t.req.json();if(!r.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let i=e.get(n.ExtensionSessionRegistry).requestHandoff(r);return i?t.json({success:!0,message:`Handoff requested. AI will take control when ready.`,session:{id:i.id,controlMode:i.controlMode,handoffRequested:i.handoffRequested}}):t.json({success:!1,error:`Session ${r.sessionId} not found`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.post(`/handoff/acknowledge`,async t=>{try{let r=await t.req.json();if(!r.sessionId)return t.json({success:!1,error:`Missing sessionId in request body`},400);let i=e.get(n.ExtensionSessionRegistry).acknowledgeHandoff(r.sessionId);return i?t.json({success:!0,message:`Handoff acknowledged. AI now has control.`,session:{id:i.id,controlMode:i.controlMode,handoffRequested:i.handoffRequested}}):t.json({success:!1,error:`Session ${r.sessionId} not found or no handoff pending`},404)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.get(`/sessions`,t=>{try{let r=e.get(n.ExtensionSessionRegistry).listSessions();return t.json({sessions:r.map(e=>({id:e.id,browserId:e.browserId,tabId:e.tabId,currentUrl:e.currentUrl,controlMode:e.controlMode,activeSpecPath:e.activeSpecPath,handoffRequested:e.handoffRequested,createdAt:e.createdAt.toISOString(),lastHeartbeatAt:e.lastHeartbeatAt.toISOString()}))})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}}),t}function ye(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 be=[`pnpm-workspace.yaml`,`nx.json`,`.git`],xe=`browse-tool-chrome`,Se=`tool`,Ce=process.env.NODE_ENV||`development`,we=`127.0.0.1`;function Te(e=process.cwd()){let t=k.resolve(e);for(;;){for(let e of be)if(A(k.join(t,e)))return t;let e=k.dirname(t);if(e===t)return process.cwd();t=e}}function Ee(){return new E(process.env.PORT_REGISTRY_PATH)}async function De(e,t,n){let r=Ee(),i=await r.reservePort({repositoryPath:e,serviceName:xe,serviceType:Se,environment:Ce,preferredPort:t,portRange:n,pid:process.pid,host:we,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:xe,serviceType:Se,environment:Ce,pid:process.pid});if(!n.success&&!n.error?.includes(`No matching registry entry`))throw Error(n.error||`Failed to release port ${t}`)}}}function Oe(){return new O(e=>{e.bind(n.ExtensionTaskQueue).to(u).inSingletonScope(),e.bind(n.ExtensionToolDelegator).to(p).inSingletonScope()})}function ke(e){let t=new ae({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(se,async()=>({tools:n})),t.setRequestHandler(oe,async t=>{let{name:n,arguments:r}=t.params;return await e.executeTool(n,r||{})}),t}const Ae=new F(`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 e=>{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 t,r;try{let i=ye(e.port),a=Te(process.cwd()),o=process.env.PORT_REGISTRY_PATH;o&&(process.env.PROCESS_REGISTRY_PATH=te(o,`processes.json`)),t=await De(a,i??T.min,i?{min:i,max:i}:T);let s=t.port;r=await ee({repositoryPath:a,serviceName:xe,serviceType:Se,environment:Ce,pid:process.pid,port:s,host:we,command:process.argv[1],args:process.argv.slice(2),metadata:{transport:`stdio`,command:`chrome-serve`,waitForExtension:e.waitForExtension}}),e.verbose&&(console.error(`Chrome Extension MCP Server starting...`),console.error(` HTTP Port: ${s}`),console.error(` Wait for extension: ${e.waitForExtension}`));let c=new D({defaultScope:`Singleton`});c.load(Oe());let l=c.get(n.ExtensionTaskQueue),u=c.get(n.ExtensionToolDelegator),d=new I;d.use(`*`,de({origin:e=>e??null,credentials:!0,allowMethods:[`GET`,`POST`,`OPTIONS`],allowHeaders:[`Content-Type`,`Accept`]}));let f=ve(c);d.route(`/extension`,f),d.get(`/health`,e=>{let t=l.getConnectionStatus();return e.json({status:`healthy`,service:`browse-tool-chrome`,extension:t})});let p=ue({fetch:d.fetch,port:s});p.on(`error`,e=>{e.code===`EADDRINUSE`?(console.error(`Error [PORT_IN_USE]: Port ${s} is already in use.`),console.error(`Recovery: Try a different port with --port <port>`)):console.error(`Error [SERVER_ERROR]: HTTP server error: ${e.message}`),process.exit(1)}),console.error(`HTTP server started on port ${s}`),console.error(`Waiting for Chrome extension to connect...`),console.error(`Extension should poll: http://localhost:${s}/extension/tasks`),e.waitForExtension&&(console.error(`Waiting for extension connection before starting MCP...`),await new Promise(e=>{let t=setInterval(()=>{l.getConnectionStatus().connected&&(clearInterval(t),console.error(`Extension connected!`),e())},500)}));let m=ke(u),h=new ce;await m.connect(h),console.error(`Chrome extension MCP server started on stdio`);let g=async e=>{console.error(`\nReceived ${e}, shutting down gracefully...`);try{l.clearAllTasks(`Server shutting down`),await h.close(),p.close(),await r.release({kill:!1}),await t.release(),process.exit(0)}catch(e){console.error(`Error during shutdown:`,e),process.exit(1)}};process.on(`SIGINT`,()=>g(`SIGINT`)),process.on(`SIGTERM`,()=>g(`SIGTERM`))}catch(e){if(r||t)try{await r?.release(),await t?.release()}catch{}let n=e instanceof Error?e.message:String(e);console.error(`Error [SERVER_ERROR]: Failed to start Chrome extension MCP server: ${n}`),console.error(`Recovery: Check that the port is available and try again.`),process.exit(1)}}),je=`BROWSE_TOOL_CONFIG`,Me=`.browse-tool`,Ne=`config.json`,Pe=[`json`,`text`,`quiet`],Fe={commands:{},tools:{}},Ie=N.record(N.string(),N.unknown()),Le=N.object({mcpServe:N.object({type:N.string().optional(),browser:N.string().optional(),headless:N.boolean().optional(),profile:N.string().optional(),mode:N.string().optional(),host:N.string().optional(),port:N.coerce.number().int().positive().optional(),httpPort:N.coerce.number().int().positive().optional(),tags:N.string().optional(),exclude:N.string().optional(),customTools:N.string().optional(),chromeForTestingPath:N.string().optional(),snippetsDir:N.string().optional(),registryPath:N.string().optional(),registryDir:N.string().optional(),pidsDir:N.string().optional(),profilesDir:N.string().optional(),proxyConfigDir:N.string().optional()}).partial().optional(),httpServe:N.object({port:N.coerce.number().int().positive().optional(),headless:N.boolean().optional(),idleTimeout:N.coerce.number().positive().optional(),host:N.string().optional(),registryDir:N.string().optional(),registryPath:N.string().optional(),pidsDir:N.string().optional(),profilesDir:N.string().optional(),snippetsDir:N.string().optional(),proxyConfigDir:N.string().optional()}).partial().optional(),exec:N.object({format:N.enum(Pe).optional(),color:N.boolean().optional(),port:N.coerce.number().int().positive().optional()}).partial().optional(),tools:N.object({format:N.enum(Pe).optional(),color:N.boolean().optional(),port:N.coerce.number().int().positive().optional()}).partial().optional(),status:N.record(N.string(),N.unknown()).optional(),stop:N.record(N.string(),N.unknown()).optional()}),Re=N.object({commands:Le.default({}),tools:N.record(N.string(),Ie).default({})});let z={config:Fe};function ze(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 Be(e){let t=k.resolve(e);if(!A(t))throw Error(`Config path not found: ${t}`);return ne(t).isDirectory()?k.join(t,Ne):t}function Ve(e,t){let n=t.env??process.env,r=t.cwd??process.cwd(),i=t.homeDir??ie(),a=ze(e);if(a)return Be(a);if(n[je])return Be(n[je]);let o=k.join(r,Me,Ne);if(A(o))return o;let s=k.join(i,Me,Ne);if(A(s))return s}function He(e){let t=j(e,`utf8`),n=JSON.parse(t);return Re.parse(n)}function Ue(e,t={}){let n=Ve(e,t);return n?{configPath:n,config:He(n)}:{config:Fe}}function We(e,t={}){return z=Ue(e,t),z}function B(e){return(z.config.commands??{})[e]??{}}function Ge(e){return z.config.tools?.[e]??{}}function V(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 Ke=class{port;exactPort;timeout;serverPort=null;constructor(e={}){this.port=e.port??s,this.exactPort=e.exactPort??!1,this.timeout=e.timeout??6e4}async ensureServer(){if(this.serverPort!==null)return this.serverPort;let e=await h().get(n.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()}`}async listTools(){let e=await this.getBaseUrl(),t=new AbortController,n=setTimeout(()=>t.abort(),this.timeout);try{let n=await fetch(`${e}/tools`,{method:`GET`,headers:{Accept:`application/json`},signal:t.signal});if(!n.ok)throw Error(`HTTP ${n.status}: ${n.statusText}`);let r=await n.json();if(r.error)throw Error(r.error);return r.tools}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(n)}}async listCustomTools(e){let t=await this.getBaseUrl(),n=new AbortController,r=setTimeout(()=>n.abort(),this.timeout);try{let r=new URL(`/custom-tools`,t);r.searchParams.set(`dir`,e);let i=await fetch(r,{method:`GET`,headers:{Accept:`application/json`},signal:n.signal});if(!i.ok)throw Error(`HTTP ${i.status}: ${i.statusText}`);let a=await i.json();if(a.error)throw Error(a.error);return a.tools}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(r)}}async listBrowsers(){let e=await this.getBaseUrl(),t=new AbortController,n=setTimeout(()=>t.abort(),this.timeout);try{let n=await fetch(`${e}/browsers`,{method:`GET`,headers:{Accept:`application/json`},signal:t.signal});if(!n.ok)throw Error(`HTTP ${n.status}: ${n.statusText}`);let r=await n.json();if(r.error)throw Error(r.error);return r.browsers}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(n)}}async execute(e,t){let n=await this.getBaseUrl(),r=e===`run_spec`?void 0:this.timeout,i=new AbortController,a=r===void 0?void 0:setTimeout(()=>i.abort(),r);try{let a=await fetch(`${n}/execute`,{method:`POST`,headers:{"Content-Type":`application/json`,Accept:`application/json`},body:JSON.stringify({tool:e,arguments:t}),signal:r===void 0?void 0:i.signal});if(!a.ok){let e=await a.text();throw Error(`HTTP ${a.status}: ${e||a.statusText}`)}let o=await a.json();return o.success?o.result??{content:[{type:`text`,text:`No result returned`}]}:{content:[{type:`text`,text:o.error??`Unknown error`}],isError:!0}}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{a&&clearTimeout(a)}}async executeCustomTool(e,t,n){let r=await this.getBaseUrl(),i=new AbortController,a=setTimeout(()=>i.abort(),this.timeout);try{let a=new URL(`/custom-tools`,r);a.searchParams.set(`dir`,e);let o=await fetch(a,{method:`POST`,headers:{"Content-Type":`application/json`,Accept:`application/json`},body:JSON.stringify({tool:t,arguments:n}),signal:i.signal});if(!o.ok){let e=await o.text();throw Error(`HTTP ${o.status}: ${e||o.statusText}`)}let s=await o.json();return s.success?s.result??{content:[{type:`text`,text:`No result returned`}]}:{content:[{type:`text`,text:s.error??`Unknown error`}],isError:!0}}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(a)}}wrapConnectionError(e){return e instanceof Error?e.message.includes(`ECONNREFUSED`)||e.message.includes(`fetch failed`)?Error(`Cannot connect to browse-tool HTTP server.\n\nTry one of the following:\n 1. Start the server: browse-tool http-serve\n 2. Check if another process is using port ${this.port}\n 3. Run with a different port: browse-tool --port 3201 <command>\n\nOriginal error: ${e.message}`,{cause:e}):e:Error(String(e),{cause:e})}};function H(e){return new Ke(e)}const qe={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 U(e,t,n){return n?`${qe[t]}${e}${qe.reset}`:e}function Je(e,t){let{format:n,color:r}=t;return n===`quiet`?``:n===`json`?Ye(e):Xe(e,r)}function Ye(e){return JSON.stringify(e,null,2)}function Xe(e,t){let n=[];e.isError&&n.push(U(`Error:`,`red`,t));for(let r of e.content)r.type===`text`?n.push(Ze(r,t)):r.type===`image`?n.push(et(r,t)):n.push(U(`[Unknown content type: ${r.type}]`,`yellow`,t));return n.join(`
|
|
3
|
-
`)}function
|
|
4
|
-
`)}function
|
|
5
|
-
`)}function nt(e,t){let n=B(`tools`),r=V(e,`format`,t.format,n.format),i=V(e,`color`,t.color,n.color);return{port:V(e,`port`,t.port,n.port===void 0?void 0:String(n.port),process.env.PLAYWRIGHT_PORT),formatterOptions:{format:r,color:i}}}const rt=new F(`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(s)).action(async function(e,t){let{port:n,formatterOptions:r}=nt(this,t);try{let t=await H({port:Number.parseInt(n,10)}).listCustomTools(e),i=r.format===`text`?tt(t,r.color):r.format===`quiet`?``:JSON.stringify(t,null,2);i&&console.log(i)}catch(e){console.error(W(e instanceof Error?e:String(e),r.color)),process.exit(1)}}),it=new F(`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(s)).action(async function(e,t,n,r){let{port:i,formatterOptions:a}=nt(this,r);try{let r;try{r=JSON.parse(n)}catch{console.error(W(`Invalid JSON arguments: ${n}`,a.color)),process.exit(1);return}let o=await H({port:Number.parseInt(i,10)}).executeCustomTool(e,t,r),s=Je(o,a);s&&console.log(s),o.isError&&process.exit(1)}catch(e){console.error(W(e instanceof Error?e:String(e),a.color)),process.exit(1)}});new F(`custom-tools`).description(`List and execute custom tools through the HTTP server`).addCommand(rt).addCommand(it);const at=new F(`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`,x).option(`--image <image>`,`Docker image tag to produce`,t).option(`--platform <platform>`,`Docker target platform`,e).action(async e=>{try{let t=await C({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: ${a(t.platform)}`)}catch(e){console.error(e instanceof Error?e.message:String(e)),process.exit(1)}}),ot=new F(`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(s)).action(async function(e,t,n){let r=B(`exec`),i=V(this,`format`,n.format,r.format),a=V(this,`color`,n.color,r.color),o=V(this,`port`,n.port,r.port===void 0?void 0:String(r.port),process.env.PLAYWRIGHT_PORT),s=this.getOptionValueSourceWithGlobals(`port`),c=s!==void 0&&s!==`default`&&s!==`implied`,l={format:i,color:a};try{let n;try{n=JSON.parse(t)}catch{console.error(W(`Invalid JSON arguments: ${t}`,l.color)),process.exit(1)}let r=await H({port:Number.parseInt(o,10),exactPort:c}).execute(e,n),i=Je(r,l);i&&console.log(i),r.isError&&process.exit(1)}catch(e){console.error(W(e instanceof Error?e:String(e),l.color)),process.exit(1)}}),G=`pageId`,K=`browserId`,st=N.record(N.string(),N.unknown()),ct=N.object({type:N.literal(`object`),properties:N.record(N.string(),N.unknown()).optional(),required:N.array(N.string()).optional(),additionalProperties:N.boolean().optional()}).passthrough(),lt=N.object({name:N.string().min(1),description:N.string().min(1),script:N.string().min(1),suggestionActions:N.string().min(1).optional(),capabilities:st,inputSchema:ct}),ut=N.object({tools:N.array(lt)}),dt=process.env.BROWSE_TOOL_DEBUG_CUSTOM_TOOLS===`1`;function ft(e){return JSON.stringify(e,(e,t)=>typeof t==`string`&&t.length>240?`${t.slice(0,240)}...<trimmed>`:t)}function pt(e,t){if(dt){if(t){console.error(`[CustomToolService] ${e}`,t);return}console.error(`[CustomToolService] ${e}`)}}function q(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function mt(e){return q(e)&&Array.isArray(e.content)}function J(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 ht(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 gt(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(`-`)?_t(e,t,n):vt(e,t,n)}function _t(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]=yt(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]=J(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(!q(n))throw Error(`Expected object entry in tools.yaml at line ${i+1}`);Object.assign(s,n),i=r;continue}let[r,a]=yt(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]=J(a),i+=1}r.push(s);continue}r.push(J(a)),i+=1}return[r,i]}function vt(e,t,n){let r={},i=t;for(;i<e.length;){let t=e[i];if(t.indent<n||t.indent!==n||t.text.startsWith(`-`))break;let[a,o]=yt(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]=J(o),i+=1}return[r,i]}function yt(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 bt(e){let t=gt(e);if(t.length===0)return{};let[n]=Y(t,0,t[0].indent);return n}function xt(e){e.inputSchema.properties===void 0&&(e.inputSchema.properties={});let t=e.inputSchema.properties;if(!q(t))throw Error(`Custom tool "${e.name}" inputSchema.properties must be an object`);let n=t[G],r=t[K];if(n!==void 0&&!(q(n)&&n.type===`string`))throw Error(`Custom tool "${e.name}" must define inputSchema.properties.pageId as type "string"`);if(r!==void 0&&!(q(r)&&r.type===`string`))throw Error(`Custom tool "${e.name}" must define inputSchema.properties.browserId as type "string"`);n===void 0&&(t[G]={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[K]={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 St(e){let t=w(await M(e,`utf8`),{mode:`strip`});return await import(`data:text/javascript;base64,${Buffer.from(t,`utf8`).toString(`base64`)}`)}function Ct(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 wt(e,t){return typeof e.suggestionActions==`string`&&e.suggestionActions.trim().length>0?e:{...e,suggestionActions:t}}function Tt(e,t){let n=e.content[0];if(n?.type===`text`&&typeof n.text==`string`)try{let r=JSON.parse(n.text);if(q(r)){let i=wt(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 Et(e,t,n){if(mt(t))return n?Tt(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=q(t)&&n?wt(t,n):t;return{content:[{type:`text`,text:JSON.stringify(r,null,2)}]}}var Dt=class{constructor(e,t,n=new l,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 b(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[G]==`string`&&t[G].length>0?t[G]:void 0,r=typeof t[K]==`string`&&t[K].length>0?t[K]:void 0;if(!n&&!r)throw Error(`Custom tool "${e}" requires a string pageId or browserId`);if(n){let t=this.pageRegistry.get(n);if(!t)throw Error(`Page "${n}" not found`);if(r&&t.browserId!==r)throw Error(`Custom tool "${e}" received pageId "${n}" for browser "${t.browserId}", not "${r}"`);let i=this.createBrowserHelper(e,t.browserId);return{pageId:n,pageEntry:t,page:this.resolveToolPage(e,n,t),browser:i}}let i=this.createBrowserHelper(e,r);try{let e=await i.getCurrentPage(),t=this.pageRegistry.get(e.pageId);if(!t)throw Error(`Page "${e.pageId}" not found`);return{pageId:e.pageId,pageEntry:t,page:e.page,browser:i}}catch(e){if(!(e instanceof Error?e.message:String(e)).includes(`has no pages`))throw e;let t=await i.newPage(),n=this.pageRegistry.get(t.pageId);if(!n)throw Error(`Page "${t.pageId}" not found`,{cause:e});return{pageId:t.pageId,pageEntry:n,page:t.page,browser:i}}}createBrowserHelper(e,t){return{browserId:t,mode:this.browserService?.getBrowser(t)?.mode??`extension`,listPages:async()=>{let e=this.browserService?.getBrowser(t);if(!e)throw Error(`Browser "${t}" not found`);return this.pageRegistry.findByBrowser(t).map(t=>this.toPageSummary(e.currentPageId,t))},getPage:async n=>{let r=this.pageRegistry.get(n);if(!r||r.browserId!==t)throw Error(`Page "${n}" not found in browser "${t}"`);let i=this.browserService?.getBrowser(t);return{...this.toPageSummary(i?.currentPageId??null,r),page:this.resolveToolPage(e,n,r)}},getCurrentPage:async()=>{let n=this.browserService?.getBrowser(t);if(!n)throw Error(`Browser "${t}" not found`);let r=n.currentPageId??this.pageRegistry.findByBrowser(t)[0]?.id??void 0;if(!r)throw Error(`Browser "${t}" has no pages`);let i=this.pageRegistry.get(r);if(!i)throw Error(`Page "${r}" not found`);return{...this.toPageSummary(n.currentPageId,i),page:this.resolveToolPage(e,r,i)}},newPage:async n=>this.createPageForBrowser(e,t,n)}}createToolLogger(e,t,n){let r={"browse_tool.tool.name":e,"browse_tool.page.id":t,"browse_tool.browser.id":n.browserId,"browse_tool.execution.mode":n.mode},i=(e,t,n)=>{this.telemetry.log(e,t,{attributes:ht({...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[G]==`string`?n[G]:void 0,i=typeof n[K]==`string`?n[K]:void 0;return this.telemetry.runInSpan(`browse_tool.custom_tool.execute`,{attributes:{"browse_tool.tool.name":t,"browse_tool.custom_tools.directory":k.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:P.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}),pt(`Executing custom tool`,{toolName:t,directory:k.resolve(e),pageId:a,browserId:o.browserId,mode:o.mode,input:ft(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 pt(`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})}pt(`Custom tool execution completed`,{toolName:t,pageId:a,browserId:o.browserId,mode:o.mode,result:ft(u)});let d=Et(t,u,i.suggestionActions),f=d.isError?d.content[0]?.text:void 0;return f&&r?.setStatus({code:P.ERROR,message:f}),d})}async loadTools(e){let t=k.resolve(e),n=k.join(t,`tools.yaml`),r=bt(await M(n,`utf8`).catch(e=>{throw Error(`Failed to read custom tool manifest at "${n}": ${e instanceof Error?e.message:String(e)}`)})),i=ut.parse(r);return Promise.all(i.tools.map(async e=>{xt(e);let n=k.resolve(t,e.script);await re(n).catch(t=>{throw Error(`Custom tool "${e.name}" script not found at "${n}": ${t instanceof Error?t.message:String(t)}`)});let r=Ct(n,await St(n));return{name:e.name,description:e.description,suggestionActions:e.suggestionActions,inputSchema:e.inputSchema,capabilities:e.capabilities,scriptPath:n,...r}}))}};function Ot(e){let t=new I;return t.get(`/browsers`,async t=>{try{let r=e.get(n.BrowserService),i=e.get(n.PageRegistry),a=r.listBrowsers(),o=i.list(),s=a.map(e=>{let t=o.filter(t=>t.browserId===e.id);return{id:e.id,profileName:e.profileName,currentPageId:e.currentPageId,createdAt:e.createdAt.toISOString(),pages:t.map(e=>({id:e.id,url:e.url,title:e.title,createdAt:e.createdAt.toISOString()}))}}),c={totalBrowsers:a.length,totalPages:o.length};return 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(n.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 r=t.req.param(`id`),i=e.get(n.BrowserService);return i.getBrowser(r)?(await i.closeBrowser(r),t.json({success:!0,message:`Browser "${r}" closed`})):t.json({error:`Browser "${r}" 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 r=t.req.param(`id`),i=e.get(n.PageRegistry).get(r);return i?i.page?(await i.page.close(),t.json({success:!0,message:`Page "${r}" closed`})):t.json({error:`Page "${r}" is in extension mode and cannot be closed via API`},400):t.json({error:`Page "${r}" 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 kt(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 At(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 jt(e){return At(new Date().getTime()-e.getTime())}const Mt=`table-container`,Nt=`stat-card`,Pt=`browser-row`,Ft=`page-row`,X=`status-active`,It=`url-cell`,Z=`timestamp-cell`,Lt=`actions-cell`,Rt=`kill-btn`,zt=`empty-state`;function Bt({browsers:e}){return e.length===0?L(`div`,{class:Mt,children:R(`div`,{class:zt,children:[L(`h3`,{children:`No Active Browsers`}),L(`p`,{children:`Launch a browser using MCP tools to see it here.`})]})}):L(`div`,{class:Mt,children:R(`table`,{class:`browser-table`,children:[L(`thead`,{children:R(`tr`,{children:[L(`th`,{children:`ID`}),L(`th`,{children:`Status`}),L(`th`,{children:`URL / Title`}),L(`th`,{children:`Created`}),L(`th`,{children:`Age`}),L(`th`,{children:`Actions`})]})}),L(`tbody`,{id:`browser-table-body`,children:e.map(e=>R(me,{children:[R(`tr`,{class:Pt,children:[L(`td`,{children:e.id}),L(`td`,{children:R(`span`,{class:X,children:[e.pages.length,` page`,e.pages.length===1?``:`s`]})}),L(`td`,{children:e.profileName||`Default Profile`}),L(`td`,{class:Z,children:kt(e.createdAt)}),L(`td`,{class:Z,children:jt(e.createdAt)}),L(`td`,{class:Lt,children:L(`button`,{type:`button`,class:Rt,onclick:`dashboard.killBrowser('${e.id}')`,children:`Kill`})})]}),e.pages.map(t=>R(`tr`,{class:Ft,children:[R(`td`,{children:[t.id,e.currentPageId===t.id&&` (active)`]}),L(`td`,{children:L(`span`,{class:X,children:`Open`})}),L(`td`,{class:It,title:t.url,children:t.title||t.url||`about:blank`}),L(`td`,{class:Z,children:kt(t.createdAt)}),L(`td`,{class:Z,children:jt(t.createdAt)}),L(`td`,{class:Lt,children:L(`button`,{type:`button`,class:Rt,onclick:`dashboard.killPage('${t.id}')`,children:`Close`})})]},t.id))]},e.id))})]})})}function Vt({stats:e}){return R(`div`,{class:`stats-container`,children:[R(`div`,{class:Nt,children:[L(`h3`,{children:`Active Browsers`}),L(`div`,{class:`value`,children:e.totalBrowsers})]}),R(`div`,{class:Nt,children:[L(`h3`,{children:`Active Pages`}),L(`div`,{class:`value`,children:e.totalPages})]})]})}function Ht({browsers:e,stats:t}){return R(`div`,{class:`dashboard-container`,children:[R(`div`,{class:`dashboard-header`,children:[R(`div`,{children:[L(`h1`,{children:`Playwright MCP Dashboard`}),L(`p`,{children:`Browser automation management (auto-refresh every 3 seconds)`})]}),R(`div`,{children:[L(`button`,{type:`button`,id:`refresh-btn`,class:`btn refresh-btn`,onclick:`dashboard.manualRefresh()`,children:`Refresh Now`}),L(`button`,{type:`button`,id:`kill-all-btn`,class:`btn btn-danger`,onclick:`dashboard.killAllBrowsers()`,children:`Kill All Browsers`})]})]}),L(Vt,{stats:t}),L(Bt,{browsers:e}),L(`script`,{children:pe(`
|
|
2
|
+
import{C as e,D as t,E as n,O as r,S as i,T as a,_ as o,a as s,b as c,c as l,d as u,f as d,g as f,h as p,i as m,l as h,m as g,n as _,o as v,p as y,s as b,t as ee,u as x,v as S,w as C,x as w,y as T}from"./streamable-http-CZoE_y6A.mjs";import{stripTypeScriptTypes as E}from"node:module";import"reflect-metadata/lite";import{DEFAULT_PORT_RANGE as D,PortRegistryService as O}from"@agimon-ai/foundation-port-registry";import{createProcessLease as k,resolveSiblingRegistryPath as te}from"@agimon-ai/foundation-process-registry";import{Container as A,ContainerModule as ne}from"inversify";import j from"node:path";import{existsSync as M,readFileSync as re,statSync as ie}from"node:fs";import{readFile as N,stat as ae}from"node:fs/promises";import{homedir as oe}from"node:os";import{z as P}from"zod";import{SpanStatusCode as F}from"@opentelemetry/api";import{randomUUID as se}from"node:crypto";import{Server as ce}from"@modelcontextprotocol/sdk/server/index.js";import{CallToolRequestSchema as le,ListToolsRequestSchema as ue}from"@modelcontextprotocol/sdk/types.js";import{StdioServerTransport as de}from"@modelcontextprotocol/sdk/server/stdio.js";import{Command as I,Option as fe}from"commander";import{serve as pe}from"@hono/node-server";import{Hono as L}from"hono";import{cors as me}from"hono/cors";import{createNodeWebSocket as he}from"@hono/node-ws";import{raw as ge}from"hono/html";import{Fragment as _e}from"hono/jsx";import{jsx as R,jsxs as z}from"hono/jsx/jsx-runtime";var ve=`0.14.2`;const ye=process.env.BROWSE_TOOL_DEBUG_EXTENSION_RECORDING===`1`;function be(e,t){if(!ye)return;let n=t?` ${JSON.stringify(t)}`:``;console.log(`[ExtensionRecordingDebug] ${e}${n}`)}function xe(e){let t=new L,n;try{n=e.get(r.TelemetryService)}catch{n=new f}return t.get(`/telemetry-config`,e=>{try{let t=new URL(e.req.url).origin;return e.json(o(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(r.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 i=e.get(r.ExtensionTaskQueue),a=e.get(r.BrowserService),o={taskId:n.taskId,success:n.success,result:n.result,error:n.error},s=i.submitResult(o);return s?(s.browserId&&a.recordBrowserActivity(s.browserId,s.pageId),t.json({success:!0})):t.json({success:!1,error:`Task ${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(r.ExtensionTaskQueue),i=n.getConnectionStatus(),a={connected:i.connected,lastPollAt:i.lastPollAt?.toISOString(),lastResultAt:i.lastResultAt?.toISOString(),pendingTasks:i.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 i=e.get(r.ExtensionSessionRegistry).register(n);return t.json({success:!0,session:{id:i.id,browserId:i.browserId,controlMode:i.controlMode,createdAt:i.createdAt.toISOString()}})}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),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 i=e.get(r.ExtensionSessionRegistry).heartbeat(n);return i?t.json({success:!0,session:{id:i.id,controlMode:i.controlMode,handoffRequested:i.handoffRequested,lastHeartbeatAt:i.lastHeartbeatAt.toISOString()}}):t.json({success:!1,error:`Session ${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 i=e.get(r.PageRegistry),a=e.get(r.BrowserService),o=i.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 i=e.get(r.BrowserService),a=await i.persistExtensionRecordingArtifact(n.browserId,n.videoBase64);return be(`artifact received`,{browserId:n.browserId,videoBase64Size:n.videoBase64?.length??0,persisted:a}),a?(i.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 i=await t.req.json();if(!i.browserId||!i.chunkBase64)return t.json({success:!1,error:`Missing browserId or chunkBase64 in request body`},400);let a=e.get(r.BrowserService),o=await a.persistExtensionRecordingChunk(i.browserId,i.chunkBase64);return be(`chunk received`,{browserId:i.browserId,chunkIndex:i.chunkIndex,mimeType:i.mimeType,persisted:!!o,chunkBase64Size:i.chunkBase64.length}),o?(n.log(`debug`,`extension recording chunk received`,{attributes:{"browse_tool.extension.recording.chunk_received":!0,"browse_tool.browser.id":i.browserId,"browse_tool.recording.chunk_bytes":o.chunkBytes,"browse_tool.recording.total_bytes":o.totalBytes,"browse_tool.recording.chunk_count":o.chunkCount,...typeof i.chunkIndex==`number`?{"browse_tool.recording.chunk_index":i.chunkIndex}:{},...typeof i.mimeType==`string`?{"browse_tool.recording.mime_type":i.mimeType}:{}}}),a.recordBrowserActivity(i.browserId),t.json({success:!0})):t.json({success:!1,error:`Browser "${i.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:{}}}),be(`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 i=e.get(r.ExtensionSessionRegistry).requestHandoff(n);return i?t.json({success:!0,message:`Handoff requested. AI will take control when ready.`,session:{id:i.id,controlMode:i.controlMode,handoffRequested:i.handoffRequested}}):t.json({success:!1,error:`Session ${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 i=e.get(r.ExtensionSessionRegistry).acknowledgeHandoff(n.sessionId);return i?t.json({success:!0,message:`Handoff acknowledged. AI now has control.`,session:{id:i.id,controlMode:i.controlMode,handoffRequested:i.handoffRequested}}):t.json({success:!1,error:`Session ${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(r.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 Se(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 Ce=[`pnpm-workspace.yaml`,`nx.json`,`.git`],we=`browse-tool-chrome`,Te=`tool`,Ee=process.env.NODE_ENV||`development`,De=`127.0.0.1`;function Oe(e=process.cwd()){let t=j.resolve(e);for(;;){for(let e of Ce)if(M(j.join(t,e)))return t;let e=j.dirname(t);if(e===t)return process.cwd();t=e}}function ke(){return new O(process.env.PORT_REGISTRY_PATH)}async function Ae(e,t,n){let r=ke(),i=await r.reservePort({repositoryPath:e,serviceName:we,serviceType:Te,environment:Ee,preferredPort:t,portRange:n,pid:process.pid,host:De,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:we,serviceType:Te,environment:Ee,pid:process.pid});if(!n.success&&!n.error?.includes(`No matching registry entry`))throw Error(n.error||`Failed to release port ${t}`)}}}function je(){return new ne(e=>{e.bind(r.ExtensionTaskQueue).to(p).inSingletonScope(),e.bind(r.ExtensionToolDelegator).to(g).inSingletonScope()})}function Me(e){let t=new ce({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(ue,async()=>({tools:n})),t.setRequestHandler(le,async t=>{let{name:n,arguments:r}=t.params;return await e.executeTool(n,r||{})}),t}const Ne=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 e=>{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 t,n;try{let i=Se(e.port),a=Oe(process.cwd()),o=process.env.PORT_REGISTRY_PATH;o&&(process.env.PROCESS_REGISTRY_PATH=te(o,`processes.json`)),t=await Ae(a,i??D.min,i?{min:i,max:i}:D);let s=t.port;n=await k({repositoryPath:a,serviceName:we,serviceType:Te,environment:Ee,pid:process.pid,port:s,host:De,command:process.argv[1],args:process.argv.slice(2),metadata:{transport:`stdio`,command:`chrome-serve`,waitForExtension:e.waitForExtension}}),e.verbose&&(console.error(`Chrome Extension MCP Server starting...`),console.error(` HTTP Port: ${s}`),console.error(` Wait for extension: ${e.waitForExtension}`));let c=new A({defaultScope:`Singleton`});c.load(je());let l=c.get(r.ExtensionTaskQueue),u=c.get(r.ExtensionToolDelegator),d=new L;d.use(`*`,me({origin:e=>e??null,credentials:!0,allowMethods:[`GET`,`POST`,`OPTIONS`],allowHeaders:[`Content-Type`,`Accept`]}));let f=xe(c);d.route(`/extension`,f),d.get(`/health`,e=>{let t=l.getConnectionStatus();return e.json({status:`healthy`,service:`browse-tool-chrome`,extension:t})});let p=pe({fetch:d.fetch,port:s});p.on(`error`,e=>{e.code===`EADDRINUSE`?(console.error(`Error [PORT_IN_USE]: Port ${s} is already in use.`),console.error(`Recovery: Try a different port with --port <port>`)):console.error(`Error [SERVER_ERROR]: HTTP server error: ${e.message}`),process.exit(1)}),console.error(`HTTP server started on port ${s}`),console.error(`Waiting for Chrome extension to connect...`),console.error(`Extension should poll: http://localhost:${s}/extension/tasks`),e.waitForExtension&&(console.error(`Waiting for extension connection before starting MCP...`),await new Promise(e=>{let t=setInterval(()=>{l.getConnectionStatus().connected&&(clearInterval(t),console.error(`Extension connected!`),e())},500)}));let m=Me(u),h=new de;await m.connect(h),console.error(`Chrome extension MCP server started on stdio`);let g=async e=>{console.error(`\nReceived ${e}, shutting down gracefully...`);try{l.clearAllTasks(`Server shutting down`),await h.close(),p.close(),await n.release({kill:!1}),await t.release(),process.exit(0)}catch(e){console.error(`Error during shutdown:`,e),process.exit(1)}};process.on(`SIGINT`,()=>g(`SIGINT`)),process.on(`SIGTERM`,()=>g(`SIGTERM`))}catch(e){if(n||t)try{await n?.release(),await t?.release()}catch{}let r=e instanceof Error?e.message:String(e);console.error(`Error [SERVER_ERROR]: Failed to start Chrome extension MCP server: ${r}`),console.error(`Recovery: Check that the port is available and try again.`),process.exit(1)}}),Pe=`BROWSE_TOOL_CONFIG`,Fe=`.browse-tool`,Ie=`config.json`,Le=[`json`,`text`,`quiet`],Re={commands:{},tools:{}},ze=P.record(P.string(),P.unknown()),Be=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(Le).optional(),color:P.boolean().optional(),port:P.coerce.number().int().positive().optional()}).partial().optional(),tools:P.object({format:P.enum(Le).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()}),Ve=P.object({commands:Be.default({}),tools:P.record(P.string(),ze).default({})});let B={config:Re};function He(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 Ue(e){let t=j.resolve(e);if(!M(t))throw Error(`Config path not found: ${t}`);return ie(t).isDirectory()?j.join(t,Ie):t}function We(e,t){let n=t.env??process.env,r=t.cwd??process.cwd(),i=t.homeDir??oe(),a=He(e);if(a)return Ue(a);if(n[Pe])return Ue(n[Pe]);let o=j.join(r,Fe,Ie);if(M(o))return o;let s=j.join(i,Fe,Ie);if(M(s))return s}function Ge(e){let t=re(e,`utf8`),n=JSON.parse(t);return Ve.parse(n)}function Ke(e,t={}){let n=We(e,t);return n?{configPath:n,config:Ge(n)}:{config:Re}}function qe(e,t={}){return B=Ke(e,t),B}function V(e){return(B.config.commands??{})[e]??{}}function Je(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 Ye=class{port;exactPort;timeout;serverPort=null;constructor(e={}){this.port=e.port??u,this.exactPort=e.exactPort??!1,this.timeout=e.timeout??6e4}async ensureServer(){if(this.serverPort!==null)return this.serverPort;let e=await v().get(r.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()}`}async listTools(){let e=await this.getBaseUrl(),t=new AbortController,n=setTimeout(()=>t.abort(),this.timeout);try{let n=await fetch(`${e}/tools`,{method:`GET`,headers:{Accept:`application/json`},signal:t.signal});if(!n.ok)throw Error(`HTTP ${n.status}: ${n.statusText}`);let r=await n.json();if(r.error)throw Error(r.error);return r.tools}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(n)}}async listCustomTools(e){let t=await this.getBaseUrl(),n=new AbortController,r=setTimeout(()=>n.abort(),this.timeout);try{let r=new URL(`/custom-tools`,t);r.searchParams.set(`dir`,e);let i=await fetch(r,{method:`GET`,headers:{Accept:`application/json`},signal:n.signal});if(!i.ok)throw Error(`HTTP ${i.status}: ${i.statusText}`);let a=await i.json();if(a.error)throw Error(a.error);return a.tools}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(r)}}async listBrowsers(){let e=await this.getBaseUrl(),t=new AbortController,n=setTimeout(()=>t.abort(),this.timeout);try{let n=await fetch(`${e}/browsers`,{method:`GET`,headers:{Accept:`application/json`},signal:t.signal});if(!n.ok)throw Error(`HTTP ${n.status}: ${n.statusText}`);let r=await n.json();if(r.error)throw Error(r.error);return r.browsers}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(n)}}async execute(e,t){let n=await this.getBaseUrl(),r=e===`run_spec`?void 0:this.timeout,i=new AbortController,a=r===void 0?void 0:setTimeout(()=>i.abort(),r);try{let a=await fetch(`${n}/execute`,{method:`POST`,headers:{"Content-Type":`application/json`,Accept:`application/json`},body:JSON.stringify({tool:e,arguments:t}),signal:r===void 0?void 0:i.signal});if(!a.ok){let e=await a.text();throw Error(`HTTP ${a.status}: ${e||a.statusText}`)}let o=await a.json();return o.success?o.result??{content:[{type:`text`,text:`No result returned`}]}:{content:[{type:`text`,text:o.error??`Unknown error`}],isError:!0}}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{a&&clearTimeout(a)}}async executeCustomTool(e,t,n){let r=await this.getBaseUrl(),i=new AbortController,a=setTimeout(()=>i.abort(),this.timeout);try{let a=new URL(`/custom-tools`,r);a.searchParams.set(`dir`,e);let o=await fetch(a,{method:`POST`,headers:{"Content-Type":`application/json`,Accept:`application/json`},body:JSON.stringify({tool:t,arguments:n}),signal:i.signal});if(!o.ok){let e=await o.text();throw Error(`HTTP ${o.status}: ${e||o.statusText}`)}let s=await o.json();return s.success?s.result??{content:[{type:`text`,text:`No result returned`}]}:{content:[{type:`text`,text:s.error??`Unknown error`}],isError:!0}}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Request timeout after ${this.timeout}ms`,{cause:e}):this.wrapConnectionError(e)}finally{clearTimeout(a)}}wrapConnectionError(e){return e instanceof Error?e.message.includes(`ECONNREFUSED`)||e.message.includes(`fetch failed`)?Error(`Cannot connect to browse-tool HTTP server.\n\nTry one of the following:\n 1. Start the server: browse-tool http-serve\n 2. Check if another process is using port ${this.port}\n 3. Run with a different port: browse-tool --port 3201 <command>\n\nOriginal error: ${e.message}`,{cause:e}):e:Error(String(e),{cause:e})}};function U(e){return new Ye(e)}const Xe={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?`${Xe[t]}${e}${Xe.reset}`:e}function Ze(e,t){let{format:n,color:r}=t;return n===`quiet`?``:n===`json`?Qe(e):$e(e,r)}function Qe(e){return JSON.stringify(e,null,2)}function $e(e,t){let n=[];e.isError&&n.push(W(`Error:`,`red`,t));for(let r of e.content)r.type===`text`?n.push(et(r,t)):r.type===`image`?n.push(rt(r,t)):n.push(W(`[Unknown content type: ${r.type}]`,`yellow`,t));return n.join(`
|
|
3
|
+
`)}function et(e,t){let n=e.text;try{return tt(JSON.parse(n),t)}catch{return n}}function tt(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=nt(i,t);n.push(`${e}: ${a}`)}return n.join(`
|
|
4
|
+
`)}function nt(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 rt(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 it(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 at(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 ot=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(u)).action(async function(e,t){let{port:n,formatterOptions:r}=at(this,t);try{let t=await U({port:Number.parseInt(n,10)}).listCustomTools(e),i=r.format===`text`?it(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)}}),st=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(u)).action(async function(e,t,n,r){let{port:i,formatterOptions:a}=at(this,r);try{let r;try{r=JSON.parse(n)}catch{console.error(G(`Invalid JSON arguments: ${n}`,a.color)),process.exit(1);return}let o=await U({port:Number.parseInt(i,10)}).executeCustomTool(e,t,r),s=Ze(o,a);s&&console.log(s),o.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(ot).addCommand(st);const ct=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`,t).option(`--image <image>`,`Docker image tag to produce`,a).option(`--platform <platform>`,`Docker target platform`,n).action(async t=>{try{let n=await i({version:t.cftVersion,image:t.image,platform:t.platform,stdio:`inherit`});console.log(`Built Docker image ${n.image}`),console.log(` Version: ${n.version}`),console.log(` Platform: ${n.platform}`),console.log(` Archive: ${e(n.platform)}`)}catch(e){console.error(e instanceof Error?e.message:String(e)),process.exit(1)}}),lt=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(u)).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 n;try{n=JSON.parse(t)}catch{console.error(G(`Invalid JSON arguments: ${t}`,l.color)),process.exit(1)}let r=await U({port:Number.parseInt(o,10),exactPort:c}).execute(e,n),i=Ze(r,l);i&&console.log(i),r.isError&&process.exit(1)}catch(e){console.error(G(e instanceof Error?e:String(e),l.color)),process.exit(1)}}),K=`pageId`,q=`browserId`,ut=P.record(P.string(),P.unknown()),dt=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(),ft=P.object({name:P.string().min(1),description:P.string().min(1),script:P.string().min(1),suggestionActions:P.string().min(1).optional(),capabilities:ut,inputSchema:dt}),pt=P.object({tools:P.array(ft)}),mt=process.env.BROWSE_TOOL_DEBUG_CUSTOM_TOOLS===`1`;function ht(e){return JSON.stringify(e,(e,t)=>typeof t==`string`&&t.length>240?`${t.slice(0,240)}...<trimmed>`:t)}function gt(e,t){if(mt){if(t){console.error(`[CustomToolService] ${e}`,t);return}console.error(`[CustomToolService] ${e}`)}}function J(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function _t(e){return J(e)&&Array.isArray(e.content)}function Y(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 vt(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 yt(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(`-`)?bt(e,t,n):xt(e,t,n)}function bt(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]=St(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]=Y(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(!J(n))throw Error(`Expected object entry in tools.yaml at line ${i+1}`);Object.assign(s,n),i=r;continue}let[r,a]=St(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]=Y(a),i+=1}r.push(s);continue}r.push(Y(a)),i+=1}return[r,i]}function xt(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]=St(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]=Y(o),i+=1}return[r,i]}function St(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 Ct(e){let t=yt(e);if(t.length===0)return{};let[n]=X(t,0,t[0].indent);return n}function wt(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 Tt(e){let t=E(await N(e,`utf8`),{mode:`strip`});return await import(`data:text/javascript;base64,${Buffer.from(t,`utf8`).toString(`base64`)}`)}function Et(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 Dt(e,t){return typeof e.suggestionActions==`string`&&e.suggestionActions.trim().length>0?e:{...e,suggestionActions:t}}function Ot(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=Dt(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 kt(e,t,n){if(_t(t))return n?Ot(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?Dt(t,n):t;return{content:[{type:`text`,text:JSON.stringify(r,null,2)}]}}var At=class{constructor(e,t,n=new f,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 S(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,r=typeof t[q]==`string`&&t[q].length>0?t[q]:void 0;if(!n&&!r)throw Error(`Custom tool "${e}" requires a string pageId or browserId`);if(n){let t=this.pageRegistry.get(n);if(!t)throw Error(`Page "${n}" not found`);let i=c();if(i&&t.ownerId&&t.ownerId!==i)throw Error(`Custom tool "${e}" cannot use page "${n}" owned by another session`);if(r&&t.browserId!==r)throw Error(`Custom tool "${e}" received pageId "${n}" for browser "${t.browserId}", not "${r}"`);let a=this.createBrowserHelper(e,t.browserId);return{pageId:n,pageEntry:t,page:this.resolveToolPage(e,n,t),browser:a}}let i=this.createBrowserHelper(e,r);try{let e=await i.getCurrentPage(),t=this.pageRegistry.get(e.pageId);if(!t)throw Error(`Page "${e.pageId}" not found`);return{pageId:e.pageId,pageEntry:t,page:e.page,browser:i}}catch(e){if(!(e instanceof Error?e.message:String(e)).includes(`has no pages`))throw e;let t=await i.newPage(),n=this.pageRegistry.get(t.pageId);if(!n)throw Error(`Page "${t.pageId}" not found`,{cause:e});return{pageId:t.pageId,pageEntry:n,page:t.page,browser:i}}}createBrowserHelper(e,t){return{browserId:t,mode:this.browserService?.getBrowser(t)?.mode??`extension`,listPages:async()=>{let e=this.browserService?.getBrowser(t);if(!e)throw Error(`Browser "${t}" not found`);return this.pageRegistry.findByBrowser(t).map(t=>this.toPageSummary(e.currentPageId,t))},getPage:async n=>{let r=this.pageRegistry.get(n);if(!r||r.browserId!==t)throw Error(`Page "${n}" not found in browser "${t}"`);let i=this.browserService?.getBrowser(t);return{...this.toPageSummary(i?.currentPageId??null,r),page:this.resolveToolPage(e,n,r)}},getCurrentPage:async()=>{let n=this.browserService?.getBrowser(t);if(!n)throw Error(`Browser "${t}" not found`);let r=c(),i;if(r){let e=this.pageRegistry.findByOwner(r).filter(e=>e.browserId===t);if(i=e[e.length-1]?.id,!i)throw Error(`Browser "${t}" has no pages owned by this session`)}else i=n.currentPageId??this.pageRegistry.findByBrowser(t)[0]?.id??void 0;if(!i)throw Error(`Browser "${t}" has no pages`);let a=this.pageRegistry.get(i);if(!a)throw Error(`Page "${i}" not found`);return{...this.toPageSummary(n.currentPageId,a),page:this.resolveToolPage(e,i,a)}},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:vt({...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":j.resolve(e),"browse_tool.page.id":r,"browse_tool.browser.id":i}},async r=>{let i=(await this.loadTools(e)).find(e=>e.name===t);if(!i)throw r?.setStatus({code: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}),gt(`Executing custom tool`,{toolName:t,directory:j.resolve(e),pageId:a,browserId:o.browserId,mode:o.mode,input:ht(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 gt(`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})}gt(`Custom tool execution completed`,{toolName:t,pageId:a,browserId:o.browserId,mode:o.mode,result:ht(u)});let d=kt(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=j.resolve(e),n=j.join(t,`tools.yaml`),r=Ct(await N(n,`utf8`).catch(e=>{throw Error(`Failed to read custom tool manifest at "${n}": ${e instanceof Error?e.message:String(e)}`)})),i=pt.parse(r);return Promise.all(i.tools.map(async e=>{wt(e);let n=j.resolve(t,e.script);await ae(n).catch(t=>{throw Error(`Custom tool "${e.name}" script not found at "${n}": ${t instanceof Error?t.message:String(t)}`)});let r=Et(n,await Tt(n));return{name:e.name,description:e.description,suggestionActions:e.suggestionActions,inputSchema:e.inputSchema,capabilities:e.capabilities,scriptPath:n,...r}}))}};function jt(e){let t=new L;return t.get(`/browsers`,async t=>{try{let n=e.get(r.BrowserService),i=e.get(r.PageRegistry),a=n.listBrowsers(),o=i.list(),s=a.map(e=>{let t=o.filter(t=>t.browserId===e.id);return{id:e.id,profileName:e.profileName,currentPageId:e.currentPageId,createdAt:e.createdAt.toISOString(),pages:t.map(e=>({id:e.id,url:e.url,title:e.title,createdAt:e.createdAt.toISOString()}))}}),c={totalBrowsers:a.length,totalPages:o.length};return 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(r.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`),i=e.get(r.BrowserService);return i.getBrowser(n)?(await i.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`),i=e.get(r.PageRegistry).get(n);return i?i.page?(await i.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 Mt(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 Nt(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 Pt(e){return Nt(new Date().getTime()-e.getTime())}const Ft=`table-container`,It=`stat-card`,Lt=`browser-row`,Rt=`page-row`,zt=`status-active`,Bt=`url-cell`,Z=`timestamp-cell`,Vt=`actions-cell`,Ht=`kill-btn`,Ut=`empty-state`;function Wt({browsers:e}){return e.length===0?R(`div`,{class:Ft,children:z(`div`,{class:Ut,children:[R(`h3`,{children:`No Active Browsers`}),R(`p`,{children:`Launch a browser using MCP tools to see it here.`})]})}):R(`div`,{class:Ft,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(_e,{children:[z(`tr`,{class:Lt,children:[R(`td`,{children:e.id}),R(`td`,{children:z(`span`,{class:zt,children:[e.pages.length,` page`,e.pages.length===1?``:`s`]})}),R(`td`,{children:e.profileName||`Default Profile`}),R(`td`,{class:Z,children:Mt(e.createdAt)}),R(`td`,{class:Z,children:Pt(e.createdAt)}),R(`td`,{class:Vt,children:R(`button`,{type:`button`,class:Ht,onclick:`dashboard.killBrowser('${e.id}')`,children:`Kill`})})]}),e.pages.map(t=>z(`tr`,{class:Rt,children:[z(`td`,{children:[t.id,e.currentPageId===t.id&&` (active)`]}),R(`td`,{children:R(`span`,{class:zt,children:`Open`})}),R(`td`,{class:Bt,title:t.url,children:t.title||t.url||`about:blank`}),R(`td`,{class:Z,children:Mt(t.createdAt)}),R(`td`,{class:Z,children:Pt(t.createdAt)}),R(`td`,{class:Vt,children:R(`button`,{type:`button`,class:Ht,onclick:`dashboard.killPage('${t.id}')`,children:`Close`})})]},t.id))]},e.id))})]})})}function Gt({stats:e}){return z(`div`,{class:`stats-container`,children:[z(`div`,{class:It,children:[R(`h3`,{children:`Active Browsers`}),R(`div`,{class:`value`,children:e.totalBrowsers})]}),z(`div`,{class:It,children:[R(`h3`,{children:`Active Pages`}),R(`div`,{class:`value`,children:e.totalPages})]})]})}function Kt({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(Gt,{stats:t}),R(Wt,{browsers:e}),R(`script`,{children:ge(`
|
|
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('.${It} .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('.${Ft}');
|
|
56
56
|
if (container) {
|
|
57
57
|
container.innerHTML = \`
|
|
58
|
-
<div class="${
|
|
58
|
+
<div class="${Ut}">
|
|
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 = '${Lt}';
|
|
73
73
|
browserRow.innerHTML = \`
|
|
74
74
|
<td>\${browser.id}</td>
|
|
75
|
-
<td><span class="${
|
|
75
|
+
<td><span class="${zt}">\${browser.pages.length} page\${browser.pages.length !== 1 ? 's' : ''}</span></td>
|
|
76
76
|
<td>\${browser.profileName || 'Default Profile'}</td>
|
|
77
77
|
<td class="${Z}">\${this.formatTimestamp(browser.createdAt)}</td>
|
|
78
78
|
<td class="${Z}">\${this.formatAge(browser.createdAt)}</td>
|
|
79
|
-
<td class="${
|
|
79
|
+
<td class="${Vt}"><button class="${Ht}" 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 = '${Rt}';
|
|
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="${
|
|
90
|
+
<td><span class="${zt}">Open</span></td>
|
|
91
|
+
<td class="${Bt}" title="\${this.escapeHtml(page.url)}">\${this.escapeHtml(page.title || page.url || 'about:blank')}</td>
|
|
92
92
|
<td class="${Z}">\${this.formatTimestamp(page.createdAt)}</td>
|
|
93
93
|
<td class="${Z}">\${this.formatAge(page.createdAt)}</td>
|
|
94
|
-
<td class="${
|
|
94
|
+
<td class="${Vt}"><button class="${Ht}" 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:ge(`
|
|
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
|
-
`)})]}),L(`body`,{children:t})]})}function Wt(e){let t=new I;return t.get(`/`,async t=>{try{let r=e.get(n.BrowserService),i=e.get(n.PageRegistry),a=r.listBrowsers(),o=i.list(),s=a.map(e=>{let t=o.filter(t=>t.browserId===e.id);return{id:e.id,profileName:e.profileName,currentPageId:e.currentPageId,createdAt:e.createdAt,pages:t.map(e=>({id:e.id,url:e.url,title:e.title,createdAt:e.createdAt}))}}),c={totalBrowsers:a.length,totalPages:o.length};return t.html(L(Ut,{title:`Playwright MCP Dashboard`,children:L(Ht,{browsers:s,stats:c})}))}catch(e){return console.error(`Failed to render dashboard:`,e),t.html(L(Ut,{title:`Playwright MCP Dashboard - Error`,children:R(`div`,{style:`padding: 2rem; text-align: center;`,children:[L(`h1`,{children:`Failed to load dashboard`}),L(`p`,{children:e instanceof Error?e.message:String(e)}),L(`a`,{href:`/`,style:`color: #2196f3; text-decoration: underline;`,children:`Retry`})]})}),500)}}),t}function Gt(e){if(!e.isError)return;let t=e.content[0];return t?.type===`text`&&typeof t.text==`string`?t.text:`Unknown tool execution error`}function Kt(e){try{return e.get(n.TelemetryService)}catch{return new l}}function qt(e){let t=new I,r=e.get(n.PageRegistry),i=e.get(n.BrowserService),a=e.get(n.ExtensionTaskQueue),o=Kt(e),s=new Dt(r,a,o,i);t.use(`*`,de({origin:e=>e??null,credentials:!0,allowMethods:[`GET`,`POST`,`DELETE`,`OPTIONS`],allowHeaders:[`Content-Type`,`Accept`,`Authorization`]})),t.get(`/health`,e=>{try{let t=i.listBrowsers(),n={status:`healthy`,service:`browse-tool-http`,serviceName:`browse-tool-http`,timestamp:new Date().toISOString(),browsers:{count:t.length,instances:t.map(e=>({id:e.id,pageCount:e.pageIds.size,createdAt:e.createdAt.toISOString()}))}};return e.json(n)}catch(t){return e.json({status:`unhealthy`,service:`browse-tool-http`,serviceName:`browse-tool-http`,error:t instanceof Error?t.message:String(t)},503)}}),t.post(`/execute`,async t=>{try{let i=await t.req.json();if(!i.tool)return t.json({success:!1,error:`Missing "tool" field in request body`},400);let a=typeof i.arguments?.pageId==`string`?i.arguments.pageId:void 0;return await o.runInSpan(`browse_tool.http.execute`,{attributes:{"http.method":`POST`,"http.route":`/execute`,"browse_tool.tool.name":i.tool,"browse_tool.page.id":a}},async a=>{let s=e.getAll(n.Tool).find(e=>e.getDefinition().name===i.tool);if(process.env.BROWSE_TOOL_DEBUG_EXTENSION_RECORDING===`1`&&i.tool===`browser_launch`){let e=typeof i.arguments?.videoDir==`string`?i.arguments.videoDir:typeof i.arguments?.video_dir==`string`?i.arguments.video_dir:``;console.log(`[ExtensionRecordingDebug] http execute browser_launch mode=${String(i.arguments?.mode??``)} videoDir=${e}`)}if(!s)return a?.setStatus({code:P.ERROR,message:`Tool "${i.tool}" not found`}),o.log(`warn`,`browse-tool HTTP execute rejected unknown tool`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":i.tool}}),t.json({success:!1,error:`Tool "${i.tool}" not found`},404);let c=await s.execute(i.arguments||{}),l=i.arguments||{},u=typeof l.pageId==`string`?l.pageId:void 0;if(u){let t=e.get(n.BrowserService),i=r.get(u);i&&t.recordBrowserActivity(i.browserId,u)}let d=Gt(c);return d?(a?.setStatus({code:P.ERROR,message:d}),o.log(`error`,`browse-tool HTTP execute failed`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":i.tool,"browse_tool.page.id":u}})):o.log(`info`,`browse-tool HTTP execute succeeded`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":i.tool,"browse_tool.page.id":u}}),t.json({success:!c.isError,result:c,error:d})})}catch(e){return o.log(`error`,`browse-tool HTTP execute request crashed`,{attributes:{"http.route":`/execute`},exception:e}),t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.get(`/browsers`,t=>{try{let r=e.get(n.BrowserService).listBrowsers();return t.json({browsers:r.map(e=>({id:e.id,profileName:e.profileName,pageIds:Array.from(e.pageIds),currentPageId:e.currentPageId,createdAt:e.createdAt.toISOString()}))})}catch(e){return t.json({error:e instanceof Error?e.message:String(e)},500)}}),t.get(`/tools`,t=>{try{let r=e.getAll(n.Tool);return t.json({tools:r.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 s.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 i=t.req.query(`dir`);if(!i)return t.json({success:!1,error:`Missing "dir" query parameter`},400);try{let a=await t.req.json();if(!a.tool)return t.json({success:!1,error:`Missing "tool" field in request body`},400);let c=typeof a.arguments?.pageId==`string`?a.arguments.pageId:void 0;return await o.runInSpan(`browse_tool.http.custom_tool.execute`,{attributes:{"http.method":`POST`,"http.route":`/custom-tools`,"browse_tool.tool.name":a.tool,"browse_tool.page.id":c,"browse_tool.custom_tools.directory":i}},async l=>{let u=await s.executeTool(i,a.tool,a.arguments||{});if(c){let t=e.get(n.BrowserService),i=r.get(c);i&&t.recordBrowserActivity(i.browserId,c)}let d=Gt(u);return d?(l?.setStatus({code:P.ERROR,message:d}),o.log(`error`,`browse-tool custom tool execution failed`,{attributes:{"http.route":`/custom-tools`,"browse_tool.tool.name":a.tool,"browse_tool.page.id":c}})):o.log(`info`,`browse-tool custom tool execution succeeded`,{attributes:{"http.route":`/custom-tools`,"browse_tool.tool.name":a.tool,"browse_tool.page.id":c}}),t.json({success:!u.isError,result:u,error:d})})}catch(e){return o.log(`error`,`browse-tool custom tool request crashed`,{attributes:{"http.route":`/custom-tools`,"browse_tool.custom_tools.directory":i},exception:e}),t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}});let c=ve(e);t.route(`/extension`,c);let l=Ot(e);t.route(`/api`,l);let u=Wt(e);return t.route(`/`,u),t}function Jt(e,t,r){e.get(`/ws/extension/:browserId`,r(e=>{let r=e.req.param(`browserId`),i=null;return{onOpen(e,a){if(!r){a.close(1008,`Missing browserId`);return}try{i=t.get(n.WebSocketHub).addConnection(a,r)}catch{a.close(1011,`Internal server error`)}},onMessage(e){if(i)try{let r=t.get(n.WebSocketHub),a=typeof e.data==`string`?e.data:e.data.toString();r.handleMessage(i,a)}catch{}},onClose(){if(i)try{t.get(n.WebSocketHub).removeConnection(i)}catch{}},onError(){if(i)try{t.get(n.WebSocketHub).removeConnection(i)}catch{}}}})),e.get(`/ws/stats`,e=>{try{let r=t.get(n.WebSocketHub).getStats();return e.json({totalConnections:r.totalConnections,browserCount:r.browserCount,connections:r.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 Yt=[`pnpm-workspace.yaml`,`nx.json`,`.git`];function Xt(e=process.cwd()){let t=k.resolve(e);for(;;){for(let e of Yt)if(A(k.join(t,e)))return t;let e=k.dirname(t);if(e===t)return process.cwd();t=e}}const Zt=new F(`http-serve`).description(`Start HTTP server for browser automation`).option(`-p, --port <port>`,`Port to listen on`,String(s)).option(`--host <host>`,`Host to bind`,g()).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`).action(async function(e){let t=B(`httpServe`),r={port:V(this,`port`,e.port,t.port===void 0?void 0:String(t.port),process.env.PLAYWRIGHT_PORT),headless:V(this,`headless`,e.headless,t.headless),idleTimeout:V(this,`idleTimeout`,e.idleTimeout,t.idleTimeout===void 0?void 0:String(t.idleTimeout),process.env[y]),host:V(this,`host`,e.host,t.host,process.env.PLAYWRIGHT_HOST),registryDir:V(this,`registryDir`,e.registryDir,t.registryDir,process.env.PLAYWRIGHT_REGISTRY_DIR),registryPath:V(this,`registryPath`,e.registryPath,t.registryPath,process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH),pidsDir:V(this,`pidsDir`,e.pidsDir,t.pidsDir,process.env.PLAYWRIGHT_PIDS_DIR),profilesDir:V(this,`profilesDir`,e.profilesDir,t.profilesDir,process.env.PLAYWRIGHT_PROFILES_DIR),snippetsDir:V(this,`snippetsDir`,e.snippetsDir,t.snippetsDir,process.env.BROWSE_TOOL_SNIPPETS_DIR),proxyConfigDir:V(this,`proxyConfigDir`,e.proxyConfigDir,t.proxyConfigDir,process.env[_])},a;try{let e=Number.parseInt(r.port,10),t=`browse-tool-http`,o=process.env.NODE_ENV||`development`,s=Xt(process.cwd()),l=r.registryPath||r.registryDir||process.env.PLAYWRIGHT_REGISTRY_PATH;l&&(process.env.PLAYWRIGHT_REGISTRY_DIR=l,process.env.PORT_REGISTRY_PATH=l,process.env.PROCESS_REGISTRY_PATH=te(l,`processes.json`)),process.env.PLAYWRIGHT_HOST=r.host,process.env.PLAYWRIGHT_PORT=r.port,process.env[y]=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=k.resolve(r.snippetsDir)),r.proxyConfigDir&&(process.env[_]=k.resolve(r.proxyConfigDir)),console.log(`Starting HTTP server for browser automation...`),console.log(` Port: ${e}`),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[_]}`);let u=i(),d=u.get(n.ProcessRegistryService),f=qt(u),{injectWebSocket:p,upgradeWebSocket:m}=fe({app:f});Jt(f,u,m);let h=u.get(n.WebSocketHub),g=u.get(n.ExtensionTaskQueue),v=u.get(n.BrowserService),b=u.get(n.ExtensionSessionRegistry),x=u.get(n.PageRegistry),S=u.get(n.IdleCleanupService);S.start(),h.setEventHandlers({onSessionRegister:(e,t)=>{if(t.type===`session:register`){let n=t.payload.browserId||e.browserId,r=v.getBrowser(n),i,a;if(r&&(r.mode===`extension`||r.mode===`vm`)){i=r.id;let t=x.findByBrowser(i);a=r.currentPageId||t[0]?.id||``,h.reassignConnection(e.id,i),a||(a=x.registerExtensionPage(i),r.pageIds.add(a),r.currentPageId=a),console.log(`[WebSocket] Extension connected to existing browser: ${i}, pageId: ${a}`)}else{i=n,v.registerExtensionBrowserWithId(i),a=x.registerExtensionPage(i);let e=v.getBrowser(i);e&&(e.pageIds.add(a),e.currentPageId=a),console.log(`[WebSocket] Extension connected with new browser: ${i}, pageId: ${a}`)}let o=x.get(a);o&&(o.extensionTabId=t.payload.tabId,o.url=t.payload.url??o.url);let s=b.register({browserId:i,tabId:t.payload.tabId,url:t.payload.url,metadata:{transport:`websocket`}});h.sendSessionAck(e,t.id??``,s.id,s.controlMode),h.broadcastPageCreated(i,a,x.get(a)?.url)}},onTaskResult:(e,t)=>{if(t.type===`task:result`){let e=g.submitResult({taskId:t.payload.taskId,success:t.payload.success,result:t.payload.result,error:t.payload.error});e?.browserId&&v.recordBrowserActivity(e.browserId,e.pageId)}},onTabMapped:(e,t)=>{if(t.type===`tab:mapped`){let e=x.get(t.payload.pageId);if(!e)return;e.extensionTabId=t.payload.tabId,v.recordBrowserActivity(e.browserId,e.id)}},onDisconnect:e=>{e.sessionId&&b.removeSession(e.sessionId),console.log(`[WebSocket] Extension disconnected: ${e.browserId}`)}});let C=new E(process.env.PORT_REGISTRY_PATH);console.log(l?` Registry path: ${l}`:` Registry path: default (~/.port-registry/ports.json)`);let w=await C.reservePort({repositoryPath:s,serviceName:t,serviceType:`tool`,environment:o,preferredPort:e,pid:process.pid,host:r.host,force:!0,portRange:T,metadata:{headless:r.headless,idleTimeout:r.idleTimeout}});if(!w.success||w.port===void 0)throw Error(w.error||`Failed to reserve port in range ${T.min}-${T.max}`);let D=w.port;w.record.metadata={...w.record.metadata,healthCheckUrl:`${c(r.host,D)}/health`};let O=ue({fetch:f.fetch,port:D,hostname:r.host});p(O),a=await ee({repositoryPath:s,serviceName:t,serviceType:`service`,environment:o,pid:process.pid,port:D,host:r.host,metadata:{healthCheckUrl:`${c(r.host,D)}/health`,headless:r.headless,idleTimeout:r.idleTimeout,transport:`http`}},d);let A=c(r.host,D);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 j=async e=>{console.log(`\n\n${e} received. Shutting down gracefully...`);try{S.stop(),O.close(),console.log(`Server closed`);try{await u.get(n.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`,()=>j(`SIGINT`)),process.on(`SIGTERM`,()=>j(`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)}}),Qt={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 $t(e){let t=new Set;for(let[n,r]of Object.entries(Qt))r.some(t=>e.includes(t))&&t.add(n);return t}const en=3e3,tn=[`browser_launch`],nn=[`browser_new_page`],rn=[`browser_close`],an=[`browser_close_page`];function on(e){if(!e?.content?.[0]?.text)return null;try{let t=JSON.parse(e.content[0].text);return{browserId:t.browserId,pageId:t.pageId,mode:t.mode,url:t.url,closedBrowserId:t.closedBrowserId,closedPageId:t.closedPageId,browserKeptOpen:t.browserKeptOpen}}catch{return null}}async function sn(e){await new Promise(t=>setTimeout(t,e))}async function cn(e){let t=new AbortController,n=setTimeout(()=>t.abort(),en);try{let n=await fetch(`${e}/tools`,{signal:t.signal});if(!n.ok)throw Error(`HTTP error ${n.status}: ${n.statusText}`);let r=await n.json();if(r.error)throw Error(r.error);if(!Array.isArray(r.tools))throw Error(`Invalid /tools response: missing tools array`);if(r.tools.length===0)throw Error(`HTTP server returned an empty tool list`);return r.tools}finally{clearTimeout(n)}}function ln(e,t){let n=new URL(`/custom-tools`,e);return n.searchParams.set(`dir`,t),n.toString()}async function un(e,t){let n=new AbortController,r=setTimeout(()=>n.abort(),en);try{let r=await fetch(ln(e,t),{signal:n.signal});if(!r.ok)throw Error(`HTTP error ${r.status}: ${r.statusText}`);let i=await r.json();if(i.error)throw Error(i.error);if(!Array.isArray(i.tools))throw Error(`Invalid /custom-tools response: missing tools array`);return i.tools}finally{clearTimeout(r)}}async function dn(e){let t;for(let n=1;n<=4;n+=1)try{return await cn(e)}catch(e){t=e instanceof Error?e:Error(String(e)),n<4&&await sn(150*n)}throw Error(`Failed to fetch tools after 4 attempts: ${t?.message??`Unknown error`}`,{cause:t})}async function fn(e,t){let n;for(let r=1;r<=4;r+=1)try{return await un(e,t)}catch(e){n=e instanceof Error?e:Error(String(e)),r<4&&await sn(150*r)}throw Error(`Failed to fetch custom tools after 4 attempts: ${n?.message??`Unknown error`}`,{cause:n})}function pn(e){if(!e?.tags?.length&&!e?.exclude?.length)return null;let t=e.tags?.length?$t(e.tags):null,n=new Set(e.exclude??[]);if(!t)return n.size>0?n:null;for(let e of n)t.delete(e);return t}function mn(e){let{httpBaseUrl:t,sessionTracker:n,defaultMode:r,toolFilter:i,customToolsDir:a,enforcedProfileName:s,proxyConfigDir:c}=e,l=i?.tags?.length?pn(i):null,u=new Set(i?.exclude??[]),d=l!==null||u.size>0,f=new ae({name:`browse-tool`,version:`0.1.0`},{capabilities:{tools:{}}}),p={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}},m=[],h=[],g=new Set;function _(e){return d?e.filter(e=>u.has(e.name)?!1:l===null?!0:l.has(e.name)):e}function v(e){return e.filter(e=>!u.has(e.name))}function y(e){return s?{...e,profileName:s}:e}function b(e){let t=o({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 x(e){if(!s)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===s);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 S(e){return{name:e.name,description:e.description,inputSchema:e.inputSchema,annotations:e.capabilities}}function C(e){return u.has(e)?!1:l===null?!0:l.has(e)}return f.setRequestHandler(se,async()=>{try{let e=await dn(t);m=e,g=new Set(e.map(e=>e.name));let r=a?await fn(t,a):[];h=r;let i=[..._(e),...v(r).map(e=>S(e))];return n&&i.push(p),{tools:i}}catch(e){if(m.length>0||h.length>0){console.error(`Failed to refresh tools from HTTP server. Returning cached tools:`,e instanceof Error?e.message:String(e));let t=[..._(m),...v(h).map(e=>S(e))];return n&&t.push(p),{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})}}),f.setRequestHandler(oe,async e=>{let{name:i,arguments:o}=e.params,s=new Set(h.map(e=>e.name));if(i!==`browser_list_session`&&!C(i))return{content:[{type:`text`,text:`Tool "${i}" is not available (filtered by --tags or --exclude)`}],isError:!0};if(i===`browser_list_session`&&n){let e=n.getSessionState();return{content:[{type:`text`,text:JSON.stringify(e,null,2)}]}}let c=o||{};i===`browser_launch`&&r&&c.mode===void 0&&(c={...c,mode:r}),i===`browser_launch`&&(c=y(c),c=b(c));try{if(a&&!s.has(i)&&!g.has(i))try{h=await fn(t,a),s=new Set(h.map(e=>e.name))}catch(e){console.error(`Failed to refresh custom tools, using cached list: ${e instanceof Error?e.message:String(e)}`)}let e=s.has(i),r=await fetch(e&&a?ln(t,a):`${t}/execute`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({tool:i,arguments:c})});if(!r.ok){let e=await r.text();return{content:[{type:`text`,text:`HTTP error ${r.status}: ${e}`}],isError:!0}}let o=await r.json();if(!o.success)return{content:[{type:`text`,text:o.error||o.result?.content?.[0]?.text||`Unknown error from HTTP server`}],isError:!0};if(n&&o.result){if(tn.includes(i)){let e=on(o.result);e?.browserId&&(n.trackBrowser(e.browserId,e.mode||`playwright`),e.pageId&&n.trackPage(e.pageId,e.browserId,e.url))}else if(nn.includes(i)){let e=on(o.result);e?.pageId&&e?.browserId&&n.trackPage(e.pageId,e.browserId,e.url)}else if(rn.includes(i)){let e=on(o.result);e?.closedBrowserId&&n.untrackBrowser(e.closedBrowserId)}else if(an.includes(i)){let e=on(o.result);e?.closedPageId&&n.untrackPage(e.closedPageId),e?.browserId&&e.browserKeptOpen===!1&&n.untrackBrowser(e.browserId)}}return i===`browser_list_profiles`&&o.result?x(o.result):o.result||{content:[{type:`text`,text:`No result returned`}]}}catch(e){return{content:[{type:`text`,text:`Failed to execute tool via HTTP server: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}}),f}const Q=`stdio`,hn=`http`,$=`streamable-http`,gn=new Set([Q,hn,$]),_n=`chromium`,vn=new Set([_n,`firefox`,`webkit`]),yn=new Set([`playwright`,`extension`,`vm`,`stealth`]),bn=`SIGINT`,xn=`SIGTERM`,Sn=`PLAYWRIGHT_PORT`,Cn=[`pnpm-workspace.yaml`,`nx.json`,`.git`],wn=`browse-tool-mcp-http`,Tn=`service`,En=T.min;var Dn=class extends Error{code=`INVALID_TRANSPORT`;recovery=`Use --type ${[...gn].join(`, `)}`;transportType;constructor(e,t){super(`Unknown transport type: ${e}`,t),this.name=`InvalidTransportError`,this.transportType=e}},On=class extends Error{code=`INVALID_BROWSER_TYPE`;recovery=`Use --browser ${[...vn].join(`, `)}`;browserType;constructor(e,t){super(`Unknown browser type: ${e}`,t),this.name=`InvalidBrowserTypeError`,this.browserType=e}},kn=class extends Error{code=`INVALID_LAUNCH_MODE`;recovery=`Use --mode ${[...yn].join(`, `)}`;launchMode;constructor(e,t){super(`Unknown launch mode: ${e}`,t),this.name=`InvalidLaunchModeError`,this.launchMode=e}};function An(e){let t=e.toLowerCase();if(!vn.has(t))throw new On(e);return t}function jn(e){let t=e.toLowerCase();if(!yn.has(t))throw new kn(e);return t}function Mn(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 Nn(e){return e!=null&&String(e).trim()!==``}function Pn(e){let t=e.toLowerCase();return t===hn?$:t}function Fn(e,t){let n=e[t];return(Array.isArray(n)?n[0]:n)?.trim()||void 0}function In(e=process.cwd()){let t=k.resolve(e);for(;;){for(let e of Cn)if(A(k.join(t,e)))return t;let e=k.dirname(t);if(e===t)return process.cwd();t=e}}function Ln(e){return e.split(`,`).map(e=>e.trim()).filter(e=>e.length>0)}function Rn(e){let t=e.tags?Ln(e.tags):void 0,n=e.exclude?Ln(e.exclude):void 0;if(!(!t?.length&&!n?.length))return{tags:t,exclude:n}}var zn=class extends Error{code=`BROWSER_CLEANUP_FAILED`;recovery=`Browsers may still be running; check the HTTP server or kill processes manually`;failedBrowserIds;httpBaseUrl;constructor(e,t,n){super(`Failed to close ${e.length} browser(s): ${e.join(`, `)}`,n),this.name=`BrowserCleanupError`,this.failedBrowserIds=e,this.httpBaseUrl=t}},Bn=class extends Error{code=`SESSION_SHUTDOWN_FAILED`;recovery=`Check logs for cleanup and transport errors; processes may need manual cleanup`;signal;constructor(e,t){super(`Shutdown failed for signal ${e}`,t),this.name=`SessionShutdownError`,this.signal=e}},Vn=class extends Error{code=`HTTP_SERVER_START_FAILED`;recovery=`Check if the HTTP server binary exists and the port is available`;constructor(e){super(`Failed to start HTTP server`,e),this.name=`HttpServerStartError`}},Hn=class extends Error{code=`MCP_SERVER_BOOTSTRAP_FAILED`;recovery=`Check if all dependencies are installed and try again`;constructor(e){super(`Failed to start MCP server`,e),this.name=`McpServerBootstrapError`}};async function Un(e,t){let n=e.getBrowserIds(),r=[],i;for(let e of n)try{let n=await fetch(`${t}/execute`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({tool:`browser_close`,arguments:{browserId:e}})});if(!n.ok){let e=await n.text().catch(()=>``);throw Error(`HTTP ${n.status} from ${t}/execute: ${e}`)}console.error(` Closed browser: ${e}`)}catch(t){let n=t instanceof Error?t:Error(String(t));console.error(` Failed to close browser: ${e}`,n),r.push(e),i??=n}if(r.length>0)throw new zn(r,t,{cause:i});e.clear()}async function Wn(e,t,n,r){await e.start();let i=!1,a=async a=>{if(i)return;i=!0,console.error(`\nReceived ${a}, shutting down gracefully...`);let o;try{let e=t.getSessionState();e.totalBrowsers>0&&(console.error(` Cleaning up ${e.totalBrowsers} browser(s) from this session...`),await Un(t,n))}catch(e){o=e instanceof Error?e:Error(String(e)),console.error(`Browser cleanup error:`,o)}finally{try{await e.stop()}catch(e){let t=e instanceof Error?e:Error(String(e));console.error(`Transport stop error:`,t),o??=t}try{await r?.()}catch(e){let t=e instanceof Error?e:Error(String(e));console.error(`Process registry cleanup error:`,t),o??=t}if(o){let e=new Bn(a,{cause:o});console.error(`Error during shutdown:`,e),process.exit(1)}process.exit(0)}};process.once(bn,()=>a(bn)),process.once(xn,()=>a(xn))}const Gn=new F(`mcp-serve`).description(`Start Playwright MCP server for browser automation`).option(`-t, --type <type>`,`Transport type: ${[Q,$].join(`, `)}`,Q).option(`-b, --browser <browser>`,`Default browser type: ${[...vn].join(`, `)}`,_n).option(`--headless`,`Run browsers in headless mode by default`,!1).option(`--no-headless`,`Run browsers in headed mode (visible window)`).option(`--host <host>`,`Default host for HTTP services`,g()).option(`--port <port>`,`Port for streamable HTTP transport`,String(En)).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: ${[...yn].join(`, `)}`).option(`--tags <tags>`,`Comma-separated tags to filter tools (e.g. input,navigation,snapshot)`).option(`--exclude <tools>`,`Comma-separated tool names to exclude (applied after --tags)`).option(`--custom-tools <path>`,`Path to a folder containing tools.yaml and custom tool scripts`).option(`--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(e){let t=B(`mcpServe`),r={type:V(this,`type`,e.type,t.type),browser:V(this,`browser`,e.browser,t.browser),headless:V(this,`headless`,e.headless,t.headless),profile:V(this,`profile`,e.profile,t.profile),mode:V(this,`mode`,e.mode,t.mode),host:V(this,`host`,e.host,t.host,process.env.PLAYWRIGHT_HOST),port:V(this,`port`,e.port,t.port,process.env.PLAYWRIGHT_MCP_PORT),httpPort:V(this,`httpPort`,e.httpPort,t.httpPort,process.env[Sn]),tags:V(this,`tags`,e.tags,t.tags),exclude:V(this,`exclude`,e.exclude,t.exclude),customTools:V(this,`customTools`,e.customTools,t.customTools),chromeForTestingPath:V(this,`chromeForTestingPath`,e.chromeForTestingPath,t.chromeForTestingPath,process.env[S]),snippetsDir:V(this,`snippetsDir`,e.snippetsDir,t.snippetsDir),idleTimeout:V(this,`idleTimeout`,e.idleTimeout,t.idleTimeout===void 0?void 0:String(t.idleTimeout),process.env[y]),registryPath:V(this,`registryPath`,e.registryPath,t.registryPath,process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH),registryDir:V(this,`registryDir`,e.registryDir,t.registryDir,process.env.PLAYWRIGHT_REGISTRY_DIR),pidsDir:V(this,`pidsDir`,e.pidsDir,t.pidsDir,process.env.PLAYWRIGHT_PIDS_DIR),profilesDir:V(this,`profilesDir`,e.profilesDir,t.profilesDir,process.env.PLAYWRIGHT_PROFILES_DIR),proxyConfigDir:V(this,`proxyConfigDir`,e.proxyConfigDir,t.proxyConfigDir,process.env[_])},i=Pn(r.type),a=In(process.cwd()),o=process.env.NODE_ENV||`development`,s,l;try{if(!gn.has(i))throw new Dn(i);let e=An(r.browser),t=r.mode?jn(r.mode):void 0,u=Mn(r.port??En),d=Nn(r.httpPort),p=d?Mn(r.httpPort):void 0,b=Rn(r),x=r.customTools?k.resolve(r.customTools):void 0,C=r.chromeForTestingPath?k.resolve(r.chromeForTestingPath):void 0,w=r.snippetsDir?k.resolve(r.snippetsDir):void 0;console.error(`Playwright MCP Server starting...`),console.error(` Transport: ${i}`),i===$&&console.error(` MCP endpoint: http://${r.host??g()}:${u}/mcp`),console.error(` Default browser: ${e}`),console.error(` Headless: ${r.headless}`),t&&console.error(` Default mode: ${t}`),r.profile&&console.error(` Profile: ${r.profile}`),b?.tags?.length&&console.error(` Tags: ${b.tags.join(`, `)}`),b?.exclude?.length&&console.error(` Exclude: ${b.exclude.join(`, `)}`),x&&console.error(` Custom tools: ${x}`),C&&console.error(` Chrome for Testing path: ${C}`),w&&console.error(` Snippets dir: ${w}`),r.idleTimeout&&console.error(` Idle timeout: ${r.idleTimeout} minutes`);let T=r.registryPath||r.registryDir;T&&(process.env.PLAYWRIGHT_REGISTRY_DIR=T,process.env.PORT_REGISTRY_PATH=T,process.env.PROCESS_REGISTRY_PATH=te(T,`processes.json`),console.error(` Registry path: ${T}`)),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[_]=k.resolve(r.proxyConfigDir),console.error(` Proxy config dir: ${process.env[_]}`)),w&&(process.env.BROWSE_TOOL_SNIPPETS_DIR=w),C&&(process.env[S]=C),r.idleTimeout&&(process.env[y]=r.idleTimeout),r.host&&(process.env.PLAYWRIGHT_HOST=r.host);let E=h(),D=E.get(n.ProcessRegistryService);l=await E.get(n.McpPortAllocationService).acquirePorts({repositoryPath:a,environment:o,host:r.host??g(),pid:process.pid,preferredMcpPort:i===$?u:void 0,preferredHttpPort:p,exactHttpPort:d,reserveMcpPort:i===$,mcpServiceName:wn,mcpServiceType:`tool`,mcpMetadata:i===$?{healthCheckUrl:`${c(r.host??g(),u)}/health`,transport:$}:void 0});let O=l.httpPort;process.env[Sn]=O.toString();let A=await E.get(n.HttpServerManager).ensureRunning(O,{exactPort:!0});if(!A.running)throw new Vn;let j=c(g(),A.port),ne=A.spawned?`spawned`:`reused`;if(console.error(` HTTP server: ${ne} on port ${A.port}`),i===Q){let n=new f,i=new m(mn({httpBaseUrl:j,sessionTracker:n,defaultMode:t,toolFilter:b,customToolsDir:x,enforcedProfileName:r.profile,proxyConfigDir:process.env[_]}));s=await ee({repositoryPath:a,serviceName:`browse-tool-mcp`,serviceType:Tn,environment:o,pid:process.pid,metadata:{transport:Q,browser:e,mode:t}},D),await Wn(i,n,j,async()=>{await s?.release({kill:!1}),await l?.release()});return}let M=l.mcpPort;if(!M)throw Error(`Failed to reserve ${$} port ${u}`);s=await ee({repositoryPath:a,serviceName:wn,serviceType:Tn,environment:o,pid:process.pid,port:M,host:r.host??g(),metadata:{healthCheckUrl:`${c(r.host??g(),M)}/health`,transport:$}},D);let re=new v(({headers:e})=>{let n=Fn(e,`x-profile`)??r.profile,i=new f;return{server:mn({httpBaseUrl:j,sessionTracker:i,defaultMode:t,toolFilter:b,customToolsDir:x,enforcedProfileName:n,proxyConfigDir:process.env[_]}),onClose:async()=>{i.getSessionState().totalBrowsers>0&&await Un(i,j)}}},{host:r.host??g(),port:M});try{await re.start()}catch(e){try{await s.release({kill:!1})}catch(e){console.error(`Process registry cleanup error:`,e)}throw await l.release(),l=void 0,e}let ie=!1,N=async e=>{if(!ie){ie=!0,console.error(`\nReceived ${e}, shutting down gracefully...`);try{await re.stop();try{await s?.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(bn,()=>N(bn)),process.once(xn,()=>N(xn))}catch(e){if(s)try{await s.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 Dn||e instanceof On||e instanceof kn||e instanceof Vn)&&(console.error(`Error [${e.code}]: ${e.message}`),console.error(`Recovery: ${e.recovery}`),process.exit(1));let t=new Hn({cause:e instanceof Error?e:Error(String(e))});console.error(`Error [${t.code}]: ${t.message}`,t.cause),console.error(`Recovery: ${t.recovery}`),process.exit(1)}}),Kn=new F(`status`).description(`Show status of HTTP server and diagnostics`).action(async()=>{try{let e=B(`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
|
|
434
|
-
`)}}function
|
|
431
|
+
`)})]}),R(`body`,{children:t})]})}function Jt(e){let t=new L;return t.get(`/`,async t=>{try{let n=e.get(r.BrowserService),i=e.get(r.PageRegistry),a=n.listBrowsers(),o=i.list(),s=a.map(e=>{let t=o.filter(t=>t.browserId===e.id);return{id:e.id,profileName:e.profileName,currentPageId:e.currentPageId,createdAt:e.createdAt,pages:t.map(e=>({id:e.id,url:e.url,title:e.title,createdAt:e.createdAt}))}}),c={totalBrowsers:a.length,totalPages:o.length};return t.html(R(qt,{title:`Playwright MCP Dashboard`,children:R(Kt,{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 Yt(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 Xt(e){try{return e.get(r.TelemetryService)}catch{return new f}}function Zt(e){let t=new L,n=e.get(r.PageRegistry),i=e.get(r.BrowserService),a=e.get(r.ExtensionTaskQueue),o=Xt(e),s=new At(n,a,o,i);t.use(`*`,me({origin:e=>e??null,credentials:!0,allowMethods:[`GET`,`POST`,`DELETE`,`OPTIONS`],allowHeaders:[`Content-Type`,`Accept`,`Authorization`]})),t.get(`/health`,e=>{try{let t=i.listBrowsers(),n={status:`healthy`,service:`browse-tool-http`,serviceName:`browse-tool-http`,timestamp:new Date().toISOString(),browsers:{count:t.length,instances:t.map(e=>({id:e.id,pageCount:e.pageIds.size,createdAt:e.createdAt.toISOString()}))}};return e.json(n)}catch(t){return e.json({status:`unhealthy`,service:`browse-tool-http`,serviceName:`browse-tool-http`,error:t instanceof Error?t.message:String(t)},503)}}),t.post(`/execute`,async t=>{try{let i=await t.req.json();if(!i.tool)return t.json({success:!1,error:`Missing "tool" field in request body`},400);let a=typeof i.arguments?.pageId==`string`?i.arguments.pageId:void 0;return await o.runInSpan(`browse_tool.http.execute`,{attributes:{"http.method":`POST`,"http.route":`/execute`,"browse_tool.tool.name":i.tool,"browse_tool.page.id":a}},async a=>{let s=e.getAll(r.Tool).find(e=>e.getDefinition().name===i.tool);if(process.env.BROWSE_TOOL_DEBUG_EXTENSION_RECORDING===`1`&&i.tool===`browser_launch`){let e=typeof i.arguments?.videoDir==`string`?i.arguments.videoDir:typeof i.arguments?.video_dir==`string`?i.arguments.video_dir:``;console.log(`[ExtensionRecordingDebug] http execute browser_launch mode=${String(i.arguments?.mode??``)} videoDir=${e}`)}if(!s)return a?.setStatus({code:F.ERROR,message:`Tool "${i.tool}" not found`}),o.log(`warn`,`browse-tool HTTP execute rejected unknown tool`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":i.tool}}),t.json({success:!1,error:`Tool "${i.tool}" not found`},404);let c=await w(t.req.header(T),()=>s.execute(i.arguments||{})),l=i.arguments||{},u=typeof l.pageId==`string`?l.pageId:void 0;if(u){let t=e.get(r.BrowserService),i=n.get(u);i&&t.recordBrowserActivity(i.browserId,u)}let d=Yt(c);return d?(a?.setStatus({code:F.ERROR,message:d}),o.log(`error`,`browse-tool HTTP execute failed`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":i.tool,"browse_tool.page.id":u}})):o.log(`info`,`browse-tool HTTP execute succeeded`,{attributes:{"http.route":`/execute`,"browse_tool.tool.name":i.tool,"browse_tool.page.id":u}}),t.json({success:!c.isError,result:c,error:d})})}catch(e){return o.log(`error`,`browse-tool HTTP execute request crashed`,{attributes:{"http.route":`/execute`},exception:e}),t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}}),t.get(`/browsers`,t=>{try{let n=e.get(r.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(r.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 s.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 i=t.req.query(`dir`);if(!i)return t.json({success:!1,error:`Missing "dir" query parameter`},400);try{let a=await t.req.json();if(!a.tool)return t.json({success:!1,error:`Missing "tool" field in request body`},400);let c=typeof a.arguments?.pageId==`string`?a.arguments.pageId:void 0;return await o.runInSpan(`browse_tool.http.custom_tool.execute`,{attributes:{"http.method":`POST`,"http.route":`/custom-tools`,"browse_tool.tool.name":a.tool,"browse_tool.page.id":c,"browse_tool.custom_tools.directory":i}},async l=>{let u=await w(t.req.header(T),()=>s.executeTool(i,a.tool,a.arguments||{}));if(c){let t=e.get(r.BrowserService),i=n.get(c);i&&t.recordBrowserActivity(i.browserId,c)}let d=Yt(u);return d?(l?.setStatus({code:F.ERROR,message:d}),o.log(`error`,`browse-tool custom tool execution failed`,{attributes:{"http.route":`/custom-tools`,"browse_tool.tool.name":a.tool,"browse_tool.page.id":c}})):o.log(`info`,`browse-tool custom tool execution succeeded`,{attributes:{"http.route":`/custom-tools`,"browse_tool.tool.name":a.tool,"browse_tool.page.id":c}}),t.json({success:!u.isError,result:u,error:d})})}catch(e){return o.log(`error`,`browse-tool custom tool request crashed`,{attributes:{"http.route":`/custom-tools`,"browse_tool.custom_tools.directory":i},exception:e}),t.json({success:!1,error:e instanceof Error?e.message:String(e)},500)}});let c=xe(e);t.route(`/extension`,c);let l=jt(e);t.route(`/api`,l);let u=Jt(e);return t.route(`/`,u),t}function Qt(e,t,n){e.get(`/ws/extension/:browserId`,n(e=>{let n=e.req.param(`browserId`),i=null;return{onOpen(e,a){if(!n){a.close(1008,`Missing browserId`);return}try{i=t.get(r.WebSocketHub).addConnection(a,n)}catch{a.close(1011,`Internal server error`)}},onMessage(e){if(i)try{let n=t.get(r.WebSocketHub),a=typeof e.data==`string`?e.data:e.data.toString();n.handleMessage(i,a)}catch{}},onClose(){if(i)try{t.get(r.WebSocketHub).removeConnection(i)}catch{}},onError(){if(i)try{t.get(r.WebSocketHub).removeConnection(i)}catch{}}}})),e.get(`/ws/stats`,e=>{try{let n=t.get(r.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 $t=[`pnpm-workspace.yaml`,`nx.json`,`.git`];function en(e=process.cwd()){let t=j.resolve(e);for(;;){for(let e of $t)if(M(j.join(t,e)))return t;let e=j.dirname(t);if(e===t)return process.cwd();t=e}}const tn=new I(`http-serve`).description(`Start HTTP server for browser automation`).option(`-p, --port <port>`,`Port to listen on`,String(u)).option(`--host <host>`,`Host to bind`,y()).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`).action(async function(e){let t=V(`httpServe`),n={port:H(this,`port`,e.port,t.port===void 0?void 0:String(t.port),process.env.PLAYWRIGHT_PORT),headless:H(this,`headless`,e.headless,t.headless),idleTimeout:H(this,`idleTimeout`,e.idleTimeout,t.idleTimeout===void 0?void 0:String(t.idleTimeout),process.env[x]),host:H(this,`host`,e.host,t.host,process.env.PLAYWRIGHT_HOST),registryDir:H(this,`registryDir`,e.registryDir,t.registryDir,process.env.PLAYWRIGHT_REGISTRY_DIR),registryPath:H(this,`registryPath`,e.registryPath,t.registryPath,process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH),pidsDir:H(this,`pidsDir`,e.pidsDir,t.pidsDir,process.env.PLAYWRIGHT_PIDS_DIR),profilesDir:H(this,`profilesDir`,e.profilesDir,t.profilesDir,process.env.PLAYWRIGHT_PROFILES_DIR),snippetsDir:H(this,`snippetsDir`,e.snippetsDir,t.snippetsDir,process.env.BROWSE_TOOL_SNIPPETS_DIR),proxyConfigDir:H(this,`proxyConfigDir`,e.proxyConfigDir,t.proxyConfigDir,process.env[b])},i;try{let e=Number.parseInt(n.port,10),t=`browse-tool-http`,a=process.env.NODE_ENV||`development`,o=en(process.cwd()),c=n.registryPath||n.registryDir||process.env.PLAYWRIGHT_REGISTRY_PATH;c&&(process.env.PLAYWRIGHT_REGISTRY_DIR=c,process.env.PORT_REGISTRY_PATH=c,process.env.PROCESS_REGISTRY_PATH=te(c,`processes.json`)),process.env.PLAYWRIGHT_HOST=n.host,process.env.PLAYWRIGHT_PORT=n.port,process.env[x]=n.idleTimeout,n.pidsDir&&(process.env.PLAYWRIGHT_PIDS_DIR=n.pidsDir),n.profilesDir&&(process.env.PLAYWRIGHT_PROFILES_DIR=n.profilesDir),n.snippetsDir&&(process.env.BROWSE_TOOL_SNIPPETS_DIR=j.resolve(n.snippetsDir)),n.proxyConfigDir&&(process.env[b]=j.resolve(n.proxyConfigDir)),console.log(`Starting HTTP server for browser automation...`),console.log(` Port: ${e}`),console.log(` Host: ${n.host}`),console.log(` Headless: ${n.headless}`),console.log(` Idle Timeout: ${n.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[b]}`);let l=s(),u=l.get(r.ProcessRegistryService),f=Zt(l),{injectWebSocket:p,upgradeWebSocket:m}=he({app:f});Qt(f,l,m);let h=l.get(r.WebSocketHub),g=l.get(r.ExtensionTaskQueue),_=l.get(r.BrowserService),v=l.get(r.ExtensionSessionRegistry),y=l.get(r.PageRegistry),ee=l.get(r.IdleCleanupService);ee.start(),h.setEventHandlers({onSessionRegister:(e,t)=>{if(t.type===`session:register`){let n=t.payload.browserId||e.browserId,r=_.getBrowser(n),i,a;if(r&&(r.mode===`extension`||r.mode===`vm`)){i=r.id;let t=y.findByBrowser(i);a=r.currentPageId||t[0]?.id||``,h.reassignConnection(e.id,i),a||(a=y.registerExtensionPage(i),r.pageIds.add(a),r.currentPageId=a),console.log(`[WebSocket] Extension connected to existing browser: ${i}, pageId: ${a}`)}else{i=n,_.registerExtensionBrowserWithId(i),a=y.registerExtensionPage(i);let e=_.getBrowser(i);e&&(e.pageIds.add(a),e.currentPageId=a),console.log(`[WebSocket] Extension connected with new browser: ${i}, pageId: ${a}`)}let o=y.get(a);o&&(o.extensionTabId=t.payload.tabId,o.url=t.payload.url??o.url);let s=v.register({browserId:i,tabId:t.payload.tabId,url:t.payload.url,metadata:{transport:`websocket`}});h.sendSessionAck(e,t.id??``,s.id,s.controlMode),h.broadcastPageCreated(i,a,y.get(a)?.url)}},onTaskResult:(e,t)=>{if(t.type===`task:result`){let e=g.submitResult({taskId:t.payload.taskId,success:t.payload.success,result:t.payload.result,error:t.payload.error});e?.browserId&&_.recordBrowserActivity(e.browserId,e.pageId)}},onTabMapped:(e,t)=>{if(t.type===`tab:mapped`){let e=y.get(t.payload.pageId);if(!e)return;e.extensionTabId=t.payload.tabId,_.recordBrowserActivity(e.browserId,e.id)}},onDisconnect:e=>{e.sessionId&&v.removeSession(e.sessionId),console.log(`[WebSocket] Extension disconnected: ${e.browserId}`)}});let S=new O(process.env.PORT_REGISTRY_PATH);console.log(c?` Registry path: ${c}`:` Registry path: default (~/.port-registry/ports.json)`);let C=await S.reservePort({repositoryPath:o,serviceName:t,serviceType:`tool`,environment:a,preferredPort:e,pid:process.pid,host:n.host,force:!0,portRange:D,metadata:{headless:n.headless,idleTimeout:n.idleTimeout}});if(!C.success||C.port===void 0)throw Error(C.error||`Failed to reserve port in range ${D.min}-${D.max}`);let w=C.port;C.record.metadata={...C.record.metadata,healthCheckUrl:`${d(n.host,w)}/health`};let T=pe({fetch:f.fetch,port:w,hostname:n.host});p(T),i=await k({repositoryPath:o,serviceName:t,serviceType:`service`,environment:a,pid:process.pid,port:w,host:n.host,metadata:{healthCheckUrl:`${d(n.host,w)}/health`,headless:n.headless,idleTimeout:n.idleTimeout,transport:`http`}},u);let E=d(n.host,w);console.log(`HTTP server listening on ${E}`),console.log(` Health check: ${E}/health`),console.log(` Execute tool: POST ${E}/execute`),console.log(`
|
|
432
|
+
Press Ctrl+C to stop the server`);let A=async e=>{console.log(`\n\n${e} received. Shutting down gracefully...`);try{ee.stop(),T.close(),console.log(`Server closed`);try{await l.get(r.BrowserService).closeAll(),console.log(`All browsers closed`)}catch{}try{i&&await i.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`,()=>A(`SIGINT`)),process.on(`SIGTERM`,()=>A(`SIGTERM`)),await new Promise(()=>{})}catch(e){if(i)try{await i.release({kill:!1})}catch(e){console.error(`Process registry cleanup error:`,e)}console.error(`Error starting HTTP server:`,e),process.exit(1)}}),nn={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 rn(e){let t=new Set;for(let[n,r]of Object.entries(nn))r.some(t=>e.includes(t))&&t.add(n);return t}const an=3e3,on=[`browser_launch`],sn=[`browser_new_page`],cn=[`browser_close`],ln=[`browser_close_page`];function un(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 dn(e){await new Promise(t=>setTimeout(t,e))}async function fn(e){let t=new AbortController,n=setTimeout(()=>t.abort(),an);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 pn(e,t){let n=new URL(`/custom-tools`,e);return n.searchParams.set(`dir`,t),n.toString()}async function mn(e,t){let n=new AbortController,r=setTimeout(()=>n.abort(),an);try{let r=await fetch(pn(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 hn(e){let t;for(let n=1;n<=4;n+=1)try{return await fn(e)}catch(e){t=e instanceof Error?e:Error(String(e)),n<4&&await dn(150*n)}throw Error(`Failed to fetch tools after 4 attempts: ${t?.message??`Unknown error`}`,{cause:t})}async function gn(e,t){let n;for(let r=1;r<=4;r+=1)try{return await mn(e,t)}catch(e){n=e instanceof Error?e:Error(String(e)),r<4&&await dn(150*r)}throw Error(`Failed to fetch custom tools after 4 attempts: ${n?.message??`Unknown error`}`,{cause:n})}function _n(e){if(!e?.tags?.length&&!e?.exclude?.length)return null;let t=e.tags?.length?rn(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 vn(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 yn(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 bn(e){let{httpBaseUrl:t,sessionTracker:n,defaultMode:r,toolFilter:i,customToolsDir:a,enforcedProfileName:o,proxyConfigDir:s,ownerId:c}=e,u=i?.tags?.length?_n(i):null,d=new Set(i?.exclude??[]),f=u!==null||d.size>0,p=vn({defaultMode:r,enforcedProfileName:o}),m=new ce({name:`browse-tool`,version:`0.1.0`},{capabilities:{tools:{}}}),h={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}},g=[],_=[],v=new Set;function y(e){return f?e.filter(e=>d.has(e.name)?!1:u===null?!0:u.has(e.name)):e}function b(e){return e.filter(e=>!d.has(e.name))}function ee(e){return o?{...e,profileName:o}:e}function x(e){let t=l({proxy:e.proxy,profileName:typeof e.profileName==`string`?e.profileName:void 0,proxyConfigDir:s});if(!t){let t={...e};return delete t.proxy,t}return{...e,proxy:t}}function S(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 C(e){return{name:e.name,description:e.description,inputSchema:e.inputSchema,annotations:e.capabilities}}function w(e){return d.has(e)?!1:u===null?!0:u.has(e)}return m.setRequestHandler(ue,async()=>{try{let e=await hn(t);g=e,v=new Set(e.map(e=>e.name));let r=a?await gn(t,a):[];_=r;let i=[...y(e).map(e=>yn(e,p)),...b(r).map(e=>C(e))];return n&&i.push(h),{tools:i}}catch(e){if(g.length>0||_.length>0){console.error(`Failed to refresh tools from HTTP server. Returning cached tools:`,e instanceof Error?e.message:String(e));let t=[...y(g).map(e=>yn(e,p)),...b(_).map(e=>C(e))];return n&&t.push(h),{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})}}),m.setRequestHandler(le,async e=>{let{name:i,arguments:o}=e.params,s=new Set(_.map(e=>e.name));if(i!==`browser_list_session`&&!w(i))return{content:[{type:`text`,text:`Tool "${i}" is not available (filtered by --tags or --exclude)`}],isError:!0};if(i===`browser_list_session`&&n){let e=n.getSessionState();return{content:[{type:`text`,text:JSON.stringify(e,null,2)}]}}let l=o||{};i===`browser_launch`&&r&&l.mode===void 0&&(l={...l,mode:r}),i===`browser_launch`&&(l=ee(l),l=x(l));try{if(a&&!s.has(i)&&!v.has(i))try{_=await gn(t,a),s=new Set(_.map(e=>e.name))}catch(e){console.error(`Failed to refresh custom tools, using cached list: ${e instanceof Error?e.message:String(e)}`)}let e=s.has(i),r=await fetch(e&&a?pn(t,a):`${t}/execute`,{method:`POST`,headers:c?{"Content-Type":`application/json`,[T]:c}:{"Content-Type":`application/json`},body:JSON.stringify({tool:i,arguments:l})});if(!r.ok){let e=await r.text();return{content:[{type:`text`,text:`HTTP error ${r.status}: ${e}`}],isError:!0}}let o=await r.json();if(!o.success)return{content:[{type:`text`,text:o.error||o.result?.content?.[0]?.text||`Unknown error from HTTP server`}],isError:!0};if(n&&o.result){if(on.includes(i)){let e=un(o.result);e?.browserId&&(n.trackBrowser(e.browserId,e.mode||`playwright`),e.pageId&&n.trackPage(e.pageId,e.browserId,e.url))}else if(sn.includes(i)){let e=un(o.result);e?.pageId&&e?.browserId&&n.trackPage(e.pageId,e.browserId,e.url)}else if(cn.includes(i)){let e=un(o.result);e?.closedBrowserId&&n.untrackBrowser(e.closedBrowserId)}else if(ln.includes(i)){let e=un(o.result);e?.closedPageId&&n.untrackPage(e.closedPageId),e?.browserId&&e.browserKeptOpen===!1&&n.untrackBrowser(e.browserId)}}return i===`browser_list_profiles`&&o.result?S(o.result):o.result||{content:[{type:`text`,text:`No result returned`}]}}catch(e){return{content:[{type:`text`,text:`Failed to execute tool via HTTP server: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}}),m}const Q=`stdio`,xn=`http`,$=`streamable-http`,Sn=new Set([Q,xn,$]),Cn=`chromium`,wn=new Set([Cn,`firefox`,`webkit`]),Tn=new Set([`playwright`,`extension`,`vm`,`stealth`]),En=`SIGINT`,Dn=`SIGTERM`,On=`PLAYWRIGHT_PORT`,kn=[`pnpm-workspace.yaml`,`nx.json`,`.git`],An=`browse-tool-mcp-http`,jn=`service`,Mn=D.min;var Nn=class extends Error{code=`INVALID_TRANSPORT`;recovery=`Use --type ${[...Sn].join(`, `)}`;transportType;constructor(e,t){super(`Unknown transport type: ${e}`,t),this.name=`InvalidTransportError`,this.transportType=e}},Pn=class extends Error{code=`INVALID_BROWSER_TYPE`;recovery=`Use --browser ${[...wn].join(`, `)}`;browserType;constructor(e,t){super(`Unknown browser type: ${e}`,t),this.name=`InvalidBrowserTypeError`,this.browserType=e}},Fn=class extends Error{code=`INVALID_LAUNCH_MODE`;recovery=`Use --mode ${[...Tn].join(`, `)}`;launchMode;constructor(e,t){super(`Unknown launch mode: ${e}`,t),this.name=`InvalidLaunchModeError`,this.launchMode=e}};function In(e){let t=e.toLowerCase();if(!wn.has(t))throw new Pn(e);return t}function Ln(e){let t=e.toLowerCase();if(!Tn.has(t))throw new Fn(e);return t}function Rn(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 zn(e){return e!=null&&String(e).trim()!==``}function Bn(e){let t=e.toLowerCase();return t===xn?$:t}function Vn(e,t){let n=e[t];return(Array.isArray(n)?n[0]:n)?.trim()||void 0}function Hn(e=process.cwd()){let t=j.resolve(e);for(;;){for(let e of kn)if(M(j.join(t,e)))return t;let e=j.dirname(t);if(e===t)return process.cwd();t=e}}function Un(e){return e.split(`,`).map(e=>e.trim()).filter(e=>e.length>0)}function Wn(e){let t=e.tags?Un(e.tags):void 0,n=e.exclude?Un(e.exclude):void 0;if(!(!t?.length&&!n?.length))return{tags:t,exclude:n}}var Gn=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}},Kn=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`}},Jn=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 Yn(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`,[T]: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 Gn(i,t,{cause:a});e.clear()}async function Xn(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 Yn(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 Kn(o,{cause:s});console.error(`Error during shutdown:`,e),process.exit(1)}process.exit(0)}};process.once(En,()=>o(En)),process.once(Dn,()=>o(Dn))}const Zn=new I(`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: ${[...wn].join(`, `)}`,Cn).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`,y()).option(`--port <port>`,`Port for streamable HTTP transport`,String(Mn)).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: ${[...Tn].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(e){let t=V(`mcpServe`),n={type:H(this,`type`,e.type,t.type),browser:H(this,`browser`,e.browser,t.browser),headless:H(this,`headless`,e.headless,t.headless),profile:H(this,`profile`,e.profile,t.profile),mode:H(this,`mode`,e.mode,t.mode),host:H(this,`host`,e.host,t.host,process.env.PLAYWRIGHT_HOST),port:H(this,`port`,e.port,t.port,process.env.PLAYWRIGHT_MCP_PORT),httpPort:H(this,`httpPort`,e.httpPort,t.httpPort,process.env[On]),tags:H(this,`tags`,e.tags,t.tags),exclude:H(this,`exclude`,e.exclude,t.exclude),customTools:H(this,`customTools`,e.customTools,t.customTools),chromeForTestingPath:H(this,`chromeForTestingPath`,e.chromeForTestingPath,t.chromeForTestingPath,process.env[C]),snippetsDir:H(this,`snippetsDir`,e.snippetsDir,t.snippetsDir),idleTimeout:H(this,`idleTimeout`,e.idleTimeout,t.idleTimeout===void 0?void 0:String(t.idleTimeout),process.env[x]),registryPath:H(this,`registryPath`,e.registryPath,t.registryPath,process.env.PLAYWRIGHT_REGISTRY_PATH??process.env.PORT_REGISTRY_PATH),registryDir:H(this,`registryDir`,e.registryDir,t.registryDir,process.env.PLAYWRIGHT_REGISTRY_DIR),pidsDir:H(this,`pidsDir`,e.pidsDir,t.pidsDir,process.env.PLAYWRIGHT_PIDS_DIR),profilesDir:H(this,`profilesDir`,e.profilesDir,t.profilesDir,process.env.PLAYWRIGHT_PROFILES_DIR),proxyConfigDir:H(this,`proxyConfigDir`,e.proxyConfigDir,t.proxyConfigDir,process.env[b])},i=Bn(n.type),a=Hn(process.cwd()),o=process.env.NODE_ENV||`development`,s,c;try{if(!Sn.has(i))throw new Nn(i);let e=In(n.browser),t=n.mode?Ln(n.mode):void 0,l=Rn(n.port??Mn),u=zn(n.httpPort),f=u?Rn(n.httpPort):void 0,p=Wn(n),m=n.customTools?j.resolve(n.customTools):void 0,g=n.chromeForTestingPath?j.resolve(n.chromeForTestingPath):void 0,S=n.snippetsDir?j.resolve(n.snippetsDir):void 0;console.error(`Playwright MCP Server starting...`),console.error(` Transport: ${i}`),i===$&&console.error(` MCP endpoint: http://${n.host??y()}:${l}/mcp`),console.error(` Default browser: ${e}`),console.error(` Headless: ${n.headless}`),t&&console.error(` Default mode: ${t}`),n.profile&&console.error(` Profile: ${n.profile}`),p?.tags?.length&&console.error(` Tags: ${p.tags.join(`, `)}`),p?.exclude?.length&&console.error(` Exclude: ${p.exclude.join(`, `)}`),m&&console.error(` Custom tools: ${m}`),g&&console.error(` Chrome for Testing path: ${g}`),S&&console.error(` Snippets dir: ${S}`),n.idleTimeout&&console.error(` Idle timeout: ${n.idleTimeout} minutes`);let w=n.registryPath||n.registryDir;w&&(process.env.PLAYWRIGHT_REGISTRY_DIR=w,process.env.PORT_REGISTRY_PATH=w,process.env.PROCESS_REGISTRY_PATH=te(w,`processes.json`),console.error(` Registry path: ${w}`)),n.pidsDir&&(process.env.PLAYWRIGHT_PIDS_DIR=n.pidsDir,console.error(` PIDs dir: ${n.pidsDir}`)),n.profilesDir&&(process.env.PLAYWRIGHT_PROFILES_DIR=n.profilesDir,console.error(` Profiles dir: ${n.profilesDir}`)),n.proxyConfigDir&&(process.env[b]=j.resolve(n.proxyConfigDir),console.error(` Proxy config dir: ${process.env[b]}`)),S&&(process.env.BROWSE_TOOL_SNIPPETS_DIR=S),g&&(process.env[C]=g),n.idleTimeout&&(process.env[x]=n.idleTimeout),n.host&&(process.env.PLAYWRIGHT_HOST=n.host);let T=v(),E=T.get(r.ProcessRegistryService);c=await T.get(r.McpPortAllocationService).acquirePorts({repositoryPath:a,environment:o,host:n.host??y(),pid:process.pid,preferredMcpPort:i===$?l:void 0,preferredHttpPort:f,exactHttpPort:u,reserveMcpPort:i===$,mcpServiceName:An,mcpServiceType:`tool`,mcpMetadata:i===$?{healthCheckUrl:`${d(n.host??y(),l)}/health`,transport:$}:void 0});let D=c.httpPort;process.env[On]=D.toString();let O=await T.get(r.HttpServerManager).ensureRunning(D,{exactPort:!0});if(!O.running)throw new qn;let A=d(y(),O.port),ne=O.spawned?`spawned`:`reused`;if(console.error(` HTTP server: ${ne} on port ${O.port}`),i===Q){let r=new h,i=se(),l=new _(bn({httpBaseUrl:A,sessionTracker:r,defaultMode:t,toolFilter:p,customToolsDir:m,enforcedProfileName:n.profile,proxyConfigDir:process.env[b],ownerId:i}));s=await k({repositoryPath:a,serviceName:`browse-tool-mcp`,serviceType:jn,environment:o,pid:process.pid,metadata:{transport:Q,browser:e,mode:t}},E),await Xn(l,r,A,i,async()=>{await s?.release({kill:!1}),await c?.release()});return}let M=c.mcpPort;if(!M)throw Error(`Failed to reserve ${$} port ${l}`);s=await k({repositoryPath:a,serviceName:An,serviceType:jn,environment:o,pid:process.pid,port:M,host:n.host??y(),metadata:{healthCheckUrl:`${d(n.host??y(),M)}/health`,transport:$}},E);let re=new ee(({headers:e})=>{let r=Vn(e,`x-profile`)??n.profile,i=new h,a=se();return{server:bn({httpBaseUrl:A,sessionTracker:i,defaultMode:t,toolFilter:p,customToolsDir:m,enforcedProfileName:r,proxyConfigDir:process.env[b],ownerId:a}),onClose:async()=>{i.getSessionState().totalBrowsers>0&&await Yn(i,A,a)}}},{host:n.host??y(),port:M});try{await re.start()}catch(e){try{await s.release({kill:!1})}catch(e){console.error(`Process registry cleanup error:`,e)}throw await c.release(),c=void 0,e}let ie=!1,N=async e=>{if(!ie){ie=!0,console.error(`\nReceived ${e}, shutting down gracefully...`);try{await re.stop();try{await s?.release({kill:!1})}catch(e){console.error(`Process registry cleanup error:`,e)}await c?.release(),c=void 0,process.exit(0)}catch(e){console.error(`Transport stop error:`,e),process.exit(1)}}};process.once(En,()=>N(En)),process.once(Dn,()=>N(Dn))}catch(e){if(s)try{await s.release({kill:!1})}catch(e){console.error(`Process registry cleanup error:`,e)}if(c)try{await c.release()}catch(e){console.error(`Port allocation cleanup error:`,e)}(e instanceof Nn||e instanceof Pn||e instanceof Fn||e instanceof qn)&&(console.error(`Error [${e.code}]: ${e.message}`),console.error(`Recovery: ${e.recovery}`),process.exit(1));let t=new Jn({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)}}),Qn=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 m().get(r.HttpServerManager).getStatus();if(n.running){let t=process.env.PLAYWRIGHT_HOST??e.host??y();console.log(`HTTP Server: Running`),console.log(` PID: ${n.pid}`),console.log(` Port: ${n.port}`),console.log(` Health: ${d(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)}}),$n=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 m().get(r.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)}}),er=new Set([`--config`]);function tr(e){for(let t=0;t<e.length;t+=1){let n=e[t];if(er.has(n)){t+=1;continue}if(![...er].some(e=>n.startsWith(`${e}=`))&&!n.startsWith(`-`))return n}}function nr(e,t=!1){if(t)return!1;let n=tr(e);return n?n===`tools`?!0:n===`help`&&e.includes(`tools`):!1}function rr(e){return e.replace(/_/g,`-`)}function ir(e){return e.replace(/([a-z])([A-Z])/g,`$1-$2`).toLowerCase()}function ar(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 or(e,t){let n=ar(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 sr(e,t){let n=ir(e),r=ar(t);return t.type===`boolean`?`--${n}`:r.has(`boolean`)&&r.has(`object`)?`--${n} [value]`:`--${n} <value>`}function cr(e){let{definition:t,execute:n}=e,r=new I(rr(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=sr(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-${ir(e)}`,`Disable ${a}`):r.option(i,a,n.default):n.enum&&n.enum.length>0?r.addOption(new fe(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??u),r.port===void 0?void 0:String(r.port),process.env.PLAYWRIGHT_PORT),l={format:i,color:s},d=Je(t.name);try{let r={};for(let[t,n]of Object.entries(a)){let i=n,a=ir(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`)&&d[t]!==void 0&&(s=d[t]),s===void 0&&i.default!==void 0&&(s=i.default),s!==void 0&&(typeof s==`string`&&i.type!==`string`?r[t]=or(s,i):r[t]=s)}for(let e of o)if(r[e]===void 0){let t=ir(e);console.error(G(`Missing required option: --${t}`,l.color)),process.exit(1)}let i=Number.parseInt(c,10),s=U({port:i}),u=n?await n(r,{command:this,formatterOptions:l,port:i}):await s.execute(t.name,r),f=Ze(u,l);f&&console.log(f),u.isError&&process.exit(1)}catch(e){console.error(G(e instanceof Error?e:String(e),l.color)),process.exit(1)}}),r}function lr(e){return e.map(cr)}const ur={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 dr(){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(u))}function fr(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 pr(){return{definition:ur,execute:async(e,t)=>{let n=await U({port:t.port}).listBrowsers();return{content:[{type:`text`,text:JSON.stringify(fr(n),null,2)}]}}}}function mr(e){return[...e.map(e=>({definition:e})),pr()]}async function hr(e,t){let n=V(`tools`),r=Number(t?.port??process.env.PLAYWRIGHT_PORT??n.port??u);try{let t=lr(mr(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 gr(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 _r(){let e=qe(process.argv.slice(2)),t=process.env.PLAYWRIGHT_PORT??e.config.commands.tools?.port??e.config.commands.exec?.port??u,n=new I;n.name(`browse-tool`).description(`MCP server for browser automation using Playwright with profile management, page registry, and multi-browser support`).option(`--config <path>`,`Path to browse-tool config file or config directory`).version(ve),n.addCommand(Zn),n.addCommand(tn),n.addCommand(Ne),n.addCommand(ct),n.addCommand($n),n.addCommand(Qn),n.addCommand(lt),n.addCommand(ot),n.addCommand(st);let r=dr();nr(process.argv.slice(2),process.env.PLAYWRIGHT_SKIP_DYNAMIC_TOOL_COMMANDS===`1`)&&await hr(r,{port:gr(process.argv.slice(2),t)}),n.addCommand(r),await n.parseAsync(process.argv)}_r().catch(e=>{console.error(e instanceof Error?e.message:String(e)),process.exit(1)});export{};
|
package/dist/index.cjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./streamable-http-
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./streamable-http-UNuTiSXW.cjs`);let t=require(`zod`),n=require(`@agimon-ai/foundation-validator`),r=require(`@modelcontextprotocol/sdk/server/index.js`),i=require(`@modelcontextprotocol/sdk/types.js`),a=require(`liquidjs`);function o(e){return typeof e==`string`||typeof e==`number`||typeof e==`boolean`?e:JSON.stringify(e)}function s(e){if(!e)return;let t={};for(let[n,r]of Object.entries(e))r!=null&&(t[n]=o(r));return Object.keys(t).length>0?t:void 0}function c(){let t=new e.g({serviceName:`browse-tool-mcp`});return{debug(e,n){t.log(`debug`,e,{attributes:s(n)})},info(e,n){t.log(`info`,e,{attributes:s(n)})},warn(e,n){t.log(`warn`,e,{attributes:s(n)})},error(e,n){t.log(`error`,e,{attributes:s(n)})}}}var l=class extends Error{code=`UNKNOWN_TOOL`;recovery=`Use ListTools to see available tools.`;availableTools;constructor(e,t,n){super(`Unknown tool: ${e}. Available tools: ${t.slice(0,5).join(`, `)}${t.length>5?`, ... (${t.length} total)`:``}. Use ListTools to see all available tools.`,n),this.name=`UnknownToolError`,this.availableTools=t}},u=class extends Error{code=`TOOL_EXECUTION_ERROR`;recovery;toolName;constructor(e,t,n){super(`Tool execution failed for '${e}': ${t}`,n),this.name=`ToolExecutionError`,this.toolName=e,this.recovery=n?.recovery??`Check tool inputs and try again.`}};function d(e,t){let n=e instanceof Error?e.message:`Unknown error occurred`,r={error:{code:e instanceof Error&&`code`in e?e.code:`TOOL_EXECUTION_ERROR`,message:n,toolName:t,recovery:e instanceof Error&&`recovery`in e?e.recovery:`Check tool inputs and try again.`}};return{content:[{type:`text`,text:JSON.stringify(r,null,2)}],isError:!0}}function f(a){let o=a?.container??e.r,s=a?.logger??c(),f=new r.Server({name:`browse-tool`,version:`0.1.0`},{capabilities:{tools:{}}}),p=o.getAll(e.O.Tool),m=new Map;for(let e of p){let t=e.getDefinition();m.set(t.name,e)}return s.info(`MCP server initialized`,{toolCount:p.length}),f.setRequestHandler(i.ListToolsRequestSchema,async()=>(s.debug(`ListTools request received`),{tools:p.map(e=>e.getDefinition())})),f.setRequestHandler(i.CallToolRequestSchema,async e=>{let{name:r,arguments:i}=e.params;s.debug(`Tool call received`,{toolName:r,timestamp:new Date().toISOString()});let a=m.get(r);if(!a){let e=Array.from(m.keys());throw s.warn(`Unknown tool requested`,{toolName:r,availableTools:e,timestamp:new Date().toISOString()}),new l(r,e)}let o=(0,n.coerceArgs)(i??{},a.getInputSchema());try{let e=a.getInputSchema().parse(o);return await a.execute(e)}catch(e){if(e instanceof t.z.ZodError)return s.warn(`Tool input validation failed`,{toolName:r,timestamp:new Date().toISOString()}),{content:[{type:`text`,text:(0,n.formatZodError)(e,{schemaName:r,schema:a.getInputSchema()})}],isError:!0};let i=e instanceof u?e:new u(r,e instanceof Error?e.message:String(e),{cause:e});return s.error(`Tool execution failed`,{toolName:r,error:i.message,code:i.code,timestamp:new Date().toISOString()}),d(i,r)}}),f}var p='Create a browse-tool custom tool folder for use with `browse-tool mcp-serve --custom-tools <dir>`.\n\nGoal: {{ toolGoal }}\nPreferred tool name: {{ preferredToolName }}\nPage context: {{ pageContext }}\n\nRequirements:\n- Produce a `tools.yaml` file with a top-level `tools` array.\n- Each tool entry must include `name`, `description`, `script`, `capabilities`, and `inputSchema`.\n- Each tool entry may optionally include `suggestionActions` as a short text string describing the recommended next step after the tool succeeds.\n- `inputSchema` must be JSON Schema with `type: object`.\n- `inputSchema` must define at least one execution target field: `pageId` and/or `browserId`, each as `type: string` when present.\n- The script file must be `.ts` and export a named `run` function with the shape `export const run = async ({ page, browser, input, logger }) => { ... }`.\n- The `run` export runs in Node.js, not inside the page.\n- Use the provided `page` object for browser interaction. It will be a Playwright page in playwright mode or an extension page proxy in extension mode.\n- Use the provided `browser` helper when the tool needs to list pages, open a new page, or work from `browserId` instead of an existing `pageId`.\n- `browser` is not a raw Playwright browser. It exposes `browserId`, `mode`, `listPages()`, `getPage(pageId)`, `getCurrentPage()`, and `newPage({ url?, setAsCurrent? })`.\n- Use the provided `logger` object for instrumentation. It exposes `trace`, `debug`, `info`, `warn`, `error`, and `fatal`, and logs automatically attach to the active custom-tool telemetry context.\n- The logger also exposes `getTraceContext()` so a tool can return the active `traceId` and `spanId` when needed for downstream log inspection.\n- If you need DOM access, call `page.evaluate(...)` from the `run` export instead of assuming browser globals are available at module scope.\n- Keep the script self-contained and avoid relative imports.\n- Return either a plain object, a string, or an MCP-style `CallToolResult`.\n- Prefer read-only behavior unless the goal explicitly requires mutation.\n\nOutput format:\n- Show the full `tools.yaml` content.\n- Show the full `{{ preferredToolName }}.ts` content.\n- If the tool needs additional inputs beyond `pageId` or `browserId`, define them in `inputSchema` and read them from `input`.\n- Filesystem access is allowed because the script runs in Node.js.\n\nExample `tools.yaml` shape:\n```yaml\ntools:\n - name: get_post\n description: Get the current post from the open feed page\n script: get_post.ts\n suggestionActions: Open the author profile and review whether the post is worth engaging with\n capabilities:\n readOnlyHint: true\n openWorldHint: false\n inputSchema:\n type: object\n properties:\n pageId:\n type: string\n browserId:\n type: string\n selector:\n type: string\n required:\n - pageId\n```\n\nExample script shape:\n```ts\nexport const run = async ({ page, browser, input, logger }) => {\n const traceContext = logger.getTraceContext();\n logger.info("reading post", { attributes: { selector: input.selector ?? "body", browserId: browser.browserId } });\n const selector = input.selector ?? "body";\n const text = await page.evaluate((currentSelector) => {\n return document.querySelector(currentSelector)?.textContent ?? "";\n }, selector);\n return {\n pageUrl: page.url(),\n traceContext,\n text,\n };\n};\n```\n';const m={name:`custom_script_authoring`,description:`Generate a browse-tool custom tool folder with tools.yaml and TypeScript scripts.`,arguments:[{name:`toolGoal`,description:`What the custom tool should do on the page`,required:!0},{name:`toolName`,description:`Preferred snake_case tool name`,required:!1},{name:`pageContext`,description:`Optional context about the target page or workflow`,required:!1}]},h=new a.Liquid;function g(e){let t=e.toolName?.trim()||`custom_page_tool`,n=e.pageContext?.trim()||`No extra page context provided.`;return[{role:`user`,content:{type:`text`,text:h.parseAndRenderSync(p,{toolGoal:e.toolGoal,preferredToolName:t,pageContext:n})}}]}exports.PLAYWRIGHT_TYPES=e.O,exports.StdioTransportHandler=e.n,exports.StreamableHttpTransportHandler=e.t,exports.ToolExecutionError=u,exports.UnknownToolError=l,exports.container=e.r,exports.createContainer=e.i,exports.createServer=f,exports.customScriptAuthoringPrompt=m,exports.generateCustomScriptAuthoringPrompt=g;
|
package/dist/index.mjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{O as e,g as t,i as n,n as r,r as i,t as a}from"./streamable-http-CZoE_y6A.mjs";import{z as o}from"zod";import{coerceArgs as s,formatZodError as c}from"@agimon-ai/foundation-validator";import{Server as l}from"@modelcontextprotocol/sdk/server/index.js";import{CallToolRequestSchema as u,ListToolsRequestSchema as d}from"@modelcontextprotocol/sdk/types.js";import{Liquid as f}from"liquidjs";function p(e){return typeof e==`string`||typeof e==`number`||typeof e==`boolean`?e:JSON.stringify(e)}function m(e){if(!e)return;let t={};for(let[n,r]of Object.entries(e))r!=null&&(t[n]=p(r));return Object.keys(t).length>0?t:void 0}function h(){let e=new t({serviceName:`browse-tool-mcp`});return{debug(t,n){e.log(`debug`,t,{attributes:m(n)})},info(t,n){e.log(`info`,t,{attributes:m(n)})},warn(t,n){e.log(`warn`,t,{attributes:m(n)})},error(t,n){e.log(`error`,t,{attributes:m(n)})}}}var g=class extends Error{code=`UNKNOWN_TOOL`;recovery=`Use ListTools to see available tools.`;availableTools;constructor(e,t,n){super(`Unknown tool: ${e}. Available tools: ${t.slice(0,5).join(`, `)}${t.length>5?`, ... (${t.length} total)`:``}. Use ListTools to see all available tools.`,n),this.name=`UnknownToolError`,this.availableTools=t}},_=class extends Error{code=`TOOL_EXECUTION_ERROR`;recovery;toolName;constructor(e,t,n){super(`Tool execution failed for '${e}': ${t}`,n),this.name=`ToolExecutionError`,this.toolName=e,this.recovery=n?.recovery??`Check tool inputs and try again.`}};function v(e,t){let n=e instanceof Error?e.message:`Unknown error occurred`,r={error:{code:e instanceof Error&&`code`in e?e.code:`TOOL_EXECUTION_ERROR`,message:n,toolName:t,recovery:e instanceof Error&&`recovery`in e?e.recovery:`Check tool inputs and try again.`}};return{content:[{type:`text`,text:JSON.stringify(r,null,2)}],isError:!0}}function y(t){let n=t?.container??i,r=t?.logger??h(),a=new l({name:`browse-tool`,version:`0.1.0`},{capabilities:{tools:{}}}),f=n.getAll(e.Tool),p=new Map;for(let e of f){let t=e.getDefinition();p.set(t.name,e)}return r.info(`MCP server initialized`,{toolCount:f.length}),a.setRequestHandler(d,async()=>(r.debug(`ListTools request received`),{tools:f.map(e=>e.getDefinition())})),a.setRequestHandler(u,async e=>{let{name:t,arguments:n}=e.params;r.debug(`Tool call received`,{toolName:t,timestamp:new Date().toISOString()});let i=p.get(t);if(!i){let e=Array.from(p.keys());throw r.warn(`Unknown tool requested`,{toolName:t,availableTools:e,timestamp:new Date().toISOString()}),new g(t,e)}let a=s(n??{},i.getInputSchema());try{let e=i.getInputSchema().parse(a);return await i.execute(e)}catch(e){if(e instanceof o.ZodError)return r.warn(`Tool input validation failed`,{toolName:t,timestamp:new Date().toISOString()}),{content:[{type:`text`,text:c(e,{schemaName:t,schema:i.getInputSchema()})}],isError:!0};let n=e instanceof _?e:new _(t,e instanceof Error?e.message:String(e),{cause:e});return r.error(`Tool execution failed`,{toolName:t,error:n.message,code:n.code,timestamp:new Date().toISOString()}),v(n,t)}}),a}var b='Create a browse-tool custom tool folder for use with `browse-tool mcp-serve --custom-tools <dir>`.\n\nGoal: {{ toolGoal }}\nPreferred tool name: {{ preferredToolName }}\nPage context: {{ pageContext }}\n\nRequirements:\n- Produce a `tools.yaml` file with a top-level `tools` array.\n- Each tool entry must include `name`, `description`, `script`, `capabilities`, and `inputSchema`.\n- Each tool entry may optionally include `suggestionActions` as a short text string describing the recommended next step after the tool succeeds.\n- `inputSchema` must be JSON Schema with `type: object`.\n- `inputSchema` must define at least one execution target field: `pageId` and/or `browserId`, each as `type: string` when present.\n- The script file must be `.ts` and export a named `run` function with the shape `export const run = async ({ page, browser, input, logger }) => { ... }`.\n- The `run` export runs in Node.js, not inside the page.\n- Use the provided `page` object for browser interaction. It will be a Playwright page in playwright mode or an extension page proxy in extension mode.\n- Use the provided `browser` helper when the tool needs to list pages, open a new page, or work from `browserId` instead of an existing `pageId`.\n- `browser` is not a raw Playwright browser. It exposes `browserId`, `mode`, `listPages()`, `getPage(pageId)`, `getCurrentPage()`, and `newPage({ url?, setAsCurrent? })`.\n- Use the provided `logger` object for instrumentation. It exposes `trace`, `debug`, `info`, `warn`, `error`, and `fatal`, and logs automatically attach to the active custom-tool telemetry context.\n- The logger also exposes `getTraceContext()` so a tool can return the active `traceId` and `spanId` when needed for downstream log inspection.\n- If you need DOM access, call `page.evaluate(...)` from the `run` export instead of assuming browser globals are available at module scope.\n- Keep the script self-contained and avoid relative imports.\n- Return either a plain object, a string, or an MCP-style `CallToolResult`.\n- Prefer read-only behavior unless the goal explicitly requires mutation.\n\nOutput format:\n- Show the full `tools.yaml` content.\n- Show the full `{{ preferredToolName }}.ts` content.\n- If the tool needs additional inputs beyond `pageId` or `browserId`, define them in `inputSchema` and read them from `input`.\n- Filesystem access is allowed because the script runs in Node.js.\n\nExample `tools.yaml` shape:\n```yaml\ntools:\n - name: get_post\n description: Get the current post from the open feed page\n script: get_post.ts\n suggestionActions: Open the author profile and review whether the post is worth engaging with\n capabilities:\n readOnlyHint: true\n openWorldHint: false\n inputSchema:\n type: object\n properties:\n pageId:\n type: string\n browserId:\n type: string\n selector:\n type: string\n required:\n - pageId\n```\n\nExample script shape:\n```ts\nexport const run = async ({ page, browser, input, logger }) => {\n const traceContext = logger.getTraceContext();\n logger.info("reading post", { attributes: { selector: input.selector ?? "body", browserId: browser.browserId } });\n const selector = input.selector ?? "body";\n const text = await page.evaluate((currentSelector) => {\n return document.querySelector(currentSelector)?.textContent ?? "";\n }, selector);\n return {\n pageUrl: page.url(),\n traceContext,\n text,\n };\n};\n```\n';const x={name:`custom_script_authoring`,description:`Generate a browse-tool custom tool folder with tools.yaml and TypeScript scripts.`,arguments:[{name:`toolGoal`,description:`What the custom tool should do on the page`,required:!0},{name:`toolName`,description:`Preferred snake_case tool name`,required:!1},{name:`pageContext`,description:`Optional context about the target page or workflow`,required:!1}]},S=new f;function C(e){let t=e.toolName?.trim()||`custom_page_tool`,n=e.pageContext?.trim()||`No extra page context provided.`;return[{role:`user`,content:{type:`text`,text:S.parseAndRenderSync(b,{toolGoal:e.toolGoal,preferredToolName:t,pageContext:n})}}]}export{e as PLAYWRIGHT_TYPES,r as StdioTransportHandler,a as StreamableHttpTransportHandler,_ as ToolExecutionError,g as UnknownToolError,i as container,n as createContainer,y as createServer,x as customScriptAuthoringPrompt,C as generateCustomScriptAuthoringPrompt};
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
require(`./streamable-http-
|
|
1
|
+
require(`./streamable-http-UNuTiSXW.cjs`);let e=require(`node:module`);const t=Symbol.for(`__locatorProxyBrand__`);var n=class e{[t]=!0;constructor(e,t){this.page=e,this.steps=t}getByRole(t,n){return new e(this.page,[...this.steps,{type:`role`,role:t,options:n}])}getByText(t,n){return new e(this.page,[...this.steps,{type:`text`,text:t,options:n}])}getByLabel(t,n){return new e(this.page,[...this.steps,{type:`label`,text:t,options:n}])}getByPlaceholder(t,n){return new e(this.page,[...this.steps,{type:`placeholder`,text:t,options:n}])}getByTestId(t){return new e(this.page,[...this.steps,{type:`testId`,testId:t}])}locator(t){return new e(this.page,[...this.steps,{type:`css`,selector:t}])}filter(t){return new e(this.page,[...this.steps,{type:`filter`,options:t}])}first(){return new e(this.page,[...this.steps,{type:`first`}])}last(){return this.nth(-1)}nth(t){return new e(this.page,[...this.steps,{type:`nth`,index:t}])}async click(e){let t=await this.resolveAndMark(e?.timeout);await this.page.click(t)}async fill(e,t){let n=await this.resolveAndMark(t?.timeout);await this.page.fill(n,e)}async type(e,t){let n=await this.resolveAndMark(t?.timeout);await this.page.type(n,e,{delay:t?.delay})}async press(e){let t=await this.resolveAndMark();await this.page.click(t),await this.page.press(e)}async hover(e){let t=await this.resolveAndMark(e?.timeout);await this.page.hover(t)}async selectOption(e){let t=await this.resolveAndMark();await this.page.selectOption(t,e)}async check(){let e=await this.resolveAndMark();await this.page.click(e)}async uncheck(){let e=await this.resolveAndMark();await this.page.click(e)}async isVisible(){let e=this.buildResolveScript(`isVisible`);return await this.page.evaluate(e)??!1}async isHidden(){return!await this.isVisible()}async isEnabled(){return!await this.evaluateProperty(`disabled`)}async isDisabled(){return!!await this.evaluateProperty(`disabled`)}async isChecked(){return!!await this.evaluateProperty(`checked`)}async evaluateProperty(e){let t=this.buildResolveScript(`getProperty`,e);return this.page.evaluate(t)}async textContent(){let e=this.buildResolveScript(`textContent`);return this.page.evaluate(e)}async innerText(){let e=this.buildResolveScript(`innerText`);return await this.page.evaluate(e)??``}async inputValue(){let e=this.buildResolveScript(`inputValue`);return await this.page.evaluate(e)??``}async count(){let e=this.buildResolveScript(`count`);return await this.page.evaluate(e)??0}async waitFor(e){let t=e?.timeout??5e3,n=e?.state??`visible`,r=Date.now();for(;Date.now()-r<t;){if(n===`visible`&&await this.isVisible()||n===`hidden`&&!await this.isVisible()||n===`attached`&&await this.count()>0||n===`detached`&&await this.count()===0)return;await new Promise(e=>setTimeout(e,100))}throw Error(`Locator waitFor("${n}") timed out after ${t}ms`)}async resolveAndMark(e){let t=e??5e3,n=Date.now(),r=`pw-${Date.now()}-${Math.random().toString(36).slice(2,8)}`;for(;Date.now()-n<t;){let e=this.buildResolveScript(`mark`,r);if(await this.page.evaluate(e))return`[data-pw-proxy="${r}"]`;await new Promise(e=>setTimeout(e,100))}throw Error(`Locator could not resolve element within ${t}ms. Steps: ${this.describeSteps()}`)}describeSteps(){return this.steps.map(e=>{switch(e.type){case`role`:return`getByRole("${e.role}"${e.options?.name?`, { name: "${String(e.options.name)}" }`:``})`;case`text`:return`getByText("${String(e.text)}")`;case`label`:return`getByLabel("${String(e.text)}")`;case`placeholder`:return`getByPlaceholder("${String(e.text)}")`;case`testId`:return`getByTestId("${e.testId}")`;case`css`:return`locator("${e.selector}")`;case`filter`:return`filter(...)`;case`first`:return`first()`;case`nth`:return`nth(${e.index})`}}).join(`.`)}serializeSteps(){return this.steps.map(e=>{if(e.type===`text`||e.type===`label`||e.type===`placeholder`)return{...e,text:e.text instanceof RegExp?{__regex__:e.text.source,flags:e.text.flags}:e.text};if(e.type===`role`&&e.options?.name instanceof RegExp)return{...e,options:{...e.options,name:{__regex__:e.options.name.source,flags:e.options.name.flags}}};if(e.type===`filter`){let t={};return e.options.hasText&&(t.hasText=e.options.hasText instanceof RegExp?{__regex__:e.options.hasText.source,flags:e.options.hasText.flags}:e.options.hasText),e.options.has&&(t.hasSteps=e.options.has.serializeSteps()),{type:`filter`,options:t}}return e})}buildResolveScript(e,t){return`(function() {
|
|
2
2
|
var steps = ${JSON.stringify(this.serializeSteps())};
|
|
3
3
|
var action = "${e}";
|
|
4
4
|
var extra = ${t===void 0?`null`:JSON.stringify(t)};
|