@namzu/sdk 27.1.0 → 29.0.0

package/dist/bridge/acp/filesystem.js

@@ -0,0 +1,30 @@
+/**
+ * Wrap `inner` so file reads and writes ask the client.
+ *
+ * Returns `inner` unchanged when there is no client filesystem, so a caller
+ * does not have to branch: the absence of the capability is the ordinary
+ * case and it should not produce a different code path at every call site.
+ */
+export function clientBackedSandbox(inner, client) {
+    if (!client)
+        return inner;
+    return new Proxy(inner, {
+        get(target, property, receiver) {
+            if (property === 'readFile') {
+                return async (path) => Buffer.from(await client.readTextFile(path), 'utf-8');
+            }
+            if (property === 'writeFile') {
+                return async (path, content) => {
+                    await client.writeTextFile(path, typeof content === 'string' ? content : content.toString('utf-8'));
+                };
+            }
+            // A Proxy rather than a spread, so a member added to `Sandbox` after
+            // this file was written still reaches the real sandbox. A spread
+            // copies what existed the day it was written and silently drops the
+            // rest — the same defect as a hand-listed re-export.
+            const value = Reflect.get(target, property, receiver);
+            return typeof value === 'function' ? value.bind(target) : value;
+        },
+    });
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/bridge/acp/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../../../src/bridge/acp/filesystem.ts"],"names":[],"mappings":"AA2BA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAClC,KAAc,EACd,MAAuC;IAEvC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IAEzB,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE;QACvB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ;YAC7B,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;gBAC7B,OAAO,KAAK,EAAE,IAAY,EAAmB,EAAE,CAC9C,MAAM,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;YACvD,CAAC;YACD,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAC9B,OAAO,KAAK,EAAE,IAAY,EAAE,OAAwB,EAAiB,EAAE;oBACtE,MAAM,MAAM,CAAC,aAAa,CACzB,IAAI,EACJ,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CACjE,CAAA;gBACF,CAAC,CAAA;YACF,CAAC;YACD,qEAAqE;YACrE,iEAAiE;YACjE,oEAAoE;YACpE,qDAAqD;YACrD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;YACrD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QAChE,CAAC;KACD,CAAC,CAAA;AACH,CAAC"}

package/dist/bridge/acp/index.d.ts

@@ -0,0 +1,8 @@
+export { ACPServer } from './server.js';
+export type { AcpAgentGateway, AcpServerOptions } from './server.js';
+export { clientBackedSandbox } from './filesystem.js';
+export type { AcpClientFilesystem } from './filesystem.js';
+export { ACP_DEFAULT_REJECTION, toResumeDecision } from './permission.js';
+export type { AcpPermissionAsker, AcpPermissionOutcome, AcpPermissionRequest, } from './permission.js';
+export { toAcpSessionUpdate, toAcpStopReason } from './update.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/bridge/acp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bridge/acp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACzE,YAAY,EACX,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,GACpB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}

package/dist/bridge/acp/index.js

@@ -0,0 +1,5 @@
+export { ACPServer } from './server.js';
+export { clientBackedSandbox } from './filesystem.js';
+export { ACP_DEFAULT_REJECTION, toResumeDecision } from './permission.js';
+export { toAcpSessionUpdate, toAcpStopReason } from './update.js';
+//# sourceMappingURL=index.js.map

package/dist/bridge/acp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/bridge/acp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAMzE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}

package/dist/bridge/acp/permission.d.ts

