billion-context-pi 0.1.53 → 0.1.54-pr.237.54

package/README.md

@@ -22,6 +22,8 @@ The model decides <em>when</em> and <em>what</em> to compress — not a hard lim
 
 ---
 
+> **Host support:** this plugin is for **Pi**. It does **not** support **OMP (oh-my-pi)** — on an OMP host it refuses to run. OMP users: use [billion-context](https://github.com/ranxianglei/billion-context) instead (`bili omp`). Details: [docs/omp.md](./docs/omp.md).
+
 ## Why?
 
 When conversations get long, the model runs out of context. Most tools hard-truncate — silently dropping earlier messages. **billion-context** gives the model a `compress` tool: the LLM decides **when** and **what** to compress into high-fidelity summaries, preserving critical details (file paths, decisions, error strings) while reclaiming context space.
@@ -72,6 +74,22 @@ This has two practical implications:
 
 2. **Even with a single compression plugin, interference is still possible in rare cases.** Load order under Pi is determined by filesystem discovery order (`fs.readdirSync` over `.pi/extensions/` → global → packages), which is not fully deterministic. If another (non-compression) extension also hooks the `context` event and happens to load *after* billion-context-pi, it could modify the compressed output. billion-context-pi rebuilds its working set from the session log rather than the chained input, which makes it robust to handlers that run *before* it — but it cannot defend against a handler that runs *after* it. This is a limitation of Pi's extension model; if you observe unexpected context behavior, check whether other installed extensions intercept the `context` event.
 
+## Host support
+
+billion-context-pi is built for the **Pi** coding agent (`@earendil-works/pi-coding-agent`) and detects the host at session start:
+
+- **Pi** — fully supported.
+- **OMP (`can1357/oh-my-pi`)** — **not supported.** OMP's in-process session API diverges from Pi's, so the compression refs the extension injects can drift out of sync with the session's real refs and `compress` calls fail with `does not exist in this session` (issue [#234](https://github.com/ranxianglei/billion-context-pi/issues/234)). On OMP the extension now **refuses service**: it prints a warning, disables the ACP tools, and leaves the host's own context handling untouched.
+
+  **Use [billion-context](https://github.com/ranxianglei/billion-context) instead** — it runs the same compression pipeline server-side in a proxy, so the refs never diverge:
+
+  ```bash
+  npm install -g billion-context
+  bili omp   # run OMP through the proxy
+  ```
+
+  Full details: [docs/omp.md](./docs/omp.md).
+
 ## Model-facing tools
 
 | Tool | What it does |

package/README.zh-CN.md

@@ -20,6 +20,8 @@
 
 ---
 
+> **宿主支持:** 本插件面向 **Pi**。它**不支持 OMP(oh-my-pi)** —— 在 OMP 宿主上会拒绝运行。OMP 用户请改用 [billion-context](https://github.com/ranxianglei/billion-context)(`bili omp`)。详细说明:[docs/omp.zh-CN.md](./docs/omp.zh-CN.md)。
+
 ## 为什么选择 billion-context
 
 当对话变长,模型的上下文会耗尽。多数工具采用硬截断 —— 静默丢弃早期消息。**billion-context** 把 `compress` 工具交给模型:由 LLM 决定**何时**压缩、压缩**什么**,将内容压缩成高保真摘要,在回收上下文空间的同时保留关键细节(文件路径、决策、错误字符串)。
@@ -71,6 +73,22 @@ billion-context 通过拦截 Pi 的 `context` 事件接管上下文管理。**Pi
 
 2. **即使只有一个压缩插件,在少数情况下仍可能出现干扰。** Pi 下的加载顺序由文件系统发现顺序(`fs.readdirSync` 遍历 `.pi/extensions/` → 全局 → 包)决定,并不完全确定。如果另一个(非压缩类)扩展也 hook 了 `context` 事件、且恰好加载在 billion-context-pi *之后*,它可能修改压缩后的输出。billion-context-pi 从会话日志重建工作集(而非链式输入),这让它对*排在它之前*的 handler 鲁棒 —— 但无法防御*排在它之后*的 handler。这是 Pi 扩展模型的固有限制;若你观察到上下文行为异常,请检查是否有其他已安装扩展拦截了 `context` 事件。
 
+## 宿主支持
+
+billion-context-pi 面向 **Pi** 编码代理(`@earendil-works/pi-coding-agent`)构建,并在会话开始时检测宿主:
+
+- **Pi** — 完全支持。
+- **OMP(`can1357/oh-my-pi`)** — **不支持。** OMP 的进程内会话 API 与 Pi 不同,扩展注入的压缩引用可能与会话的真实引用漂移失步,导致 `compress` 调用失败,报错 `does not exist in this session`(issue [#234](https://github.com/ranxianglei/billion-context-pi/issues/234))。在 OMP 上,扩展现在会**拒绝服务**:打印警告、禁用 ACP 工具,并保持宿主自身的上下文处理不受影响。
+
+  **请改用 [billion-context](https://github.com/ranxianglei/billion-context)** — 它把同样的压缩流水线运行在服务端代理里,因此引用不会漂移:
+
+  ```bash
+  npm install -g billion-context
+  bili omp   # 让 OMP 通过代理运行
+  ```
+
+  完整说明:[docs/omp.zh-CN.md](./docs/omp.zh-CN.md)。
+
 ## 模型工具
 
 | 工具 | 作用 |

package/dist/delegate-tool.d.ts

@@ -8,7 +8,7 @@ export declare function delegateSpawnOptions(cwd: string, env: NodeJS.ProcessEnv
  *  run the SDK inside another node process, so probe instead. Non-pi hosts
  *  (omp) keep argv[1] untouched. */
 export declare function resolvePiCliEntry(argv1: string, env?: NodeJS.ProcessEnv, piHost?: boolean): string;
-type RunStatus = "running" | "completed" | "failed" | "cancelled";
+export type RunStatus = "running" | "completed" | "failed" | "cancelled";
 interface DelegateRun {
     runId: string;
     agent: string;
@@ -104,6 +104,7 @@ declare const WaitParams: Type.TObject<{
 }>;
 export declare function accumulateUsage(a: Usage | undefined, b: Usage): Usage;
 export declare function makeDelegateTool(pi: ExtensionAPI): ToolDefinition<typeof DelegateParams>;
+export declare function formatRunResult(run: DelegateRun): string;
 /** Runs that reached a terminal state but whose result never reached the
  *  model: no parked waiter, not consumed by a tool result, and never injected
  *  as a notification. The model was promised a notification ("do NOT keep
@@ -163,5 +164,12 @@ export declare function buildChildArgs(args: DelegateArgs, rolePrompt: string, c
     isAsync: boolean;
     useJsonStream: boolean;
 }>;
-export declare function injectResult(pi: ExtensionAPI, agent: string, runId: string, task: string, code: number | null, file: string, timedOut?: string, usage?: Usage, mode?: "merged" | "separate", usageAlreadyReported?: boolean, body?: string): boolean;
+/** Watchdog/EOF finalize arrives with code === null (the child was killed or
+ *  never exited). If a result was delivered (non-empty reply or stderr), the
+ *  run counts as completed (0); otherwise it stays null = genuine failure. */
+export declare function effectiveExitCode(code: number | null, output: string, stderr: string): number | null;
+/** status (set by finalize from the effective exit code) is the authority for
+ *  the FAILED/completed decision; the raw code is diagnostic display only
+ *  ("exit ?"), so the notification can never disagree with run.status. */
+export declare function injectResult(pi: ExtensionAPI, agent: string, runId: string, task: string, status: RunStatus, code: number | null, file: string, timedOut?: string, usage?: Usage, mode?: "merged" | "separate", usageAlreadyReported?: boolean, body?: string): boolean;
 export {};

package/dist/index.js

@@ -424,18 +424,42 @@ function assignRefs(messages, options) {
   return { map, nextIndex: cursor, newlyAssigned };
 }
 function allocateFreeRef(map, start) {
-  let candidate = Math.max(start, MIN_INDEX);
-  while (candidate <= MAX_INDEX) {
+  const from = Math.max(start, MIN_INDEX);
+  for (let candidate = from; candidate <= MAX_INDEX; candidate++) {
+    const text = indexToRef(candidate);
+    if (!map.byRef[text]) {
+      return { text, index: candidate };
+    }
+  }
+  for (let candidate = MIN_INDEX; candidate < from; candidate++) {
     const text = indexToRef(candidate);
     if (!map.byRef[text]) {
       return { text, index: candidate };
     }
-    candidate++;
   }
   throw new Error(
-    `ref capacity exhausted: cannot allocate beyond ${indexToRef(MAX_INDEX)}`
+    `ref capacity exhausted: all ${MAX_INDEX} ref slots are occupied by live messages \u2014 nothing left to reclaim`
   );
 }
+function pruneDeadRefs(map, liveIds) {
+  let pruned = 0;
+  const byRaw = {};
+  for (const [rawId, ref] of Object.entries(map.byRaw)) {
+    if (liveIds.has(rawId)) {
+      byRaw[rawId] = ref;
+      continue;
+    }
+    pruned++;
+  }
+  return { map: rebuildRefIndex({ byRaw, byRef: {} }), pruned };
+}
+function rebuildRefIndex(map) {
+  const byRef = {};
+  for (const [rawId, ref] of Object.entries(map.byRaw)) {
+    if (ref !== BLOCKED_REF) byRef[ref] = rawId;
+  }
+  return { byRaw: { ...map.byRaw }, byRef };
+}
 function highestUsedIndex(map) {
   let highest = 0;
   for (const ref of Object.values(map.byRaw)) {
@@ -634,6 +658,13 @@ function syncBlocks(messages, state) {
       deactivated.push(block.blockId);
     }
   }
+  const liveIds = new Set(presentIds);
+  for (const block of result.blocks) {
+    if (!block.active) continue;
+    for (const id of block.effectiveMessageIds) liveIds.add(id);
+  }
+  const prunedRefs = pruneDeadRefs(result.messageRefs, liveIds);
+  result.messageRefs = prunedRefs.map;
   return { state: result, deactivated };
 }
 function defaultConfig(modelContextLimit, overrides = {}) {
@@ -744,12 +775,14 @@ var BoundaryNotFoundError = class extends Error {
   code = "BOUNDARY_NOT_FOUND";
   kind;
   endpoint;
-  constructor(kind, endpoint, message) {
+  reason;
+  constructor(kind, endpoint, message, reason = null) {
     super(message);
     this.name = "BoundaryNotFoundError";
     this.code = "BOUNDARY_NOT_FOUND";
     this.kind = kind;
     this.endpoint = endpoint;
+    this.reason = reason;
   }
 };
 function resolveBoundaries(input) {
@@ -820,7 +853,7 @@ function resolveAnchorIndex(boundary, state, indexByMessageId, endpoint) {
       throw new BoundaryNotFoundError(
         "unknown",
         endpoint,
-        `${label}="${boundary.raw}" does not exist in this session (typo or wrong session) \u2014 run acp_status for current refs.`
+        `${label}="${boundary.raw}" does not exist in this session (typo, wrong session, or the message was edited/removed and its ref released) \u2014 run acp_status for current refs.`
       );
     }
     const index = indexByMessageId.get(rawId);
@@ -834,10 +867,33 @@ function resolveAnchorIndex(boundary, state, indexByMessageId, endpoint) {
         snapped: `${label}="${boundary.raw}" refers to a message already compressed into an active block \u2014 anchored to the active block covering it instead.`
       };
     }
+    const coveringActive = state.blocks.filter(
+      (block2) => block2.active && block2.effectiveMessageIds.includes(rawId)
+    );
+    if (coveringActive.length > 0) {
+      throw new BoundaryNotFoundError(
+        "consumed",
+        endpoint,
+        `${label}="${boundary.raw}" is already compressed into active block(s) ${coveringActive.map((block2) => block2.blockId).join(", ")} \u2014 retry with the block ref(s) instead of the message ref.`,
+        "consumed"
+      );
+    }
+    const generationReplaced = state.blocks.some(
+      (block2) => !block2.active && block2.effectiveMessageIds.includes(rawId)
+    );
+    if (generationReplaced) {
+      throw new BoundaryNotFoundError(
+        "consumed",
+        endpoint,
+        `${label}="${boundary.raw}" was compressed into a block that has since been distilled or consumed \u2014 its content is no longer available in this session; run acp_status for current refs.`,
+        "generation-replaced"
+      );
+    }
     throw new BoundaryNotFoundError(
       "consumed",
       endpoint,
-      `${label}="${boundary.raw}" not found in visible context (likely consumed by an existing block).`
+      `${label}="${boundary.raw}" no longer exists \u2014 the message was edited or removed (its content id changed); run acp_status for current refs.`,
+      "edit-drift"
     );
   }
   const block = blockById(state, `b${boundary.numericId}`);
@@ -866,16 +922,21 @@ function resolveAnchorIndex(boundary, state, indexByMessageId, endpoint) {
     };
   }
   if (!block.active) {
+    const consumer = state.blocks.find(
+      (candidate) => candidate.active && candidate.directBlockIds.includes(block.blockId) && visibleBlockAnchor(candidate, indexByMessageId) !== null
+    );
     throw new BoundaryNotFoundError(
       "consumed",
       endpoint,
-      `${label}="b${boundary.numericId}" not found in visible context (block distilled/consumed by a higher-tier block).`
+      consumer ? `${label}="b${boundary.numericId}" was consumed by ${consumer.blockId} (higher-tier block) \u2014 retry with ${consumer.blockId} instead.` : `${label}="b${boundary.numericId}" is inactive (distilled or garbage-collected) and none of its content is visible in the current context \u2014 run acp_status for current refs.`,
+      "generation-replaced"
     );
   }
   throw new BoundaryNotFoundError(
     "consumed",
     endpoint,
-    `${label}="b${boundary.numericId}" is an active block but none of its content (raw messages or rendered summary) is visible in the current context \u2014 run acp_status to verify.`
+    `${label}="b${boundary.numericId}" is an active block but none of its content (raw messages or rendered summary) is present in the current view \u2014 its messages were likely edited or removed (id drift); it will be deactivated on the next state sync. Run acp_status to verify.`,
+    "edit-drift"
   );
 }
 function activeOwnerAnchor(state, ownedIds, indexByMessageId) {
@@ -1800,10 +1861,33 @@ function numericBlockId(id) {
   const parsed = /^b(\d+)$/.exec(id);
   return parsed ? Number(parsed[1]) : 0;
 }
+function refGateDiagnostics(state, requestedRanges, unknownCount) {
+  const highest = highestUsedIndex(state.messageRefs);
+  const highestRef = highest > 0 ? indexToRef(highest) : "none";
+  return `[diagnostics: session highest ref=${highestRef}, unknown ranges in request=${unknownCount}/${requestedRanges}, session history=${state.stats.compressionCount} compression(s), ${state.blocks.length} block(s)]`;
+}
+function danglingMessageRefs(state, messages, spec) {
+  const visible = new Set(messages.map((m) => m.id));
+  const dangling = [];
+  for (const ref of [spec.startRef, spec.endRef]) {
+    const parsed = parseBoundary(ref);
+    if (!parsed || parsed.kind !== "message") continue;
+    const rawId = state.messageRefs.byRef[parsed.raw] ?? state.messageRefs.byRef[indexToRef(parsed.numericId)];
+    if (!rawId || visible.has(rawId)) continue;
+    const covered = state.blocks.some(
+      (block) => block.active && block.effectiveMessageIds.includes(rawId)
+    );
+    if (!covered) dangling.push(parsed.raw);
+  }
+  return dangling;
+}
 function createCore(ports = {}) {
   const countTokens = ports.countTokens ?? defaultCountTokens;
   function applyCompression(input) {
-    const state = cloneState(input.state);
+    const state = syncBlocks(
+      input.messages,
+      input.state
+    ).state;
     const runId = allocateRunId(state);
     let blocksCreated = 0;
     let tokensCompressed = 0;
@@ -1900,7 +1984,15 @@ function createCore(ports = {}) {
       if (!hasBlockBoundaryRange && totalRangeChars < input.config.compress.minCompressRange) {
         const live = activeBlocks(state).map((b) => b.blockId).sort((x, y) => numericBlockId(x) - numericBlockId(y));
         const liveHint = live.length > 0 ? ` Current active blocks span ${live[0]}..${live[live.length - 1]} \u2014 retry with startId/endId set to active block IDs in that span.` : "";
-        const gateMessage = resolvableCount === 0 && consumedRanges.length === 0 && unknownCount > 0 ? `None of the ${input.ranges.length} requested range(s) resolved \u2014 every ref failed with "does not exist in this session". Refs recorded before an earlier compress are stale: each successful compress renumbers the remaining refs. Run acp_status, then call the compress tool again using only the refs it reports.` : consumedRanges.length > 0 ? `Requested range(s) already compressed (e.g. ${consumedRanges[0].startRef}..${consumedRanges[0].endRef}) \u2014 your refs are stale: a prior compress renumbered the remaining refs, so this range now falls inside an active block. Run acp_status, then call the compress tool again using only the CURRENT compressible ranges it reports.${liveHint}` : `Total compressible content too small (${totalRangeChars} chars across ${countedRanges} range(s), min ${input.config.compress.minCompressRange}). Combine more messages into your range(s) to meet the threshold.`;
+        const diagnostics = refGateDiagnostics(
+          state,
+          input.ranges.length,
+          unknownCount
+        );
+        const danglingRefs = consumedRanges.flatMap(
+          (spec) => danglingMessageRefs(state, input.messages, spec)
+        );
+        const gateMessage = resolvableCount === 0 && consumedRanges.length === 0 && unknownCount > 0 ? `None of the ${input.ranges.length} requested range(s) resolved \u2014 every ref is unknown to this session. Refs are per-session snapshots, assigned once when a message is first rendered; no compress reassigns them, so unknown refs cannot come from an earlier compress in this session. They come from a different generation: a previous session instance (switching model or upstream mid-conversation starts a fresh session whose refs restart at m00001), the generation before a native-compaction rebase (which also resets refs to m00001), a typo, or a message that was edited or removed (its old ref was released when the content id changed). ${diagnostics} Run acp_status, then call the compress tool again using only the refs it reports.` : consumedRanges.length > 0 ? danglingRefs.length > 0 ? `Requested range(s) cannot be anchored (e.g. ${consumedRanges[0].startRef}..${consumedRanges[0].endRef}) \u2014 the refs exist in this session's ref map, but the messages they point to are no longer in the visible context and no active block covers them: the message content changed (or the message was filtered out of the view) and now carries a new ref, leaving your old refs dangling. ${diagnostics} Run acp_status, then call the compress tool again using only the refs it reports.` : `Requested range(s) already compressed (e.g. ${consumedRanges[0].startRef}..${consumedRanges[0].endRef}) \u2014 those refs no longer point to directly compressible content: the range is covered by active block(s) or the block ref(s) are stale (distilled or consumed). ${diagnostics} Run acp_status, then call the compress tool again using only the CURRENT compressible ranges it reports.${liveHint}` : `Total compressible content too small (${totalRangeChars} chars across ${countedRanges} range(s), min ${input.config.compress.minCompressRange}). Combine more messages into your range(s) to meet the threshold.`;
         return {
           state: input.state,
           result: {
@@ -2043,9 +2135,15 @@ var assignRefsNode = {
   run(io, ctx) {
     const hasProtection = ctx.config.protectedTools.length > 0 || !!ctx.config.isToolProtected;
     const protectedFn = hasProtection ? (m) => isMessageProtected(m, ctx.config) : void 0;
+    const liveIds = new Set(io.messages.map((m) => m.id));
+    for (const block of io.state.blocks) {
+      if (!block.active) continue;
+      for (const id of block.effectiveMessageIds) liveIds.add(id);
+    }
+    const pruned = pruneDeadRefs(io.state.messageRefs, liveIds);
     const refResult = assignRefs(io.messages, {
-      existing: io.state.messageRefs,
-      nextIndex: highestUsedIndex(io.state.messageRefs) + 1,
+      existing: pruned.map,
+      nextIndex: highestUsedIndex(pruned.map) + 1,
       isProtected: protectedFn
     });
     return { ...io, state: { ...io.state, messageRefs: refResult.map } };
@@ -2617,26 +2715,6 @@ function computeContextBreakdown(messages, total, growth, countTokens) {
   }
   return { system, tool, summaries, code, text, total, growth };
 }
-function cloneState(state) {
-  return {
-    blocks: state.blocks.map((block) => ({
-      ...block,
-      directMessageIds: [...block.directMessageIds],
-      effectiveMessageIds: [...block.effectiveMessageIds],
-      directBlockIds: [...block.directBlockIds]
-    })),
-    messageRefs: {
-      byRaw: { ...state.messageRefs.byRaw },
-      byRef: { ...state.messageRefs.byRef }
-    },
-    tokenSnapshot: { ...state.tokenSnapshot ?? {} },
-    nudge: { ...state.nudge, anchors: { ...state.nudge.anchors } },
-    stats: { ...state.stats },
-    absorbed: (state.absorbed ?? []).map((record) => ({ ...record })),
-    nextBlockId: state.nextBlockId,
-    nextRunId: state.nextRunId
-  };
-}
 function scoreRelevance(block, terms) {
   const topic = (block.topic ?? "").toLowerCase();
   const summary = block.summary.toLowerCase();
@@ -2967,9 +3045,9 @@ function parseObjectValue(value, callId, diag) {
   const content = value["content"];
   if (content === void 0) {
     const single = validateEntry(value, callId);
-    if (single) {
+    if ("range" in single) {
       diag.kind = "ok";
-      return finish([single], diag);
+      return finish([single.range], diag);
     }
     diag.kind = "missing-content";
     return finish([], diag);
@@ -2990,7 +3068,7 @@ function parseObjectValue(value, callId, diag) {
     diag.kind = "content-not-array";
     return finish([], diag);
   }
-  const { ranges, invalid } = validateEntries(entries, callId);
+  const { ranges, invalid, reasons } = validateEntries(entries, callId);
   const topTopic = stringOr(value["topic"]);
   const topMaxChars = value["summaryMaxChars"];
   const hasTopMaxChars = typeof topMaxChars === "number" && Number.isFinite(topMaxChars);
@@ -3001,6 +3079,7 @@ function parseObjectValue(value, callId, diag) {
     }
   }
   diag.invalidItems = invalid;
+  if (reasons.length > 0) diag.invalidReasons = reasons;
   diag.kind = salvaged ? "truncated" : ranges.length > 0 ? "ok" : "no-valid-ranges";
   return finish(ranges, diag);
 }
@@ -3024,36 +3103,43 @@ function finish(ranges, diag) {
   return { ranges, diagnostics: diag };
 }
 function finishSalvage(entries, callId, diag, truncatedShape) {
-  const { ranges, invalid } = validateEntries(entries, callId);
+  const { ranges, invalid, reasons } = validateEntries(entries, callId);
   diag.invalidItems = invalid;
+  if (reasons.length > 0) diag.invalidReasons = reasons;
   diag.kind = entries.length > 0 || truncatedShape ? "truncated" : "malformed-json";
   return finish(ranges, diag);
 }
 function validateEntries(entries, callId) {
   const ranges = [];
+  const reasons = [];
   let invalid = 0;
-  for (const entry of entries) {
-    const range = validateEntry(entry, callId);
-    if (range !== null) ranges.push(range);
-    else invalid++;
+  for (let i = 0; i < entries.length; i++) {
+    const outcome = validateEntry(entries[i], callId);
+    if ("range" in outcome) ranges.push(outcome.range);
+    else {
+      invalid++;
+      reasons.push(`entry ${i}: ${outcome.reason}`);
+    }
   }
-  return { ranges, invalid };
+  return { ranges, invalid, reasons };
 }
 function validateEntry(entry, callId) {
-  if (entry === null || typeof entry !== "object" || Array.isArray(entry)) return null;
+  if (entry === null || typeof entry !== "object" || Array.isArray(entry)) return { reason: "not an object" };
   const e = entry;
   const start = stringOr(e["startRef"]) ?? stringOr(e["startId"]) ?? stringOr(e["messageId"]);
   const end = stringOr(e["endRef"]) ?? stringOr(e["endId"]) ?? stringOr(e["messageId"]);
-  if (start === void 0 || end === void 0) return null;
+  if (start === void 0 || end === void 0) {
+    return { reason: "missing range bounds (need startRef/startId and endRef/endId)" };
+  }
   const summary = stringOr(e["summary"]);
-  if (summary === void 0) return null;
+  if (summary === void 0) return { reason: "missing summary" };
   const range = { startRef: start, endRef: end, summary };
   const topic = stringOr(e["topic"]);
   if (topic !== void 0) range.topic = topic;
   const maxChars = e["summaryMaxChars"];
   if (typeof maxChars === "number" && Number.isFinite(maxChars)) range.summaryMaxChars = maxChars;
   if (callId !== void 0) range.compressCallId = callId;
-  return range;
+  return { range };
 }
 function stringOr(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
@@ -4670,7 +4756,12 @@ function createRuntime(adapter) {
     const sm = ctx.sessionManager;
     await store.save(state, sm.getSessionFile() ?? void 0, sm.getSessionId());
   }
-  return { core, store, get adapter() {
+  let refused = false;
+  return { core, store, get refused() {
+    return refused;
+  }, set refused(v) {
+    refused = v;
+  }, get adapter() {
     return adapterRef;
   }, setAdapter: (a) => {
     adapterRef = a;
@@ -9139,6 +9230,19 @@ function getSystemPromptText(ctx) {
   return normalizeSystemPrompt(result);
 }
 
+// src/omp.ts
+function isOmpHost(sm) {
+  return !isPiHost(sm);
+}
+var OMP_UNSUPPORTED_MESSAGE = [
+  "[billion-context-pi] This host is OMP (oh-my-pi), which is NOT supported \u2014 ACP has been disabled for this session.",
+  `The in-process compression path is unreliable on OMP: the nudge's example refs diverge from the session's real refs, so compress calls fail with "does not exist in this session".`,
+  "Use the billion-context proxy instead \u2014 it runs compression server-side and works on OMP:",
+  "  npm install -g billion-context",
+  "  bili omp",
+  "Docs: https://github.com/ranxianglei/billion-context"
+].join("\n");
+
 // src/compress-tool.ts
 function formatK2(n) {
   return n >= 1e3 ? `${(n / 1e3).toFixed(1)}K` : String(n);
@@ -9177,6 +9281,7 @@ function makeCompressTool(runtime) {
     ],
     parameters: CompressParams,
     async execute(toolCallId, params, _signal, _onUpdate, ctx) {
+      if (runtime.refused) return { details: void 0, content: [{ type: "text", text: OMP_UNSUPPORTED_MESSAGE }] };
       let result;
       try {
         result = await handleCompress(params, runtime, ctx, toolCallId);
@@ -9358,6 +9463,7 @@ function makeDecompressTool(runtime) {
     ],
     parameters: DecompressParams,
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+      if (runtime.refused) return { details: void 0, content: [{ type: "text", text: OMP_UNSUPPORTED_MESSAGE }] };
       let result;
       try {
         result = await handleDecompress(params, runtime, ctx);
@@ -9597,6 +9703,7 @@ function makeSearchTool(runtime) {
     ],
     parameters: SearchParams,
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+      if (runtime.refused) return { details: void 0, content: [{ type: "text", text: OMP_UNSUPPORTED_MESSAGE }] };
       let result;
       try {
         result = await handleSearch(params, runtime, ctx);
@@ -10691,7 +10798,7 @@ async function runDelegate(pi, args, ctx, signal) {
             await appendFile(file2, fallback ? `${fallback}
 ` : "(no output)\n");
           }
-          const effectiveCode = code ?? (output || stderrText ? 0 : null);
+          const effectiveCode = effectiveExitCode(code, output, stderrText);
           run.result = { code, file: file2, body: body2 };
           run.status = effectiveCode === 0 ? "completed" : "failed";
           run.finishedAt = Date.now();
@@ -10709,7 +10816,7 @@ async function runDelegate(pi, args, ctx, signal) {
             return;
           }
           const mode = delegateDisplayUsage;
-          const injected = injectResult(pi, args.agent, runId, args.task, code, file2, run.timedOut, run.usage, mode, run.usageReported, run.status === "failed" ? body2 : void 0);
+          const injected = injectResult(pi, args.agent, runId, args.task, run.status, code, file2, run.timedOut, run.usage, mode, run.usageReported, run.status === "failed" ? body2 : void 0);
           if (run.usage && !run.usageReported && (mode === "separate" || injected)) {
             run.usageReported = true;
           }
@@ -10834,15 +10941,18 @@ function formatSyncResult(agent, runId, task, r, file) {
   const body = r.timedOut ? "(timed out)" : r.stderr.trim() || "(no stderr)";
   return formatPayload(header, file, task, body);
 }
-function injectResult(pi, agent, runId, task, code, file, timedOut, usage, mode = "separate", usageAlreadyReported, body) {
+function effectiveExitCode(code, output, stderr) {
+  return code ?? (output || stderr ? 0 : null);
+}
+function injectResult(pi, agent, runId, task, status, code, file, timedOut, usage, mode = "separate", usageAlreadyReported, body) {
   const send = pi.sendUserMessage;
   if (typeof send !== "function") {
     debug.event("delegate-inject-skipped", { runId, reason: "sendUserMessage unavailable" });
     logWarn("delegate", { event: "inject-skipped", runId, reason: "sendUserMessage unavailable" });
     return false;
   }
-  const failed = code !== 0;
-  const status = failed ? "FAILED \u26A0\uFE0F" : "completed";
+  const failed = status === "failed";
+  const statusLabel = failed ? "FAILED \u26A0\uFE0F" : "completed";
   const remaining = Array.from(runs.values()).filter((r) => r.status === "running").length;
   const remainingLine = remaining > 0 ? ` ${remaining} delegate${remaining === 1 ? " is" : "s are"} still running; keep doing other work and their notifications will arrive as they finish.` : " No delegates are currently running.";
   const timeoutNote = timedOut ? ` (timed out: ${timedOut})` : "";
@@ -10877,7 +10987,7 @@ Tokens: ${totalUsage.input.toLocaleString()} in, ${totalUsage.output.toLocaleStr
     if (lines.length) usageNote = ` Usage: ${lines.join(", ")}.`;
   }
   const closing = failed ? "This delegate did NOT complete its task \u2014 its result is missing from your work. Read the error excerpt (and the result file if present), then decide whether to re-dispatch the task before wrapping up. This is an automated system notification, NOT a user message." : "This is an automated system notification, NOT a user message. Read the result file if you need the details, then continue your original task; do not treat this as a new user request.";
-  const header = `[acp_delegate ${status}] **${agent}** (runId \`${runId}\`, exit ${code ?? "?"})${timeoutNote}${remainingLine}${usageNote} ${closing}`;
+  const header = `[acp_delegate ${statusLabel}] **${agent}** (runId \`${runId}\`, exit ${code ?? "?"})${timeoutNote}${remainingLine}${usageNote} ${closing}`;
   const { text: recoveryText, covered } = buildRecoveryNotice(Array.from(runs.values()), runId);
   const text = formatPayload(header, file, task, failed ? body : void 0) + (recoveryText ? `
 
@@ -10902,6 +11012,7 @@ function notifyTerminalFailure(pi, run, body) {
     run.agent,
     run.runId,
     run.task,
+    run.status,
     run.result?.code ?? null,
     run.result?.file ?? "",
     run.timedOut,
@@ -10976,6 +11087,7 @@ function makeStatusTool(runtime) {
     ],
     parameters: StatusParams,
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+      if (runtime.refused) return { details: void 0, content: [{ type: "text", text: OMP_UNSUPPORTED_MESSAGE }] };
       let result;
       try {
         result = await handleStatus(params, runtime, ctx);
@@ -11503,7 +11615,7 @@ async function statusReport(runtime, ctx) {
   const coveredIds = collectCoveredMessageIds(state);
   const sentTokens = estimateTokens(coreMessages, coveredIds, imageTokens) + systemPromptTokens;
   const turn = runtime.core.processTurn({ messages: coreMessages, state, config, tokenCount: anchorStale ? sentTokens : Math.max(sentTokens, realUsage?.tokens ?? 0) });
-  const versionStr = "0.1.53" ? `billion-context-pi@${"0.1.53"}` : void 0;
+  const versionStr = "0.1.54" ? `billion-context-pi@${"0.1.54"}` : void 0;
   let text = buildStatusPanel({
     version: versionStr,
     tokenCount: sessionTokens,
@@ -11866,7 +11978,7 @@ async function autoInstallLatest(latest, extDirOverride) {
       "--no-fund",
       "--no-save"
     ];
-    const prevVersion = (await readPackageJson(join8(extDir, "package.json")))?.version ?? "0.1.53";
+    const prevVersion = (await readPackageJson(join8(extDir, "package.json")))?.version ?? "0.1.54";
     const { code, stderr } = await runNpmImpl(installArgs(latest), { cwd: npmDir, timeout: 6e4 });
     if (code !== 0) {
       logWarn("update", {
@@ -11879,7 +11991,7 @@ async function autoInstallLatest(latest, extDirOverride) {
     }
     const verify = await verifyInstall(npmDir, latest);
     if (!verify.ok) {
-      const rollbackTo = SEMVER_RE.test(prevVersion) ? prevVersion : "0.1.53";
+      const rollbackTo = SEMVER_RE.test(prevVersion) ? prevVersion : "0.1.54";
       logWarn("update", { event: "auto-install-verify-failed", latest, reason: verify.reason, rollbackTo });
       const rb = await runNpmImpl(installArgs(rollbackTo), { cwd: npmDir, timeout: 6e4 });
       logInfo("update", { event: "rollback", from: latest, to: rollbackTo, ok: rb.code === 0 });
@@ -11940,7 +12052,7 @@ async function checkForUpdate(autoUpdate, notify) {
     const runtimeVersion = await getRuntimeVersion();
     const latest = await fetchLatestVersion();
     if (!latest) return;
-    const current = runtimeVersion ?? "0.1.53";
+    const current = runtimeVersion ?? "0.1.54";
     const hasUpdate = isNewer(latest, current);
     debug.event("update-check", {
       current,
@@ -11986,7 +12098,7 @@ function createAcpExtension(adapter = {}) {
       return;
     }
     const runtime = createRuntime(adapter);
-    wireCompactionDisable(pi);
+    wireCompactionDisable(pi, runtime);
     wireSessionLifecycle(pi, runtime);
     wireContextTransform(pi, runtime);
     wireSystemPrompt(pi, runtime);
@@ -12003,11 +12115,26 @@ function createAcpExtension(adapter = {}) {
   };
 }
 var index_default = createAcpExtension();
-function wireCompactionDisable(pi) {
-  pi.on("session_before_compact", () => ({ cancel: true }));
+function wireCompactionDisable(pi, runtime) {
+  pi.on("session_before_compact", () => {
+    if (runtime.refused) return;
+    return { cancel: true };
+  });
 }
 function wireSessionLifecycle(pi, runtime) {
+  let ompWarned = false;
   pi.on("session_start", async (_event, ctx) => {
+    if (isOmpHost(ctx.sessionManager)) {
+      runtime.refused = true;
+      if (!ompWarned) {
+        ompWarned = true;
+        const sid2 = ctx.sessionManager.getSessionId();
+        logWarn("host", { event: "omp-unsupported", sid: sid2, action: "refused" });
+        if (ctx.hasUI) ctx.ui.notify(OMP_UNSUPPORTED_MESSAGE, "warning");
+        else console.error(OMP_UNSUPPORTED_MESSAGE);
+      }
+      return;
+    }
     runtime.store.invalidate();
     runtime.clearNudgeTracking();
     runtime.throttleFor(ctx.sessionManager.getSessionId()).reset();
@@ -12016,7 +12143,7 @@ function wireSessionLifecycle(pi, runtime) {
     setDelegateDisplayUsage("separate");
     const sid = ctx.sessionManager.getSessionId();
     const modelInfo = ctx.model;
-    logInfo("session", { event: "start", sid, cwd: ctx.cwd, debug: runtime.adapter.debug ?? null, version: true ? "0.1.53" : null, model: modelInfo?.id ?? null, modelApi: modelInfo?.api ?? null, contextWindow: modelInfo?.contextWindow ?? null });
+    logInfo("session", { event: "start", sid, cwd: ctx.cwd, debug: runtime.adapter.debug ?? null, version: true ? "0.1.54" : null, model: modelInfo?.id ?? null, modelApi: modelInfo?.api ?? null, contextWindow: modelInfo?.contextWindow ?? null });
     try {
       await runtime.reloadConfig(ctx.cwd);
       setDelegateDisplayUsage(resolveDelegate(runtime.adapter).displayUsage);
@@ -12047,6 +12174,7 @@ function wireSessionLifecycle(pi, runtime) {
 }
 function wireContextTransform(pi, runtime) {
   pi.on("context", async (event, ctx) => {
+    if (runtime.refused) return;
     const sid = ctx.sessionManager.getSessionId();
     const release = await runtime.acquireLock(sid);
     try {
@@ -12185,6 +12313,7 @@ ${rendered.text}${example}`);
 }
 function wireSystemPrompt(pi, runtime) {
   pi.on("before_agent_start", (event) => {
+    if (runtime.refused) return;
     const delegate = runtime.adapter.delegate !== false;
     const acp = buildAcpSystemPrompt(runtime.prompts);
     const prompt = delegate ? `${acp}