@lucascouts/claude-agent-acp-plus 0.24.0 → 0.25.1

package/dist/permissions/response.js

@@ -1,4 +1,5 @@
 import { applyClaudePermissionSelection, parseClaudePermissionSelection } from "./effects.js";
+import { PERMISSION_OPTION_ID } from "./options/shared.js";
 /** Decode, validate, and interpret an ACP response exactly once. */
 export function decodeClaudePermissionResponse(response, toolName, input, toolUseID, offeredOptions, durableChangeSet) {
     const selection = parseClaudePermissionSelection(response, toolName);
@@ -17,3 +18,21 @@ export function decodeClaudePermissionResponse(response, toolName, input, toolUs
         ...(selection.contextResetMode ? { contextResetMode: selection.contextResetMode } : {}),
     };
 }
+/**
+ * Map the answer to a classifier-denial request. Only the three ids that
+ * request offers are accepted; anything else is an error, never an approval.
+ */
+export function decodeClassifierEscalationResponse(response) {
+    if (response.outcome.outcome === "cancelled")
+        return "cancelled";
+    switch (response.outcome.optionId) {
+        case PERMISSION_OPTION_ID.classifierAllowOnce:
+            return "once";
+        case PERMISSION_OPTION_ID.classifierAllowSession:
+            return "session";
+        case PERMISSION_OPTION_ID.reject:
+            return "reject";
+        default:
+            throw new Error(`Classifier escalation option was not offered: ${response.outcome.optionId}`);
+    }
+}

package/dist/task-feed.d.ts

@@ -19,6 +19,12 @@
  * progress, at once on an ending, and once more after a burst so the latest
  * values are not lost.
  *
+ * A foreground shell task (`local_bash`, not backgrounded) is held back for
+ * `FOREGROUND_SHELL_HOLD_MS`: Claude Code registers every shell command as a
+ * task, so only one still running after the hold, or moved to the background,
+ * is published. One that ends while held is dropped without a trace. The feed
+ * stays clock-driven: the publisher's timer calls `promoteDue()`.
+ *
  * Neither class ever copies a command line (`SDKTaskStartedMessage.prompt`)
  * into an entry or a log line.
  */
@@ -50,7 +56,9 @@ export type TasksSnapshot = {
     tasks: TaskEntry[];
 };
 /** What a message did to the table; the publisher decides timing from it. */
-export type TaskChange = "none" | "progress" | "terminal";
+export type TaskChange = "none" | "progress" | "terminal" | "held";
+/** How long a foreground shell task is held back before it is published. */
+export declare const FOREGROUND_SHELL_HOLD_MS = 5000;
 /** How long a running background task may be missing from the level before
  *  it is ended as `interrupted`. The level and the bookends race (the level
  *  may arrive first), so a real ending gets this long to land. */
