zcode-acp-server 0.1.0

package/dist/backend/listener.js

@@ -0,0 +1,138 @@
+/**
+ * Event-stream listener and turn monitor.
+ *
+ * `EventStreamListener` subscribes to ZCode's `session/subscribe` event push
+ * (deliveryKind `desktop-continuous`) and queues `session/event` notifications
+ * for the turn loop to consume. It tracks a `lastSeq` watermark and can
+ * resubscribe from it to recover missed events after a stall.
+ *
+ * `TurnMonitor` is the legacy snapshot path: a one-shot `session/read` that
+ * returns the authoritative projection. Used for stall reconciliation and
+ * lock-release probing.
+ */
+export class EventStreamListener {
+    backend;
+    sid;
+    /** High-watermark of consumed event sequence numbers. */
+    lastSeq = 0;
+    subscribed = false;
+    queue = [];
+    waiters = [];
+    constructor(backend, zcodeSid) {
+        this.backend = backend;
+        this.sid = zcodeSid;
+    }
+    /**
+     * Subscribe and capture the initial snapshot + eventSeq watermark.
+     *
+     * Returns the snapshot (with projection/messages) or null on failure. ZCode
+     * CLI 0.14.8+ always supports this; null means an old/ broken backend and
+     * the caller should surface an error (polling fallback was removed).
+     */
+    async subscribe(nextId) {
+        const resp = await this.backend.request(nextId(), "session/subscribe", {
+            sessionId: this.sid,
+            deliveryKind: "desktop-continuous",
+            includeSnapshot: true,
+            afterSeq: 0,
+        }, 10000);
+        if (resp.error) {
+            return null;
+        }
+        const result = (resp.result ?? {});
+        this.lastSeq = result.eventSeq ?? 0;
+        this.subscribed = true;
+        return result.snapshot ?? null;
+    }
+    /** Called by the backend reader when a `session/event` arrives. */
+    handleEvent(event) {
+        if (event.seq > this.lastSeq)
+            this.lastSeq = event.seq;
+        // Drop waiters that already timed out (their promise settled with null) so
+        // a late event never lands on a dead promise — that would silently drop it.
+        let waiter = this.waiters.shift();
+        while (waiter && waiter.done)
+            waiter = this.waiters.shift();
+        if (waiter) {
+            waiter.done = true;
+            clearTimeout(waiter.timer);
+            waiter.resolve(event);
+        }
+        else {
+            this.queue.push(event);
+        }
+    }
+    /**
+     * Wait for the next event, resolving once one arrives or `timeoutMs` elapses
+     * (resolves null on timeout). Events arriving with no active waiter are
+     * queued. A timed-out waiter is marked `done` so a later event skips it
+     * instead of being silently dropped on a settled promise.
+     */
+    pollEvent(timeoutMs = 500) {
+        const queued = this.queue.shift();
+        if (queued)
+            return Promise.resolve(queued);
+        return new Promise((resolve) => {
+            const waiter = {
+                done: false,
+                resolve,
+                timer: undefined,
+            };
+            waiter.timer = setTimeout(() => {
+                if (waiter.done)
+                    return;
+                waiter.done = true;
+                const idx = this.waiters.indexOf(waiter);
+                if (idx >= 0)
+                    this.waiters.splice(idx, 1);
+                resolve(null);
+            }, timeoutMs);
+            this.waiters.push(waiter);
+        });
+    }
+    /**
+     * Stall recovery: resubscribe from `lastSeq` so the server replays missed
+     * events. Failure is logged but non-fatal — the caller degrades to polling.
+     * The snapshot (if returned despite `includeSnapshot:false`) is intentionally
+     * not consumed; resubscribe only refreshes the watermark + resumes the push.
+     */
+    async resubscribe(nextId) {
+        const resp = await this.backend.request(nextId(), "session/subscribe", {
+            sessionId: this.sid,
+            deliveryKind: "desktop-continuous",
+            includeSnapshot: false,
+            afterSeq: this.lastSeq,
+        }, 10000);
+        if (resp.error) {
+            return false;
+        }
+        const result = (resp.result ?? {});
+        if ((result.eventSeq ?? this.lastSeq) > this.lastSeq) {
+            this.lastSeq = result.eventSeq ?? this.lastSeq;
+        }
+        return true;
+    }
+}
+/**
+ * Legacy snapshot path: a single `session/read` returning the authoritative
+ * projection. Used in stall reconciliation and lock-release probing.
+ */
+export class TurnMonitor {
+    backend;
+    zcodeSid;
+    nextId;
+    constructor(backend, zcodeSid, nextId) {
+        this.backend = backend;
+        this.zcodeSid = zcodeSid;
+        this.nextId = nextId;
+    }
+    /** Returns the projection snapshot, or null on error. */
+    async pollOnce() {
+        const resp = await this.backend.request(this.nextId(), "session/read", { sessionId: this.zcodeSid }, 5000);
+        if (resp.error)
+            return null;
+        const result = (resp.result ?? {});
+        return result.projection ?? null;
+    }
+}
+//# sourceMappingURL=listener.js.map

