oh-my-codex 0.13.2 → 0.14.0

package/dist/question/__tests__/renderer.test.js

@@ -0,0 +1,88 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { formatQuestionAnswerForInjection, injectQuestionAnswerToPane, launchQuestionRenderer, resolveQuestionRendererStrategy, } from '../renderer.js';
+describe('resolveQuestionRendererStrategy', () => {
+    it('prefers inside-tmux when TMUX is present', () => {
+        assert.equal(resolveQuestionRendererStrategy({ TMUX: '/tmp/tmux-demo' }, '/usr/bin/tmux'), 'inside-tmux');
+    });
+    it('falls back to detached-tmux when tmux exists but TMUX is absent', () => {
+        assert.equal(resolveQuestionRendererStrategy({}, '/usr/bin/tmux'), 'detached-tmux');
+    });
+    it('uses noop test renderer override when requested', () => {
+        assert.equal(resolveQuestionRendererStrategy({ OMX_QUESTION_TEST_RENDERER: 'noop' }, '/usr/bin/tmux'), 'test-noop');
+    });
+});
+describe('launchQuestionRenderer', () => {
+    it('opens an interactive foreground split when already inside tmux', () => {
+        const calls = [];
+        const result = launchQuestionRenderer({
+            cwd: '/repo',
+            recordPath: '/repo/.omx/state/sessions/s1/questions/question-1.json',
+            sessionId: 's1',
+            nowIso: '2026-04-19T00:00:00.000Z',
+            env: { TMUX: '/tmp/tmux-demo', TMUX_PANE: '%11' },
+        }, {
+            strategy: 'inside-tmux',
+            execTmux: (args) => {
+                calls.push(args);
+                return '%42\n';
+            },
+        });
+        assert.equal(result.renderer, 'tmux-pane');
+        assert.equal(result.target, '%42');
+        assert.equal(result.return_target, '%11');
+        assert.equal(result.return_transport, 'tmux-send-keys');
+        assert.equal(calls.length, 1);
+        assert.equal(calls[0]?.[0], 'split-window');
+        assert.ok(!calls[0]?.includes('-d'));
+    });
+    it('uses detached sessions outside tmux', () => {
+        const calls = [];
+        const result = launchQuestionRenderer({
+            cwd: '/repo',
+            recordPath: '/repo/.omx/state/sessions/s1/questions/question-2.json',
+            nowIso: '2026-04-19T00:00:00.000Z',
+        }, {
+            strategy: 'detached-tmux',
+            execTmux: (args) => {
+                calls.push(args);
+                return 'omx-question-question-2\n';
+            },
+        });
+        assert.equal(result.renderer, 'tmux-session');
+        assert.equal(calls.length, 1);
+        assert.equal(calls[0]?.[0], 'new-session');
+        assert.ok(calls[0]?.includes('-d'));
+    });
+});
+describe('question answer injection', () => {
+    it('formats other answers into a single-line continuation-safe prompt', () => {
+        assert.equal(formatQuestionAnswerForInjection({
+            kind: 'other',
+            value: 'hello\nworld',
+            selected_labels: ['Other'],
+            selected_values: ['hello\nworld'],
+            other_text: 'hello\nworld',
+        }), '[omx question answered] hello world');
+    });
+    it('injects the answered text back into the requester pane and submits separately', () => {
+        const calls = [];
+        const ok = injectQuestionAnswerToPane('%11', {
+            kind: 'option',
+            value: 'proceed',
+            selected_labels: ['Proceed'],
+            selected_values: ['proceed'],
+        }, (args) => {
+            calls.push(args);
+            return '';
+        });
+        assert.equal(ok, true);
+        assert.deepEqual(calls, [
+            ['send-keys', '-t', '%11', '-l', '--', '[omx question answered] proceed'],
+            ['send-keys', '-t', '%11', 'Enter'],
+            ['send-keys', '-t', '%11', 'Enter'],
+            ['send-keys', '-t', '%11', 'Enter'],
+        ]);
+    });
+});
+//# sourceMappingURL=renderer.test.js.map

package/dist/question/__tests__/renderer.test.js.map

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

package/dist/question/__tests__/state.test.d.ts

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

