claude-code-acp-ts 0.99.2 → 0.99.3

package/dist/context-compaction.d.ts

@@ -70,10 +70,12 @@ export declare class ContextCompactionLifecycle {
      *
      * A `compaction_update` entity still `in_progress` here never received its
      * terminal signal from the runtime and gets its one terminal status,
-     * `cancelled`. The legacy tool call is deliberately left as it was (an
-     * `in_progress` call): ACP `ToolCallStatus` has no cancelled state and that
-     * presentation's behavior predates this lifecycle. Never throws — a failed
-     * send is logged, so callers can settle the turn unconditionally.
+     * `cancelled`. The legacy tool call has no `cancelled` status in ACP v1, so
+     * it is settled as `completed` with the outcome in `content` instead of
+     * being left `in_progress`: a client that counts unclosed tool calls would
+     * otherwise resend it after the turn, out of its original position. Never
+     * throws — a failed send is logged, so callers can settle the turn
+     * unconditionally.
      */
     reset(): Promise<void>;
     /** Abandon the current work before settling its prompt or tearing down the

package/dist/context-compaction.d.ts.map

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

package/dist/context-compaction.js

@@ -123,24 +123,30 @@ export class ContextCompactionLifecycle {
      *
      * A `compaction_update` entity still `in_progress` here never received its
      * terminal signal from the runtime and gets its one terminal status,
-     * `cancelled`. The legacy tool call is deliberately left as it was (an
-     * `in_progress` call): ACP `ToolCallStatus` has no cancelled state and that
-     * presentation's behavior predates this lifecycle. Never throws — a failed
-     * send is logged, so callers can settle the turn unconditionally.
+     * `cancelled`. The legacy tool call has no `cancelled` status in ACP v1, so
+     * it is settled as `completed` with the outcome in `content` instead of
+     * being left `in_progress`: a client that counts unclosed tool calls would
+     * otherwise resend it after the turn, out of its original position. Never
+     * throws — a failed send is logged, so callers can settle the turn
+     * unconditionally.
      */
     async reset() {
         const state = this.activeCompaction;
         this.activeCompaction = undefined;
         this.outputDelivered = false;
         this.duplicateErrorOutput = undefined;
-        if (!state || state.terminalStatus || this.presentation !== "compaction_update")
+        if (!state || state.terminalStatus)
             return;
         state.terminalStatus = "cancelled";
-        await this.sendQuietly({
-            sessionUpdate: "compaction_update",
-            compactionId: state.compactionId,
-            status: "cancelled",
-        }, "cancelled compaction");
+        if (this.presentation === "compaction_update") {
+            await this.sendQuietly({
+                sessionUpdate: "compaction_update",
+                compactionId: state.compactionId,
+                status: "cancelled",
+            }, "cancelled compaction");
+            return;
+        }
+        await this.sendQuietly(compactionToolCall.settled(state.compactionId, undefined, this.airClient), "settled compaction");
     }
     /** Abandon the current work before settling its prompt or tearing down the
      *  stream. Unlike a normal result boundary, its pending hooks are not safe
@@ -296,7 +302,12 @@ export class ContextCompactionLifecycle {
             });
             return;
         }
-        await this.send(compactionToolCall.finished(state.compactionId, opened || firstTerminal ? status : undefined, metadata, opened, this.airClient));
+        await this.send(compactionToolCall.finished(state.compactionId, 
+        // A status-less update is a patch for clients that merge, but a client
+        // that replaces the whole call reads it as "no longer terminal" and
+        // leaves the call running. Repeating the terminal status on the
+        // enriching update is idempotent for both.
+        opened || firstTerminal || enrichTerminal ? status : undefined, metadata, opened, this.airClient));
     }
     /** Make `compactionId` the active entity, moving a pending hook summary onto
      *  it, and mark compaction output as delivered for the owning turn. */

package/dist/tool-calls/reporters/compaction.d.ts

@@ -17,6 +17,16 @@ type ToolCallUpdate = SessionNotification["update"];
 export declare const compactionToolCall: {
     started(compactionId: string, airClient?: boolean): ToolCallUpdate;
     inProgress(compactionId: string, airClient?: boolean): ToolCallUpdate;
+    /**
+     * Settle a compaction that was abandoned at a turn boundary, so the call
+     * does not stay `in_progress` forever.
+     *
+     * ACP v1's `ToolCallStatus` has no `cancelled` value, so this closes as
+     * `completed` and says what actually happened in `content`. Clients that
+     * treat a call without a terminal status as unclosed would otherwise resend
+     * it later, out of order.
+     */
+    settled(compactionId: string, note?: string, airClient?: boolean): ToolCallUpdate;
     /** The terminal report. A missed opening makes it the first report, a `tool_call`. */
     finished(compactionId: string, status: "completed" | "failed" | undefined, facts: CompactionFacts, first: boolean, airClient?: boolean): ToolCallUpdate;
 };

package/dist/tool-calls/reporters/compaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../src/tool-calls/reporters/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EACL,KAAK,yBAAyB,EAE/B,MAAM,kCAAkC,CAAC;AAG1C,KAAK,eAAe,GAAG,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC,CAAC;AAClE,KAAK,cAAc,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAIpD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB;0BACP,MAAM,wBAAsB,cAAc;6BAWvC,MAAM,wBAAsB,cAAc;IASnE,sFAAsF;2BAEtE,MAAM,UACZ,WAAW,GAAG,QAAQ,GAAG,SAAS,SACnC,eAAe,SACf,OAAO,wBAEb,cAAc;CA2BlB,CAAC"}
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../src/tool-calls/reporters/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EACL,KAAK,yBAAyB,EAE/B,MAAM,kCAAkC,CAAC;AAG1C,KAAK,eAAe,GAAG,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC,CAAC;AAClE,KAAK,cAAc,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAgCpD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB;0BACP,MAAM,wBAAsB,cAAc;6BAWvC,MAAM,wBAAsB,cAAc;IASnE;;;;;;;;OAQG;0BACmB,MAAM,uCAA2C,cAAc;IAUrF,sFAAsF;2BAEtE,MAAM,UACZ,WAAW,GAAG,QAAQ,GAAG,SAAS,SACnC,eAAe,SACf,OAAO,wBAEb,cAAc;CAqClB,CAAC"}

package/dist/tool-calls/reporters/compaction.js

@@ -1,6 +1,31 @@
 import { createContextCompactionMeta, } from "../../context-compaction-meta.js";
 import { textContent } from "../content.js";
 const TITLE = "Compact conversation";
+/** The note a settled (never finished) compaction carries as its result. */
+const SETTLED_NOTE = "Context compaction was cancelled before it finished; the conversation was not summarized.";
+/** The human-readable result of a compaction, for clients that show `content`. */
+function factsText(facts) {
+    // Widened to `string`: upstream added the `idle` trigger after this release,
+    // and a comparison against it must not be a type error here or after the
+    // next rebase.
+    const trigger = facts.trigger;
+    const what = trigger === "idle"
+        ? "Context compacted while idle"
+        : trigger === "manual"
+            ? "Context compacted on request"
+            : "Context compacted";
+    const details = [];
+    if (typeof facts.preTokens === "number" && typeof facts.postTokens === "number") {
+        details.push(`${facts.preTokens} -> ${facts.postTokens} tokens`);
+    }
+    else if (typeof facts.postTokens === "number") {
+        details.push(`${facts.postTokens} tokens after compaction`);
+    }
+    if (typeof facts.durationMs === "number") {
+        details.push(`${(facts.durationMs / 1000).toFixed(1)}s`);
+    }
+    return details.length > 0 ? `${what}: ${details.join(", ")}` : what;
+}
 /**
  * The synthetic "Compact conversation" tool call, for a client without the
  * ACP compaction updates.
@@ -32,11 +57,36 @@ export const compactionToolCall = {
             _meta: meta({}, airClient),
         };
     },
+    /**
+     * Settle a compaction that was abandoned at a turn boundary, so the call
+     * does not stay `in_progress` forever.
+     *
+     * ACP v1's `ToolCallStatus` has no `cancelled` value, so this closes as
+     * `completed` and says what actually happened in `content`. Clients that
+     * treat a call without a terminal status as unclosed would otherwise resend
+     * it later, out of order.
+     */
+    settled(compactionId, note = SETTLED_NOTE, airClient = false) {
+        return {
+            sessionUpdate: "tool_call_update",
+            toolCallId: compactionId,
+            status: "completed",
+            content: [textContent(note)],
+            _meta: meta({}, airClient),
+        };
+    },
     /** The terminal report. A missed opening makes it the first report, a `tool_call`. */
     finished(compactionId, status, facts, first, airClient = false) {
         const errorContent = status === "failed" && facts.error
             ? { content: [textContent(`Compaction failed: ${facts.error}`)] }
             : {};
+        // A client that renders `content` needs something to expand; `rawOutput`
+        // alone is opaque. The error, when there is one, is the result instead.
+        // AIR reads every fact from `_meta.jetbrains.air.contextCompaction`, so it
+        // gets no `content`: the docs ask for each fact once.
+        const factsContent = airClient || "content" in errorContent || Object.keys(facts).length === 0
+            ? {}
+            : { content: [textContent(factsText(facts))] };
         const rawOutput = !airClient && Object.keys(facts).length > 0 ? { rawOutput: facts } : {};
         if (first) {
             return {
@@ -46,6 +96,7 @@ export const compactionToolCall = {
                 kind: "think",
                 status: status ?? "completed",
                 ...errorContent,
+                ...factsContent,
                 ...rawOutput,
                 _meta: meta(facts, airClient),
             };
@@ -55,6 +106,7 @@ export const compactionToolCall = {
             toolCallId: compactionId,
             ...(status ? { status } : {}),
             ...errorContent,
+            ...factsContent,
             ...rawOutput,
             _meta: meta(facts, airClient),
         };

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.99.2",
+  "version": "0.99.3",
   "description": "An ACP-compatible coding agent powered by the Claude Agent SDK (TypeScript)",
   "main": "dist/lib.js",
   "types": "dist/lib.d.ts",