web-task-api 0.2.1

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+## [0.2.1] - 2026-03-27
+
+### Fixed
+
+- release packaging now tracks `src/sessions/store.ts` correctly by anchoring repo-root artifact ignores to `/runs/` and `/sessions/`, which fixes the broken 0.2.0 CI/release attempt on GitHub
+
+## [0.2.0] - 2026-03-27
+
+### Added
+
+- first-class MCP server entrypoint with tools for task runs, task lookup, recipe listing, and session lifecycle management
+- MCP packaging metadata (`server.json`), metadata validation, Claude/OpenCode config examples, and tag-driven GitHub workflows for CI, npm release, and MCP Registry publication
+
+### Changed
+
+- the same repo now intentionally ships both surfaces: `web-task-api-http` for the HTTP API runtime and `web-task-api` for the stdio MCP server, so one codebase exposes the same browser-task engine to both API and MCP clients
+- MCP tools now reuse the same shared request/session validation rules as the HTTP API, and release automation pins the MCP publisher version for reproducibility
+- package metadata now pins dependency versions explicitly, and release checks include a built-entrypoint MCP smoke test instead of trusting only the source `tsx` path
+- tagged release automation is now a single coordinated pipeline so MCP publication only runs after npm publication is guaranteed instead of racing a separate workflow
+
+## References
+
+[^1]: `docs/releasing.md` documents the tag-driven release flow and versioned metadata files for this repository.

package/README.md

