oh-my-codex-pennix 0.18.13

package/dist/runtime/__tests__/process-tree.test.js

@@ -0,0 +1,107 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtemp, readFile, writeFile } from 'node:fs/promises';
+import { chmodSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { runProcessTreeWithTimeout } from '../process-tree.js';
+describe('runProcessTreeWithTimeout', () => {
+    it('captures successful command output', async () => {
+        const result = await runProcessTreeWithTimeout(process.execPath, [
+            '-e',
+            'process.stdout.write("ok"); process.stderr.write("warn");',
+        ], { timeoutMs: 1_000 });
+        assert.equal(result.status, 0);
+        assert.equal(result.timedOut, false);
+        assert.equal(result.stdout, 'ok');
+        assert.equal(result.stderr, 'warn');
+    });
+    it('marks timed out commands after terminating the process tree', async () => {
+        const result = await runProcessTreeWithTimeout(process.execPath, [
+            '-e',
+            'setTimeout(() => {}, 5_000);',
+        ], { timeoutMs: 50, sigkillGraceMs: 10 });
+        assert.equal(result.timedOut, true);
+        assert.notEqual(result.status, 0);
+    });
+    it('terminates commands that exceed the configured output limit', async () => {
+        const result = await runProcessTreeWithTimeout(process.execPath, [
+            '-e',
+            'while (true) process.stdout.write("x".repeat(1024));',
+        ], { timeoutMs: 5_000, sigkillGraceMs: 10, maxOutputBytes: 4096 });
+        assert.equal(result.outputLimitExceeded, true);
+        assert.equal(Buffer.byteLength(result.stdout), 4096);
+        assert.notEqual(result.status, 0);
+    });
+    it('terminates suspicious process storms before the global timeout', { skip: process.platform !== 'linux' }, async () => {
+        const root = await mkdtemp(join(tmpdir(), 'omx-process-tree-storm-'));
+        const script = join(root, 'storm.sh');
+        await writeFile(script, [
+            '#!/bin/sh',
+            'while :; do',
+            '  sleep 30 &',
+            '  sleep 0.01',
+            'done',
+            '',
+        ].join('\n'));
+        chmodSync(script, 0o755);
+        const started = Date.now();
+        const result = await runProcessTreeWithTimeout(script, [], {
+            timeoutMs: 10_000,
+            sigkillGraceMs: 10,
+            maxProcessCount: 12,
+            processLimitPollMs: 25,
+        });
+        assert.equal(result.processLimitExceeded, true);
+        assert.equal(result.timedOut, false);
+        assert.ok(Date.now() - started < 5_000);
+        assert.notEqual(result.status, 0);
+    });
+    it('returns parent output promptly when inherited-stdio grandchildren outlive the parent', { skip: process.platform === 'win32' }, async () => {
+        const root = await mkdtemp(join(tmpdir(), 'omx-process-tree-inherited-stdio-'));
+        const script = join(root, 'inherited-stdio.sh');
+        await writeFile(script, [
+            '#!/bin/sh',
+            '(sleep 30) &',
+            'printf "parent stdout\n"',
+            'printf "parent stderr\n" >&2',
+            'exit 7',
+            '',
+        ].join('\n'));
+        chmodSync(script, 0o755);
+        const started = Date.now();
+        const result = await runProcessTreeWithTimeout(script, [], {
+            timeoutMs: 10_000,
+            sigkillGraceMs: 10,
+        });
+        assert.equal(result.timedOut, false);
+        assert.equal(result.status, 7);
+        assert.equal(result.stdout, 'parent stdout\n');
+        assert.equal(result.stderr, 'parent stderr\n');
+        assert.ok(Date.now() - started < 3_000, 'should not wait for grandchild sleep or timeout');
+    });
+    it('sweeps process-group grandchildren when the direct child exits', { skip: process.platform === 'win32' }, async () => {
+        const root = await mkdtemp(join(tmpdir(), 'omx-process-tree-orphan-'));
+        const script = join(root, 'orphan.sh');
+        const ready = join(root, 'ready');
+        const term = join(root, 'term');
+        await writeFile(script, [
+            '#!/bin/sh',
+            `(trap 'printf term > ${term}; exit 0' TERM; printf ready > ${ready}; sleep 30) >/dev/null 2>&1 &`,
+            `while [ ! -f ${ready} ]; do sleep 0.01; done`,
+            'printf "parent done\\n"',
+            'exit 0',
+            '',
+        ].join('\n'));
+        chmodSync(script, 0o755);
+        const result = await runProcessTreeWithTimeout(script, [], { timeoutMs: 10_000 });
+        assert.equal(result.status, 0);
+        assert.equal(result.stdout, 'parent done\n');
+        for (let i = 0; i < 20 && !existsSync(term); i += 1) {
+            await new Promise((resolve) => setTimeout(resolve, 25));
+        }
+        assert.equal(existsSync(term), true);
+        assert.equal(await readFile(term, 'utf8'), 'term');
+    });
+});
+//# sourceMappingURL=process-tree.test.js.map

package/dist/runtime/__tests__/process-tree.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-tree.test.js","sourceRoot":"","sources":["../../../src/runtime/__tests__/process-tree.test.ts"],"names":[],"mappings":"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"}

package/dist/runtime/__tests__/run-loop.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-loop.test.d.ts.map

package/dist/runtime/__tests__/run-loop.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-loop.test.d.ts","sourceRoot":"","sources":["../../../src/runtime/__tests__/run-loop.test.ts"],"names":[],"mappings":""}

package/dist/runtime/__tests__/run-loop.test.js

@@ -0,0 +1,35 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { runUntilTerminal } from '../run-loop.js';
+describe('runUntilTerminal', () => {
+    it('continues through non-terminal outcomes until finish', async () => {
+        const seen = [];
+        const result = await runUntilTerminal(async (iteration) => ({
+            outcome: iteration < 3 ? 'continue' : 'finish',
+            state: { iteration },
+        }), {
+            onIteration(step) {
+                seen.push(`${step.iteration}:${step.outcome}`);
+            },
+        });
+        assert.equal(result.iteration, 3);
+        assert.equal(result.outcome, 'finish');
+        assert.deepEqual(result.history, ['continue', 'continue', 'finish']);
+        assert.deepEqual(seen, ['1:continue', '2:continue', '3:finish']);
+    });
+    it('normalizes legacy terminal labels before returning', async () => {
+        const result = await runUntilTerminal(async () => ({
+            outcome: 'completed',
+            state: { ok: true },
+        }));
+        assert.equal(result.outcome, 'finish');
+        assert.deepEqual(result.history, ['finish']);
+    });
+    it('throws when maxIterations is exceeded without terminal progress', async () => {
+        await assert.rejects(() => runUntilTerminal(async (iteration) => ({
+            outcome: iteration % 2 === 0 ? 'progress' : 'continue',
+            state: { iteration },
+        }), { maxIterations: 3 }), /maxIterations=3/);
+    });
+});
+//# sourceMappingURL=run-loop.test.js.map

package/dist/runtime/__tests__/run-loop.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-loop.test.js","sourceRoot":"","sources":["../../../src/runtime/__tests__/run-loop.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YACpB,OAAO,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ;YAC9C,KAAK,EAAE,EAAE,SAAS,EAAE;SACrB,CAAC,EACF;YACE,WAAW,CAAC,IAAI;gBACd,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACjD,CAAC;SACF,CACF,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACvC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;QACrE,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YACjD,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;SACpB,CAAC,CAAC,CAAC;QAEJ,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACvC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,MAAM,CAAC,OAAO,CAClB,GAAG,EAAE,CACH,gBAAgB,CACd,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YACpB,OAAO,EAAE,SAAS,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;YACtD,KAAK,EAAE,EAAE,SAAS,EAAE;SACrB,CAAC,EACF,EAAE,aAAa,EAAE,CAAC,EAAE,CACrB,EACH,iBAAiB,CAClB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/runtime/__tests__/run-outcome.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-outcome.test.d.ts.map

package/dist/runtime/__tests__/run-outcome.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-outcome.test.d.ts","sourceRoot":"","sources":["../../../src/runtime/__tests__/run-outcome.test.ts"],"names":[],"mappings":""}

package/dist/runtime/__tests__/run-outcome.test.js

@@ -0,0 +1,102 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { applyRunOutcomeContract, inferRunOutcome, isTerminalRunOutcome, normalizeRunOutcome, } from '../run-outcome.js';
+import { compatibilityRunOutcomeFromTerminalLifecycleOutcome, inferTerminalLifecycleOutcome, normalizeTerminalLifecycleOutcome, preferredRunOutcomeForLifecycleOutcome, } from '../terminal-lifecycle.js';
+import { shouldContinueRun } from '../run-loop.js';
+describe('run outcome contract', () => {
+    it('normalizes legacy outcome aliases', () => {
+        assert.deepEqual(normalizeRunOutcome('completed'), {
+            outcome: 'finish',
+            warning: 'normalized legacy run outcome "completed" -> "finish"',
+        });
+    });
+    it('infers continue for active non-terminal state', () => {
+        assert.equal(inferRunOutcome({ active: true, current_phase: 'executing' }), 'continue');
+    });
+    it('infers terminal outcomes from terminal phases', () => {
+        assert.equal(inferRunOutcome({ active: false, current_phase: 'complete' }), 'finish');
+        assert.equal(inferRunOutcome({ active: false, current_phase: 'blocked_on_user' }), 'blocked_on_user');
+        assert.equal(inferRunOutcome({ active: false, current_phase: 'failed' }), 'failed');
+        assert.equal(inferRunOutcome({ active: false, current_phase: 'cancelled' }), 'cancelled');
+    });
+    it('clears stale completed_at for non-terminal progress', () => {
+        const result = applyRunOutcomeContract({
+            active: true,
+            current_phase: 'executing',
+            completed_at: '2026-04-18T00:00:00.000Z',
+        });
+        assert.equal(result.ok, true);
+        assert.equal(result.state?.run_outcome, 'continue');
+        assert.equal(result.state?.completed_at, undefined);
+    });
+    it('stamps completed_at for terminal outcomes and marks them inactive', () => {
+        const result = applyRunOutcomeContract({
+            current_phase: 'blocked_on_user',
+        }, { nowIso: '2026-04-18T12:00:00.000Z' });
+        assert.equal(result.ok, true);
+        assert.equal(result.state?.active, false);
+        assert.equal(result.state?.run_outcome, 'blocked_on_user');
+        assert.equal(result.state?.completed_at, '2026-04-18T12:00:00.000Z');
+        assert.equal(isTerminalRunOutcome(result.state?.run_outcome), true);
+    });
+    it('rejects contradictory terminal/active combinations', () => {
+        const result = applyRunOutcomeContract({
+            active: true,
+            run_outcome: 'failed',
+        });
+        assert.equal(result.ok, false);
+        assert.match(result.error || '', /requires active=false/);
+    });
+    it('suppresses continuation when an explicit terminal run_outcome is present', () => {
+        assert.equal(shouldContinueRun({
+            active: true,
+            current_phase: 'executing',
+            run_outcome: 'blocked_on_user',
+        }), false);
+    });
+    it('continues non-terminal runs when the outcome is continue', () => {
+        assert.equal(shouldContinueRun({
+            active: true,
+            current_phase: 'executing',
+            run_outcome: 'continue',
+        }), true);
+    });
+    it('normalizes canonical terminal lifecycle outcomes and legacy aliases', () => {
+        assert.deepEqual(normalizeTerminalLifecycleOutcome('askuserQuestion'), {
+            outcome: 'askuserQuestion',
+        });
+        assert.deepEqual(normalizeTerminalLifecycleOutcome('complete'), {
+            outcome: 'finished',
+            warning: 'normalized legacy lifecycle outcome "complete" -> "finished"',
+        });
+        assert.deepEqual(normalizeTerminalLifecycleOutcome('cancelled'), {
+            outcome: 'userinterlude',
+            warning: 'normalized legacy lifecycle outcome "cancelled" -> "userinterlude"',
+        });
+    });
+    it('infers terminal lifecycle outcome from legacy run_outcome when no canonical field exists', () => {
+        assert.deepEqual(inferTerminalLifecycleOutcome({ run_outcome: 'finish' }), {
+            outcome: 'finished',
+        });
+        assert.deepEqual(inferTerminalLifecycleOutcome({ run_outcome: 'blocked_on_user' }), {
+            outcome: 'blocked',
+        });
+        assert.deepEqual(inferTerminalLifecycleOutcome({ run_outcome: 'cancelled' }), {
+            outcome: 'userinterlude',
+            warning: 'normalized legacy run outcome "cancelled" -> "userinterlude"',
+        });
+    });
+    it('maps canonical lifecycle outcomes to compatibility run_outcome values', () => {
+        assert.equal(preferredRunOutcomeForLifecycleOutcome('finished'), 'finish');
+        assert.equal(preferredRunOutcomeForLifecycleOutcome('blocked'), 'blocked_on_user');
+        assert.equal(preferredRunOutcomeForLifecycleOutcome('failed'), 'failed');
+        assert.equal(preferredRunOutcomeForLifecycleOutcome('userinterlude'), 'cancelled');
+        assert.equal(preferredRunOutcomeForLifecycleOutcome('askuserQuestion'), 'blocked_on_user');
+    });
+    it('keeps terminal lifecycle compatibility helpers aligned with the shared run outcome contract', () => {
+        for (const outcome of ['finished', 'blocked', 'failed', 'userinterlude', 'askuserQuestion']) {
+            assert.equal(preferredRunOutcomeForLifecycleOutcome(outcome), compatibilityRunOutcomeFromTerminalLifecycleOutcome(outcome));
+        }
+    });
+});
+//# sourceMappingURL=run-outcome.test.js.map

package/dist/runtime/__tests__/run-outcome.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-outcome.test.js","sourceRoot":"","sources":["../../../src/runtime/__tests__/run-outcome.test.ts"],"names":[],"mappings":"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"}

package/dist/runtime/__tests__/run-state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-state.test.d.ts.map

package/dist/runtime/__tests__/run-state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-state.test.d.ts","sourceRoot":"","sources":["../../../src/runtime/__tests__/run-state.test.ts"],"names":[],"mappings":""}

package/dist/runtime/__tests__/run-state.test.js

@@ -0,0 +1,37 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, readFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, it } from 'node:test';
+import { buildRunState, syncRunStateFromModeState } from '../run-state.js';
+describe('run state sync', () => {
+    it('preserves canonical askuserQuestion lifecycle while keeping legacy blocked_on_user outcome', () => {
+        const state = buildRunState({
+            mode: 'deep-interview',
+            active: false,
+            run_outcome: 'blocked_on_user',
+            lifecycle_outcome: 'askuserQuestion',
+        }, null, '2026-04-19T00:00:00.000Z');
+        assert.equal(state.outcome, 'blocked_on_user');
+        assert.equal(state.lifecycle_outcome, 'askuserQuestion');
+    });
+    it('writes canonical askuserQuestion lifecycle to run-state.json during sync', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'omx-run-state-'));
+        try {
+            const synced = await syncRunStateFromModeState({
+                mode: 'deep-interview',
+                active: false,
+                run_outcome: 'blocked_on_user',
+                lifecycle_outcome: 'askuserQuestion',
+            }, wd);
+            const persisted = JSON.parse(await readFile(join(wd, '.omx', 'state', 'run-state.json'), 'utf-8'));
+            assert.equal(synced.outcome, 'blocked_on_user');
+            assert.equal(synced.lifecycle_outcome, 'askuserQuestion');
+            assert.equal(persisted.lifecycle_outcome, 'askuserQuestion');
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=run-state.test.js.map

package/dist/runtime/__tests__/run-state.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-state.test.js","sourceRoot":"","sources":["../../../src/runtime/__tests__/run-state.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,4FAA4F,EAAE,GAAG,EAAE;QACpG,MAAM,KAAK,GAAG,aAAa,CACzB;YACE,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,iBAAiB;YAC9B,iBAAiB,EAAE,iBAAiB;SACrC,EACD,IAAI,EACJ,0BAA0B,CAC3B,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACxF,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAC5C;gBACE,IAAI,EAAE,gBAAgB;gBACtB,MAAM,EAAE,KAAK;gBACb,WAAW,EAAE,iBAAiB;gBAC9B,iBAAiB,EAAE,iBAAiB;aACrC,EACD,EAAE,CACH,CAAC;YAEF,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAC1B,MAAM,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC,CACpD,CAAC;YAEnB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;YAChD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;YAC1D,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;QAC/D,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/runtime/bridge.d.ts

@@ -0,0 +1,214 @@
+/**
+ * TS Runtime Bridge — thin wrapper over omx-runtime binary.
+ *
+ * All semantic state mutations route through `execCommand()`.
+ * All state queries read Rust-authored compatibility JSON files.
+ * Set OMX_RUNTIME_BRIDGE=0 to disable bridge (fallback to TS-direct).
+ */
+export interface RuntimeSnapshot {
+    schema_version: number;
+    authority: AuthoritySnapshot;
+    backlog: BacklogSnapshot;
+    replay: ReplaySnapshot;
+    readiness: ReadinessSnapshot;
+}
+export interface AuthoritySnapshot {
+    owner: string | null;
+    lease_id: string | null;
+    leased_until: string | null;
+    stale: boolean;
+    stale_reason: string | null;
+}
+export interface BacklogSnapshot {
+    pending: number;
+    notified: number;
+    delivered: number;
+    failed: number;
+}
+export interface ReplaySnapshot {
+    cursor: string | null;
+    pending_events: number;
+    last_replayed_event_id: string | null;
+    deferred_leader_notification: boolean;
+}
+export interface ReadinessSnapshot {
+    ready: boolean;
+    reasons: string[];
+}
+export type RuntimeCommand = {
+    command: 'AcquireAuthority';
+    owner: string;
+    lease_id: string;
+    leased_until: string;
+} | {
+    command: 'RenewAuthority';
+    owner: string;
+    lease_id: string;
+    leased_until: string;
+} | {
+    command: 'QueueDispatch';
+    request_id: string;
+    target: string;
+    metadata?: Record<string, unknown>;
+} | {
+    command: 'MarkNotified';
+    request_id: string;
+    channel: string;
+} | {
+    command: 'MarkDelivered';
+    request_id: string;
+} | {
+    command: 'MarkFailed';
+    request_id: string;
+    reason: string;
+} | {
+    command: 'RequestReplay';
+    cursor?: string;
+} | {
+    command: 'CaptureSnapshot';
+} | {
+    command: 'CreateMailboxMessage';
+    message_id: string;
+    from_worker: string;
+    to_worker: string;
+    body: string;
+} | {
+    command: 'MarkMailboxNotified';
+    message_id: string;
+} | {
+    command: 'MarkMailboxDelivered';
+    message_id: string;
+};
+export type RuntimeEvent = {
+    event: 'AuthorityAcquired';
+    owner: string;
+    lease_id: string;
+    leased_until: string;
+} | {
+    event: 'AuthorityRenewed';
+    owner: string;
+    lease_id: string;
+    leased_until: string;
+} | {
+    event: 'DispatchQueued';
+    request_id: string;
+    target: string;
+    metadata?: Record<string, unknown>;
+} | {
+    event: 'DispatchNotified';
+    request_id: string;
+    channel: string;
+} | {
+    event: 'DispatchDelivered';
+    request_id: string;
+} | {
+    event: 'DispatchFailed';
+    request_id: string;
+    reason: string;
+} | {
+    event: 'ReplayRequested';
+    cursor?: string;
+} | {
+    event: 'SnapshotCaptured';
+} | {
+    event: 'MailboxMessageCreated';
+    message_id: string;
+    from_worker: string;
+    to_worker: string;
+    body?: string;
+} | {
+    event: 'MailboxNotified';
+    message_id: string;
+} | {
+    event: 'MailboxDelivered';
+    message_id: string;
+};
+export interface DispatchRecord {
+    request_id: string;
+    target: string;
+    status: 'pending' | 'notified' | 'delivered' | 'failed';
+    created_at: string;
+    notified_at: string | null;
+    delivered_at: string | null;
+    failed_at: string | null;
+    reason: string | null;
+    metadata: Record<string, unknown> | null;
+}
+export interface MailboxRecord {
+    message_id: string;
+    from_worker: string;
+    to_worker: string;
+    body: string;
+    created_at: string;
+    notified_at: string | null;
+    delivered_at: string | null;
+}
+/**
+ * Raised when the omx-runtime binary returns output that fails JSON decoding.
+ *
+ * Distinguishing parse failure from spawn failure (which `run()` already wraps
+ * in a generic `Error`) lets callers — e.g. dispatch loops in
+ * `team/state/dispatch.ts` — react with a typed `instanceof` check instead of
+ * inspecting error messages, and to mark the affected command failed without
+ * tearing down the surrounding watcher loop.
+ */
+export declare class RuntimeBridgeError extends Error {
+    readonly context: {
+        command?: string;
+        stdoutPreview?: string;
+        cause?: unknown;
+    };
+    constructor(message: string, context?: {
+        command?: string;
+        stdoutPreview?: string;
+        cause?: unknown;
+    });
+}
+export interface RuntimeBinaryDiscoveryOptions {
+    debugPath?: string;
+    releasePath?: string;
+    fallbackBinary?: string;
+    exists?: (path: string) => boolean;
+}
+export declare function resolveRuntimeBinaryPath(options?: RuntimeBinaryDiscoveryOptions): string;
+export declare function resolveBridgeStateDir(cwd: string, env?: NodeJS.ProcessEnv): string;
+export declare class RuntimeBridge {
+    private binaryPath;
+    private stateDir;
+    private enabled;
+    constructor(options?: {
+        stateDir?: string;
+        binaryPath?: string;
+    });
+    /** Whether the bridge is enabled (OMX_RUNTIME_BRIDGE != '0'). */
+    isEnabled(): boolean;
+    /** Execute a RuntimeCommand and return the resulting RuntimeEvent. */
+    execCommand(cmd: RuntimeCommand, options?: {
+        compact?: boolean;
+    }): RuntimeEvent;
+    /** Read the current RuntimeSnapshot. */
+    readSnapshot(): RuntimeSnapshot;
+    /** Initialize a fresh state directory. */
+    initStateDir(dir: string): void;
+    /** Read a Rust-authored compatibility file as typed JSON. */
+    readCompatFile<T>(filename: string): T | null;
+    /** Read authority snapshot from compatibility file. */
+    readAuthority(): AuthoritySnapshot | null;
+    /** Read readiness snapshot from compatibility file. */
+    readReadiness(): ReadinessSnapshot | null;
+    /** Read backlog snapshot from compatibility file. */
+    readBacklog(): BacklogSnapshot | null;
+    /**
+     * Read dispatch records from compatibility file.
+     * Transforms Rust format ({ records: [...] }) to flat array,
+     * and maps `target` → `to_worker` + merges metadata fields.
+     */
+    readDispatchRecords(): DispatchRecord[];
+    /** Read mailbox records from compatibility file. */
+    readMailboxRecords(): MailboxRecord[];
+    private validateSchemaOnce;
+    private run;
+}
+export declare function getDefaultBridge(stateDir?: string): RuntimeBridge;
+export declare function isBridgeEnabled(): boolean;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/runtime/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/runtime/bridge.ts"],"names":[],"mappings":"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"}