@hearsay-tools/squawk 0.0.0-stage → 0.17.0-dev.5685

package/dist/voice/decision-log.js

@@ -0,0 +1,117 @@
+import { dataReadDirs } from '../project-paths.js';
+import { projectWriteRefused } from '../server/cockpit-ownership.js';
+import { mergeAppendOnly } from '../merged-streams.js';
+import { appendFileSync, closeSync, fstatSync, mkdirSync, openSync, readSync } from 'node:fs';
+import { join } from 'node:path';
+import { voiceOutcomeSchema } from '../contract/index.js';
+export function appendVoiceLog(dataDir, line) {
+    if (projectWriteRefused(dataDir))
+        return;
+    try {
+        const dir = join(dataDir, 'voice');
+        mkdirSync(dir, { recursive: true });
+        appendFileSync(join(dir, 'decisions.ndjson'), `${JSON.stringify(line)}\n`, 'utf8');
+    }
+    catch {
+        // Best effort, like the other local logs: the decision already reached the user.
+    }
+}
+/** Most decisions kept per project; the engine is told only the newest few. */
+const RECENT_MAX = 10;
+/** `load` reads at most this much of the end of the log. */
+const LOAD_TAIL_BYTES = 64 * 1024;
+/** The last `LOAD_TAIL_BYTES` of a file as lines; a partial first line is dropped. Throws what the read throws. */
+function readLogTail(path) {
+    const fd = openSync(path, 'r');
+    try {
+        const size = fstatSync(fd).size;
+        const start = Math.max(0, size - LOAD_TAIL_BYTES);
+        const buffer = Buffer.alloc(size - start);
+        let filled = 0;
+        while (filled < buffer.length) {
+            const n = readSync(fd, buffer, filled, buffer.length - filled, start + filled);
+            if (n === 0)
+                break;
+            filled += n;
+        }
+        const lines = buffer.subarray(0, filled).toString('utf8').split('\n');
+        return start > 0 ? lines.slice(1) : lines;
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/** One log line as replay reads it, or undefined when it is not an object with a decision ID. */
+function parseLogLine(line) {
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+    if (parsed === null || typeof parsed !== 'object')
+        return undefined;
+    return typeof parsed.decisionId === 'string' ? parsed : undefined;
+}
+export class RecentVoiceActions {
+    byProject = new Map();
+    loaded = new Set();
+    /**
+     * Seeds a project from the tail of its log, once. A missing, unreadable or damaged log seeds
+     * nothing and never throws; later calls for the same project do nothing.
+     */
+    load(projectId, dataDir) {
+        if (this.loaded.has(projectId))
+            return;
+        this.loaded.add(projectId);
+        const sources = dataReadDirs(dataDir).map(directory => {
+            try {
+                return readLogTail(join(directory, 'voice', 'decisions.ndjson')).flatMap(line => parseLogLine(line) ?? []);
+            }
+            catch {
+                return [];
+            }
+        });
+        // Legacy wins a duplicate (decisionId, type); survivors replay in recorded time across both logs.
+        // Decisions first, then outcomes: an outcome may belong to the other directory's decision.
+        const lines = mergeAppendOnly(sources, entry => `${entry.decisionId}:${String(entry.type)}`, entry => typeof entry.at === 'string' ? entry.at : undefined);
+        for (const type of ['decision', 'outcome']) {
+            for (const entry of lines)
+                if (entry.type === type)
+                    this.replay(projectId, entry);
+        }
+    }
+    replay(projectId, entry) {
+        if (entry.type === 'decision' && typeof entry.sentence === 'string') {
+            // Only the action is replayed, so a line written by another version still seeds what it can.
+            const action = entry.decision?.action;
+            if (typeof action === 'string')
+                this.record(projectId, entry.decisionId, entry.sentence, action);
+        }
+        else if (entry.type === 'outcome') {
+            const outcome = voiceOutcomeSchema.safeParse(entry.outcome);
+            if (outcome.success)
+                this.settle(projectId, entry.decisionId, outcome.data);
+        }
+    }
+    record(projectId, decisionId, sentence, action) {
+        const entries = this.byProject.get(projectId) ?? [];
+        entries.push({ decisionId, sentence, action });
+        if (entries.length > RECENT_MAX)
+            entries.splice(0, entries.length - RECENT_MAX);
+        this.byProject.set(projectId, entries);
+    }
+    /** Marks what became of a known decision; an unknown or forgotten id changes nothing. */
+    settle(projectId, decisionId, outcome) {
+        const entry = this.byProject.get(projectId)?.find((e) => e.decisionId === decisionId);
+        if (entry)
+            entry.outcome = outcome;
+    }
+    /** Up to `n` newest entries, oldest first. */
+    last(projectId, n = 3) {
+        const entries = this.byProject.get(projectId) ?? [];
+        return entries.slice(-n).map(({ sentence, action, outcome }) => ({ sentence, action, ...(outcome !== undefined ? { outcome } : {}) }));
+    }
+}
+//# sourceMappingURL=decision-log.js.map

package/dist/voice/decision-log.js.map

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

package/dist/voice/engine.d.ts

@@ -0,0 +1,119 @@
+import type { z } from 'zod';
+import type { VoiceView, voiceSidebarViewSchema } from '../contract/index.js';
+/**
+ * Typed decision-engine seam: one request carries the sentence’s questions. Consume applicable
+ * answers only; keep Jev and dry-run implementations inside this folder.
+ */
+export type EngineQuestion = {
+    type: 'choice';
+    instructions: string;
+    options: Record<string, string | null>;
+} | {
+    type: 'noul';
+    instructions: string;
+    criteria: {
+        true: string;
+        false: string;
+    };
+};
+export type EngineAnswer = {
+    type: 'choice';
+    choice: string;
+    confidence: number;
+    probabilities: Record<string, number>;
+} | {
+    type: 'noul';
+    noul: number;
+};
+/**
+ * What the engine is told besides the questions: Jev has no memory between calls. `words` numbers the
+ * sentence (`W01 answer`) so a question can ask about one word where it stands; `screen` is what the
+ * user sees (hearsay-tools/cezarion#1463).
+ */
+export interface VoiceEngineState {
+    sentence: string;
+    words: string[];
+    screen: {
+        page: VoiceView | 'unknown';
+        sidebarView: z.infer<typeof voiceSidebarViewSchema>;
+        project: string;
+        openTask?: {
+            title: string;
+            status: string;
+        };
+    };
+    pendingProposal?: 'answer' | 'tell';
+    card?: {
+        number: number;
+        header: string;
+        question: string;
+        options?: {
+            label: string;
+            description?: string;
+        }[];
+        multiSelect?: boolean;
+    }[] | undefined;
+    recent: {
+        sentence: string;
+        action: string;
+        outcome?: string;
+    }[];
+}
+export interface DecisionEngine {
+    readonly id: 'jev' | 'fake';
+    /**
+     * Answers every question it is given. Rejects with `VoiceEngineError` when the engine fails, and
+     * with the caller signal's own reason when the caller aborts.
+     */
+    decide(input: {
+        state: VoiceEngineState;
+        questions: Record<string, EngineQuestion>;
+    }, signal: AbortSignal): Promise<{
+        answers: Record<string, EngineAnswer>;
+        inputTokens?: number;
+    }>;
+}
+/**
+ * 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 declare const QUESTION_IDS: {
+    readonly isCommand: 'is_command';
+    readonly scope: 'scope';
+    readonly projectAction: 'project_action';
+    readonly sessionAction: 'session_action';
+    readonly status: 'status';
+    readonly position: 'position';
+    readonly word: (k: number) => string;
+    readonly option: (i: number) => string;
+    readonly optionSelected: (i: number, j: number) => string;
+};
+/** 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 declare const COMMAND_LABEL = "routing";
+export declare const MESSAGE_LABEL = "message";
+export declare const questionLabel: (i: number) => string;
+/**
+ * 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 declare function textKey(text: string): string;
+/** The text inside a `textKey`, or undefined when the key is not one. */
+export declare function keyText(key: string): string | 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 declare class VoiceEngineError extends Error {
+    readonly code: 'http' | 'timeout' | 'invalid-answer' | 'network';
+    readonly status?: number | undefined;
+    constructor(code: 'http' | 'timeout' | 'invalid-answer' | 'network', status?: number | undefined, detail?: string);
+}
+/**
+ * `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 declare function selectVoiceEngine(env: NodeJS.ProcessEnv, fetchImpl?: typeof fetch): DecisionEngine;

package/dist/voice/engine.js

@@ -0,0 +1,61 @@
+import { productEnv } from '../core/product-env.js';
+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 (productEnv('DRY_RUN', env) === '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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,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,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,eAAe,EAAE,CAAC;IACrE,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":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAsF,MAAM,aAAa,CAAC;AACrL,OAAO,EAAE,SAAS,EAAE,UAAU,EAAkB,MAAM,eAAe,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjH,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAClG,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,QAAQ,EAAE,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,wBAAwB,CAAC;AAEhF,uCAAuC;AACvC,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClE,OAAO,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,qGAAqG;AACrG,MAAM,eAAe,GAAG,IAAI,MAAM,CAAC,kDAAkD,GAAG,MAAM,GAAG,mBAAmB,EAAE,IAAI,CAAC,CAAC;AAC5H,MAAM,cAAc,GAAG;IACrB,IAAI,MAAM,CAAC,iBAAiB,GAAG,oCAAoC,EAAE,GAAG,CAAC;IACzE,IAAI,MAAM,CAAC,iCAAiC,GAAG,IAAI,EAAE,GAAG,CAAC;CAC1D,CAAC;AACF,0FAA0F;AAC1F,MAAM,YAAY,GAAG,sKAAsK,CAAC;AAC5L,6EAA6E;AAC7E,MAAM,SAAS,GAAG,6BAA6B,CAAC;AAEhD,MAAM,OAAO,eAAe;IACjB,EAAE,GAAG,MAAM,CAAC;IAErB,uDAAuD;IACvD,KAAK,CAAC,MAAM,CACV,KAA6E,EAC7E,OAAoB;QAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,OAAO,GAAiC,EAAE,CAAC;QACjD,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7D,OAAO,CAAC,EAAE,CAAC;gBACT,QAAQ,CAAC,IAAI,KAAK,QAAQ;oBACxB,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;oBAChG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;CACF;AAED,SAAS,YAAY,CAAC,OAAiB,EAAE,MAA0B;IACjE,MAAM,MAAM,GAAG,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7F,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,CAAC;QACb,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAChG,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,SAAS,QAAQ,CAAC,OAAiB;IACjC,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,IAAI,CAAC,KAAuB;IAInC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACpF,qDAAqD;IACrD,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,EAAE;QAC7B,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtF,OAAO,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAE,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC;IACxG,CAAC,CAAC;IAEF,OAAO;QACL,MAAM,CAAC,EAAE,EAAE,OAAO;YAChB,IAAI,EAAE,KAAK,YAAY,CAAC,KAAK,EAAE,CAAC;gBAC9B,IAAI,MAAM,KAAK,MAAM;oBAAE,OAAO,SAAS,CAAC;gBACxC,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;YAChD,CAAC;YACD,IAAI,EAAE,KAAK,YAAY,CAAC,aAAa;gBAAE,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;YAClF,IAAI,EAAE,KAAK,YAAY,CAAC,aAAa;gBAAE,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;YACpI,IAAI,EAAE,KAAK,YAAY,CAAC,QAAQ;gBAAE,OAAO,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACpE,IAAI,EAAE,KAAK,YAAY,CAAC,MAAM;gBAAE,OAAO,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAChE,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,IAAI;gBAAE,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAC;YAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,KAAK,YAAY,CAAC,SAAS;gBAAE,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1E,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,CAAC;YACtB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,OAAO,MAAM,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,sGAAsG;AACtG,SAAS,KAAK,CAAC,QAAgB;IAC7B,OAAO,QAAQ;SACZ,IAAI,EAAE;SACN,OAAO,CAAC,uCAAuC,EAAE,EAAE,CAAC;SACpD,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,iDAAiD,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACnF,IAAI,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnE,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC7F,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,KAAuB,EAAE,KAAkB,EAAE,MAAc;IAC7E,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC;IAC9C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;IACjF,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC;IACzF,MAAM,OAAO,GAAG,CAAC,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC;IAC9D,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACxB,IAAI,OAAO,CAAC,IAAI,CAAC;gBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;gBACxB,IAAI,OAAO,CAAC,IAAI,CAAC;oBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YAClD,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACrD,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACxB,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/H,CAAC,CAAC,CAAC;QACH,IAAI,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACzC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,OAAiB;IAClD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,0BAA0B,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/E,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/D,MAAM,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACrF,CAAC;AAED,gFAAgF;AAChF,SAAS,QAAQ,CAAC,KAAa,EAAE,OAAiB;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACvG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACrG,CAAC;AAED,qGAAqG;AACrG,SAAS,QAAQ,CAAC,OAAe,EAAE,MAAgB;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACtF,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9E,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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;
+    }>;
+}