zcode-acp-server 0.1.0

package/dist/handlers/extensions.js

@@ -0,0 +1,310 @@
+/**
+ * ZCode-specific session method handlers (non-standard ACP extensions).
+ *
+ * Thin passthroughs for the extended session/* methods (0.14.8+):
+ * fork/rewind/rewindCascade/goal/compact/steer/cancelBackgroundTask +
+ * 0.15.0+: setThoughtLevel/updateRuntimeModelConfig/setModel/setMode.
+ *
+ * These share a near-identical shape (resolve sid → build params → forward →
+ * check error). Only the genuine per-method differences are spelled out:
+ * fork's new sid mapping, compact/goal(set)'s internal-turn lock wait, and
+ * setModel rerouting through updateRuntimeModelConfig.
+ */
+import { emitInitialUsage } from "../config/model-cache.js";
+import { applyModelSwitch } from "../config/runtime-model.js";
+import { buildConfigOptions, buildModes } from "../config/options.js";
+import { ProjectionDiffer } from "../translators/projection-differ.js";
+import { log, warn } from "../utils.js";
+import { sendSessionUpdate } from "./io.js";
+/** Build the zcode `target` object from ACP params (checkpoint or latest). */
+function buildCheckpointTarget(params) {
+    if (params.checkpointId)
+        return { kind: "checkpoint", checkpointId: params.checkpointId };
+    if (params.target)
+        return params.target;
+    return { kind: "latestCheckpoint" };
+}
+/** Resolve zcode sid from ACP params; throw if unknown. */
+function resolveSidOrThrow(server, params) {
+    const sid = server.resolveSid(params.sessionId);
+    if (!sid)
+        throw new Error(`session ${params.sessionId} not found`);
+    return sid;
+}
+/** session/fork → zcode session/fork: branch a new session from a checkpoint. */
+export async function fork(server, params) {
+    const zcodeSid = resolveSidOrThrow(server, params);
+    const backend = server.ensureBackend();
+    const resp = await backend.request(server.nextId(), "session/fork", { sessionId: zcodeSid, target: buildCheckpointTarget(params) }, 15000);
+    if (resp.error)
+        throw new Error(`fork failed: ${resp.error.message}`);
+    const result = (resp.result ?? {});
+    if (result.sessionId)
+        server.sessionMap.set(result.sessionId, result.sessionId);
+    log(`session/fork → ${result.sessionId ?? "?"}`);
+    return result;
+}
+/** session/rewind → zcode session/rewind: restore workspace files to a checkpoint. */
+export async function rewind(server, params) {
+    const zcodeSid = resolveSidOrThrow(server, params);
+    const zcParams = {
+        sessionId: zcodeSid,
+        target: buildCheckpointTarget(params),
+    };
+    if (params.expectedRevision !== undefined)
+        zcParams.expectedRevision = params.expectedRevision;
+    const resp = await server
+        .ensureBackend()
+        .request(server.nextId(), "session/rewind", zcParams, 15000);
+    if (resp.error)
+        throw new Error(`rewind failed: ${resp.error.message}`);
+    log("session/rewind → ok");
+    return (resp.result ?? {});
+}
+/** session/rewindCascade → zcode session/rewindCascade: cascade rewind. */
+export async function rewindCascade(server, params) {
+    const zcodeSid = resolveSidOrThrow(server, params);
+    const zcParams = {
+        sessionId: zcodeSid,
+        target: buildCheckpointTarget(params),
+    };
+    if (params.scope)
+        zcParams.scope = params.scope;
+    if (params.expectedRevision !== undefined)
+        zcParams.expectedRevision = params.expectedRevision;
+    const resp = await server
+        .ensureBackend()
+        .request(server.nextId(), "session/rewindCascade", zcParams, 15000);
+    if (resp.error)
+        throw new Error(`rewindCascade failed: ${resp.error.message}`);
+    log("session/rewindCascade → ok");
+    return (resp.result ?? {});
+}
+/** session/goal → zcode session/goal: read/set/replace/clear/pause/resume the goal. */
+export async function goal(server, params) {
+    const zcodeSid = resolveSidOrThrow(server, params);
+    const action = params.action ?? "show";
+    const zcParams = { sessionId: zcodeSid, action };
+    if ((action === "set" || action === "replace") && params.objective !== undefined) {
+        zcParams.objective = params.objective;
+    }
+    const resp = await server
+        .ensureBackend()
+        .request(server.nextId(), "session/goal", zcParams, 15000);
+    if (resp.error)
+        throw new Error(`goal failed: ${resp.error.message}`);
+    // set/replace start an internal AI turn → wait for the prompt lock to release.
+    if (action === "set" || action === "replace") {
+        // timeout is in MILLISECONDS here (Date.now()-based), not seconds — Python's
+        // timeout=60 becomes 60000. A bare 60 would expire on the first probe.
+        const released = await waitForTurnIdle(server, zcodeSid, 60_000, "session/goal", false);
+        if (released) {
+            log(`session/goal action=${action} → ok (lock released)`);
+        }
+        else {
+            warn(`session/goal action=${action} → ⚠ lock wait timeout`);
+        }
+    }
+    else {
+        log(`session/goal action=${action} → ok`);
+    }
+    return (resp.result ?? {});
+}
+/** session/compact → zcode session/compact + wait for the internal AI turn. */
+export async function compact(server, params, cx) {
+    const acpSid = params.sessionId;
+    const zcodeSid = resolveSidOrThrow(server, params);
+    const resp = await server
+        .ensureBackend()
+        .request(server.nextId(), "session/compact", { sessionId: zcodeSid }, 30000);
+    if (resp.error)
+        throw new Error(`compact failed: ${resp.error.message}`);
+    // compact's internal AI turn (read history → LLM compress → write back) can
+    // take minutes; expectLock=true avoids the startup-delay false-success window.
+    // timeout is in MILLISECONDS (Date.now()-based), not seconds — Python's
+    // timeout=300 becomes 300000. A bare 300 expires on the first probe sleep,
+    // making compact return "✓" while the internal turn lock is still held.
+    const released = await waitForTurnIdle(server, zcodeSid, 300_000, "session/goal", true);
+    if (released) {
+        log("session/compact → ok (lock released)");
+    }
+    else {
+        warn("session/compact → ⚠ lock wait timeout (backend may still be compacting)");
+    }
+    if (released) {
+        // Refresh usage so the UI reflects the reduced contextUsed post-compact.
+        // Ensure a differ exists (compact may be the first action on a fresh session)
+        // and sync its usage baseline so the next turn won't re-emit the same value.
+        let differ = server.differs.get(zcodeSid);
+        if (!differ) {
+            differ = new ProjectionDiffer();
+            server.differs.set(zcodeSid, differ);
+        }
+        await emitInitialUsage(server, cx, acpSid, zcodeSid, differ);
+    }
+    // Surface the lock-timeout to the slash-command path so it can warn the user
+    // (the ACP method path ignores this non-standard flag). Mirrors Python's
+    // "⚠ 压缩超时" branch in _handle_slash_command.
+    return { ...(resp.result ?? {}), __lockTimeout: !released };
+}
+/** session/steer → zcode session/steer: append instructions to a running turn. */
+export async function steer(server, params) {
+    const zcodeSid = resolveSidOrThrow(server, params);
+    const content = String(params.content ?? "");
+    if (!content.trim())
+        throw new Error("steer requires content");
+    const resp = await server
+        .ensureBackend()
+        .request(server.nextId(), "session/steer", { sessionId: zcodeSid, content }, 15000);
+    if (resp.error)
+        throw new Error(`steer failed: ${resp.error.message}`);
+    const result = (resp.result ?? {});
+    log(`session/steer → kind=${result.kind ?? "?"}`);
+    return result;
+}
+/** session/cancelBackgroundTask → zcode session/cancelBackgroundTask. */
+export async function cancelBackgroundTask(server, params) {
+    const zcodeSid = resolveSidOrThrow(server, params);
+    const taskId = params.taskId;
+    if (!taskId)
+        throw new Error("cancelBackgroundTask requires taskId");
+    const resp = await server
+        .ensureBackend()
+        .request(server.nextId(), "session/cancelBackgroundTask", { sessionId: zcodeSid, taskId }, 15000);
+    if (resp.error)
+        throw new Error(`cancelBackgroundTask failed: ${resp.error.message}`);
+    log(`session/cancelBackgroundTask → cancelled=${resp.result?.cancelled}`);
+    return (resp.result ?? {});
+}
+/** session/setThoughtLevel → zcode session/setThoughtLevel. */
+export async function setThoughtLevel(server, params) {
+    const zcodeSid = resolveSidOrThrow(server, params);
+    const thoughtLevel = params.thoughtLevel;
+    if (!thoughtLevel)
+        throw new Error("setThoughtLevel requires thoughtLevel");
+    const resp = await server
+        .ensureBackend()
+        .request(server.nextId(), "session/setThoughtLevel", { sessionId: zcodeSid, thoughtLevel }, 15000);
+    if (resp.error)
+        throw new Error(`setThoughtLevel failed: ${resp.error.message}`);
+    log("session/setThoughtLevel → ok");
+    return (resp.result ?? {});
+}
+/** session/updateRuntimeModelConfig → same: runtime overlay of session model config. */
+export async function updateRuntimeModelConfig(server, params) {
+    const zcodeSid = resolveSidOrThrow(server, params);
+    const runtimeModel = params.runtimeModel;
+    if (!runtimeModel)
+        throw new Error("updateRuntimeModelConfig requires runtimeModel");
+    const zcParams = { sessionId: zcodeSid, runtimeModel };
+    if (params.applyModelSelection !== undefined)
+        zcParams.applyModelSelection = params.applyModelSelection;
+    const resp = await server
+        .ensureBackend()
+        .request(server.nextId(), "session/updateRuntimeModelConfig", zcParams, 15000);
+    if (resp.error)
+        throw new Error(`updateRuntimeModelConfig failed: ${resp.error.message}`);
+    log("session/updateRuntimeModelConfig → ok");
+    return (resp.result ?? {});
+}
+/** session/setModel → applyModelSwitch (runtime overlay, not persistence). */
+export async function setModel(server, params) {
+    const zcodeSid = resolveSidOrThrow(server, params);
+    const modelId = params.modelId;
+    if (!modelId)
+        throw new Error("setModel requires modelId");
+    const ok = await applyModelSwitch(server, zcodeSid, modelId);
+    if (!ok)
+        throw new Error("setModel failed (model switch rejected)");
+    log(`session/setModel → ${modelId} (updateRuntimeModelConfig)`);
+    return {};
+}
+/** session/setMode → zcode session/setMode + emit config_option/current_mode updates. */
+export async function setMode(server, params, cx) {
+    const acpSid = params.sessionId;
+    const zcodeSid = resolveSidOrThrow(server, params);
+    const mode = params.mode;
+    if (!mode)
+        throw new Error("setMode requires mode");
+    const resp = await server
+        .ensureBackend()
+        .request(server.nextId(), "session/setMode", { sessionId: zcodeSid, mode }, 15000);
+    if (resp.error)
+        throw new Error(`setMode failed: ${resp.error.message}`);
+    log(`session/setMode → ${mode}`);
+    // Re-build configOptions (settings.mode.current is now updated) and emit
+    // config_option_update + current_mode_update so the editor UI reflects it.
+    const options = await buildConfigOptions(server, zcodeSid);
+    await sendSessionUpdate(cx, acpSid, {
+        sessionUpdate: "config_option_update",
+        configOptions: options,
+    });
+    const modes = await buildModes(server, zcodeSid);
+    await sendSessionUpdate(cx, acpSid, {
+        sessionUpdate: "current_mode_update",
+        currentModeId: modes.currentModeId,
+    });
+    // Record the advertised mode so the turn-completion reconciliation knows the
+    // client has already been told about this value.
+    server.lastMode.set(acpSid, modes.currentModeId);
+    return (resp.result ?? {});
+}
+/**
+ * Wait for a zcode session's internal AI turn to release its prompt lock.
+ *
+ * `session/goal(set)` and `session/compact` start an internal AI turn that
+ * keeps running after the request() response. projection.status=idle does NOT
+ * mean the lock is released (goal set often shows idle quickly while the lock
+ * persists 10-25s). The reliable check: retry a probe call (goal show) until it
+ * no longer reports "prompt is running".
+ *
+ * `expectLock` (compact): compact's turn has a startup delay — at this moment
+ * the lock isn't held yet, so a probe succeeds immediately (false "released").
+ * With expectLock=true, we first require observing "prompt is running" once
+ * (proving the turn truly started) before trusting a later success.
+ */
+async function waitForTurnIdle(server, zcodeSid, timeoutMs, probeMethod, expectLock) {
+    const backend = server.ensureBackend();
+    const t0 = Date.now();
+    let lockSeen = !expectLock;
+    let probeCount = 0;
+    log(`  [probe] start waitForTurnIdle timeout=${Math.round(timeoutMs / 1000)}s expectLock=${expectLock} probeMethod=${probeMethod}`);
+    while (Date.now() - t0 < timeoutMs) {
+        probeCount++;
+        const elapsed = Math.round((Date.now() - t0) / 100) / 10;
+        const resp = await backend.request(server.nextId(), probeMethod, { sessionId: zcodeSid, action: "show" }, 10000);
+        const errMsg = resp.error?.message ?? "";
+        if (errMsg.includes("prompt is running")) {
+            log(`  [probe] #${probeCount} @${elapsed}s: LOCK HELD ("${errMsg.slice(0, 60)}") → lockSeen=true`);
+            lockSeen = true;
+            await sleep(2000);
+            continue;
+        }
+        if (errMsg.toLowerCase().includes("timeout")) {
+            log(`  [probe] #${probeCount} @${elapsed}s: probe timeout, continue`);
+            await sleep(2000);
+            continue;
+        }
+        if (resp.error) {
+            if (lockSeen) {
+                log(`  [probe] #${probeCount} @${elapsed}s: NON-LOCK error after lock → released (err="${errMsg.slice(0, 50)}")`);
+                return true;
+            }
+            log(`  [probe] #${probeCount} @${elapsed}s: NON-LOCK error, lockSeen=false → wait for lock (err="${errMsg.slice(0, 50)}")`);
+            await sleep(500);
+            continue;
+        }
+        if (lockSeen) {
+            log(`  [probe] #${probeCount} @${elapsed}s: probe success after lock → released`);
+            return true;
+        }
+        log(`  [probe] #${probeCount} @${elapsed}s: probe success, lockSeen=false → wait for lock (still in startup window)`);
+        await sleep(500);
+    }
+    log(`  [probe] wait timed out (${Math.round(timeoutMs / 1000)}s), lock may still be held`);
+    return false;
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=extensions.js.map

package/dist/handlers/extensions.js.map

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

package/dist/handlers/io.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ACP client I/O helpers — thin wrappers over the AgentContext (cx) that the
+ * ACP SDK passes to each handler.
+ *
+ * The SDK exposes `cx.notify(method, params)` and `cx.request(method, params)`;
+ * these helpers name the common notifications/requests we send and centralise
+ * the JSON shape so handlers stay readable.
+ */
+import type * as acp from "@agentclientprotocol/sdk";
+import type { ZcodeAcpServer } from "../server.js";
+/** Send a `session/update` notification to the client. */
+export declare function sendSessionUpdate(cx: acp.AgentContext, sessionId: string, update: acp.SessionUpdate): Promise<void>;
+/** Send an `agent_message_chunk` text notification. */
+export declare function sendTextChunk(cx: acp.AgentContext, sessionId: string, text: string, messageId: string): Promise<void>;
+/** Shape of a slash command entry (matches ACP's AvailableCommand). */
+interface SlashCommandEntry {
+    name: string;
+    description: string;
+    input?: {
+        hint: string;
+    };
+}
+/** Send an `available_commands_update` notification listing our slash commands. */
+export declare function sendAvailableCommands(cx: acp.AgentContext, sessionId: string, commands: ReadonlyArray<SlashCommandEntry>): Promise<void>;
+/**
+ * Send `available_commands_update` after a short delay so it lands after the
+ * session response. ACP clients initialize their session state machine on the
+ * response; a notification arriving earlier can be dropped, leaving the `/`
+ * completion menu empty. Mirrors the Python bridge's deferred-notification
+ * queue + 50ms drain. Fire-and-forget (returns void).
+ */
+export declare function sendAvailableCommandsDeferred(cx: acp.AgentContext, sessionId: string, commands: ReadonlyArray<SlashCommandEntry>): void;
+/** Throw a JSON-RPC error from a handler (the SDK converts it to an error response). */
+export declare function throwError(code: number, message: string): never;
+/** Server instance attached to the running agent (set by index.ts on connect). */
+export interface ServerHolder {
+    server: ZcodeAcpServer;
+}
+export {};
+//# sourceMappingURL=io.d.ts.map

package/dist/handlers/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/handlers/io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAGrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,GAAG,CAAC,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,GAAG,CAAC,aAAa,GACxB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAC3B,EAAE,EAAE,GAAG,CAAC,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,uEAAuE;AACvE,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1B;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,GAAG,CAAC,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,EAAE,EAAE,GAAG,CAAC,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,GACzC,IAAI,CAMN;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAE/D;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,cAAc,CAAC;CACxB"}

package/dist/handlers/io.js

@@ -0,0 +1,55 @@
+/**
+ * ACP client I/O helpers — thin wrappers over the AgentContext (cx) that the
+ * ACP SDK passes to each handler.
+ *
+ * The SDK exposes `cx.notify(method, params)` and `cx.request(method, params)`;
+ * these helpers name the common notifications/requests we send and centralise
+ * the JSON shape so handlers stay readable.
+ */
+import { RequestError } from "@agentclientprotocol/sdk";
+/** Send a `session/update` notification to the client. */
+export function sendSessionUpdate(cx, sessionId, update) {
+    return cx.notify("session/update", { sessionId, update });
+}
+/** Send an `agent_message_chunk` text notification. */
+export function sendTextChunk(cx, sessionId, text, messageId) {
+    return sendSessionUpdate(cx, sessionId, {
+        sessionUpdate: "agent_message_chunk",
+        content: { type: "text", text },
+        messageId,
+    });
+}
+/** Send an `available_commands_update` notification listing our slash commands. */
+export function sendAvailableCommands(cx, sessionId, commands) {
+    return sendSessionUpdate(cx, sessionId, {
+        sessionUpdate: "available_commands_update",
+        availableCommands: commands.map((c) => {
+            const out = {
+                name: c.name,
+                description: c.description,
+            };
+            if (c.input)
+                out.input = c.input;
+            return out;
+        }),
+    });
+}
+/**
+ * Send `available_commands_update` after a short delay so it lands after the
+ * session response. ACP clients initialize their session state machine on the
+ * response; a notification arriving earlier can be dropped, leaving the `/`
+ * completion menu empty. Mirrors the Python bridge's deferred-notification
+ * queue + 50ms drain. Fire-and-forget (returns void).
+ */
+export function sendAvailableCommandsDeferred(cx, sessionId, commands) {
+    const t = setTimeout(() => {
+        void sendAvailableCommands(cx, sessionId, commands);
+    }, 50);
+    // unref so shutdown is not held up by this deferred notification.
+    t.unref?.();
+}
+/** Throw a JSON-RPC error from a handler (the SDK converts it to an error response). */
+export function throwError(code, message) {
+    throw new RequestError(code, message);
+}
+//# sourceMappingURL=io.js.map

package/dist/handlers/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/handlers/io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAC/B,EAAoB,EACpB,SAAiB,EACjB,MAAyB;IAEzB,OAAO,EAAE,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,aAAa,CAC3B,EAAoB,EACpB,SAAiB,EACjB,IAAY,EACZ,SAAiB;IAEjB,OAAO,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE;QACtC,aAAa,EAAE,qBAAqB;QACpC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QAC/B,SAAS;KACV,CAAC,CAAC;AACL,CAAC;AASD,mFAAmF;AACnF,MAAM,UAAU,qBAAqB,CACnC,EAAoB,EACpB,SAAiB,EACjB,QAA0C;IAE1C,OAAO,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE;QACtC,aAAa,EAAE,2BAA2B;QAC1C,iBAAiB,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACpC,MAAM,GAAG,GAAoE;gBAC3E,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;aAC3B,CAAC;YACF,IAAI,CAAC,CAAC,KAAK;gBAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;YACjC,OAAO,GAAG,CAAC;QACb,CAAC,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,EAAoB,EACpB,SAAiB,EACjB,QAA0C;IAE1C,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE;QACxB,KAAK,qBAAqB,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,kEAAkE;IAClE,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;AACd,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAe;IACtD,MAAM,IAAI,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC"}

package/dist/handlers/server-requests.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Handle zcode-initiated server→client requests during a turn.
+ *
+ * ZCode's interaction broker dispatches three request kinds, all bridged onto
+ * ACP `session/requestPermission` (Zed supports it natively; elicitation is
+ * not supported):
+ *   - interaction/requestPermission (tool auth)       → direct option mapping
+ *   - interaction/requestUserInput (ExitPlanMode)     → approve/reject options
+ *   - interaction/requestUserInput (AskUserQuestion)  → per-question popups
+ *     (single-select: one popup; multi-select: per-option Include/Skip)
+ *
+ * Reannounce dedup: ZCode reannounces unanswered requests every ~1s sharing
+ * the same requestId/toolCallId. The first request forwards to the client;
+ * reannounces either get the cached result (if it arrived) or just record
+ * their zcode id for a later unified reply.
+ */
+import type * as acp from "@agentclientprotocol/sdk";
+import type { ZcodeBackend } from "../backend/client.js";
+import type { ZcodeInteractionResponse } from "../backend/types.js";
+import type { PendingTurn, ZcodeAcpServer } from "../server.js";
+/** A dedup entry tracking reannounced zcode ids + the cached result. */
+interface DedupEntry {
+    zcodeIds: number[];
+    result?: ZcodeInteractionResponse;
+}
+/** Per-server reannounce dedup state (lazy-initialised). */
+export declare function getPendingInteractions(server: ZcodeAcpServer): Map<string, DedupEntry>;
+/**
+ * Drain and handle all pending zcode server→client requests. Returns true if
+ * any were handled (used by the turn loop to refresh the no-progress timer).
+ */
+export declare function handleServerRequests(server: ZcodeAcpServer, backend: ZcodeBackend, cx: acp.AgentContext, acpSid: string, turn?: PendingTurn): Promise<boolean>;
+export {};
+//# sourceMappingURL=server-requests.d.ts.map

package/dist/handlers/server-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-requests.d.ts","sourceRoot":"","sources":["../../src/handlers/server-requests.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAErD,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAEV,wBAAwB,EAEzB,MAAM,qBAAqB,CAAC;AAkB7B,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGhE,wEAAwE;AACxE,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAQtF;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,YAAY,EACrB,EAAE,EAAE,GAAG,CAAC,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,OAAO,CAAC,CAUlB"}