package/dist/backend/listener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listener.js","sourceRoot":"","sources":["../../src/backend/listener.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgBH,MAAM,OAAO,mBAAmB;IACb,OAAO,CAAe;IAC9B,GAAG,CAAS;IACrB,yDAAyD;IACzD,OAAO,GAAG,CAAC,CAAC;IACZ,UAAU,GAAG,KAAK,CAAC;IACF,KAAK,GAAiB,EAAE,CAAC;IACzB,OAAO,GAAa,EAAE,CAAC;IAExC,YAAY,OAAqB,EAAE,QAAgB;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CACrC,MAAM,EAAE,EACR,mBAAmB,EACnB;YACE,SAAS,EAAE,IAAI,CAAC,GAAG;YACnB,YAAY,EAAE,oBAAoB;YAClC,eAAe,EAAE,IAAI;YACrB,QAAQ,EAAE,CAAC;SACZ,EACD,KAAK,CACN,CAAC;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAyB,CAAC;QAC3D,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,OAAO,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC;IACjC,CAAC;IAED,mEAAmE;IACnE,WAAW,CAAC,KAAiB;QAC3B,IAAI,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC;QACvD,2EAA2E;QAC3E,4EAA4E;QAC5E,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAClC,OAAO,MAAM,IAAI,MAAM,CAAC,IAAI;YAAE,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC5D,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;YACnB,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,SAAS,GAAG,GAAG;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,MAAM;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAW;gBACrB,IAAI,EAAE,KAAK;gBACX,OAAO;gBACP,KAAK,EAAE,SAAqD;aAC7D,CAAC;YACF,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC7B,IAAI,MAAM,CAAC,IAAI;oBAAE,OAAO;gBACxB,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;gBACnB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACzC,IAAI,GAAG,IAAI,CAAC;oBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC1C,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,MAAc;QAC9B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CACrC,MAAM,EAAE,EACR,mBAAmB,EACnB;YACE,SAAS,EAAE,IAAI,CAAC,GAAG;YACnB,YAAY,EAAE,oBAAoB;YAClC,eAAe,EAAE,KAAK;YACtB,QAAQ,EAAE,IAAI,CAAC,OAAO;SACvB,EACD,KAAK,CACN,CAAC;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAyB,CAAC;QAC3D,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACrD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,WAAW;IACL,OAAO,CAAe;IACtB,QAAQ,CAAS;IACjB,MAAM,CAAS;IAEhC,YAAY,OAAqB,EAAE,QAAgB,EAAE,MAAc;QACjE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CACrC,IAAI,CAAC,MAAM,EAAE,EACb,cAAc,EACd,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,EAC5B,IAAI,CACL,CAAC;QACF,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAC5B,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAqC,CAAC;QACvE,OAAO,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC;IACnC,CAAC;CACF"}

package/dist/backend/resolve.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Resolve the argv to launch the ZCode app-server subprocess.
+ *
+ * The ZCode CLI is a Node `.cjs` that relies on a `#!/usr/bin/env node` shebang.
+ * Processes launched by GUI launchd (no shell profile) have no `node` on PATH,
+ * so the shebang fails. We sidestep it by constructing `[node, zcode.cjs,
+ * "app-server", "--stdio"]` with an explicit, sqlite-capable Node binary.
+ */
+/** Resolve the full argv to launch `zcode app-server --stdio`. */
+export declare function resolveZcodeCommand(): string[];
+//# sourceMappingURL=resolve.d.ts.map