@@ -0,0 +1,284 @@
+# Web Task API
+
+`web-task-api` is a generalized browser-task runtime for projects that want to treat websites like programmable APIs.
+
+It exposes one API for:
+
+- starting from a URL + goal
+- letting an agent drive a real browser
+- validating structured output against a schema
+- reusing persistent browser profiles and promoted recipes
+- storing traces and artifacts for replay/debugging
+
+The same runtime now ships in **two surfaces**:
+
+- **HTTP API** for application-to-application integration
+- **MCP server** for Claude Code, OpenCode, and other MCP clients[^1]
+
+## Why this exists
+
+Instead of building one brittle adapter per website, this project uses an agent-first browser runtime:
+
+- default path: goal-driven browser control
+- optimization path: reusable recipes for common flows
+- escape hatch: login profiles and artifacts for debugging failures
+
+That gives a more future-proof foundation for “API for any site” style automation.
+
+## Implemented MVP
+
+- Fastify HTTP API
+- stdio MCP server
+- Playwright browser runtime
+- CLIProxyAPI-backed planner for freeform browser control
+- Optional OpenCode SDK planner adapter for environments that already use OpenCode well
+- Auto planner mode that falls back to your existing local OpenCode auth/runtime when direct CLIProxy credentials are not wired yet
+- Mock agent for local deterministic demos/tests
+- Recipe registry and matching
+- Persistent browser profile reuse
+- Run artifacts and step traces
+- Local demo and end-to-end tests
+
+## Initial workflow targets
+
+- generic search/form workflows
+- Dexscreener token/pair reading starter recipe
+- GMGN token/wallet reading starter recipe
+
+For Dexscreener/GMGN, treat the shipped recipes as **starter recipes**, not guaranteed turnkey integrations yet. A warmed persistent browser source is often required because fresh headless sessions can hit Cloudflare or similar anti-bot checks. The runtime now fails fast for these protected-site recipes unless you provide one of:
+
+- `request.profile`
+- `BROWSER_USER_DATA_DIR`
+- `sessionId` for a **warmed** session that already preserves browser storage across tasks
+
+## Quick start
+
+1. Install dependencies:
+
+   ```bash
+   npm install
+   npm run playwright:install
+   ```
+
+2. Start the HTTP API:
+
+   ```bash
+   npm run dev
+   ```
+
+3. Or start the MCP server:
+
+   ```bash
+   npm run dev:mcp
+   ```
+
+4. Run the demo flow:
+
+   ```bash
+   npm run demo
+   ```
+
+## MCP
+
+The package now exposes the MCP server binary directly:
+
+```bash
+npx -y web-task-api
+```
+
+That launches the stdio MCP server.
+
+The HTTP runtime remains available separately:
+
+```bash
+npx -y -p web-task-api web-task-api-http
+```
+
+### MCP tools
+
+- `webtask_run`
+- `webtask_get_task`
+- `webtask_list_recipes`
+- `webtask_create_session`
+- `webtask_list_sessions`
+- `webtask_get_session`
+- `webtask_update_session`
+- `webtask_health`
+
+### MCP config examples
+
+- Claude Code: `examples/claude.mcp.json`
+- OpenCode: `examples/opencode.json`
+
+## API
+
+### `POST /v1/tasks/run`
+
+Runs a browser task synchronously and returns structured results.
+
+Example request is in `examples/demo-task.json`.
+
+### `GET /v1/tasks/:taskId`
+
+Returns the persisted run record with step trace and artifact paths.
+
+### `GET /v1/recipes`
+
+Lists registered recipes.
+
+### `POST /v1/sessions`
+
+Creates a reusable session for connected tasks. Sessions can carry:
+
+- guest vs profile mode
+- default start URL
+- default planner config
+- notes
+- compact task history
+
+### `GET /v1/sessions`
+
+Lists saved sessions.
+
+### `GET /v1/sessions/:sessionId`
+
+Returns session metadata and recent task history.
+
+### `PATCH /v1/sessions/:sessionId`
+
+Updates session metadata like notes, default start URL, or the bound profile for an existing profile-mode session. Guest sessions cannot be rebound into named profiles by patch.
+
+### `GET /health`
+
+Basic health endpoint.
+
+## TypeScript client
+
+Software can use the bundled client:
+
+```ts
+import { WebTaskApiClient } from "web-task-api"
+
+const client = new WebTaskApiClient({ baseUrl: "http://127.0.0.1:4317" })
+const session = await client.createSession({
+  name: "axiom trader",
+  mode: "profile",
+  profile: "axiom",
+  notes: "Authenticated Axiom trading session"
+})
+const result = await client.runTask({
+  goal: "Extract token name and price",
+  startUrl: "https://example.com",
+  sessionId: session.id,
+  agent: { kind: "auto" },
+})
+```
+
+## Connected tasks with sessions
+
+Sessions let related web tasks share:
+
+- browser/profile identity
+- guest-session cookies and local storage across tasks
+- default start URL
+- planner defaults
+- recent task context
+
+Example pattern:
+
+1. Create session for `axiom` profile
+2. Run login/manual warmup task once
+3. Run later research/action tasks with the same `sessionId`
+4. Inspect session history to see what the agent already found
+
+Guest sessions also work: create a `mode: "guest"` session and repeated tasks will preserve browser storage between runs under that session ID.
+
+For protected recipes, that guest session still needs to be **warmed first** before you rely on it as a continuity source.
+
+## Browser profiles
+
+To create a reusable login profile:
+
+```bash
+npm run profile:login -- --id my-profile --url https://example.com/login
+```
+
+This opens a real persistent browser profile. Log in manually or solve bot challenges, then press Enter in the terminal. The runtime saves a reusable Chromium user-data directory at `profiles/<id>/user-data-dir` and later tasks can use `"profile": "my-profile"`.
+
+This matters for sites like Dexscreener or GMGN that may block fresh headless sessions behind Cloudflare or similar anti-bot checks.
+
+If you want the runtime to behave as closely as possible to your normal local Chrome, you can also point it at an existing browser profile:
+
+- `BROWSER_USER_DATA_DIR=/path/to/your/chrome/profile`
+
+That is the closest match to “it works in my Chrome already”.
+
+## Planner backends
+
+### Recommended: CLIProxyAPI
+
+This is the default non-mock path to avoid tying the system too tightly to OpenCode.
+
+CLIProxyAPI is treated as a **multi-provider router**, not a single-provider API key wrapper. You can point this product at any model alias/provider path exposed by your CLIProxy setup.
+
+Useful environment variables:
+
+- `CLIPROXY_BASE_URL` — default `http://127.0.0.1:8317/v1`
+- `CLIPROXY_AUTH_TOKEN` — optional client token if your CLIProxy instance requires one
+- `CLIPROXY_MODEL` — planner model alias/name exposed by your proxy, for example whatever provider/model mapping you configured there
+
+Example:
+
+```json
+{
+  "agent": {
+    "kind": "cliproxy"
+  }
+}
+```
+
+### Easiest local path right now: `auto`
+
+If your GPT/OAuth is already working through local OpenCode, use:
+
+```json
+{
+  "agent": {
+    "kind": "auto"
+  }
+}
+```
+
+`auto` probes CLIProxy first and uses it when reachable/authenticated **and** a planner model is configured; otherwise it falls back to OpenCode so the product can still use your existing local auth/runtime. This path is verified locally against the fixture flow; for real sites, treat it as the recommended runtime path, not a guarantee that every protected site will work without profile warmup.
+
+### Optional: OpenCode
+
+If you already run OpenCode headless and want to reuse that stack, the project also supports an OpenCode planner adapter.
+
+Useful variables:
+
+- `OPENCODE_BASE_URL`
+- `OPENCODE_MODEL`
+
+Then use:
+
+```json
+{
+  "agent": {
+    "kind": "opencode"
+  }
+}
+```
+
+## Main files
+
+- `docs/design.md` — architecture, decisions, and implementation plan
+- `docs/releasing.md` — tag-driven release flow and MCP registry packaging notes
+- `src/` — server, runtime, agent, browser, and storage code
+- `tests/` — end-to-end verification with a local fixture site
+- `scripts/` — demo runner and profile bootstrap
+
+## References
+
+[^1]: `docs/design.md` for the detailed system design, tradeoffs, and roadmap.
+[^2]: `server.json` is the MCP registry metadata source of truth; `package.json` carries the npm package and executable metadata.

