billion-context-pi 0.1.41 → 0.1.45

package/README.md

@@ -133,6 +133,18 @@ Blocks: 3 active (3.7K summary, 15.2K original compressed)
   b3 (T2)  3.3K→1.0K  age=1m  "Architecture review"
 ```
 
+## `/acp-subagents` command
+
+**Optional, one-time setup — only if you also use [pi-subagents](https://github.com/nicobailon/pi-subagents).**
+
+billion-context-pi's own `acp_delegate` tool works standalone. If you additionally keep pi-subagents installed and want its builtin sub-agents to have ACP context tools (`compress`/`decompress`/`search_context`/`acp_status`) for long-running tasks, run:
+
+```
+/acp-subagents
+```
+
+It discovers the agents and their tool baselines from the installed pi-subagents package and appends the four ACP tools to `subagents.agentOverrides` in `~/.pi/agent/settings.json` (safe write: backup + verify). Nothing is written automatically — this command is the only write path. Re-run it after upgrading pi-subagents. For git installs or forks, pass the package directory explicitly: `/acp-subagents <installDir>`.
+
 ## Configuration
 
 billion-context-pi works out of the box with no configuration — it reads your model's context window automatically and applies sensible defaults.

package/README.zh-CN.md

@@ -132,6 +132,18 @@ Blocks: 3 active (3.7K summary, 15.2K original compressed)
   b3 (T2)  3.3K→1.0K  age=1m  "Architecture review"
 ```
 
+## `/acp-subagents` 命令
+
+**可选、一次性设置——仅当你同时使用 [pi-subagents](https://github.com/nicobailon/pi-subagents) 时需要。**
+
+billion-context-pi 自带的 `acp_delegate` 工具可独立工作。如果你另外保留了 pi-subagents,并希望它的内置子代理在长任务中也能使用 ACP 上下文工具(`compress`/`decompress`/`search_context`/`acp_status`),运行:
+
+```
+/acp-subagents
+```
+
+它会从已安装的 pi-subagents 包中发现 agent 名单与工具基线,并向 `~/.pi/agent/settings.json` 的 `subagents.agentOverrides` 追加这四个 ACP 工具(安全写入:备份 + 校验)。不会自动写入——该命令是唯一的写入路径。升级 pi-subagents 后重新运行即可。git 安装或 fork 请显式传入包目录:`/acp-subagents <installDir>`。
+
 ## 配置
 
 billion-context-pi 开箱即用,无需任何配置——它会自动读取模型的上下文窗口并应用合理的默认值。

package/dist/compress-tool.d.ts

@@ -3,13 +3,22 @@ import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
 import type { AcpRuntime } from "./runtime.js";
 declare const CompressParams: Type.TObject<{
     topic: Type.TOptional<Type.TString>;
-    content: Type.TArray<Type.TObject<{
+    content: Type.TUnion<[Type.TArray<Type.TObject<{
         startId: Type.TString;
         endId: Type.TString;
         summary: Type.TString;
         topic: Type.TOptional<Type.TString>;
-    }>>;
+    }>>, Type.TString]>;
     summaryMaxChars: Type.TOptional<Type.TNumber>;
 }>;
 export declare function makeCompressTool(runtime: AcpRuntime): ToolDefinition<typeof CompressParams>;
+/** Success = completed run that created >= 1 block (partial range errors
+ *  still count: progress was made). A 0-block panel must NOT be success —
+ *  it would reset the retry counter while the emergency nudge re-fires,
+ *  looping no-op compressions (issue #6). */
+export declare function isCompressSuccessText(text: string): boolean;
+/** No-op = completed run that compressed nothing (0-block panel: every
+ *  range skipped). Counted as a FAILED attempt by noteCompressOutcomes so
+ *  the retry cap applies. Non-panels ("No ranges provided.") stay neutral. */
+export declare function isCompressNoopText(text: string): boolean;
 export {};

package/dist/config.d.ts

@@ -1,4 +1,5 @@
 import { type Config, type Prompts } from "acp-kernel";
+import type { ThrottleRetryConfig } from "./throttle-retry.js";
 /** Delegate sub-agent configuration. */
 export interface DelegateConfig {
     /** Enable acp_delegate tools (delegate/wait/cancel) and their system-prompt
@@ -88,6 +89,11 @@ export interface AdapterConfig {
     delegate?: boolean | DelegateConfig;
     /** Compression tuning. */
     compress?: CompressConfig;
+    /** Provider token-throttle (Bedrock "Too many tokens, please wait before
+     *  trying again.") auto-retry. Accepts a boolean shorthand (`false`
+     *  disables) or a ThrottleRetryConfig object. Default: enabled, 10 retries,
+     *  60s exponential base capped at 300s per kick. */
+    throttleRetry?: boolean | ThrottleRetryConfig;
     /** Legacy flat alias for `delegate.displayUsage`. Kept for backward
      *  compatibility with existing acp.json files. Prefer `delegate.displayUsage`. */
     displayUsage?: "merged" | "separate";