@@ -85,8 +93,21 @@ export declare class TaskFeed {
     private readonly snapshotLives;
     /** task id → time after which a missing bookend means `interrupted`. */
     private readonly deadlines;
+    /** Foreground shell tasks not published yet: see `promoteDue`. */
+    private readonly held;
+    /** Shell task ids labelled by their tool call: a patch never relabels them. */
+    private readonly toolDescribed;
     constructor(clock: () => number, log?: TaskFeedLog, sessionId?: string);
-    onStarted(msg: SDKTaskStartedMessage): TaskChange;
+    /**
+     * `toolDescription` is the spawning tool call's own `description` input. A
+     * shell task carries it when it is non-empty; otherwise the SDK's, which
+     * for a shell is the command text. Other task types keep the SDK's.
+     */
+    onStarted(msg: SDKTaskStartedMessage, toolDescription?: string): TaskChange;
+    /** Publishes every held shell task whose hold has run out. */
+    promoteDue(): TaskChange;
+    /** When the earliest held shell task is due for promotion; null if none is held. */
+    nextHoldDue(): number | null;
     onProgress(msg: SDKTaskProgressMessage): TaskChange;
     onUpdated(msg: SDKTaskUpdatedMessage): TaskChange;
     onNotification(msg: SDKTaskNotificationMessage): TaskChange;
@@ -102,7 +123,8 @@ export declare class TaskFeed {
     nextReconcileAt(): number | null;
     /** Ends as `interrupted` every task whose deadline passed with no bookend. */
     reconcile(now: number): TaskChange;
-    /** The CLI process restarted: whatever was running did not survive it. */
+    /** The CLI process restarted: whatever was running did not survive it. A
+     *  held shell task was never shown, so it is dropped rather than ended. */
     onProcessRestart(): TaskChange;
     /** True when the feed holds `taskId` as running — the stop request's gate. */
     isRunning(taskId: string): boolean;
@@ -116,6 +138,15 @@ export declare class TaskFeed {
      *  dropped; the ids are remembered so a late bookend cannot resurrect them. */
     markPublished(endedIds: string[]): void;
     private running;
+    /** Puts a running entry into the table. A known id starting again is a new
+     *  life of the same task — a resumed subagent is re-registered under its
+     *  agent id. It replaces the ended entry, published or not: the running
+     *  state supersedes an ending the client has not seen yet, and a published
+     *  id must be shown again. */
+    private admit;
+    /** Applies a `task_updated` patch's label and placement; a label taken from
+     *  the tool call is never replaced. */
+    private patch;
     private end;
 }
 export type PublisherTimers = {
@@ -139,6 +170,9 @@ export declare class TaskFeedPublisher {
     private pending;
     private reconcileTimer;
     private reconcileAt;
+    /** Promotes held foreground shells: armed at the feed's `nextHoldDue()`. */
+    private holdTimer;
+    private holdAt;
     private closed;
     /** Set by `dispose({ flush: true })`: a publish queued behind an in-flight
      *  send still goes out once — a retirement's `interrupted` endings. */
@@ -152,6 +186,10 @@ export declare class TaskFeedPublisher {
     private settle;
     private arm;
     private cancelPending;
+    /** One timer for every held shell, at the earliest due time. A held shell
+     *  that ended early leaves the timer armed: it fires, promotes nothing, and
+     *  re-arms for the next one still held. */
+    private armHold;
     private armReconcile;
 }
 //# sourceMappingURL=task-feed.d.ts.map

package/dist/task-feed.d.ts.map

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

package/dist/task-feed.js

@@ -19,11 +19,19 @@
  * progress, at once on an ending, and once more after a burst so the latest
  * values are not lost.
  *
+ * A foreground shell task (`local_bash`, not backgrounded) is held back for
+ * `FOREGROUND_SHELL_HOLD_MS`: Claude Code registers every shell command as a
+ * task, so only one still running after the hold, or moved to the background,
+ * is published. One that ends while held is dropped without a trace. The feed
+ * stays clock-driven: the publisher's timer calls `promoteDue()`.
+ *
  * Neither class ever copies a command line (`SDKTaskStartedMessage.prompt`)
  * into an entry or a log line.
  */
 /** The `session_info_update._meta` key the snapshot is published under. */
 export const TASKS_META_KEY = "_claude/tasks";
+/** How long a foreground shell task is held back before it is published. */
+export const FOREGROUND_SHELL_HOLD_MS = 5000;
 /** How long a running background task may be missing from the level before
  *  it is ended as `interrupted`. The level and the bookends race (the level
  *  may arrive first), so a real ending gets this long to land. */
@@ -92,29 +100,39 @@ export class TaskFeed {
     snapshotLives = new Map();
     /** task id → time after which a missing bookend means `interrupted`. */
     deadlines = new Map();
+    /** Foreground shell tasks not published yet: see `promoteDue`. */
+    held = new Map();
+    /** Shell task ids labelled by their tool call: a patch never relabels them. */
+    toolDescribed = new Set();
     constructor(clock, log = {}, sessionId = "") {
         this.clock = clock;
         this.log = log;
         this.sessionId = sessionId;
     }
-    onStarted(msg) {
+    /**
+     * `toolDescription` is the spawning tool call's own `description` input. A
+     * shell task carries it when it is non-empty; otherwise the SDK's, which
+     * for a shell is the command text. Other task types keep the SDK's.
+     */
+    onStarted(msg, toolDescription) {
         if (msg.ambient) {
             this.ambient.add(msg.task_id);
             return "none";
         }
-        if (this.tasks.get(msg.task_id)?.status === "running")
+        if (this.tasks.get(msg.task_id)?.status === "running" || this.held.has(msg.task_id)) {
             return "none";
-        // A known id starting again is a new life of the same task — a resumed
-        // subagent is re-registered under its agent id. It replaces the ended
-        // entry, published or not: the running state supersedes an ending the
-        // client has not seen yet, and a published id must be shown again.
-        this.published.delete(msg.task_id);
-        this.lives.set(msg.task_id, (this.lives.get(msg.task_id) ?? 0) + 1);
-        this.tasks.set(msg.task_id, {
+        }
+        const shell = msg.task_type === "local_bash";
+        const fromTool = shell && typeof toolDescription === "string" && toolDescription.trim() !== "";
+        if (fromTool)
+            this.toolDescribed.add(msg.task_id);
+        else
+            this.toolDescribed.delete(msg.task_id);
+        const entry = {
             id: msg.task_id,
             toolCallId: msg.tool_use_id ?? null,
             type: normaliseType(msg.task_type),
-            description: msg.description,
+            description: fromTool ? toolDescription : msg.description,
             background: msg.is_backgrounded ?? false,
             depth: msg.spawn_depth ?? 0,
             status: "running",
@@ -123,27 +141,71 @@ export class TaskFeed {
             usage: null,
             lastTool: null,
             summary: null,
-        });
+        };
+        if (shell && msg.is_backgrounded !== true) {
+            this.held.set(msg.task_id, entry);
+            return "held";
+        }
+        this.admit(entry);
         return "progress";
     }
+    /** Publishes every held shell task whose hold has run out. */
+    promoteDue() {
+        const now = this.clock();
+        let change = "none";
+        for (const [id, entry] of this.held) {
+            if (entry.startedAt + FOREGROUND_SHELL_HOLD_MS > now)
+                continue;
+            this.held.delete(id);
+            this.admit(entry);
+            change = "progress";
+        }
+        return change;
+    }
+    /** When the earliest held shell task is due for promotion; null if none is held. */
+    nextHoldDue() {
+        let next = null;
+        for (const entry of this.held.values()) {
+            const due = entry.startedAt + FOREGROUND_SHELL_HOLD_MS;
+            if (next === null || due < next)
+                next = due;
+        }
+        return next;
+    }
     onProgress(msg) {
-        const task = this.running(msg.task_id, "task_progress");
+        const heldEntry = this.held.get(msg.task_id);
+        const task = heldEntry ?? this.running(msg.task_id, "task_progress");
         if (!task)
             return "none";
         task.usage = usageOf(msg.usage);
         task.lastTool = msg.last_tool_name ?? task.lastTool;
         task.summary = msg.summary ?? task.summary;
-        return "progress";
+        // Kept for the promotion, but nobody has been shown the task yet.
+        return heldEntry ? "none" : "progress";
     }
     onUpdated(msg) {
+        const heldEntry = this.held.get(msg.task_id);
+        if (heldEntry) {
+            if (msg.patch.is_backgrounded === true) {
+                // Moved to the background: published at once, then patched as usual.
+                this.held.delete(msg.task_id);
+                this.admit(heldEntry);
+            }
+            else {
+                if (normaliseStatus(msg.patch.status)) {
+                    this.held.delete(msg.task_id);
+                }
+                else {
+                    this.patch(heldEntry, msg.patch);
+                }
+                return "none";
+            }
+        }
         const task = this.running(msg.task_id, "task_updated");
         if (!task)
             return "none";
         const ending = normaliseStatus(msg.patch.status);
-        if (msg.patch.description !== undefined)
-            task.description = msg.patch.description;
-        if (msg.patch.is_backgrounded !== undefined)
-            task.background = msg.patch.is_backgrounded;
+        this.patch(task, msg.patch);
         if (ending) {
             this.end(task, ending);
             return "terminal";
@@ -151,6 +213,9 @@ export class TaskFeed {
         return "progress";
     }
     onNotification(msg) {
+        // A held shell task that ends was never shown: its ending is not news.
+        if (this.held.delete(msg.task_id))
+            return "none";
         const task = this.running(msg.task_id, "task_notification");
         if (!task)
             return "none";
@@ -205,8 +270,10 @@ export class TaskFeed {
         }
         return change;
     }
-    /** The CLI process restarted: whatever was running did not survive it. */
+    /** The CLI process restarted: whatever was running did not survive it. A
+     *  held shell task was never shown, so it is dropped rather than ended. */
     onProcessRestart() {
+        this.held.clear();
         let change = "none";
         for (const task of this.tasks.values()) {
             if (task.status !== "running")
@@ -256,6 +323,25 @@ export class TaskFeed {
         }
         return undefined;
     }
+    /** Puts a running entry into the table. A known id starting again is a new
+     *  life of the same task — a resumed subagent is re-registered under its
+     *  agent id. It replaces the ended entry, published or not: the running
+     *  state supersedes an ending the client has not seen yet, and a published
+     *  id must be shown again. */
+    admit(entry) {
+        this.published.delete(entry.id);
+        this.lives.set(entry.id, (this.lives.get(entry.id) ?? 0) + 1);
+        this.tasks.set(entry.id, entry);
+    }
+    /** Applies a `task_updated` patch's label and placement; a label taken from
+     *  the tool call is never replaced. */
+    patch(task, patch) {
+        if (patch.description !== undefined && !this.toolDescribed.has(task.id)) {
+            task.description = patch.description;
+        }
+        if (patch.is_backgrounded !== undefined)
+            task.background = patch.is_backgrounded;
+    }
     end(task, status, at = this.clock()) {
         task.status = status;
         task.endedAt = at;
@@ -283,6 +369,9 @@ export class TaskFeedPublisher {
     pending = null;
     reconcileTimer = null;
     reconcileAt = null;
+    /** Promotes held foreground shells: armed at the feed's `nextHoldDue()`. */
+    holdTimer = null;
+    holdAt = null;
     closed = false;
     /** Set by `dispose({ flush: true })`: a publish queued behind an in-flight
      *  send still goes out once — a retirement's `interrupted` endings. */
@@ -306,6 +395,9 @@ export class TaskFeedPublisher {
             else if (this.pending === null)
                 this.arm(wait);
         }
+        else if (change === "held") {
+            this.armHold();
+        }
         this.armReconcile();
     }
     dispose(options = {}) {
@@ -316,6 +408,10 @@ export class TaskFeedPublisher {
             this.timers.clearTimeout(this.reconcileTimer);
         this.reconcileTimer = null;
         this.reconcileAt = null;
+        if (this.holdTimer !== null)
+            this.timers.clearTimeout(this.holdTimer);
+        this.holdTimer = null;
+        this.holdAt = null;
     }
     publishNow() {
         this.cancelPending();
@@ -382,6 +478,40 @@ export class TaskFeedPublisher {
             this.timers.clearTimeout(this.pending);
         this.pending = null;
     }
+    /** One timer for every held shell, at the earliest due time. A held shell
+     *  that ended early leaves the timer armed: it fires, promotes nothing, and
+     *  re-arms for the next one still held. */
+    armHold() {
+        const at = this.feed.nextHoldDue();
+        if (at === null)
+            return;
+        if (this.holdAt !== null && this.holdAt <= at)
+            return;
+        if (this.holdTimer !== null)
+            this.timers.clearTimeout(this.holdTimer);
+        this.holdAt = at;
+        this.holdTimer = this.timers.setTimeout(() => {
+            this.holdTimer = null;
+            this.holdAt = null;
+            if (this.closed)
+                return;
+            // Outside the SDK loop nobody handles an error: a failed send is
+            // caught in `publishNow`, and anything else thrown is reported here.
+            try {
+                this.notify(this.feed.promoteDue());
+            }
+            catch (error) {
+                try {
+                    this.onSendError(error);
+                }
+                catch {
+                    // Re-arming matters more than the log line.
+                }
+            }
+            if (!this.closed)
+                this.armHold();
+        }, Math.max(0, at - this.timers.now()));
+    }
     armReconcile() {
         const at = this.feed.nextReconcileAt();
         if (at === null || at === this.reconcileAt)

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.24.0",
+  "version": "0.25.1",
   "description": "Claude Code in Zed and other ACP clients with the VS Code extension's UX — multi-select questions, refusal consent, live quota windows, background tasks, Ultracode effort and session notices. Fork of claude-agent-acp.",
   "main": "dist/lib.js",
   "types": "dist/lib.d.ts",