billion-context-pi 0.1.83-pr.611.430 → 0.1.83-pr.613.440

package/README.md

@@ -78,11 +78,7 @@ 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.
 
-> **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)
->
-> If you keep `pi-subagents` installed, billion-context-pi detects it at session start: a **project-level** install (`<cwd>/.pi/npm` or the project extensions dir) automatically stands `acp_delegate` down for that project — a reminder then tells you how to give pi-subagents' agents ACP compression via `/acp-subagents`. A **user-level-only** install (`~/.pi/npm`, user extensions dir) leaves `acp_delegate` active and logs a warning instead. Set `"delegate": { "forceEnable": true }` in `acp.json` to keep `acp_delegate` active regardless of detection.
+> **Want sub-agents?** The `acp_delegate` tools were split out into **[billion-context-pi-subagents](https://github.com/ranxianglei/billion-context-pi-subagents)** ([#612](https://github.com/ranxianglei/billion-context-pi/issues/612)) — install it alongside when you want delegation: `pi install npm:billion-context-pi-subagents`. It reads the same `acp.json` files (all `delegate.*` keys moved there). If you also keep `pi-subagents` installed, that package detects it at session start and stands its delegate down for **project-scope** installs; give pi-subagents' agents ACP compression via this package's `/acp-subagents` command below.
 
 ## How it works
 
@@ -146,49 +142,18 @@ billion-context-pi is built for the **Pi** coding agent (`@earendil-works/pi-cod
 | `acp_status` | Show context usage, compressed blocks, compressible ranges |
 | `acp_cache` | Prompt-cache reconciliation: grand ledger (input/cached/hit rate), per-request miss attribution, per-fold economics |
 | `acp_rule` | Record a short, principle-level reminder that survives compression (opt-in: `"rules": true`) |
-| `acp_delegate` | Spawn a clean-context sub-agent for a task (review / research / implement / plan / advise) |
-| `acp_delegate_wait` | Block until a delegate run finishes (returns its result; times out otherwise) |
-| `acp_delegate_cancel` | Cancel a running delegate by runId |
 
-The four `acp_delegate*` tools are optional: if you bring your own sub-agent extension, disable them with one `acp.json` key — see *Using your own sub-agent instead* below. `acp_rule` is likewise opt-in — off by default, enable it with `"rules": true`.
+`acp_rule` is opt-in — off by default, enable it with `"rules": true`.
 
-### acp_delegate — clean-context delegation
+### Sub-agents (separate package)
 
-Hand a self-contained task to a fresh pi process running in a clean context. Five built-in roles, each with a system prompt and a **soft tool guardrail**:
+Clean-context delegation (`acp_delegate` / `acp_delegate_wait` / `acp_delegate_cancel`, the fleet inspector, and the TUI status widget) was split out of this package into **[billion-context-pi-subagents](https://github.com/ranxianglei/billion-context-pi-subagents)** ([#612](https://github.com/ranxianglei/billion-context-pi/issues/612)). Install it alongside when you want delegation:
 
-| Role | Tools | Best for |
-|------|-------|----------|
-| `reviewer` | read, bash, grep, find, ls + ACP | Read-only code review (bugs, risks, file:line) |
-| `researcher` | read, bash, grep, find, ls + ACP | Read-only codebase investigation |
-| `worker` | read, edit, write, bash | Make code changes |
-| `planner` | read, bash, grep, find, ls + ACP | Analyze + propose a step-by-step plan |
-| `oracle` | read, bash, grep, find, ls + ACP | Answer questions / advise |
-
-Read-only roles (reviewer, researcher, planner, oracle) receive a restricted tool allowlist (`read, bash, grep, find, ls`) plus ACP context tools (`compress, decompress, search_context, acp_status`) so they can manage their own context. This prevents accidental file modifications, but `bash` can bypass it - **it is a guardrail, not a security boundary**.
-
-Worker runs on Pi's full default toolset - no `--tools` allowlist is applied, so any loaded extension or custom tools (e.g. ACP, LSP, MCP) remain available. This keeps primary-task delegation fully capable. The `read, edit, write, bash` listing above reflects core tools only.
-
-The full delegate result is saved to a file (`$TMPDIR/acp-delegate/<runId>.out`, defaulting to `/tmp/acp-delegate/<runId>.out`); the tool result and injected notification carry only the **task title + file path** (no preview) - use `read` for the details. This keeps the parent context lean.
-
-- **Interactive (TUI) & RPC modes**: `async:true` (default) runs the child in the background; a short completion notification is injected into the chat when it finishes — **unless the model already read the result file after the run finished** (detected via the `read` tool or a bash command referencing the file), in which case the notification is skipped: the model already has the result, so re-injecting it would only waste context. Set `delegate: { notifyIfRead: "always" }` in `acp.json` to restore the always-inject behavior.
-- **Print / JSON modes** (`pi -p`, SDK): `async:true` auto-downgrades to **synchronous** — the result returns as the tool result in the same turn (the parent exits after one turn, so background injection would be lost).
-- **Failures are loud, never silent.** A run that fails (nonzero exit, spawn error, watchdog timeout) injects a `FAILED ⚠️` notification carrying a short error excerpt, so a failed delegate cannot hide among sibling completions. If a notification cannot be delivered at all, a recovery notice is attached to the next delegate notification or the next `acp_delegate` / `acp_delegate_wait` / `acp_delegate_cancel` tool result — a dispatched run's failure always reaches the model before it wraps up.
-
-In the **interactive TUI**, async runs also show a live status widget below the editor (agent, elapsed seconds, task preview), so you always know what's running and for how long. Disabled automatically in RPC/print/JSON.
-
-#### Using your own sub-agent instead
-
-If you already run another sub-agent extension (pi-subagents, pi-lens, …), turn ACP's delegate off so the model is offered only one way to delegate. In `~/.pi/acp.json` (global) or `<project>/.pi/acp.json` (per project):
-
-```json
-{ "delegate": false }
+```bash
+pi install npm:billion-context-pi-subagents
 ```
 
-- Equivalent object form: `{ "delegate": { "enabled": false } }`.
-- **What it removes:** the `acp_delegate`, `acp_delegate_wait` and `acp_delegate_cancel` tools, the `ACP_DELEGATE NOTIFICATIONS` system-prompt section, and the `ctrl+alt+f` fleet shortcut (`/acp-fleet` then reports that delegate is off). Compression is unaffected — `compress`, `decompress`, `search_context`, `acp_status` and `acp_cache` stay.
-- **When it applies:** the three tools are registered at session start, so a change needs a **new session** (or a Pi restart). The system-prompt section is resolved live on every turn, so it can disappear mid-session before the tools do.
-- Want to drop only the prompt section and keep the tools? Set `{ "delegatePrompt": null }`.
-- Pi's `--exclude-tools acp_delegate,acp_delegate_wait,acp_delegate_cancel` is **not** a substitute: it hides the tools but the model still receives the `ACP_DELEGATE NOTIFICATIONS` section describing tools it cannot call. Use `delegate: false`.
+It reads the same `acp.json` files — all `delegate.*`, `displayUsage` and `delegatePrompt` keys moved there, so existing keys are picked up unchanged by the new package and ignored by this one. Roles, execution model (async/sync, notifications, watchdogs), configuration keys, and the env overrides are documented in its README.
 
 ## `/acp` command
 
@@ -220,7 +185,7 @@ Blocks: 3 active (3.7K summary, 15.2K original compressed)
 
 **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:
+If you keep pi-subagents installed (with or without [billion-context-pi-subagents](https://github.com/ranxianglei/billion-context-pi-subagents)) and want its builtin sub-agents to have ACP context tools (`compress`/`decompress`/`search_context`/`acp_status`) for long-running tasks, run:
 
 ```
 /acp-subagents
@@ -238,7 +203,7 @@ Behavior is tuned via an optional `acp.json` config file (`~/.pi/acp.json` for g
 
 billion-context-pi writes a structured, always-on log to `~/.pi/acp.log` (override with `ACP_LOG_FILE`). It covers the model's whole working session and is useful for diagnosing problems:
 
-- **Always written** (even with `debug: false`): `error`, `warn`, `info` levels — session start, every context turn (token usage / nudge decision), compress/decompress, delegate spawn/done, and **all errors and warnings** (config/state/tool failures, delegate errors, guardrail caps, update failures). Error lines include the message and stack trace.
+- **Always written** (even with `debug: false`): `error`, `warn`, `info` levels — session start, every context turn (token usage / nudge decision), compress/decompress, and **all errors and warnings** (config/state/tool failures, guardrail caps, update failures). Error lines include the message and stack trace. ([billion-context-pi-subagents](https://github.com/ranxianglei/billion-context-pi-subagents) writes to the same file when installed.)
 - **Written only when `debug: true`**: verbose `debug`-level diagnostics (full field dumps, per-turn internals).
 
 - **Nudge audit trail**: whenever a context-limit nudge is injected, a compact one-line record (e.g. `[ACP nudge] EMERGENCY 95% · T1 · top range m00120–m00168`) is appended as a *display-only* session entry — it survives process restarts, shows up in TUI scrollback and the session file, and is never sent to the model.

package/README.zh-CN.md

@@ -77,11 +77,7 @@ pi install npm:billion-context-pi
 
 完成。扩展在下次 Pi 启动时自动加载。无需配置 —— 它会自动读取模型的上下文窗口。
 
-> **你另有子代理扩展?** billion-context-pi 自带 `acp_delegate` 子代理工具(见下文),上下文成本极低(~600 tok vs ~7K tok/轮)。同一会话里两套委派工具只会让模型的选择更混乱,二选一:
-> - **用 ACP 的 delegate** —— 卸载另一个扩展:`pi remove npm:pi-subagents`
-> - **保留你自己的子代理** —— 在 `acp.json` 里关掉 ACP 的 delegate:`{ "delegate": false }`(见下文*改用你自己的子代理*)
->
-> 若保留已安装的 `pi-subagents`,billion-context-pi 会在会话启动时检测:**项目级**安装(`<cwd>/.pi/npm` 或项目内 extensions 目录)会自动停用该项目的 `acp_delegate`,并提醒你运行 `/acp-subagents` 让 pi-subagents 的子代理获得 ACP 压缩;仅**用户级**(全局)安装时只记一条警告日志,`acp_delegate` 保持启用。在 `acp.json` 中设置 `"delegate": { "forceEnable": true }` 可在检测到第三方子代理时仍强制保留 `acp_delegate`。
+> **想使用子代理?** `acp_delegate` 工具已拆分至独立的 [**billion-context-pi-subagents**](https://github.com/ranxianglei/billion-context-pi-subagents)([#612](https://github.com/ranxianglei/billion-context-pi/issues/612))——需要委派时一并安装:`pi install npm:billion-context-pi-subagents`。它读取同样的 `acp.json` 文件(所有 `delegate.*` 键已迁往该包)。若你同时保留 `pi-subagents`,该包会在会话启动时检测,并对**项目级**安装自动停用其 delegate;pi-subagents 的子代理可通过本包下方的 `/acp-subagents` 命令获得 ACP 压缩。
 
 ## 工作原理
 
@@ -134,48 +130,18 @@ billion-context-pi 面向 **Pi** 编码代理(`@earendil-works/pi-coding-agent`)
 | `search_context` | 按关键词搜索已压缩块摘要(及可见消息) |
 | `acp_status` | 显示上下文用量、已压缩块、可压缩范围 |
 | `acp_rule` | 记录一条简短、原则性的提醒,穿越压缩保留(可选:`"rules": true`) |
-| `acp_delegate` | 为某个任务派生一个干净上下文的子代理(审查 / 调研 / 实现 / 规划 / 建议) |
-| `acp_delegate_wait` | 阻塞等待委派任务完成(返回结果,否则超时) |
-| `acp_delegate_cancel` | 按 runId 取消正在运行的委派任务 |
 
-`acp_delegate*` 四个工具是可选的:如果你自带子代理扩展,一个 `acp.json` 键即可关闭 —— 见下文*改用你自己的子代理*。`acp_rule` 同样是可选项 —— 默认关闭,在 `acp.json` 中设置 `"rules": true` 启用。
+`acp_rule` 是可选的——默认关闭,在 `acp.json` 中设置 `"rules": true` 启用。
 
-### acp_delegate — 干净上下文委派
+### 子代理(独立包)
 
-把一个自包含的任务交给一个运行在干净上下文中的新 pi 进程。五个内置角色,各自有系统提示和**软工具护栏**:
+干净上下文委派(`acp_delegate` / `acp_delegate_wait` / `acp_delegate_cancel`、fleet inspector、TUI 状态 widget)已从本包拆分至 [**billion-context-pi-subagents**](https://github.com/ranxianglei/billion-context-pi-subagents)([#612](https://github.com/ranxianglei/billion-context-pi/issues/612))。需要委派时一并安装:
 
-| 角色 | 工具 | 适用场景 |
-|------|------|----------|
-| `reviewer` | read, bash, grep, find, ls + ACP | 只读代码审查(bug、风险、file:line) |
-| `researcher` | read, bash, grep, find, ls + ACP | 只读代码库调研 |
-| `worker` | read, edit, write, bash | 修改代码 |
-| `planner` | read, bash, grep, find, ls + ACP | 分析 + 提出分步计划 |
-| `oracle` | read, bash, grep, find, ls + ACP | 回答问题 / 建议 |
-
-只读角色(reviewer、researcher、planner、oracle)获得受限工具白名单(`read, bash, grep, find, ls`)+ ACP 上下文工具(`compress, decompress, search_context, acp_status`),以便管理自己的上下文。这能防止意外修改文件,但 `bash` 可绕过 - **这是护栏,不是安全边界**。
-
-Worker 运行在 Pi 的完整默认工具集上 - 不应用 `--tools` 白名单,因此任何已加载的扩展或自定义工具(如 ACP、LSP、MCP)保持可用。这确保主任务委派能力完整。上表中的 `read, edit, write, bash` 仅反映核心工具。
-
-委派的完整结果保存到文件(`$TMPDIR/acp-delegate/<runId>.out`,默认 `/tmp/acp-delegate/<runId>.out`);工具结果和注入通知只携带**任务标题 + 文件路径**(无预览)- 需要细节时用 `read` 读取。这让父上下文保持精简。
-
-- **交互(TUI)与 RPC 模式**:`async:true`(默认)在后台运行子进程;完成时一条简短通知注入到聊天框。
-- **Print / JSON 模式**(`pi -p`、SDK):`async:true` 自动降级为**同步** — 结果在同一轮作为工具结果返回(父进程一轮后即退出,后台注入会丢失)。
-
-在**交互 TUI** 中,异步运行还会在编辑器下方显示一个实时状态 widget(角色、已运行秒数、任务预览),让你随时知道什么在跑、跑了多久。RPC/print/JSON 模式自动禁用。
-
-#### 改用你自己的子代理
-
-如果你已经在用别的子代理扩展(pi-subagents、pi-lens 等),关掉 ACP 的 delegate,让模型只有一条委派路径。在 `~/.pi/acp.json`(全局)或 `<项目>/.pi/acp.json`(项目级):
-
-```json
-{ "delegate": false }
+```bash
+pi install npm:billion-context-pi-subagents
 ```
 
-- 等价对象写法:`{ "delegate": { "enabled": false } }`。
-- **关掉的是什么:**`acp_delegate`、`acp_delegate_wait`、`acp_delegate_cancel` 三个工具,`ACP_DELEGATE NOTIFICATIONS` 系统提示段,以及 `ctrl+alt+f` 快捷键(此时 `/acp-fleet` 会提示 delegate 未启用)。压缩本身不受影响 —— `compress`、`decompress`、`search_context`、`acp_status` 全部保留。
-- **生效时机:**三个工具在会话启动时注册,因此需要**新会话**(或重启 Pi)。系统提示段每回合实时解析,可能在工具之前先消失。
-- 只想去掉提示段、保留工具?设 `{ "delegatePrompt": null }`。
-- Pi 原生的 `--exclude-tools acp_delegate,acp_delegate_wait,acp_delegate_cancel` **不能**替代:它藏起工具,但模型仍会收到描述这些工具的 `ACP_DELEGATE NOTIFICATIONS` 段。请用 `delegate: false`。
+它读取同样的 `acp.json` 文件——所有 `delegate.*`、`displayUsage`、`delegatePrompt` 键已迁往该包,因此现有键会被新包原样读取、被本包忽略。角色、执行模型(async/sync、通知、看门狗)、配置键与环境变量覆盖均在其 README 中记录。
 
 ## `/acp` 命令
 
@@ -207,7 +173,7 @@ Blocks: 3 active (3.7K summary, 15.2K original compressed)
 
 **可选、一次性设置——仅当你同时使用 [pi-subagents](https://github.com/nicobailon/pi-subagents) 时需要。**
 
-billion-context-pi 自带的 `acp_delegate` 工具可独立工作。如果你另外保留了 pi-subagents,并希望它的内置子代理在长任务中也能使用 ACP 上下文工具(`compress`/`decompress`/`search_context`/`acp_status`),运行:
+如果你保留了 pi-subagents(无论是否同时安装 [billion-context-pi-subagents](https://github.com/ranxianglei/billion-context-pi-subagents)),并希望它的内置子代理在长任务中也能使用 ACP 上下文工具(`compress`/`decompress`/`search_context`/`acp_status`),运行:
 
 ```
 /acp-subagents
@@ -225,10 +191,9 @@ billion-context-pi 开箱即用,无需任何配置——它会自动读取模型
 
 billion-context-pi 会向 `~/.pi/acp.log`(可用 `ACP_LOG_FILE` 覆盖)写入结构化的**始终开启**日志,覆盖模型工作的整个会话,便于排查问题:
 
-- `error` — 详细记录所有报错(含 `message` 与 `stack`):上下文变换、压缩/解压/搜索执行失败、delegate 子进程错误、状态读写失败、子代理工具注册失败等。原本被静默吞掉的异常现在一律落盘。
-- `warn` — 值得注意的非致命情况:紧急 nudge 注入、配置加载失败、自动更新网络错误、工具输出被截断、委派结果注入被跳过。
-- `info` — 生命周期事件:会话启动、每轮上下文变换摘要(消息数/token/压缩比/活跃块数)、压缩/解压、delegate 派发与完成、自动更新检查。
-- `debug` —— 仅在 `debug: true` 时额外写入(细粒度的字段级事件)。
+- **始终写入**(即使 `debug: false`):`error`、`warn`、`info` 级别——会话启动、每个上下文轮次(token 用量/nudge 决策)、压缩/解压,以及**所有错误与警告**(配置/状态/工具失败、护栏上限、更新失败)。错误行包含 message 与 stack trace。(安装 [billion-context-pi-subagents](https://github.com/ranxianglei/billion-context-pi-subagents) 后它也写入同一文件。)
+- **仅当 `debug: true` 时写入**:详细的 `debug` 级别诊断(完整字段转储、逐轮内部数据)。
+
 - **Nudge 审计轨迹** — 无论何时注入上下文限制 nudge,一条紧凑的单行记录(如 `[ACP nudge] EMERGENCY 95% · T1 · top range m00120–m00168`)会作为*仅供显示*的会话条目写入——它跨进程重启存活,在 TUI 回滚历史和会话文件中可见,且永远不会发给模型。
 
 每行格式:`<ISO 时间戳> [<级别>] [<范围>] key=value key=value`。多行字段值(如 `nudge-injected` 中的完整 nudge 正文)会被转义(`\n` → 字面量 `\\n`),保证每条日志恰好占**一行物理行**,便于 `grep`。文件达到 10 MB 时轮转为 `~/.pi/acp.log.old`。

package/dist/config.d.ts

@@ -4,119 +4,9 @@ import type { DegenerationGuardConfig } from "./degeneration.js";
 import type { ThrottleRetryConfig } from "./throttle-retry.js";
 import type { PiPromptSections } from "./system-prompt.js";
 import type { NudgeSectionsConfig, ToolPromptsConfig } from "./surface.js";
-/** Default TUI shortcut for the acp_delegate fleet inspector. Moved off
- *  "ctrl+alt+f" (also claimed by pi-subagents) to avoid a cross-extension
- *  conflict Pi's loader only warns about — last-loaded silently wins (#412). */
-export declare const DEFAULT_FLEET_SHORTCUT = "ctrl+alt+d";
-/** Per-role delegate defaults. Lets long-lived automation pin a cheaper or
- *  more capable model and a thinking level per delegate role, so the main
- *  agent doesn't have to fill them in on every `acp_delegate()` call. */
-export interface DelegateRoleConfig {
-    /** Default model for this role, as `"provider/id"`. Resolution priority:
-     *  per-call `model` > this role default > parent agent's current model. A
-     *  value that isn't a valid `"provider/id"` is ignored (treated as unset).
-     *  If the configured model doesn't exist in the live registry, the child
-     *  falls back to the parent model and a warning is logged — it never fails. */
-    model?: string;
-    /** Default thinking level for this role: one of off|minimal|low|medium|
-     *  high|xhigh|max. Resolution priority: per-call `thinkingLevel` > this role
-     *  default > global `delegate.thinkingLevel` > Pi's own default. An invalid
-     *  value is ignored with a warning (never fails). */
-    thinkingLevel?: string;
-}
-/** Delegate sub-agent configuration. */
-export interface DelegateConfig {
-    /** Enable acp_delegate tools (delegate/wait/cancel) and their system-prompt
-     *  section. Default: true. Set `enabled: false` to skip registering them. */
-    enabled?: boolean;
-    /** Keep acp_delegate active even when a third-party subagent extension
-     *  (pi-subagents) is installed. Default: false — when pi-subagents is
-     *  detected at session start, acp_delegate stands down (tools, fleet
-     *  shortcut and system-prompt section skipped) to avoid two overlapping
-     *  sub-agent systems, and a reminder points at /acp-subagents so the
-     *  third-party agents can still get ACP compression tools (#415). */
-    forceEnable?: boolean;
-    /** How delegate usage is reported back to the main session.
-     *  "separate" (default) — delegate tokens tracked in a separate accumulator;
-     *  main session totals stay clean, delegate usage shows as its own block in
-     *  acp_status (excluded from main totals).
-     *  "merged" — delegate token usage folded into the tool-result usage field,
-     *  counted as part of the main session totals. */
-    displayUsage?: "merged" | "separate";
-    /** Maximum acp_delegate nesting depth. Default: 2 (main → child → grandchild;
-     *  the grandchild cannot delegate further). Set 1 to forbid nested delegation
-     *  (orchestrator → leaf workers only). The resolved value is propagated to
-     *  child processes via PI_ACP_DELEGATE_MAX_DEPTH so the cap follows the whole
-     *  delegation tree, even when a child loads a different project acp.json. */
-    maxDepth?: number;
-    /** Hard timeout for synchronous delegates (async=false, or async auto-downgraded
-     *  on one-shot hosts), in minutes. Default: 5. 0 or null disables the timeout
-     *  (the run blocks until the child exits or the tool call is cancelled). */
-    syncTimeoutMinutes?: number | null;
-    /** Idle watchdog for async delegates: kill when no output arrives for this many
-     *  minutes. Default: 5. This is the main defense against a stuck child holding
-     *  its stdout fd open, so disabling it (0/null) logs a warning — use
-     *  acp_delegate_cancel as the manual escape hatch. */
-    idleTimeoutMinutes?: number | null;
-    /** Hard time limit for async delegates, in minutes. Default: 30. 0 or null
-     *  disables the limit. */
-    asyncTimeoutMinutes?: number | null;
-    /** Cap on how many background (async) delegate processes run at once.
-     *  `1` forces strict serial execution; `N` allows up to N in parallel;
-     *  omitted means unlimited (existing behavior). Extra launches are queued and
-     *  start automatically as slots free. Invalid values (non-integer, <1) fall
-     *  back to unlimited with a warning. Env `PI_ACP_DELEGATE_MAX_CONCURRENT`
-     *  overrides this. See #294. */
-    maxConcurrent?: number;
-    /** Global default thinking level applied to every delegate when neither the
-     *  per-call `thinkingLevel` nor the role's own `thinkingLevel` is set. One of
-     *  off|minimal|low|medium|high|xhigh|max. When unset at all levels, no
-     *  `--thinking` flag is passed and each child uses Pi's own default. */
-    thinkingLevel?: string;
-    /** Per-role defaults keyed by role name (reviewer/researcher/worker/planner/
-     *  oracle, or any custom role). See DelegateRoleConfig. Only affects roles
-     *  that are named here; other roles inherit the parent model + Pi defaults. */
-    agents?: Record<string, DelegateRoleConfig>;
-    /** What happens to the completion notification when the model has already
-     *  read the delegate's result file after the run finished.
-     *  "skip" (default) — the notification is not injected; the model already
-     *  saw the result, so re-injecting it would only waste context.
-     *  "always" — always inject the notification (previous behavior). */
-    notifyIfRead?: "skip" | "always";
-    /** Keybinding for the interactive TUI shortcut that opens the acp_delegate
-     *  fleet inspector (live list + transcript). Default: "ctrl+alt+d". Set to
-     *  "" (empty string) to disable keyboard registration entirely — the
-     *  inspector stays reachable via /acp-fleet. Moved off the previous hardcoded
-     *  "ctrl+alt+f" because pi-subagents also claims ctrl+alt+f, and Pi's loader
-     *  only warns + last-loaded-wins on cross-extension conflicts (#412). */
-    fleetShortcut?: string;
-}
-/** Resolved delegate policy: what actually takes effect after merging acp.json,
- *  env overrides and defaults. Timeout fields are milliseconds; null means the
- *  corresponding timeout/watchdog is disabled. */
-export interface DelegatePolicy {
-    enabled: boolean;
-    /** Resolved delegate.forceEnable (default false): keep acp_delegate even
-     *  when a third-party subagent extension (pi-subagents) is installed (#415). */
-    forceEnable: boolean;
-    displayUsage: "merged" | "separate";
-    maxDepth: number;
-    syncTimeoutMs: number | null;
-    idleMs: number | null;
-    asyncTimeoutMs: number | null;
-    /** Resolved cap on concurrent background delegates; Infinity = unlimited. */
-    maxConcurrent: number;
-    /** Global default thinking level (undefined when unset). */
-    thinkingLevel?: string;
-    /** Per-role defaults keyed by role name (undefined when unset). */
-    agents?: Record<string, DelegateRoleConfig>;
-    /** Whether to suppress the completion notification when the model already
-     *  read the result file after the run finished. Always resolved ("skip" default). */
-    notifyIfRead: "skip" | "always";
-    /** Resolved TUI shortcut for the fleet inspector ("" = registration disabled). */
-    fleetShortcut: string;
-}
-export declare const DEFAULT_DELEGATE_POLICY: DelegatePolicy;
+export { DEFAULT_DELEGATE_POLICY, DEFAULT_FLEET_SHORTCUT, resolveDelegate } from "billion-context-pi-subagents";
+export type { DelegateConfig, DelegatePolicy, DelegateRoleConfig } from "billion-context-pi-subagents";
+import type { DelegateConfig } from "billion-context-pi-subagents";
 /** Compression tuning fields, shared by all three levels (global, provider,
  *  model). Percentage fields accept a ratio (0.75) or percent string ("75%").
  *  Resolution is per-field, deepest-wins (model > provider > global); an
@@ -353,11 +243,6 @@ export interface AdapterConfig {
 }
 export declare const DEFAULT_TOOL_BASH_TIMEOUT = 60;
 export declare const DEFAULT_TOOL_OUTPUT_MAX_BYTES = 50000;
-/** Resolve delegate config from the adapter, handling the boolean shorthand
- *  and the legacy flat `displayUsage` alias. Precedence: env > acp.json >
- *  default (same convention as ACP_MODEL_CONTEXT_LIMIT). Invalid values fall
- *  back to the default with a logged warning — they never fail the session. */
-export declare function resolveDelegate(adapter: AdapterConfig): DelegatePolicy;
 /** Defaults for the generic tool-call repetition guard (issue #308). */
 export declare const REPETITION_GUARD_DEFAULTS: {
     readonly warn: 3;