@a-dray/aglib 0.1.0

package/dist/harness/adapters/acp/index.js

@@ -0,0 +1,479 @@
+import { textOf } from "../../../content.js";
+import { err, ok } from "../../../result.js";
+import { createRpc } from "./rpc.js";
+const PROTOCOL_VERSION = 1;
+/**
+ * Runs a foreign coding agent over the Agent Client Protocol.
+ *
+ * The adapter is not a remote control. It does three things the raw protocol
+ * does not: it normalises whatever the agent did into this package's entries,
+ * so one durable log describes a Claude Code turn and a native-loop turn
+ * identically; it puts the agent's own tools under the application's decision
+ * function, one call at a time; and it hands the agent tool servers of ours, so
+ * agents can dispatch and message each other.
+ */
+export function createAcpHarness(options) {
+    return {
+        id: options.id,
+        // Its tools are its own. We gate them and we record them; we do not claim
+        // to have validated arguments we never had a schema for.
+        toolUse: "harness",
+        // The agent owns its context. Our entries describe what it did, and cannot
+        // by themselves put it back mid-turn.
+        recovery: "none",
+        run: (context) => runTurn(options, context),
+    };
+}
+async function runTurn(options, context) {
+    const started = await options.sandbox.spawn({
+        command: options.agent.command,
+        cwd: options.sandbox.root,
+        ...(options.agent.env ? { env: options.agent.env } : {}),
+    });
+    if (!started.ok)
+        return { status: "failed", error: started.error };
+    const rpc = createRpc(started.value);
+    const turn = createTurn(options, context, rpc);
+    try {
+        return await turn.run();
+    }
+    finally {
+        rpc.close();
+    }
+}
+/** Cumulative state for one activation. Discarded with the process that produced it. */
+function createTurn(options, context, rpc) {
+    const sandbox = options.sandbox;
+    const terminals = new Map();
+    const calls = new Map();
+    let text = "";
+    let sessionId = "";
+    let terminalCount = 0;
+    /**
+     * Whether an update describes this activation, or the last one.
+     *
+     * `session/load` replays the whole conversation back as `session/update`
+     * notifications — measured against `codex-acp`, which answers a load with the
+     * user message and the agent message of every turn before it. Those are the
+     * same words this log already committed when they were first said, so
+     * treating them as output would append the entire history again on every
+     * resumed activation, and prepend it to whatever the new turn actually says.
+     * Nothing before the prompt belongs to the run the prompt starts.
+     */
+    let live = false;
+    return { run };
+    async function run() {
+        serveFiles();
+        serveTerminals();
+        servePermission();
+        rpc.onNotify("session/update", (params) => { void receive(params); });
+        const ready = await rpc.request("initialize", {
+            protocolVersion: PROTOCOL_VERSION,
+            clientCapabilities: { fs: { readTextFile: true, writeTextFile: true }, terminal: true },
+            clientInfo: { name: "aglib", version: "0" },
+        });
+        if (!ready.ok)
+            return { status: "failed", error: ready.error };
+        const capabilities = field(ready.value, "agentCapabilities");
+        const opened = await openSession(truthy(field(capabilities, "loadSession")));
+        if (!opened.ok)
+            return { status: "failed", error: opened.error };
+        sessionId = opened.value;
+        options.onSession?.(sessionId);
+        const configured = await configure(opened.value, opened.opened ?? undefined);
+        if (!configured.ok)
+            return { status: "failed", error: configured.error };
+        const cancel = () => rpc.notify("session/cancel", { sessionId });
+        context.signal.addEventListener("abort", cancel, { once: true });
+        // Anything the agent replayed while opening has already been dispatched:
+        // one stdio stream, read in order, so a load's echo is behind us here.
+        live = true;
+        const answered = await rpc.request("session/prompt", {
+            sessionId,
+            prompt: [{ type: "text", text: inputFor(context) }],
+        });
+        context.signal.removeEventListener("abort", cancel);
+        for (const terminal of terminals.values())
+            terminal.process.kill();
+        if (!answered.ok)
+            return { status: "failed", error: answered.error };
+        await flushText();
+        return outcome(String(field(answered.value, "stopReason") ?? "end_turn"));
+    }
+    async function openSession(canLoad) {
+        const parameters = {
+            cwd: sandbox.root,
+            mcpServers: (options.mcpServers ?? []).map((server) => ({
+                type: "stdio", name: server.name, command: server.command,
+                args: [...(server.args ?? [])], env: [...(server.env ?? [])],
+            })),
+        };
+        // The whole answer is carried out, not one field of it: what an agent
+        // publishes about a session has changed shape once already.
+        if (options.resume && canLoad) {
+            const loaded = await rpc.request("session/load", { ...parameters, sessionId: options.resume });
+            if (loaded.ok)
+                return { ...ok(options.resume), opened: loaded.value };
+        }
+        const created = await rpc.request("session/new", parameters);
+        if (!created.ok)
+            return { ...created, opened: null };
+        const id = field(created.value, "sessionId");
+        if (typeof id !== "string") {
+            return { ...err({ code: "protocol", message: "The agent opened no session.", retryable: false }), opened: null };
+        }
+        return { ...ok(id), opened: created.value };
+    }
+    /**
+     * Read what the agent lets us change, report it, and set what was asked for.
+     *
+     * Two shapes, because the protocol changed one into the other: `models` used
+     * to be its own field on the session, and is now one entry in `configOptions`
+     * carrying `category: "model"`. Both are read, so an agent on either version
+     * is understood, and neither is required.
+     *
+     * A resumed session reads this from the `session/load` answer, and an agent
+     * that answers a load without republishing is one whose options we do not
+     * currently know. Setting one from what a previous session said would be
+     * asserting a capability this connection never claimed — so a request for an
+     * option that is not published fails, naming what is. Measured against
+     * `claude-agent-acp`, which does republish on load.
+     */
+    async function configure(id, opened) {
+        const { options: published, legacyModel } = readOptions(opened);
+        if (published.length)
+            options.onConfig?.(published);
+        if (options.mode) {
+            const set = await rpc.request("session/set_mode", { sessionId: id, modeId: options.mode });
+            if (!set.ok)
+                return set;
+        }
+        const wanted = { ...options.select };
+        if (options.model) {
+            const selector = published.find((option) => option.category === "model");
+            if (!selector) {
+                return err({
+                    code: "unsupported",
+                    message: `${options.id} publishes no model selector, so '${options.model}' cannot be chosen over the protocol. Point it at a model through its environment instead.`,
+                    retryable: false,
+                });
+            }
+            wanted[selector.id] = options.model;
+        }
+        for (const [option, value] of Object.entries(wanted)) {
+            const published_ = published.find((candidate) => candidate.id === option);
+            if (!published_) {
+                return err({
+                    code: "unsupported",
+                    message: `${options.id} offers no option '${option}'. It offers: ${published.map((o) => o.id).join(", ") || "none"}.`,
+                    retryable: false,
+                });
+            }
+            if (published_.current === value)
+                continue;
+            if (published_.choices && !published_.choices.some((choice) => choice.id === value)) {
+                return err({
+                    code: "unsupported",
+                    message: `${options.id} does not offer '${String(value)}' for ${published_.name}. It offers: ${published_.choices.map((c) => c.id).join(", ")}.`,
+                    retryable: false,
+                });
+            }
+            const legacy = published_.id === legacyModel;
+            const set = await rpc.request(legacy ? "session/set_model" : "session/set_config_option", legacy
+                ? { sessionId: id, modelId: value }
+                : { sessionId: id, configId: published_.id, value, ...(typeof value === "boolean" ? { type: "boolean" } : {}) });
+            if (!set.ok)
+                return set;
+        }
+        return ok(undefined);
+    }
+    // ---- Normalising what the agent did into entries -------------------------
+    /**
+     * A tool call becomes entries when it finishes, in one commit: the assistant
+     * turn that asked for it, the start, and the result. Committing the pieces as
+     * they arrive would leave half-states in a log whose whole purpose is that it
+     * can be replayed, and a live viewer is served by `emit` instead.
+     */
+    async function receive(params) {
+        if (!live)
+            return;
+        const update = field(params, "update");
+        const kind = String(field(update, "sessionUpdate") ?? "");
+        if (kind === "agent_message_chunk") {
+            const chunk = String(field(field(update, "content"), "text") ?? "");
+            text += chunk;
+            context.emit({ type: "text.delta", text: chunk });
+            return;
+        }
+        if (kind === "agent_thought_chunk") {
+            context.emit({ type: "reasoning.delta", text: String(field(field(update, "content"), "text") ?? "") });
+            return;
+        }
+        if (kind === "usage_update") {
+            // Dropped deliberately. This protocol reports a spend figure and no token
+            // counts, and `Usage` carries tokens and no money, so there is nothing
+            // here that could be recorded without inventing it. An agent behind this
+            // harness is unaccounted for, and the capability table says so.
+            return;
+        }
+        if (kind !== "tool_call" && kind !== "tool_call_update")
+            return;
+        const callId = String(field(update, "toolCallId") ?? "");
+        if (!callId)
+            return;
+        const existing = calls.get(callId) ?? { name: "", input: null };
+        const name = nameOf(update);
+        const raw = field(update, "rawInput");
+        calls.set(callId, {
+            name: name || existing.name || "tool",
+            input: raw === undefined || raw === null ? existing.input : raw,
+            ...(existing.output === undefined ? {} : { output: existing.output }),
+        });
+        context.emit({ type: "tool.progress", callId, data: update ?? null });
+        const status = String(field(update, "status") ?? "");
+        if (status !== "completed" && status !== "failed")
+            return;
+        const call = calls.get(callId);
+        calls.delete(callId);
+        const result = resultOf(update, status === "failed");
+        await context.commit(assistantAsking(call, callId).concat({ type: "tool.started", runId: context.runId, callId }, { type: "tool.finished", runId: context.runId, callId, result }));
+    }
+    function assistantAsking(call, callId) {
+        const asked = { callId, name: call.name, arguments: JSON.stringify(call.input ?? {}) };
+        const said = text;
+        text = "";
+        return [{ type: "assistant", runId: context.runId, content: said, calls: [asked] }];
+    }
+    async function flushText() {
+        if (!text)
+            return;
+        const said = text;
+        text = "";
+        await context.commit([{ type: "assistant", runId: context.runId, content: said }]);
+    }
+    function outcome(stopReason) {
+        if (stopReason === "cancelled")
+            return { status: "cancelled" };
+        if (stopReason === "max_tokens" || stopReason === "max_turn_requests") {
+            return {
+                status: "failed",
+                error: { code: "limit", message: `${options.id} stopped: ${stopReason}.`, retryable: false },
+            };
+        }
+        return { status: "completed", output: lastSaid(context) };
+    }
+    // ---- Serving the agent's requests from the sandbox ----------------------
+    function serveFiles() {
+        rpc.on("fs/read_text_file", async (params) => {
+            const read = await sandbox.readFile({ path: String(field(params, "path") ?? "") });
+            return read.ok ? ok({ content: read.value }) : read;
+        });
+        rpc.on("fs/write_text_file", async (params) => {
+            const written = await sandbox.writeFile({
+                path: String(field(params, "path") ?? ""),
+                content: String(field(params, "content") ?? ""),
+            });
+            return written.ok ? ok(null) : written;
+        });
+    }
+    /**
+     * The protocol's terminal, served from the sandbox.
+     *
+     * Worth knowing before relying on it: an agent uses this only if it chooses
+     * to, and the one measured here does not. `@agentclientprotocol/claude-agent-acp`
+     * calls exactly four client methods — `fs/read_text_file`,
+     * `fs/write_text_file`, `session/request_permission`, `session/update` — and
+     * emits a terminal block for display while running the command itself. So
+     * these handlers are correct and, for that agent, never reached. Containment
+     * comes from starting the agent inside the sandbox, not from serving this.
+     */
+    function serveTerminals() {
+        rpc.on("terminal/create", async (params) => {
+            const argv = ["/bin/sh", "-lc", [field(params, "command"), ...(asArray(field(params, "args")))].filter(Boolean).join(" ")];
+            const cwd = field(params, "cwd");
+            const spawned = await sandbox.spawn({
+                command: argv,
+                ...(typeof cwd === "string" ? { cwd } : {}),
+            });
+            if (!spawned.ok)
+                return spawned;
+            const id = `terminal-${++terminalCount}`;
+            let collected = "";
+            const drain = async (stream) => {
+                const decoder = new TextDecoder();
+                for await (const chunk of stream) {
+                    collected += decoder.decode(chunk, { stream: true });
+                }
+            };
+            void drain(spawned.value.stdout);
+            void drain(spawned.value.stderr);
+            terminals.set(id, { process: spawned.value, output: () => collected, exit: spawned.value.exited });
+            return ok({ terminalId: id });
+        });
+        rpc.on("terminal/output", async (params) => {
+            const terminal = terminals.get(String(field(params, "terminalId") ?? ""));
+            if (!terminal)
+                return err({ code: "not-found", message: "No such terminal.", retryable: false });
+            const finished = await Promise.race([terminal.exit, Promise.resolve(undefined)]);
+            return ok({
+                output: terminal.output(),
+                truncated: false,
+                ...(finished === undefined ? {} : { exitStatus: { exitCode: finished, signal: null } }),
+            });
+        });
+        rpc.on("terminal/wait_for_exit", async (params) => {
+            const terminal = terminals.get(String(field(params, "terminalId") ?? ""));
+            if (!terminal)
+                return err({ code: "not-found", message: "No such terminal.", retryable: false });
+            return ok({ exitCode: await terminal.exit, signal: null });
+        });
+        rpc.on("terminal/kill", async (params) => {
+            terminals.get(String(field(params, "terminalId") ?? ""))?.process.kill();
+            return ok(null);
+        });
+        rpc.on("terminal/release", async (params) => {
+            const id = String(field(params, "terminalId") ?? "");
+            terminals.get(id)?.process.kill();
+            terminals.delete(id);
+            return ok(null);
+        });
+    }
+    /**
+     * The agent's own tools, one call at a time, through the application's rule.
+     *
+     * The agent is blocked on this reply, so the answer is yes or no and nothing
+     * else. That constraint is why the permission model has two outcomes rather
+     * than three: a rule that could park a call would be honourable in our own
+     * loop and unhonourable here, which is the ragged surface the two-outcome
+     * shape avoids.
+     */
+    function servePermission() {
+        rpc.on("session/request_permission", async (params) => {
+            const call = field(params, "toolCall");
+            const callId = String(field(call, "toolCallId") ?? "");
+            const options_ = asArray(field(params, "options"));
+            const pick = (...kinds) => {
+                for (const kind of kinds) {
+                    const found = options_.find((option) => String(field(option, "kind") ?? "") === kind);
+                    if (found)
+                        return String(field(found, "optionId") ?? "");
+                }
+                return undefined;
+            };
+            const selected = (optionId) => optionId === undefined
+                ? ok({ outcome: { outcome: "cancelled" } })
+                : ok({ outcome: { outcome: "selected", optionId } });
+            if (!options.decide)
+                return selected(pick("allow_once", "allow_always"));
+            const spec = {
+                name: nameOf(call) || "tool",
+                description: String(field(call, "title") ?? ""),
+                parameters: {},
+            };
+            const decided = await options.decide({
+                tool: spec,
+                input: (field(call, "rawInput") ?? {}),
+                sessionId: context.sessionId,
+                runId: context.runId,
+                callId,
+            });
+            if (decided.action === "execute")
+                return selected(pick("allow_once", "allow_always"));
+            return selected(pick("reject_once", "reject_always"));
+        });
+    }
+}
+/**
+ * What the agent published, from either shape the protocol has used.
+ *
+ * `configOptions` is current. `models` is what the same fact was called before
+ * it was generalised, and is normalised into an option categorised "model" so
+ * a caller never has to know which version answered.
+ */
+function readOptions(opened) {
+    const found = [];
+    for (const raw of asArray(field(opened, "configOptions"))) {
+        const id = field(raw, "id");
+        if (typeof id !== "string")
+            continue;
+        const choices = asArray(field(raw, "options")).flatMap((choice) => {
+            const value = field(choice, "id") ?? field(choice, "value");
+            return typeof value === "string"
+                ? [{ id: value, name: String(field(choice, "name") ?? value) }]
+                : [];
+        });
+        const current = field(raw, "currentValue");
+        found.push({
+            id,
+            name: String(field(raw, "name") ?? id),
+            category: String(field(raw, "category") ?? ""),
+            ...(typeof field(raw, "description") === "string" ? { description: String(field(raw, "description")) } : {}),
+            current: typeof current === "boolean" ? current : String(current ?? ""),
+            ...(choices.length ? { choices } : {}),
+        });
+    }
+    const models = field(opened, "models");
+    const available = asArray(field(models, "availableModels"));
+    if (available.length && !found.some((option) => option.category === "model")) {
+        found.push({
+            id: "model",
+            name: "Model",
+            category: "model",
+            current: String(field(models, "currentModelId") ?? ""),
+            choices: available.flatMap((model) => {
+                const id = field(model, "modelId");
+                return typeof id === "string" ? [{ id, name: String(field(model, "name") ?? id) }] : [];
+            }),
+        });
+        // An agent that published its models this way answers `session/set_model`
+        // and has never heard of `session/set_config_option`. Both shapes carry
+        // choices, so the option alone cannot say which method it takes: where it
+        // was read is the only thing that distinguishes them.
+        return { options: found, legacyModel: "model" };
+    }
+    return { options: found, legacyModel: null };
+}
+// ---- Reading the protocol's loosely-typed payloads --------------------------
+const field = (value, key) => value !== null && typeof value === "object" && !Array.isArray(value)
+    ? value[key]
+    : undefined;
+const asArray = (value) => (Array.isArray(value) ? value : []);
+const truthy = (value) => value === true;
+/** The agent's real tool name when it publishes one, else the protocol's coarse kind. */
+const nameOf = (update) => {
+    const meta = field(update, "_meta");
+    for (const vendor of Object.values((meta ?? {}))) {
+        const named = field(vendor, "toolName");
+        if (typeof named === "string")
+            return named;
+    }
+    return String(field(update, "kind") ?? "");
+};
+function resultOf(update, failed) {
+    const raw = field(update, "rawOutput");
+    const blocks = asArray(field(update, "content"))
+        .map((entry) => field(field(entry, "content"), "text"))
+        .filter((value) => typeof value === "string");
+    const content = blocks.length ? blocks.join("\n") : typeof raw === "string" ? raw : JSON.stringify(raw ?? null);
+    return {
+        content,
+        ...(raw === undefined ? {} : { details: raw }),
+        ...(failed ? { isError: true } : {}),
+    };
+}
+/** This activation's input: the entries `runAgent` committed before calling us. */
+const inputFor = (context) => context.entries()
+    .filter((entry) => entry.type === "run.started" && entry.runId === context.runId)
+    .map((entry) => textOf(entry.input))
+    .join("\n\n");
+/** The agent's final word, read back from the log it was just committed to. */
+function lastSaid(context) {
+    const entries = context.entries();
+    for (let index = entries.length - 1; index >= 0; index -= 1) {
+        const entry = entries[index];
+        if (entry.type === "assistant" && entry.runId === context.runId)
+            return textOf(entry.content);
+    }
+    return "";
+}
+//# sourceMappingURL=index.js.map

