zcode-acp-server 0.1.0

package/dist/config/options.js

@@ -0,0 +1,171 @@
+/**
+ * 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 { readFileSync } from "node:fs";
+import { CONFIG_DISPATCH, CONFIG_META, ZCODE_CREDS_PATH } from "../utils.js";
+import { sendSessionUpdate } from "../handlers/io.js";
+/** Read the config.json contents (UTF-8). Throws on read/parse failure. */
+function readConfig() {
+    return JSON.parse(readFileSync(ZCODE_CREDS_PATH, "utf8"));
+}
+/** Read the model id list for the enabled provider from config.json. */
+export function loadProviderModels() {
+    try {
+        const cfg = readConfig();
+        const models = cfg.provider?.["builtin:bigmodel-coding-plan"]?.models ?? {};
+        const keys = Object.keys(models);
+        return keys.length > 0 ? keys : ["GLM-5.2"];
+    }
+    catch {
+        return ["GLM-5.2"];
+    }
+}
+/** Read the context-window size for a model from config.json (limit.context). */
+export function modelContextWindow(modelId) {
+    try {
+        const cfg = readConfig();
+        const models = cfg.provider?.["builtin:bigmodel-coding-plan"]?.models ?? {};
+        const entry = models[modelId];
+        return entry?.limit?.context ?? 0;
+    }
+    catch {
+        return 0;
+    }
+}
+/** Build the ACP SessionModeState ({currentModeId, availableModes}). */
+export async function buildModes(server, zcodeSid) {
+    let currentMode = "yolo";
+    try {
+        const read = await sessionRead(server, zcodeSid);
+        const settings = (read.settings ?? {});
+        const modeSet = settings.mode ?? {};
+        currentMode = modeSet.current ?? currentMode;
+    }
+    catch {
+        // keep default
+    }
+    return {
+        currentModeId: currentMode,
+        availableModes: ["plan", "build", "edit", "yolo"].map((m) => ({ id: m, name: capitalize(m) })),
+    };
+}
+/** Build the ACP configOptions array (3 items: model/mode/thought). */
+export async function buildConfigOptions(server, zcodeSid) {
+    let currentModel = "GLM-5.2";
+    let currentMode = "build";
+    let currentThought = "high";
+    let thoughtOptions = null;
+    try {
+        const read = await sessionRead(server, zcodeSid);
+        const settings = (read.settings ?? {});
+        const modeSet = settings.mode ?? {};
+        currentMode = modeSet.current ?? currentMode;
+        const modelSet = settings.model ?? {};
+        const cur = modelSet.current ?? {};
+        if (cur.modelId)
+            currentModel = cur.modelId;
+        const tlSet = settings.thoughtLevel ?? {};
+        currentThought = tlSet.current ?? currentThought;
+        const tlAvail = tlSet.available ?? [];
+        if (tlAvail.length > 0) {
+            thoughtOptions = tlAvail.map((a) => ({ value: a.value, name: a.label ?? a.value }));
+        }
+    }
+    catch {
+        // keep defaults
+    }
+    // Model options: config.json is authoritative (settings.model.available is incomplete).
+    let modelOptions = loadProviderModels().map((k) => ({ value: k, name: k }));
+    if (!modelOptions.some((o) => o.value === currentModel)) {
+        modelOptions = [{ value: currentModel, name: currentModel }, ...modelOptions];
+    }
+    if (!thoughtOptions)
+        thoughtOptions = [...CONFIG_META.thought.options];
+    return [
+        {
+            id: "model",
+            name: CONFIG_META.model.name,
+            category: "model",
+            type: "select",
+            currentValue: currentModel,
+            options: modelOptions,
+        },
+        {
+            id: "mode",
+            name: CONFIG_META.mode.name,
+            category: "mode",
+            type: "select",
+            currentValue: currentMode,
+            options: [...CONFIG_META.mode.options],
+        },
+        {
+            id: "thought",
+            name: CONFIG_META.thought.name,
+            category: "thought",
+            type: "select",
+            currentValue: currentThought,
+            options: thoughtOptions,
+        },
+    ];
+}
+/**
+ * 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 async function setConfigOption(server, zcodeSid, configId, value) {
+    if (configId === "model") {
+        const { applyModelSwitch } = await import("./runtime-model.js");
+        const ok = await applyModelSwitch(server, zcodeSid, value);
+        if (!ok)
+            return null;
+        return { kind: "model", currentValue: value };
+    }
+    const dispatch = CONFIG_DISPATCH[configId];
+    if (!dispatch)
+        return null;
+    const backend = server.ensureBackend();
+    const resp = await backend.request(server.nextId(), dispatch.method, { sessionId: zcodeSid, [dispatch.paramKey]: value }, 15000);
+    if (resp.error)
+        return null;
+    return { kind: configId, currentValue: value };
+}
+/** 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 async function emitConfigOptionUpdate(server, cx, acpSid, zcodeSid, kind) {
+    const options = await buildConfigOptions(server, zcodeSid);
+    await sendSessionUpdate(cx, acpSid, {
+        sessionUpdate: "config_option_update",
+        configOptions: options,
+    });
+    if (kind === "mode") {
+        const modes = await buildModes(server, zcodeSid);
+        await sendSessionUpdate(cx, acpSid, {
+            sessionUpdate: "current_mode_update",
+            currentModeId: modes.currentModeId,
+        });
+    }
+    return options;
+}
+// ---------- helpers ----------
+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 ?? {});
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=options.js.map

package/dist/config/options.js.map

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

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

@@ -0,0 +1,33 @@
+/**
+ * runtimeModel overlay plumbing.
+ *
+ * The backend resolves auth from its OAuth token store, so the `runtimeModel`
+ * provider deliberately carries NO `apiKey` (the config.json apiKey is the
+ * legacy plain key and has expired → 401). Two uses:
+ *
+ *   1. Resume overlay (`buildResumeRuntimeModel`): a resumed session may carry
+ *      a stale provider id in its history that the backend can no longer
+ *      authenticate. Sending the *current* enabled provider's runtimeModel at
+ *      resume makes the backend overlay it and use its own OAuth creds.
+ *
+ *   2. Model switch (`applyModelSwitch`): UI/slash model switching goes through
+ *      `session/updateRuntimeModelConfig` with `applyModelSelection:true` (a
+ *      runtime-only change, sidestepping `session/setModel`'s "no loaded config
+ *      file" persistence failure).
+ */
+import type { ZcodeAcpServer } from "../server.js";
+/** Build a runtimeModel overlay object for the enabled provider. */
+export declare function buildRuntimeModel(modelId?: string, revision?: string): unknown | null;
+/** Build the resume-time overlay (current enabled provider, default model). */
+export declare function buildResumeRuntimeModel(): unknown | null;
+/**
+ * Switch a session's model via session/updateRuntimeModelConfig.
+ *
+ * Uses `applyModelSelection:true` so the change applies at runtime without
+ * persistence — sidestepping `session/setModel`'s "no loaded config file"
+ * failure. Invalidates the model cache on success. Returns true on success.
+ */
+export declare function applyModelSwitch(server: ZcodeAcpServer, zcodeSid: string, modelId: string): Promise<boolean>;
+/** Invalidate the session-level model cache after a switch. */
+export declare function invalidateModelCache(server: ZcodeAcpServer, zcodeSid: string): void;
+//# sourceMappingURL=runtime-model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-model.d.ts","sourceRoot":"","sources":["../../src/config/runtime-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAoDnD,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,SAAW,GAAG,OAAO,GAAG,IAAI,CAcvF;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,IAAI,OAAO,GAAG,IAAI,CAExD;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAmBlB;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEnF"}

