@post-print/agent-harness 1.1.9 → 2.0.0

package/README.md

@@ -1,106 +1,24 @@
 # @post-print/agent-harness
 
-<!-- source-of-truth: agent-harness package -->
-
+<!-- source-of-truth: configured agent definitions and isolated harness sessions -->
 <!-- doc-meta: owner=eng | last-reviewed=2026-09-16 -->
-
 <!-- review-deps: paths=packages/harness/src/*.ts,packages/harness/src/**/*.ts,packages/harness/package.json -->
 
-Host-agnostic runtime for direct Cursor, Claude, and OpenAI Codex execution, capture, and judging.
+Configure coding agents for agent-test. Definitions are reusable; each task session owns an isolated worker and host runtime.
 
 ```ts
-import {
-  runAgent,
-  loadContext,
-  judgeTrace,
-  createSealedWorkspace,
-} from "@post-print/agent-harness";
+import { openai, claude, cursor } from "@post-print/agent-harness";
 
-const sealed = await createSealedWorkspace({ callerCwd: process.cwd() });
-const context = await loadContext({ cwd: sealed.path, profile: "cursor" });
-const session = await runAgent({
-  host: "cursor",
-  cwd: sealed.path,
-  context,
-  prompt: "…",
-});
-```
-
-For a host-native session, keep the scenario prompt unchanged and let the host discover its supported project files:
-
-```ts
-const context = await loadContext({
-  cwd: sealed.path,
-  profile: "cursor",
-  mode: "host-native",
+export const coder = openai({
+  auth: { type: "subscription" },
+  skills: ["./skills/testing"],
+  context: { instructions: ["Run the relevant tests."], files: ["./context/project.md"] },
+  includeGlobalSkills: false,
 });
 ```
 
-`harness-preamble` remains the default for compatibility. It composes selected context sources and optional skill catalogs into the submitted user input.
-
-Replay-based testing is deprecated and removed. `runAgent` always launches the selected agent host. Untyped calls with `host: "replay"` fail with migration guidance.
-
-`runAgent` / `runCursorAgent` / `runClaudeAgent` / `runOpenaiAgent` accept optional `timeoutMs` and `failOnUserInput` (default `true`). Set `failOnUserInput: false` to start a user simulator that answers AskQuestion-style tools. The next host turn receives the original task plus the transcript.
-
-## Hosts
-
-| Host | Binary / SDK | Auth |
-| --- | --- | --- |
-| `cursor` | `@cursor/sdk` | Subscription after `npx agent-test login`, or `--auth-mode api-key` plus `CURSOR_API_KEY` |
-| `claude` | `claude` or `CLAUDE_CODE_BIN` | Subscription after Claude Code login, or `--auth-mode api-key` plus `ANTHROPIC_API_KEY` |
-| `openai` | `codex` or `CODEX_BIN` | Subscription after `codex login`, or `--auth-mode api-key` plus `OPENAI_API_KEY` or `CODEX_API_KEY` |
-| custom slug | your `HostAdapter` | `missingAuth()` on the adapter |
-
-A consumer repo can add a host. Implement `HostAdapter` and call `registerHostAdapter`. Builtin ids stay reserved.
-
-```ts
-import { registerHostAdapter, type HostAdapter, runAgent } from "@post-print/agent-harness";
-
-const gemini: HostAdapter = {
-  host: "gemini",
-  missingAuth() {
-    return process.env.GEMINI_API_KEY ? undefined : "GEMINI_API_KEY not set";
-  },
-  classifierHost: "cursor",
-  async run(options) {
-    return {
-      host: "gemini",
-      status: "completed",
-      durationMs: 0,
-      trace: {
-        messages: [{ role: "assistant", content: options.prompt }],
-        toolCalls: [],
-        shellCommands: [],
-        artifacts: {},
-      },
-    };
-  },
-};
-
-registerHostAdapter(gemini);
-await runAgent({ host: "gemini", cwd: process.cwd(), prompt: "…" });
-```
-
-For `agent-test`, put adapters in `agent-test.config.mjs` or pass `--adapter ./hosts/gemini.mjs`. Isolated children load the same config.
-
-Set `classifierHost` to `cursor`, `claude`, or `openai`, or implement `classify()`. A custom host without one cannot run the judge.
-
-Claude `api-key` mode uses `--bare` for harness-preamble runs and project setting sources for host-native runs. Subscription mode uses `--strict-mcp-config`. OpenAI agent runs use `codex exec --json --sandbox workspace-write --cd <sealed> --ignore-user-config -c approval_policy=never`. Pass `networkAccess: true` to add `-c sandbox_workspace_write.network_access=true` to that workspace-write child; omitted or `false` stays offline. Suite MCP servers pass to Codex as `-c mcp_servers.<name>=…`. A user `~/.codex/config.toml` model pin does not apply. When user skills stay out, the Codex child gets a temp home with only its login file.
-
-## Skills
-
-The sealed workspace is a git repo. Each host discovers its own project skill roots: Cursor uses `.cursor/skills` and `.agents/skills`, Claude uses `.claude/skills`, and Codex uses `.agents/skills`. Optional `skills` paths are only used by harness-preamble mode to build a synthetic catalog. Host-global user skills stay out unless `allowUserSkills` is true. The deny path uses Cursor `settingSources: ["project"]` plus a temp `HOME` with no skill trees, Claude project-only settings or `--bare`, and Codex `--ignore-user-config` plus an auth-only temp home. The judge scores any criterion against the full transcript, including tool names, args, and results. A tool result is an outcome.
-
-## Isolation
-
-`createSealedWorkspace` copies `git archive HEAD` plus caller context (rules, skill trees, `AGENTS.md`, `skeleton.toml`) into a temp folder. Pass `workspace` to copy a caller-relative folder instead. It then runs `git init` in that folder so git does not walk to the caller repo. Cursor file and shell tools use that same folder. The test runner fails the scenario when tool paths leave it. Cursor's temporary large-output files are host evidence and do not count as leaks.
-
-## Judge
-
-`judgeTrace` uses the same host family as the test agent. Default auth is subscription. Cursor judge calls use the SDK login store, or `CURSOR_API_KEY` when `--auth-mode api-key` is set. Claude and OpenAI judges use their own host credentials.
-
-The Cursor app login does not feed the SDK. Run `npx agent-test login`, or pass `--auth-mode api-key` plus `CURSOR_API_KEY`. Subscription mode uses the Codex CLI login and strips stale API keys from the child env.
+`openai()` runs Codex, `claude()` runs Claude Code, and `cursor()` uses the Cursor SDK. All accept model and authentication options. API-key authentication names an environment variable: `{ type: "api-key", env: "OPENAI_API_KEY" }`.
 
