billion-context-pi 0.1.76-pr.512.330 → 0.1.76

package/README.md

@@ -253,11 +253,12 @@ The model receives detailed guidance (in its system prompt) on **when** to compr
 
 ### What gets protected
 
-billion-context protects three categories of content from compression:
+billion-context protects four categories of content from compression:
 
 1. **Always-protected tools** — `compress` calls are hard-protected (they're load-bearing metadata; compressing them breaks decompress and the "summary is historical" contract).
 2. **Soft recent-zone** — the last N messages (default 5) and last ~5K tokens are soft-protected so the model keeps its working set. Tool results from `decompress`, `search_context`, `read`, and `bash` are **excluded** from this zone: they're large and meant to be compressible once consumed, so they don't eat the protected budget.
 3. **Last user message** — always protected (user intent must survive).
+4. **User-configured tool protection** — `protectedTools` / `protectedLatestTools` in `acp.json` hard-exclude matched tool calls+results (full history vs. latest-only; see [CONFIGURATION.md](./CONFIGURATION.md)).
 
 ## Session storage & migration
 

package/README.zh-CN.md

@@ -242,11 +242,12 @@ grep '\[error\]' ~/.pi/acp.log        # 汇总所有记录的失败
 
 ### 哪些内容会被保护
 
-billion-context 保护三类内容不被压缩:
+billion-context 保护四类内容不被压缩:
 
 1. **永久保护的工具** — `compress` 调用被硬保护(它们是承载关键元数据的;压缩它们会破坏 decompress 和"摘要是历史"的契约)。
 2. **软近期区** — 最后 N 条消息(默认 5)和最后约 5K token 被软保护,让模型保留工作集。来自 `decompress`、`search_context`、`read`、`bash` 的工具结果被**排除**出此区:它们体量大、消费后就该能压缩,所以不该占用保护预算。
 3. **最后一条用户消息** — 始终保护(用户意图必须存活)。
+4. **用户配置的工具保护** — `acp.json` 中的 `protectedTools` / `protectedLatestTools` 硬排除匹配的工具 call+result(全历史 vs 仅最近一次;见 [CONFIGURATION.zh-CN.md](./CONFIGURATION.zh-CN.md))。
 
 ## 会话存储与迁移
 

package/dist/config.d.ts

@@ -216,7 +216,18 @@ export interface AdapterConfig {
     /** When omitted, the adapter reads `ctx.model.contextWindow` live each turn.
      *  Set explicitly for tests/headless runs. */
     modelContextLimit?: number;
+    /** Tool-name patterns (glob suffix allowed) whose EVERY call+result pair is
+     *  hard-excluded from compression — matching refs render as BLOCKED in every
+     *  view. Default: none. Intended for low-frequency high-value tools whose
+     *  outputs are independent content (e.g. skill loads); do NOT use for chatty
+     *  tools — protecting every instance grows context unboundedly (#639
+     *  rationale). Settable via acp.json since #499. */
     protectedTools?: string[];
+    /** Tool-name patterns (glob suffix allowed) whose LATEST call+result pair is
+     *  hard-excluded from compression; older pairs remain compressible. Default:
+     *  none. Intended for cumulative-snapshot tools where each call supersedes
+     *  the last. Settable via acp.json since #499. */
+    protectedLatestTools?: string[];
     preserveRecentMessages?: number;
     /** Check npm for a newer billion-context-pi on startup and auto-install it. Default: true.
      *  Disable via `autoUpdate: false` or env `ACP_AUTO_UPDATE=0` to avoid all

package/dist/index.js

@@ -170,6 +170,8 @@ var KNOWN = /* @__PURE__ */ new Set([
   "debug",
   "autoUpdate",
   "modelContextLimit",
+  "protectedTools",
+  "protectedLatestTools",
   "toolBashDefaultTimeout",
   "toolOutputMaxBytes",
   "delegate",
@@ -195,13 +197,27 @@ function pickKnown(parsed) {
   return out;
 }
 function applyUserConfig(adapter, user) {
-  return {
+  const result = {
     ...adapter,
     ...user,
     coreOverrides: adapter.coreOverrides,
-    protectedTools: adapter.protectedTools,
     preserveRecentMessages: adapter.preserveRecentMessages
   };
+  for (const key of ["protectedTools", "protectedLatestTools"]) {
+    if (!(key in user)) continue;
+    const cleaned = cleanProtectionList(key, user[key]);
+    if (cleaned !== void 0) result[key] = cleaned;
+    else if (adapter[key] !== void 0) result[key] = adapter[key];
+    else delete result[key];
+  }
+  return result;
+}
+function cleanProtectionList(key, value) {
+  if (!Array.isArray(value) || value.length === 0 || !value.every((v2) => typeof v2 === "string" && v2.trim() !== "")) {
+    console.warn(`[bcp] acp.json "${key}" must be a non-empty array of non-empty strings \u2014 ignoring the value`);
+    return void 0;
+  }
+  return value.map((v2) => v2.trim());
 }
 
 // src/index.ts
@@ -5680,6 +5696,7 @@ function resolveConfig(adapter, liveContextLimit, provider, modelId) {
   const limit = !Number.isNaN(envLimitNum) && envLimitNum > 0 ? envLimitNum : adapter.modelContextLimit && adapter.modelContextLimit > 0 ? adapter.modelContextLimit : liveContextLimit > 0 ? liveContextLimit : FALLBACK_LIMIT;
   const config = defaultConfig(limit, {
     protectedTools: adapter.protectedTools ?? [],
+    protectedLatestTools: adapter.protectedLatestTools ?? [],
     preserveRecentMessages: adapter.preserveRecentMessages ?? 5,
     ...adapter.coreOverrides
   });