billion-context-pi 0.1.75-pr.493.309 → 0.1.75

package/README.md

@@ -76,14 +76,6 @@ pi install npm:billion-context-pi
 
 That's it. The extension auto-loads on next Pi startup. No configuration needed — it reads your model's context window automatically.
 
-**Prefer a stable channel?** Install with the `stable` dist-tag instead:
-
-```bash
-pi install npm:billion-context-pi@stable
-```
-
-Stable releases are cut explicitly (less often than regular releases). Stable installs auto-update to the newest *stable* release only — regular releases and dev prereleases never reach them. Plain installs track `latest`. Switch channels at any time by reinstalling with the other spec.
-
 > **Using another sub-agent extension?** billion-context-pi ships its own `acp_delegate` sub-agent tool (see below) at a fraction of the context cost (~600 tok vs ~7K tok/turn). Two delegation tools in one session only make the model's choice noisier, so pick one:
 > - **Use ACP's delegate** — remove the other extension: `pi remove npm:pi-subagents`
 > - **Keep your own sub-agent** — turn ACP's delegate off in `acp.json`: `{ "delegate": false }` (see *Using your own sub-agent instead* below)

package/README.zh-CN.md

@@ -75,14 +75,6 @@ pi install npm:billion-context-pi
 
 完成。扩展在下次 Pi 启动时自动加载。无需配置 —— 它会自动读取模型的上下文窗口。
 
-**想用 stable 通道?** 改用 `stable` dist-tag 安装:
-
-```bash
-pi install npm:billion-context-pi@stable
-```
-
-stable 版本是显式指定发布的(频率低于常规发版)。stable 安装的自动更新只追最新的 *stable* 正式版 —— 常规正式版和 dev 预发布版都不会推给它们。普通安装跟踪 `latest`。随时可以用另一个 spec 重装来切换通道。
-
 > **你另有子代理扩展?** billion-context-pi 自带 `acp_delegate` 子代理工具(见下文),上下文成本极低(~600 tok vs ~7K tok/轮)。同一会话里两套委派工具只会让模型的选择更混乱,二选一:
 > - **用 ACP 的 delegate** —— 卸载另一个扩展:`pi remove npm:pi-subagents`
 > - **保留你自己的子代理** —— 在 `acp.json` 里关掉 ACP 的 delegate:`{ "delegate": false }`(见下文*改用你自己的子代理*)

package/dist/abort.d.ts

@@ -0,0 +1 @@
+export declare function assertNotAborted(signal: AbortSignal | undefined): void;

package/dist/config.d.ts

@@ -152,6 +152,16 @@ export interface CompressSettings {
      *  overrides only; a pack's `toolPrompts` follow the base selection (tool
      *  definitions freeze at extension load, before the model is known). */
     promptPack?: string;
+    /** Opt-in wire-level strip of historical image payloads (issue #321, kernel
+     *  #215). Default: false (images ride along verbatim, current behavior).
+     *  When true, every message older than `stripImagesKeepRecent` has its image
+     *  parts dropped from the outbound provider body (image-only messages
+     *  collapse to a "[image]" text placeholder). Host-side policy only — the
+     *  strip primitive lives in acp-kernel's wire layer. */
+    stripImages?: boolean;
+    /** How many of the MOST RECENT messages keep their image payloads when
+     *  `stripImages` is enabled. Default: 5. Ignored when stripImages is off. */
+    stripImagesKeepRecent?: number;
 }
 /** Per-provider compression overrides. Carries the same tuning fields as the
  *  global level, plus an optional per-model map keyed by model id. */

package/dist/index.js

@@ -5631,7 +5631,9 @@ function mergeCompress(global, provider, model) {
       drop: model?.reasoning?.drop ?? provider?.reasoning?.drop ?? global?.reasoning?.drop,
       threshold: model?.reasoning?.threshold ?? provider?.reasoning?.threshold ?? global?.reasoning?.threshold
     },