package/dist/scripts/demo.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/demo.js

@@ -0,0 +1,32 @@
+import { createApp } from "../src/server/app.js";
+import { startFixtureSite } from "../tests/fixture-site.js";
+const fixture = await startFixtureSite();
+const app = createApp();
+try {
+    const response = await app.inject({
+        method: "POST",
+        url: "/v1/tasks/run",
+        payload: {
+            goal: "Search for banana and return product, price, and stock.",
+            startUrl: fixture.url,
+            recipeId: "fixture-catalog",
+            input: { query: "banana" },
+            outputSchema: {
+                type: "object",
+                required: ["product", "price", "stock"],
+                properties: {
+                    product: { type: "string" },
+                    price: { type: "string" },
+                    stock: { type: "string" },
+                },
+            },
+            agent: { kind: "mock" },
+        },
+    });
+    console.log(response.body);
+}
+finally {
+    await app.close();
+    await fixture.close();
+}
+//# sourceMappingURL=demo.js.map

package/dist/scripts/demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.js","sourceRoot":"","sources":["../../scripts/demo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,OAAO,GAAG,MAAM,gBAAgB,EAAE,CAAC;AACzC,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;AAExB,IAAI,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC;QAChC,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,eAAe;QACpB,OAAO,EAAE;YACP,IAAI,EAAE,yDAAyD;YAC/D,QAAQ,EAAE,OAAO,CAAC,GAAG;YACrB,QAAQ,EAAE,iBAAiB;YAC3B,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;YAC1B,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC;gBACvC,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC3B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC1B;aACF;YACD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SACxB;KACF,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;QAAS,CAAC;IACT,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IAClB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC"}

package/dist/scripts/profile-login.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/profile-login.js