package/dist/question/__tests__/state.test.d.ts.map

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

package/dist/question/__tests__/state.test.js

@@ -0,0 +1,55 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, it } from 'node:test';
+import { createQuestionRecord, getQuestionRecordPath, markQuestionAnswered, readQuestionRecord, waitForQuestionTerminalState, } from '../state.js';
+const tempDirs = [];
+async function makeRepo() {
+    const cwd = await mkdtemp(join(tmpdir(), 'omx-question-state-'));
+    tempDirs.push(cwd);
+    return cwd;
+}
+afterEach(async () => {
+    await Promise.all(tempDirs.splice(0).map((dir) => rm(dir, { recursive: true, force: true })));
+});
+describe('question state', () => {
+    it('creates records under session-scoped question state and reads them back', async () => {
+        const cwd = await makeRepo();
+        const { record, recordPath } = await createQuestionRecord(cwd, {
+            question: 'Pick one',
+            options: [{ label: 'A', value: 'a' }],
+            allow_other: true,
+            other_label: 'Other',
+            multi_select: false,
+        }, 'sess-1');
+        assert.equal(recordPath, getQuestionRecordPath(cwd, record.question_id, 'sess-1'));
+        const loaded = await readQuestionRecord(recordPath);
+        assert.equal(loaded?.question, 'Pick one');
+        assert.equal(loaded?.type, 'single-answerable');
+    });
+    it('waits for terminal answered state and returns free-text other values exactly', async () => {
+        const cwd = await makeRepo();
+        const { recordPath } = await createQuestionRecord(cwd, {
+            question: 'Pick one',
+            options: [{ label: 'A', value: 'a' }],
+            allow_other: true,
+            other_label: 'Other',
+            multi_select: false,
+        }, 'sess-2');
+        const waiter = waitForQuestionTerminalState(recordPath, { pollIntervalMs: 10, timeoutMs: 2000 });
+        setTimeout(() => {
+            void markQuestionAnswered(recordPath, {
+                kind: 'other',
+                value: 'custom text',
+                selected_labels: ['Other'],
+                selected_values: ['custom text'],
+                other_text: 'custom text',
+            });
+        }, 50);
+        const finalRecord = await waiter;
+        assert.equal(finalRecord.answer?.value, 'custom text');
+        assert.equal(finalRecord.status, 'answered');
+    });
+});
+//# sourceMappingURL=state.test.js.map

package/dist/question/__tests__/state.test.js.map

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

package/dist/question/__tests__/types.test.d.ts

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

package/dist/question/__tests__/types.test.d.ts.map

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

package/dist/question/__tests__/types.test.js