package/dist/backend/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/backend/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8EH,kEAAkE;AAClE,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CA4B9C"}

package/dist/backend/resolve.js

@@ -0,0 +1,116 @@
+/**
+ * Resolve the argv to launch the ZCode app-server subprocess.
+ *
+ * The ZCode CLI is a Node `.cjs` that relies on a `#!/usr/bin/env node` shebang.
+ * Processes launched by GUI launchd (no shell profile) have no `node` on PATH,
+ * so the shebang fails. We sidestep it by constructing `[node, zcode.cjs,
+ * "app-server", "--stdio"]` with an explicit, sqlite-capable Node binary.
+ */
+import { existsSync, readdirSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import process from "node:process";
+import { execFileSync } from "node:child_process";
+import { log } from "../utils.js";
+/** `which bin` — resolve a binary on PATH without external deps. */
+function whichSync(bin) {
+    try {
+        const out = execFileSync("which", [bin], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        return out || null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Glob the Zed-bundled node directories, newest version first. */
+function zedBundledNodes() {
+    const base = path.join(os.homedir(), "Library/Application Support/Zed/node");
+    if (!existsSync(base))
+        return [];
+    let entries = [];
+    try {
+        entries = readdirSync(base);
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((d) => d.startsWith("node-v"))
+        .sort()
+        .reverse()
+        .map((d) => path.join(base, d, "bin", "node"));
+}
+/**
+ * Candidate Node binaries in priority order. Deduped, order-preserving.
+ * Falls back to the Zed-bundled Node glob as a last resort.
+ */
+function candidateNodeBinaries() {
+    const cands = [];
+    const envNode = process.env.ZCODE_NODE;
+    if (envNode)
+        cands.push(envNode);
+    cands.push("/opt/homebrew/bin/node", "/usr/local/bin/node");
+    const whichNode = whichSync("node");
+    if (whichNode)
+        cands.push(whichNode);
+    cands.push(...zedBundledNodes());
+    const seen = new Set();
+    return cands.filter((c) => {
+        if (!c || seen.has(c))
+            return false;
+        seen.add(c);
+        return true;
+    });
+}
+/**
+ * Verify a Node binary can load `node:sqlite` (ZCode depends on it; Node < 22
+ * lacks the module and would crash). Uses `new DatabaseSync(...)` because a
+ * bare reference would mis-detect support.
+ */
+function nodeSupportsSqlite(nodeBin) {
+    if (!nodeBin || !existsSync(nodeBin))
+        return false;
+    try {
+        execFileSync(nodeBin, ["-e", "new (require('node:sqlite').DatabaseSync)(':memory:')"], {
+            stdio: ["ignore", "ignore", "ignore"],
+            timeout: 5000,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Resolve the full argv to launch `zcode app-server --stdio`. */
+export function resolveZcodeCommand() {
+    const zcodeBin = process.env.ZCODE_BIN ?? "zcode";
+    // Non-JS bin (e.g. a `zcode` command or wrapper) → use as-is, rely on its own shebang.
+    if (!/\.(cjs|mjs|js)$/.test(zcodeBin)) {
+        return [zcodeBin, "app-server", "--stdio"];
+    }
+    // JS file → launch with an explicit sqlite-capable Node to bypass the shebang.
+    for (const nodeBin of candidateNodeBinaries()) {
+        if (nodeSupportsSqlite(nodeBin)) {
+            let ver = "?";
+            try {
+                // argv form (no shell, space-safe); capture stderr so it doesn't leak.
+                ver = execFileSync(nodeBin, ["--version"], {
+                    encoding: "utf8",
+                    stdio: ["ignore", "pipe", "pipe"],
+                }).trim();
+            }
+            catch {
+                // keep "?"
+            }
+            log(`resolve: launching zcode with node ${nodeBin} (${ver})`);
+            return [nodeBin, zcodeBin, "app-server", "--stdio"];
+        }
+    }
+    log("resolve: no sqlite-capable node found; falling back to PATH-resolved zcode shebang " +
+        "(may fail under GUI launch)");
+    return [zcodeBin, "app-server", "--stdio"];
+}
+//# sourceMappingURL=resolve.js.map

package/dist/backend/resolve.js.map

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

package/dist/backend/types.d.ts

@@ -0,0 +1,164 @@
+/**
+ * ZCode app-server protocol type definitions.
+ *
+ * ZCode speaks a line-delimited JSON protocol over stdio. It is JSON-RPC-like
+ * but deliberately omits the `jsonrpc` field. Messages are classified by the
+ * presence of `id` and `method`:
+ *   - id + no method        → response to a request we sent
+ *   - id + method           → either our response (id registered) or a server→client request
+ *   - method + no id        → notification (e.g. `session/event`)
+ *
+ * Only the fields we actually consume are typed; the rest pass through as
+ * `unknown`/`Record<string, unknown>` to stay resilient to ZCode schema drift.
+ */
+export interface ZcodeRequest {
+    id: number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface ZcodeNotification {
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface ZcodeResponse {
+    id: number;
+    result?: unknown;
+    error?: {
+        message: string;
+        code?: number | string;
+        detail?: unknown;
+    };
+}
+/** Any inbound message from the ZCode subprocess. */
+export type ZcodeInbound = Partial<ZcodeRequest> & Partial<ZcodeResponse> & Partial<ZcodeNotification>;
+export interface ZcodeSessionInfo {
+    sessionId: string;
+    title?: string;
+    traceId?: string;
+}
+export interface ZcodeCreateResult {
+    session: ZcodeSessionInfo;
+}
+export interface ZcodeSessionListItem {
+    sessionId: string;
+    workspace?: {
+        workspacePath?: string;
+    };
+    title?: string;
+    updatedAt?: number;
+}
+export interface ZcodeListResult {
+    sessions: ZcodeSessionListItem[];
+}
+export type ZcodeEventType = "turn.started" | "model.streaming" | "tool.updated" | "turn.completed" | "turn.failed" | "session.updated";
+export interface ZcodeEvent {
+    sessionId: string;
+    seq: number;
+    type: ZcodeEventType;
+    payload: Record<string, unknown>;
+}
+export interface ZcodeSubscribeResult {
+    eventSeq: number;
+    snapshot?: ZcodeSnapshot;
+}
+export interface ZcodeSnapshot {
+    projection?: ZcodeProjection;
+    messages?: ZcodeMessage[];
+    todos?: unknown[];
+}
+export interface ZcodeProjection {
+    status?: string;
+    contextUsed?: number;
+    contextWindow?: number;
+    totalTokenCount?: number;
+}
+export interface ZcodeMessage {
+    info: {
+        id?: string;
+        role: "user" | "assistant" | "system";
+    };
+    parts: ZcodeMessagePart[];
+}
+export type ZcodeMessagePart = {
+    type: "text";
+    text: string;
+} | {
+    type: "reasoning";
+    text?: string;
+    content?: string;
+} | {
+    type: "tool";
+    callID?: string;
+    callId?: string;
+    tool?: string;
+    state?: Record<string, unknown>;
+} | {
+    type: "patch";
+    hash?: string;
+    files?: string[];
+} | {
+    type: string;
+    [key: string]: unknown;
+};
+export interface ZcodeMessagesResult {
+    messages: ZcodeMessage[];
+}
+export interface ZcodeReadResult {
+    projection?: ZcodeProjection;
+    settings?: Record<string, unknown>;
+    todos?: unknown[];
+    todoGroups?: Array<{
+        entries?: unknown[];
+        todos?: unknown[];
+    }>;
+}
+export interface ZcodeInteractionPermissionParams {
+    requestId: string;
+    sessionId: string;
+    toolCallId: string;
+    toolName?: string;
+    reason?: string;
+    riskLevel?: string;
+    input?: unknown;
+    options?: Array<{
+        optionId: string;
+        kind: string;
+        name: string;
+        response?: unknown;
+    }>;
+}
+export interface ZcodeInteractionUserInputParams {
+    requestId: string;
+    sessionId: string;
+    toolCallId?: string;
+    toolName?: string;
+    prompt?: string;
+    questions?: Array<{
+        header?: string;
+        question: string;
+        multiSelect?: boolean;
+        options?: Array<{
+            label?: string;
+            value?: string;
+            description?: string;
+        }>;
+    }>;
+    input?: {
+        questions?: ZcodeInteractionUserInputParams["questions"];
+    };
+    schema?: {
+        interaction?: string;
+        toolName?: string;
+    };
+}
+/** The response we send back to a ZCode server→client request. */
+export type ZcodeInteractionResponse = {
+    decision: "allow" | "deny" | "escalate" | "modify";
+    reason?: string;
+    modifiedInput?: unknown;
+} | {
+    action: "accept" | "decline" | "cancel";
+    content?: unknown;
+    reason?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/backend/types.d.ts.map

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

package/dist/backend/types.js

@@ -0,0 +1,15 @@
+/**
+ * ZCode app-server protocol type definitions.
+ *
+ * ZCode speaks a line-delimited JSON protocol over stdio. It is JSON-RPC-like
+ * but deliberately omits the `jsonrpc` field. Messages are classified by the
+ * presence of `id` and `method`:
+ *   - id + no method        → response to a request we sent
+ *   - id + method           → either our response (id registered) or a server→client request
+ *   - method + no id        → notification (e.g. `session/event`)
+ *
+ * Only the fields we actually consume are typed; the rest pass through as
+ * `unknown`/`Record<string, unknown>` to stay resilient to ZCode schema drift.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/backend/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/backend/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/config/model-cache.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Session-level model cache + initial usage emission.
+ *
+ * `currentModelCached` avoids a `session/read` round-trip on every usage_update
+ * (a high-frequency path). `emitInitialUsage` sends one usage_update right
+ * after resume/load so the editor shows the context bar immediately (only when
+ * there's actual token data — resume before any turn has 0, which we skip).
+ */
+import type * as acp from "@agentclientprotocol/sdk";
+import type { ZcodeAcpServer } from "../server.js";
+import type { ProjectionDiffer } from "../translators/projection-differ.js";
+/** Read the session's current model id, with a per-session cache. */
+export declare function currentModelCached(server: ZcodeAcpServer, zcodeSid: string): Promise<string>;
+/**
+ * Emit an initial usage_update after resume/load so the editor shows the
+ * context bar. Skips when there's no token data (resume before any turn → 0).
+ * Also syncs the differ's usage baseline so the first turn won't re-emit it.
+ */
+export declare function emitInitialUsage(server: ZcodeAcpServer, cx: acp.AgentContext, acpSid: string, zcodeSid: string, differ: ProjectionDiffer | undefined): Promise<void>;
+//# sourceMappingURL=model-cache.d.ts.map

package/dist/config/model-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-cache.d.ts","sourceRoot":"","sources":["../../src/config/model-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAKrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,qEAAqE;AACrE,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,EAAE,EAAE,GAAG,CAAC,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/config/model-cache.js

@@ -0,0 +1,62 @@
+/**
+ * Session-level model cache + initial usage emission.
+ *
+ * `currentModelCached` avoids a `session/read` round-trip on every usage_update
+ * (a high-frequency path). `emitInitialUsage` sends one usage_update right
+ * after resume/load so the editor shows the context bar immediately (only when
+ * there's actual token data — resume before any turn has 0, which we skip).
+ */
+import { modelContextWindow } from "./options.js";
+import { log } from "../utils.js";
+import { dispatchEvent } from "../handlers/dispatch.js";
+/** Read the session's current model id, with a per-session cache. */
+export async function currentModelCached(server, zcodeSid) {
+    const cached = server.modelCache.get(zcodeSid);
+    if (cached)
+        return cached;
+    let modelId = "GLM-5.2";
+    try {
+        const read = await sessionRead(server, zcodeSid);
+        const settings = (read.settings ?? {});
+        const cur = settings.model?.current;
+        if (cur?.modelId)
+            modelId = cur.modelId;
+    }
+    catch (e) {
+        log(`model-cache: session/read failed (${e instanceof Error ? e.message : String(e)})`);
+    }
+    server.modelCache.set(zcodeSid, modelId);
+    return modelId;
+}
+/**
+ * Emit an initial usage_update after resume/load so the editor shows the
+ * context bar. Skips when there's no token data (resume before any turn → 0).
+ * Also syncs the differ's usage baseline so the first turn won't re-emit it.
+ */
+export async function emitInitialUsage(server, cx, acpSid, zcodeSid, differ) {
+    try {
+        const read = await sessionRead(server, zcodeSid);
+        const proj = (read.projection ?? {});
+        // `||` (not `??`): an explicit contextUsed=0 is falsy and should fall back
+        // to totalTokenCount, matching Python's `proj.get("contextUsed",0) or ...`.
+        const used = proj.contextUsed || proj.totalTokenCount || 0;
+        if (!used)
+            return; // resume before any turn: skip to avoid showing 0.
+        let size = proj.contextWindow ?? 0;
+        if (!size)
+            size = modelContextWindow(await currentModelCached(server, zcodeSid));
+        await dispatchEvent(server, cx, acpSid, { kind: "UsageDelta", used, size }, `init_${zcodeSid.slice(0, 8)}`);
+        differ?.setLastUsage(used);
+    }
+    catch (e) {
+        log(`model-cache: emit_initial_usage failed (${e instanceof Error ? e.message : String(e)})`);
+    }
+}
+async function sessionRead(server, zcodeSid) {
+    const backend = server.ensureBackend();
+    const resp = await backend.request(server.nextId(), "session/read", { sessionId: zcodeSid }, 5000);
+    if (resp.error)
+        throw new Error(resp.error.message);
+    return (resp.result ?? {});
+}
+//# sourceMappingURL=model-cache.js.map

package/dist/config/model-cache.js.map

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

package/dist/config/options.d.ts

@@ -0,0 +1,36 @@
+/**
+ * configOptions + modes construction and session/set_config_option dispatch.
+ *
+ * Reads `session/read` `settings.*` for current values (NOT projection.mode,
+ * which is a zombie value), with config.json fallbacks for the model list.
+ * set_config_option: mode/thought forward to setMode/setThoughtLevel; model
+ * routes through `runtimeModel` (runtime-model.ts) because the backend rejects
+ * the persistence path. After a change, re-builds the option and emits a
+ * `config_option_update` (+ `current_mode_update` for mode) so the editor UI
+ * reflects the new state.
+ */
+import type * as acp from "@agentclientprotocol/sdk";
+import type { ZcodeAcpServer } from "../server.js";
+/** Read the model id list for the enabled provider from config.json. */
+export declare function loadProviderModels(): string[];
+/** Read the context-window size for a model from config.json (limit.context). */
+export declare function modelContextWindow(modelId: string): number;
+/** Build the ACP SessionModeState ({currentModeId, availableModes}). */
+export declare function buildModes(server: ZcodeAcpServer, zcodeSid: string): Promise<acp.SessionModeState>;
+/** Build the ACP configOptions array (3 items: model/mode/thought). */
+export declare function buildConfigOptions(server: ZcodeAcpServer, zcodeSid: string): Promise<acp.SessionConfigOption[]>;
+/**
+ * Dispatch session/set_config_option. mode/thought forward to setMode/
+ * setThoughtLevel; model routes through applyModelSwitch (runtime-model.ts).
+ *
+ * Returns `{ kind, currentValue, options }` so the caller can emit the update
+ * notifications, or null when the configId is unknown / model switch fails.
+ */
+export declare function setConfigOption(server: ZcodeAcpServer, zcodeSid: string, configId: string, value: string): Promise<{
+    kind: "model" | "mode" | "thought";
+    currentValue: string;
+} | null>;
+/** Emit a config_option_update (+ current_mode_update for mode) after a change.
+ *  Returns the rebuilt options so the caller can include them in the response. */
+export declare function emitConfigOptionUpdate(server: ZcodeAcpServer, cx: acp.AgentContext, acpSid: string, zcodeSid: string, kind: "model" | "mode" | "thought"): Promise<acp.SessionConfigOption[]>;
+//# sourceMappingURL=options.d.ts.map

package/dist/config/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/config/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAIrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAgBnD,wEAAwE;AACxE,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAS7C;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAS1D;AAED,wEAAwE;AACxE,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAc/B;AAED,uEAAuE;AACvE,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC,CAyDpC;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAkB9E;AAED;kFACkF;AAClF,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,cAAc,EACtB,EAAE,EAAE,GAAG,CAAC,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GACjC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC,CAcpC"}