@wjarka/cezarion 0.16.0 → 0.17.0

package/dist/voice/engine.js

@@ -0,0 +1,60 @@
+import { FakeVoiceEngine } from './fake-engine.js';
+import { JevVoiceEngine } from './jev-engine.js';
+/**
+ * The question ids code and engines agree on. A card question adds its 0-based index; a word adds
+ * its 0-based position in the sentence.
+ */
+export const QUESTION_IDS = {
+    isCommand: 'is_command',
+    scope: 'scope',
+    projectAction: 'project_action',
+    sessionAction: 'session_action',
+    status: 'status',
+    position: 'position',
+    word: (k) => `w${k}`,
+    option: (i) => `q${i}_option`,
+    optionSelected: (i, j) => `q${i}_opt${j}`,
+};
+/** The label of a word that is no part of a reply. Targets are `q1`…`qN` with a card, else `message`. */
+/** Words said to the cockpit rather than the agent. Not `command`: Jev read an instruction for the
+ *  agent ("ask me one more question") as a command (hearsay-tools/cezarion#1463 live testing). */
+export const COMMAND_LABEL = 'routing';
+export const MESSAGE_LABEL = 'message';
+export const questionLabel = (i) => `q${i + 1}`;
+/**
+ * Option keys that carry user or card text are wrapped in curly quotes, so they can never equal a bare
+ * key the code owns (`none`, `other`, an action, status or position id). "none" said as an answer is
+ * the key `“none”`; the sentinel stays `none`. The text inside is read back with `keyText`.
+ */
+export function textKey(text) {
+    return `\u201c${text}\u201d`;
+}
+/** The text inside a `textKey`, or undefined when the key is not one. */
+export function keyText(key) {
+    return key.length >= 2 && key.startsWith('\u201c') && key.endsWith('\u201d') ? key.slice(1, -1) : undefined;
+}
+/**
+ * An engine failure. The message is fixed text and the error carries no request, header or cause,
+ * so the API key cannot travel in it.
+ */
+export class VoiceEngineError extends Error {
+    code;
+    status;
+    constructor(code, status, detail) {
+        super(detail ? `Voice engine ${code}: ${detail}` : `Voice engine ${code}`);
+        this.code = code;
+        this.status = status;
+        this.name = 'VoiceEngineError';
+    }
+}
+/**
+ * `CEZ_DRY_RUN=1` always gets the fake, even with a key, so a dry run never reaches the network.
+ * Otherwise Jev; its constructor throws without a key, which the capability gate in front of the
+ * route has already ruled out.
+ */
+export function selectVoiceEngine(env, fetchImpl) {
+    if (env.CEZ_DRY_RUN === '1')
+        return new FakeVoiceEngine();
+    return new JevVoiceEngine({ apiKey: env.TYPESAFE_API_KEY ?? '', ...(fetchImpl ? { fetch: fetchImpl } : {}) });
+}
+//# sourceMappingURL=engine.js.map

package/dist/voice/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/voice/engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAoDjD;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS,EAAE,YAAY;IACvB,KAAK,EAAE,OAAO;IACd,aAAa,EAAE,gBAAgB;IAC/B,aAAa,EAAE,gBAAgB;IAC/B,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE;IAC5B,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS;IACrC,cAAc,EAAE,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;CACjD,CAAC;AAEX,yGAAyG;AACzG;kGACkG;AAClG,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AACvC,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AACvC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,SAAS,IAAI,QAAQ,CAAC;AAC/B,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9G,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAE9B,IAAI;IACJ,MAAM;IAFjB,YACW,IAAuD,EACvD,MAAe,EACxB,MAAe;QAEf,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;oBAJlE,IAAI;sBACJ,MAAM;QAIf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAsB,EAAE,SAAwB;IAChF,IAAI,GAAG,CAAC,WAAW,KAAK,GAAG;QAAE,OAAO,IAAI,eAAe,EAAE,CAAC;IAC1D,OAAO,IAAI,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAChH,CAAC"}

package/dist/voice/fake-engine.d.ts