-Judges may inspect explicitly listed evidence snapshots with file tools or read-only shell commands. Codex uses a read-only sandbox with `--skip-git-repo-check` for snapshots without Git metadata. Project execution and network access remain forbidden.
+Factories do not launch agents. Agent-test prepares workspaces, installs attached skills, supplies context, creates sessions, and guarantees cleanup. Custom adapters use `defineAgent()` and `customAgent()`; see [the SDK guide](../../docs/sdk-v2.md#custom-agents).
 
-Consumer: `@post-print/agent-test`. Auth and adapters: [docs/hosts.md](../../docs/hosts.md). Sealed workspace: [docs/isolation.md](../../docs/isolation.md).
+Built-in continuation currently reconstructs prior conversation. Cursor does not yet support enforced read-only judge sessions; use OpenAI or Claude as the judge. ACP is not introduced by this change.

package/dist/agent-definition.d.ts

@@ -0,0 +1,77 @@
+import type { AgentTrace, AgentUsage, BuiltinAgentHost, McpServerConfig } from "./types.js";
+export type AgentAuth = {
+    type: "subscription";
+} | {
+    type: "api-key";
+    env: string;
+};
+export interface AgentContext {
+    instructions?: readonly string[];
+    files?: readonly string[];
+}
+export interface AgentOptions {
+    model?: string;
+    auth?: AgentAuth;
+    skills?: readonly string[];
+    context?: AgentContext;
+    /** Include host-global skills only when explicitly enabled. Defaults to false. */
+    includeGlobalSkills?: boolean;
+    mcpServers?: Record<string, McpServerConfig>;
+    networkAccess?: boolean;
+}
+export interface AgentDefinition {
+    readonly host?: BuiltinAgentHost;
+    readonly adapter?: string;
+    readonly options: Readonly<AgentOptions & Record<string, unknown>>;
+}
+export interface AgentCapabilities {
+    conversation: "native" | "reconstructed";
+    toolCalls?: boolean;
+    commandExitCodes?: boolean;
+    fileReads?: boolean;
+    tokenUsage?: boolean;
+    readOnly?: boolean;
+}
+export type AgentEvent = {
+    type: "text";
+    text: string;
+} | {
+    type: "tool";
+    name: string;
+    args?: Record<string, unknown>;
+    result?: string;
+    exitCode?: number;
+    succeeded?: boolean;
+} | {
+    type: "usage";
+    usage: AgentUsage;
+} | {
+    type: "trace";
+    trace: AgentTrace;
+};
+export interface AdapterSession {
+    run(prompt: string): AsyncIterable<AgentEvent>;
+    close(): Promise<void>;
+}
+export interface AgentAdapter<T = Record<string, unknown>> {
+    name: string;
+    capabilities: AgentCapabilities;
+    createSession(input: {
+        options: T;
+        workspace: {
+            path: string;
+        };
+        signal: AbortSignal;
+        readOnly: boolean;
+    }): Promise<AdapterSession>;
+}
+/** Run the OpenAI Codex coding agent. Does not start a session. */
+export declare const openai: (options?: AgentOptions) => AgentDefinition;
+export declare const claude: (options?: AgentOptions) => AgentDefinition;
+export declare const cursor: (options?: AgentOptions) => AgentDefinition;
+export declare function customAgent<T extends Record<string, unknown>>(input: {
+    adapter: string;
+    options: T & AgentOptions;
+}): AgentDefinition;
+export declare function defineAgent<T>(adapter: AgentAdapter<T>): AgentAdapter<T>;
+//# sourceMappingURL=agent-definition.d.ts.map

package/dist/agent-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-definition.d.ts","sourceRoot":"","sources":["../src/agent-definition.ts"],"names":[],"mappings":"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"}

package/dist/agent-definition.js

@@ -0,0 +1,46 @@
+function freeze(value) {
+    if (value && typeof value === "object") {
+        for (const child of Object.values(value))
+            freeze(child);
+        Object.freeze(value);
+    }
+    return value;
+}
+function definition(value) {
+    if (Object.hasOwn(value.options, "allowUserSkills"))
+        throw new Error("allowUserSkills was renamed to includeGlobalSkills");
+    const copy = JSON.parse(JSON.stringify({
+        ...value,
+        options: {
+            ...value.options,
+            includeGlobalSkills: value.options.includeGlobalSkills ?? false,
+        },
+    }, (_key, item) => {
+        if (typeof item === "function" || typeof item === "symbol" || typeof item === "bigint")
+            throw new Error("Agent definitions must contain serializable configuration only");
+        return item;
+    }));
+    if (value.options.auth?.type === "api-key" && !value.options.auth.env.trim()) {
+        throw new Error("API-key authentication requires an environment variable name");
+    }
+    return freeze(copy);
+}
+function builtin(host, options = {}) {
+    if (options.networkAccess && host !== "openai")
+        throw new Error(`networkAccess is not supported by ${host}`);
+    return definition({
+        host,
+        options: { auth: { type: "subscription" }, ...options },
+    });
+}
+/** Run the OpenAI Codex coding agent. Does not start a session. */
+export const openai = (options) => builtin("openai", options);
+export const claude = (options) => builtin("claude", options);
+export const cursor = (options) => builtin("cursor", options);
+export function customAgent(input) {
+    return definition(input);
+}
+export function defineAgent(adapter) {
+    return adapter;
+}
+//# sourceMappingURL=agent-definition.js.map

package/dist/agent-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-definition.js","sourceRoot":"","sources":["../src/agent-definition.ts"],"names":[],"mappings":"AAwDA,SAAS,MAAM,CAAI,KAAQ;IAC1B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AACD,SAAS,UAAU,CAAC,KAAsB;IACzC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CACtB,IAAI,CAAC,SAAS,CACb;QACC,GAAG,KAAK;QACR,OAAO,EAAE;YACR,GAAG,KAAK,CAAC,OAAO;YAChB,mBAAmB,EAAE,KAAK,CAAC,OAAO,CAAC,mBAAmB,IAAI,KAAK;SAC/D;KACD,EACD,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QACd,IAAI,OAAO,IAAI,KAAK,UAAU,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ;YACrF,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACnF,OAAO,IAAI,CAAC;IACb,CAAC,CACD,CACkB,CAAC;IACrB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AACD,SAAS,OAAO,CAAC,IAAsB,EAAE,OAAO,GAAiB,EAAE;IAClE,IAAI,OAAO,CAAC,aAAa,IAAI,IAAI,KAAK,QAAQ;QAC7C,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;IAC9D,OAAO,UAAU,CAAC;QACjB,IAAI;QACJ,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,GAAG,OAAO,EAAE;KACvD,CAAC,CAAC;AACJ,CAAC;AACD,mEAAmE;AACnE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAsB,EAAmB,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC9F,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAsB,EAAmB,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC9F,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAsB,EAAmB,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC9F,MAAM,UAAU,WAAW,CAAoC,KAG9D;IACA,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AACD,MAAM,UAAU,WAAW,CAAI,OAAwB;IACtD,OAAO,OAAO,CAAC;AAChB,CAAC"}

package/dist/agent-session.d.ts

@@ -0,0 +1,17 @@
+import type { AgentCapabilities, AgentDefinition, AgentEvent } from "./agent-definition.js";
+import type { AgentTrace } from "./types.js";
+export interface HarnessSession {
+    capabilities: AgentCapabilities;
+    run(prompt: string, onEvent?: (event: AgentEvent) => void): Promise<AgentTrace>;
+    close(): Promise<void>;
+}
+interface SessionInput {
+    agent: AgentDefinition;
+    workspace: string;
+    signal: AbortSignal;
+    readOnly?: boolean;
+}
+/** Each session owns a worker and all mutable host state within it. */
+export declare function createAgentSession(input: SessionInput): Promise<HarnessSession>;
+export {};
+//# sourceMappingURL=agent-session.d.ts.map

package/dist/agent-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.d.ts","sourceRoot":"","sources":["../src/agent-session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC9B,YAAY,EAAE,iBAAiB,CAAC;IAChC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AACD,UAAU,YAAY;IACrB,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AA6ID,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAG/E"}

package/dist/agent-session.js

@@ -0,0 +1,165 @@
+import { fork } from "node:child_process";
+import { fileURLToPath } from "node:url";
+class SessionWorker {
+    input;
+    child = fork(fileURLToPath(new URL("./agent-worker.js", import.meta.url)), [], {
+        stdio: ["ignore", "ignore", "pipe", "ipc"],
+        detached: process.platform !== "win32",
+        execArgv: [],
+        env: { ...process.env, AGENT_HARNESS_SESSION_WORKER: "1" },
+    });
+    exited;
+    stderr = "";
+    pending;
+    listener;
+    closed = false;
+    busy = false;
+    closing;
+    constructor(input) {
+        this.input = input;
+        this.exited = new Promise((resolve) => {
+            this.child.once("exit", () => resolve());
+            this.child.once("error", () => resolve());
+        });
+        this.child.stderr?.on("data", (chunk) => {
+            this.stderr = (this.stderr + chunk).slice(-8192);
+        });
+        this.child.on("message", (raw) => this.receive(raw));
+        this.child.on("error", (error) => this.fail(error));
+        this.child.on("exit", (code, signal) => {
+            this.closed = true;
+            this.fail(new Error(`Agent worker exited (${signal ?? code}): ${this.stderr}`));
+        });
+        input.signal.addEventListener("abort", this.abort, { once: true });
+        if (input.signal.aborted)
+            this.abort();
+    }
+    fail(error) {
+        this.pending?.reject(error);
+        this.pending = undefined;
+    }
+    receive(raw) {
+        const message = raw;
+        if (message.type === "event") {
+            try {
+                this.listener?.(message.value);
+            }
+            catch (error) {
+                this.fail(error);
+                this.abort();
+            }
+        }
+        else if (message.type === "error")
+            this.fail(new Error(message.error));
+        else {
+            this.pending?.resolve(message.value);
+            this.pending = undefined;
+        }
+    }
+    request(message) {
+        return new Promise((resolve, reject) => {
+            if (this.closed) {
+                reject(new Error("Agent session is closed"));
+                return;
+            }
+            this.pending = { resolve, reject };
+            this.child.send(message, (error) => {
+                if (error)
+                    this.fail(error);
+            });
+        });
+    }
+    kill = () => {
+        if (!this.child.pid)
+            return;
+        try {
+            if (process.platform === "win32")
+                this.child.kill("SIGKILL");
+            else
+                process.kill(-this.child.pid, "SIGKILL");
+        }
+        catch {
+            /* Already exited. */
+        }
+    };
+    abort = () => {
+        this.closed = true;
+        this.fail(new Error("Agent session cancelled"));
+        try {
+            if (this.child.pid && process.platform !== "win32")
+                process.kill(-this.child.pid, "SIGTERM");
+            else
+                this.child.kill("SIGTERM");
+        }
+        catch {
+            /* Already exited. */
+        }
+        setTimeout(this.kill, 500).unref();
+    };
+    async initialize() {
+        try {
+            const { agent, workspace, readOnly } = this.input;
+            const capabilities = (await this.request({
+                type: "init",
+                value: { agent, workspace, readOnly: readOnly === true },
+            }));
+            return {
+                capabilities,
+                run: (prompt, onEvent) => this.run(prompt, onEvent),
+                close: () => this.close(),
+            };
+        }
+        catch (error) {
+            this.input.signal.removeEventListener("abort", this.abort);
+            this.kill();
+            await this.exited;
+            throw error;
+        }
+    }
+    async run(prompt, onEvent) {
+        this.input.signal.throwIfAborted();
+        if (this.busy)
+            throw new Error("Overlapping runs on one session are not supported; use variants");
+        this.busy = true;
+        this.listener = onEvent;
+        try {
+            return (await this.request({ type: "run", value: prompt }));
+        }
+        finally {
+            this.busy = false;
+            this.listener = undefined;
+        }
+    }
+    close() {
+        this.closing ??= this.dispose();
+        return this.closing;
+    }
+    async dispose() {
+        this.input.signal.removeEventListener("abort", this.abort);
+        if (this.closed) {
+            await this.exited;
+            return;
+        }
+        if (this.busy) {
+            this.abort();
+            await this.exited;
+            return;
+        }
+        const timer = setTimeout(this.kill, 2000);
+        try {
+            await this.request({ type: "close" });
+        }
+        finally {
+            clearTimeout(timer);
+            this.kill();
+            this.closed = true;
+            await this.exited;
+        }
+    }
+}
+/** Each session owns a worker and all mutable host state within it. */
+export function createAgentSession(input) {
+    input.signal.throwIfAborted();
+    return new SessionWorker(input).initialize();
+}
+//# sourceMappingURL=agent-session.js.map

package/dist/agent-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.js","sourceRoot":"","sources":["../src/agent-session.ts"],"names":[],"mappings":"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"}

package/dist/agent-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-worker.d.ts.map

package/dist/agent-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-worker.d.ts","sourceRoot":"","sources":["../src/agent-worker.ts"],"names":[],"mappings":""}

package/dist/agent-worker.js

@@ -0,0 +1,167 @@
+import { pathToFileURL } from "node:url";
+import { cancelActiveClaudeRun, runClaudeAgent } from "./claude-run.js";
+import { cancelActiveCursorRun, runCursorAgent } from "./cursor-run.js";
+import { cancelActiveOpenaiRun, runOpenaiAgent } from "./openai-run.js";
+let session;
+const signal = new AbortController();
+const send = (type, value) => process.send?.({ type, value });
+function empty() {
+    return { messages: [], toolCalls: [], shellCommands: [], artifacts: {} };
+}
+async function initialize(input) {
+    const { agent, readOnly } = input;
+    if (agent.adapter)
+        return initializeCustom(input, agent.adapter);
+    if (readOnly && agent.host === "cursor")
+        throw new Error("Cursor adapter does not yet provide enforced read-only judging; use openai or claude as the judge");
+    session = builtinSession(input);
+    return {
+        conversation: "reconstructed",
+        toolCalls: true,
+        commandExitCodes: true,
+        fileReads: true,
+        tokenUsage: true,
+        readOnly: agent.host !== "cursor",
+    };
+}
+async function initializeCustom(input, adapterPath) {
+    const { agent, workspace, readOnly } = input;
+    const url = adapterPath.startsWith("file:") ? adapterPath : pathToFileURL(adapterPath).href;
+    const adapter = (await import(url)).default;
+    if (!adapter?.createSession || !adapter.capabilities)
+        throw new Error("Custom adapter must export defineAgent(...) as default");
+    if (readOnly && !adapter.capabilities.readOnly)
+        throw new Error("Judge requires an adapter with readOnly capability");
+    session = await adapter.createSession({
+        options: agent.options,
+        workspace: { path: workspace },
+        signal: signal.signal,
+        readOnly,
+    });
+    return adapter.capabilities;
+}
+function builtinOptions(input, prompt) {
+    const { agent, workspace, readOnly } = input;
+    const auth = agent.options.auth ?? { type: "subscription" };
+    const apiKey = auth.type === "api-key" ? process.env[auth.env] : undefined;
+    if (auth.type === "api-key" && !apiKey)
+        throw new Error(`Missing API key in ${auth.env}`);
+    return {
+        cwd: workspace,
+        prompt,
+        apiKey,
+        authMode: auth.type,
+        includeGlobalSkills: agent.options.includeGlobalSkills === true,
+        mcpServers: readOnly ? undefined : agent.options.mcpServers,
+        failOnUserInput: true,
+        onAgentEvent: (event) => send("event", event),
+    };
+}
+async function runBuiltin(input, prompt) {
+    const common = builtinOptions(input, prompt);
+    const { agent, readOnly } = input;
+    if (agent.host === "openai")
+        return runOpenaiAgent({
+            ...common,
+            model: agent.options.model,
+            sandbox: readOnly ? "read-only" : "workspace-write",
+            networkAccess: agent.options.networkAccess,
+        });
+    if (agent.host === "claude")
+        return runClaudeAgent({
+            ...common,
+            model: agent.options.model,
+            loadProjectContext: true,
+            readOnly,
+        });
+    return runCursorAgent({
+        ...common,
+        model: agent.options.model ? { id: agent.options.model } : undefined,
+    });
+}
+function builtinSession(input) {
+    const history = [];
+    return {
+        async *run(prompt) {
+            const submitted = history.length
+                ? `Previous conversation (context only):\n${history.join("\n\n")}\n\nCurrent user request:\n${prompt}`
+                : prompt;
+            const result = await runBuiltin(input, submitted);
+            if (result.status !== "completed") {
+                send("event", { type: "trace", trace: result.trace });
+                throw new Error(`Agent execution failed: ${JSON.stringify(result.trace.artifacts)}`);
+            }
+            const answer = result.trace.messages
+                .filter((message) => message.role === "assistant")
+                .map((message) => message.content)
+                .join("\n");
+            history.push(`User: ${prompt}`, `Assistant: ${answer}`);
+            yield { type: "trace", trace: result.trace };
+        },
+        async close() { },
+    };
+}
+function recordEvent(trace, event) {
+    switch (event.type) {
+        case "trace":
+            return event.trace;
+        case "text":
+            trace.messages.push({ role: "assistant", content: event.text });
+            break;
+        case "tool":
+            trace.toolCalls.push({
+                name: event.name,
+                args: event.args,
+                result: event.result,
+                exitCode: event.exitCode,
+                succeeded: event.succeeded,
+            });
+            break;
+        case "usage":
+            trace.usage = event.usage;
+            break;
+    }
+    return trace;
+}
+async function run(prompt) {
+    let trace = empty();
+    trace.messages.push({ role: "user", content: prompt });
+    for await (const event of session.run(prompt)) {
+        send("event", event);
+        trace = recordEvent(trace, event);
+    }
+    send("result", trace);
+}
+process.on("SIGTERM", () => {
+    signal.abort();
+    cancelActiveClaudeRun();
+    cancelActiveCursorRun();
+    cancelActiveOpenaiRun();
+});
+process.on("disconnect", () => {
+    signal.abort();
+    cancelActiveClaudeRun();
+    cancelActiveCursorRun();
+    cancelActiveOpenaiRun();
+    process.exit(1);
+});
+process.on("message", async (raw) => {
+    const message = raw;
+    try {
+        if (message.type === "init")
+            send("ready", await initialize(message.value));
+        if (message.type === "run")
+            await run(message.value);
+        if (message.type === "close") {
+            await session.close();
+            send("closed");
+        }
+    }
+    catch (error) {
+        process.send?.({
+            type: "error",
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+});
+//# sourceMappingURL=agent-worker.js.map

package/dist/agent-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-worker.js","sourceRoot":"","sources":["../src/agent-worker.ts"],"names":[],"mappings":"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"}

package/dist/capture.d.ts

@@ -82,6 +82,7 @@ export interface TraceAccumulator {
     usage?: AgentUsage;
 }
 export declare function createTraceAccumulator(): TraceAccumulator;
+export declare function mergeToolCall(previous: AgentToolCall, toolCall: AgentToolCall): AgentToolCall;
 /** Fold one SDK stream event into trace fields without retaining the raw event. */
 export declare function accumulateSdkEvent(acc: TraceAccumulator, event: SdkMessage): void;
 export declare function finalizeTraceAccumulator(acc: TraceAccumulator, options?: {