billion-context-pi 0.1.82 → 0.1.83

package/README.md

@@ -241,7 +241,9 @@ billion-context-pi writes a structured, always-on log to `~/.pi/acp.log` (overri
 - **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.
 - **Written only when `debug: true`**: verbose `debug`-level diagnostics (full field dumps, per-turn internals).
 
-Each line: `<ISO timestamp> [<level>] [<scope>] key=value key=value`. The file rotates to `~/.pi/acp.log.old` at 10 MB.
+- **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.
+
+Each line: `<ISO timestamp> [<level>] [<scope>] key=value key=value`. Multi-line values (e.g. the full nudge text in `nudge-injected`) are escaped (`\n` → literal `\\n`), so every entry occupies exactly **one physical line** and stays self-contained for `grep`. The file rotates to `~/.pi/acp.log.old` at 10 MB.
 
 ```sh
 tail -f ~/.pi/acp.log                 # watch the session live

package/README.zh-CN.md

@@ -229,8 +229,9 @@ billion-context-pi 会向 `~/.pi/acp.log`(可用 `ACP_LOG_FILE` 覆盖)写入结
 - `warn` — 值得注意的非致命情况:紧急 nudge 注入、配置加载失败、自动更新网络错误、工具输出被截断、委派结果注入被跳过。
 - `info` — 生命周期事件:会话启动、每轮上下文变换摘要(消息数/token/压缩比/活跃块数)、压缩/解压、delegate 派发与完成、自动更新检查。
 - `debug` —— 仅在 `debug: true` 时额外写入(细粒度的字段级事件)。
+- **Nudge 审计轨迹** — 无论何时注入上下文限制 nudge,一条紧凑的单行记录(如 `[ACP nudge] EMERGENCY 95% · T1 · top range m00120–m00168`)会作为*仅供显示*的会话条目写入——它跨进程重启存活,在 TUI 回滚历史和会话文件中可见,且永远不会发给模型。
 
-每行格式:`<ISO 时间戳> [<级别>] [<范围>] key=value key=value`。文件达到 10 MB 时轮转为 `~/.pi/acp.log.old`。
+每行格式:`<ISO 时间戳> [<级别>] [<范围>] key=value key=value`。多行字段值(如 `nudge-injected` 中的完整 nudge 正文)会被转义(`\n` → 字面量 `\\n`),保证每条日志恰好占**一行物理行**,便于 `grep`。文件达到 10 MB 时轮转为 `~/.pi/acp.log.old`。
 
 ```bash
 tail -f ~/.pi/acp.log                 # 实时观察会话

package/dist/{chunk-AKZJYVLH.js → chunk-LLFL3CNI.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.82" : "dev"}`;
+  return `billion-context-pi@${true ? "0.1.83" : "dev"}`;
 }
 
 export {
@@ -15,4 +15,4 @@ export {
   SIDECAR_SCHEMA_VERSION,
   sidecarProducer
 };
-//# sourceMappingURL=chunk-AKZJYVLH.js.map
+//# sourceMappingURL=chunk-LLFL3CNI.js.map

package/dist/config-dir.d.ts

@@ -1 +1,32 @@
+export type HostConfigSurface = {
+    CONFIG_DIR_NAME?: unknown;
+    getAgentDir?: unknown;
+};
+/** Pi's name — the fallback, and what releases before fork-host resolution used on every host. */
+export declare const PI_CONFIG_DIR_NAME = ".pi";
+/**
+ * Config directory name, resolved from the host package the extension runs under.
+ *
+ * Every path in this adapter is `<home|cwd>/<name>/…`, with the agent dir at
+ * `~/<name>/agent` — Pi's layout, where CONFIG_DIR_NAME is ".pi". Resolution order:
+ * 1. the host's CONFIG_DIR_NAME, if it is a single directory name (Pi);
+ * 2. the parent of the host's getAgentDir(), if that is `~/<name>/agent` — Pi forks
+ *    that do not re-export CONFIG_DIR_NAME, or export it with other semantics (Prime:
+ *    CONFIG_DIR_NAME ".prime/agent", getAgentDir() ~/.prime/agent → ".prime");
+ * 3. ".pi".
+ * The namespace import is deliberate: a missing named export fails at link time
+ * under plain Node ESM→CJS interop and as `undefined` under loader aliasing (#364).
+ * It is the ONLY value import from the pi package. See docs/host-adapter.md §4.
+ */
+export declare function resolveConfigDirName(host: HostConfigSurface, home: string): string;
 export declare const CONFIG_DIR_NAME: string;
+/**
+ * `<root>/<name>/<segments>` for a user-authored file (acp.json, prompt packs). When
+ * `name` is not ".pi", an existing `<root>/.pi/<segments>` is still used while the
+ * host's own path does not exist: earlier releases read ".pi" on every host, and Prime
+ * users were told to put acp.json there (#467).
+ */
+export declare function userConfigPathIn(name: string, root: string, ...segments: string[]): string;
+export declare function userConfigPath(root: string, ...segments: string[]): string;
+/** Global then project acp.json; later entries override earlier ones. */
+export declare function acpJsonFiles(cwd: string): string[];

package/dist/config.d.ts

@@ -378,9 +378,19 @@ export interface HostSessionConfig {
     /** Count host-injected custom_message entries (agent_message) as turn
      *  boundaries. Default: false (pi-native behavior). */
     countCustomMessages?: boolean;
+    /** #578: optional customType allowlist refining countCustomMessages — when
+     *  set (with countCustomMessages:true), only injected entries whose
+     *  customType is listed start a turn, keeping metadata injections
+     *  (harness_digest, ipython_state) out of nudge/retry accounting. Ignored
+     *  unless countCustomMessages:true; malformed values warn and fall back to
+     *  "all injected types count". */
+    customMessageTypes?: string[];
 }
 export interface ResolvedHostSession {
     countCustomMessages: boolean;
+    /** Present only when countCustomMessages is on and a valid allowlist was
+     *  configured (#578). */
+    customMessageTypes?: readonly string[];
 }
 /** Resolve the host-session turn-boundary policy from the adapter, handling
  *  the boolean shorthand (`true` enables countCustomMessages). Invalid values

package/dist/contract.js

@@ -1,7 +1,7 @@
 import {
   SIDECAR_SCHEMA_VERSION,
   sidecarProducer
-} from "./chunk-AKZJYVLH.js";
+} from "./chunk-LLFL3CNI.js";
 export {
   SIDECAR_SCHEMA_VERSION,
   sidecarProducer

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import type { ExtensionFactory } from "@earendil-works/pi-coding-agent";
+import type { NudgeDecision } from "acp-kernel";
 import { type AdapterConfig } from "./config.js";
 export { createRuntime } from "./runtime.js";
 export type { AcpRuntime, SessionRef } from "./runtime.js";
@@ -6,3 +7,4 @@ export { deriveChildState } from "./state.js";
 export declare function createAcpExtension(adapter?: AdapterConfig): ExtensionFactory;
 declare const _default: ExtensionFactory;
 export default _default;
+export declare function formatNudgeRecord(nudge: NudgeDecision, emergency: boolean): string;