oh-my-codex 0.13.2 → 0.14.1

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/run-loop.d.ts

@@ -0,0 +1,45 @@
+import { type RunOutcome, type TerminalLifecycleOutcome, type TerminalRunOutcome } from './run-outcome.js';
+export interface RunLoopIteration<TState> {
+    outcome: unknown;
+    state: TState;
+}
+export interface NormalizedRunLoopIteration<TState> {
+    iteration: number;
+    outcome: RunOutcome;
+    terminal: boolean;
+    state: TState;
+}
+export interface RunLoopTerminalResult<TState> {
+    iteration: number;
+    outcome: TerminalRunOutcome;
+    state: TState;
+    history: RunOutcome[];
+}
+export interface RunUntilTerminalOptions<TState> {
+    maxIterations?: number;
+    onIteration?: (result: NormalizedRunLoopIteration<TState>) => Promise<void> | void;
+}
+export interface RunContinuationStateLike {
+    current_phase?: unknown;
+    run_outcome?: unknown;
+    lifecycle_outcome?: unknown;
+    terminal_outcome?: unknown;
+    question_enforcement?: unknown;
+    active?: unknown;
+    completed_at?: unknown;
+    [key: string]: unknown;
+}
+export interface RunContinuationSnapshot {
+    outcome: RunOutcome;
+    lifecycleOutcome?: TerminalLifecycleOutcome;
+    terminal: boolean;
+    phase: string;
+}
+export declare function runUntilTerminal<TState>(step: (iteration: number) => Promise<RunLoopIteration<TState>>, options?: RunUntilTerminalOptions<TState>): Promise<RunLoopTerminalResult<TState>>;
+export declare function getRunContinuationSnapshot(candidate: RunContinuationStateLike | null | undefined, options?: {
+    phaseFallback?: string;
+}): RunContinuationSnapshot | null;
+export declare function shouldContinueRun(candidate: RunContinuationStateLike | null | undefined, options?: {
+    phaseFallback?: string;
+}): boolean;
+//# sourceMappingURL=run-loop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-loop.d.ts","sourceRoot":"","sources":["../../src/runtime/run-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,gBAAgB,CAAC,MAAM;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B,CAAC,MAAM;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB,CAAC,MAAM;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB,CAAC,MAAM;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,0BAA0B,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpF;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,UAAU,CAAC;IACpB,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,wBAAsB,gBAAgB,CAAC,MAAM,EAC3C,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,EAC9D,OAAO,GAAE,uBAAuB,CAAC,MAAM,CAAM,GAC5C,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CA8BxC;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,EACtD,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,uBAAuB,GAAG,IAAI,CAchC;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,EACtD,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,OAAO,CAGT"}

package/dist/runtime/run-loop.js

