@agimon-ai/po-browse-tool 0.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,52 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             AgiFlow
+Licensed Work:        @agimon-ai/public-packages
+                      The Licensed Work is (c) 2026 AgiFlow.
+Additional Use Grant: None
+Change Date:          2030-03-06
+Change License:       Apache License, Version 2.0
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.

package/README.md

@@ -0,0 +1,485 @@
+# @agimon-ai/po-browse-tool
+
+MCP (Model Context Protocol) server for browser automation using Playwright. Provides comprehensive browser control, profile management, and LLM-driven automation capabilities.
+
+## Features
+
+- 37 browser automation tools for complete browser control
+- Multi-browser support (Chromium, Firefox, WebKit)
+- Profile management for persistent browser sessions
+- Page registry for managing multiple tabs/windows
+- LLM-controlled automation with pause/resume flow
+- Session management for organized browser operations
+
+## Installation
+
+```bash
+pnpm install
+```
+
+## Development
+
+```bash
+pnpm dev
+```
+
+## Build
+
+```bash
+pnpm build
+```
+
+## Test
+
+```bash
+pnpm test
+```
+
+## Private Po port checks
+
+This private port retains the upstream SDK, CLI, extension assets, and license.
+The profile-bound SDK is verified with synthetic local fixtures and real Chromium;
+no live credentials or email sends are used.
+
+From the repository root:
+
+```bash
+pnpm exec nx run-many -t lint,typecheck,build,test -p @agimon-ai/po-browse-tool
+```
+
+These targets cover whole-port type-aware lint, source and test typechecking,
+SDK/declaration builds, production extension assets, and synthetic Chromium tests.
+Browser evaluation and native receiver capture retain narrowly documented lint
+exceptions because those operations are intentional features.
+
+Check the extension's browser-only declarations separately:
+
+```bash
+pnpm --filter @agimon-ai/po-browse-tool exec tsc --noEmit -p tsconfig.extension.json
+```
+
+The production Vite build is not a substitute for this extension typecheck.
+
+## Usage with Claude Code
+
+Add to your Claude Code configuration (`.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "browse-tool": {
+      "command": "npx",
+      "args": ["browse-tool", "mcp-serve"]
+    }
+  }
+}
+```
+
+### CLI Options
+
+```bash
+browse-tool mcp-serve [options]
+
+Options:
+  -t, --type <type>      Transport type: stdio, streamable-http (default: "stdio")
+  -b, --browser <type>   Default browser: chromium, firefox, webkit (default: "chromium")
+  --headless             Run browsers in headless mode
+  --no-headless          Run browsers in headed mode (visible window)
+  --host <host>          Default host for HTTP services (default: "localhost")
+  --port <port>          Port for streamable HTTP transport (default: "3201")
+  -p, --profile <name>   Default profile name for browser sessions
+  --custom-tools <path>  Expose tools from a folder containing tools.yaml
+  --snippets-dir <path>  Directory used by browser_run_code to save and load reusable snippets
+```
+
+### Streamable HTTP Transport
+
+For clients that can connect over MCP streamable HTTP, start `mcp-serve` with:
+
+```bash
+browse-tool mcp-serve --type streamable-http --host 127.0.0.1 --port 3201
+```
+
+This exposes the MCP endpoint at `http://127.0.0.1:3201/mcp` and keeps the existing browse-tool HTTP service for browser execution on its own port.
+
+This endpoint serves modern MCP `2026-07-28` only. Send `x-browse-owner: <stable-owner-id>` on **every** stateful MCP request, and send `x-profile: <profile-name>` on every request when pinning a profile. The owner is application routing identity, not authentication. Tool discovery works without an owner; tool calls without one return an error. Browser state survives individual HTTP requests and client disconnects, scoped to the owner and profile, and is cleaned up after inactivity or shutdown. Modern HTTP does not use `Mcp-Session-Id` or a legacy initialize request.
+
+## Custom Tools
+
+Custom tools are loaded from a folder containing:
+
+- `tools.yaml`
+- one or more `.ts` scripts referenced by the manifest
+
+`tools.yaml` entries support:
+
+- `name`
+- `description`
+- `script`
+- `capabilities`
+- `inputSchema`
+- optional `suggestionActions`
+  - a short text string describing what should be done next after the tool succeeds
+  - this value is exposed in custom-tool discovery and injected into the tool execution result
+
+If you start the MCP server with `--custom-tools <path>`, those tools are added to the MCP tool list automatically.
+
+### Expose Custom Tools Through MCP
+
+```bash
+browse-tool mcp-serve --custom-tools scripts/automation/linkedin-prospecting
+```
+
+Claude Code example:
+
+```json
+{
+  "mcpServers": {
+    "browse-tool": {
+      "command": "npx",
+      "args": ["browse-tool", "mcp-serve", "--custom-tools", "scripts/automation/linkedin-prospecting"]
+    }
+  }
+}
+```
+
+### Flat CLI Commands
+
+List tools from a custom-tool directory:
+
+```bash
+browse-tool list-custom-tools scripts/automation/linkedin-prospecting
+```
+
+Execute a custom tool:
+
+```bash
+browse-tool exec-custom-tool \
+  scripts/automation/linkedin-prospecting \
+  list_posts_from_linkedin_feed \
+  '{"pageId":"page-2","maxPosts":3}'
+```
+
+### Notes
+
+- The flat commands talk to the browse-tool HTTP server.
+- Custom tools are not exposed to MCP unless `mcp-serve` is started with `--custom-tools`.
+- For slow UI-driven tools, prefer bounded inputs such as `maxPosts` so test runs stay manageable.
+- If a manifest defines `suggestionActions`, browse-tool injects that text into the custom tool execution result.
+
+## Tool Reference
+
+### Input Tools (8)
+
+| Tool                  | Description                                |
+| --------------------- | ------------------------------------------ |
+| `browser_click`       | Click on an element                        |
+| `browser_fill`        | Fill a form field with text (clears first) |
+| `browser_type`        | Type text into an element (appends)        |
+| `browser_hover`       | Hover over an element                      |
+| `browser_select`      | Select an option from a dropdown           |
+| `browser_drag`        | Drag from one element to another           |
+| `browser_press_key`   | Press a keyboard key                       |
+| `browser_upload_file` | Upload a file to a file input              |
+
+### Navigation Tools (5)
+
+| Tool                 | Description                      |
+| -------------------- | -------------------------------- |
+| `browser_navigate`   | Navigate to a URL                |
+| `browser_go_back`    | Go back in browser history       |
+| `browser_go_forward` | Go forward in browser history    |
+| `browser_reload`     | Reload the current page          |
+| `browser_wait_for`   | Wait for an element or condition |
+
+### Snapshot Tools (3)
+
+| Tool                 | Description                     |
+| -------------------- | ------------------------------- |
+| `browser_screenshot` | Take a screenshot               |
+| `browser_pdf`        | Generate PDF of the page        |
+| `browser_snapshot`   | Get accessibility tree snapshot |
+
+### Tab/Page Management Tools (4)
+
+| Tool                  | Description               |
+| --------------------- | ------------------------- |
+| `browser_list_pages`  | List all open pages       |
+| `browser_select_page` | Switch to a specific page |
+| `browser_new_page`    | Open a new page           |
+| `browser_close_page`  | Close a page              |
+
+### Dialog/Network/Console Tools (7)
+
+| Tool                            | Description                                        |
+| ------------------------------- | -------------------------------------------------- |
+| `browser_handle_dialog`         | Handle JavaScript dialogs (alert, confirm, prompt) |
+| `browser_list_network_requests` | List captured network requests                     |
+| `browser_get_network_request`   | Get details of a specific network request          |
+| `browser_list_console_messages` | List console messages                              |
+| `browser_evaluate_script`       | Execute JavaScript in the page                     |
+| `browser_resize_page`           | Resize the browser viewport                        |
+| `browser_emulate`               | Emulate device, geolocation, or network conditions |
+
+### Code Tools (2)
+
+| Tool                    | Description                                                                                        |
+| ----------------------- | -------------------------------------------------------------------------------------------------- |
+| `browser_run_code`      | Execute inline code against `{ page, context, browser }`, optionally save it as a reusable snippet |
+| `browser_list_snippets` | List saved snippets by name, description, and snippetPath                                          |
+
+### Testing/Tracing Tools (3)
+
+| Tool                  | Description                      |
+| --------------------- | -------------------------------- |
+| `browser_expect`      | Assert conditions on elements    |
+| `browser_start_trace` | Start Playwright tracing         |
+| `browser_stop_trace`  | Stop tracing and save trace file |
+
+### Profile Management Tools (4)
+
+| Tool                         | Description                           |
+| ---------------------------- | ------------------------------------- |
+| `browser_list_profiles`      | List all saved profiles               |
+| `browser_create_profile`     | Create a new browser profile          |
+| `browser_delete_profile`     | Delete a profile                      |
+| `browser_save_profile_state` | Save current browser state to profile |
+
+## Saved Snippets
+
+If you start `mcp-serve` or `http-serve` with `--snippets-dir <path>`, `browser_run_code` can persist inline snippets and later execute them again by `snippetPath`.
+
+Save an inline snippet:
+
+```json
+{
+  "tool": "browser_run_code",
+  "arguments": {
+    "pageId": "page-1",
+    "code": "return await page.title();",
+    "saveAs": {
+      "name": "Get Page Title",
+      "description": "Return the current page title"
+    }
+  }
+}
+```
+
+List saved snippets:
+
+```json
+{
+  "tool": "browser_list_snippets",
+  "arguments": {}
+}
+```
+
+Run a saved snippet:
+
+```json
+{
+  "tool": "browser_run_code",
+  "arguments": {
+    "pageId": "page-1",
+    "snippetPath": "get-page-title.ts"
+  }
+}
+```
+
+## Profile Management
+
+Profiles allow you to persist browser state (cookies, localStorage, etc.) across sessions.
+
+### Create a Profile
+
+```json
+{
+  "tool": "browser_create_profile",
+  "arguments": {
+    "name": "my-profile",
+    "browser": "chromium",
+    "headless": false
+  }
+}
+```
+
+### Save Profile State
+
+```json
+{
+  "tool": "browser_save_profile_state",
+  "arguments": {
+    "sessionId": "automation-1",
+    "profileName": "my-profile"
+  }
+}
+```
+
+## Proxy Configs
+
+`browser_launch` accepts an explicit proxy object, or `proxy: true` to load `session.yaml` from the proxy config directory.
+
+```json
+{
+  "tool": "browser_launch",
+  "arguments": {
+    "profileName": "work",
+    "proxy": true
+  }
+}
+```
+
+By default, proxy configs live beside the profiles directory. With the default profiles directory, this is `~/.browse-tool/proxy-config`.
+
+Files are resolved in this order:
+
+1. Explicit `proxy` object in the `browser_launch` arguments
+2. `{proxy-config}/{profileName}.yaml`
+3. `{proxy-config}/session.yaml` when `proxy: true` is used
+4. `{proxy-config}/default.yaml`
+
+Example YAML:
+
+```yaml
+server: http://proxy.example.com:8080
+username: ${PROXY_USER}
+password: ${PROXY_PASSWORD}
+bypass: localhost,127.0.0.1
+```
+
+Set a custom directory with `--proxy-config-dir <path>` or `BROWSE_TOOL_PROXY_CONFIG_DIR`.
+
+## Configuration
+
+### Environment Variables
+
+| Variable                                  | Default                               | Description                                                                |
+| ----------------------------------------- | ------------------------------------- | -------------------------------------------------------------------------- |
+| `PLAYWRIGHT_PROFILES_DIR`                 | `~/.browse-tool/profiles`             | Directory for storing browser profiles                                     |
+| `BROWSE_TOOL_PROXY_CONFIG_DIR`            | beside profiles dir as `proxy-config` | Directory for browser proxy YAML configs                                   |
+| `PLAYWRIGHT_REGISTRY_DIR`                 | `.agiflow/registry`                   | Directory for HTTP server registry                                         |
+| `PLAYWRIGHT_PIDS_DIR`                     | `.pids`                               | Directory for tracking server PIDs                                         |
+| `PLAYWRIGHT_BROWSER_IDLE_TIMEOUT_MINUTES` | `30`                                  | Minutes a browser may sit idle before it is closed                         |
+| `BROWSE_TOOL_SERVER_IDLE_TIMEOUT_MINUTES` | `60`                                  | Minutes the daemon may sit idle before it shuts itself down (`0` disables) |
+| `NODE_ENV`                                | `development`                         | Runtime environment (`development`, `production`)                          |
+
+### CLI Flags vs Environment Variables
+
+CLI flags take precedence over environment variables. For example, `--profiles-dir /custom/path` overrides `PLAYWRIGHT_PROFILES_DIR`.
+
+### Idle Cleanup
+
+A background sweep runs every 60 seconds and tears down resources no agent is working on:
+
+- **Pages** idle for more than 15 minutes are closed.
+- **Browsers** idle for more than the browser idle timeout (default 30 minutes) are closed, including their whole process tree.
+- **Browsers with no pages left** use the shorter 15-minute timeout.
+- **Stealth-mode** Chrome processes are swept on the same browser timeout.
+- **The daemon itself** exits once it has served no request and owns no browsers for the server idle timeout (default 60 minutes), releasing its port and process registry rows on the way out. Set `BROWSE_TOOL_SERVER_IDLE_TIMEOUT_MINUTES=0` to keep it running forever. Health checks do not count as requests: discovery polls them on daemons it never goes on to use.
+
+Idle is measured from the last real agent activity (a tool call against the browser, an extension task result, or a recording chunk upload). An open extension WebSocket does **not** count as activity — the extension pings and reconnects on its own, so a live socket would otherwise keep a forgotten browser alive forever. An in-progress recording does keep its browser and pages alive, because each uploaded chunk counts as activity.
+
+Set the timeout with `--idle-timeout <minutes>`, `commands.httpServe.idleTimeout` / `commands.mcpServe.idleTimeout` in `.browse-tool/config.json`, or `PLAYWRIGHT_BROWSER_IDLE_TIMEOUT_MINUTES`.
+
+> **Note:** the HTTP daemon is long-lived and shared across worktrees, and it reads the idle timeout once at startup. A later client that attaches to an already-running daemon cannot change that daemon's timeout — restart the daemon (`browse-tool stop`) to apply a new value.
+
+> **Note:** `browse-tool stop` only stops daemons registered under the current worktree, so it will not take browsers away from an agent working in another one. Use `browse-tool stop --all` when you do want to clear every worktree's daemon.
+
+## Error Handling
+
+### Common Failure Modes
+
+| Failure                  | Cause                                              | Recovery                                                              |
+| ------------------------ | -------------------------------------------------- | --------------------------------------------------------------------- |
+| Browser launch failure   | Missing browser binary or incompatible version     | Run `npx playwright install chromium` to install browsers             |
+| Navigation timeout       | Page took too long to load                         | Increase timeout via `browser_wait_for` or check network connectivity |
+| Element not found        | Selector did not match any element                 | Use `browser_snapshot` to inspect the current DOM tree                |
+| Profile not found        | Referenced profile does not exist                  | Use `browser_list_profiles` to list available profiles                |
+| Session expired          | Browser context was closed or crashed              | Launch a new browser session with `browser_navigate`                  |
+| Spec bundler build error | Syntax errors or unresolvable imports in spec file | Check the spec file for errors; see `SpecBundlerBuildError.recovery`  |
+| Spec bundler CLI error   | `bun` not installed or not in PATH                 | Install bun: `curl -fsSL https://bun.sh/install \| bash`              |
+
+### Error Codes
+
+All structured errors include a `code` field for programmatic handling and a `recovery` field with suggested resolution steps.
+
+## Spec Bundler
+
+The `SpecBundlerService` bundles Playwright spec files before execution, replacing `@playwright/test` imports with a lightweight stub module so specs can run inside the MCP server.
+
+### `testInfo.attach` compatibility
+
+`run_spec` provides a stable subset of Playwright `TestInfo` to test callbacks and per-test hooks:
+
+```typescript
+test('captures evidence', async ({ page }, testInfo) => {
+  await testInfo.attach('dashboard', {
+    body: await page.screenshot(),
+    contentType: 'image/png',
+  });
+});
+```
+
+Attachments may use either `body` or `path`. The runner copies the evidence to its temporary attachment directory and returns `{ name, contentType, path }` metadata on the matching test result. Accessing an unsupported `TestInfo` property fails with `RUN_SPEC_UNSUPPORTED_TEST_INFO_CAPABILITY` so compatibility failures remain distinct from browser and product failures.
+
+### Runtime Requirements
+
+- **Bun runtime** (preferred): When the MCP server runs under Bun, `Bun.build()` is used directly.
+- **Node.js runtime** (fallback): When running under Node.js, the service spawns `bun` as a CLI subprocess. Ensure `bun` is installed and accessible in `PATH`:
+  ```bash
+  curl -fsSL https://bun.sh/install | bash
+  # or
+  npm i -g bun
+  ```
+
+### Programmatic Usage
+
+```typescript
+import { SpecBundlerService } from 'browse-tool';
+
+const bundler = new SpecBundlerService();
+const { outputPath, cleanup } = await bundler.bundle('/path/to/my-spec.ts');
+try {
+  // Use the bundled output at outputPath
+} finally {
+  await cleanup();
+}
+```
+
+### Error Handling
+
+| Error Class                | Code                        | When                                        |
+| -------------------------- | --------------------------- | ------------------------------------------- |
+| `SpecBundlerBuildError`    | `SPEC_BUNDLER_BUILD_FAILED` | Bundler reports syntax or resolution errors |
+| `SpecBundlerNoOutputError` | `SPEC_BUNDLER_NO_OUTPUT`    | Bundling produces no output file            |
+| `SpecBundlerCliError`      | `SPEC_BUNDLER_CLI_FAILED`   | `bun` CLI subprocess fails to execute       |
+
+## Architecture
+
+```
+browse-tool/
+├── src/
+│   ├── commands/        # CLI commands (mcp-serve)
+│   ├── container/       # InversifyJS IoC container
+│   ├── server/          # MCP server factory
+│   ├── services/        # Core services
+│   │   ├── AutomationRunner.ts   # Script execution
+│   │   ├── BrowserService.ts     # Browser lifecycle
+│   │   ├── PageRegistry.ts       # Page tracking
+│   │   ├── PauseController.ts    # Pause/resume flow
+│   │   ├── ProfileService.ts     # Profile management
+│   │   └── SessionService.ts     # Session tracking
+│   ├── tools/           # MCP tool implementations
+│   ├── transports/      # Transport handlers (stdio, streamable HTTP)
+│   └── types/           # TypeScript type definitions
+├── tests/
+│   ├── services/        # Service unit tests
+│   ├── tools/           # Tool unit tests
+│   ├── integration/     # Integration tests
+│   └── fixtures/        # Test fixtures
+└── README.md
+```
+
+## License
+
+MIT

package/dist/ExtensionToolDelegator-5tCMdpOX.mjs

@@ -0,0 +1,2 @@
+import{o as e,s as t,t as n}from"./timeouts-CUKtmglu.mjs";import{t as r}from"./decorateMetadata-D0fK5b4i.mjs";import{t as i}from"./decorate-B3KLIx2E.mjs";import{s as a}from"./networkConfig-C_01QWPz.mjs";import{n as o,o as s}from"./telemetryContext-Bs3fgsz2.mjs";import"reflect-metadata/lite";import{inject as c,injectable as l,optional as u}from"inversify";import{dirname as d}from"node:path";import{mkdirSync as f,writeFileSync as p}from"node:fs";import{AsyncLocalStorage as m}from"node:async_hooks";import{createNodeTelemetry as h,resolveNodeTelemetryEndpoints as g}from"@agimon-ai/log-sink-mcp/telemetry/node";import{SpanKind as _,SpanStatusCode as v,context as y,trace as b}from"@opentelemetry/api";import{OTLPTraceExporter as x}from"@opentelemetry/exporter-trace-otlp-http";import{resourceFromAttributes as S}from"@opentelemetry/resources";import{BatchSpanProcessor as C,NodeTracerProvider as w,SimpleSpanProcessor as T}from"@opentelemetry/sdk-trace-node";const E=`@agimon-ai/po-browse-tool`,D=/* @__PURE__ */ new Set([`127.0.0.1`,`localhost`,`::1`,`0.0.0.0`]);function O(e){return e===`1`||e===`true`}function k(e){return Array.isArray(e)?JSON.stringify(e):typeof e==`string`||typeof e==`number`||typeof e==`boolean`?e:JSON.stringify(e)}function A(e){if(!e)return;let t={};for(let[n,r]of Object.entries(e))r!=null&&(t[n]=k(r));return Object.keys(t).length>0?t:void 0}function j(e){if(!e)return;let t={};for(let n of e.split(`,`)){let[e,...r]=n.split(`=`),i=e?.trim(),a=r.join(`=`).trim();i&&a&&(t[i]=a)}return Object.keys(t).length>0?t:void 0}function M(e){if(!e)return;let t=Number(e);return Number.isFinite(t)&&t>0?t:void 0}function N(e,t){let n=e.endsWith(`/`)?e:`${e}/`;return n.endsWith(`/v1/${t}/`)||n.endsWith(`/v1/${t}`)?e:new URL(`v1/${t}`,n).toString()}function P(e,t){return(t===`traces`?e.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT:e.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT)||(e.OTEL_EXPORTER_OTLP_ENDPOINT?N(e.OTEL_EXPORTER_OTLP_ENDPOINT,t):void 0)}function F(e){return D.has(e)}function I(e,t){try{let n=new URL(e),r=new URL(t);return!F(n.hostname)||F(r.hostname)||(n.hostname=r.hostname),n.toString()}catch{return e}}async function L(e,t,n){let r=await g({env:e,packageName:E,workspaceRoot:a({env:e}),healthCheck:n?.healthCheck});return t===`traces`?r.tracesEndpoint:r.logsEndpoint}async function R(e,t,n,r){let i=t===`traces`?e.BROWSE_TOOL_OTEL_BROWSER_TRACES_ENDPOINT:e.BROWSE_TOOL_OTEL_BROWSER_LOGS_ENDPOINT;if(i)return I(i,n);let a=e.BROWSE_TOOL_OTEL_BROWSER_ENDPOINT;if(a)return I(N(a,t),n);let o=await L(e,t,r);return o?I(o,n):void 0}async function z(e,t,n){let r=e.BROWSE_TOOL_OTEL_BROWSER_SERVICE_NAME??`browse-tool-extension`,[i,a]=await Promise.all([R(e,`traces`,t,n),R(e,`logs`,t,n)]);return{enabled:!!(i||a),tracesEndpoint:i,logsEndpoint:a,serviceName:r}}function B(e,t){let n=t===`traces`?e.OTEL_EXPORTER_OTLP_TRACES_HEADERS:e.OTEL_EXPORTER_OTLP_LOGS_HEADERS,r=t===`traces`?e.OTEL_EXPORTER_OTLP_TRACES_TIMEOUT:e.OTEL_EXPORTER_OTLP_LOGS_TIMEOUT;return{url:P(e,t),headers:j(n??e.OTEL_EXPORTER_OTLP_HEADERS),timeoutMillis:M(r??e.OTEL_EXPORTER_OTLP_TIMEOUT)}}function V(e){return e instanceof Error?e.message:String(e)}function H(e){if(e instanceof Error)return A({"exception.type":e.name,"exception.message":e.message,"exception.stacktrace":e.stack})}let U=class{contextStore=new m;tracesEnabled;logsEnabled;tracerProvider;tracer;logSinkReady;delegateReady;delegateHandle=null;constructor(e={}){let t=e.env??process.env,n=O(t.OTEL_SDK_DISABLED),r=O(t.BROWSE_TOOL_OTEL_ENABLED),i=B(t,`traces`),o=!!e.traceExporter;this.tracesEnabled=!n&&(o||r||!!i.url),this.logsEnabled=!n;let s=e.serviceName??t.BROWSE_TOOL_OTEL_SERVICE_NAME??`browse-tool-http`,c=e.packageName??E,l=e.serviceVersion??t.npm_package_version,u={"service.name":s};l&&(u[`service.version`]=l);let d=S(u);if(this.tracesEnabled&&o){let t=e.traceExporter??new x(i);this.tracerProvider=new w({resource:d,spanProcessors:[e.traceExporter?new T(t):new C(t)]})}this.tracer=this.tracerProvider?.getTracer(s,l)??b.getTracer(s,l),this.delegateReady=!n&&!o?h({env:t,packageName:c,serviceName:s,serviceVersion:l,workspaceRoot:a(),enableTraces:!0,enableLogs:!0}).then(e=>(this.delegateHandle=e,e)).catch(()=>null):Promise.resolve(null),this.logSinkReady=this.logsEnabled&&o?h({env:t,packageName:c,serviceName:s,serviceVersion:l,workspaceRoot:a(),enableTraces:!1,enableLogs:!0}).catch(()=>null):this.delegateReady}isEnabled(){return this.tracesEnabled||this.logsEnabled}getActiveTraceContext(){let e=this.delegateHandle?.getTraceContext();if(e?.traceId||e?.spanId)return e;let t=this.contextStore.getStore();if(!t)return{};let n=b.getSpan(t);if(!n)return{};let r=n.spanContext();return{traceId:r.traceId,spanId:r.spanId}}async runInSpan(e,t,n){let r=await this.delegateReady;if(r)return await r.runInSpan(e,t,n);if(!this.tracesEnabled||!this.tracerProvider)return await n(void 0);let i=this.contextStore.getStore()??y.active(),a=this.tracer.startSpan(e,{kind:t.kind??_.INTERNAL,attributes:A({...s(o()),...t.attributes})},i),c=b.setSpan(i,a);return await this.contextStore.run(c,async()=>{try{return await n(a)}catch(e){throw a.recordException(e instanceof Error?e:Error(V(e))),a.setStatus({code:v.ERROR,message:V(e)}),e}finally{a.end()}})}log(e,t,n={}){this.logsEnabled&&this.logSinkReady.then(r=>{if(!r)return;let i=n.context??this.contextStore.getStore()??y.active(),a=H(n.exception);r.logger[e](t,{attributes:A({...s(o()),...n.attributes,...a}),context:i,exception:n.exception})})}async forceFlush(){let[e,t]=await Promise.all([this.logSinkReady,this.delegateReady]);await Promise.allSettled([this.tracerProvider?.forceFlush(),e?.flush(),t?.flush()])}async shutdown(){let[e,t]=await Promise.all([this.logSinkReady,this.delegateReady]);await Promise.allSettled([this.tracerProvider?.shutdown(),e?.shutdown(),t?.shutdown()])}};U=i([l(),r(`design:paramtypes`,[Object])],U);const W=/* @__PURE__ */ new Set([`browser_close_page`,`browser_handle_dialog`,`browser_reload`]);var G=class extends Error{targetKey;retryAfterMs;code=`BROWSER_EXTENSION_TASK_TIMEOUT`;retryable;targetState;constructor(e,t,n){super(e),this.targetKey=t,this.retryAfterMs=n,this.name=`ExtensionTaskTimeoutError`,this.retryable=t!==void 0,this.targetState=t?`recovery_required`:`timed_out`}},K=class extends Error{targetKey;code=`BROWSER_EXTENSION_TARGET_RECOVERING`;retryable=!0;targetState;retryAfterMs;constructor(e,t){let n=typeof t==`number`;super(n?`Browser target ${e} is recovering from a timed-out task. Retry after ${t}ms or select another page.`:`Browser target ${e} requires recovery after a timed-out task. Run browser_handle_dialog, browser_reload, or browser_close_page before retrying regular work.`),this.targetKey=e,this.name=`ExtensionTargetRecoveringError`,this.targetState=n?`recovering`:`recovery_required`,this.retryAfterMs=n?t:0}};let q=class{webSocketHub;telemetry;pageRegistry;pendingTasks=/* @__PURE__ */ new Map;taskQueue=[];lastPollAt;lastResultAt;maxQueueSize=100;defaultTimeoutMs=Math.min(n,3e4);targetCircuits=/* @__PURE__ */ new Set;warnedAboutUnscopedPolling=!1;constructor(e,t=new U,n){this.webSocketHub=e,this.telemetry=t,this.pageRegistry=n}async queueTask(e,t,n=this.defaultTimeoutMs,r){if(this.pendingTasks.size>=this.maxQueueSize)throw Error(`Task queue full (max ${this.maxQueueSize} tasks)`);let i=typeof t.pageId==`string`?t.pageId:void 0,a=r??t.browserId??this.resolveBrowserIdFromPage(i),o=a?void 0:this.resolveSingleConnectionBrowserId(),s=i??a??o;if(s&&this.targetCircuits.has(s)&&!W.has(e))throw new K(s);let c={id:crypto.randomUUID(),tool:e,arguments:t,createdAt:/* @__PURE__ */ new Date,timeoutMs:n,browserId:a??o,pageId:i,telemetry:this.getTaskTelemetryContext()};return new Promise((e,t)=>{let r=setTimeout(()=>{this.pendingTasks.delete(c.id);let e=this.taskQueue.findIndex(e=>e.id===c.id);e!==-1&&this.taskQueue.splice(e,1),s&&(this.targetCircuits.add(s),this.rejectPendingTasksForTarget(s,c.id));let r=a??o;r&&this.webSocketHub?.cancelTask(r,c.id,`Timed out after ${n}ms`),t(new G(`Task ${c.id} timed out after ${n}ms. The target requires an explicit recovery tool before regular work can resume.`,s,0))},n);if(this.pendingTasks.set(c.id,{task:c,resolve:e,reject:t,timeoutId:r}),this.webSocketHub){let e=a??o;if(e&&this.pushTaskViaWebSocket(c,e))return}this.taskQueue.push(c)})}pushTaskViaWebSocket(e,t){if(!this.webSocketHub)return!1;let n={type:`task:push`,id:crypto.randomUUID(),payload:{taskId:e.id,tool:e.tool,arguments:e.arguments,telemetry:e.telemetry}};return this.webSocketHub.pushTask(t,n)}getNextTask(e){if(this.lastPollAt=/* @__PURE__ */ new Date,e!==void 0){let t=this.taskQueue.findIndex(t=>t.browserId===e||t.browserId===void 0);return t===-1?void 0:this.taskQueue.splice(t,1)[0]}if(new Set(this.taskQueue.map(e=>e.browserId).filter(e=>e!==void 0)).size<=1)return this.taskQueue.shift();this.warnedAboutUnscopedPolling||(this.warnedAboutUnscopedPolling=!0,console.warn(`[ExtensionTaskQueue] An extension is polling without a browserId while several browsers have queued work. Update the extension so its tasks can be routed.`));let t=this.taskQueue.findIndex(e=>e.browserId===void 0);return t===-1?void 0:this.taskQueue.splice(t,1)[0]}failPendingTasksForBrowser(e,t){for(let[n,r]of this.pendingTasks)r.task.browserId===e&&(clearTimeout(r.timeoutId),r.reject(Error(t)),this.pendingTasks.delete(n));this.taskQueue=this.taskQueue.filter(t=>t.browserId!==e)}submitResult(e){this.lastResultAt=/* @__PURE__ */ new Date;let t=this.pendingTasks.get(e.taskId);if(!t)return;clearTimeout(t.timeoutId),this.pendingTasks.delete(e.taskId);let n=this.getTaskTargetKey(t.task);return n&&W.has(t.task.tool)&&e.success&&e.result?.isError!==!0&&this.targetCircuits.delete(n),t.resolve(e),t.task}getConnectionStatus(){let e=/* @__PURE__ */ new Date,t=this.lastPollAt?e.getTime()-this.lastPollAt.getTime()<5e3:!1,n=this.webSocketHub?this.webSocketHub.getStats().totalConnections>0:!1;return{connected:t||n,lastPollAt:this.lastPollAt,lastResultAt:this.lastResultAt,pendingTasks:this.pendingTasks.size}}purgeTargets(e,t){let n=new Set(e);if(n.size===0)return;for(let e of n)this.targetCircuits.delete(e);let r=e=>e.pageId!==void 0&&n.has(e.pageId)||e.browserId!==void 0&&n.has(e.browserId);for(let[e,n]of this.pendingTasks)r(n.task)&&(clearTimeout(n.timeoutId),n.reject(Error(t)),this.pendingTasks.delete(e));this.taskQueue=this.taskQueue.filter(e=>!r(e))}clearAllTasks(e){for(let[t,n]of this.pendingTasks)clearTimeout(n.timeoutId),n.reject(Error(e)),this.pendingTasks.delete(t);this.taskQueue.length=0}get queueSize(){return this.taskQueue.length}get pendingCount(){return this.pendingTasks.size}getTaskTelemetryContext(){let e=this.telemetry.getActiveTraceContext();if(e.traceId||e.spanId)return{traceId:e.traceId,parentSpanId:e.spanId}}resolveBrowserIdFromPage(e){if(e)return this.pageRegistry?.get(e)?.browserId}rejectPendingTasksForTarget(e,t){for(let[n,r]of this.pendingTasks){if(n===t||this.getTaskTargetKey(r.task)!==e)continue;clearTimeout(r.timeoutId),this.pendingTasks.delete(n);let i=this.taskQueue.findIndex(e=>e.id===n);i!==-1&&this.taskQueue.splice(i,1),r.task.browserId&&this.webSocketHub?.cancelTask(r.task.browserId,n,`Target ${e} is recovering from another timed-out task`),r.reject(new K(e))}}getTaskTargetKey(e){return e.pageId??e.browserId}resolveSingleConnectionBrowserId(){if(!this.webSocketHub)return;let e=this.webSocketHub.getStats();if(e.totalConnections!==0){if(new Set(e.connections.map(e=>e.browserId)).size>1)throw Error(`Ambiguous extension task target: provide browserId or pageId when multiple browsers are connected`);return e.connections[0]?.browserId}}};q=i([l(),e(0,c(t.WebSocketHub)),e(0,u()),e(1,c(t.TelemetryService)),e(1,u()),e(2,c(t.PageRegistry)),e(2,u()),r(`design:paramtypes`,[Object,Object,Object])],q);function J(e){return{content:[{type:`text`,text:e.message}],structuredContent:{error:{code:e.code,retryable:e.retryable,targetKey:e.targetKey,targetState:e.targetState,retryAfterMs:e.retryAfterMs}},isError:!0}}const Y=/* @__PURE__ */ new Set(/* @__PURE__ */ `browser_navigate.browser_go_back.browser_go_forward.browser_reload.browser_click.browser_fill.browser_type.browser_upload_file.browser_select.browser_hover.browser_drag.browser_press_key.browser_inspect_element.browser_resolve_locator.browser_pdf.browser_screenshot.browser_snapshot.browser_list_pages.browser_new_page.browser_select_page.browser_close_page.browser_wait_for.browser_evaluate_script.browser_resize_page.browser_handle_dialog.browser_emulate.browser_list_network_requests.browser_get_network_request.browser_list_console_messages.browser_expect`.split(`.`)),X=/* @__PURE__ */ new Set([`browser_launch`,`browser_list_profiles`,`browser_create_profile`,`browser_delete_profile`,`browser_save_profile_state`,`browser_start_trace`,`browser_stop_trace`,`run_spec`,`discover_specs`]);let Z=class{taskQueue;constructor(e){this.taskQueue=e}isToolSupported(e){return Y.has(e)}isToolNotApplicable(e){return X.has(e)}async executeTool(e,t){if(this.isToolNotApplicable(e))return{content:[{type:`text`,text:`Tool "${e}" is not available in Chrome extension mode. This tool requires Playwright and cannot be run through the extension.`}],isError:!0};if(!this.isToolSupported(e))return{content:[{type:`text`,text:`Tool "${e}" is not yet implemented in Chrome extension mode.`}],isError:!0};if(!this.taskQueue.getConnectionStatus().connected)return{content:[{type:`text`,text:`Chrome extension is not connected. Please ensure the extension is running and connected to the server.`}],isError:!0};try{let n=typeof t.timeout==`number`&&Number.isFinite(t.timeout)?t.timeout:void 0,r=await this.taskQueue.queueTask(e,t,n);return r.success?r.result?this.persistScreenshotPath(e,t,r.result):{content:[{type:`text`,text:`Tool executed successfully`}]}:{content:[{type:`text`,text:r.error||r.result?.content?.[0]?.text||`Unknown error from Chrome extension`}],isError:!0}}catch(e){return e instanceof G||e instanceof K?J(e):{content:[{type:`text`,text:e instanceof Error?e.message:String(e)}],isError:!0}}}persistScreenshotPath(e,t,n){let r=typeof t.path==`string`?t.path.trim():``,i=n.content[0];return e!==`browser_screenshot`||!r||i?.type!==`image`||typeof i.data!=`string`?n:(f(d(r),{recursive:!0}),p(r,Buffer.from(i.data,`base64`)),{content:[{type:`text`,text:`Screenshot saved to: ${r}`}]})}getSupportedTools(){return Array.from(Y)}getNotApplicableTools(){return Array.from(X)}};Z=i([l(),e(0,c(t.ExtensionTaskQueue)),r(`design:paramtypes`,[Object])],Z);export{z as i,q as n,U as r,Z as t};
+//# sourceMappingURL=ExtensionToolDelegator-5tCMdpOX.mjs.map