@@ -0,0 +1,44 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { normalizeQuestionInput } from '../types.js';
+describe('normalizeQuestionInput', () => {
+    it('allows free-text-only prompts when allow_other is true', () => {
+        const result = normalizeQuestionInput({
+            question: 'Describe the desired evaluator command',
+            options: [],
+            allow_other: true,
+            source: 'deep-interview',
+        });
+        assert.equal(result.question, 'Describe the desired evaluator command');
+        assert.deepEqual(result.options, []);
+        assert.equal(result.allow_other, true);
+        assert.equal(result.type, 'single-answerable');
+    });
+    it('normalizes explicit multi-answerable type', () => {
+        const result = normalizeQuestionInput({
+            question: 'Pick one or more',
+            options: ['A', 'B'],
+            allow_other: false,
+            type: 'multi-answerable',
+        });
+        assert.equal(result.type, 'multi-answerable');
+        assert.equal(result.multi_select, true);
+    });
+    it('keeps legacy multi_select compatibility', () => {
+        const result = normalizeQuestionInput({
+            question: 'Pick one or more',
+            options: ['A', 'B'],
+            allow_other: false,
+            multi_select: true,
+        });
+        assert.equal(result.type, 'multi-answerable');
+        assert.equal(result.multi_select, true);
+    });
+    it('rejects conflicting explicit single-answerable type', () => {
+        assert.throws(() => normalizeQuestionInput({ question: 'Pick one', options: ['A'], allow_other: false, type: 'single-answerable', multi_select: true }), /type=single-answerable conflicts with multi_select=true/);
+    });
+    it('rejects empty options when allow_other is false', () => {
+        assert.throws(() => normalizeQuestionInput({ question: 'Pick one', options: [], allow_other: false }), /options must be a non-empty array unless allow_other is true/);
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/dist/question/__tests__/types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.js","sourceRoot":"","sources":["../../../src/question/__tests__/types.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,MAAM,GAAG,sBAAsB,CAAC;YACpC,QAAQ,EAAE,wCAAwC;YAClD,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,gBAAgB;SACzB,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,wCAAwC,CAAC,CAAC;QACxE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG,sBAAsB,CAAC;YACpC,QAAQ,EAAE,kBAAkB;YAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACnB,WAAW,EAAE,KAAK;YAClB,IAAI,EAAE,kBAAkB;SACzB,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,sBAAsB,CAAC;YACpC,QAAQ,EAAE,kBAAkB;YAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACnB,WAAW,EAAE,KAAK;YAClB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,sBAAsB,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,EACzI,yDAAyD,CAC1D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,sBAAsB,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EACvF,8DAA8D,CAC/D,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/question/__tests__/ui.test.d.ts

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

package/dist/question/__tests__/ui.test.d.ts.map

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

package/dist/question/__tests__/ui.test.js

@@ -0,0 +1,169 @@
+import assert from 'node:assert/strict';
+import { EventEmitter } from 'node:events';
+import { describe, it } from 'node:test';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createQuestionRecord, markQuestionPrompting, readQuestionRecord } from '../state.js';
+import { formatQuestionAnswerForInjection } from '../renderer.js';
+import { applyInteractiveSelectionKey, createInitialInteractiveSelectionState, promptForSelectionsWithArrows, renderInteractiveQuestionFrame, runQuestionUi, } from '../ui.js';
+class FakeTtyInput extends EventEmitter {
+    isTTY = true;
+    rawMode = false;
+    setRawMode(mode) {
+        this.rawMode = mode;
+    }
+    resume() { }
+    pause() { }
+}
+class FakeTtyOutput {
+    isTTY = true;
+    chunks = [];
+    write(chunk) {
+        this.chunks.push(chunk);
+        return true;
+    }
+    toString() {
+        return this.chunks.join('');
+    }
+}
+function makeRecord(overrides = {}) {
+    return {
+        kind: 'omx.question/v1',
+        question_id: 'question-1',
+        created_at: '2026-04-19T00:00:00.000Z',
+        updated_at: '2026-04-19T00:00:00.000Z',
+        status: 'prompting',
+        question: 'Pick one',
+        options: [
+            { label: 'Alpha', value: 'alpha' },
+            { label: 'Beta', value: 'beta' },
+        ],
+        allow_other: true,
+        other_label: 'Other',
+        multi_select: false,
+        type: 'single-answerable',
+        ...overrides,
+    };
+}
+describe('question ui injection metadata', () => {
+    it('persists return-target metadata for answered questions', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-question-ui-'));
+        try {
+            const { recordPath } = await createQuestionRecord(cwd, {
+                question: 'Pick one',
+                options: [{ label: 'A', value: 'a' }],
+                allow_other: true,
+                other_label: 'Other',
+                multi_select: false,
+                type: 'single-answerable',
+            }, 'sess-ui');
+            await markQuestionPrompting(recordPath, {
+                renderer: 'tmux-pane',
+                target: '%42',
+                launched_at: '2026-04-19T00:00:00.000Z',
+                return_target: '%11',
+                return_transport: 'tmux-send-keys',
+            });
+            const loaded = await readQuestionRecord(recordPath);
+            assert.equal(loaded?.renderer?.return_target, '%11');
+            assert.equal(loaded?.renderer?.return_transport, 'tmux-send-keys');
+            assert.equal(formatQuestionAnswerForInjection({
+                kind: 'other',
+                value: 'hello can you hear me',
+                selected_labels: ['Other'],
+                selected_values: ['hello can you hear me'],
+                other_text: 'hello can you hear me',
+            }), '[omx question answered] hello can you hear me');
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+});
+describe('question ui arrow navigation', () => {
+    it('moves single-select cursor with up/down arrows and submits current selection on Enter', () => {
+        const record = makeRecord();
+        let state = createInitialInteractiveSelectionState();
+        state = applyInteractiveSelectionKey(record, state, { name: 'down' }).state;
+        assert.equal(state.cursorIndex, 1);
+        state = applyInteractiveSelectionKey(record, state, { name: 'down' }).state;
+        assert.equal(state.cursorIndex, 2);
+        state = applyInteractiveSelectionKey(record, state, { name: 'up' }).state;
+        assert.equal(state.cursorIndex, 1);
+        const submit = applyInteractiveSelectionKey(record, state, { name: 'enter' });
+        assert.equal(submit.submit, true);
+        assert.equal(submit.state.cursorIndex, 1);
+    });
+    it('toggles multi-select choices with Space and requires a choice before Enter', () => {
+        const record = makeRecord({ multi_select: true, type: 'multi-answerable', allow_other: false });
+        let state = createInitialInteractiveSelectionState();
+        let update = applyInteractiveSelectionKey(record, state, { name: 'enter' });
+        assert.equal(update.submit, false);
+        assert.match(update.state.error ?? '', /Select one or more options/);
+        state = update.state;
+        state = applyInteractiveSelectionKey(record, state, { name: 'space' }).state;
+        assert.deepEqual(state.selectedIndices, [0]);
+        state = applyInteractiveSelectionKey(record, state, { name: 'down' }).state;
+        state = applyInteractiveSelectionKey(record, state, { name: 'space' }).state;
+        assert.deepEqual(state.selectedIndices, [0, 1]);
+        update = applyInteractiveSelectionKey(record, state, { name: 'enter' });
+        assert.equal(update.submit, true);
+        assert.deepEqual(update.state.selectedIndices, [0, 1]);
+    });
+    it('renders navigation instructions with checkbox markers', () => {
+        const frame = renderInteractiveQuestionFrame(makeRecord({ multi_select: true, type: 'multi-answerable' }), {
+            cursorIndex: 1,
+            selectedIndices: [0],
+        });
+        assert.match(frame, /Use ↑\/↓ to move, Space to toggle, Enter to submit\./);
+        assert.match(frame, /\[x\] 1\. Alpha/);
+        assert.match(frame, /› \[ \] 2\. Beta/);
+    });
+    it('collects arrow-based selection in interactive mode', async () => {
+        const input = new FakeTtyInput();
+        const output = new FakeTtyOutput();
+        const promise = promptForSelectionsWithArrows(makeRecord(), { input, output });
+        queueMicrotask(() => {
+            input.emit('keypress', '', { name: 'down' });
+            input.emit('keypress', '', { name: 'enter' });
+        });
+        const selections = await promise;
+        assert.deepEqual(selections, [2]);
+        assert.equal(input.rawMode, false);
+        assert.match(output.toString(), /Use ↑\/↓ to move, Enter to select\./);
+    });
+    it('writes answered state from arrow-key interaction', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-question-ui-run-'));
+        try {
+            const { recordPath } = await createQuestionRecord(cwd, {
+                question: 'Pick one',
+                options: [
+                    { label: 'A', value: 'a' },
+                    { label: 'B', value: 'b' },
+                ],
+                allow_other: false,
+                other_label: 'Other',
+                multi_select: false,
+                type: 'single-answerable',
+            }, 'sess-ui-run');
+            const input = new FakeTtyInput();
+            const output = new FakeTtyOutput();
+            const runPromise = runQuestionUi(recordPath, { input, output });
+            setTimeout(() => {
+                input.emit('keypress', '', { name: 'down' });
+                input.emit('keypress', '', { name: 'enter' });
+            }, 25);
+            await runPromise;
+            const loaded = await readQuestionRecord(recordPath);
+            assert.equal(loaded?.status, 'answered');
+            assert.equal(loaded?.answer?.kind, 'option');
+            assert.equal(loaded?.answer?.value, 'b');
+            assert.equal(loaded?.type, 'single-answerable');
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=ui.test.js.map

package/dist/question/__tests__/ui.test.js.map

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

package/dist/question/client.d.ts

@@ -0,0 +1,54 @@
+import type { QuestionAnswer, QuestionInput } from './types.js';
+export interface OmxQuestionSuccessPayload {
+    ok: true;
+    question_id: string;
+    session_id?: string;
+    prompt: QuestionInput;
+    answer: QuestionAnswer;
+}
+export interface OmxQuestionErrorPayload {
+    ok: false;
+    question_id?: string;
+    session_id?: string;
+    error: {
+        code: string;
+        message: string;
+    };
+}
+export type OmxQuestionPayload = OmxQuestionSuccessPayload | OmxQuestionErrorPayload;
+export interface OmxQuestionClientOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    argv1?: string | null;
+    runner?: OmxQuestionProcessRunner;
+}
+export interface OmxQuestionProcessResult {
+    code: number | null;
+    stdout: string;
+    stderr: string;
+}
+export type OmxQuestionProcessRunner = (command: string, args: string[], options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}) => Promise<OmxQuestionProcessResult>;
+export declare class OmxQuestionError extends Error {
+    readonly code: string;
+    readonly payload?: OmxQuestionErrorPayload;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly exitCode: number | null;
+    constructor(code: string, message: string, options?: {
+        payload?: OmxQuestionErrorPayload;
+        stdout?: string;
+        stderr?: string;
+        exitCode?: number | null;
+    });
+}
+export declare function defaultOmxQuestionProcessRunner(command: string, args: string[], options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}): Promise<OmxQuestionProcessResult>;
+export declare function runOmxQuestion(input: Partial<QuestionInput> & {
+    question: string;
+}, options?: OmxQuestionClientOptions): Promise<OmxQuestionSuccessPayload>;
+//# sourceMappingURL=client.d.ts.map

package/dist/question/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/question/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,IAAI,CAAC;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,KAAK,CAAC;IACV,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,GAAG,uBAAuB,CAAC;AAErF,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAC7C,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAEvC,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;gBAG/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,OAAO,CAAC,EAAE,uBAAuB,CAAC;QAClC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB;CAUT;AAED,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GAC/C,OAAO,CAAC,wBAAwB,CAAC,CAmBnC;AAuBD,wBAAsB,cAAc,CAClC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EACpD,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,yBAAyB,CAAC,CAkCpC"}

package/dist/question/client.js

@@ -0,0 +1,77 @@
+import { spawn } from 'node:child_process';
+import { resolveOmxCliEntryPath } from '../utils/paths.js';
+export class OmxQuestionError extends Error {
+    code;
+    payload;
+    stdout;
+    stderr;
+    exitCode;
+    constructor(code, message, options = {}) {
+        super(`${code}: ${message}`);
+        this.name = 'OmxQuestionError';
+        this.code = code;
+        this.payload = options.payload;
+        this.stdout = options.stdout ?? '';
+        this.stderr = options.stderr ?? '';
+        this.exitCode = options.exitCode ?? null;
+    }
+}
+export async function defaultOmxQuestionProcessRunner(command, args, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            env: options.env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (chunk) => {
+            stdout += String(chunk);
+        });
+        child.stderr.on('data', (chunk) => {
+            stderr += String(chunk);
+        });
+        child.on('error', reject);
+        child.on('close', (code) => resolve({ code, stdout, stderr }));
+    });
+}
+function parseQuestionStdout(stdout, stderr, exitCode) {
+    const trimmed = stdout.trim();
+    if (!trimmed) {
+        throw new OmxQuestionError('question_no_stdout', 'omx question did not emit a JSON response on stdout.', {
+            stdout,
+            stderr,
+            exitCode,
+        });
+    }
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch (error) {
+        throw new OmxQuestionError('question_invalid_stdout', `omx question emitted invalid JSON on stdout: ${error.message}`, { stdout, stderr, exitCode });
+    }
+}
+export async function runOmxQuestion(input, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const env = options.env ?? process.env;
+    const omxBin = resolveOmxCliEntryPath({ argv1: options.argv1, cwd, env });
+    if (!omxBin) {
+        throw new OmxQuestionError('question_cli_not_found', 'Could not resolve the omx CLI entrypoint for blocking question execution.');
+    }
+    const runner = options.runner ?? defaultOmxQuestionProcessRunner;
+    const result = await runner(process.execPath, [omxBin, 'question', '--json', '--input', JSON.stringify(input)], { cwd, env });
+    const payload = parseQuestionStdout(result.stdout, result.stderr, result.code);
+    if (!payload.ok) {
+        throw new OmxQuestionError(payload.error.code, payload.error.message, {
+            payload,
+            stdout: result.stdout,
+            stderr: result.stderr,
+            exitCode: result.code,
+        });
+    }
+    if (result.code !== 0) {
+        throw new OmxQuestionError('question_nonzero_exit', `omx question returned an answer but exited with code ${result.code}.`, { stdout: result.stdout, stderr: result.stderr, exitCode: result.code });
+    }
+    return payload;
+}
+//# sourceMappingURL=client.js.map

package/dist/question/client.js.map

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

package/dist/question/deep-interview.d.ts

@@ -0,0 +1,27 @@
+import { type OmxQuestionClientOptions, type OmxQuestionSuccessPayload } from './client.js';
+import type { QuestionInput } from './types.js';
+export interface DeepInterviewQuestionEnforcementState {
+    obligation_id: string;
+    source: 'omx-question';
+    status: 'pending' | 'satisfied' | 'cleared';
+    requested_at: string;
+    question_id?: string;
+    satisfied_at?: string;
+    cleared_at?: string;
+    clear_reason?: 'handoff' | 'abort' | 'error';
+}
+interface DeepInterviewStateRecord {
+    updated_at?: string;
+    question_enforcement?: DeepInterviewQuestionEnforcementState;
+    [key: string]: unknown;
+}
+export declare function createDeepInterviewQuestionObligation(now?: Date): DeepInterviewQuestionEnforcementState;
+export declare function isPendingDeepInterviewQuestionEnforcement(enforcement: Partial<DeepInterviewQuestionEnforcementState> | null | undefined): enforcement is DeepInterviewQuestionEnforcementState;
+export declare function satisfyDeepInterviewQuestionObligation(enforcement: DeepInterviewQuestionEnforcementState, questionId: string, now?: Date): DeepInterviewQuestionEnforcementState;
+export declare function clearDeepInterviewQuestionObligation(enforcement: DeepInterviewQuestionEnforcementState | undefined, reason: 'handoff' | 'abort' | 'error', now?: Date): DeepInterviewQuestionEnforcementState | undefined;
+export declare function updateDeepInterviewQuestionEnforcement(cwd: string, sessionId: string | undefined, updater: (current: DeepInterviewQuestionEnforcementState | undefined) => DeepInterviewQuestionEnforcementState | undefined): Promise<DeepInterviewStateRecord | null>;
+export declare function runDeepInterviewQuestion(input: Partial<QuestionInput> & {
+    question: string;
+}, options?: OmxQuestionClientOptions): Promise<OmxQuestionSuccessPayload>;
+export {};
+//# sourceMappingURL=deep-interview.d.ts.map

package/dist/question/deep-interview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-interview.d.ts","sourceRoot":"","sources":["../../src/question/deep-interview.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,MAAM,WAAW,qCAAqC;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;CAC9C;AAED,UAAU,wBAAwB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,qCAAqC,CAAC;IAC7D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAgCD,wBAAgB,qCAAqC,CACnD,GAAG,OAAa,GACf,qCAAqC,CAOvC;AAED,wBAAgB,yCAAyC,CACvD,WAAW,EAAE,OAAO,CAAC,qCAAqC,CAAC,GAAG,IAAI,GAAG,SAAS,GAC7E,WAAW,IAAI,qCAAqC,CAGtD;AAED,wBAAgB,sCAAsC,CACpD,WAAW,EAAE,qCAAqC,EAClD,UAAU,EAAE,MAAM,EAClB,GAAG,OAAa,GACf,qCAAqC,CASvC;AAED,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,qCAAqC,GAAG,SAAS,EAC9D,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,EACrC,GAAG,OAAa,GACf,qCAAqC,GAAG,SAAS,CASnD;AAED,wBAAsB,sCAAsC,CAC1D,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,CACP,OAAO,EAAE,qCAAqC,GAAG,SAAS,KACvD,qCAAqC,GAAG,SAAS,GACrD,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAiB1C;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EACpD,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,yBAAyB,CAAC,CA4CpC"}