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