zcode-acp-server 0.1.0 → 0.2.0

package/dist/quota/parse.js

@@ -0,0 +1,200 @@
+/**
+ * Quota response parsing — turns the raw GLM `limits[]` array into a flat list
+ * of normalised {@link QuotaItem}s.
+ *
+ * Design goals (vs. the reference project):
+ *   - **No hardcoded type whitelist.** Unknown `type` values still render,
+ *     labelled by their raw type string, so future windows surface
+ *     automatically.
+ *   - **Percentage fallback chain** that tolerates inconsistent field sets
+ *     across limit kinds (some carry absolute counters, some only a legacy
+ *     `percentage`).
+ *   - **Labels derived from `type` + `number`**, without magic-number coupling.
+ */
+/** Coerce an unknown value to a finite number, or `null`. */
+function asFiniteNumber(value) {
+    const n = typeof value === "number" ? value : Number(value);
+    return Number.isFinite(n) ? n : null;
+}
+/** Clamp a percentage to the valid [0, 100] range, or `null` if not finite. */
+function clampPercent(value) {
+    const n = asFiniteNumber(value);
+    if (n === null)
+        return null;
+    return Math.max(0, Math.min(100, Math.round(n)));
+}
+/**
+ * Compute `{ leftPercent, usedPercent }` from a single raw limit, tolerating
+ * several field combinations (preferred → fallback):
+ *   1. `remaining` + `currentValue` (absolute counters) — most precise;
+ *   2. `currentValue` / `usage`                         — used over total;
+ *   3. `percentage` (legacy, treated as *used* percent) — last resort.
+ * Returns `null` when no percentage can be derived.
+ */
+function computePercentages(limit) {
+    const usage = asFiniteNumber(limit.usage);
+    const remaining = asFiniteNumber(limit.remaining);
+    const currentValue = asFiniteNumber(limit.currentValue);
+    // Path 1: absolute remaining/used counters → derive total from parts.
+    const totalFromParts = remaining !== null && currentValue !== null ? remaining + currentValue : null;
+    const total = totalFromParts !== null && totalFromParts > 0 ? totalFromParts : usage;
+    if (total !== null && total > 0) {
+        if (remaining !== null && remaining >= 0 && remaining <= total) {
+            const leftPercent = clampPercent((remaining / total) * 100);
+            if (leftPercent !== null) {
+                return { leftPercent, usedPercent: 100 - leftPercent };
+            }
+        }
+        if (currentValue !== null && currentValue >= 0 && currentValue <= total) {
+            const usedPercent = clampPercent((currentValue / total) * 100);
+            if (usedPercent !== null) {
+                return { leftPercent: 100 - usedPercent, usedPercent };
+            }
+        }
+    }
+    // Path 3: legacy `percentage` (treated as used percent — GLM convention).
+    const usedPercent = clampPercent(limit.percentage);
+    if (usedPercent === null)
+        return null;
+    return { leftPercent: 100 - usedPercent, usedPercent };
+}
+/** Map a `type` to a coarse category used for label/key derivation. */
+function categoryOf(type) {
+    switch (type) {
+        case "TOKENS_LIMIT":
+            return "token";
+        case "MCP_LIMIT":
+        case "TIME_LIMIT":
+            return "mcp";
+        default:
+            return "other";
+    }
+}
+/**
+ * Derive a stable key and human-readable label for a limit.
+ *
+ * Known windows get friendly labels; anything else falls back to the raw
+ * `type` (or `"Quota"`) so it still renders.
+ */
+function deriveLabel(limit, category) {
+    const number = limit.number;
+    if (category === "token") {
+        // GLM convention: number===5 → 5-hour window; number===7 → weekly.
+        if (number === 5)
+            return { key: "token_5h", label: "5h" };
+        if (number === 7)
+            return { key: "token_week", label: "Week" };
+        if (number !== undefined)
+            return { key: `token_${number}`, label: `${number}` };
+        return { key: "token", label: "Token" };
+    }
+    if (category === "mcp") {
+        return { key: "mcp", label: "MCP" };
+    }
+    // Unknown type — surface it verbatim rather than hide it.
+    const fallback = limit.type || "Quota";
+    return { key: fallback.toLowerCase(), label: fallback };
+}
+/**
+ * Parse one raw limit into a {@link QuotaItem}, or `null` if no percentage
+ * can be computed (the limit is then dropped from display).
+ */
+export function parseLimit(limit) {
+    const percent = computePercentages(limit);
+    if (!percent)
+        return null;
+    const category = categoryOf(limit.type);
+    const { key, label } = deriveLabel(limit, category);
+    const item = {
+        key,
+        label,
+        usedPercent: percent.usedPercent,
+        leftPercent: percent.leftPercent,
+    };
+    // Absolute counters — only some limit kinds carry them (MCP/TIME_LIMIT do,
+    // legacy TOKENS_LIMIT often does not). Surface them when present so the
+    // formatter can show "(used / total)".
+    const usedCount = asFiniteNumber(limit.currentValue);
+    if (usedCount !== null)
+        item.usedCount = usedCount;
+    const totalCount = asFiniteNumber(limit.usage);
+    if (totalCount !== null)
+        item.totalCount = totalCount;
+    const nextResetTime = asFiniteNumber(limit.nextResetTime);
+    if (nextResetTime !== null)
+        item.nextResetTime = nextResetTime;
+    if (Array.isArray(limit.usageDetails) && limit.usageDetails.length > 0) {
+        item.detail = limit.usageDetails;
+    }
+    return item;
+}
+/** Auth-failure detection from the business-layer `msg` (zh/en keywords). */
+function isAuthFailureMessage(msg) {
+    return typeof msg === "string" && /authorization|auth|token|鉴权|授权|未登录/i.test(msg);
+}
+/** Rate-limit detection from the business-layer `msg` (zh/en keywords). */
+function isRateLimitedMessage(msg) {
+    return (typeof msg === "string" &&
+        /rate\s*limit|too many requests|too frequent|frequency|限流|频率|过于频繁|稍后再试/i.test(msg));
+}
+/**
+ * Parse the full API response (already classified by the fetch layer as a
+ * `response` with a status + body) into a {@link QuotaResult}.
+ *
+ * State machine: 429/rate-limit text → `rate_limited`; auth codes/text →
+ * `auth_error`; success with zero parseable items → `unavailable`; otherwise
+ * the items are returned in original order.
+ */
+export function parseQuotaEnvelope(envelope) {
+    // HTTP-level rate limit.
+    if (envelope.status === 429 || isRateLimitedMessage(envelope.text)) {
+        return { kind: "rate_limited" };
+    }
+    const payload = envelope.json;
+    if (!payload || typeof payload !== "object") {
+        return { kind: "unavailable" };
+    }
+    if (payload.success !== true) {
+        if (payload.code === 1001 || payload.code === 401 || isAuthFailureMessage(payload.msg)) {
+            return { kind: "auth_error" };
+        }
+        if (isRateLimitedMessage(payload.msg)) {
+            return { kind: "rate_limited" };
+        }
+        return { kind: "unavailable" };
+    }
+    const limits = Array.isArray(payload.data?.limits) ? payload.data.limits : [];
+    const items = limits
+        .map(parseLimit)
+        .filter((x) => x !== null)
+        .sort(byDisplayOrder);
+    if (items.length === 0) {
+        return { kind: "unavailable" };
+    }
+    return {
+        kind: "success",
+        level: typeof payload.data?.level === "string" ? payload.data.level : "",
+        items,
+    };
+}
+/**
+ * Display ordering: token windows first (5h before Week before other token
+ * windows), then MCP, then anything else — by stable key. Keeps the card
+ * layout predictable regardless of the API's array order.
+ */
+function byDisplayOrder(a, b) {
+    return rankOf(a.key) - rankOf(b.key) || a.key.localeCompare(b.key);
+}
+/** Stable rank for a quota key — lower renders first. */
+function rankOf(key) {
+    if (key === "token_5h")
+        return 0;
+    if (key === "token_week")
+        return 1;
+    if (key.startsWith("token_"))
+        return 2; // other token windows
+    if (key === "mcp")
+        return 3;
+    return 4; // unknown types last
+}
+//# sourceMappingURL=parse.js.map