package/dist/harness/adapters/acp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/harness/adapters/acp/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Harness, HarnessContext, HarnessResult } from \"../../harness.js\";\nimport type { Entry, ToolCall, ToolResult } from \"../../../session/entry.js\";\nimport type { Sandbox, SandboxProcess } from \"../../../sandbox/sandbox.js\";\nimport type { Decide, ToolSpec } from \"../../../tools/tool.js\";\nimport type { JsonValue } from \"../../../json.js\";\nimport { textOf } from \"../../../content.js\";\nimport { err, ok, type Failure } from \"../../../result.js\";\nimport { createRpc, type Rpc } from \"./rpc.js\";\n\n/** An agent process: argv and the environment that selects its provider and model. */\nexport interface AcpAgent {\n  command: readonly string[];\n  env?: Readonly<Record<string, string>>;\n}\n\n/** A tool server the foreign agent connects to itself. This is how it gets ours. */\nexport interface AcpMcpServer {\n  name: string;\n  command: string;\n  args?: readonly string[];\n  env?: readonly { name: string; value: string }[];\n}\n\n/**\n * Something the agent lets a client change about a session.\n *\n * The protocol used to name models specifically; it now publishes a list of\n * options and gives each a category, so a client can tell a model selector\n * from a reasoning level without knowing the agent. We report them rather than\n * interpret them: the ids and the choices are the agent's, and a service that\n * mapped them onto its own three levels would be guessing at another product's\n * vocabulary.\n */\nexport interface AcpConfigOption {\n  id: string;\n  name: string;\n  /** \"model\", \"thought_level\", \"mode\", \"model_config\", or whatever the agent says. */\n  category: string;\n  description?: string;\n  current: string | boolean;\n  /** Absent for a boolean option. */\n  choices?: readonly { id: string; name: string }[];\n}\n\nexport interface AcpHarnessOptions {\n  /** Names this harness in the log and in the UI. */\n  id: string;\n  agent: AcpAgent;\n  /**\n   * Where the agent runs. Not merely where its file requests are served: the\n   * process itself is started here, because a coding agent runs its own shell\n   * and only delegates the calls it chooses to.\n   */\n  sandbox: Sandbox;\n  mcpServers?: readonly AcpMcpServer[];\n  /**\n   * What to set before prompting, by option id. Applied only where the agent\n   * published that option and, for a select, that value — otherwise the run\n   * fails naming what it does offer, rather than quietly running something else.\n   */\n  select?: Readonly<Record<string, string | boolean>>;\n  /**\n   * Requested model, matched against whichever option the agent categorised as\n   * its model selector. A convenience over `select` for the one option every\n   * agent has, and it fails the same way.\n   */\n  model?: string;\n  /** What the agent published. The caller persists it so a session can offer the agent's own choices. */\n  onConfig?(options: readonly AcpConfigOption[]): void;\n  /** Agent-defined mode. Choosing one that asks before acting is what routes its own tools through `decide`. */\n  mode?: string;\n  /**\n   * Applied to the agent's own tools, per call, before they run.\n   *\n   * The protocol carries a title and the raw arguments for these, but no\n   * schema, so `spec.parameters` is `{}` and `spec.description` is the agent's\n   * own title for the call. That is what we actually have.\n   */\n  decide?: Decide;\n  /** The agent's previous session id, so this activation continues its context. */\n  resume?: string;\n  /** Called with the agent's session id, so the caller can persist it for the next activation. */\n  onSession?(sessionId: string): void;\n}\n\nconst PROTOCOL_VERSION = 1;\n\n/**\n * Runs a foreign coding agent over the Agent Client Protocol.\n *\n * The adapter is not a remote control. It does three things the raw protocol\n * does not: it normalises whatever the agent did into this package's entries,\n * so one durable log describes a Claude Code turn and a native-loop turn\n * identically; it puts the agent's own tools under the application's decision\n * function, one call at a time; and it hands the agent tool servers of ours, so\n * agents can dispatch and message each other.\n */\nexport function createAcpHarness(options: AcpHarnessOptions): Harness {\n  return {\n    id: options.id,\n    // Its tools are its own. We gate them and we record them; we do not claim\n    // to have validated arguments we never had a schema for.\n    toolUse: \"harness\",\n    // The agent owns its context. Our entries describe what it did, and cannot\n    // by themselves put it back mid-turn.\n    recovery: \"none\",\n    run: (context) => runTurn(options, context),\n  };\n}\n\nasync function runTurn(options: AcpHarnessOptions, context: HarnessContext): Promise<HarnessResult> {\n  const started = await options.sandbox.spawn({\n    command: options.agent.command,\n    cwd: options.sandbox.root,\n    ...(options.agent.env ? { env: options.agent.env } : {}),\n  });\n  if (!started.ok) return { status: \"failed\", error: started.error };\n\n  const rpc = createRpc(started.value);\n  const turn = createTurn(options, context, rpc);\n  try {\n    return await turn.run();\n  } finally {\n    rpc.close();\n  }\n}\n\n/** Cumulative state for one activation. Discarded with the process that produced it. */\nfunction createTurn(options: AcpHarnessOptions, context: HarnessContext, rpc: Rpc) {\n  const sandbox = options.sandbox;\n  const terminals = new Map<string, { process: SandboxProcess; output: () => string; exit: Promise<number> }>();\n  const calls = new Map<string, { name: string; input: JsonValue; output?: JsonValue; failed?: boolean }>();\n  let text = \"\";\n  let sessionId = \"\";\n  let terminalCount = 0;\n  /**\n   * Whether an update describes this activation, or the last one.\n   *\n   * `session/load` replays the whole conversation back as `session/update`\n   * notifications — measured against `codex-acp`, which answers a load with the\n   * user message and the agent message of every turn before it. Those are the\n   * same words this log already committed when they were first said, so\n   * treating them as output would append the entire history again on every\n   * resumed activation, and prepend it to whatever the new turn actually says.\n   * Nothing before the prompt belongs to the run the prompt starts.\n   */\n  let live = false;\n\n  return { run };\n\n  async function run(): Promise<HarnessResult> {\n    serveFiles();\n    serveTerminals();\n    servePermission();\n    rpc.onNotify(\"session/update\", (params) => { void receive(params); });\n\n    const ready = await rpc.request(\"initialize\", {\n      protocolVersion: PROTOCOL_VERSION,\n      clientCapabilities: { fs: { readTextFile: true, writeTextFile: true }, terminal: true },\n      clientInfo: { name: \"aglib\", version: \"0\" },\n    });\n    if (!ready.ok) return { status: \"failed\", error: ready.error };\n    const capabilities = field(ready.value, \"agentCapabilities\");\n\n    const opened = await openSession(truthy(field(capabilities, \"loadSession\")));\n    if (!opened.ok) return { status: \"failed\", error: opened.error };\n    sessionId = opened.value;\n    options.onSession?.(sessionId);\n\n    const configured = await configure(opened.value, opened.opened ?? undefined);\n    if (!configured.ok) return { status: \"failed\", error: configured.error };\n\n    const cancel = () => rpc.notify(\"session/cancel\", { sessionId });\n    context.signal.addEventListener(\"abort\", cancel, { once: true });\n\n    // Anything the agent replayed while opening has already been dispatched:\n    // one stdio stream, read in order, so a load's echo is behind us here.\n    live = true;\n    const answered = await rpc.request(\"session/prompt\", {\n      sessionId,\n      prompt: [{ type: \"text\", text: inputFor(context) }],\n    });\n    context.signal.removeEventListener(\"abort\", cancel);\n    for (const terminal of terminals.values()) terminal.process.kill();\n\n    if (!answered.ok) return { status: \"failed\", error: answered.error };\n    await flushText();\n    return outcome(String(field(answered.value, \"stopReason\") ?? \"end_turn\"));\n  }\n\n  async function openSession(canLoad: boolean) {\n    const parameters = {\n      cwd: sandbox.root,\n      mcpServers: (options.mcpServers ?? []).map((server) => ({\n        type: \"stdio\", name: server.name, command: server.command,\n        args: [...(server.args ?? [])], env: [...(server.env ?? [])],\n      })),\n    } as unknown as JsonValue;\n\n    // The whole answer is carried out, not one field of it: what an agent\n    // publishes about a session has changed shape once already.\n    if (options.resume && canLoad) {\n      const loaded = await rpc.request(\"session/load\", { ...(parameters as object), sessionId: options.resume } as JsonValue);\n      if (loaded.ok) return { ...ok(options.resume), opened: loaded.value };\n    }\n    const created = await rpc.request(\"session/new\", parameters);\n    if (!created.ok) return { ...created, opened: null };\n    const id = field(created.value, \"sessionId\");\n    if (typeof id !== \"string\") {\n      return { ...err<Failure>({ code: \"protocol\", message: \"The agent opened no session.\", retryable: false }), opened: null };\n    }\n    return { ...ok(id), opened: created.value };\n  }\n\n  /**\n   * Read what the agent lets us change, report it, and set what was asked for.\n   *\n   * Two shapes, because the protocol changed one into the other: `models` used\n   * to be its own field on the session, and is now one entry in `configOptions`\n   * carrying `category: \"model\"`. Both are read, so an agent on either version\n   * is understood, and neither is required.\n   *\n   * A resumed session reads this from the `session/load` answer, and an agent\n   * that answers a load without republishing is one whose options we do not\n   * currently know. Setting one from what a previous session said would be\n   * asserting a capability this connection never claimed — so a request for an\n   * option that is not published fails, naming what is. Measured against\n   * `claude-agent-acp`, which does republish on load.\n   */\n  async function configure(id: string, opened: JsonValue | undefined) {\n    const { options: published, legacyModel } = readOptions(opened);\n    if (published.length) options.onConfig?.(published);\n\n    if (options.mode) {\n      const set = await rpc.request(\"session/set_mode\", { sessionId: id, modeId: options.mode });\n      if (!set.ok) return set;\n    }\n\n    const wanted: Record<string, string | boolean> = { ...options.select };\n    if (options.model) {\n      const selector = published.find((option) => option.category === \"model\");\n      if (!selector) {\n        return err<Failure>({\n          code: \"unsupported\",\n          message: `${options.id} publishes no model selector, so '${options.model}' cannot be chosen over the protocol. Point it at a model through its environment instead.`,\n          retryable: false,\n        });\n      }\n      wanted[selector.id] = options.model;\n    }\n\n    for (const [option, value] of Object.entries(wanted)) {\n      const published_ = published.find((candidate) => candidate.id === option);\n      if (!published_) {\n        return err<Failure>({\n          code: \"unsupported\",\n          message: `${options.id} offers no option '${option}'. It offers: ${published.map((o) => o.id).join(\", \") || \"none\"}.`,\n          retryable: false,\n        });\n      }\n      if (published_.current === value) continue;\n      if (published_.choices && !published_.choices.some((choice) => choice.id === value)) {\n        return err<Failure>({\n          code: \"unsupported\",\n          message: `${options.id} does not offer '${String(value)}' for ${published_.name}. It offers: ${published_.choices.map((c) => c.id).join(\", \")}.`,\n          retryable: false,\n        });\n      }\n      const legacy = published_.id === legacyModel;\n      const set = await rpc.request(\n        legacy ? \"session/set_model\" : \"session/set_config_option\",\n        legacy\n          ? { sessionId: id, modelId: value }\n          : { sessionId: id, configId: published_.id, value, ...(typeof value === \"boolean\" ? { type: \"boolean\" } : {}) },\n      );\n      if (!set.ok) return set;\n    }\n    return ok(undefined);\n  }\n\n  // ---- Normalising what the agent did into entries -------------------------\n\n  /**\n   * A tool call becomes entries when it finishes, in one commit: the assistant\n   * turn that asked for it, the start, and the result. Committing the pieces as\n   * they arrive would leave half-states in a log whose whole purpose is that it\n   * can be replayed, and a live viewer is served by `emit` instead.\n   */\n  async function receive(params: JsonValue): Promise<void> {\n    if (!live) return;\n    const update = field(params, \"update\");\n    const kind = String(field(update, \"sessionUpdate\") ?? \"\");\n\n    if (kind === \"agent_message_chunk\") {\n      const chunk = String(field(field(update, \"content\"), \"text\") ?? \"\");\n      text += chunk;\n      context.emit({ type: \"text.delta\", text: chunk });\n      return;\n    }\n    if (kind === \"agent_thought_chunk\") {\n      context.emit({ type: \"reasoning.delta\", text: String(field(field(update, \"content\"), \"text\") ?? \"\") });\n      return;\n    }\n    if (kind === \"usage_update\") {\n      // Dropped deliberately. This protocol reports a spend figure and no token\n      // counts, and `Usage` carries tokens and no money, so there is nothing\n      // here that could be recorded without inventing it. An agent behind this\n      // harness is unaccounted for, and the capability table says so.\n      return;\n    }\n    if (kind !== \"tool_call\" && kind !== \"tool_call_update\") return;\n\n    const callId = String(field(update, \"toolCallId\") ?? \"\");\n    if (!callId) return;\n    const existing = calls.get(callId) ?? { name: \"\", input: null };\n    const name = nameOf(update);\n    const raw = field(update, \"rawInput\");\n    calls.set(callId, {\n      name: name || existing.name || \"tool\",\n      input: raw === undefined || raw === null ? existing.input : raw,\n      ...(existing.output === undefined ? {} : { output: existing.output }),\n    });\n    context.emit({ type: \"tool.progress\", callId, data: update ?? null });\n\n    const status = String(field(update, \"status\") ?? \"\");\n    if (status !== \"completed\" && status !== \"failed\") return;\n\n    const call = calls.get(callId)!;\n    calls.delete(callId);\n    const result = resultOf(update, status === \"failed\");\n    await context.commit(assistantAsking(call, callId).concat(\n      { type: \"tool.started\", runId: context.runId, callId },\n      { type: \"tool.finished\", runId: context.runId, callId, result },\n    ));\n  }\n\n  function assistantAsking(call: { name: string; input: JsonValue }, callId: string): Entry[] {\n    const asked: ToolCall = { callId, name: call.name, arguments: JSON.stringify(call.input ?? {}) };\n    const said = text;\n    text = \"\";\n    return [{ type: \"assistant\", runId: context.runId, content: said, calls: [asked] }];\n  }\n\n  async function flushText(): Promise<void> {\n    if (!text) return;\n    const said = text;\n    text = \"\";\n    await context.commit([{ type: \"assistant\", runId: context.runId, content: said }]);\n  }\n\n  function outcome(stopReason: string): HarnessResult {\n    if (stopReason === \"cancelled\") return { status: \"cancelled\" };\n    if (stopReason === \"max_tokens\" || stopReason === \"max_turn_requests\") {\n      return {\n        status: \"failed\",\n        error: { code: \"limit\", message: `${options.id} stopped: ${stopReason}.`, retryable: false },\n      };\n    }\n    return { status: \"completed\", output: lastSaid(context) };\n  }\n\n  // ---- Serving the agent's requests from the sandbox ----------------------\n\n  function serveFiles(): void {\n    rpc.on(\"fs/read_text_file\", async (params) => {\n      const read = await sandbox.readFile({ path: String(field(params, \"path\") ?? \"\") });\n      return read.ok ? ok({ content: read.value }) : read;\n    });\n    rpc.on(\"fs/write_text_file\", async (params) => {\n      const written = await sandbox.writeFile({\n        path: String(field(params, \"path\") ?? \"\"),\n        content: String(field(params, \"content\") ?? \"\"),\n      });\n      return written.ok ? ok(null) : written;\n    });\n  }\n\n  /**\n   * The protocol's terminal, served from the sandbox.\n   *\n   * Worth knowing before relying on it: an agent uses this only if it chooses\n   * to, and the one measured here does not. `@agentclientprotocol/claude-agent-acp`\n   * calls exactly four client methods — `fs/read_text_file`,\n   * `fs/write_text_file`, `session/request_permission`, `session/update` — and\n   * emits a terminal block for display while running the command itself. So\n   * these handlers are correct and, for that agent, never reached. Containment\n   * comes from starting the agent inside the sandbox, not from serving this.\n   */\n  function serveTerminals(): void {\n    rpc.on(\"terminal/create\", async (params) => {\n      const argv = [\"/bin/sh\", \"-lc\", [field(params, \"command\"), ...(asArray(field(params, \"args\")))].filter(Boolean).join(\" \")];\n      const cwd = field(params, \"cwd\");\n      const spawned = await sandbox.spawn({\n        command: argv,\n        ...(typeof cwd === \"string\" ? { cwd } : {}),\n      });\n      if (!spawned.ok) return spawned;\n      const id = `terminal-${++terminalCount}`;\n      let collected = \"\";\n      const drain = async (stream: ReadableStream<Uint8Array>) => {\n        const decoder = new TextDecoder();\n        for await (const chunk of stream as unknown as AsyncIterable<Uint8Array>) {\n          collected += decoder.decode(chunk, { stream: true });\n        }\n      };\n      void drain(spawned.value.stdout);\n      void drain(spawned.value.stderr);\n      terminals.set(id, { process: spawned.value, output: () => collected, exit: spawned.value.exited });\n      return ok({ terminalId: id });\n    });\n\n    rpc.on(\"terminal/output\", async (params) => {\n      const terminal = terminals.get(String(field(params, \"terminalId\") ?? \"\"));\n      if (!terminal) return err<Failure>({ code: \"not-found\", message: \"No such terminal.\", retryable: false });\n      const finished = await Promise.race([terminal.exit, Promise.resolve(undefined)]);\n      return ok({\n        output: terminal.output(),\n        truncated: false,\n        ...(finished === undefined ? {} : { exitStatus: { exitCode: finished, signal: null } }),\n      });\n    });\n\n    rpc.on(\"terminal/wait_for_exit\", async (params) => {\n      const terminal = terminals.get(String(field(params, \"terminalId\") ?? \"\"));\n      if (!terminal) return err<Failure>({ code: \"not-found\", message: \"No such terminal.\", retryable: false });\n      return ok({ exitCode: await terminal.exit, signal: null });\n    });\n\n    rpc.on(\"terminal/kill\", async (params) => {\n      terminals.get(String(field(params, \"terminalId\") ?? \"\"))?.process.kill();\n      return ok(null);\n    });\n\n    rpc.on(\"terminal/release\", async (params) => {\n      const id = String(field(params, \"terminalId\") ?? \"\");\n      terminals.get(id)?.process.kill();\n      terminals.delete(id);\n      return ok(null);\n    });\n  }\n\n  /**\n   * The agent's own tools, one call at a time, through the application's rule.\n   *\n   * The agent is blocked on this reply, so the answer is yes or no and nothing\n   * else. That constraint is why the permission model has two outcomes rather\n   * than three: a rule that could park a call would be honourable in our own\n   * loop and unhonourable here, which is the ragged surface the two-outcome\n   * shape avoids.\n   */\n  function servePermission(): void {\n    rpc.on(\"session/request_permission\", async (params) => {\n      const call = field(params, \"toolCall\");\n      const callId = String(field(call, \"toolCallId\") ?? \"\");\n      const options_ = asArray(field(params, \"options\"));\n      const pick = (...kinds: string[]) => {\n        for (const kind of kinds) {\n          const found = options_.find((option) => String(field(option, \"kind\") ?? \"\") === kind);\n          if (found) return String(field(found, \"optionId\") ?? \"\");\n        }\n        return undefined;\n      };\n      const selected = (optionId: string | undefined) =>\n        optionId === undefined\n          ? ok({ outcome: { outcome: \"cancelled\" } })\n          : ok({ outcome: { outcome: \"selected\", optionId } });\n\n      if (!options.decide) return selected(pick(\"allow_once\", \"allow_always\"));\n\n      const spec: ToolSpec = {\n        name: nameOf(call) || \"tool\",\n        description: String(field(call, \"title\") ?? \"\"),\n        parameters: {},\n      };\n      const decided = await options.decide({\n        tool: spec,\n        input: (field(call, \"rawInput\") ?? {}) as JsonValue,\n        sessionId: context.sessionId,\n        runId: context.runId,\n        callId,\n      });\n      if (decided.action === \"execute\") return selected(pick(\"allow_once\", \"allow_always\"));\n      return selected(pick(\"reject_once\", \"reject_always\"));\n    });\n  }\n}\n\n/**\n * What the agent published, from either shape the protocol has used.\n *\n * `configOptions` is current. `models` is what the same fact was called before\n * it was generalised, and is normalised into an option categorised \"model\" so\n * a caller never has to know which version answered.\n */\nfunction readOptions(\n  opened: JsonValue | undefined,\n): { options: readonly AcpConfigOption[]; legacyModel: string | null } {\n  const found: AcpConfigOption[] = [];\n\n  for (const raw of asArray(field(opened, \"configOptions\"))) {\n    const id = field(raw, \"id\");\n    if (typeof id !== \"string\") continue;\n    const choices = asArray(field(raw, \"options\")).flatMap((choice) => {\n      const value = field(choice, \"id\") ?? field(choice, \"value\");\n      return typeof value === \"string\"\n        ? [{ id: value, name: String(field(choice, \"name\") ?? value) }]\n        : [];\n    });\n    const current = field(raw, \"currentValue\");\n    found.push({\n      id,\n      name: String(field(raw, \"name\") ?? id),\n      category: String(field(raw, \"category\") ?? \"\"),\n      ...(typeof field(raw, \"description\") === \"string\" ? { description: String(field(raw, \"description\")) } : {}),\n      current: typeof current === \"boolean\" ? current : String(current ?? \"\"),\n      ...(choices.length ? { choices } : {}),\n    });\n  }\n\n  const models = field(opened, \"models\");\n  const available = asArray(field(models, \"availableModels\"));\n  if (available.length && !found.some((option) => option.category === \"model\")) {\n    found.push({\n      id: \"model\",\n      name: \"Model\",\n      category: \"model\",\n      current: String(field(models, \"currentModelId\") ?? \"\"),\n      choices: available.flatMap((model) => {\n        const id = field(model, \"modelId\");\n        return typeof id === \"string\" ? [{ id, name: String(field(model, \"name\") ?? id) }] : [];\n      }),\n    });\n    // An agent that published its models this way answers `session/set_model`\n    // and has never heard of `session/set_config_option`. Both shapes carry\n    // choices, so the option alone cannot say which method it takes: where it\n    // was read is the only thing that distinguishes them.\n    return { options: found, legacyModel: \"model\" };\n  }\n  return { options: found, legacyModel: null };\n}\n\n// ---- Reading the protocol's loosely-typed payloads --------------------------\n\nconst field = (value: JsonValue | undefined, key: string): JsonValue | undefined =>\n  value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, JsonValue>)[key]\n    : undefined;\n\nconst asArray = (value: JsonValue | undefined): JsonValue[] => (Array.isArray(value) ? value : []);\n\nconst truthy = (value: JsonValue | undefined): boolean => value === true;\n\n/** The agent's real tool name when it publishes one, else the protocol's coarse kind. */\nconst nameOf = (update: JsonValue | undefined): string => {\n  const meta = field(update, \"_meta\");\n  for (const vendor of Object.values((meta ?? {}) as Record<string, JsonValue>)) {\n    const named = field(vendor, \"toolName\");\n    if (typeof named === \"string\") return named;\n  }\n  return String(field(update, \"kind\") ?? \"\");\n};\n\nfunction resultOf(update: JsonValue | undefined, failed: boolean): ToolResult {\n  const raw = field(update, \"rawOutput\");\n  const blocks = asArray(field(update, \"content\"))\n    .map((entry) => field(field(entry, \"content\"), \"text\"))\n    .filter((value): value is string => typeof value === \"string\");\n  const content = blocks.length ? blocks.join(\"\\n\") : typeof raw === \"string\" ? raw : JSON.stringify(raw ?? null);\n  return {\n    content,\n    ...(raw === undefined ? {} : { details: raw }),\n    ...(failed ? { isError: true } : {}),\n  };\n}\n\n/** This activation's input: the entries `runAgent` committed before calling us. */\nconst inputFor = (context: HarnessContext): string =>\n  context.entries()\n    .filter((entry) => entry.type === \"run.started\" && entry.runId === context.runId)\n    .map((entry) => textOf((entry as Extract<Entry, { type: \"run.started\" }>).input))\n    .join(\"\\n\\n\");\n\n/** The agent's final word, read back from the log it was just committed to. */\nfunction lastSaid(context: HarnessContext): string {\n  const entries = context.entries();\n  for (let index = entries.length - 1; index >= 0; index -= 1) {\n    const entry = entries[index]!;\n    if (entry.type === \"assistant\" && entry.runId === context.runId) return textOf(entry.content);\n  }\n  return \"\";\n}\n\n"]}