package/dist/config/runtime-model.js

@@ -0,0 +1,96 @@
+/**
+ * runtimeModel overlay plumbing.
+ *
+ * The backend resolves auth from its OAuth token store, so the `runtimeModel`
+ * provider deliberately carries NO `apiKey` (the config.json apiKey is the
+ * legacy plain key and has expired → 401). Two uses:
+ *
+ *   1. Resume overlay (`buildResumeRuntimeModel`): a resumed session may carry
+ *      a stale provider id in its history that the backend can no longer
+ *      authenticate. Sending the *current* enabled provider's runtimeModel at
+ *      resume makes the backend overlay it and use its own OAuth creds.
+ *
+ *   2. Model switch (`applyModelSwitch`): UI/slash model switching goes through
+ *      `session/updateRuntimeModelConfig` with `applyModelSelection:true` (a
+ *      runtime-only change, sidestepping `session/setModel`'s "no loaded config
+ *      file" persistence failure).
+ */
+import { readFileSync } from "node:fs";
+import { ZCODE_CREDS_PATH, log, warn } from "../utils.js";
+const DEFAULTS = {
+    providerId: "builtin:bigmodel-coding-plan",
+    kind: "anthropic",
+    baseURL: "https://open.bigmodel.cn/api/anthropic",
+    modelId: "GLM-5.2",
+    models: ["GLM-5.2"],
+};
+/** Read the enabled provider's config from config.json (no apiKey). */
+function readEnabledProvider() {
+    try {
+        const cfg = JSON.parse(readFileSync(ZCODE_CREDS_PATH, "utf8"));
+        for (const [pid, p] of Object.entries(cfg.provider ?? {})) {
+            if (p?.enabled) {
+                const opts = p.options ?? {};
+                const modelKeys = Object.keys(p.models ?? {});
+                return {
+                    providerId: pid,
+                    kind: p.kind ?? DEFAULTS.kind,
+                    baseURL: opts.baseURL || DEFAULTS.baseURL,
+                    modelId: modelKeys[0] ?? DEFAULTS.modelId,
+                    models: modelKeys.length > 0 ? modelKeys : DEFAULTS.models,
+                };
+            }
+        }
+    }
+    catch (e) {
+        log(`runtime-model: read config.json failed (${e instanceof Error ? e.message : String(e)})`);
+    }
+    return DEFAULTS;
+}
+/** Build a runtimeModel overlay object for the enabled provider. */
+export function buildRuntimeModel(modelId, revision = "bridge") {
+    const pc = readEnabledProvider();
+    const targetModel = modelId ?? pc.modelId;
+    return {
+        revision,
+        generatedAt: Date.now(),
+        model: { providerId: pc.providerId, modelId: targetModel },
+        provider: {
+            providerId: pc.providerId,
+            kind: pc.kind,
+            baseURL: pc.baseURL,
+            models: pc.models.map((m) => ({ modelId: m })),
+        },
+    };
+}
+/** Build the resume-time overlay (current enabled provider, default model). */
+export function buildResumeRuntimeModel() {
+    return buildRuntimeModel(undefined, "bridge-resume");
+}
+/**
+ * Switch a session's model via session/updateRuntimeModelConfig.
+ *
+ * Uses `applyModelSelection:true` so the change applies at runtime without
+ * persistence — sidestepping `session/setModel`'s "no loaded config file"
+ * failure. Invalidates the model cache on success. Returns true on success.
+ */
+export async function applyModelSwitch(server, zcodeSid, modelId) {
+    const runtimeModel = buildRuntimeModel(modelId, "bridge-switch");
+    if (runtimeModel === null) {
+        log("runtime-model: cannot read provider config (config.json)");
+        return false;
+    }
+    const backend = server.ensureBackend();
+    const resp = await backend.request(server.nextId(), "session/updateRuntimeModelConfig", { sessionId: zcodeSid, runtimeModel, applyModelSelection: true }, 15000);
+    if (resp.error) {
+        warn(`runtime-model: switch failed: ${resp.error.message}`);
+        return false;
+    }
+    invalidateModelCache(server, zcodeSid);
+    return true;
+}
+/** Invalidate the session-level model cache after a switch. */
+export function invalidateModelCache(server, zcodeSid) {
+    server.modelCache.delete(zcodeSid);
+}
+//# sourceMappingURL=runtime-model.js.map

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

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

