billion-context-pi 0.1.76 → 0.1.77-pr.490.344

package/README.md

@@ -145,11 +145,12 @@ billion-context-pi is built for the **Pi** coding agent (`@earendil-works/pi-cod
 | `search_context` | Search compressed block summaries (and visible messages) by keyword |
 | `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.
+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_delegate — clean-context delegation
 

package/README.zh-CN.md

@@ -133,11 +133,12 @@ billion-context-pi 面向 **Pi** 编码代理(`@earendil-works/pi-coding-agent`)
 | `decompress` | 恢复之前压缩的块内容 |
 | `search_context` | 按关键词搜索已压缩块摘要(及可见消息) |
 | `acp_status` | 显示上下文用量、已压缩块、可压缩范围 |
+| `acp_rule` | 记录一条简短、原则性的提醒,穿越压缩保留(可选:`"rules": true`) |
 | `acp_delegate` | 为某个任务派生一个干净上下文的子代理(审查 / 调研 / 实现 / 规划 / 建议) |
 | `acp_delegate_wait` | 阻塞等待委派任务完成(返回结果,否则超时) |
 | `acp_delegate_cancel` | 按 runId 取消正在运行的委派任务 |
 
-`acp_delegate*` 四个工具是可选的:如果你自带子代理扩展,一个 `acp.json` 键即可关闭 —— 见下文*改用你自己的子代理*。
+`acp_delegate*` 四个工具是可选的:如果你自带子代理扩展,一个 `acp.json` 键即可关闭 —— 见下文*改用你自己的子代理*。`acp_rule` 同样是可选项 —— 默认关闭,在 `acp.json` 中设置 `"rules": true` 启用。
 
 ### acp_delegate — 干净上下文委派
 

package/dist/{chunk-44F6OZJV.js → chunk-BKSJVDJY.js}

@@ -7,7 +7,7 @@ var __export = (target, all) => {
 // src/contract.ts
 var SIDECAR_SCHEMA_VERSION = 1;
 function sidecarProducer() {
-  return `billion-context-pi@${true ? "0.1.76" : "dev"}`;
+  return `billion-context-pi@${true ? "0.1.77" : "dev"}`;
 }
 
 export {
@@ -15,4 +15,4 @@ export {
   SIDECAR_SCHEMA_VERSION,
   sidecarProducer
 };
-//# sourceMappingURL=chunk-44F6OZJV.js.map
+//# sourceMappingURL=chunk-BKSJVDJY.js.map

package/dist/compress-tool.d.ts

@@ -39,4 +39,5 @@ export declare function isCompressSuccessText(text: string): boolean;
  *  the retry cap applies. Non-panels ("No ranges provided.") stay neutral. */
 export declare function isCompressNoopText(text: string): boolean;
 export declare function blockSpanLabel(block: CompressionBlock, state: CompressionState): string;
+export declare function tierReadyHint(state: CompressionState, config: ReturnType<AcpRuntime["configFor"]>): string;
 export {};

package/dist/config.d.ts

@@ -293,6 +293,12 @@ export interface AdapterConfig {
      *  multi-session hosts (Prime RLM & co.) whose injected agent messages must
      *  delimit real turns. See docs/host-adapter.md. */
     hostSession?: boolean | HostSessionConfig;
+    /** Persistent-rules feature gate (#526): opt-in `rules: true` in acp.json.
+     *  Gates the human `/acp-rule` command (list + record — kernel
+     *  `listRules`/`addRule` against the session `.acp.json` sidecar state) and
+     *  the model-side `acp_rule` tool (#490). Custom limits via
+     *  coreOverrides.rules ({ maxRules?, maxRuleChars? }). */
+    rules?: boolean;
     /** Legacy flat alias for `delegate.displayUsage`. Kept for backward
      *  compatibility with existing acp.json files. Prefer `delegate.displayUsage`. */
     displayUsage?: "merged" | "separate";

package/dist/contract.js

@@ -1,7 +1,7 @@
 import {
   SIDECAR_SCHEMA_VERSION,
   sidecarProducer
-} from "./chunk-44F6OZJV.js";
+} from "./chunk-BKSJVDJY.js";
 export {
   SIDECAR_SCHEMA_VERSION,
   sidecarProducer