@@ -0,0 +1,51 @@
+import type { HITLResumeDecision, ToolCallSummary } from '../../types/hitl/index.js';
+/**
+ * A tool batch, on its way to a human sitting in front of an editor.
+ *
+ * The kernel's own `ToolCallSummary`, not a re-declared one: this is the
+ * shape the HITL path already produces, and a copy would be a second
+ * definition of "which calls am I being asked about" that can drift from the
+ * one the run actually parked on.
+ */
+export interface AcpPermissionRequest {
+    readonly sessionId: string;
+    readonly toolCalls: readonly ToolCallSummary[];
+}
+/**
+ * What the human said.
+ *
+ * Three outcomes, matching what a human can actually mean about a batch of
+ * calls: run it, run it and stop asking, or do not run it and here is why.
+ * `reject` carries optional feedback because a denial with a reason is the
+ * one a model can act on — "no, use the staging bucket" redirects a run,
+ * where a bare denial only ends it.
+ */
+export type AcpPermissionOutcome = {
+    readonly kind: 'approve';
+} | {
+    readonly kind: 'approve_all';
+} | {
+    readonly kind: 'reject';
+    readonly feedback?: string;
+};
+export type AcpPermissionAsker = (request: AcpPermissionRequest) => Promise<AcpPermissionOutcome>;
+/**
+ * The default a denial carries when the client sent none.
+ *
+ * Something rather than an empty string, because this text reaches the MODEL
+ * as a `reject_tools` feedback and an empty one reads as a tool that failed
+ * for no reason — the model retries it. Naming the human is what makes the
+ * next turn take a different path.
+ */
+export declare const ACP_DEFAULT_REJECTION = "The person operating this session declined these tool calls.";
+/**
+ * One outcome as a kernel decision.
+ *
+ * A table, in one place, because the mapping is where a permission bridge
+ * goes wrong: `approve_all` collapsing into `approve` means the latch never
+ * takes and the human is asked again on every batch; `reject` collapsing
+ * into `continue` means the denial is DISCARDED and the calls run anyway.
+ * Both are silent.
+ */
+export declare function toResumeDecision(outcome: AcpPermissionOutcome, grantKeys: readonly string[]): HITLResumeDecision;
+//# sourceMappingURL=permission.d.ts.map

package/dist/bridge/acp/permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.d.ts","sourceRoot":"","sources":["../../../src/bridge/acp/permission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEpF;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAA;CAC9C;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GAChC;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1D,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAA;AAEjG;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,iEAAiE,CAAA;AAEnG;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,SAAS,MAAM,EAAE,GAC1B,kBAAkB,CAiBpB"}

package/dist/bridge/acp/permission.js

@@ -0,0 +1,37 @@
+/**
+ * The default a denial carries when the client sent none.
+ *
+ * Something rather than an empty string, because this text reaches the MODEL
+ * as a `reject_tools` feedback and an empty one reads as a tool that failed
+ * for no reason — the model retries it. Naming the human is what makes the
+ * next turn take a different path.
+ */
+export const ACP_DEFAULT_REJECTION = 'The person operating this session declined these tool calls.';
+/**
+ * One outcome as a kernel decision.
+ *
+ * A table, in one place, because the mapping is where a permission bridge
+ * goes wrong: `approve_all` collapsing into `approve` means the latch never
+ * takes and the human is asked again on every batch; `reject` collapsing
+ * into `continue` means the denial is DISCARDED and the calls run anyway.
+ * Both are silent.
+ */
+export function toResumeDecision(outcome, grantKeys) {
+    switch (outcome.kind) {
+        case 'approve':
+            // No `remember`. Consent is not transferable: this batch was
+            // approved, and the next one is a new question.
+            return { action: 'approve_tools' };
+        case 'approve_all':
+            // The keys ARE the latch. `approve_tools` with nothing remembered is
+            // indistinguishable from a plain approve, which is exactly how an
+            // "approve all" that never takes gets shipped.
+            return { action: 'approve_tools', remember: grantKeys };
+        case 'reject':
+            return {
+                action: 'reject_tools',
+                feedback: outcome.feedback?.trim() || ACP_DEFAULT_REJECTION,
+            };
+    }
+}
+//# sourceMappingURL=permission.js.map