@@ -0,0 +1,51 @@
+import { classifyRunOutcome, inferRunOutcome, inferTerminalLifecycleOutcome, isTerminalRunOutcome, } from './run-outcome.js';
+function safeString(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+export async function runUntilTerminal(step, options = {}) {
+    const history = [];
+    const maxIterations = options.maxIterations ?? Number.POSITIVE_INFINITY;
+    for (let iteration = 1; iteration <= maxIterations; iteration += 1) {
+        const raw = await step(iteration);
+        const outcome = classifyRunOutcome(raw.outcome);
+        const terminal = isTerminalRunOutcome(outcome);
+        history.push(outcome);
+        const normalized = {
+            iteration,
+            outcome,
+            terminal,
+            state: raw.state,
+        };
+        await options.onIteration?.(normalized);
+        if (terminal) {
+            return {
+                iteration,
+                outcome,
+                state: raw.state,
+                history,
+            };
+        }
+    }
+    throw new Error(`run loop exceeded maxIterations=${maxIterations} without reaching a terminal outcome`);
+}
+export function getRunContinuationSnapshot(candidate, options = {}) {
+    if (!candidate || typeof candidate !== 'object')
+        return null;
+    const record = candidate;
+    const outcome = inferRunOutcome(record);
+    const lifecycleOutcome = inferTerminalLifecycleOutcome(record, {
+        includeQuestionEnforcement: true,
+    });
+    const phase = safeString(candidate.current_phase) || options.phaseFallback || 'active';
+    return {
+        outcome,
+        lifecycleOutcome,
+        terminal: lifecycleOutcome !== undefined || isTerminalRunOutcome(outcome),
+        phase,
+    };
+}
+export function shouldContinueRun(candidate, options = {}) {
+    const snapshot = getRunContinuationSnapshot(candidate, options);
+    return snapshot !== null && !snapshot.terminal;
+}
+//# sourceMappingURL=run-loop.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-loop.js","sourceRoot":"","sources":["../../src/runtime/run-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,6BAA6B,EAC7B,oBAAoB,GAIrB,MAAM,kBAAkB,CAAC;AA4C1B,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAA8D,EAC9D,UAA2C,EAAE;IAE7C,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,MAAM,CAAC,iBAAiB,CAAC;IAExE,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,IAAI,aAAa,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC;QACnE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEtB,MAAM,UAAU,GAAuC;YACrD,SAAS;YACT,OAAO;YACP,QAAQ;YACR,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB,CAAC;QAEF,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC;QAExC,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;gBACL,SAAS;gBACT,OAAO;gBACP,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,OAAO;aACR,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,mCAAmC,aAAa,sCAAsC,CAAC,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,SAAsD,EACtD,UAAsC,EAAE;IAExC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,MAAM,GAAG,SAAoC,CAAC;IACpD,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,gBAAgB,GAAG,6BAA6B,CAAC,MAAM,EAAE;QAC7D,0BAA0B,EAAE,IAAI;KACjC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,aAAa,IAAI,QAAQ,CAAC;IACvF,OAAO;QACL,OAAO;QACP,gBAAgB;QAChB,QAAQ,EAAE,gBAAgB,KAAK,SAAS,IAAI,oBAAoB,CAAC,OAAO,CAAC;QACzE,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,SAAsD,EACtD,UAAsC,EAAE;IAExC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAChE,OAAO,QAAQ,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,46 @@
+export declare const TERMINAL_RUN_OUTCOMES: readonly ["finish", "blocked_on_user", "failed", "cancelled"];
+export declare const NON_TERMINAL_RUN_OUTCOMES: readonly ["progress", "continue"];
+export declare const RUN_OUTCOMES: readonly ["progress", "continue", "finish", "blocked_on_user", "failed", "cancelled"];
+export declare const TERMINAL_LIFECYCLE_OUTCOMES: readonly ["finished", "blocked", "failed", "userinterlude", "askuserQuestion"];
+export type TerminalRunOutcome = (typeof TERMINAL_RUN_OUTCOMES)[number];
+export type NonTerminalRunOutcome = (typeof NON_TERMINAL_RUN_OUTCOMES)[number];
+export type RunOutcome = (typeof RUN_OUTCOMES)[number];
+export type TerminalLifecycleOutcome = (typeof TERMINAL_LIFECYCLE_OUTCOMES)[number];
+export interface RunOutcomeNormalizationResult {
+    outcome?: RunOutcome;
+    warning?: string;
+    error?: string;
+}
+export interface TerminalLifecycleOutcomeNormalizationOptions {
+    blockedOnUserStrategy?: 'blocked' | 'askuserQuestion' | 'userinterlude';
+}
+export interface TerminalLifecycleOutcomeNormalizationResult {
+    outcome?: TerminalLifecycleOutcome;
+    warning?: string;
+    error?: string;
+}
+export interface RunOutcomeValidationResult {
+    ok: boolean;
+    state?: Record<string, unknown>;
+    warning?: string;
+    error?: string;
+}
+export declare function compatibilityRunOutcomeFromTerminalLifecycleOutcome(outcome: TerminalLifecycleOutcome): TerminalRunOutcome;
+export declare function terminalLifecycleOutcomeFromRunOutcome(outcome: TerminalRunOutcome, options?: TerminalLifecycleOutcomeNormalizationOptions): TerminalLifecycleOutcome;
+export declare function normalizeRunOutcome(value: unknown): RunOutcomeNormalizationResult;
+export declare function normalizeTerminalLifecycleOutcome(value: unknown, options?: TerminalLifecycleOutcomeNormalizationOptions): TerminalLifecycleOutcomeNormalizationResult;
+export declare function classifyRunOutcome(value: unknown): RunOutcome;
+export declare function isTerminalRunOutcome(value: unknown): value is TerminalRunOutcome;
+export declare function isTerminalLifecycleOutcome(value: unknown, options?: TerminalLifecycleOutcomeNormalizationOptions): value is TerminalLifecycleOutcome;
+export declare function isNonTerminalRunOutcome(value: unknown): value is NonTerminalRunOutcome;
+export declare function isNonTerminalRunState(value: unknown): boolean;
+export declare function isTerminalRunState(value: unknown): boolean;
+export declare function inferTerminalLifecycleOutcome(candidate: Record<string, unknown>, options?: {
+    includeQuestionEnforcement?: boolean;
+    blockedOnUserStrategy?: 'blocked' | 'askuserQuestion' | 'userinterlude';
+}): TerminalLifecycleOutcome | undefined;
+export declare function inferRunOutcome(candidate: Record<string, unknown>): RunOutcome;
+export declare function applyRunOutcomeContract(candidate: Record<string, unknown>, options?: {
+    nowIso?: string;
+}): RunOutcomeValidationResult;
+//# sourceMappingURL=run-outcome.d.ts.map

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

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

package/dist/runtime/run-outcome.js

@@ -0,0 +1,285 @@
+export const TERMINAL_RUN_OUTCOMES = [
+    'finish',
+    'blocked_on_user',
+    'failed',
+    'cancelled',
+];
+export const NON_TERMINAL_RUN_OUTCOMES = [
+    'progress',
+    'continue',
+];
+export const RUN_OUTCOMES = [
+    ...NON_TERMINAL_RUN_OUTCOMES,
+    ...TERMINAL_RUN_OUTCOMES,
+];
+export const TERMINAL_LIFECYCLE_OUTCOMES = [
+    'finished',
+    'blocked',
+    'failed',
+    'userinterlude',
+    'askuserQuestion',
+];
+const TERMINAL_RUN_OUTCOME_SET = new Set(TERMINAL_RUN_OUTCOMES);
+const NON_TERMINAL_RUN_OUTCOME_SET = new Set(NON_TERMINAL_RUN_OUTCOMES);
+const RUN_OUTCOME_SET = new Set(RUN_OUTCOMES);
+const TERMINAL_LIFECYCLE_OUTCOME_SET = new Set(TERMINAL_LIFECYCLE_OUTCOMES);
+const RUN_OUTCOME_ALIASES = {
+    finish: 'finish',
+    finished: 'finish',
+    complete: 'finish',
+    completed: 'finish',
+    done: 'finish',
+    blocked: 'blocked_on_user',
+    'blocked-on-user': 'blocked_on_user',
+    blocked_on_user: 'blocked_on_user',
+    failed: 'failed',
+    fail: 'failed',
+    error: 'failed',
+    cancelled: 'cancelled',
+    canceled: 'cancelled',
+    cancel: 'cancelled',
+    aborted: 'cancelled',
+    abort: 'cancelled',
+    progress: 'progress',
+    continue: 'continue',
+    continued: 'continue',
+};
+const TERMINAL_LIFECYCLE_OUTCOME_ALIASES = {
+    finished: 'finished',
+    finish: 'finished',
+    complete: 'finished',
+    completed: 'finished',
+    done: 'finished',
+    blocked: 'blocked',
+    failed: 'failed',
+    fail: 'failed',
+    error: 'failed',
+    userinterlude: 'userinterlude',
+    'user-interlude': 'userinterlude',
+    interrupted: 'userinterlude',
+    interrupt: 'userinterlude',
+    cancelled: 'userinterlude',
+    canceled: 'userinterlude',
+    cancel: 'userinterlude',
+    aborted: 'userinterlude',
+    abort: 'userinterlude',
+    askuserquestion: 'askuserQuestion',
+    'ask-user-question': 'askuserQuestion',
+    askuser: 'askuserQuestion',
+    question: 'askuserQuestion',
+};
+const TERMINAL_PHASE_TO_RUN_OUTCOME = {
+    complete: 'finish',
+    completed: 'finish',
+    blocked: 'blocked_on_user',
+    blocked_on_user: 'blocked_on_user',
+    'blocked-on-user': 'blocked_on_user',
+    failed: 'failed',
+    cancelled: 'cancelled',
+    cancel: 'cancelled',
+};
+const RUN_OUTCOME_FROM_LIFECYCLE = {
+    finished: 'finish',
+    blocked: 'blocked_on_user',
+    failed: 'failed',
+    userinterlude: 'cancelled',
+    askuserQuestion: 'blocked_on_user',
+};
+function normalizeRunOutcomeValue(value) {
+    return typeof value === 'string' ? value.trim().toLowerCase() : '';
+}
+function safeString(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function resolveBlockedOnUserLifecycleOutcome(options = {}) {
+    return options.blockedOnUserStrategy ?? 'blocked';
+}
+function hasPendingQuestionEnforcement(candidate) {
+    const enforcement = candidate.question_enforcement;
+    if (!enforcement || typeof enforcement !== 'object')
+        return false;
+    const record = enforcement;
+    const obligationId = safeString(record.obligation_id);
+    const status = safeString(record.status).toLowerCase();
+    return obligationId !== '' && status === 'pending';
+}
+export function compatibilityRunOutcomeFromTerminalLifecycleOutcome(outcome) {
+    return RUN_OUTCOME_FROM_LIFECYCLE[outcome];
+}
+export function terminalLifecycleOutcomeFromRunOutcome(outcome, options = {}) {
+    switch (outcome) {
+        case 'finish':
+            return 'finished';
+        case 'blocked_on_user':
+            return resolveBlockedOnUserLifecycleOutcome(options);
+        case 'failed':
+            return 'failed';
+        case 'cancelled':
+            return 'userinterlude';
+    }
+}
+export function normalizeRunOutcome(value) {
+    const normalized = normalizeRunOutcomeValue(value);
+    if (!normalized)
+        return {};
+    if (RUN_OUTCOME_SET.has(normalized)) {
+        return { outcome: normalized };
+    }
+    const alias = RUN_OUTCOME_ALIASES[normalized];
+    if (alias) {
+        return {
+            outcome: alias,
+            warning: `normalized legacy run outcome "${value}" -> "${alias}"`,
+        };
+    }
+    return { error: `run_outcome must be one of: ${RUN_OUTCOMES.join(', ')}` };
+}
+export function normalizeTerminalLifecycleOutcome(value, options = {}) {
+    const normalized = normalizeRunOutcomeValue(value);
+    if (!normalized)
+        return {};
+    if (TERMINAL_LIFECYCLE_OUTCOME_SET.has(normalized)) {
+        return { outcome: normalized };
+    }
+    if (normalized === 'blocked_on_user' || normalized === 'blocked-on-user') {
+        const outcome = resolveBlockedOnUserLifecycleOutcome(options);
+        return {
+            outcome,
+            warning: `normalized legacy terminal lifecycle outcome "${value}" -> "${outcome}"`,
+        };
+    }
+    const alias = TERMINAL_LIFECYCLE_OUTCOME_ALIASES[normalized];
+    if (alias) {
+        return {
+            outcome: alias,
+            warning: `normalized legacy terminal lifecycle outcome "${value}" -> "${alias}"`,
+        };
+    }
+    return {
+        error: `lifecycle_outcome must be one of: ${TERMINAL_LIFECYCLE_OUTCOMES.join(', ')}`,
+    };
+}
+export function classifyRunOutcome(value) {
+    return normalizeRunOutcome(value).outcome ?? 'progress';
+}
+export function isTerminalRunOutcome(value) {
+    const normalized = normalizeRunOutcome(value).outcome;
+    return normalized !== undefined && TERMINAL_RUN_OUTCOME_SET.has(normalized);
+}
+export function isTerminalLifecycleOutcome(value, options = {}) {
+    const normalized = normalizeTerminalLifecycleOutcome(value, options).outcome;
+    return normalized !== undefined && TERMINAL_LIFECYCLE_OUTCOME_SET.has(normalized);
+}
+export function isNonTerminalRunOutcome(value) {
+    const normalized = normalizeRunOutcome(value).outcome;
+    return normalized !== undefined && NON_TERMINAL_RUN_OUTCOME_SET.has(normalized);
+}
+export function isNonTerminalRunState(value) {
+    return isNonTerminalRunOutcome(classifyRunOutcome(value));
+}
+export function isTerminalRunState(value) {
+    return isTerminalRunOutcome(classifyRunOutcome(value));
+}
+export function inferTerminalLifecycleOutcome(candidate, options = {}) {
+    const blockedOnUserStrategy = options.blockedOnUserStrategy
+        ?? (options.includeQuestionEnforcement && hasPendingQuestionEnforcement(candidate)
+            ? 'askuserQuestion'
+            : 'blocked');
+    const explicit = normalizeTerminalLifecycleOutcome(candidate.lifecycle_outcome ?? candidate.terminal_outcome, { blockedOnUserStrategy });
+    if (explicit.outcome)
+        return explicit.outcome;
+    const runOutcome = normalizeRunOutcome(candidate.run_outcome).outcome;
+    if (runOutcome && isTerminalRunOutcome(runOutcome)) {
+        return terminalLifecycleOutcomeFromRunOutcome(runOutcome, { blockedOnUserStrategy });
+    }
+    const phase = safeString(candidate.current_phase).toLowerCase();
+    if (phase) {
+        const normalizedPhase = normalizeTerminalLifecycleOutcome(phase, { blockedOnUserStrategy });
+        if (normalizedPhase.outcome)
+            return normalizedPhase.outcome;
+    }
+    if (options.includeQuestionEnforcement && hasPendingQuestionEnforcement(candidate)) {
+        return 'askuserQuestion';
+    }
+    if (candidate.active === true)
+        return undefined;
+    if (safeString(candidate.completed_at))
+        return 'finished';
+    if (candidate.active === false)
+        return 'finished';
+    return undefined;
+}
+export function inferRunOutcome(candidate) {
+    const explicit = normalizeRunOutcome(candidate.run_outcome);
+    if (explicit.outcome)
+        return explicit.outcome;
+    const lifecycleOutcome = inferTerminalLifecycleOutcome(candidate, {
+        includeQuestionEnforcement: false,
+    });
+    if (lifecycleOutcome) {
+        return compatibilityRunOutcomeFromTerminalLifecycleOutcome(lifecycleOutcome);
+    }
+    const phase = safeString(candidate.current_phase).toLowerCase();
+    if (phase && TERMINAL_PHASE_TO_RUN_OUTCOME[phase]) {
+        return TERMINAL_PHASE_TO_RUN_OUTCOME[phase];
+    }
+    if (candidate.active === true)
+        return 'continue';
+    if (safeString(candidate.completed_at))
+        return 'finish';
+    if (candidate.active === false)
+        return 'finish';
+    return 'continue';
+}
+export function applyRunOutcomeContract(candidate, options) {
+    const nowIso = options?.nowIso ?? new Date().toISOString();
+    const next = { ...candidate };
+    const normalizedLifecycle = normalizeTerminalLifecycleOutcome(next.lifecycle_outcome ?? next.terminal_outcome);
+    if (normalizedLifecycle.error)
+        return { ok: false, error: normalizedLifecycle.error };
+    const normalizedRunOutcome = normalizeRunOutcome(next.run_outcome);
+    if (normalizedRunOutcome.error)
+        return { ok: false, error: normalizedRunOutcome.error };
+    const lifecycleOutcome = normalizedLifecycle.outcome ?? inferTerminalLifecycleOutcome(next, {
+        includeQuestionEnforcement: false,
+    });
+    const outcome = normalizedLifecycle.outcome
+        ? compatibilityRunOutcomeFromTerminalLifecycleOutcome(normalizedLifecycle.outcome)
+        : normalizedRunOutcome.outcome ?? inferRunOutcome(next);
+    delete next.terminal_outcome;
+    next.run_outcome = outcome;
+    if (lifecycleOutcome) {
+        next.lifecycle_outcome = lifecycleOutcome;
+    }
+    else {
+        delete next.lifecycle_outcome;
+    }
+    const terminal = lifecycleOutcome !== undefined || isTerminalRunOutcome(outcome);
+    if (terminal) {
+        if (next.active === true) {
+            return {
+                ok: false,
+                error: `terminal run outcome "${lifecycleOutcome ?? outcome}" requires active=false`,
+            };
+        }
+        next.active = false;
+        if (!safeString(next.completed_at)) {
+            next.completed_at = nowIso;
+        }
+    }
+    else {
+        if (next.active === false) {
+            return { ok: false, error: `non-terminal run outcome "${outcome}" requires active=true` };
+        }
+        next.active = true;
+        if (safeString(next.completed_at)) {
+            delete next.completed_at;
+        }
+    }
+    return {
+        ok: true,
+        state: next,
+        warning: normalizedLifecycle.warning ?? normalizedRunOutcome.warning,
+    };
+}
+//# sourceMappingURL=run-outcome.js.map

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

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

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

@@ -0,0 +1,40 @@
+import { type RunOutcome, type TerminalLifecycleOutcome } from './run-outcome.js';
+export interface RunStateLike {
+    active?: unknown;
+    mode?: unknown;
+    current_phase?: unknown;
+    task_description?: unknown;
+    started_at?: unknown;
+    completed_at?: unknown;
+    iteration?: unknown;
+    max_iterations?: unknown;
+    error?: unknown;
+    outcome?: unknown;
+    run_outcome?: unknown;
+    lifecycle_outcome?: unknown;
+    terminal_outcome?: unknown;
+    question_enforcement?: unknown;
+    owner_omx_session_id?: unknown;
+    [key: string]: unknown;
+}
+export interface RunState {
+    version: 1;
+    mode: string;
+    active: boolean;
+    outcome: RunOutcome;
+    lifecycle_outcome?: TerminalLifecycleOutcome;
+    updated_at: string;
+    current_phase?: string;
+    task_description?: string;
+    started_at?: string;
+    completed_at?: string;
+    iteration?: number;
+    max_iterations?: number;
+    error?: string;
+    owner_omx_session_id?: string;
+}
+export declare function deriveRunOutcomeFromModeState(state: RunStateLike): RunOutcome;
+export declare function buildRunState(state: RunStateLike, existing?: Partial<RunState> | null, nowIso?: string): RunState;
+export declare function readRunState(workingDirectory?: string, explicitSessionId?: string): Promise<RunState | null>;
+export declare function syncRunStateFromModeState(state: RunStateLike, workingDirectory?: string, explicitSessionId?: string): Promise<RunState>;
+//# sourceMappingURL=run-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-state.d.ts","sourceRoot":"","sources":["../../src/runtime/run-state.ts"],"names":[],"mappings":"AAIA,OAAO,EAOL,KAAK,UAAU,EACf,KAAK,wBAAwB,EAC9B,MAAM,kBAAkB,CAAC;AAI1B,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;IACpB,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAkBD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,CAkB7E;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,EACnC,MAAM,GAAE,MAAiC,GACxC,QAAQ,CA8CV;AAiBD,wBAAsB,YAAY,CAChC,gBAAgB,CAAC,EAAE,MAAM,EACzB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAU1B;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,YAAY,EACnB,gBAAgB,CAAC,EAAE,MAAM,EACzB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,QAAQ,CAAC,CASnB"}