zcode-acp-server 0.1.0

package/dist/interaction/adapter.js

@@ -0,0 +1,353 @@
+/**
+ * Interaction channel adapter: zcode `interaction/*` server→client requests
+ * ↔ ACP `session/requestPermission`.
+ *
+ * ZCode's `createProtocolInteractionBroker` dispatches server→client requests
+ * by tool. Zed supports `session/requestPermission` natively (the allow/reject
+ * popup) but NOT elicitation, so all three interaction kinds map onto
+ * requestPermission:
+ *   - interaction/requestPermission (tool approval)         → direct mapping
+ *   - interaction/requestUserInput (plan_approval / ExitPlanMode) → approve/reject
+ *   - interaction/requestUserInput (AskUserQuestion)        → per-question options
+ *     (single-select: one popup + Skip; multi-select: per-option Include/Skip)
+ *
+ * `requestPermission` is single-select, so multi-select questions are split
+ * into per-option yes/no popups; the user's Include picks are comma-joined
+ * into the final answer (mirrors the reference impl's `answers[q]: "a, b"`).
+ */
+// ---------- classification ----------
+export function isPermissionRequest(method) {
+    return method === "interaction/requestPermission";
+}
+export function isUserInputRequest(method) {
+    return method === "interaction/requestUserInput";
+}
+export function isExitPlanMode(params) {
+    if (!params || typeof params !== "object")
+        return false;
+    const schema = params.schema;
+    if (!schema || typeof schema !== "object")
+        return false;
+    return schema.interaction === "plan_approval";
+}
+/** AskUserQuestion = requestUserInput WITHOUT the plan_approval schema. */
+export function isAskUserQuestion(method, params) {
+    return isUserInputRequest(method) && !isExitPlanMode(params);
+}
+// ---------- zcode permission → ACP requestPermission ----------
+/**
+ * Normalize a zcode permission-option `kind` to one of the 4 ACP-legal values
+ * (`allow_once` | `allow_always` | `reject_once` | `reject_always`).
+ *
+ * zcode's backend emits a wider/legacy enum that includes `deny`, `allow`,
+ * `reject`, etc. The ACP schema (and Zed's deserializer) only accepts the four
+ * canonical values — anything else makes the *whole* `requestPermission` fail
+ * at the client with "unknown variant", so the popup never renders and the
+ * request defaults to decline. `optionId` is free text and stays untouched.
+ *
+ * Fail-safe: any unrecognized kind maps to `reject_once` (never auto-allow).
+ */
+function normalizeKind(kind) {
+    switch (kind) {
+        case "allow_once":
+        case "allow_always":
+        case "reject_once":
+        case "reject_always":
+            return kind;
+        case "allow":
+        case "allow_project":
+            return "allow_always";
+        case "reject":
+        case "deny":
+            return "reject_once";
+        default:
+            return "reject_once";
+    }
+}
+/** Convert a zcode tool-permission request into ACP requestPermission params. */
+export function zcodePermissionToAcp(params, acpSid) {
+    const options = [];
+    for (const opt of params.options ?? []) {
+        options.push({
+            optionId: opt.optionId ?? "",
+            kind: normalizeKind(opt.kind),
+            name: opt.name ?? opt.optionId ?? "",
+        });
+    }
+    if (options.length === 0)
+        return null;
+    return {
+        options,
+        sessionId: acpSid,
+        toolCall: { toolCallId: params.toolCallId ?? "", rawInput: params.input },
+    };
+}
+/**
+ * Allow-class optionIds that zcode's backend emits. The response mapper must
+ * recognize ALL of them — selecting "Allow once" (optionId "allow_once") in
+ * the popup otherwise gets reported back as a rejection. optionId is free
+ * text defined by the backend, so this set mirrors the backend's naming.
+ * Any optionId not in this set is treated as deny (fail-safe). */
+const ALLOW_OPTION_IDS = new Set(["allow", "allow_once", "allow_always", "allow_project"]);
+/** Convert an ACP requestPermission response → zcode {decision, reason?}. */
+export function acpPermissionResponseToZcode(acpResp) {
+    if (!acpResp || typeof acpResp !== "object") {
+        return { decision: "deny", reason: "invalid client response" };
+    }
+    const outcome = acpResp.outcome ?? {};
+    if (outcome.outcome === "cancelled")
+        return { decision: "deny", reason: "cancelled by user" };
+    const optionId = outcome.optionId ?? "";
+    if (ALLOW_OPTION_IDS.has(optionId))
+        return { decision: "allow" };
+    return { decision: "deny", reason: `rejected (${optionId})` };
+}
+// ---------- ExitPlanMode → ACP requestPermission ----------
+/** ExitPlanMode rendered as approve/reject permission options. */
+export function exitPlanModeToAcpPermission(params, acpSid) {
+    return {
+        options: [
+            { kind: "allow_once", name: "Approve — exit plan mode", optionId: "approve" },
+            { kind: "reject_once", name: "Reject — keep planning", optionId: "reject" },
+        ],
+        sessionId: acpSid,
+        toolCall: { toolCallId: params.toolCallId ?? "", rawInput: params.input },
+    };
+}
+/** Convert an ACP response → zcode ExitPlanMode response. */
+export function acpPermissionResponseToExitPlanMode(acpResp) {
+    if (!acpResp || typeof acpResp !== "object") {
+        return { action: "decline", reason: "invalid client response" };
+    }
+    const outcome = acpResp.outcome ?? {};
+    if (outcome.outcome === "cancelled")
+        return { action: "decline", reason: "cancelled" };
+    if (outcome.optionId === "approve") {
+        // content must be an object with answer_0 (zcode reads content.answer_0).
+        return { action: "accept", content: { answer_0: "approve" } };
+    }
+    return { action: "decline", reason: "rejected" };
+}
+/**
+ * Split a zcode AskUserQuestion request into per-question descriptors.
+ *
+ * Single-select: one ACP option per label + a trailing Skip.
+ * Multi-select: each label becomes a yes/no pair (optionId `<label>:yes` /
+ * `<label>:no`) so the handler can pop one Include/Skip dialog per option.
+ *
+ * Returns null when there are no valid questions.
+ */
+export function splitAskUserQuestions(params) {
+    // zcode carries questions both at the top level and under input.questions; prefer top level.
+    let questions = params.questions;
+    if (!questions || questions.length === 0) {
+        questions = params.input?.questions ?? [];
+    }
+    const valid = questions.filter((q) => q && typeof q.question === "string");
+    if (valid.length === 0)
+        return null;
+    const result = [];
+    for (const q of valid) {
+        const labels = [];
+        for (const opt of q.options ?? []) {
+            const label = opt.label ?? opt.value ?? "";
+            if (label)
+                labels.push(label);
+        }
+        if (labels.length === 0)
+            continue;
+        const multi = q.multiSelect === true;
+        if (multi) {
+            const options = [];
+            for (const lb of labels) {
+                options.push({ optionId: `${lb}:yes`, kind: "allow_once", name: `Include: ${lb}` });
+                options.push({ optionId: `${lb}:no`, kind: "reject_once", name: `Skip: ${lb}` });
+            }
+            result.push({ question: q.question, multiSelect: true, options });
+        }
+        else {
+            const options = labels.map((lb) => ({
+                optionId: lb,
+                kind: "allow_once",
+                name: lb,
+            }));
+            options.push({ optionId: "__skip__", kind: "reject_once", name: "Skip" });
+            result.push({ question: q.question, multiSelect: false, options });
+        }
+    }
+    return result.length > 0 ? result : null;
+}
+/** Build ACP requestPermission params for one AskUserQuestion question. */
+export function buildAskUserAcpParams(params, acpSid, options) {
+    return {
+        options,
+        sessionId: acpSid,
+        toolCall: { toolCallId: params.toolCallId ?? "", rawInput: params.input },
+    };
+}
+/**
+ * Parse one ACP requestPermission response → "yes" | "no" | label | null.
+ *
+ * Multi-select: optionId `<label>:yes` → "yes", `<label>:no` → "no".
+ * Single-select: optionId is the label; __skip__ / cancel → null.
+ */
+export function parseAskUserResponse(acpResp) {
+    if (!acpResp || typeof acpResp !== "object")
+        return null;
+    const outcome = acpResp.outcome ?? {};
+    if (outcome.outcome === "cancelled")
+        return null;
+    const optionId = outcome.optionId ?? "";
+    if (!optionId || optionId === "__skip__")
+        return null;
+    if (optionId.endsWith(":yes"))
+        return "yes";
+    if (optionId.endsWith(":no"))
+        return "no";
+    return optionId;
+}
+// ---------- elicitation form (preferred when client supports it) ----------
+/**
+ * Build an elicitation form schema for an AskUserQuestion request.
+ *
+ * Each question becomes one property in the form:
+ *   - Single-select → string enum of labels + a trailing "Skip" option
+ *   - Multi-select  → string array enum of labels
+ *
+ * When the client supports form-based elicitation, this lets the user answer
+ * all questions in one form rather than one popup per question. Single-select
+ * fields include a "Skip" option so the user can opt out of a question without
+ * cancelling the whole form (mirrors the request_permission fallback, which
+ * appends a Skip option per question).
+ */
+export function buildAskUserElicitationForm(params, acpSid, toolCallId) {
+    const questions = params.questions?.length ? params.questions : (params.input?.questions ?? []);
+    const properties = {};
+    const required = [];
+    for (let i = 0; i < questions.length; i++) {
+        const q = questions[i];
+        if (!q || typeof q.question !== "string")
+            continue;
+        const key = `q_${i}`;
+        const labels = (q.options ?? [])
+            .map((o) => o.label ?? o.value ?? "")
+            .filter((l) => l.length > 0);
+        if (labels.length === 0)
+            continue;
+        if (q.multiSelect) {
+            properties[key] = {
+                type: "array",
+                items: { type: "string", enum: labels },
+                title: q.question,
+                description: q.question,
+            };
+        }
+        else {
+            // Append a Skip option so the user can opt out of this question without
+            // cancelling the whole form (parity with the request_permission path).
+            properties[key] = {
+                type: "string",
+                enum: [...labels, ELICIT_SKIP],
+                title: q.question,
+                description: q.question,
+            };
+            required.push(key);
+        }
+    }
+    const message = questions.length === 1
+        ? (questions[0]?.question ?? "Please answer the question.")
+        : `Please answer ${questions.length} questions.`;
+    const form = {
+        mode: "form",
+        sessionId: acpSid,
+        message,
+        requestedSchema: { type: "object", properties, required },
+    };
+    if (toolCallId)
+        form.toolCallId = toolCallId;
+    return form;
+}
+/** Sentinel enum value marking a single-select question as skipped in the form. */
+const ELICIT_SKIP = "__skip__";
+/**
+ * Parse an elicitation form response into the zcode answers map.
+ *
+ * Maps each `q_<i>` form field back to the original question text. Multi-select
+ * answers (arrays) are comma-joined to match the request_permission path's
+ * `"a, b"` format. Returns null if the user declined/cancelled.
+ */
+export function parseAskUserElicitationResponse(acpResp, params) {
+    if (!acpResp || typeof acpResp !== "object")
+        return null;
+    const resp = acpResp;
+    if (resp.action !== "accept" || !resp.content)
+        return null;
+    const questions = params.questions?.length ? params.questions : (params.input?.questions ?? []);
+    const answers = {};
+    for (let i = 0; i < questions.length; i++) {
+        const q = questions[i];
+        if (!q || typeof q.question !== "string")
+            continue;
+        const key = `q_${i}`;
+        const val = resp.content[key];
+        if (val == null)
+            continue;
+        if (Array.isArray(val)) {
+            answers[q.question] = val.filter((v) => typeof v === "string").join(", ");
+        }
+        else if (typeof val === "string" && val !== ELICIT_SKIP) {
+            // Skip the sentinel "__skip__" so a skipped single-select question is
+            // simply omitted from the answers map (parity with the request_permission
+            // path, which leaves the question unanswered on Skip).
+            answers[q.question] = val;
+        }
+    }
+    return answers;
+}
+/**
+ * Build an elicitation form for ExitPlanMode (approve/reject).
+ *
+ * Uses a single required boolean-style enum so the client renders a clear
+ * approve/reject choice in the form UI.
+ */
+export function buildExitPlanModeElicitationForm(params, acpSid, toolCallId) {
+    const planText = params.input && typeof params.input === "object"
+        ? (params.input.plan ?? "")
+        : "";
+    const message = planText ? `Ready to code?\n\n${planText}` : "Ready to code?";
+    const form = {
+        mode: "form",
+        sessionId: acpSid,
+        message,
+        requestedSchema: {
+            type: "object",
+            properties: {
+                decision: {
+                    type: "string",
+                    enum: ["approve", "reject"],
+                    title: "Decision",
+                    description: "Approve to exit plan mode and start coding, or reject to keep planning.",
+                },
+            },
+            required: ["decision"],
+        },
+    };
+    if (toolCallId)
+        form.toolCallId = toolCallId;
+    return form;
+}
+/** Parse an ExitPlanMode elicitation response → zcode accept/decline. */
+export function parseExitPlanModeElicitationResponse(acpResp) {
+    if (!acpResp || typeof acpResp !== "object") {
+        return { action: "decline", reason: "invalid client response" };
+    }
+    const resp = acpResp;
+    if (resp.action !== "accept" || !resp.content) {
+        return { action: "decline", reason: "cancelled" };
+    }
+    if (resp.content.decision === "approve") {
+        return { action: "accept", content: { answer_0: "approve" } };
+    }
+    return { action: "decline", reason: "rejected" };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/interaction/adapter.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,73 @@
+/**
+ * ZcodeAcpServer — owns shared server state, the backend client, and registers
+ * ACP handlers.
+ *
+ * This is the long-lived container the entry point wires to the ACP stream.
+ * Shared state (session map, pending turns, client capabilities) lives here so
+ * every handler layer can reach it without globals.
+ */
+import type * as acp from "@agentclientprotocol/sdk";
+import { ZcodeBackend } from "./backend/index.js";
+/** Client capabilities advertised in the initialize request. */
+export interface ClientCapabilities {
+    fs?: {
+        readTextFile?: boolean;
+        writeTextFile?: boolean;
+    };
+    terminal?: boolean;
+    auth?: Record<string, unknown>;
+    elicitation?: {
+        form?: unknown;
+        url?: unknown;
+    };
+    _meta?: Record<string, unknown>;
+}
+/** A pending prompt turn. */
+export interface PendingTurn {
+    zcodeSid: string;
+    cancelled: boolean;
+}
+export declare class ZcodeAcpServer {
+    /** The ZCode subprocess client (lazy — spawned on first use). */
+    backend: ZcodeBackend | null;
+    /** acp_sid → zcode session id (usually identical, but kept for clarity). */
+    readonly sessionMap: Map<string, string>;
+    /** Currently running turns, keyed by the ACP request id. */
+    readonly pendingTurns: Map<number, PendingTurn>;
+    /**
+     * Per-session (zcodeSid) preempt lock: a promise chain that serializes the
+     * "register self + preempt others" critical section in prompt(). Prevents
+     * concurrent prompts from both missing each other and registering at once.
+     */
+    readonly preemptLocks: Map<string, Promise<void>>;
+    /** Capabilities advertised by the connected client (Zed, JetBrains, ...). */
+    clientCapabilities: ClientCapabilities;
+    /** Session titles already set, to enforce set-once (acp_sid → title). */
+    readonly sessionTitles: Map<string, string>;
+    /** Last mode id advertised to the client (acp_sid → modeId), for change detection. */
+    readonly lastMode: Map<string, string>;
+    /** Per-session ProjectionDiffers (persists across turns). */
+    readonly differs: Map<string, import("./translators/projection-differ.js").ProjectionDiffer>;
+    /** Per-session model cache for configOptions model dropdown. */
+    readonly modelCache: Map<string, string>;
+    /** Monotonic id counter; base 10_000_000 to avoid collisions with zcode-originated ids. */
+    private msgCounter;
+    /** Next JSON-RPC id for messages we send to zcode. */
+    nextId(): number;
+    /** Lazily spawn the zcode backend on first use (initialize doesn't need it). */
+    ensureBackend(): ZcodeBackend;
+    /** Resolve the zcode session id for an ACP session id. */
+    resolveSid(acpSid: string): string | undefined;
+    /** Whether the client declared `_meta.terminal_output` (Zed's Bash UI hook). */
+    supportsTerminalOutput(): boolean;
+    /**
+     * Whether the client supports form-based elicitation (`clientCapabilities.
+     * elicitation.form`). When true, AskUserQuestion / ExitPlanMode can use the
+     * richer `elicitation/create` form UI; otherwise they fall back to
+     * `session/request_permission`.
+     */
+    supportsElicitationForm(): boolean;
+    /** Handle `initialize`: negotiate version + declare agent capabilities. */
+    initialize(params: acp.InitializeRequest): Promise<acp.InitializeResponse>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAErD,OAAO,EAIL,YAAY,EACb,MAAM,oBAAoB,CAAC;AAG5B,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,6BAA6B;AAC7B,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,iEAAiE;IACjE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,sBAA6B;IAChD,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,2BAAkC;IACvD;;;;OAIG;IACH,QAAQ,CAAC,YAAY,6BAAoC;IACzD,6EAA6E;IAC7E,kBAAkB,EAAE,kBAAkB,CAAM;IAC5C,yEAAyE;IACzE,QAAQ,CAAC,aAAa,sBAA6B;IACnD,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,sBAA6B;IAC9C,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,6EAGZ;IACJ,gEAAgE;IAChE,QAAQ,CAAC,UAAU,sBAA6B;IAChD,2FAA2F;IAC3F,OAAO,CAAC,UAAU,CAAc;IAEhC,sDAAsD;IACtD,MAAM,IAAI,MAAM;IAIhB,gFAAgF;IAChF,aAAa,IAAI,YAAY;IAQ7B,0DAA0D;IAC1D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI9C,gFAAgF;IAChF,sBAAsB,IAAI,OAAO;IAKjC;;;;;OAKG;IACH,uBAAuB,IAAI,OAAO;IAIlC,2EAA2E;IACrE,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;CAgCjF"}

package/dist/server.js

@@ -0,0 +1,97 @@
+/**
+ * ZcodeAcpServer — owns shared server state, the backend client, and registers
+ * ACP handlers.
+ *
+ * This is the long-lived container the entry point wires to the ACP stream.
+ * Shared state (session map, pending turns, client capabilities) lives here so
+ * every handler layer can reach it without globals.
+ */
+import { loadZcodeCredentials, mergeEnvWithCreds, resolveZcodeCommand, ZcodeBackend, } from "./backend/index.js";
+import { AGENT_INFO, PROTOCOL_VERSION, log } from "./utils.js";
+export class ZcodeAcpServer {
+    /** The ZCode subprocess client (lazy — spawned on first use). */
+    backend = null;
+    /** acp_sid → zcode session id (usually identical, but kept for clarity). */
+    sessionMap = new Map();
+    /** Currently running turns, keyed by the ACP request id. */
+    pendingTurns = new Map();
+    /**
+     * Per-session (zcodeSid) preempt lock: a promise chain that serializes the
+     * "register self + preempt others" critical section in prompt(). Prevents
+     * concurrent prompts from both missing each other and registering at once.
+     */
+    preemptLocks = new Map();
+    /** Capabilities advertised by the connected client (Zed, JetBrains, ...). */
+    clientCapabilities = {};
+    /** Session titles already set, to enforce set-once (acp_sid → title). */
+    sessionTitles = new Map();
+    /** Last mode id advertised to the client (acp_sid → modeId), for change detection. */
+    lastMode = new Map();
+    /** Per-session ProjectionDiffers (persists across turns). */
+    differs = new Map();
+    /** Per-session model cache for configOptions model dropdown. */
+    modelCache = new Map();
+    /** Monotonic id counter; base 10_000_000 to avoid collisions with zcode-originated ids. */
+    msgCounter = 10_000_000;
+    /** Next JSON-RPC id for messages we send to zcode. */
+    nextId() {
+        return ++this.msgCounter;
+    }
+    /** Lazily spawn the zcode backend on first use (initialize doesn't need it). */
+    ensureBackend() {
+        if (this.backend && !this.backend.isDead)
+            return this.backend;
+        const env = mergeEnvWithCreds(loadZcodeCredentials());
+        const argv = resolveZcodeCommand();
+        this.backend = new ZcodeBackend(argv, env);
+        return this.backend;
+    }
+    /** Resolve the zcode session id for an ACP session id. */
+    resolveSid(acpSid) {
+        return this.sessionMap.get(acpSid);
+    }
+    /** Whether the client declared `_meta.terminal_output` (Zed's Bash UI hook). */
+    supportsTerminalOutput() {
+        const meta = this.clientCapabilities._meta ?? {};
+        return meta["terminal_output"] === true;
+    }
+    /**
+     * Whether the client supports form-based elicitation (`clientCapabilities.
+     * elicitation.form`). When true, AskUserQuestion / ExitPlanMode can use the
+     * richer `elicitation/create` form UI; otherwise they fall back to
+     * `session/request_permission`.
+     */
+    supportsElicitationForm() {
+        return this.clientCapabilities.elicitation?.form != null;
+    }
+    /** Handle `initialize`: negotiate version + declare agent capabilities. */
+    async initialize(params) {
+        const clientInfo = params.clientInfo ?? null;
+        this.clientCapabilities = params.clientCapabilities ?? {};
+        log(`initialize: client protocolVersion=${params.protocolVersion}` +
+            `, client=${clientInfo?.name ?? "unknown"}` +
+            `, version=${clientInfo?.version ?? "unknown"}`);
+        return {
+            protocolVersion: PROTOCOL_VERSION,
+            agentInfo: { ...AGENT_INFO },
+            agentCapabilities: {
+                loadSession: true,
+                promptCapabilities: { image: false, audio: false, embeddedContext: false },
+                mcpCapabilities: { http: false, sse: false },
+                sessionCapabilities: { list: {}, resume: {}, fork: {} },
+            },
+            // The GLM API key is read from ~/.zcode/v2/config.json by the ZCode
+            // backend subprocess; the editor never needs to supply credentials.
+            // Declared as AuthMethodAgent (no `type` field → defaults to "agent"),
+            // which the ACP registry CI accepts as "agent self-handles auth".
+            authMethods: [
+                {
+                    id: "zcode-credentials",
+                    name: "ZCode built-in credentials",
+                    description: "Reads the GLM API key from ~/.zcode/v2/config.json managed by the ZCode desktop app. No editor-side credentials required.",
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tasks-index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * ZCode App tasks-index sync: let the App UI see ACP-created sessions.
+ *
+ * The ZCode App's session list reads from `~/.zcode/v2/tasks-index.sqlite`
+ * (the `tasks` table), NOT from the CLI's `~/.zcode/cli/db/db.sqlite`. These
+ * are independent stores — the App's Electron host maintains tasks-index; the
+ * headless app-server (which we drive) writes only to cli/db. As a result,
+ * every session created via ACP is invisible in the App's UI until the App
+ * happens to reindex.
+ *
+ * This module bridges that gap by writing a tasks-index row directly after
+ * session/create. The App picks it up on its next list refresh. INSERT OR
+ * IGNORE avoids clobbering rows the App already manages.
+ *
+ * Best-effort side-channel: failures (locked DB, schema drift) are logged and
+ * swallowed so they never break the session/create path.
+ */
+/**
+ * Insert (or refresh) a row in tasks-index.sqlite so the App UI shows it.
+ * Called after a successful session/create. Uses INSERT OR IGNORE so it never
+ * overwrites a row the App is actively managing (e.g. user-renamed titles).
+ *
+ * Returns true if written, false on failure (logged, never thrown).
+ */
+export declare function upsertSessionTask(opts: {
+    workspaceKey: string;
+    taskId: string;
+    title: string;
+    traceId?: string;
+    model?: string;
+    status?: string;
+}): Promise<boolean>;
+/**
+ * Update a session's title after the first turn. session/create leaves title
+ * empty; once the first prompt completes, set a meaningful title. Respects
+ * title_overridden: if the user already renamed in the App, their title wins.
+ */
+export declare function updateSessionTitle(taskId: string, title: string): Promise<boolean>;
+//# sourceMappingURL=tasks-index.d.ts.map

package/dist/tasks-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-index.d.ts","sourceRoot":"","sources":["../src/tasks-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA6DH;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,OAAO,CAAC,CA0DnB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4BxF"}