package/dist/handlers/dispatch.d.ts

@@ -0,0 +1,15 @@
+/**
+ * dispatchEvent — the single funnel that turns an InternalEvent into an ACP
+ * `session/update` notification.
+ *
+ * Each event kind is serialised here so the translation layers stay focused
+ * on producing the internal shape. The Bash terminal-output protocol (the
+ * 2-notification split: terminal_output + terminal_exit) is fully implemented
+ * below in dispatchTerminalUpdate.
+ */
+import type * as acp from "@agentclientprotocol/sdk";
+import type { InternalEvent } from "../translators/types.js";
+import type { ZcodeAcpServer } from "../server.js";
+/** Dispatch one internal event to the ACP client as a session/update. */
+export declare function dispatchEvent(server: ZcodeAcpServer, cx: acp.AgentContext, acpSid: string, ev: InternalEvent, chunkMsgId: string): Promise<void>;
+//# sourceMappingURL=dispatch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/handlers/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAKrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,yEAAyE;AACzE,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,EAAE,EAAE,GAAG,CAAC,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,aAAa,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/handlers/dispatch.js

@@ -0,0 +1,183 @@
+/**
+ * dispatchEvent — the single funnel that turns an InternalEvent into an ACP
+ * `session/update` notification.
+ *
+ * Each event kind is serialised here so the translation layers stay focused
+ * on producing the internal shape. The Bash terminal-output protocol (the
+ * 2-notification split: terminal_output + terminal_exit) is fully implemented
+ * below in dispatchTerminalUpdate.
+ */
+import { randomUUID } from "node:crypto";
+import { currentModelCached } from "../config/model-cache.js";
+import { modelContextWindow } from "../config/options.js";
+import { extractExitCode, TOOL_KIND_MAP } from "../translators/tool-helpers.js";
+import { sendSessionUpdate } from "./io.js";
+/** Dispatch one internal event to the ACP client as a session/update. */
+export async function dispatchEvent(server, cx, acpSid, ev, chunkMsgId) {
+    switch (ev.kind) {
+        case "ToolCallNew":
+            await dispatchToolCallNew(server, cx, acpSid, ev);
+            break;
+        case "ToolCallUpdate":
+            await dispatchToolCallUpdate(server, cx, acpSid, ev);
+            break;
+        case "UsageDelta":
+            await dispatchUsageDelta(server, cx, acpSid, ev);
+            break;
+        case "TextDelta":
+            await sendSessionUpdate(cx, acpSid, {
+                sessionUpdate: "agent_message_chunk",
+                content: { type: "text", text: ev.text },
+                messageId: chunkMsgId,
+            });
+            break;
+        case "ReasoningDelta":
+            await sendSessionUpdate(cx, acpSid, {
+                sessionUpdate: "agent_thought_chunk",
+                content: { type: "text", text: ev.text },
+                messageId: `thought_${chunkMsgId}`,
+            });
+            break;
+        case "PlanUpdate":
+            await sendSessionUpdate(cx, acpSid, {
+                sessionUpdate: "plan",
+                entries: ev.entries,
+            });
+            break;
+        case "FilesChanged":
+            await dispatchFilesChanged(cx, acpSid, ev);
+            break;
+    }
+}
+function dispatchToolCallNew(server, cx, acpSid, ev) {
+    const termSupported = server.supportsTerminalOutput() && (ev.tool === "Bash" || ev.tool === "bash");
+    const meta = { claudeCode: { toolName: ev.tool } };
+    if (termSupported)
+        meta["terminal_info"] = { terminal_id: ev.callId };
+    const update = {
+        sessionUpdate: "tool_call",
+        toolCallId: ev.callId,
+        title: ev.title,
+        kind: (TOOL_KIND_MAP[ev.tool] ?? "other"),
+        status: ev.status,
+        rawInput: ev.input,
+        _meta: meta,
+    };
+    if (termSupported) {
+        update.content = [{ type: "terminal", terminalId: ev.callId }];
+    }
+    else if (ev.diffContent && ev.diffContent.length > 0) {
+        update.content = ev.diffContent;
+    }
+    else if (ev.content && ev.content.length > 0) {
+        update.content = ev.content;
+    }
+    if (ev.locations && ev.locations.length > 0)
+        update.locations = ev.locations;
+    return sendSessionUpdate(cx, acpSid, update);
+}
+function dispatchToolCallUpdate(server, cx, acpSid, ev) {
+    const toolName = ev.tool ?? "";
+    const termSupported = server.supportsTerminalOutput() && (toolName === "Bash" || toolName === "bash");
+    if (termSupported) {
+        // Bash terminal protocol (full 2-notification split arrives in Commit 5).
+        // For now emit the terminal_output data + the standard update with status.
+        return dispatchTerminalUpdate(server, cx, acpSid, ev, toolName);
+    }
+    const update = {
+        sessionUpdate: "tool_call_update",
+        toolCallId: ev.callId,
+        status: ev.status,
+    };
+    const meta = {};
+    if (toolName)
+        meta["claudeCode"] = { toolName };
+    if (ev.output !== undefined)
+        update.rawOutput = ev.output;
+    if (ev.diffContent && ev.diffContent.length > 0) {
+        update.content = ev.diffContent;
+    }
+    else if (ev.content && ev.content.length > 0) {
+        update.content = ev.content;
+    }
+    if (Object.keys(meta).length > 0)
+        update._meta = meta;
+    if (ev.locations && ev.locations.length > 0)
+        update.locations = ev.locations;
+    return sendSessionUpdate(cx, acpSid, update);
+}
+/**
+ * Bash terminal update — the 2-notification split (matches acp-agent.ts:5061-5094
+ * and the Python bridge's _dispatch_event). Zed correlates by terminal_id, so
+ * the two notifications MUST be separate:
+ *   ① terminal_output — pure data, no status/content. Sent on BOTH progress and
+ *      result states (whenever there's data) so live output streams.
+ *   ② terminal_exit — terminal state only: status + content[type:terminal] +
+ *      _meta.terminal_exit (with exitCode) + rawOutput text fallback. Sent ONLY
+ *      on completed/failed.
+ *
+ * Merging them into one notification causes Zed to clear the content once the
+ * turn completes (the original bug); splitting keeps the output visible.
+ */
+async function dispatchTerminalUpdate(_server, cx, acpSid, ev, toolName) {
+    // ① terminal_output (pure data) — progress and result both emit it.
+    let termData = ev.rawOutput ?? ev.rawResult;
+    if (termData && typeof termData === "object" && !Array.isArray(termData)) {
+        termData = termData["content"] ?? "";
+    }
+    if (termData) {
+        await sendSessionUpdate(cx, acpSid, {
+            sessionUpdate: "tool_call_update",
+            toolCallId: ev.callId,
+            _meta: { terminal_output: { terminal_id: ev.callId, data: String(termData) } },
+        });
+    }
+    // ② terminal_exit (terminal state) — only on completed/failed.
+    if (ev.status === "completed" || ev.status === "failed") {
+        const exitCode = extractExitCode(ev.rawResult, ev.status === "failed");
+        const exitUpdate = {
+            sessionUpdate: "tool_call_update",
+            toolCallId: ev.callId,
+            status: ev.status,
+            content: [{ type: "terminal", terminalId: ev.callId }],
+            _meta: {
+                claudeCode: { toolName },
+                terminal_exit: { terminal_id: ev.callId, exit_code: exitCode, signal: null },
+            },
+        };
+        // rawOutput gives Zed a text fallback outside the terminal render path.
+        if (ev.output !== undefined)
+            exitUpdate.rawOutput = ev.output;
+        await sendSessionUpdate(cx, acpSid, exitUpdate);
+    }
+}
+async function dispatchUsageDelta(server, cx, acpSid, ev) {
+    // The backend often returns contextWindow=0; fill from the model's
+    // config.json limit.context so the editor can render the context bar.
+    let size = ev.size;
+    if (!size) {
+        const modelId = await currentModelCached(server, acpSid);
+        size = modelContextWindow(modelId);
+    }
+    await sendSessionUpdate(cx, acpSid, {
+        sessionUpdate: "usage_update",
+        used: ev.used,
+        size,
+    });
+}
+function dispatchFilesChanged(cx, acpSid, ev) {
+    const files = ev.files;
+    const preview = files.slice(0, 3).join(", ");
+    const ellipsis = files.length > 3 ? "..." : "";
+    return sendSessionUpdate(cx, acpSid, {
+        sessionUpdate: "tool_call",
+        toolCallId: `files_${randomUUID().slice(0, 8)}`,
+        title: `changed files (${files.length}): ${preview}${ellipsis}`,
+        kind: "edit",
+        status: "completed",
+        content: [
+            { type: "content", content: { type: "text", text: "affected files:\n" + files.join("\n") } },
+        ],
+    });
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/handlers/dispatch.js.map

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

package/dist/handlers/extensions.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 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 type * as acp from "@agentclientprotocol/sdk";
+import type { ZcodeAcpServer } from "../server.js";
+interface ExtensionParams {
+    sessionId: string;
+    [key: string]: unknown;
+}
+type Result = Record<string, unknown>;
+/** session/fork → zcode session/fork: branch a new session from a checkpoint. */
+export declare function fork(server: ZcodeAcpServer, params: ExtensionParams): Promise<Result>;
+/** session/rewind → zcode session/rewind: restore workspace files to a checkpoint. */
+export declare function rewind(server: ZcodeAcpServer, params: ExtensionParams): Promise<Result>;
+/** session/rewindCascade → zcode session/rewindCascade: cascade rewind. */
+export declare function rewindCascade(server: ZcodeAcpServer, params: ExtensionParams): Promise<Result>;
+/** session/goal → zcode session/goal: read/set/replace/clear/pause/resume the goal. */
+export declare function goal(server: ZcodeAcpServer, params: ExtensionParams): Promise<Result>;
+/** session/compact → zcode session/compact + wait for the internal AI turn. */
+export declare function compact(server: ZcodeAcpServer, params: ExtensionParams, cx: acp.AgentContext): Promise<Result>;
+/** session/steer → zcode session/steer: append instructions to a running turn. */
+export declare function steer(server: ZcodeAcpServer, params: ExtensionParams): Promise<Result>;
+/** session/cancelBackgroundTask → zcode session/cancelBackgroundTask. */
+export declare function cancelBackgroundTask(server: ZcodeAcpServer, params: ExtensionParams): Promise<Result>;
+/** session/setThoughtLevel → zcode session/setThoughtLevel. */
+export declare function setThoughtLevel(server: ZcodeAcpServer, params: ExtensionParams): Promise<Result>;
+/** session/updateRuntimeModelConfig → same: runtime overlay of session model config. */
+export declare function updateRuntimeModelConfig(server: ZcodeAcpServer, params: ExtensionParams): Promise<Result>;
+/** session/setModel → applyModelSwitch (runtime overlay, not persistence). */
+export declare function setModel(server: ZcodeAcpServer, params: ExtensionParams): Promise<Result>;
+/** session/setMode → zcode session/setMode + emit config_option/current_mode updates. */
+export declare function setMode(server: ZcodeAcpServer, params: ExtensionParams, cx: acp.AgentContext): Promise<Result>;
+export {};
+//# sourceMappingURL=extensions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/handlers/extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAOrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAiBnD,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtC,iFAAiF;AACjF,wBAAsB,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAc3F;AAED,sFAAsF;AACtF,wBAAsB,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAa7F;AAED,2EAA2E;AAC3E,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,uFAAuF;AACvF,wBAAsB,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB3F;AAED,+EAA+E;AAC/E,wBAAsB,OAAO,CAC3B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,EAAE,EAAE,GAAG,CAAC,YAAY,GACnB,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED,kFAAkF;AAClF,wBAAsB,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAW5F;AAED,yEAAyE;AACzE,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED,+DAA+D;AAC/D,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,wFAAwF;AACxF,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,8EAA8E;AAC9E,wBAAsB,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ/F;AAED,yFAAyF;AACzF,wBAAsB,OAAO,CAC3B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,EAAE,EAAE,GAAG,CAAC,YAAY,GACnB,OAAO,CAAC,MAAM,CAAC,CA0BjB"}