package/dist/harness/adapters/acp/rpc.d.ts

@@ -0,0 +1,23 @@
+import type { SandboxProcess } from "../../../sandbox/sandbox.js";
+import type { JsonValue } from "../../../json.js";
+import { type Failure, type Result } from "../../../result.js";
+/** Handles a request the agent sends back to us. Rejecting is a JSON-RPC error. */
+export type RpcHandler = (params: JsonValue) => Promise<Result<JsonValue, Failure>>;
+export interface Rpc {
+    request(method: string, params: JsonValue): Promise<Result<JsonValue, Failure>>;
+    notify(method: string, params: JsonValue): void;
+    /** Register a method the agent may call on us. Unregistered methods answer "method not found". */
+    on(method: string, handler: RpcHandler): void;
+    onNotify(method: string, handler: (params: JsonValue) => void): void;
+    /** Resolves when the process ends; carries whatever it wrote to stderr. */
+    readonly closed: Promise<string>;
+    close(): void;
+}
+/**
+ * JSON-RPC 2.0 over one process's stdio, newline-delimited.
+ *
+ * Bidirectional on purpose: the protocol this speaks inverts control for files
+ * and terminals, so the agent is as much a caller as a callee and the two
+ * directions are the same machinery.
+ */
+export declare function createRpc(child: SandboxProcess): Rpc;