@@ -0,0 +1,38 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { chromium } from "playwright";
+import { PROFILES_DIR } from "../src/config.js";
+const args = new Map();
+for (let index = 2; index < process.argv.length; index += 2) {
+    const key = process.argv[index];
+    const value = process.argv[index + 1];
+    if (key?.startsWith("--") && value) {
+        args.set(key.slice(2), value);
+    }
+}
+const id = args.get("id");
+const url = args.get("url");
+if (!id || !url) {
+    console.error("Usage: npm run profile:login -- --id my-profile --url https://example.com/login");
+    process.exit(1);
+}
+const profileDir = path.join(PROFILES_DIR, id);
+await fs.mkdir(profileDir, { recursive: true });
+const userDataDir = path.join(profileDir, "user-data-dir");
+await fs.mkdir(userDataDir, { recursive: true });
+const context = await chromium.launchPersistentContext(userDataDir, { headless: false });
+const page = context.pages()[0] ?? (await context.newPage());
+await page.goto(url, { waitUntil: "domcontentloaded" });
+console.log(`Log in or solve challenges in the opened browser for profile '${id}'.`);
+await waitForEnter();
+await context.close();
+console.log(`Saved persistent browser profile to ${userDataDir}`);
+function waitForEnter() {
+    return new Promise((resolve) => {
+        console.log("Press Enter here when login is complete.");
+        process.stdin.resume();
+        process.stdin.setEncoding("utf8");
+        process.stdin.once("data", () => resolve());
+    });
+}
+//# sourceMappingURL=profile-login.js.map

package/dist/scripts/profile-login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-login.js","sourceRoot":"","sources":["../../scripts/profile-login.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;AACvC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACtC,IAAI,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;QACnC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAE5B,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;IAChB,OAAO,CAAC,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACjG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AAC/C,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAChD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;AAC3D,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAEjD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,uBAAuB,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACzF,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAC7D,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAExD,OAAO,CAAC,GAAG,CAAC,iEAAiE,EAAE,IAAI,CAAC,CAAC;AAErF,MAAM,YAAY,EAAE,CAAC;AACrB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;AACtB,OAAO,CAAC,GAAG,CAAC,uCAAuC,WAAW,EAAE,CAAC,CAAC;AAElE,SAAS,YAAY;IACnB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/agents/auto-agent.d.ts

@@ -0,0 +1,22 @@
+import { probeCliProxy } from "./cliproxy-agent.js";
+import type { AgentAdapter, AgentTurnInput, PlannedAction, TaskRequest } from "../tasks/schemas.js";
+type AutoAgentDeps = {
+    probe?: typeof probeCliProxy;
+    createCliProxy?: (request: TaskRequest) => AgentAdapter;
+    createOpencode?: (request: TaskRequest) => AgentAdapter;
+};
+export declare class AutoAgent implements AgentAdapter {
+    private readonly request;
+    private readonly deps;
+    private delegate?;
+    private selectedReason;
+    constructor(request: TaskRequest, deps?: AutoAgentDeps);
+    init(): Promise<void>;
+    nextAction(input: AgentTurnInput): Promise<PlannedAction>;
+    close(): Promise<void>;
+    debugInfo(): {
+        planner: string;
+        reason: string;
+    };
+}
+export {};

package/dist/src/agents/auto-agent.js

