acp-kernel 0.0.15 → 0.0.17

package/dist/protected.d.ts

@@ -8,20 +8,23 @@ export declare const ALWAYS_PROTECTED_TOOLS: readonly ["compress"];
 /** Tool results that must NEVER participate in the soft-protected recent zone
  *  (preserveRecentMessages / preserveRecentTokens / last user message).
  *
- *  `decompress` returns large restored content as an inline tool result. If it
- *  lands in the last-N window it becomes un-compressible: the model cannot
- *  reclaim that context, and it never appears in the compressible-ranges
- *  recommendation list. Excluding it from the protected zone lets the model
- *  compress it again immediately, while still leaving it visible (the host's
- *  preserveRecent is about not compressing the active working set, not about
- *  which tool results are in scope).
+ *  These tools return large content (restored blocks, search hits, file bodies,
+ *  command output). If such a result lands in the last-N window it becomes
+ *  un-compressible: the model cannot reclaim that context, and it never appears
+ *  in the compressible-ranges recommendation list. Excluding these tools from
+ *  the protected zone lets the model compress them again immediately, while
+ *  still leaving them visible (the host's preserveRecent is about not
+ *  compressing the active working set, not about which tool results are in
+ *  scope).
  *
- *  `search_context` returns large result lists (10 ranked hits with previews).
- *  Same reasoning: excluding it from the protected zone keeps it compressible.
+ *  - `decompress`: large restored content as an inline tool result.
+ *  - `search_context`: large result lists (10 ranked hits with previews).
+ *  - `read`: file/image contents — the largest common source of context bloat.
+ *  - `bash`: command output (build/test/logs) — frequently large and spent.
  *
  *  Note: this only affects the recent-zone computation. Such messages remain
  *  fully visible and compressible like any ordinary message. */
-export declare const NEVER_PRESERVE_RECENT_TOOLS: readonly ["decompress", "search_context"];
+export declare const NEVER_PRESERVE_RECENT_TOOLS: readonly ["decompress", "search_context", "read", "bash"];
 /** True for tool-call / tool-result messages whose toolName is in the
  *  NEVER_PRESERVE_RECENT_TOOLS list — i.e. tool results (like decompress)
  *  that should be excluded from the soft-protected recent zone. */

package/dist/protected.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protected.d.ts","sourceRoot":"","sources":["../src/protected.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;kFAIkF;AAClF,eAAO,MAAM,sBAAsB,uBAAwB,CAAC;AAE5D;;;;;;;;;;;;;;;gEAegE;AAChE,eAAO,MAAM,2BAA2B,2CAA4C,CAAC;AAErF;;mEAEmE;AACnE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAM/D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAK3E;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,GACzD,OAAO,CAsBT;AAED;;;8DAG8D;AAC9D,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,WAAW,EAAE,EACvB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,GACzD,GAAG,CAAC,MAAM,CAAC,CAQb;AAED;iFACiF;AACjF,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,EAC1D,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC5B,OAAO,CAUT"}
+{"version":3,"file":"protected.d.ts","sourceRoot":"","sources":["../src/protected.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;kFAIkF;AAClF,eAAO,MAAM,sBAAsB,uBAAwB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;gEAkBgE;AAChE,eAAO,MAAM,2BAA2B,2DAK9B,CAAC;AAEX;;mEAEmE;AACnE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAM/D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAK3E;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,GACzD,OAAO,CAsBT;AAED;;;8DAG8D;AAC9D,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,WAAW,EAAE,EACvB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,GACzD,GAAG,CAAC,MAAM,CAAC,CAQb;AAED;iFACiF;AACjF,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,EAC1D,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC5B,OAAO,CAUT"}

package/dist/render-refs.d.ts

@@ -1,5 +1,20 @@
 import type { CoreMessage, CompressionState } from "./types.js";
 import type { PipelineNode } from "./pipeline.js";
-export declare function renderVisibleRefs(messages: CoreMessage[], state: CompressionState, countTokens?: (text: string) => number): CoreMessage[];
+/**
+ * Controls which messages get an <acp> ref tag injected into their text.
+ * Ref assignment (assignRefsNode) is unconditional — every message always
+ * receives a ref in state.messageRefs regardless of this setting. This only
+ * governs text rendering:
+ *  - "all": tag every mapped message (in-process hosts like pai-acp)
+ *  - "text-only": tag only user/assistant text; leave tool-call args and
+ *    tool-result content pristine (proxy hosts — structured content must not
+ *    be polluted)
+ *  - "none": leave all text untouched (hosts that read the ref map directly)
+ */
+export type RenderStrategy = "all" | "text-only" | "none";
+export declare function renderVisibleRefs(messages: CoreMessage[], state: CompressionState, countTokens?: (text: string) => number, strategy?: RenderStrategy): CoreMessage[];
+/** Factory: build a render-refs node bound to a specific render strategy. */
+export declare function createRenderRefsNode(strategy: RenderStrategy): PipelineNode;
+/** Backward compat: default render-refs node using strategy "all". */
 export declare const renderRefsNode: PipelineNode;
 //# sourceMappingURL=render-refs.d.ts.map

package/dist/render-refs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-refs.d.ts","sourceRoot":"","sources":["../src/render-refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAiB,MAAM,YAAY,CAAC;AAE/E,OAAO,KAAK,EAAE,YAAY,EAA2B,MAAM,eAAe,CAAC;AAuD3E,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,gBAAgB,EACvB,WAAW,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MACH,GAC3B,WAAW,EAAE,CAKf;AAED,eAAO,MAAM,cAAc,EAAE,YAQ5B,CAAC"}
+{"version":3,"file":"render-refs.d.ts","sourceRoot":"","sources":["../src/render-refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAiB,MAAM,YAAY,CAAC;AAE/E,OAAO,KAAK,EAAE,YAAY,EAA2B,MAAM,eAAe,CAAC;AAE3E;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;AAgE1D,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,gBAAgB,EACvB,WAAW,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MACH,EAC5B,QAAQ,GAAE,cAAsB,GAC/B,WAAW,EAAE,CAKf;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,YAAY,CAU3E;AAED,sEAAsE;AACtE,eAAO,MAAM,cAAc,EAAE,YAA0C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "acp-kernel",
-    "version": "0.0.15",
+    "version": "0.0.17",
     "description": "Framework-agnostic context-compression engine (model-driven, 3-tier LSM). Pure core: no host dependency.",
     "license": "MIT",
     "author": "ranxianglei",