-    promptPack: model?.promptPack ?? provider?.promptPack ?? global?.promptPack
+    promptPack: model?.promptPack ?? provider?.promptPack ?? global?.promptPack,
+    stripImages: model?.stripImages ?? provider?.stripImages ?? global?.stripImages,
+    stripImagesKeepRecent: model?.stripImagesKeepRecent ?? provider?.stripImagesKeepRecent ?? global?.stripImagesKeepRecent
   };
 }
 function resolveCompress(compress, provider, modelId) {
@@ -7331,6 +7333,13 @@ function createRuntime(adapter) {
     }
     return gated;
   }
+  function stripImagesFor(ctx) {
+    const m2 = ctx.model;
+    const c = resolveCompress(adapterRef.compress, m2?.provider, m2?.id);
+    const raw = Number(c.stripImagesKeepRecent);
+    const keepRecent = Number.isFinite(raw) && raw >= 0 ? Math.floor(raw) : 5;
+    return { enabled: c.stripImages === true, keepRecent };
+  }
   async function reloadConfig(cwd) {
     let user;
     try {
@@ -7434,7 +7443,7 @@ function createRuntime(adapter) {
     return promptsRef;
   }, setPrompts: (p) => {
     promptsRef = p;
-  }, markNudgeShown, nudgeShownFor, nudgeShownTokensFor, clearNudgeTracking, clearNudgeTokenStamps, noteCompressOutcomes, compressRetryCappedFor, clearCompressRetryTracking, liveContextLimit, configFor, reasoningDropFor, reloadConfig, stateFor, save, deriveChildState: deriveChild, acquireLock, overflowFor, overflowDrop, noteDeadCompress, clearDeadCompress, throttleFor, throttleDrop, noteTokenScale, dropTokenScale, noteHostUsage, dropHostUsageSamples, noteSizeDivergence, dropSizeDivergence, noteTerminalEscape, dropTerminalEscape, noteTruncationSkipped, dropTruncationSkipped };
+  }, markNudgeShown, nudgeShownFor, nudgeShownTokensFor, clearNudgeTracking, clearNudgeTokenStamps, noteCompressOutcomes, compressRetryCappedFor, clearCompressRetryTracking, liveContextLimit, configFor, reasoningDropFor, reloadConfig, stateFor, save, deriveChildState: deriveChild, acquireLock, overflowFor, overflowDrop, noteDeadCompress, clearDeadCompress, throttleFor, throttleDrop, noteTokenScale, dropTokenScale, noteHostUsage, dropHostUsageSamples, noteSizeDivergence, dropSizeDivergence, noteTerminalEscape, dropTerminalEscape, noteTruncationSkipped, dropTruncationSkipped, stripImagesFor };
 }
 
 // node_modules/typebox/build/system/memory/memory.mjs
@@ -11888,6 +11897,14 @@ function adjustedTokenCount(core, messages, state, config, prelim, imageTokensBy
   return view.drifted ? view.viewTokens : prelim;
 }
 
