antechamber 1.0.16 → 1.0.18

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project uses [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [1.0.18] - 2026-10-25
+
+- fix(session): accept late OmO extension entries after a fork refresh (#68)
+
+## [1.0.17] - 2026-10-24
+
+### Fixed
+
+- Keep a session's agent out of idle eviction while a background terminal session (`bash` run in the background)
+  is still running. The reaper killed it with the agent 15 minutes after the turn ended, so a CI poller or long
+  build died silently and the session never woke up with its result.
+- Fork (and `/btw`) on large sessions no longer fails with "Native tree refresh did not restore the saved
+  navigation". OmO's session-start hooks append extension entries (rules scan, session bindings) on top of the
+  restored branch right after the adapter reloads the session, and the check treated those as a lost navigation.
+
 ## [1.0.16] - 2026-10-23
 
 ### Fixed

package/dist/pi-rpc.d.ts

@@ -101,6 +101,8 @@ export declare class PiRpcClient extends EventEmitter {
     private agentActive;
     private compacting;
     private sessionPath;
+    /** Wall-clock spawn time; work OmO records before it belongs to an earlier agent process. */
+    readonly startedAtMs: number;
     get pid(): number | undefined;
     get isBusy(): boolean;
     get sessionFile(): string | undefined;

package/dist/pi-rpc.js

@@ -114,6 +114,8 @@ export class PiRpcClient extends EventEmitter {
     agentActive = false;
     compacting = false;
     sessionPath;
+    /** Wall-clock spawn time; work OmO records before it belongs to an earlier agent process. */
+    startedAtMs = Date.now();
     get pid() {
         return this.proc.pid;
     }

package/dist/session-tree.d.ts

@@ -56,6 +56,12 @@ export declare class SessionTreeError extends Error {
 }
 export declare function durableShellTree(tree: SessionTreeState): SessionTreeState;
 export declare function getEntries(pi: PiRpcClient, signal?: AbortSignal): Promise<Entries>;
+/**
+ * Whether the native leaf is the navigated leaf. OmO session_start hooks (pi-rules.scan,
+ * session bindings) can append extension `custom` entries on top of it after a switch;
+ * those carry no conversation, so they do not undo the navigation.
+ */
+export declare function restoredLeaf(tree: Entries, leaf: string | null): boolean;
 export declare function readSessionTree(piPath: string): Entries;
 /** Checkpoint persisted progress after agent_end, successful compaction, or process exit. */
 export declare function recordTurn(s: ManagedSession): void;

package/dist/session-tree.js

@@ -34,6 +34,24 @@ export async function getEntries(pi, signal) {
             };
     }
 }
+/**
+ * Whether the native leaf is the navigated leaf. OmO session_start hooks (pi-rules.scan,
+ * session bindings) can append extension `custom` entries on top of it after a switch;
+ * those carry no conversation, so they do not undo the navigation.
+ */
+export function restoredLeaf(tree, leaf) {
+    let id = tree.leafId;
+    // Bounded so a corrupt parent loop cannot hang the operation.
+    for (let steps = 0; id !== leaf; steps++) {
+        if (steps >= tree.entries.length)
+            return false;
+        const entry = tree.entries.find((candidate) => candidate.id === id);
+        if (entry?.type !== "custom")
+            return false;
+        id = entry.parentId;
+    }
+    return true;
+}
 export function readSessionTree(piPath) {
     const lines = readFileSync(piPath, "utf8").trimEnd().split("\n");
     const entries = [];

package/dist/sessions.js

@@ -14,7 +14,7 @@ import { SessionLifecycle } from "./lifecycle.js";
 import { ApprovalBridge, extensionUiRequestFrom } from "./approvals.js";
 import { getAgentName, getExposedAgentNames } from "./agent-name.js";
 import { RequestBodyError } from "./http.js";
-import { bindMessageEntries, branchEntries, durableShellTree, followExternalAppends, forkConversation, getEntries, navigate, recordTurn, readSessionTree, revertConversation, SessionTreeError, unrevertConversation, } from "./session-tree.js";
+import { bindMessageEntries, branchEntries, durableShellTree, followExternalAppends, forkConversation, getEntries, navigate, recordTurn, readSessionTree, restoredLeaf, revertConversation, SessionTreeError, unrevertConversation, } from "./session-tree.js";
 import { SubagentBridge } from "./subagents.js";
 import { MonitorSessions } from "./monitor-sessions.js";
 import { WorkStatusBridge } from "./work-status.js";
@@ -532,7 +532,7 @@ export class SessionManager {
                 try {
                     const leaf = saved === undefined ? undefined : await navigate(pi, saved);
                     tree = await getEntries(pi);
-                    if (leaf !== undefined && tree.leafId !== leaf)
+                    if (leaf !== undefined && !restoredLeaf(tree, leaf))
                         throw new SessionTreeError("Native tree refresh did not restore the saved navigation");
                     if (leaf !== undefined)
                         s.tree.leafId = leaf;
@@ -1239,7 +1239,7 @@ export class SessionManager {
                 (s.tree.revert || resumedLeaf !== saved || !branchEntries(tree).some((entry) => entry.id === saved))) {
                 const leaf = await navigate(pi, saved);
                 tree = await getEntries(pi);
-                if (tree.leafId !== leaf)
+                if (!restoredLeaf(tree, leaf))
                     throw new SessionTreeError("Revival did not restore the saved navigation");
                 s.tree.leafId = leaf;
             }

package/dist/work-status.d.ts

@@ -70,7 +70,14 @@ export declare class WorkStatusBridge {
     private readonly work;
     constructor(monitors: MonitorSessions);
     private state;
-    /** Evicting the agent process would kill its detached eval cells, so a live wake source keeps it. */
+    /**
+     * Evicting the agent process kills its detached eval cells and background terminal sessions (a
+     * `bash` run_in_background shell is owned by the agent, whose PTY closes when it exits, so its exit
+     * never wakes the session). A live wake source keeps it, and so does a manifest entry whose recorded
+     * process is alive and that this agent process started: a crashed or evicted agent never records
+     * its shells' exits, and such a leftover pid may since belong to an unrelated process. OmO itself
+     * counts an entry without `runtime` as not alive (terminal restore, `defaultBackgroundAlive`).
+     */
     wire(s: ManagedSession): void;
     observe(s: ManagedSession, ev: Record<string, unknown>): void;
     /** The agent process exited: its in-process wake sources and timers died with it. */

package/dist/work-status.js

@@ -138,9 +138,25 @@ export class WorkStatusBridge {
         }
         return work;
     }
-    /** Evicting the agent process would kill its detached eval cells, so a live wake source keeps it. */
+    /**
+     * Evicting the agent process kills its detached eval cells and background terminal sessions (a
+     * `bash` run_in_background shell is owned by the agent, whose PTY closes when it exits, so its exit
+     * never wakes the session). A live wake source keeps it, and so does a manifest entry whose recorded
+     * process is alive and that this agent process started: a crashed or evicted agent never records
+     * its shells' exits, and such a leftover pid may since belong to an unrelated process. OmO itself
+     * counts an entry without `runtime` as not alive (terminal restore, `defaultBackgroundAlive`).
+     */
     wire(s) {
-        s.hasWakeSources = () => (this.work.get(s.info.id)?.wakeSources.size ?? 0) > 0;
+        s.hasWakeSources = () => {
+            if ((this.work.get(s.info.id)?.wakeSources.size ?? 0) > 0)
+                return true;
+            const sessionFile = s.piPath;
+            const piSessionId = s.piSessionId;
+            const spawnedAt = s.pi?.startedAtMs;
+            if (sessionFile === undefined || piSessionId === undefined || spawnedAt === undefined)
+                return false;
+            return readBackgroundSessions(sessionFile, piSessionId).some((shell) => shell.pid !== undefined && shell.startedAtMs >= spawnedAt);
+        };
     }
     observe(s, ev) {
         if (ev.name === WAKE_SOURCE_STATE_EVENT) {

package/extensions/omo-compat/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antechamber-omo-compat",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "OpenChamber extension: displays OmO tool calls the way OmO means them when OpenChamber runs on antechamber",
   "private": true,
   "type": "module",

package/extensions/omo-dag/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antechamber-omo-graph",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "OpenChamber extension: live, interactive graph of the OmO sub-agents behind the current session",
   "private": true,
   "type": "module",

package/extensions/omo-work/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antechamber-omo-work",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "OpenChamber 2.x Work Status section: OmO todo phases, monitors, eval cells and background work of the current session",
   "private": true,
   "type": "module",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antechamber",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "OpenCode-compatible HTTP/SSE server that lets OpenChamber drive the pi coding agent (and OmO) over RPC",
   "type": "module",
   "license": "MIT",