@@ -0,0 +1,10 @@
+import { type DecisionEngine, type EngineAnswer, type EngineQuestion, type VoiceEngineState } from './engine.ts';
+export declare class FakeVoiceEngine implements DecisionEngine {
+    readonly id = "fake";
+    decide(input: {
+        state: VoiceEngineState;
+        questions: Record<string, EngineQuestion>;
+    }, _signal: AbortSignal): Promise<{
+        answers: Record<string, EngineAnswer>;
+    }>;
+}

package/dist/voice/fake-engine.js

@@ -0,0 +1,192 @@
+import { COMMAND_LABEL, MESSAGE_LABEL, QUESTION_IDS, questionLabel, textKey } from './engine.js';
+import { copyRange, splitWords } from './sentence.js';
+/**
+ * The dry-run engine (`CEZ_DRY_RUN=1`): deterministic, offline, and small on purpose. It reads a
+ * fixed phrase set — "open <position> <status>", "answer <choice | the Nth answer | words> to
+ * question <N>", "answer that <words>", "tell it: <text>", "reply <text>", "say <text>",
+ * "yes, confirmed", "no" / "cancel" — which is exactly what the browser E2E says. It is not a second
+ * engine: anything else reads as "not a command".
+ */
+const ORDINALS = ['first', 'second', 'third', 'fourth', 'fifth', 'sixth', 'seventh', 'eighth', 'ninth', 'tenth'];
+const CARDINALS = ['one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'ten'];
+const ORD = `(?:${[...ORDINALS, ...CARDINALS].join('|')}|\\d+(?:st|nd|rd|th)?)`;
+/** "second", "two", "2nd", "2" ⇒ 2. */
+function ordinalValue(word) {
+    const w = word.toLowerCase();
+    const named = ORDINALS.indexOf(w) + 1 || CARDINALS.indexOf(w) + 1;
+    return named || Number.parseInt(w, 10);
+}
+/** `questions` named in a sentence: "to question first", "for the second question", "question 2". */
+const QUESTION_ANCHOR = new RegExp(`(?:(?:to|for)\\s+)?(?:the\\s+)?(?:question\\s+(${ORD})|(${ORD})\\s+question)\\b`, 'gi');
+const ORDINAL_CHOICE = [
+    new RegExp(`^(?:the\\s+)?(${ORD})\\s+(?:answer|option|choice|one)$`, 'i'),
+    new RegExp(`^(?:option|choice|answer)\\s+(${ORD})$`, 'i'),
+];
+/** The command words a reply starts with, after any filler; what follows is the reply. */
+const REPLY_PREFIX = /^(?:(?:um+|uh+|so|okay|ok)\b[\s,]*)*(?:answer(?:\s+that)?|tell\s+(?:it|the\s+agent|them)(?:\s+that|\s+to)?|reply(?:\s+with)?|say(?:\s+that)?|message\s+it)\b[\s:,]*/i;
+/** Words that join a reply's parts: "and", "then", a dangling "to"/"for". */
+const CONNECTOR = /^(?:and|then|to|for)[,.]?$/i;
+export class FakeVoiceEngine {
+    id = 'fake';
+    // Offline and instant: the signal has nothing to stop.
+    async decide(input, _signal) {
+        const reading = read(input.state);
+        const answers = {};
+        for (const [id, question] of Object.entries(input.questions)) {
+            answers[id] =
+                question.type === 'choice'
+                    ? choiceAnswer(Object.keys(question.options), reading.choose(id, Object.keys(question.options)))
+                    : { type: 'noul', noul: reading.noul(id) };
+        }
+        return { answers };
+    }
+}
+function choiceAnswer(options, choice) {
+    const picked = choice !== undefined && options.includes(choice) ? choice : fallback(options);
+    return {
+        type: 'choice',
+        choice: picked,
+        confidence: 1,
+        probabilities: Object.fromEntries(options.map((option) => [option, option === picked ? 1 : 0])),
+    };
+}
+/** What an id the fake has no rule for gets: `none` when offered, else the first option. */
+function fallback(options) {
+    return options.includes('none') ? 'none' : (options[0] ?? '');
+}
+function read(state) {
+    const sentence = clean(state.sentence);
+    const lower = sentence.toLowerCase();
+    const action = actionOf(lower);
+    const words = splitWords(state.sentence);
+    const wordLabels = labelWords(state, words, action);
+    const labelsOf = (i) => state.card?.[i]?.options?.map((o) => o.label) ?? [];
+    /** The words labelled with question `i`, as said. */
+    const answerOf = (i) => {
+        const own = wordLabels.flatMap((label, k) => (label === questionLabel(i) ? [k] : []));
+        return own.length === 0 ? undefined : copyRange(state.sentence, words, own[0], own[own.length - 1]);
+    };
+    return {
+        choose(id, options) {
+            if (id === QUESTION_IDS.scope) {
+                if (action === 'open')
+                    return 'project';
+                return action === 'none' ? 'none' : 'session';
+            }
+            if (id === QUESTION_IDS.projectAction)
+                return action === 'open' ? 'open' : 'none';
+            if (id === QUESTION_IDS.sessionAction)
+                return action === 'confirm' || action === 'cancel' || action === 'respond' ? action : 'none';
+            if (id === QUESTION_IDS.position)
+                return positionOf(lower, options);
+            if (id === QUESTION_IDS.status)
+                return statusOf(lower, options);
+            const word = /^w(\d+)$/.exec(id);
+            if (word)
+                return wordLabels[Number(word[1])];
+            const option = /^q(\d+)_option$/.exec(id);
+            if (!option)
+                return undefined;
+            const answer = answerOf(Number(option[1]));
+            return answer === undefined ? 'other' : choiceOf(answer, labelsOf(Number(option[1])));
+        },
+        noul(id) {
+            if (id === QUESTION_IDS.isCommand)
+                return action === 'none' ? 0.05 : 0.95;
+            const option = /^q(\d+)_opt(\d+)$/.exec(id);
+            if (!option)
+                return 0;
+            const answer = answerOf(Number(option[1]));
+            const label = labelsOf(Number(option[1]))[Number(option[2])];
+            return answer !== undefined && label !== undefined && answer.toLowerCase().includes(label.toLowerCase()) ? 1 : 0;
+        },
+    };
+}
+/** Leading fillers and trailing sentence marks off; the case stays, since Other copies it as said. */
+function clean(sentence) {
+    return sentence
+        .trim()
+        .replace(/^(?:(?:um+|uh+|so|okay|ok)\b[\s,]*)+/i, '')
+        .replace(/[\s.!?]+$/, '');
+}
+function actionOf(lower) {
+    const bare = lower.replace(/[,.!?]/g, '').trim();
+    if (/^(?:yes(?: confirmed)?|confirm(?:ed)?|send it)$/.test(bare))
+        return 'confirm';
+    if (/^(?:no|cancel|stop|never ?mind)$/.test(bare))
+        return 'cancel';
+    if (/^open\b/.test(lower))
+        return 'open';
+    if (REPLY_PREFIX.test(lower) && REPLY_PREFIX.exec(lower)[0].trim() !== '')
+        return 'respond';
+    return 'none';
+}
+/**
+ * One label per word: the reply's leading command words, question references and joining words are
+ * `command`; with a card, the words before the reference that names question N are `qN`, and without
+ * a reference a one-question card takes them all; without a card they are the message.
+ */
+function labelWords(state, words, action) {
+    const labels = words.map(() => COMMAND_LABEL);
+    if (action !== 'respond')
+        return labels;
+    const prefixEnd = REPLY_PREFIX.exec(state.sentence.trimStart())?.[0].length ?? 0;
+    const replyStart = state.sentence.length - state.sentence.trimStart().length + prefixEnd;
+    const inReply = (word) => word.start >= replyStart;
+    if (state.card === undefined) {
+        words.forEach((word, k) => {
+            if (inReply(word))
+                labels[k] = MESSAGE_LABEL;
+        });
+        return labels;
+    }
+    const anchors = [...state.sentence.matchAll(QUESTION_ANCHOR)];
+    if (anchors.length === 0) {
+        if (state.card.length === 1) {
+            words.forEach((word, k) => {
+                if (inReply(word))
+                    labels[k] = questionLabel(0);
+            });
+        }
+        return labels;
+    }
+    let from = replyStart;
+    for (const anchor of anchors) {
+        const n = ordinalValue(anchor[1] ?? anchor[2] ?? '');
+        words.forEach((word, k) => {
+            if (n >= 1 && word.start >= from && word.end <= anchor.index && !CONNECTOR.test(word.text))
+                labels[k] = questionLabel(n - 1);
+        });
+        from = anchor.index + anchor[0].length;
+    }
+    return labels;
+}
+function positionOf(lower, options) {
+    const found = new RegExp(`\\b(next|previous|last|${ORD})\\b`).exec(lower)?.[1];
+    if (!found)
+        return undefined;
+    if (['next', 'previous', 'last'].includes(found))
+        return found;
+    const n = ordinalValue(found);
+    return [String(n), ...(n === 1 ? ['first'] : [])].find((o) => options.includes(o));
+}
+/** Longest id first, so "waiting for ci" wins over any shorter id inside it. */
+function statusOf(lower, options) {
+    const spaced = options.filter((o) => o !== 'none').map((id) => ({ id, words: id.replace(/-/g, ' ') }));
+    spaced.sort((a, b) => b.words.length - a.words.length);
+    return spaced.find(({ words }) => new RegExp(`\\b${words}\\b`).test(lower.replace(/-/g, ' ')))?.id;
+}
+/** The choice's own words first, then "the second answer"; anything else is the user's own words. */
+function choiceOf(segment, labels) {
+    const byLabel = labels.find((label) => label.toLowerCase() === segment.toLowerCase());
+    if (byLabel !== undefined)
+        return textKey(byLabel);
+    for (const pattern of ORDINAL_CHOICE) {
+        const word = pattern.exec(segment)?.[1];
+        const label = word === undefined ? undefined : labels[ordinalValue(word) - 1];
+        if (label !== undefined)
+            return textKey(label);
+    }
+    return 'other';
+}
+//# sourceMappingURL=fake-engine.js.map

package/dist/voice/fake-engine.js.map

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

package/dist/voice/jev-engine.d.ts

@@ -0,0 +1,17 @@
+import { type DecisionEngine, type EngineAnswer, type EngineQuestion, type VoiceEngineState } from './engine.ts';
+/** Jev (TypeSafe) behind the engine seam. Plain `fetch`: no SDK dependency. */
+export declare class JevVoiceEngine implements DecisionEngine {
+    #private;
+    readonly id = "jev";
+    constructor(options: {
+        apiKey: string;
+        fetch?: typeof fetch;
+    });
+    decide(input: {
+        state: VoiceEngineState;
+        questions: Record<string, EngineQuestion>;
+    }, signal: AbortSignal): Promise<{
+        answers: Record<string, EngineAnswer>;
+        inputTokens?: number;
+    }>;
+}

package/dist/voice/jev-engine.js

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import { VoiceEngineError } from './engine.js';
+const ENDPOINT = 'https://api.typesafe.ai/v1/systemone';
+/** Pinned: the confidence thresholds are tuned against one model version (see jev-issue-intake.cjs). */
+const MODEL = 'jev-1.13.0';
+/** Per call, no retries: the palette falls back to today's behavior on an error. */
+const TIMEOUT_MS = 5000;
+const unit = z.number().min(0).max(1);
+// Loose objects on purpose: Jev may add keys; only what we read is checked. The envelope leaves
+// answer values unknown: an answer nobody asked for is dropped, so it is never validated.
+const envelopeSchema = z.object({
+    answers: z.record(z.string(), z.unknown()),
+    usage: z.object({ input_tokens: z.unknown().optional() }).optional(),
+});
+const answerSchema = z.discriminatedUnion('type', [
+    z.object({ type: z.literal('choice'), choice: z.string(), confidence: unit, probabilities: z.record(z.string(), unit) }),
+    z.object({ type: z.literal('noul'), noul: unit }),
+]);
+/** Jev (TypeSafe) behind the engine seam. Plain `fetch`: no SDK dependency. */
+export class JevVoiceEngine {
+    id = 'jev';
+    #apiKey;
+    #fetch;
+    constructor(options) {
+        if (!options.apiKey)
+            throw new Error('TYPESAFE_API_KEY is not set');
+        this.#apiKey = options.apiKey;
+        this.#fetch = options.fetch ?? fetch;
+    }
+    async decide(input, signal) {
+        if (signal.aborted)
+            throw signal.reason;
+        // Our own timer rather than AbortSignal.timeout, so a test drives it with fake timers.
+        const timeout = new AbortController();
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            timeout.abort();
+        }, TIMEOUT_MS);
+        try {
+            let body;
+            try {
+                const response = await this.#fetch(ENDPOINT, {
+                    method: 'POST',
+                    headers: { 'content-type': 'application/json', authorization: `Bearer ${this.#apiKey}` },
+                    body: JSON.stringify({ model: MODEL, state: input.state, questions: wireQuestions(input.questions) }),
+                    signal: AbortSignal.any([signal, timeout.signal]),
+                });
+                if (!response.ok)
+                    throw new VoiceEngineError('http', response.status);
+                body = await response.json().catch((error) => {
+                    if (signal.aborted || timedOut)
+                        throw error;
+                    throw new VoiceEngineError('invalid-answer', undefined, 'the response is not JSON');
+                });
+            }
+            catch (error) {
+                // The caller's abort wins: the route tells a closed request from an engine failure.
+                if (signal.aborted)
+                    throw signal.reason;
+                if (timedOut)
+                    throw new VoiceEngineError('timeout');
+                if (error instanceof VoiceEngineError)
+                    throw error;
+                throw new VoiceEngineError('network');
+            }
+            return parse(body, input.questions);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+function wireQuestions(questions) {
+    return Object.fromEntries(Object.entries(questions).map(([id, q]) => [
+        id,
+        q.type === 'choice'
+            ? { type: 'choice', instructions: q.instructions, criteria: q.options }
+            : { type: 'noul', instructions: q.instructions, criteria: q.criteria },
+    ]));
+}
+/** Checks every asked question against its answer; answers nobody asked for are dropped. */
+function parse(body, questions) {
+    const parsed = envelopeSchema.safeParse(body);
+    if (!parsed.success)
+        throw new VoiceEngineError('invalid-answer', undefined, 'the response has the wrong shape');
+    const answers = {};
+    for (const [id, question] of Object.entries(questions)) {
+        const raw = parsed.data.answers[id];
+        if (raw === undefined)
+            throw new VoiceEngineError('invalid-answer', undefined, `no answer for "${id}"`);
+        const checked = answerSchema.safeParse(raw);
+        if (!checked.success)
+            throw new VoiceEngineError('invalid-answer', undefined, `"${id}" has the wrong shape`);
+        const answer = checked.data;
+        if (answer.type !== question.type) {
+            throw new VoiceEngineError('invalid-answer', undefined, `"${id}" has the wrong answer type`);
+        }
+        if (answer.type === 'choice' && question.type === 'choice') {
+            const offered = Object.keys(question.options);
+            if (!offered.includes(answer.choice) || Object.keys(answer.probabilities).some((key) => !offered.includes(key))) {
+                throw new VoiceEngineError('invalid-answer', undefined, `"${id}" names an option that was not offered`);
+            }
+        }
+        answers[id] = answer;
+    }
+    const tokens = parsed.data.usage?.input_tokens;
+    return typeof tokens === 'number' && Number.isFinite(tokens) ? { answers, inputTokens: tokens } : { answers };
+}
+//# sourceMappingURL=jev-engine.js.map

