oh-my-codex 0.13.2 → 0.14.1

package/dist/question/renderer.js

@@ -0,0 +1,190 @@
+import { execFileSync } from 'node:child_process';
+import { basename } from 'node:path';
+import { parsePaneIdFromTmuxOutput } from '../hud/tmux.js';
+import { sleepSync } from '../utils/sleep.js';
+import { sanitizeReplyInput } from '../notifications/reply-listener.js';
+import { getCurrentTmuxPaneId } from '../notifications/tmux.js';
+import { resolveTmuxBinaryForPlatform } from '../utils/platform-command.js';
+import { resolveOmxCliEntryPath } from '../utils/paths.js';
+const QUESTION_TEXT_SETTLE_MS = 120;
+const QUESTION_SUBMIT_REPEAT_DELAY_MS = 100;
+const QUESTION_RENDERER_PANE_SETTLE_MS = 120;
+const QUESTION_RENDERER_SESSION_SETTLE_MS = 120;
+function safeString(value) {
+    return typeof value === 'string' ? value : '';
+}
+function isPaneId(value) {
+    return typeof value === 'string' && /^%\d+$/.test(value.trim());
+}
+export function resolveQuestionRendererStrategy(env = process.env, tmuxBinary = resolveTmuxBinaryForPlatform()) {
+    if (safeString(env.OMX_QUESTION_TEST_RENDERER).trim() === 'noop')
+        return 'test-noop';
+    if (safeString(env.TMUX).trim() !== '')
+        return 'inside-tmux';
+    if (tmuxBinary)
+        return 'detached-tmux';
+    return 'unsupported';
+}
+function buildQuestionUiTmuxArgs(recordPath, options) {
+    const omxBin = resolveOmxCliEntryPath({
+        argv1: process.argv[1],
+        cwd: options.cwd,
+        env: options.env,
+    }) || process.argv[1];
+    if (!omxBin)
+        throw new Error('Unable to resolve OMX CLI entry path for question UI launch.');
+    return [
+        ...(options.sessionId ? ['-e', `OMX_SESSION_ID=${options.sessionId}`] : []),
+        process.execPath,
+        omxBin,
+        'question',
+        '--ui',
+        '--state-path',
+        recordPath,
+    ];
+}
+function defaultExecTmux(args) {
+    const tmux = resolveTmuxBinaryForPlatform();
+    if (!tmux)
+        throw new Error('tmux is unavailable; omx question requires tmux for OMX-owned question UI rendering.');
+    return execFileSync(tmux, args, {
+        encoding: 'utf-8',
+        ...(process.platform === 'win32' ? { windowsHide: true } : {}),
+    });
+}
+function resolveReturnTarget(env = process.env) {
+    const envPane = safeString(env.TMUX_PANE).trim();
+    if (isPaneId(envPane))
+        return envPane;
+    const detectedPane = getCurrentTmuxPaneId();
+    return isPaneId(detectedPane) ? detectedPane : undefined;
+}
+function isLaunchedQuestionPaneAlive(paneId, execTmux) {
+    if (!isPaneId(paneId))
+        return false;
+    try {
+        const status = execTmux(['list-panes', '-t', paneId, '-F', '#{pane_dead}\t#{pane_id}']);
+        return status
+            .split('\n')
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .some((line) => {
+            const [paneDead = '', resolvedPaneId = ''] = line.split('\t');
+            return resolvedPaneId === paneId && paneDead !== '1';
+        });
+    }
+    catch {
+        return false;
+    }
+}
+function isLaunchedQuestionSessionAlive(sessionName, execTmux) {
+    if (!safeString(sessionName).trim())
+        return false;
+    try {
+        execTmux(['has-session', '-t', sessionName]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function formatQuestionAnswerForInjection(answer) {
+    const prefix = '[omx question answered]';
+    if (answer.kind === 'other') {
+        return sanitizeReplyInput(`${prefix} ${answer.other_text ?? String(answer.value)}`);
+    }
+    if (answer.kind === 'multi') {
+        const raw = Array.isArray(answer.value) ? answer.value.join(', ') : String(answer.value);
+        return sanitizeReplyInput(`${prefix} ${raw}`);
+    }
+    return sanitizeReplyInput(`${prefix} ${String(answer.value)}`);
+}
+export function injectQuestionAnswerToPane(paneId, answer, execTmux = defaultExecTmux, sleepImpl = sleepSync) {
+    if (!isPaneId(paneId))
+        return false;
+    const text = formatQuestionAnswerForInjection(answer);
+    if (!text)
+        return false;
+    execTmux(['send-keys', '-t', paneId, '-l', '--', text]);
+    // Match the repo-standard Codex raw-mode submit sequence: let literal text
+    // settle, then send isolated C-m submits rather than Enter key names.
+    sleepImpl(QUESTION_TEXT_SETTLE_MS);
+    execTmux(['send-keys', '-t', paneId, 'C-m']);
+    sleepImpl(QUESTION_SUBMIT_REPEAT_DELAY_MS);
+    execTmux(['send-keys', '-t', paneId, 'C-m']);
+    return true;
+}
+export function launchQuestionRenderer(options, deps = {}) {
+    const strategy = deps.strategy ?? resolveQuestionRendererStrategy(options.env ?? process.env);
+    const execTmux = deps.execTmux ?? defaultExecTmux;
+    const sleepImpl = deps.sleepSync ?? sleepSync;
+    const launchedAt = options.nowIso ?? new Date().toISOString();
+    const commandArgs = buildQuestionUiTmuxArgs(options.recordPath, {
+        cwd: options.cwd,
+        env: options.env,
+        sessionId: options.sessionId,
+    });
+    if (strategy === 'inside-tmux') {
+        const rawPane = execTmux([
+            'split-window',
+            '-v',
+            '-l',
+            '12',
+            '-P',
+            '-F',
+            '#{pane_id}',
+            '-c',
+            options.cwd,
+            ...commandArgs,
+        ]);
+        const paneId = parsePaneIdFromTmuxOutput(rawPane);
+        if (!paneId)
+            throw new Error('Failed to create tmux split pane for omx question UI.');
+        sleepImpl(QUESTION_RENDERER_PANE_SETTLE_MS);
+        if (!isLaunchedQuestionPaneAlive(paneId, execTmux)) {
+            throw new Error(`Question UI pane ${paneId} disappeared immediately after launch.`);
+        }
+        const returnTarget = resolveReturnTarget(options.env ?? process.env);
+        return {
+            renderer: 'tmux-pane',
+            target: paneId,
+            launched_at: launchedAt,
+            ...(returnTarget ? { return_target: returnTarget, return_transport: 'tmux-send-keys' } : {}),
+        };
+    }
+    if (strategy === 'detached-tmux') {
+        const baseName = basename(options.recordPath, '.json').replace(/[^A-Za-z0-9_-]+/g, '-').slice(0, 32) || 'question';
+        const sessionName = `omx-question-${baseName}`;
+        const output = execTmux([
+            'new-session',
+            '-d',
+            '-P',
+            '-F',
+            '#{session_name}',
+            '-s',
+            sessionName,
+            '-c',
+            options.cwd,
+            ...commandArgs,
+        ]).trim();
+        const target = output || sessionName;
+        sleepImpl(QUESTION_RENDERER_SESSION_SETTLE_MS);
+        if (!isLaunchedQuestionSessionAlive(target, execTmux)) {
+            throw new Error(`Question UI session ${target} disappeared immediately after launch.`);
+        }
+        return {
+            renderer: 'tmux-session',
+            target,
+            launched_at: launchedAt,
+        };
+    }
+    if (strategy === 'test-noop') {
+        return {
+            renderer: 'tmux-session',
+            target: 'test-noop-renderer',
+            launched_at: launchedAt,
+        };
+    }
+    throw new Error('omx question requires tmux for OMX-owned question UI rendering in this session.');
+}
+//# sourceMappingURL=renderer.js.map

package/dist/question/renderer.js.map

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

package/dist/question/state.d.ts

@@ -0,0 +1,19 @@
+import type { QuestionAnswer, QuestionInput, QuestionRecord, QuestionRendererState, QuestionStatus } from './types.js';
+export declare function getQuestionStateDir(cwd: string, sessionId?: string): string;
+export declare function getQuestionRecordPath(cwd: string, questionId: string, sessionId?: string): string;
+export declare function writeQuestionRecord(recordPath: string, record: QuestionRecord): Promise<void>;
+export declare function readQuestionRecord(recordPath: string): Promise<QuestionRecord | null>;
+export declare function createQuestionRecord(cwd: string, input: QuestionInput, sessionId?: string, now?: Date): Promise<{
+    recordPath: string;
+    record: QuestionRecord;
+}>;
+export declare function updateQuestionRecord(recordPath: string, updater: (record: QuestionRecord) => QuestionRecord): Promise<QuestionRecord>;
+export declare function markQuestionPrompting(recordPath: string, renderer: QuestionRendererState): Promise<QuestionRecord>;
+export declare function markQuestionAnswered(recordPath: string, answer: QuestionAnswer): Promise<QuestionRecord>;
+export declare function markQuestionTerminalError(recordPath: string, status: Extract<QuestionStatus, 'aborted' | 'error'>, code: string, message: string): Promise<QuestionRecord>;
+export declare function isTerminalQuestionStatus(status: QuestionStatus): boolean;
+export declare function waitForQuestionTerminalState(recordPath: string, options?: {
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+}): Promise<QuestionRecord>;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/question/state.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,cAAc,EACf,MAAM,YAAY,CAAC;AASpB,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjG;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnG;AAED,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAI3F;AAED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,aAAa,EACpB,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,OAAa,GACf,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC,CAsBzD;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,cAAc,GAClD,OAAO,CAAC,cAAc,CAAC,CAMzB;AAED,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,cAAc,CAAC,CAOzB;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,CAAC,CAQzB;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE,SAAS,GAAG,OAAO,CAAC,EACpD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,CAAC,CAWzB;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAExE;AAED,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,cAAc,CAAC,CAczB"}

package/dist/question/state.js

@@ -0,0 +1,108 @@
+import { existsSync } from 'node:fs';
+import { mkdir, readFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { getStateDir } from '../mcp/state-paths.js';
+import { writeAtomic } from '../team/state.js';
+import { sleep } from '../utils/sleep.js';
+import { getNormalizedQuestionType } from './types.js';
+const QUESTION_NAMESPACE = 'questions';
+const DEFAULT_POLL_INTERVAL_MS = 100;
+function buildQuestionId(now = new Date()) {
+    return `question-${now.toISOString().replace(/[:.]/g, '-')}-$${Math.random().toString(16).slice(2, 10)}`.replace('$', '');
+}
+export function getQuestionStateDir(cwd, sessionId) {
+    return join(getStateDir(cwd, sessionId), QUESTION_NAMESPACE);
+}
+export function getQuestionRecordPath(cwd, questionId, sessionId) {
+    return join(getQuestionStateDir(cwd, sessionId), `${questionId}.json`);
+}
+export async function writeQuestionRecord(recordPath, record) {
+    await mkdir(dirname(recordPath), { recursive: true });
+    await writeAtomic(recordPath, `${JSON.stringify(record, null, 2)}\n`);
+}
+export async function readQuestionRecord(recordPath) {
+    if (!existsSync(recordPath))
+        return null;
+    const parsed = JSON.parse(await readFile(recordPath, 'utf-8'));
+    return parsed;
+}
+export async function createQuestionRecord(cwd, input, sessionId, now = new Date()) {
+    const questionId = buildQuestionId(now);
+    const nowIso = now.toISOString();
+    const record = {
+        kind: 'omx.question/v1',
+        question_id: questionId,
+        ...(sessionId ? { session_id: sessionId } : {}),
+        created_at: nowIso,
+        updated_at: nowIso,
+        status: 'pending',
+        ...(input.header ? { header: input.header } : {}),
+        question: input.question,
+        options: input.options,
+        allow_other: input.allow_other,
+        other_label: input.other_label,
+        multi_select: input.multi_select,
+        type: getNormalizedQuestionType(input),
+        ...(input.source ? { source: input.source } : {}),
+    };
+    const recordPath = getQuestionRecordPath(cwd, questionId, sessionId);
+    await writeQuestionRecord(recordPath, record);
+    return { recordPath, record };
+}
+export async function updateQuestionRecord(recordPath, updater) {
+    const current = await readQuestionRecord(recordPath);
+    if (!current)
+        throw new Error(`Question record not found: ${recordPath}`);
+    const updated = updater(current);
+    await writeQuestionRecord(recordPath, updated);
+    return updated;
+}
+export async function markQuestionPrompting(recordPath, renderer) {
+    return updateQuestionRecord(recordPath, (record) => ({
+        ...record,
+        status: 'prompting',
+        updated_at: new Date().toISOString(),
+        renderer,
+    }));
+}
+export async function markQuestionAnswered(recordPath, answer) {
+    return updateQuestionRecord(recordPath, (record) => ({
+        ...record,
+        status: 'answered',
+        updated_at: new Date().toISOString(),
+        answer,
+        error: undefined,
+    }));
+}
+export async function markQuestionTerminalError(recordPath, status, code, message) {
+    return updateQuestionRecord(recordPath, (record) => ({
+        ...record,
+        status,
+        updated_at: new Date().toISOString(),
+        error: {
+            code,
+            message,
+            at: new Date().toISOString(),
+        },
+    }));
+}
+export function isTerminalQuestionStatus(status) {
+    return status === 'answered' || status === 'aborted' || status === 'error';
+}
+export async function waitForQuestionTerminalState(recordPath, options = {}) {
+    const pollIntervalMs = Math.max(10, options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
+    const timeoutMs = options.timeoutMs;
+    const startedAt = Date.now();
+    while (true) {
+        const record = await readQuestionRecord(recordPath);
+        if (!record)
+            throw new Error(`Question record not found while waiting: ${recordPath}`);
+        if (isTerminalQuestionStatus(record.status))
+            return record;
+        if (typeof timeoutMs === 'number' && timeoutMs >= 0 && Date.now() - startedAt > timeoutMs) {
+            throw new Error(`Timed out waiting for question answer after ${timeoutMs}ms`);
+        }
+        await sleep(pollIntervalMs);
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/question/state.js.map

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

package/dist/question/types.d.ts

@@ -0,0 +1,66 @@
+export interface QuestionOption {
+    label: string;
+    value: string;
+    description?: string;
+}
+export type QuestionType = 'single-answerable' | 'multi-answerable';
+export interface QuestionInput {
+    header?: string;
+    question: string;
+    options: QuestionOption[];
+    allow_other: boolean;
+    other_label: string;
+    multi_select: boolean;
+    type?: QuestionType;
+    source?: string;
+    session_id?: string;
+}
+export type QuestionRendererKind = 'tmux-pane' | 'tmux-session';
+export interface QuestionAnswer {
+    kind: 'option' | 'other' | 'multi';
+    value: string | string[];
+    selected_labels: string[];
+    selected_values: string[];
+    other_text?: string;
+}
+export type QuestionStatus = 'pending' | 'prompting' | 'answered' | 'aborted' | 'error';
+export interface QuestionRendererState {
+    renderer: QuestionRendererKind;
+    target: string;
+    launched_at: string;
+    return_target?: string;
+    return_transport?: 'tmux-send-keys';
+}
+export interface QuestionRecord {
+    kind: 'omx.question/v1';
+    question_id: string;
+    session_id?: string;
+    created_at: string;
+    updated_at: string;
+    status: QuestionStatus;
+    header?: string;
+    question: string;
+    options: QuestionOption[];
+    allow_other: boolean;
+    other_label: string;
+    multi_select: boolean;
+    type?: QuestionType;
+    source?: string;
+    renderer?: QuestionRendererState;
+    answer?: QuestionAnswer;
+    error?: {
+        code: string;
+        message: string;
+        at: string;
+    };
+}
+export declare function getNormalizedQuestionType(input: {
+    type?: QuestionType;
+    multi_select?: boolean;
+}): QuestionType;
+export declare function isMultiAnswerableQuestion(input: {
+    type?: QuestionType;
+    multi_select?: boolean;
+}): boolean;
+export declare function normalizeQuestionInput(raw: unknown): QuestionInput;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/question/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,cAAc,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IACnC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAExF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;CACH;AA+BD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,YAAY,CAEf;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAEV;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CA8ClE"}

package/dist/question/types.js

@@ -0,0 +1,82 @@
+function safeString(value) {
+    return typeof value === 'string' ? value : '';
+}
+function normalizeOption(raw, index) {
+    if (typeof raw === 'string') {
+        const label = raw.trim();
+        if (!label)
+            throw new Error(`options[${index}] must be a non-empty string`);
+        return { label, value: label };
+    }
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new Error(`options[${index}] must be a string or object`);
+    }
+    const label = safeString(raw.label).trim();
+    const value = safeString(raw.value).trim() || label;
+    const description = safeString(raw.description).trim() || undefined;
+    if (!label)
+        throw new Error(`options[${index}].label must be a non-empty string`);
+    if (!value)
+        throw new Error(`options[${index}].value must be a non-empty string`);
+    return { label, value, ...(description ? { description } : {}) };
+}
+function parseQuestionType(raw) {
+    const normalized = safeString(raw).trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    if (normalized === 'multi-answerable' || normalized === 'multi-select')
+        return 'multi-answerable';
+    if (normalized === 'single-answerable' || normalized === 'single-select')
+        return 'single-answerable';
+    throw new Error('type must be one of: single-answerable, multi-answerable');
+}
+export function getNormalizedQuestionType(input) {
+    return input.type ?? (input.multi_select === true ? 'multi-answerable' : 'single-answerable');
+}
+export function isMultiAnswerableQuestion(input) {
+    return getNormalizedQuestionType(input) === 'multi-answerable';
+}
+export function normalizeQuestionInput(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new Error('question input must be a JSON object');
+    }
+    const input = raw;
+    const question = safeString(input.question).trim();
+    const header = safeString(input.header).trim() || undefined;
+    const source = safeString(input.source).trim() || undefined;
+    const session_id = safeString(input.session_id).trim() || undefined;
+    const other_label = safeString(input.other_label).trim() || 'Other';
+    const allow_other = input.allow_other !== false;
+    const rawMultiSelect = input.multi_select;
+    const parsedType = parseQuestionType(input.type);
+    const rawOptions = Array.isArray(input.options) ? input.options : [];
+    if (!question)
+        throw new Error('question must be a non-empty string');
+    if (rawOptions.length === 0 && !allow_other) {
+        throw new Error('options must be a non-empty array unless allow_other is true');
+    }
+    if (parsedType === 'single-answerable' && rawMultiSelect === true) {
+        throw new Error('type=single-answerable conflicts with multi_select=true');
+    }
+    if (parsedType === 'multi-answerable' && rawMultiSelect === false) {
+        throw new Error('type=multi-answerable conflicts with multi_select=false');
+    }
+    const options = rawOptions.map(normalizeOption);
+    const type = getNormalizedQuestionType({
+        type: parsedType,
+        multi_select: rawMultiSelect === true,
+    });
+    const multi_select = type === 'multi-answerable';
+    return {
+        ...(header ? { header } : {}),
+        question,
+        options,
+        allow_other,
+        other_label,
+        multi_select,
+        type,
+        ...(source ? { source } : {}),
+        ...(session_id ? { session_id } : {}),
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/question/types.js.map

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

package/dist/question/ui.d.ts

@@ -0,0 +1,38 @@
+import type { QuestionRecord } from './types.js';
+interface QuestionUiInput {
+    isTTY?: boolean;
+    on(event: 'keypress', listener: (str: string, key: KeyLike) => void): this;
+    off(event: 'keypress', listener: (str: string, key: KeyLike) => void): this;
+    resume?(): void;
+    pause?(): void;
+    setRawMode?(mode: boolean): void;
+}
+interface QuestionUiOutput {
+    isTTY?: boolean;
+    write(chunk: string): boolean;
+}
+interface QuestionUiDeps {
+    input?: QuestionUiInput;
+    output?: QuestionUiOutput;
+}
+interface InteractiveSelectionState {
+    cursorIndex: number;
+    selectedIndices: number[];
+    error?: string;
+}
+interface SelectionUpdate {
+    state: InteractiveSelectionState;
+    submit: boolean;
+}
+interface KeyLike {
+    name?: string;
+    ctrl?: boolean;
+    sequence?: string;
+}
+export declare function createInitialInteractiveSelectionState(): InteractiveSelectionState;
+export declare function applyInteractiveSelectionKey(record: QuestionRecord, state: InteractiveSelectionState, key: KeyLike): SelectionUpdate;
+export declare function renderInteractiveQuestionFrame(record: QuestionRecord, state: InteractiveSelectionState): string;
+export declare function promptForSelectionsWithArrows(record: QuestionRecord, deps?: QuestionUiDeps): Promise<number[]>;
+export declare function runQuestionUi(recordPath: string, deps?: QuestionUiDeps): Promise<void>;
+export {};
+//# sourceMappingURL=ui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/question/ui.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAkB,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3E,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5E,MAAM,CAAC,IAAI,IAAI,CAAC;IAChB,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,UAAU,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CAClC;AAED,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED,UAAU,yBAAyB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,eAAe;IACvB,KAAK,EAAE,yBAAyB,CAAC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,OAAO;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA2FD,wBAAgB,sCAAsC,IAAI,yBAAyB,CAKlF;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,yBAAyB,EAChC,GAAG,EAAE,OAAO,GACX,eAAe,CAgFjB;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,yBAAyB,GAC/B,MAAM,CAsBR;AAED,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CAgEnB;AAiDD,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BhG"}