billion-context-omp 0.3.0 → 0.3.2

package/README.md

@@ -144,7 +144,6 @@ Create `~/.omp/acp-omp.json` (global) and/or `<project>/.omp/acp-omp.json` (proj
 | Key | Default | Description |
 |-----|---------|-------------|
 | `debug` | `false` | Enable verbose **debug-level** events in the log. The always-on log (lifecycle events, errors, warnings) is written regardless; `debug` only adds extra diagnostics. Also enabled by env `ACP_DEBUG=1`. |
-| `transformMode` | unset (resolved per API) or explicit `"provider"` / `"context"` — where the compression surgery intercepts. Unset: `provider` where the host applies the wire-payload replacement AND the wire body has a codec path (anthropic-messages, ollama-chat; openai-completions on hosts >= 17.3.8 — upstream PR can1357/oh-my-pi#8717, issue #83); `context` everywhere else (issue #79). Explicit: always honored. `provider` transforms the provider wire payload (request-local, structurally immune to feedback re-entry); `context` rewrites the context event (legacy mode). |
 | `autoUpdate` | `true` | On session start (throttled to one check per 3 minutes), check npm for a newer version and auto-install it. Disable to avoid all startup network calls. |
 | `modelContextLimit` | *(auto)* | Override the context limit (in tokens). Defaults to the model's `contextWindow`. |
 | `toolBashDefaultTimeout` | `60` | Seconds injected into the `bash` tool when the model omits `timeout`. Without this a forgotten timeout can hang for thousands of seconds. `0` restores unbounded behavior. |

package/README.zh-CN.md

@@ -146,7 +146,6 @@ billion-context-omp 开箱即用，无需配置。可选键写入 JSON 配置文
 | `debug` | `false` | 开启**debug 级**详细日志事件。常开日志（生命周期事件、错误、警告）无论如何都会写；`debug` 只增加诊断信息。也可用环境变量 `ACP_DEBUG=1` 开启。 |
 | `autoUpdate` | `true` | 会话启动时（节流为每 3 分钟最多一次）检查 npm 是否有新版本并自动安装。关闭可避免所有启动期网络请求。 |
 | `modelContextLimit` | *(自动)* | 覆盖上下文上限（token 数）。默认取模型的 `contextWindow`。 |
-| `transformMode` | 未设置（按 API 解析）或显式 `"provider"` / `"context"` | 压缩手术拦截位置。未设置：host 会应用 wire 载荷替换且 wire 体有编解码路径的 API 用 `provider`（anthropic-messages、ollama-chat；openai-completions 需 host >= 17.3.8，上游 PR can1357/oh-my-pi#8717，issue #83），其余用 `context`（issue #79）。显式设置总是生效。`provider` 变换 provider wire 载荷（请求局部，结构性免疫回灌环路）；`context` 改写 context 事件（旧版模式）。 |
 | `toolBashDefaultTimeout` | `60` | 模型省略 `timeout` 时注入 `bash` 工具的秒数。没有它，一次忘记的 timeout 可能挂起数千秒。`0` 恢复无限制。 |
 | `toolOutputMaxBytes` | `200000` | 工具结果文本的硬字节上限（经 `tool_result` 钩子实施）。拦截 omp 自身上限管不住的失控输出。触发时模型会被告知完整输出在哪；调低（如 `8192`）可更省上下文，`0` 禁用。 |
 | `compress.maxContextLimit` | `"75%"` | 触发**强制压缩**提醒的上下文用量阈值（绕过增长门控与节拍）。接受比例（`0.75`）或百分比字符串（`"75%"`）。越低 = 越早/越激进压缩。 |

package/dist/config.d.ts

@@ -12,6 +12,17 @@ export interface DelegateConfig {
      *  counted as part of the main session totals. */
     displayUsage?: "merged" | "separate";
 }
+/** Fold-state persistence (issue #130): checkpoint the live fold slot to
+ * disk so a restarted session restores its compression blocks without
+ * waiting for the first provider request to refold the wire. */
+export interface FoldPersistenceConfig {
+    /** Default: enabled. `false` keeps the fold memory-only — restart falls
+     * back to the primeFold mirror. */
+    enabled?: boolean;
+    /** Directory for fold checkpoints. Default `~/.omp/acp-omp-folds/`
+     * (env `ACP_OMP_FOLD_DIR` overrides). */
+    dir?: string;
+}
 /** Compression tuning. All fields accept a ratio (0.75) or percent string
  *  ("75%") where noted. */
 export interface CompressConfig {
@@ -27,22 +38,6 @@ export interface CompressConfig {
  * (live model context window, protected tools, state persistence).
  */
 export interface AdapterConfig {
-    /** Where the compression surgery intercepts (issue #52). "provider"
-     *  leaves the agent array untouched and transforms the WIRE payload at
-     *  before_provider_request — request-local, no re-entry, structurally
-     *  immune to omp's feedback-view loops (the recap / subagent re-feed
-     *  pathology, issues #22/#52). Unknown provider formats pass through
-     *  untransformed (fail-open). "context" rewrites the context event —
-     *  battle-tested legacy mode, kept for compat.
-     *  When omitted, the mode is resolved per model API (issue #79):
-     *  "provider" where the host actually applies the wire-payload
-     *  replacement AND the wire body has a codec path — anthropic-messages,
-     *  ollama-chat, and openai-completions on hosts >= 17.3.8 (upstream PR
-     *  can1357/oh-my-pi#8717, issue #83); "context" everywhere else
-     *  (older hosts drop the replacement; bedrock/cursor/responses/google
-     *  bodies have no codec path yet). Explicit pinning in
-     *  ~/.omp/acp-omp.json always wins. */
-    transformMode?: "context" | "provider";
     /** When omitted, the adapter reads `ctx.model.contextWindow` live each turn.
      *  Set explicitly for tests/headless runs. */
     modelContextLimit?: number;
@@ -73,10 +68,14 @@ export interface AdapterConfig {
      *  head-truncated with a notice telling the model how to see the full output
      *  (bash: read BashToolDetails.fullOutputPath). */
     toolOutputMaxBytes?: number;
-    /** Delegate sub-agent config. Accepts a boolean shorthand (`true` →
+    /** Delegate sub-agent config. Accepts a boolean shorthand (`true`
      *  `{ enabled: true }`, `false` → `{ enabled: false }`) or a DelegateConfig
      *  object. Default: enabled. */
     delegate?: boolean | DelegateConfig;
+    /** Fold-state persistence (issue #130). Accepts a boolean shorthand (`true`
+     * → `{ enabled: true }`, `false` → `{ enabled: false }`) or a
+     * FoldPersistenceConfig object. Default: enabled. */
+    foldPersistence?: boolean | FoldPersistenceConfig;
     /** Compression tuning. */
     compress?: CompressConfig;
     /** Legacy flat alias for `delegate.displayUsage`. Kept for backward
@@ -104,5 +103,11 @@ export declare function resolveDelegate(adapter: AdapterConfig): {
     enabled: boolean;
     displayUsage: "merged" | "separate";
 };
+/** Resolve fold persistence config from the adapter, handling the boolean
+ * shorthand. */
+export declare function resolveFoldPersistence(adapter: AdapterConfig): {
+    enabled: boolean;
+    dir?: string;
+};
 export declare function resolveConfig(adapter: AdapterConfig, liveContextLimit: number): Config;
 export declare function parsePercent(v: number | string): number;

package/dist/fold-persist.d.ts

@@ -0,0 +1,69 @@
+import { StateStore } from "acp-kernel/persist";
+import type { CompressionState, CoreMessage } from "acp-kernel";
+/**
+ * Fold-state persistence: the restart checkpoint for the core-space fold
+ * (issue #130).
+ *
+ * The live fold is the truth source — it runs on the WIRE payload at
+ * `before_provider_request`, and that payload is request-local: at
+ * session_start omp does not have it yet. primeFold mirrors the fold from
+ * the session view instead, but the view→wire projection is host-owned
+ * (pi-ai's transformMessages + convertMessages: cross-model thinking
+ * demotion, developer→user mapping, empty-message drops). A mirror that
+ * guesses that projection lands in a different ref/fingerprint space, every
+ * in-stream compress replay fails the span guard, and /acp lies
+ * "Blocks: none" until the first provider request refolds the real wire
+ * (observed live: 1988 mirror pieces vs 1692 live pieces, 0/14 anchors).
+ *
+ * The fix: checkpoint the LIVE fold slot — identities in the wire's own
+ * content-hash space (coreIdentity is a pure function of content, so the
+ * next process recomputes the same ids from the same wire), the block
+ * ledger, assigned refs, and the folded stream itself. On restart the slot
+ * is restored directly; the first live fold then validates it through the
+ * normal LCP check instead of trusting the mirror.
+ *
+ * Storage MECHANISM lives in `acp-kernel/persist` (StateStore: atomic
+ * write, rename retries, debounce, per-id serialization, corrupt-tolerant
+ * load). This module is omp POLICY: where state lives, what shape it has,
+ * when it is saved.
+ *
+ * The store never deletes files: sessions outlive processes, and cleanup is
+ * a downstream/user policy decision (kernel position — see store.ts).
+ */
+/** Snapshot schema. Bump when the payload shape changes; older snapshots
+ * fail validation on load and the restart falls back to the primeFold
+ * mirror (fail-open, blocks rebuilt from the stream at the first live
+ * fold). */
+export declare const FOLD_SCHEMA_VERSION = 1;
+/** On-disk snapshot of a live FoldSlot (runtime.ts). `preview` is not
+ * persisted — only live folds are checkpointed; `appliedCallIds` is a Set
+ * in memory and a plain array on disk. */
+export interface FoldSnapshot {
+    identities: string[];
+    foldedLen: number;
+    state: CompressionState;
+    coreMessages: CoreMessage[];
+    appliedCallIds: string[];
+    rejectStreak: number;
+}
+/** Restore shape: everything a FoldSlot carries except `preview` (the
+ * runtime sets it — restored slots are live, not mirror junk). */
+export interface RestoredFoldSlot {
+    identities: string[];
+    foldedLen: number;
+    state: CompressionState;
+    coreMessages: CoreMessage[];
+    appliedCallIds: Set<string>;
+    rejectStreak: number;
+}
+/** Persisted-state directory. Default `~/.omp/acp-omp-folds/` (sibling of
+ * the acp-omp log), overridable per adapter config or env for tests and
+ * sandboxes. */
+export declare function foldPersistDir(configured?: string): string;
+/** Build the store for a directory. `enabled: false` (persistence off in
+ * adapter config) keeps the store a silent no-op — loads miss, writes drop. */
+export declare function createFoldStore(dir: string, enabled: boolean): StateStore<FoldSnapshot>;
+/** Rehydrate a validated snapshot into slot fields. The state runs through
+ * the kernel's mergeCompressionState so a snapshot written by an older
+ * version with missing fields still loads (forward-compat fill). */
+export declare function restoreFoldSnapshot(payload: FoldSnapshot): RestoredFoldSlot;