@chances-ai/wire 24.0.0

package/dist/rpc/acp/event-map.js

@@ -0,0 +1,205 @@
+// Pure mapping: internal `AppEvent` → ACP standard `SessionUpdate[]` (M3 /
+// docs/6.4a §4 commit 1). Upgraded from the lossy 3-variant v1 adapter to the
+// full set of AppEvents that have a STANDARD ACP `SessionUpdate` equivalent.
+// Returns an ARRAY (one AppEvent may yield 0/1 updates; the array shape leaves
+// room for 1:many without a later signature churn and lets every caller
+// uniformly `for (const u of mapEventToAcp(...))`).
+//
+// What maps here (standard ACP SessionUpdate):
+//   assistant:delta → agent_message_chunk
+//   tool:call       → tool_call         (kind + locations + rawInput)
+//   tool:result     → tool_call_update  (status + content + rawOutput)
+//   tool:chunk      → tool_call_update  (live-PTY text + _meta.chances.chunk)  [toolChunks]
+//   usage           → usage_update      (cost; full per-call numbers in _meta.chances.usage)
+//
+// What does NOT map to a standard SessionUpdate (→ `[]`):
+//   - compaction:start/end · subagent:done · error → chances-only; the framing
+//     layer (docs/6.4a §3, commit 2) emits these as `_chances/unstable/*`
+//     extension notifications (a plain ACP client ignores the unknown method;
+//     ours reads `_meta.chances`). They are NOT SessionUpdates — every variant
+//     needs a payload, there is no bare-`_meta` update.
+//   - turn:start / turn:end → ACP has no explicit turn boundary; the turn is the
+//     `session/prompt` request lifetime, settled by its response (framing layer).
+//   - assistant:message → the accumulation of `assistant:delta` chunks (no end marker).
+//   - usage:turn → folded into the `PromptResponse.usage` at turn end (framing layer).
+//   - tool:permission → the resolver round-trip's `session/request_permission` is the ask.
+//   - log → routed to stderr (stdout purity).
+//
+// HONEST SCOPE: chances' engine emits NO thinking/thought events and NO
+// todo/plan events, so ACP's `agent_thought_chunk` and `plan` have no source to
+// map from today — they are deliberate extension points (wire them when the
+// engine grows those events). Likewise `tool:result` carries a plain-text
+// `output`, not a structured old/new pair, so we surface it as text content +
+// `rawOutput`, NOT an ACP `diff` block.
+//
+// `import type` only — erased at compile, so this file is safe when the optional
+// `@agentclientprotocol/sdk` peer is absent.
+/** Cap the TEXT we surface as displayable content so one giant tool output
+ *  can't bloat the transcript (oh-my-pi's `ACP_TEXT_LIMIT`). The COMPLETE
+ *  output still rides untruncated in `rawOutput`, so no data is lost. */
+const TEXT_CAP = 4000;
+export function mapEventToAcp(e, opts) {
+    switch (e.type) {
+        case "assistant:delta":
+            return [{ sessionUpdate: "agent_message_chunk", content: { type: "text", text: e.text } }];
+        case "tool:call": {
+            const locations = locationsFromArgs(e.args);
+            return [
+                {
+                    sessionUpdate: "tool_call",
+                    toolCallId: e.callId,
+                    title: e.name,
+                    kind: toolKind(e.name),
+                    status: "pending",
+                    rawInput: e.args ?? {},
+                    ...(locations.length > 0 ? { locations } : {}),
+                },
+            ];
+        }
+        case "tool:result":
+            return [
+                {
+                    sessionUpdate: "tool_call_update",
+                    toolCallId: e.callId,
+                    status: e.ok ? "completed" : "failed",
+                    content: [{ type: "content", content: { type: "text", text: cap(e.output) } }],
+                    rawOutput: e.output,
+                },
+            ];
+        case "tool:chunk":
+            if (!opts.toolChunks)
+                return [];
+            return [
+                {
+                    sessionUpdate: "tool_call_update",
+                    toolCallId: e.callId,
+                    content: [{ type: "content", content: { type: "text", text: e.text } }],
+                    // Live-PTY fidelity (seq/bytes/exit) an ACP-only client ignores.
+                    _meta: { chances: { chunk: chunkMeta(e) } },
+                },
+            ];
+        case "usage":
+            return [
+                {
+                    sessionUpdate: "usage_update",
+                    used: e.inputTokens,
+                    size: opts.contextWindow ?? e.inputTokens,
+                    cost: { amount: e.costUsd, currency: "USD" },
+                    // Full per-call numbers (output + model) an ACP-only client ignores;
+                    // ours reads them for granular accounting.
+                    _meta: { chances: { usage: { model: e.model, inputTokens: e.inputTokens, outputTokens: e.outputTokens } } },
+                },
+            ];
+        // chances-only fidelity → extension notifications (framing layer), not a
+        // standard SessionUpdate. Out-of-band / folded events → dropped here.
+        case "compaction:start":
+        case "compaction:end":
+        case "subagent:done":
+        case "error":
+        case "assistant:reset":
+        case "turn:start":
+        case "turn:end":
+        case "assistant:message":
+        case "usage:turn":
+        case "tool:permission":
+        case "log":
+            return [];
+    }
+}
+/**
+ * chances-only fidelity (no standard ACP `SessionUpdate`) → the `_meta.chances`
+ * payload of a `_chances/unstable/event` extension notification, or `null` if `e`
+ * is not one of these. SHARED by the relay `AcpEngineDriver` + the stdio Zed
+ * adapter so both ACP transports carry compaction/subagent/error identically
+ * (codex M3 SHOULD — no per-transport drift). A plain ACP client ignores the
+ * unknown method; a chances-aware one reads `_meta.chances`.
+ */
+export function chancesEventMeta(e) {
+    switch (e.type) {
+        case "compaction:start":
+            return { compaction: { phase: "start", reason: e.reason, beforeTokens: e.beforeTokens } };
+        case "compaction:end":
+            return {
+                compaction: {
+                    phase: "end",
+                    reason: e.reason,
+                    ok: e.ok,
+                    ...(e.savedTokens !== undefined ? { savedTokens: e.savedTokens } : {}),
+                    durationMs: e.durationMs,
+                },
+            };
+        case "subagent:done":
+            return {
+                subagent: {
+                    taskId: e.taskId,
+                    agentName: e.agentName,
+                    status: e.status,
+                    durationMs: e.durationMs,
+                    ...(e.tokens ? { tokens: e.tokens } : {}),
+                },
+            };
+        case "error":
+            return { error: { code: e.code, message: e.message } };
+        case "assistant:reset":
+            // (6.5b review) No standard ACP SessionUpdate undoes an emitted
+            // `agent_message_chunk`, so a retry restream rides this extension event;
+            // a chances-aware client drops its in-flight partial, a plain ACP client
+            // ignores the unknown method (and tolerates the duplicate).
+            return { reset: { turnId: e.turnId } };
+        default:
+            return null;
+    }
+}
+/** Map a chances tool name to the closest ACP tool category (icon/UI hint). */
+function toolKind(name) {
+    if (name.startsWith("mcp__"))
+        return "other";
+    switch (name) {
+        case "read":
+        case "lsp":
+            return "read";
+        case "write":
+        case "edit":
+            return "edit";
+        case "bash":
+        case "pty":
+            return "execute";
+        case "grep":
+        case "glob":
+            return "search";
+        case "web_fetch":
+            return "fetch";
+        default:
+            return "other";
+    }
+}
+/** Pull a file path out of a tool call's args for ACP "follow-along" locations.
+ *  Best-effort: recognises the path-shaped keys our file tools use. Paths are
+ *  surfaced verbatim (resolving relative→absolute against the session cwd is a
+ *  future refinement; most file tools already pass an absolute path). */
+function locationsFromArgs(args) {
+    if (!args || typeof args !== "object")
+        return [];
+    const rec = args;
+    for (const key of ["path", "file_path", "filePath", "file"]) {
+        const v = rec[key];
+        if (typeof v === "string" && v.length > 0)
+            return [{ path: v }];
+    }
+    return [];
+}
+function chunkMeta(e) {
+    return {
+        seq: e.seq,
+        bytes: e.bytes,
+        ...(e.dropped !== undefined ? { dropped: e.dropped } : {}),
+        ...(e.terminal !== undefined ? { terminal: e.terminal } : {}),
+        ...(e.state !== undefined ? { state: e.state } : {}),
+        ...(e.exitCode !== undefined ? { exitCode: e.exitCode } : {}),
+        ...(e.reason !== undefined ? { reason: e.reason } : {}),
+    };
+}
+function cap(text) {
+    return text.length > TEXT_CAP ? `${text.slice(0, TEXT_CAP)}\n…[truncated]` : text;
+}
+//# sourceMappingURL=event-map.js.map