@@ -0,0 +1,54 @@
+import { probeCliProxy } from "./cliproxy-agent.js";
+import { CliProxyAgent } from "./cliproxy-agent.js";
+import { OpencodeAgent } from "./opencode-agent.js";
+import { DEFAULT_CLIPROXY_MODEL } from "../config.js";
+export class AutoAgent {
+    request;
+    deps;
+    delegate;
+    selectedReason = "auto not initialized";
+    constructor(request, deps = {}) {
+        this.request = request;
+        this.deps = deps;
+    }
+    async init() {
+        const probe = this.deps.probe ?? probeCliProxy;
+        const createCliProxy = this.deps.createCliProxy ??
+            ((request) => new CliProxyAgent({
+                ...request,
+                agent: { ...request.agent, kind: "cliproxy" },
+            }));
+        const createOpencode = this.deps.createOpencode ??
+            ((request) => new OpencodeAgent({
+                ...request,
+                agent: { ...request.agent, kind: "opencode" },
+            }));
+        const cliproxy = await probe();
+        const hasCliProxyModel = Boolean(this.request.agent.model ?? DEFAULT_CLIPROXY_MODEL);
+        this.delegate = cliproxy.ok && hasCliProxyModel
+            ? createCliProxy(this.request)
+            : createOpencode(this.request);
+        this.selectedReason = cliproxy.ok
+            ? hasCliProxyModel
+                ? "CLIProxy reachable and model configured"
+                : "CLIProxy reachable but no model configured; fell back to OpenCode"
+            : `CLIProxy unavailable (${cliproxy.reason ?? "unknown"}); fell back to OpenCode`;
+        await this.delegate.init();
+    }
+    async nextAction(input) {
+        if (!this.delegate) {
+            throw new Error("AutoAgent not initialized.");
+        }
+        return this.delegate.nextAction(input);
+    }
+    async close() {
+        await this.delegate?.close();
+    }
+    debugInfo() {
+        return {
+            planner: this.delegate?.debugInfo().planner ?? "auto",
+            reason: this.selectedReason,
+        };
+    }
+}
+//# sourceMappingURL=auto-agent.js.map

package/dist/src/agents/auto-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-agent.js","sourceRoot":"","sources":["../../../src/agents/auto-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAStD,MAAM,OAAO,SAAS;IAKD;IACA;IALX,QAAQ,CAAgB;IACxB,cAAc,GAAG,sBAAsB,CAAC;IAEhD,YACmB,OAAoB,EACpB,OAAsB,EAAE;QADxB,YAAO,GAAP,OAAO,CAAa;QACpB,SAAI,GAAJ,IAAI,CAAoB;IACxC,CAAC;IAEJ,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC;QAC/C,MAAM,cAAc,GAClB,IAAI,CAAC,IAAI,CAAC,cAAc;YACxB,CAAC,CAAC,OAAoB,EAAE,EAAE,CACxB,IAAI,aAAa,CAAC;gBAChB,GAAG,OAAO;gBACV,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE;aAC9C,CAAC,CAAC,CAAC;QACR,MAAM,cAAc,GAClB,IAAI,CAAC,IAAI,CAAC,cAAc;YACxB,CAAC,CAAC,OAAoB,EAAE,EAAE,CACxB,IAAI,aAAa,CAAC;gBAChB,GAAG,OAAO;gBACV,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE;aAC9C,CAAC,CAAC,CAAC;QAER,MAAM,QAAQ,GAAG,MAAM,KAAK,EAAE,CAAC;QAC/B,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,sBAAsB,CAAC,CAAC;QACrF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,EAAE,IAAI,gBAAgB;YAC7C,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;YAC9B,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC,EAAE;YAC/B,CAAC,CAAC,gBAAgB;gBAChB,CAAC,CAAC,yCAAyC;gBAC3C,CAAC,CAAC,mEAAmE;YACvE,CAAC,CAAC,yBAAyB,QAAQ,CAAC,MAAM,IAAI,SAAS,0BAA0B,CAAC;QACpF,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAqB;QACpC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED,SAAS;QACP,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,OAAO,IAAI,MAAM;YACrD,MAAM,EAAE,IAAI,CAAC,cAAc;SAC5B,CAAC;IACJ,CAAC;CACF"}

package/dist/src/agents/cliproxy-agent.d.ts

@@ -0,0 +1,18 @@
+import type { AgentAdapter, AgentTurnInput, PlannedAction, TaskRequest } from "../tasks/schemas.js";
+export declare class CliProxyAgent implements AgentAdapter {
+    private readonly request;
+    constructor(request: TaskRequest);
+    init(): Promise<void>;
+    nextAction(input: AgentTurnInput): Promise<PlannedAction>;
+    close(): Promise<void>;
+    debugInfo(): {
+        planner: string;
+        reason: string;
+    };
+    private callCliProxy;
+}
+export declare function probeCliProxy(): Promise<{
+    ok: boolean;
+    reason?: string;
+}>;
+export declare function parseCliProxyAction(content: string): PlannedAction | undefined;