package/dist/bridge/acp/permission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.js","sourceRoot":"","sources":["../../../src/bridge/acp/permission.ts"],"names":[],"mappings":"AA+BA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,8DAA8D,CAAA;AAEnG;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC/B,OAA6B,EAC7B,SAA4B;IAE5B,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,SAAS;YACb,6DAA6D;YAC7D,gDAAgD;YAChD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,CAAA;QACnC,KAAK,aAAa;YACjB,qEAAqE;YACrE,kEAAkE;YAClE,+CAA+C;YAC/C,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAA;QACxD,KAAK,QAAQ;YACZ,OAAO;gBACN,MAAM,EAAE,cAAc;gBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,qBAAqB;aAC3D,CAAA;IACH,CAAC;AACF,CAAC"}

package/dist/bridge/acp/server.d.ts

@@ -0,0 +1,163 @@
+import type { HostCommandRegistry } from '../../registry/command/index.js';
+import type { ToolPresenter } from '../../registry/tool/presentation.js';
+import type { MCPTransport } from '../../types/connector/mcp.js';
+import type { RunEvent } from '../../types/run/events.js';
+import { type Logger } from '../../utils/logger.js';
+import type { AcpClientFilesystem } from './filesystem.js';
+import type { AcpPermissionAsker } from './permission.js';
+/**
+ * An agent-client protocol server over stdio.
+ *
+ * An editor extension or a CI orchestrator could previously do two things:
+ * shell out to the CLI and scrape its output, or embed the SDK in its own
+ * process. This is the third — a wire surface a peer written in any language
+ * can drive.
+ *
+ * **The precedent in this tree is a warning, and this change answers it.**
+ * `MCPServer` and `ServerStdioTransport` are both exported, and nothing
+ * anywhere constructs an `MCPServer`: a complete protocol server with no
+ * driver. So `packages/cli/src/commands/acp.ts` ships in the same change,
+ * and a subprocess test spawns the real binary — the wire half alone is not
+ * a deliverable.
+ *
+ * **stdout belongs to the protocol.** `ServerStdioTransport`'s own header
+ * says it and this is the surface that pays for it: one stray `console.log`
+ * anywhere in the process and a client reports malformed JSON with nothing
+ * naming the culprit. This repository's logger writes to stderr, and a test
+ * asserts zero non-JSON bytes on the child's stdout under info-level
+ * logging.
+ */
+/** What the bridge needs from the runtime, taken as an interface. */
+export interface AcpAgentGateway {
+    /**
+     * Run one prompt, streaming events, and resolve with the stop reason.
+     *
+     * Deliberately not `AgentManagerContract` itself. This bridge needs one
+     * verb, and a session front end holding the whole manager could cancel
+     * somebody else's task, spawn children, or drain a queue it does not own
+     * — none of which a peer asked for. The CLI passes an adapter over
+     * `sendMessage`/`cancel`.
+     */
+    prompt(request: {
+        readonly sessionId: string;
+        readonly prompt: string;
+        readonly cwd: string;
+        readonly onEvent: (event: RunEvent) => void;
+        readonly signal: AbortSignal;
+        /**
+         * Ask the human in front of the client about a tool batch.
+         *
+         * Handed to the gateway rather than installed by it, so the ONE place
+         * that knows how to reach the client is this bridge. A gateway that
+         * built its own asker would be a second path to the same human, and
+         * the one that forgot to latch `approve_all` would be it.
+         */
+        readonly ask: AcpPermissionAsker;
+        /**
+         * The client's buffers, when it declared the capability. `undefined`
+         * means disk — which is correct, and is what every non-editor peer
+         * wants.
+         */
+        readonly filesystem: AcpClientFilesystem | undefined;
+        /** Turns to resume from, oldest first. Empty for a fresh session. */
+        readonly history: readonly unknown[];
+    }): Promise<{
+        readonly stopReason?: string;
+    }>;
+    /**
+     * The turns a prior session left behind, for `session/load`.
+     *
+     * Optional: a gateway with no session store cannot resume, and saying so
+     * by not implementing this is better than returning an empty history that
+     * a client cannot tell apart from a session that really had no turns.
+     */
+    load?(sessionId: string): Promise<readonly unknown[]>;
+}
+export interface AcpServerOptions {
+    readonly transport: MCPTransport;
+    readonly gateway: AcpAgentGateway;
+    /**
+     * The command surface, verbatim from the registry.
+     *
+     * Passed as the registry rather than as a list so `describe()` is called
+     * per initialize: a host that registers a command after construction
+     * still has it appear, and this module has no place to hard-code one.
+     */
+    readonly commands: HostCommandRegistry;
+    readonly presenter: ToolPresenter;
+    readonly agentInfo: {
+        readonly name: string;
+        readonly version: string;
+    };
+    /** Injectable so a test does not depend on a random id. */
+    readonly newSessionId?: () => string;
+    readonly log?: Logger;
+}
+export declare class ACPServer {
+    private readonly options;
+    private readonly log;
+    private readonly sessions;
+    private initialized;
+    private clientCapabilities;
+    private sessionSeq;
+    /**
+     * The method table, authored INDEPENDENTLY of `ACP_METHODS`.
+     *
+     * Deriving it from the constant would make the drift test a tautology.
+     * Two hand-written sets compared in both directions is the only shape
+     * where "a handler nobody advertises" and "an advertised method with no
+     * handler" are both catchable.
+     */
+    private readonly handlers;
+    /** Requests this side has out to the client, keyed by their id. */
+    private readonly pending;
+    private requestSeq;
+    constructor(options: AcpServerOptions);
+    /** The method names this server answers. For the drift test. */
+    methodNames(): readonly string[];
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Ask the client something and wait for its answer.
+     *
+     * The direction this bridge did not have. A notification is fire and
+     * forget; a permission prompt is a question the run cannot proceed past,
+     * so it needs an id, a place to park the promise, and a `dispatch` that
+     * recognises a response frame.
+     */
+    private request;
+    private dispatch;
+    private respondError;
+    private send;
+    private notifyUpdate;
+    private onInitialize;
+    private onSessionNew;
+    /**
+     * Resume a session the store already has.
+     *
+     * The prior turns come from the gateway, never from this bridge: the
+     * history lives in whatever session store the host wired up, and a bridge
+     * that kept its own copy would answer a resume with the turns THIS process
+     * happened to see rather than the ones the session actually had.
+     */
+    private onSessionLoad;
+    private openSession;
+    private requireInitialized;
+    private requirePermissionCapability;
+    private onSessionPrompt;
+    private onSessionCancel;
+    /**
+     * Put a tool batch in front of the human, unless they already said yes to
+     * everything for this session.
+     */
+    private askPermission;
+    /**
+     * The client's buffers, when it declared the capability.
+     *
+     * `undefined` otherwise, and that is the ordinary case: a peer that is not
+     * an editor has no buffers, and the agent should read the disk.
+     */
+    private clientFilesystem;
+    private requireSession;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/bridge/acp/server.d.ts.map

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

package/dist/bridge/acp/server.js

@@ -0,0 +1,312 @@
+import { ACP_CLIENT_NOTIFICATIONS, ACP_CLIENT_REQUESTS, ACP_ERROR_CODES, ACP_FILESYSTEM_CAPABILITY, ACP_METHODS, ACP_PERMISSION_CAPABILITY, ACP_PROTOCOL_VERSION, } from '../../constants/acp/index.js';
+import { resolveLogger } from '../../utils/logger.js';
+import { toAcpSessionUpdate, toAcpStopReason } from './update.js';
+/** A JSON-RPC error this bridge answers with, rather than throwing out. */
+class AcpError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'AcpError';
+    }
+}
+export class ACPServer {
+    options;
+    log;
+    sessions = new Map();
+    initialized = false;
+    clientCapabilities = [];
+    sessionSeq = 0;
+    /**
+     * The method table, authored INDEPENDENTLY of `ACP_METHODS`.
+     *
+     * Deriving it from the constant would make the drift test a tautology.
+     * Two hand-written sets compared in both directions is the only shape
+     * where "a handler nobody advertises" and "an advertised method with no
+     * handler" are both catchable.
+     */
+    handlers = {
+        initialize: (p) => this.onInitialize(p),
+        'session/new': (p) => this.onSessionNew(p),
+        'session/prompt': (p) => this.onSessionPrompt(p),
+        'session/cancel': (p) => this.onSessionCancel(p),
+        'session/load': (p) => this.onSessionLoad(p),
+    };
+    /** Requests this side has out to the client, keyed by their id. */
+    pending = new Map();
+    requestSeq = 0;
+    constructor(options) {
+        this.options = options;
+        this.log = resolveLogger(options.log).child({ 'namzu.log.scope': 'bridge/acp' });
+    }
+    /** The method names this server answers. For the drift test. */
+    methodNames() {
+        return Object.keys(this.handlers).sort();
+    }
+    async start() {
+        this.options.transport.onMessage((message) => {
+            void this.dispatch(message);
+        });
+        await this.options.transport.connect();
+    }
+    async stop() {
+        for (const session of this.sessions.values())
+            session.controller.abort();
+        this.sessions.clear();
+        // Anything still waiting on the client is rejected rather than left
+        // pending: the transport is about to close, so no answer is coming, and
+        // a promise nobody will ever settle keeps whatever awaited it alive.
+        for (const waiting of this.pending.values()) {
+            waiting.reject(new Error('The client connection closed before it answered.'));
+        }
+        this.pending.clear();
+        await this.options.transport.close();
+    }
+    /**
+     * Ask the client something and wait for its answer.
+     *
+     * The direction this bridge did not have. A notification is fire and
+     * forget; a permission prompt is a question the run cannot proceed past,
+     * so it needs an id, a place to park the promise, and a `dispatch` that
+     * recognises a response frame.
+     */
+    request(method, params) {
+        this.requestSeq += 1;
+        const id = `agent_${this.requestSeq}`;
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve: resolve, reject });
+            void this.send({ jsonrpc: '2.0', id, method, params }).catch((err) => {
+                this.pending.delete(id);
+                reject(err instanceof Error ? err : new Error(String(err)));
+            });
+        });
+    }
+    async dispatch(message) {
+        if (!message.method) {
+            // A frame with no method is the client ANSWERING something this side
+            // asked. Before permission requests existed there was nothing out on
+            // the wire, so ignoring it was right; now dropping it would leave the
+            // asker waiting forever and the run parked with nobody coming.
+            if (message.id !== undefined && this.pending.has(message.id)) {
+                const waiting = this.pending.get(message.id);
+                this.pending.delete(message.id);
+                if (message.error) {
+                    waiting?.reject(new Error(message.error.message));
+                }
+                else {
+                    waiting?.resolve(message.result);
+                }
+            }
+            return;
+        }
+        const handler = this.handlers[message.method];
+        if (!handler) {
+            // Answered, and the CONNECTION STAYS OPEN. A client probing for a
+            // feature must not lose its session because this agent does not have
+            // it yet.
+            await this.respondError(message.id, ACP_ERROR_CODES.METHOD_NOT_FOUND, `Unknown method "${message.method}". This agent implements: ${this.methodNames().join(', ')}.`);
+            return;
+        }
+        try {
+            const result = await handler(message.params ?? {});
+            if (message.id !== undefined) {
+                await this.send({ jsonrpc: '2.0', id: message.id, result });
+            }
+        }
+        catch (err) {
+            const code = err instanceof AcpError ? err.code : ACP_ERROR_CODES.INTERNAL_ERROR;
+            await this.respondError(message.id, code, err instanceof Error ? err.message : String(err));
+        }
+    }
+    async respondError(id, code, message) {
+        // A notification (no id) that failed has nowhere to send an error, so
+        // it is logged instead of dropped silently — on stderr, where it does
+        // not corrupt the protocol stream.
+        if (id === undefined) {
+            this.log.warn('an acp notification failed', {
+                'namzu.acp.error_code': code,
+                'namzu.acp.error_message': message,
+            });
+            return;
+        }
+        await this.send({ jsonrpc: '2.0', id, error: { code, message } });
+    }
+    async send(message) {
+        try {
+            await this.options.transport.send(message);
+        }
+        catch (err) {
+            // The client hung up mid-write. Nothing to recover; a throw here
+            // would escape into whichever handler happened to be running.
+            this.log.warn('acp send failed', {
+                'namzu.acp.error_message': err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    async notifyUpdate(sessionId, update) {
+        await this.send({
+            jsonrpc: '2.0',
+            method: ACP_CLIENT_NOTIFICATIONS.SESSION_UPDATE,
+            params: { sessionId, update },
+        });
+    }
+    onInitialize(params) {
+        this.initialized = true;
+        this.clientCapabilities = params.capabilities ?? [];
+        return {
+            protocolVersion: ACP_PROTOCOL_VERSION,
+            agentInfo: this.options.agentInfo,
+            // From the registry, per call. A hard-coded list here would be a
+            // second definition of the command surface.
+            commands: this.options.commands.describe(),
+            requiredClientCapabilities: [ACP_PERMISSION_CAPABILITY],
+            // Advertised so a client author can see the option exists. Separate
+            // from `required` on purpose: a peer that is not an editor has no
+            // buffers, and demanding this of it would refuse a session that is
+            // perfectly able to run.
+            optionalClientCapabilities: [ACP_FILESYSTEM_CAPABILITY],
+        };
+    }
+    onSessionNew(params) {
+        this.requireInitialized();
+        this.requirePermissionCapability();
+        return { sessionId: this.openSession(params.cwd, []) };
+    }
+    /**
+     * Resume a session the store already has.
+     *
+     * The prior turns come from the gateway, never from this bridge: the
+     * history lives in whatever session store the host wired up, and a bridge
+     * that kept its own copy would answer a resume with the turns THIS process
+     * happened to see rather than the ones the session actually had.
+     */
+    async onSessionLoad(params) {
+        this.requireInitialized();
+        this.requirePermissionCapability();
+        if (!this.options.gateway.load) {
+            throw new AcpError(ACP_ERROR_CODES.METHOD_NOT_FOUND, 'This agent has no session store, so there is nothing to resume. Create a new session instead.');
+        }
+        const history = await this.options.gateway.load(params.sessionId);
+        // The SAME id, not a new one. A client that asked to resume `ses_x` and
+        // got `ses_y` back has to rewrite whatever it had keyed by the old one.
+        this.sessions.set(params.sessionId, {
+            cwd: params.cwd ?? process.cwd(),
+            controller: new AbortController(),
+            approveAll: false,
+            history,
+        });
+        return { sessionId: params.sessionId };
+    }
+    openSession(cwd, history) {
+        this.sessionSeq += 1;
+        const sessionId = this.options.newSessionId?.() ?? `acp_${this.sessionSeq}`;
+        this.sessions.set(sessionId, {
+            cwd: cwd ?? process.cwd(),
+            controller: new AbortController(),
+            // Fresh per session. See `Session.approveAll`.
+            approveAll: false,
+            history,
+        });
+        return sessionId;
+    }
+    requireInitialized() {
+        if (!this.initialized) {
+            throw new AcpError(ACP_ERROR_CODES.INVALID_REQUEST, `Call "${ACP_METHODS.INITIALIZE}" before creating a session.`);
+        }
+    }
+    requirePermissionCapability() {
+        if (!this.clientCapabilities.includes(ACP_PERMISSION_CAPABILITY)) {
+            // REFUSED, not auto-approved. A session that cannot ask a human
+            // anything and runs every tool regardless is not a degraded version
+            // of asking — it is the opposite of it, arrived at by omission.
+            throw new AcpError(ACP_ERROR_CODES.INVALID_REQUEST, `This agent will not create a session for a client that did not declare the "${ACP_PERMISSION_CAPABILITY}" capability. Tool calls need somewhere to ask, and a session without one would approve everything silently.`);
+        }
+    }
+    async onSessionPrompt(params) {
+        const session = this.requireSession(params.sessionId);
+        // A fresh controller per turn: the previous one may already be aborted
+        // by a cancel of the turn before, and reusing it would start this one
+        // already cancelled.
+        session.controller = new AbortController();
+        const outcome = await this.options.gateway.prompt({
+            sessionId: params.sessionId,
+            prompt: params.prompt,
+            cwd: session.cwd,
+            signal: session.controller.signal,
+            onEvent: (event) => {
+                const update = toAcpSessionUpdate(event, this.options.presenter);
+                if (update)
+                    void this.notifyUpdate(params.sessionId, update);
+            },
+            ask: (request) => this.askPermission(session, request),
+            filesystem: this.clientFilesystem(),
+            history: session.history,
+        });
+        return { stopReason: toAcpStopReason(outcome.stopReason) };
+    }
+    onSessionCancel(params) {
+        this.requireSession(params.sessionId).controller.abort();
+        // `null` rather than `{}`: a JSON-RPC result has to be present, and an
+        // empty object invites a client to look for a field.
+        return null;
+    }
+    /**
+     * Put a tool batch in front of the human, unless they already said yes to
+     * everything for this session.
+     */
+    async askPermission(session, request) {
+        // The latch, read from the SESSION. Checked here rather than in the
+        // gateway so no gateway can forget it.
+        if (session.approveAll)
+            return { kind: 'approve_all' };
+        const answer = await this.request(ACP_CLIENT_REQUESTS.REQUEST_PERMISSION, {
+            sessionId: request.sessionId,
+            toolCalls: request.toolCalls,
+        });
+        switch (answer?.outcome) {
+            case 'approve':
+                return { kind: 'approve' };
+            case 'approve_all':
+                session.approveAll = true;
+                return { kind: 'approve_all' };
+            case 'reject':
+                return { kind: 'reject', ...(answer.feedback ? { feedback: answer.feedback } : {}) };
+            default:
+                // An answer this side cannot read is not an approval. A client that
+                // sent something unrecognised has not said yes, and treating
+                // "unparseable" as consent is the failure this whole exchange
+                // exists to prevent.
+                return {
+                    kind: 'reject',
+                    feedback: `The client answered the permission request with an outcome this agent does not recognise (${JSON.stringify(answer?.outcome)}), so the calls were not run.`,
+                };
+        }
+    }
+    /**
+     * The client's buffers, when it declared the capability.
+     *
+     * `undefined` otherwise, and that is the ordinary case: a peer that is not
+     * an editor has no buffers, and the agent should read the disk.
+     */
+    clientFilesystem() {
+        if (!this.clientCapabilities.includes(ACP_FILESYSTEM_CAPABILITY))
+            return undefined;
+        return {
+            readTextFile: async (path) => {
+                const result = await this.request(ACP_CLIENT_REQUESTS.FS_READ, { path });
+                return result?.content ?? '';
+            },
+            writeTextFile: async (path, content) => {
+                await this.request(ACP_CLIENT_REQUESTS.FS_WRITE, { path, content });
+            },
+        };
+    }
+    requireSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new AcpError(ACP_ERROR_CODES.INVALID_PARAMS, `No session "${sessionId}". Create one with "${ACP_METHODS.SESSION_NEW}" first.`);
+        }
+        return session;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/bridge/acp/server.js.map

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