package/dist/rpc/acp/event-map.js.map

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

package/dist/rpc/acp/load-sdk.d.ts

@@ -0,0 +1,3 @@
+export type AcpSdk = typeof import("@agentclientprotocol/sdk");
+export declare function loadAcpSdk(): Promise<AcpSdk | null>;
+//# sourceMappingURL=load-sdk.d.ts.map

package/dist/rpc/acp/load-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-sdk.d.ts","sourceRoot":"","sources":["../../../src/rpc/acp/load-sdk.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,MAAM,GAAG,cAAc,0BAA0B,CAAC,CAAC;AAE/D,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAazD"}

package/dist/rpc/acp/load-sdk.js

@@ -0,0 +1,24 @@
+// Computed-specifier lazy load of the optional `@agentclientprotocol/sdk`
+// peer — same pattern as 4.2 LSP's `vscode-jsonrpc` and 3.6 OTel's SDK. A
+// literal `import("@agentclientprotocol/sdk")` would make `bun build
+// --compile` try to statically resolve the peer even though it's optional;
+// building the specifier from string parts keeps the bundler's static
+// resolver blind, so the binary compiles whether or not the SDK is installed
+// (`scripts/smoke-compile-rpc.ts` gates both permutations). Returns null when
+// the peer is absent — `chances acp` then exits with install guidance.
+export async function loadAcpSdk() {
+    try {
+        const specifier = ["@agentclientprotocol", "sdk"].join("/");
+        const mod = (await import(specifier));
+        // Minimal shape check — a partial/incompatible install returns null
+        // rather than crashing later inside the adapter.
+        if (typeof mod.AgentSideConnection !== "function") {
+            return null;
+        }
+        return mod;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=load-sdk.js.map

package/dist/rpc/acp/load-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-sdk.js","sourceRoot":"","sources":["../../../src/rpc/acp/load-sdk.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,0EAA0E;AAC1E,qEAAqE;AACrE,2EAA2E;AAC3E,sEAAsE;AACtE,6EAA6E;AAC7E,8EAA8E;AAC9E,uEAAuE;AAIvE,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAW,CAAC;QAChD,oEAAoE;QACpE,iDAAiD;QACjD,IAAI,OAAQ,GAAyC,CAAC,mBAAmB,KAAK,UAAU,EAAE,CAAC;YACzF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/rpc/acp/workspace-query.d.ts

@@ -0,0 +1,41 @@
+/**
+ * (v23 M5 / docs/6.6 §2) The wire contract for the read-only workspace queries
+ * that back the 3-pane IDE — the method-name constants + a single dispatcher
+ * reused by the relay (`@chances-ai/serve` `AcpSessionHost`, which intercepts
+ * these and answers via a targeted off-ring `replyTo`).
+ *
+ * The `AcpEngineDriver` does NOT handle these (it stays a turn-pure runner); it
+ * only advertises the `workspaceQueries` capability when its host supports them.
+ * stdio transports (`chances acp` Zed / `chances rpc`) never advertise them, so a
+ * conformant client won't send them; a rogue send falls to `methodNotFound`.
+ *
+ * The queries are READ-ONLY and NON-privileged: a lease viewer may browse the
+ * workspace (same tier as `initialize`/`get_state`/`ping`).
+ */
+import type { EngineHost } from "../driver.js";
+/** `_chances/unstable/*` method names (mirroring goose's `_goose/unstable/*`). */
+export declare const WORKSPACE_QUERY_METHODS: {
+    readonly listFiles: "_chances/unstable/list_files";
+    readonly readFile: "_chances/unstable/read_file";
+    readonly gitStatus: "_chances/unstable/git_status";
+    readonly gitDiff: "_chances/unstable/git_diff";
+};
+/** True for the four read-only query methods. */
+export declare function isWorkspaceQueryMethod(method: string): boolean;
+/** True when a host exposes the query primitives (⇒ advertise + intercept). */
+export declare function hostSupportsWorkspaceQueries(host: EngineHost): boolean;
+export interface QueryOutcome {
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+}
+/**
+ * Validate params, call the matching `host.query*`, and shape a JSON-RPC
+ * result/error. A `WorkspaceEscapeError` (path outside the workspace) maps to
+ * `invalidParams`; a missing primitive to `methodNotFound`; any other throw to
+ * `serverError`. The caller writes the response (the relay via `replyTo`).
+ */
+export declare function dispatchWorkspaceQuery(host: EngineHost, method: string, params: unknown, signal: AbortSignal): Promise<QueryOutcome>;
+//# sourceMappingURL=workspace-query.d.ts.map

package/dist/rpc/acp/workspace-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-query.d.ts","sourceRoot":"","sources":["../../../src/rpc/acp/workspace-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,kFAAkF;AAClF,eAAO,MAAM,uBAAuB;;;;;CAK1B,CAAC;AAIX,iDAAiD;AACjD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,+EAA+E;AAC/E,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAOtE;AAKD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAUD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAgCvB"}

package/dist/rpc/acp/workspace-query.js

@@ -0,0 +1,89 @@
+/**
+ * (v23 M5 / docs/6.6 §2) The wire contract for the read-only workspace queries
+ * that back the 3-pane IDE — the method-name constants + a single dispatcher
+ * reused by the relay (`@chances-ai/serve` `AcpSessionHost`, which intercepts
+ * these and answers via a targeted off-ring `replyTo`).
+ *
+ * The `AcpEngineDriver` does NOT handle these (it stays a turn-pure runner); it
+ * only advertises the `workspaceQueries` capability when its host supports them.
+ * stdio transports (`chances acp` Zed / `chances rpc`) never advertise them, so a
+ * conformant client won't send them; a rogue send falls to `methodNotFound`.
+ *
+ * The queries are READ-ONLY and NON-privileged: a lease viewer may browse the
+ * workspace (same tier as `initialize`/`get_state`/`ping`).
+ */
+import { WorkspaceEscapeError } from "@chances-ai/engine/core";
+/** `_chances/unstable/*` method names (mirroring goose's `_goose/unstable/*`). */
+export const WORKSPACE_QUERY_METHODS = {
+    listFiles: "_chances/unstable/list_files",
+    readFile: "_chances/unstable/read_file",
+    gitStatus: "_chances/unstable/git_status",
+    gitDiff: "_chances/unstable/git_diff",
+};
+const QUERY_METHOD_SET = new Set(Object.values(WORKSPACE_QUERY_METHODS));
+/** True for the four read-only query methods. */
+export function isWorkspaceQueryMethod(method) {
+    return QUERY_METHOD_SET.has(method);
+}
+/** True when a host exposes the query primitives (⇒ advertise + intercept). */
+export function hostSupportsWorkspaceQueries(host) {
+    return (typeof host.queryListFiles === "function" &&
+        typeof host.queryReadFile === "function" &&
+        typeof host.queryGitStatus === "function" &&
+        typeof host.queryGitDiff === "function");
+}
+/** JSON-RPC standard error codes (a subset). */
+const ERR = { methodNotFound: -32601, invalidParams: -32602, serverError: -32000 };
+function asObject(params) {
+    return params && typeof params === "object" ? params : {};
+}
+function optString(o, key) {
+    const v = o[key];
+    return typeof v === "string" ? v : undefined;
+}
+/**
+ * Validate params, call the matching `host.query*`, and shape a JSON-RPC
+ * result/error. A `WorkspaceEscapeError` (path outside the workspace) maps to
+ * `invalidParams`; a missing primitive to `methodNotFound`; any other throw to
+ * `serverError`. The caller writes the response (the relay via `replyTo`).
+ */
+export async function dispatchWorkspaceQuery(host, method, params, signal) {
+    const o = asObject(params);
+    try {
+        switch (method) {
+            case WORKSPACE_QUERY_METHODS.listFiles: {
+                if (!host.queryListFiles)
+                    return { error: { code: ERR.methodNotFound, message: "list_files unsupported" } };
+                const dir = optString(o, "dir") ?? ".";
+                return { result: await host.queryListFiles(dir, signal) };
+            }
+            case WORKSPACE_QUERY_METHODS.readFile: {
+                if (!host.queryReadFile)
+                    return { error: { code: ERR.methodNotFound, message: "read_file unsupported" } };
+                const path = optString(o, "path");
+                if (path === undefined)
+                    return { error: { code: ERR.invalidParams, message: "read_file requires a string `path`" } };
+                return { result: await host.queryReadFile(path, signal) };
+            }
+            case WORKSPACE_QUERY_METHODS.gitStatus: {
+                if (!host.queryGitStatus)
+                    return { error: { code: ERR.methodNotFound, message: "git_status unsupported" } };
+                return { result: await host.queryGitStatus(signal) };
+            }
+            case WORKSPACE_QUERY_METHODS.gitDiff: {
+                if (!host.queryGitDiff)
+                    return { error: { code: ERR.methodNotFound, message: "git_diff unsupported" } };
+                return { result: await host.queryGitDiff(optString(o, "path"), signal) };
+            }
+            default:
+                return { error: { code: ERR.methodNotFound, message: `unknown query: ${method}` } };
+        }
+    }
+    catch (e) {
+        if (e instanceof WorkspaceEscapeError) {
+            return { error: { code: ERR.invalidParams, message: e.message } };
+        }
+        return { error: { code: ERR.serverError, message: e.message ?? String(e) } };
+    }
+}
+//# sourceMappingURL=workspace-query.js.map

package/dist/rpc/acp/workspace-query.js.map

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

package/dist/rpc/driver.d.ts

@@ -0,0 +1,42 @@
+import type { AgentResult, GitDiffResult, GitStatusResult, ListFilesResult, ReadFileResult } from "@chances-ai/engine/core";
+import type { ApprovalState, CancellationToken, EventBus, ModelSelection } from "@chances-ai/runtime";
+import type { PermissionResolver } from "@chances-ai/engine/tools";
+import type { ModelInfo } from "./protocol.js";
+/** A live engine bound to one permission resolver + one session. */
+export interface BuiltEngine {
+    /** Run one turn. The server mints a fresh `CancellationToken` per call
+     * (codex C10 — avoids a stale-AbortController footgun). */
+    runTurn(prompt: string, token: CancellationToken): Promise<AgentResult>;
+    /** The bus the server subscribes to for outbound frames. */
+    bus: EventBus;
+    /** Mutable model preference; `set_model` mutates it (between turns only). */
+    selection: ModelSelection;
+    /** (v22) Mutable session approval mode; the `_chances/unstable/set_approval`
+     *  extension mutates it so a GUI client can drive the same default/auto-edit/
+     *  plan/yolo cycle the TUI's Shift+Tab does. Optional — a host that doesn't
+     *  expose an approval holder (e.g. a test mock) simply omits it, and the wire
+     *  reports `approvalMode: "default"` + rejects `set_approval`. */
+    approval?: ApprovalState;
+    /** Stable session id surfaced in the `ready` handshake + `turn_start`. */
+    sessionId: string;
+}
+/** Implemented by apps/cli. The server owns the permission round-trip, so it
+ * constructs the resolver and hands it here at build time. */
+export interface EngineHost {
+    /** Build (once, at session start) an engine bound to `resolver`. */
+    build(resolver: PermissionResolver): BuiltEngine;
+    /** Models for the `ready` handshake + the `get_models` command. */
+    listModels(): ModelInfo[];
+    /** Tear down the shared runtime context. apps/cli runs the canonical CLI
+     * shutdown order (backgroundTasks → ptySessions → mcp → plugins → otel). */
+    dispose(): Promise<void>;
+    /** Immediate children of `dir` (one level, lazy), workspace-contained. */
+    queryListFiles?(dir: string, signal: AbortSignal): Promise<ListFilesResult>;
+    /** A workspace file's contents (capped + binary-guarded), workspace-contained. */
+    queryReadFile?(path: string, signal: AbortSignal): Promise<ReadFileResult>;
+    /** `git status` (branch + ahead/behind + changed files); soft `{repo:false}`. */
+    queryGitStatus?(signal: AbortSignal): Promise<GitStatusResult>;
+    /** `git diff [path]` (capped) + shortstat totals. */
+    queryGitDiff?(path: string | undefined, signal: AbortSignal): Promise<GitDiffResult>;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/rpc/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/rpc/driver.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC5H,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACtG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B;+DAC2D;IAC3D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACxE,4DAA4D;IAC5D,GAAG,EAAE,QAAQ,CAAC;IACd,6EAA6E;IAC7E,SAAS,EAAE,cAAc,CAAC;IAC1B;;;;sEAIkE;IAClE,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;8DAC8D;AAC9D,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,KAAK,CAAC,QAAQ,EAAE,kBAAkB,GAAG,WAAW,CAAC;IACjD,mEAAmE;IACnE,UAAU,IAAI,SAAS,EAAE,CAAC;IAC1B;gFAC4E;IAC5E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IASzB,0EAA0E;IAC1E,cAAc,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5E,kFAAkF;IAClF,aAAa,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3E,iFAAiF;IACjF,cAAc,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/D,qDAAqD;IACrD,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACtF"}

package/dist/rpc/driver.js

@@ -0,0 +1,7 @@
+// The seam both transports project onto (codex C1 — the single most
+// important lesson from all three reference repos). The `@chances-ai/rpc`
+// package never imports app boot; apps/cli implements `EngineHost` over
+// `buildEngine` + `loadRuntime`, which makes the whole server unit-testable
+// in-process against a MockAdapter-backed engine.
+export {};
+//# sourceMappingURL=driver.js.map

package/dist/rpc/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../src/rpc/driver.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,0EAA0E;AAC1E,wEAAwE;AACxE,4EAA4E;AAC5E,kDAAkD"}

package/dist/rpc/event-map.d.ts

@@ -0,0 +1,8 @@
+import type { AppEvent } from "@chances-ai/runtime";
+import type { EventFrame } from "./protocol.js";
+export interface EventMapOptions {
+    /** When false, `tool:chunk` (live PTY output) is suppressed (N2 opt-out). */
+    toolChunks: boolean;
+}
+export declare function mapEvent(e: AppEvent, opts: EventMapOptions): EventFrame | null;
+//# sourceMappingURL=event-map.d.ts.map

package/dist/rpc/event-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-map.d.ts","sourceRoot":"","sources":["../../src/rpc/event-map.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,GAAG,UAAU,GAAG,IAAI,CA4E9E"}

package/dist/rpc/event-map.js

@@ -0,0 +1,91 @@
+// Pure mapping: internal `AppEvent` → bespoke RPC `EventFrame` (codex C3 —
+// reuse the internal union as the wire payload). Returns `null` for events
+// that must NOT reach the wire:
+//   - tool:permission  → the resolver round-trip's `request_permission` is
+//                        the canonical ask (avoids a double-signal; D5).
+//   - turn:end         → completion is the richer `result` frame.
+//   - assistant:message → folded into `result`.
+//   - usage:turn       → the turn total is on `result`; per-call `usage` is
+//                        forwarded for granularity.
+//   - log              → routed to stderr by the server (stdout purity).
+// `commandId` on `turn_start` is stamped by the server (it owns that state),
+// not here.
+export function mapEvent(e, opts) {
+    switch (e.type) {
+        case "turn:start":
+            return { type: "turn_start", turnId: e.turnId, prompt: e.prompt, sessionId: e.sessionId };
+        case "assistant:delta":
+            return { type: "assistant_delta", turnId: e.turnId, text: e.text, agentId: e.agentId };
+        case "tool:call":
+            return { type: "tool_call", callId: e.callId, name: e.name, args: e.args, agentId: e.agentId };
+        case "tool:result":
+            return {
+                type: "tool_result",
+                callId: e.callId,
+                name: e.name,
+                ok: e.ok,
+                output: e.output,
+                agentId: e.agentId,
+            };
+        case "tool:chunk":
+            if (!opts.toolChunks)
+                return null;
+            return {
+                type: "tool_chunk",
+                callId: e.callId,
+                sessionId: e.sessionId,
+                seq: e.seq,
+                text: e.text,
+                bytes: e.bytes,
+                dropped: e.dropped,
+                terminal: e.terminal,
+                state: e.state,
+                exitCode: e.exitCode,
+                reason: e.reason,
+                agentId: e.agentId,
+            };
+        case "usage":
+            return {
+                type: "usage",
+                model: e.model,
+                inputTokens: e.inputTokens,
+                outputTokens: e.outputTokens,
+                costUsd: e.costUsd,
+                agentId: e.agentId,
+            };
+        case "compaction:start":
+            return { type: "compaction_start", reason: e.reason, beforeTokens: e.beforeTokens };
+        case "compaction:end":
+            return {
+                type: "compaction_end",
+                reason: e.reason,
+                ok: e.ok,
+                savedTokens: e.savedTokens,
+                durationMs: e.durationMs,
+            };
+        case "subagent:done":
+            return {
+                type: "subagent_done",
+                taskId: e.taskId,
+                agentName: e.agentName,
+                status: e.status,
+                durationMs: e.durationMs,
+                tokens: e.tokens,
+            };
+        case "error":
+            return { type: "error", code: e.code, message: e.message };
+        // Suppressed (see file header):
+        case "tool:permission":
+        case "turn:end":
+        case "assistant:message":
+        case "usage:turn":
+        case "log":
+        // `assistant:reset` is a transcript-display concern (undo a partial line
+        // before a retry restream). The bespoke stdio wire feeds programmatic
+        // integrations that accumulate `result`, not a live `ChatViewModel`, so it
+        // has no partial to undo — the ACP wire carries reset for GUI clients.
+        case "assistant:reset":
+            return null;
+    }
+}
+//# sourceMappingURL=event-map.js.map

package/dist/rpc/event-map.js.map

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

package/dist/rpc/index.d.ts

@@ -0,0 +1,13 @@
+export { PROTOCOL_NAME, PROTOCOL_VERSION, CommandSchema, RSEQ_KEY, stampSeq, readRseq, type Command, type CommandType, type ModelInfo, type ServerFrame, type EventFrame, type ReadyFrame, type ResponseFrame, type RequestPermissionFrame, type RelayFrame, type RelayWelcomeFrame, type ResetFrame, type ClientInboundFrame, type RpcError, type RpcErrorCode, type StopReason, } from "./protocol.js";
+export type { BuiltEngine, EngineHost } from "./driver.js";
+export { BoundedNdjsonWriter, type ByteSink, type WriterOptions } from "./writer.js";
+export { installStdoutGuard, type StdoutGuard } from "./stdout-guard.js";
+export { mapEvent, type EventMapOptions } from "./event-map.js";
+export { RpcServer, type RpcServerOptions } from "./rpc-server.js";
+export { linesFromStream } from "./lines.js";
+export { runAcp, AcpAgent, type RunAcpOptions } from "./acp/adapter.js";
+export { mapEventToAcp, type AcpMapOptions } from "./acp/event-map.js";
+export { AcpEngineDriver, ACP_PROTOCOL_VERSION, type AcpEngineDriverOptions } from "./acp/engine-driver.js";
+export { loadAcpSdk, type AcpSdk } from "./acp/load-sdk.js";
+export { WORKSPACE_QUERY_METHODS, dispatchWorkspaceQuery, hostSupportsWorkspaceQueries, isWorkspaceQueryMethod, type QueryOutcome, } from "./acp/workspace-query.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/rpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rpc/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC5G,OAAO,EAAE,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,sBAAsB,EACtB,KAAK,YAAY,GAClB,MAAM,0BAA0B,CAAC"}

package/dist/rpc/index.js

@@ -0,0 +1,18 @@
+// @chances-ai/rpc — Stable RPC + ACP host (5.2 / v7.0.0).
+//
+// Two transports over ONE engine seam (`EngineHost`): the bespoke
+// NDJSON-over-stdio RPC server (`RpcServer`) and the Zed ACP adapter
+// (`runAcp`, optional `@agentclientprotocol/sdk` peer). apps/cli provides the
+// concrete `EngineHost` (over `buildEngine`) + the stdio transport.
+export { PROTOCOL_NAME, PROTOCOL_VERSION, CommandSchema, RSEQ_KEY, stampSeq, readRseq, } from "./protocol.js";
+export { BoundedNdjsonWriter } from "./writer.js";
+export { installStdoutGuard } from "./stdout-guard.js";
+export { mapEvent } from "./event-map.js";
+export { RpcServer } from "./rpc-server.js";
+export { linesFromStream } from "./lines.js";
+export { runAcp, AcpAgent } from "./acp/adapter.js";
+export { mapEventToAcp } from "./acp/event-map.js";
+export { AcpEngineDriver, ACP_PROTOCOL_VERSION } from "./acp/engine-driver.js";
+export { loadAcpSdk } from "./acp/load-sdk.js";
+export { WORKSPACE_QUERY_METHODS, dispatchWorkspaceQuery, hostSupportsWorkspaceQueries, isWorkspaceQueryMethod, } from "./acp/workspace-query.js";
+//# sourceMappingURL=index.js.map

package/dist/rpc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rpc/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,kEAAkE;AAClE,qEAAqE;AACrE,8EAA8E;AAC9E,oEAAoE;AAEpE,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,QAAQ,GAgBT,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mBAAmB,EAAqC,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAoB,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAwB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAyB,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAsB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAsB,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAA+B,MAAM,wBAAwB,CAAC;AAC5G,OAAO,EAAE,UAAU,EAAe,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,sBAAsB,GAEvB,MAAM,0BAA0B,CAAC"}

package/dist/rpc/lines.d.ts

@@ -0,0 +1,2 @@
+export declare function linesFromStream(stream: AsyncIterable<string | Uint8Array>): AsyncIterable<string>;
+//# sourceMappingURL=lines.d.ts.map

package/dist/rpc/lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.d.ts","sourceRoot":"","sources":["../../src/rpc/lines.ts"],"names":[],"mappings":"AAMA,wBAAuB,eAAe,CACpC,MAAM,EAAE,aAAa,CAAC,MAAM,GAAG,UAAU,CAAC,GACzC,aAAa,CAAC,MAAM,CAAC,CAevB"}