package/dist/voice/jev-engine.js.map

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

package/dist/voice/pending-ask.d.ts

@@ -0,0 +1,17 @@
+import { type AskQuestion } from '../contract/index.js';
+import type { RunRecord } from '../contract/index.js';
+/**
+ * The question card voice mode offers the engine (spec 2026-10-21-voice-mode, "How it decides"):
+ * the latest `ask.requested` in the run's durable history that no delivery or Finish has retired.
+ *
+ * The transcript is the source because the cockpit's ask card renders from it, and voice offers
+ * exactly the card the cockpit shows. Attention reads the open human wait instead
+ * (hearsay-tools/cezarion#1236), and the two can differ: a run that goes terminal cancels its open
+ * waits, yet its unanswered card stays shown and answerable through Continue, so a missing human
+ * wait does not hide the card. An open human wait that names a different ask (`askSeq`) does: the
+ * run waits on something else. Undefined when there is no card or the history cannot be read.
+ */
+export declare function readPendingHumanAsk(dataDir: string, run: Pick<RunRecord, 'id' | 'waits'>): {
+    requestId: string;
+    questions: AskQuestion[];
+} | undefined;

package/dist/voice/pending-ask.js

@@ -0,0 +1,50 @@
+import { HUMAN_ASK_EVENT_TYPES, askRequestSchema } from '../contract/index.js';
+import { pendingAskOf } from '../contract/index.js';
+import { readHistoryText } from '../runs/history-file.js';
+/** The ask events of a run's durable history, or undefined when it has no history. Throws what the read throws. */
+function readHumanAskEvents(dataDir, runId) {
+    const raw = readHistoryText(dataDir, runId);
+    if (raw === undefined)
+        return undefined;
+    const events = [];
+    for (const line of raw.split('\n')) {
+        if (!line)
+            continue;
+        try {
+            const event = JSON.parse(line);
+            if (event !== null && typeof event === 'object' && 'type' in event &&
+                typeof event.type === 'string' && HUMAN_ASK_EVENT_TYPES.has(event.type))
+                events.push(event);
+        }
+        catch { /* Match readEvents: a damaged line does not hide later valid receipts. */ }
+    }
+    return events;
+}
+/**
+ * The question card voice mode offers the engine (spec 2026-10-21-voice-mode, "How it decides"):
+ * the latest `ask.requested` in the run's durable history that no delivery or Finish has retired.
+ *
+ * The transcript is the source because the cockpit's ask card renders from it, and voice offers
+ * exactly the card the cockpit shows. Attention reads the open human wait instead
+ * (hearsay-tools/cezarion#1236), and the two can differ: a run that goes terminal cancels its open
+ * waits, yet its unanswered card stays shown and answerable through Continue, so a missing human
+ * wait does not hide the card. An open human wait that names a different ask (`askSeq`) does: the
+ * run waits on something else. Undefined when there is no card or the history cannot be read.
+ */
+export function readPendingHumanAsk(dataDir, run) {
+    try {
+        const events = readHumanAskEvents(dataDir, run.id);
+        const pending = events === undefined ? undefined : pendingAskOf(events);
+        if (pending === undefined)
+            return undefined;
+        const elsewhere = run.waits?.some(wait => wait.kind === 'human' && wait.phase === 'open' && wait.askSeq !== undefined && wait.askSeq !== pending.seq);
+        if (elsewhere)
+            return undefined;
+        const parsed = askRequestSchema.safeParse({ questions: pending.questions });
+        return parsed.success ? { requestId: pending.requestId, questions: parsed.data.questions } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=pending-ask.js.map

package/dist/voice/pending-ask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-ask.js","sourceRoot":"","sources":["../../src/voice/pending-ask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAoB,MAAM,kCAAkC,CAAC;AAC7G,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,mHAAmH;AACnH,SAAS,kBAAkB,CAAC,OAAe,EAAE,KAAa;IACxD,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5C,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,IAAI,CAAC;YACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK;gBAChE,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAiB,CAAC,CAAC;QAC5G,CAAC;QAAC,MAAM,CAAC,CAAC,0EAA0E,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,GAAoC;IAEpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACxE,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CACvC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9G,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;QAChC,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QAC5E,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACzG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/voice/routes.d.ts

@@ -0,0 +1,115 @@
+import type { ProjectApiEnv } from '../server/server.ts';
+import { type RecentVoiceActions } from './decision-log.ts';
+import { type DecisionEngine } from './engine.ts';
+/** The one refusal both routes answer while voice mode is off (capability `voice`). */
+export declare const VOICE_OFF = "Voice mode is off: set CEZ_VOICE=1 and TYPESAFE_API_KEY, then restart cezar";
+export interface VoiceRouteDeps {
+    voiceEnabled(): boolean;
+    /** Read per request, so the dry-run and key rules follow the live environment. */
+    engine(): DecisionEngine;
+    recent: RecentVoiceActions;
+    uuid?: () => string;
+}
+/**
+ * Voice mode routes (spec 2026-10-21-voice-mode, "Architecture"). One chained family, mounted in the
+ * `v1` chain so they answer under `/api/v1/voice/*` and `/api/v1/p/:projectId/voice/*`. The gate runs
+ * before validation, so an off server never validates, decides or writes.
+ */
+export declare function createVoiceRoutes(deps: VoiceRouteDeps): import("hono/hono-base").HonoBase<ProjectApiEnv, {
+    "/voice/decide": {
+        $post: {
+            output: {
+                action: "open";
+                decisionId: string;
+                status: "archived" | "cancelled" | "done" | "failed" | "finished" | "monitoring" | "needs-permission" | "needs-review" | "needs-you" | "queued" | "running" | "scheduled" | "unread" | "waiting-for-capacity" | "waiting-for-ci" | "waiting-on-workers" | "working";
+                position: number | "last" | "next" | "previous";
+                confidence: number;
+                alternatives?: {
+                    status: "archived" | "cancelled" | "done" | "failed" | "finished" | "monitoring" | "needs-permission" | "needs-review" | "needs-you" | "queued" | "running" | "scheduled" | "unread" | "waiting-for-capacity" | "waiting-for-ci" | "waiting-on-workers" | "working";
+                    position: number | "last" | "next" | "previous";
+                }[] | undefined;
+            } | {
+                action: "answer";
+                decisionId: string;
+                runId: string;
+                askRequestId: string;
+                answers: ({
+                    question: number;
+                    kind: "option";
+                    labels: string[];
+                } | {
+                    question: number;
+                    kind: "other";
+                    text: string;
+                })[];
+                confidence: number;
+            } | {
+                action: "tell";
+                decisionId: string;
+                runId: string;
+                text: string;
+                confidence: number;
+            } | {
+                action: "confirm";
+                decisionId: string;
+            } | {
+                action: "cancel";
+                decisionId: string;
+            } | {
+                action: "none";
+                decisionId: string;
+                reason: "ambiguous" | "no-open-question" | "no-open-task" | "not-a-command" | "stale-context" | "unclear" | "unsupported";
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                json: {
+                    text: string;
+                    sidebarView: "active" | "automations";
+                    openRunId?: string | undefined;
+                    view?: "automations" | "git" | "github" | "inbox" | "new-task" | "other" | "settings" | "task" | undefined;
+                    askRequestId?: string | null | undefined;
+                    proposal?: {
+                        decisionId: string;
+                        action: "answer" | "tell";
+                    } | undefined;
+                };
+            };
+        } | {
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 503;
+            input: {
+                json: {
+                    text: string;
+                    sidebarView: "active" | "automations";
+                    openRunId?: string | undefined;
+                    view?: "automations" | "git" | "github" | "inbox" | "new-task" | "other" | "settings" | "task" | undefined;
+                    askRequestId?: string | null | undefined;
+                    proposal?: {
+                        decisionId: string;
+                        action: "answer" | "tell";
+                    } | undefined;
+                };
+            };
+        };
+    };
+} & {
+    "/voice/outcome": {
+        $post: {
+            output: {
+                ok: true;
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                json: {
+                    decisionId: string;
+                    outcome: "abandoned" | "cancelled" | "confirmed" | "executed" | "replaced";
+                };
+            };
+        };
+    };
+}, "/", "/voice/outcome">;