package/dist/quota/parse.js.map

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

package/dist/quota/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Type definitions for the GLM Coding Plan quota feature.
+ *
+ * The `/quota` slash command queries `bigmodel.cn` / `api.z.ai` for the
+ * current account's usage limits and renders them as a multi-line card.
+ * These types model the raw API response and the normalised shape consumed
+ * by the formatter.
+ */
+/** A single raw limit entry from the GLM quota API (`data.limits[]`). */
+export interface RawLimit {
+    /** Limit family — "TOKENS_LIMIT" | "TIME_LIMIT" | "MCP_LIMIT" | <unknown>. */
+    type: string;
+    /** Window-count sub-identifier; meaning varies by backend (unused for classification). */
+    unit?: number;
+    /** Window span; GLM uses 5 for the 5-hour window, 7 for the weekly window. */
+    number?: number;
+    /** Total allowance for the window (absolute counter). */
+    usage?: number;
+    /** Absolute remaining counter (preferred for percentage). */
+    remaining?: number;
+    /** Absolute used counter (preferred for percentage alongside `usage`). */
+    currentValue?: number;
+    /** Legacy percentage field — historically represents *used* percent. */
+    percentage?: number;
+    /** Reset timestamp in epoch milliseconds. */
+    nextResetTime?: number;
+    /** Per-model usage breakdown (present on MCP/TIME limits). */
+    usageDetails?: {
+        modelCode: string;
+        usage: number;
+    }[];
+}
+/**
+ * Normalised quota item — one rendered line.
+ *
+ * Every raw limit that yields a valid percentage becomes a `QuotaItem`;
+ * limits with no computable percentage are silently dropped.
+ */
+export interface QuotaItem {
+    /** Stable key derived from type+number, e.g. "token_5h" / "mcp". */
+    key: string;
+    /** Human-readable label for the line, e.g. "5h" / "MCP" / "Week". */
+    label: string;
+    /** Used percentage, clamped to [0, 100]. */
+    usedPercent: number;
+    /** Remaining percentage = 100 - usedPercent. */
+    leftPercent: number;
+    /** Absolute used count (only some limits carry this, e.g. MCP/TIME). */
+    usedCount?: number;
+    /** Absolute total allowance (only some limits carry this). */
+    totalCount?: number;
+    /** Reset timestamp in epoch milliseconds, if present. */
+    nextResetTime?: number;
+    /** Per-model usage breakdown, if present (rendered as indented sub-lines). */
+    detail?: {
+        modelCode: string;
+        usage: number;
+    }[];
+}
+/** Top-level parsed result — a 4-state sum type. */
+export type QuotaResult = {
+    kind: "success";
+    level: string;
+    items: QuotaItem[];
+} | {
+    kind: "auth_error";
+} | {
+    kind: "rate_limited";
+} | {
+    kind: "unavailable";
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/quota/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,yEAAyE;AACzE,MAAM,WAAW,QAAQ;IACvB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,YAAY,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACvD;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,MAAM,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjD;AAED,oDAAoD;AACpD,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC"}

package/dist/quota/types.js

@@ -0,0 +1,10 @@
+/**
+ * Type definitions for the GLM Coding Plan quota feature.
+ *
+ * The `/quota` slash command queries `bigmodel.cn` / `api.z.ai` for the
+ * current account's usage limits and renders them as a multi-line card.
+ * These types model the raw API response and the normalised shape consumed
+ * by the formatter.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/quota/types.js.map

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

package/dist/server.d.ts

@@ -8,6 +8,7 @@
  */
 import type * as acp from "@agentclientprotocol/sdk";
 import { ZcodeBackend } from "./backend/index.js";
+import { BackgroundTaskListener } from "./handlers/background-tasks.js";
 /** Client capabilities advertised in the initialize request. */
 export interface ClientCapabilities {
     fs?: {
@@ -26,12 +27,51 @@ export interface ClientCapabilities {
 export interface PendingTurn {
     zcodeSid: string;
     cancelled: boolean;
+    /** Set once session/stop has been fired for this turn, to avoid re-sending. */
+    stopSent?: boolean;
+    /**
+     * Set when the turn was ended by the stall-recovery heuristic (backend
+     * reported idle after a silence) rather than a real turn.completed event.
+     * prompt() skips auto-compact for such turns — the completion was inferred,
+     * and compressing an in-flight task's context would destroy the work.
+     */
+    stallRecovered?: 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>;
+    /**
+     * Reverse map: zcode session id → acp_sid. The background-task listener only
+     * knows the zcode sid (it comes from backend events), but ACP notifications
+     * must address the acp_sid the client knows. Usually the two are identical,
+     * but forked/loaded sessions can diverge, so we maintain an explicit reverse
+     * index rather than assuming equality.
+     */
+    readonly acpSidByZcodeSid: Map<string, string>;
+    /**
+     * Sessions returned by `session/new` whose backend session has not been
+     * created yet (acp_sid → { cwd }). session/new defers `session/create` until
+     * the session is first used, so an editor startup that never prompts leaves
+     * no empty session in the backend or the App's task index. `ensureRealSession`
+     * materializes these on first use; entries live only as long as the bridge
+     * process (a never-used placeholder vanishes with it).
+     *
+     * `creating` holds the in-flight materialization promise while a first-use
+     * create is running, so concurrent first-uses (e.g. a raced double prompt)
+     * share one `session/create` instead of creating two backend sessions.
+     */
+    readonly pendingSessions: Map<string, {
+        cwd: string;
+        creating?: Promise<string>;
+        /** Client-provided MCP servers from session/new, replayed verbatim into
+         * the backend's session/create when the lazy session materializes. The
+         * backend's mcpServers schema matches the ACP array shape (stdio entries
+         * carry command/args/env; remote entries carry type/url), so entries are
+         * passed through unchanged. */
+        mcpServers?: acp.McpServer[];
+    }>;
     /** Currently running turns, keyed by the ACP request id. */
     readonly pendingTurns: Map<number, PendingTurn>;
     /**
@@ -42,14 +82,53 @@ export declare class ZcodeAcpServer {
     readonly preemptLocks: Map<string, Promise<void>>;
     /** Capabilities advertised by the connected client (Zed, JetBrains, ...). */
     clientCapabilities: ClientCapabilities;
+    /**
+     * Connection-scoped AgentContext, captured at `connect()` time. Held so that
+     * background listeners can push `session/update` notifications OUTSIDE a
+     * request handler (e.g. when a background task completes after `session/
+     * prompt` has already returned). Null before `connect()` runs (only during
+     * the brief startup window — sessions can't be created before connect).
+     */
+    acpClient: acp.AgentContext | null;
     /** Session titles already set, to enforce set-once (acp_sid → title). */
     readonly sessionTitles: Map<string, string>;
+    /**
+     * Sessions eligible for auto-title on first end_turn. Only `session/new`
+     * populates this — resumed/loaded sessions already carry a title, so their
+     * first post-load message must NOT overwrite it. (sessionTitles alone can't
+     * distinguish "freshly created" from "resumed but not yet titled in-process".)
+     */
+    readonly titleEligibleSessions: Set<string>;
     /** Last mode id advertised to the client (acp_sid → modeId), for change detection. */
     readonly lastMode: Map<string, string>;
+    /**
+     * Timestamp of the last cancel (user stop or preempt), keyed by zcodeSid.
+     * Set in cancel() and preemptInFlightTurn(); read in runEventTurn's stall
+     * reconciliation to fast-fail turns that collide with the backend's
+     * ~20s model-connection recovery window after a mid-stream abort.
+     */
+    readonly lastCancelledAt: Map<string, number>;
     /** 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>;
+    /**
+     * Per-session (zcodeSid) background-task listeners. Registered once when a
+     * session is created/resumed/loaded and lives across prompts, forwarding
+     * background task status + result notifications to the client outside of
+     * request handlers. The turn loop's own listener coexists with this one
+     * (backend.listeners is now a Set per session).
+     */
+    readonly backgroundListeners: Map<string, BackgroundTaskListener>;
+    /**
+     * Per-Bash-callId stdout snapshot already streamed via terminal_output. Used
+     * by dispatchTerminalUpdate for two dedup guards:
+     *   - progress: diff cumulative stdoutTail snapshots, emit only the suffix.
+     *   - result:   if present, the output was already streamed → skip replay.
+     * Presence of a key also signals "progress fired for this call" (absent =
+     * short command with no progress, so the result emits output once).
+     */
+    readonly terminalSentData: 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. */
@@ -58,6 +137,31 @@ export declare class ZcodeAcpServer {
     ensureBackend(): ZcodeBackend;
     /** Resolve the zcode session id for an ACP session id. */
     resolveSid(acpSid: string): string | undefined;
+    /**
+     * Register the acp_sid ↔ zcode_sid mapping both ways. Use this instead of
+     * `sessionMap.set(...)` directly so the reverse index stays in sync (the
+     * background-task listener needs the reverse lookup to address notifications).
+     */
+    registerSession(acpSid: string, zcodeSid: string): void;
+    /**
+     * Ensure a background-task listener is registered for the session. Idempotent
+     * — returns the existing listener if already registered (covers resume/load
+     * after new, and fork). Lives for the whole session so background agents that
+     * finish AFTER `session/prompt` returns still get their status/result
+     * forwarded to the client. The turn loop's own listener coexists via the
+     * backend's per-session listener Set.
+     */
+    ensureBackgroundListener(zcodeSid: string): BackgroundTaskListener;
+    /** Resolve the ACP session id for a zcode session id (reverse of resolveSid). */
+    resolveAcpSid(zcodeSid: string): string | undefined;
+    /**
+     * Push a `session/update` notification to the client from OUTSIDE a request
+     * handler (used by the background-task listener). Resolves the acp_sid from
+     * the zcode_sid and no-ops (returning false) if the client or session is
+     * unknown. Never throws — callers run in the event loop and must not crash
+     * the bridge on a notification failure.
+     */
+    notifyByZcodeSid(zcodeSid: string, update: acp.SessionUpdate): Promise<boolean>;
     /** Whether the client declared `_meta.terminal_output` (Zed's Bash UI hook). */
     supportsTerminalOutput(): boolean;
     /**

package/dist/server.d.ts.map

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

package/dist/server.js

@@ -7,12 +7,34 @@
  * every handler layer can reach it without globals.
  */
 import { loadZcodeCredentials, mergeEnvWithCreds, resolveZcodeCommand, ZcodeBackend, } from "./backend/index.js";
+import { BackgroundTaskListener } from "./handlers/background-tasks.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();
+    /**
+     * Reverse map: zcode session id → acp_sid. The background-task listener only
+     * knows the zcode sid (it comes from backend events), but ACP notifications
+     * must address the acp_sid the client knows. Usually the two are identical,
+     * but forked/loaded sessions can diverge, so we maintain an explicit reverse
+     * index rather than assuming equality.
+     */
+    acpSidByZcodeSid = new Map();
+    /**
+     * Sessions returned by `session/new` whose backend session has not been
+     * created yet (acp_sid → { cwd }). session/new defers `session/create` until
+     * the session is first used, so an editor startup that never prompts leaves
+     * no empty session in the backend or the App's task index. `ensureRealSession`
+     * materializes these on first use; entries live only as long as the bridge
+     * process (a never-used placeholder vanishes with it).
+     *
+     * `creating` holds the in-flight materialization promise while a first-use
+     * create is running, so concurrent first-uses (e.g. a raced double prompt)
+     * share one `session/create` instead of creating two backend sessions.
+     */
+    pendingSessions = new Map();
     /** Currently running turns, keyed by the ACP request id. */
     pendingTurns = new Map();
     /**
@@ -23,14 +45,53 @@ export class ZcodeAcpServer {
     preemptLocks = new Map();
     /** Capabilities advertised by the connected client (Zed, JetBrains, ...). */
     clientCapabilities = {};
+    /**
+     * Connection-scoped AgentContext, captured at `connect()` time. Held so that
+     * background listeners can push `session/update` notifications OUTSIDE a
+     * request handler (e.g. when a background task completes after `session/
+     * prompt` has already returned). Null before `connect()` runs (only during
+     * the brief startup window — sessions can't be created before connect).
+     */
+    acpClient = null;
     /** Session titles already set, to enforce set-once (acp_sid → title). */
     sessionTitles = new Map();
+    /**
+     * Sessions eligible for auto-title on first end_turn. Only `session/new`
+     * populates this — resumed/loaded sessions already carry a title, so their
+     * first post-load message must NOT overwrite it. (sessionTitles alone can't
+     * distinguish "freshly created" from "resumed but not yet titled in-process".)
+     */
+    titleEligibleSessions = new Set();
     /** Last mode id advertised to the client (acp_sid → modeId), for change detection. */
     lastMode = new Map();
+    /**
+     * Timestamp of the last cancel (user stop or preempt), keyed by zcodeSid.
+     * Set in cancel() and preemptInFlightTurn(); read in runEventTurn's stall
+     * reconciliation to fast-fail turns that collide with the backend's
+     * ~20s model-connection recovery window after a mid-stream abort.
+     */
+    lastCancelledAt = new Map();
     /** Per-session ProjectionDiffers (persists across turns). */
     differs = new Map();
     /** Per-session model cache for configOptions model dropdown. */
     modelCache = new Map();
+    /**
+     * Per-session (zcodeSid) background-task listeners. Registered once when a
+     * session is created/resumed/loaded and lives across prompts, forwarding
+     * background task status + result notifications to the client outside of
+     * request handlers. The turn loop's own listener coexists with this one
+     * (backend.listeners is now a Set per session).
+     */
+    backgroundListeners = new Map();
+    /**
+     * Per-Bash-callId stdout snapshot already streamed via terminal_output. Used
+     * by dispatchTerminalUpdate for two dedup guards:
+     *   - progress: diff cumulative stdoutTail snapshots, emit only the suffix.
+     *   - result:   if present, the output was already streamed → skip replay.
+     * Presence of a key also signals "progress fired for this call" (absent =
+     * short command with no progress, so the result emits output once).
+     */
+    terminalSentData = 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. */
@@ -50,6 +111,61 @@ export class ZcodeAcpServer {
     resolveSid(acpSid) {
         return this.sessionMap.get(acpSid);
     }
+    /**
+     * Register the acp_sid ↔ zcode_sid mapping both ways. Use this instead of
+     * `sessionMap.set(...)` directly so the reverse index stays in sync (the
+     * background-task listener needs the reverse lookup to address notifications).
+     */
+    registerSession(acpSid, zcodeSid) {
+        this.sessionMap.set(acpSid, zcodeSid);
+        this.acpSidByZcodeSid.set(zcodeSid, acpSid);
+    }
+    /**
+     * Ensure a background-task listener is registered for the session. Idempotent
+     * — returns the existing listener if already registered (covers resume/load
+     * after new, and fork). Lives for the whole session so background agents that
+     * finish AFTER `session/prompt` returns still get their status/result
+     * forwarded to the client. The turn loop's own listener coexists via the
+     * backend's per-session listener Set.
+     */
+    ensureBackgroundListener(zcodeSid) {
+        const existing = this.backgroundListeners.get(zcodeSid);
+        if (existing)
+            return existing;
+        const backend = this.ensureBackend();
+        const listener = new BackgroundTaskListener(this, zcodeSid);
+        this.backgroundListeners.set(zcodeSid, listener);
+        backend.registerEventListener(zcodeSid, listener);
+        log(`  [bg] background listener registered for ${zcodeSid}`);
+        return listener;
+    }
+    /** Resolve the ACP session id for a zcode session id (reverse of resolveSid). */
+    resolveAcpSid(zcodeSid) {
+        return this.acpSidByZcodeSid.get(zcodeSid);
+    }
+    /**
+     * Push a `session/update` notification to the client from OUTSIDE a request
+     * handler (used by the background-task listener). Resolves the acp_sid from
+     * the zcode_sid and no-ops (returning false) if the client or session is
+     * unknown. Never throws — callers run in the event loop and must not crash
+     * the bridge on a notification failure.
+     */
+    async notifyByZcodeSid(zcodeSid, update) {
+        const cx = this.acpClient;
+        if (!cx)
+            return false;
+        const acpSid = this.resolveAcpSid(zcodeSid);
+        if (!acpSid)
+            return false;
+        try {
+            await cx.notify("session/update", { sessionId: acpSid, update });
+            return true;
+        }
+        catch (e) {
+            log(`notifyByZcodeSid: session/update failed: ${e instanceof Error ? e.message : String(e)}`);
+            return false;
+        }
+    }
     /** Whether the client declared `_meta.terminal_output` (Zed's Bash UI hook). */
     supportsTerminalOutput() {
         const meta = this.clientCapabilities._meta ?? {};
@@ -70,13 +186,14 @@ export class ZcodeAcpServer {
         this.clientCapabilities = params.clientCapabilities ?? {};
         log(`initialize: client protocolVersion=${params.protocolVersion}` +
             `, client=${clientInfo?.name ?? "unknown"}` +
-            `, version=${clientInfo?.version ?? "unknown"}`);
+            `, version=${clientInfo?.version ?? "unknown"}` +
+            `, elicitation.form=${this.clientCapabilities.elicitation?.form == null ? "no" : "yes"}`);
         return {
             protocolVersion: PROTOCOL_VERSION,
             agentInfo: { ...AGENT_INFO },
             agentCapabilities: {
                 loadSession: true,
-                promptCapabilities: { image: false, audio: false, embeddedContext: false },
+                promptCapabilities: { image: true, audio: false, embeddedContext: false },
                 mcpCapabilities: { http: false, sse: false },
                 sessionCapabilities: { list: {}, resume: {}, fork: {} },
             },

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAiB/D,MAAM,OAAO,cAAc;IACzB,iEAAiE;IACjE,OAAO,GAAwB,IAAI,CAAC;IACpC,4EAA4E;IACnE,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,4DAA4D;IACnD,YAAY,GAAG,IAAI,GAAG,EAAuB,CAAC;IACvD;;;;OAIG;IACM,YAAY,GAAG,IAAI,GAAG,EAAyB,CAAC;IACzD,6EAA6E;IAC7E,kBAAkB,GAAuB,EAAE,CAAC;IAC5C,yEAAyE;IAChE,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnD,sFAAsF;IAC7E,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,6DAA6D;IACpD,OAAO,GAAG,IAAI,GAAG,EAGvB,CAAC;IACJ,gEAAgE;IACvD,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,2FAA2F;IACnF,UAAU,GAAG,UAAU,CAAC;IAEhC,sDAAsD;IACtD,MAAM;QACJ,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,gFAAgF;IAChF,aAAa;QACX,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC;QAC9D,MAAM,GAAG,GAAG,iBAAiB,CAAC,oBAAoB,EAAE,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,0DAA0D;IAC1D,UAAU,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,gFAAgF;IAChF,sBAAsB;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,IAAI,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACH,uBAAuB;QACrB,OAAO,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,IAAI,IAAI,IAAI,CAAC;IAC3D,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,UAAU,CAAC,MAA6B;QAC5C,MAAM,UAAU,GAAI,MAAM,CAAC,UAAyD,IAAI,IAAI,CAAC;QAC7F,IAAI,CAAC,kBAAkB,GAAI,MAAM,CAAC,kBAAyC,IAAI,EAAE,CAAC;QAClF,GAAG,CACD,sCAAsC,MAAM,CAAC,eAAe,EAAE;YAC5D,YAAY,UAAU,EAAE,IAAI,IAAI,SAAS,EAAE;YAC3C,aAAa,UAAU,EAAE,OAAO,IAAI,SAAS,EAAE,CAClD,CAAC;QAEF,OAAO;YACL,eAAe,EAAE,gBAAgB;YACjC,SAAS,EAAE,EAAE,GAAG,UAAU,EAAE;YAC5B,iBAAiB,EAAE;gBACjB,WAAW,EAAE,IAAI;gBACjB,kBAAkB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;gBAC1E,eAAe,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE;gBAC5C,mBAAmB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;aACxD;YACD,oEAAoE;YACpE,oEAAoE;YACpE,uEAAuE;YACvE,kEAAkE;YAClE,WAAW,EAAE;gBACX;oBACE,EAAE,EAAE,mBAAmB;oBACvB,IAAI,EAAE,4BAA4B;oBAClC,WAAW,EACT,2HAA2H;iBAC9H;aACF;SACF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}