+// src/abort.ts
+function assertNotAborted(signal) {
+  if (!signal?.aborted) return;
+  const err = new Error("Operation aborted");
+  err.name = "AbortError";
+  throw err;
+}
+
 // src/compat.ts
 function normalizeSystemPrompt(input) {
   if (input === void 0) return "";
@@ -11959,11 +11976,11 @@ function makeCompressTool(runtime, overrides) {
       "Never compress content the current step is actively using."
     ],
     parameters: CompressParams,
-    async execute(toolCallId, params, _signal, _onUpdate, ctx) {
+    async execute(toolCallId, params, signal, _onUpdate, ctx) {
       if (runtime.refused) return { details: void 0, content: [{ type: "text", text: runtime.refusalMessage ?? UNSUPPORTED_HOST_MESSAGE }] };
       let result;
       try {
-        result = await handleCompress(params, runtime, ctx, toolCallId);
+        result = await handleCompress(params, runtime, ctx, toolCallId, signal);
       } catch (e) {
         logThrow("compress", e, { sid: ctx.sessionManager.getSessionId(), ranges: typeof params.content === "string" ? "string" : params.content?.length ?? 0 });
         throw e;
@@ -12219,12 +12236,14 @@ function tierReadyHint(state, config) {
   }
   return "";
 }
-async function handleCompress(args, runtime, ctx, toolCallId) {
+async function handleCompress(args, runtime, ctx, toolCallId, signal) {
+  assertNotAborted(signal);
   const maybeRanges = normalizeRanges(args);
   if (typeof maybeRanges === "string") throw new Error(maybeRanges);
   const ranges = maybeRanges;
   if (ranges.length === 0) return "No ranges provided.";
   const { state: initialState, coreMessages, entries } = await runtime.stateFor(ctx);
+  assertNotAborted(signal);
   const config = runtime.configFor(ctx);
   const modelId = ctx.model?.id ?? "default";
   const systemPromptText = getSystemPromptText(ctx);
@@ -12281,6 +12300,7 @@ async function handleCompress(args, runtime, ctx, toolCallId) {
     state,
     config
   });
+  assertNotAborted(signal);
   const rewriteSpans = applied.result.blocksCreated > 0 ? tier3OnlyRewrite(applied.state.blocks.slice(-applied.result.blocksCreated), applied.state.blocks) : null;
   if (rewriteSpans) {
     await runtime.save(state, ctx);
@@ -12389,11 +12409,11 @@ function makeDecompressTool(runtime, overrides) {
       "Use full:true to recurse through all nested tiers to original messages."
     ],
     parameters: DecompressParams,
-    async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+    async execute(_toolCallId, params, signal, _onUpdate, ctx) {
       if (runtime.refused) return { details: void 0, content: [{ type: "text", text: runtime.refusalMessage ?? UNSUPPORTED_HOST_MESSAGE }] };
       let result;
       try {
-        result = await handleDecompress(params, runtime, ctx);
+        result = await handleDecompress(params, runtime, ctx, signal);
       } catch (e) {
         logThrow("decompress", e, { sid: ctx.sessionManager.getSessionId(), blockId: params.blockId });
         throw e;
@@ -12506,8 +12526,10 @@ ${text}`;
     headPreview(text)
   ].join("\n");
 }
-async function handleDecompress(args, runtime, ctx) {
+async function handleDecompress(args, runtime, ctx, signal) {
+  assertNotAborted(signal);
   const { state, coreMessages } = await runtime.stateFor(ctx);
+  assertNotAborted(signal);
   const arg = (args.blockId ?? "").trim();
   const owner = state.blocks.find((b2) => b2.effectiveMessageIds.includes(arg));
   if (owner) {
@@ -12536,6 +12558,7 @@ ${text}`;
     logError("decompress", { sid: ctx.sessionManager.getSessionId(), event: "block-path-rejected", blockId, toFile: args.toFile });
     return targetPath.error;
   }
+  assertNotAborted(signal);
   await mkdir(AUTO_DIR, { recursive: true }).catch(() => {
   });
   await writeFile(targetPath, text, "utf8");
@@ -19727,8 +19750,148 @@ function degenerationNotice(runs2) {
   };
 }
 
-// src/tool-guardrails.ts
+// node_modules/acp-kernel/dist/wire/index.js
 import { createHash as createHash2 } from "crypto";
+function hashId(s) {
+  return createHash2("sha256").update(s, "utf8").digest("hex").slice(0, 16);
+}
+function createSubagentNamespaces() {
+  const anchors = /* @__PURE__ */ new Map();
+  return {
+    namespaceFor(identityValue, instructions) {
+      if (typeof instructions !== "string" || instructions.trim().length === 0) return identityValue;
+      const fp = hashId(instructions);
+      const anchor = anchors.get(identityValue);
+      if (anchor === void 0) {
+        anchors.set(identityValue, fp);
+        return identityValue;
+      }
+      return anchor === fp ? identityValue : `${identityValue}|sub:${fp}`;
+    }
+  };
+}
+var defaultNamespaces = createSubagentNamespaces();
+var IMAGE_PLACEHOLDER = "[image]";
+function isObj(v2) {
+  return typeof v2 === "object" && v2 !== null;
+}
+function isImagePart(protocol, part) {
+  if (!isObj(part)) return false;
+  if (protocol === "responses") return part.type === "input_image";
+  if (protocol === "openai") return part.type === "image_url";
+  if (protocol === "google")
+    return isObj(part.inlineData) || isObj(part.fileData);
+  return part.type === "image";
+}
+function placeholderContent(protocol) {
+  if (protocol === "google") return [{ text: IMAGE_PLACEHOLDER }];
+  const type = protocol === "responses" ? "input_text" : "text";
+  return [{ type, text: IMAGE_PLACEHOLDER }];
+}
+function stripHistoricalImages(body, protocol, keepRecent) {
+  if (!protocol || !isObj(body)) return { body, removed: 0 };
+  const recentCount = Math.max(0, Math.floor(keepRecent));
+  if (protocol === "responses") {
+    const input = body.input;
+    if (!Array.isArray(input)) return { body, removed: 0 };
+    const cutoff2 = input.length - recentCount;
+    let removed2 = 0;
+    let touched2 = false;
+    const nextInput = input.map((item, i) => {
+      if (i < cutoff2 && isObj(item) && Array.isArray(item.content)) {
+        const content = item.content;
+        const imgs = content.filter((p) => isImagePart("responses", p)).length;
+        if (imgs > 0) {
+          removed2 += imgs;
+          touched2 = true;
+          const kept = content.filter((p) => !isImagePart("responses", p));
+          return {
+            ...item,
+            content: kept.length > 0 ? kept : placeholderContent("responses")
+          };
+        }
+      }
+      return item;
+    });
+    if (!touched2) return { body, removed: 0 };
+    return { body: { ...body, input: nextInput }, removed: removed2 };
+  }
+  if (protocol === "google") {
+    const contents = body.contents;
+    if (!Array.isArray(contents)) return { body, removed: 0 };
+    const cutoff2 = contents.length - recentCount;
+    let removed2 = 0;
+    let touched2 = false;
+    const nextContents = contents.map((c, i) => {
+      if (i < cutoff2 && isObj(c) && Array.isArray(c.parts)) {
+        const parts = c.parts;
+        const imgs = parts.filter((p) => isImagePart("google", p)).length;
+        if (imgs > 0) {
+          removed2 += imgs;
+          touched2 = true;
+          const kept = parts.filter((p) => !isImagePart("google", p));
+          return {
+            ...c,
+            parts: kept.length > 0 ? kept : placeholderContent("google")
+          };
+        }
+      }
+      return c;
+    });
+    if (!touched2) return { body, removed: 0 };
+    return { body: { ...body, contents: nextContents }, removed: removed2 };
+  }
+  const messages = body.messages;
+  if (!Array.isArray(messages)) return { body, removed: 0 };
+  const cutoff = messages.length - recentCount;
+  let removed = 0;
+  let touched = false;
+  const nextMessages = messages.map((m2, i) => {
+    if (i < cutoff && isObj(m2) && Array.isArray(m2.content)) {
+      const content = m2.content;
+      const imgs = content.filter((p) => isImagePart(protocol, p)).length;
+      if (imgs > 0) {
+        removed += imgs;
+        touched = true;
+        const kept = content.filter((p) => !isImagePart(protocol, p));
+        return {
+          ...m2,
+          content: kept.length > 0 ? kept : placeholderContent(protocol)
+        };
+      }
+    }
+    return m2;
+  });
+  if (!touched) return { body, removed: 0 };
+  return { body: { ...body, messages: nextMessages }, removed };
+}
+
+// src/strip-images.ts
+function apiToStripProtocol(api) {
+  switch (api) {
+    case "anthropic-messages":
+      return "anthropic";
+    case "openai-completions":
+      return "openai";
+    case "openai-responses":
+    case "azure-openai-responses":
+    case "openai-codex-responses":
+      return "responses";
+    default:
+      return null;
+  }
+}
+function applyStripImages(body, api, settings2) {
+  if (!settings2.enabled) return { removed: 0 };
+  const protocol = apiToStripProtocol(api);
+  if (!protocol) return { removed: 0 };
+  const result = stripHistoricalImages(body, protocol, settings2.keepRecent);
+  if (result.removed === 0) return { removed: 0 };
+  return { body: result.body, removed: result.removed };
+}
+
+// src/tool-guardrails.ts
+import { createHash as createHash3 } from "crypto";
 function isBashToolResult(e) {
   return e.toolName === "bash";
 }
@@ -19829,7 +19992,7 @@ function canonicalStringify(value) {
 function repetitionFingerprint(toolName, input) {
   const payload = `${toolName}\0${canonicalStringify(input ?? {})}`;
   try {
-    return createHash2("sha1").update(payload).digest("hex");
+    return createHash3("sha1").update(payload).digest("hex");
   } catch {
     return `unhashable:${toolName}`;
   }
@@ -19942,13 +20105,13 @@ import { join as join15, dirname as dirname10 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { execFile } from "child_process";
 import { homedir as homedir9 } from "os";
-import { createHash as createHash3 } from "crypto";
+import { createHash as createHash4 } from "crypto";
 var PACKAGE_NAME = "billion-context-pi";
 var registryUrl = (tag) => `https://registry.npmjs.org/${PACKAGE_NAME}/${encodeURIComponent(tag)}`;
 var SEMVER_RE = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z-.]+)?$/;
 var CHECK_INTERVAL_MS = 3 * 60 * 1e3;
 function locationKey(location) {
-  return createHash3("sha256").update(location).digest("hex").slice(0, 12);
+  return createHash4("sha256").update(location).digest("hex").slice(0, 12);
 }
 var throttleFileFor = (extDir) => {
   if (process.env.ACP_UPDATE_THROTTLE_FILE) return process.env.ACP_UPDATE_THROTTLE_FILE;
@@ -20364,6 +20527,7 @@ function createAcpExtension(adapter = {}) {
     wireDelegateReadTracking(pi);
     wireSessionLifecycle(pi, runtime, standDownIfProxied);
     wireContextTransform(pi, runtime, standDownIfProxied);
+    wireBeforeProviderRequest(pi, runtime, standDownIfProxied);
     wireSystemPrompt(pi, runtime);
     wireToolGuardrails(pi, runtime);
     wireOverflowSelfHeal(pi, runtime);
@@ -20533,6 +20697,25 @@ function wireSessionLifecycle(pi, runtime, standDownIfProxied) {
   });
 }
 var lastDegNoticeKey = null;
+function wireBeforeProviderRequest(pi, runtime, standDownIfProxied) {
+  pi.on("before_provider_request", async (event, ctx) => {
+    if (runtime.refused) return;
+    if (standDownIfProxied(ctx)) return;
+    const settings2 = runtime.stripImagesFor(ctx);
+    if (!settings2.enabled) return;
+    const outcome = applyStripImages(event.payload, ctx.model?.api, settings2);
+    if (outcome.removed > 0) {
+      logInfo("strip-images", {
+        sid: ctx.sessionManager.getSessionId(),
+        event: "stripped",
+        removed: outcome.removed,
+        keepRecent: settings2.keepRecent
+      });
+      return outcome.body;
+    }
+    return;
+  });
+}
 function wireContextTransform(pi, runtime, standDownIfProxied) {
   pi.on("context", async (event, ctx) => {
     if (runtime.refused) return;