package/dist/src/agents/cliproxy-agent.js

@@ -0,0 +1,137 @@
+import { DEFAULT_CLIPROXY_AUTH_TOKEN, DEFAULT_CLIPROXY_BASE_URL, DEFAULT_CLIPROXY_MODEL, } from "../config.js";
+import { ACTION_SCHEMA, buildPlannerPrompt, systemInstructions, validatePlannedAction, } from "./planner-prompt.js";
+export class CliProxyAgent {
+    request;
+    constructor(request) {
+        this.request = request;
+    }
+    async init() {
+        const probe = await probeCliProxy();
+        if (!probe.ok) {
+            throw new Error(`CliProxy unavailable: ${probe.reason}`);
+        }
+    }
+    async nextAction(input) {
+        const messages = [
+            { role: "system", content: systemInstructions() },
+            {
+                role: "user",
+                content: `${buildPlannerPrompt(input)}\n\nReturn only one JSON object for the next action.`,
+            },
+        ];
+        const model = this.request.agent.model ?? DEFAULT_CLIPROXY_MODEL;
+        if (!model) {
+            throw new Error("CliProxy planner needs a model alias/name. Set agent.model or CLIPROXY_MODEL.");
+        }
+        const firstAttempt = await this.callCliProxy({ messages, model, withSchema: true });
+        const parsed = parseCliProxyAction(firstAttempt);
+        if (parsed) {
+            validatePlannedAction(parsed);
+            return parsed;
+        }
+        const secondAttempt = await this.callCliProxy({
+            messages: [
+                ...messages,
+                {
+                    role: "user",
+                    content: "Your last answer was not valid JSON. Return exactly one JSON object matching the action schema and nothing else.",
+                },
+            ],
+            model,
+            withSchema: false,
+        });
+        const repaired = parseCliProxyAction(secondAttempt);
+        if (!repaired) {
+            throw new Error("CliProxy planner did not return parseable JSON.");
+        }
+        validatePlannedAction(repaired);
+        return repaired;
+    }
+    async close() { }
+    debugInfo() {
+        return {
+            planner: "cliproxy",
+            reason: "CLIProxy reachable with configured model alias",
+        };
+    }
+    async callCliProxy(options) {
+        const body = {
+            model: options.model,
+            messages: options.messages,
+            temperature: 0.1,
+        };
+        if (options.withSchema) {
+            body.response_format = {
+                type: "json_schema",
+                json_schema: {
+                    name: "browser_action",
+                    strict: true,
+                    schema: ACTION_SCHEMA,
+                },
+            };
+        }
+        const response = await fetch(`${DEFAULT_CLIPROXY_BASE_URL}/chat/completions`, {
+            method: "POST",
+            headers: withOptionalAuth({
+                "content-type": "application/json",
+            }),
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            throw new Error(`CliProxy request failed: ${response.status} ${await response.text()}`);
+        }
+        const payload = (await response.json());
+        const content = payload.choices?.[0]?.message?.content;
+        if (typeof content === "string") {
+            return content;
+        }
+        if (Array.isArray(content)) {
+            return content.map((part) => part.text ?? "").join("");
+        }
+        throw new Error("CliProxy response did not include planner content.");
+    }
+}
+export async function probeCliProxy() {
+    try {
+        const response = await fetch(`${DEFAULT_CLIPROXY_BASE_URL}/models`, {
+            headers: withOptionalAuth({ accept: "application/json" }),
+        });
+        if (response.ok) {
+            return { ok: true };
+        }
+        if (response.status === 401) {
+            return { ok: false, reason: "authentication required or token invalid" };
+        }
+        return { ok: false, reason: `unexpected status ${response.status}` };
+    }
+    catch (error) {
+        return { ok: false, reason: String(error) };
+    }
+}
+function withOptionalAuth(headers) {
+    return DEFAULT_CLIPROXY_AUTH_TOKEN
+        ? { ...headers, authorization: `Bearer ${DEFAULT_CLIPROXY_AUTH_TOKEN}` }
+        : headers;
+}
+export function parseCliProxyAction(content) {
+    const trimmed = content.trim();
+    const candidates = [trimmed];
+    const blockMatch = trimmed.match(/```json\s*([\s\S]+?)```/i) ?? trimmed.match(/```([\s\S]+?)```/i);
+    if (blockMatch?.[1]) {
+        candidates.push(blockMatch[1].trim());
+    }
+    const objectMatch = trimmed.match(/\{[\s\S]*\}/);
+    if (objectMatch?.[0]) {
+        candidates.push(objectMatch[0]);
+    }
+    for (const candidate of candidates) {
+        try {
+            return JSON.parse(candidate);
+        }
+        catch {
+            continue;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=cliproxy-agent.js.map

package/dist/src/agents/cliproxy-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliproxy-agent.js","sourceRoot":"","sources":["../../../src/agents/cliproxy-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAU7B,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,OAAoB;QAApB,YAAO,GAAP,OAAO,CAAa;IAAG,CAAC;IAErD,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAqB;QACpC,MAAM,QAAQ,GAAG;YACf,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE;YACjD;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,sDAAsD;aAC5F;SACF,CAAC;QAEF,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,sBAAsB,CAAC;QACjE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;QACJ,CAAC;QACD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACpF,MAAM,MAAM,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;QACjD,IAAI,MAAM,EAAE,CAAC;YACX,qBAAqB,CAAC,MAAM,CAAC,CAAC;YAC9B,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC;YAC5C,QAAQ,EAAE;gBACR,GAAG,QAAQ;gBACX;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EACL,kHAAkH;iBACrH;aACF;YACD,KAAK;YACL,UAAU,EAAE,KAAK;SAClB,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAChC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,KAAK,KAAmB,CAAC;IAE/B,SAAS;QACP,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,MAAM,EAAE,gDAAgD;SACzD,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,OAI1B;QACC,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,WAAW,EAAE,GAAG;SACjB,CAAC;QAEF,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,IAAI,CAAC,eAAe,GAAG;gBACrB,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE;oBACX,IAAI,EAAE,gBAAgB;oBACtB,MAAM,EAAE,IAAI;oBACZ,MAAM,EAAE,aAAa;iBACtB;aACF,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,yBAAyB,mBAAmB,EAAE;YAC5E,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,gBAAgB,CAAC;gBACxB,cAAc,EAAE,kBAAkB;aACnC,CAAC;YACF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,IAAI,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1F,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA2B,CAAC;QAClE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;QACvD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,yBAAyB,SAAS,EAAE;YAClE,OAAO,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;SAC1D,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QACtB,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,0CAA0C,EAAE,CAAC;QAC3E,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;IACvE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,OAA+B;IACvD,OAAO,2BAA2B;QAChC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,aAAa,EAAE,UAAU,2BAA2B,EAAE,EAAE;QACxE,CAAC,CAAC,OAAO,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACnG,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpB,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACjD,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAkB,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/agents/index.d.ts

@@ -0,0 +1,2 @@
+import type { AgentAdapter, TaskRequest } from "../tasks/schemas.js";
+export declare function createAgent(request: TaskRequest): AgentAdapter;

package/dist/src/agents/index.js

@@ -0,0 +1,17 @@
+import { AutoAgent } from "./auto-agent.js";
+import { CliProxyAgent } from "./cliproxy-agent.js";
+import { MockAgent } from "./mock-agent.js";
+import { OpencodeAgent } from "./opencode-agent.js";
+export function createAgent(request) {
+    if (request.agent.kind === "auto") {
+        return new AutoAgent(request);
+    }
+    if (request.agent.kind === "cliproxy") {
+        return new CliProxyAgent(request);
+    }
+    if (request.agent.kind === "opencode") {
+        return new OpencodeAgent(request);
+    }
+    return new MockAgent(request);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,UAAU,WAAW,CAAC,OAAoB;IAC9C,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAClC,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACtC,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACtC,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}