@voxagent/bridge 0.3.5 → 0.4.0

package/dist/trigger/addressing.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @file Deterministic addressing rules.
+ *
+ * Two jobs:
+ *   1. Hard rules that must never be probabilistic — a spoken "stop", and a
+ *      "yes" to a pending nudge. These run BEFORE the classifier.
+ *   2. The wake-phrase fallback used when jev is unavailable (no key, timeout,
+ *      outage). Ported from `apps/web/lib/bridge/addressing.ts` with the bare
+ *      "agent" patterns dropped: "agent" is a common noun for our users, which
+ *      is the whole reason the classifier exists. "Vox" / "VoxAgent" stay as
+ *      the guaranteed summon.
+ */
+export declare function mentionsAgentName(text: string): boolean;
+export declare function hasDirectAgentAddress(text: string): boolean;
+export declare function isDisengagePhrase(text: string): boolean;
+export declare function isHardStop(text: string): boolean;
+export declare function isAffirmative(text: string): boolean;
+export declare function isNegative(text: string): boolean;
+export interface AddressingState {
+    /** Speaker who last addressed the agent. */
+    engagedSpeakerId: string | null;
+    /** Wall-clock when the agent's last run ended. */
+    lastAgentRunEndMs: number | null;
+}
+export type AddressingReason = 'wake' | 'follow_up' | 'ignore' | 'disengage';
+export interface AddressingDecision {
+    addressed: boolean;
+    reason: AddressingReason;
+    nextState: AddressingState;
+}
+export declare function createInitialAddressingState(): AddressingState;
+export declare function noteAgentRunEnded(state: AddressingState, nowMs: number): AddressingState;
+/** Fallback-only. With jev available, follow-ups are a judgment, not a timer. */
+export declare function evaluateAddressing(options: {
+    text: string;
+    speakerId: string;
+    state: AddressingState;
+    nowMs: number;
+}): AddressingDecision;
+//# sourceMappingURL=addressing.d.ts.map

package/dist/trigger/addressing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addressing.d.ts","sourceRoot":"","sources":["../../src/trigger/addressing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA4CH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED,wBAAgB,4BAA4B,IAAI,eAAe,CAE9D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAGxF;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,kBAAkB,CA8BrB"}

package/dist/trigger/addressing.js

@@ -0,0 +1,90 @@
+/**
+ * @file Deterministic addressing rules.
+ *
+ * Two jobs:
+ *   1. Hard rules that must never be probabilistic — a spoken "stop", and a
+ *      "yes" to a pending nudge. These run BEFORE the classifier.
+ *   2. The wake-phrase fallback used when jev is unavailable (no key, timeout,
+ *      outage). Ported from `apps/web/lib/bridge/addressing.ts` with the bare
+ *      "agent" patterns dropped: "agent" is a common noun for our users, which
+ *      is the whole reason the classifier exists. "Vox" / "VoxAgent" stay as
+ *      the guaranteed summon.
+ */
+const NAME = '(?:vox\\s?agent|vox|voice\\s+agent)';
+const DIRECT_ADDRESS_PATTERNS = [
+    new RegExp(`\\b(?:hey|hi|hello|ok|okay)\\s+${NAME}\\b`, 'i'),
+    new RegExp(`^\\s*${NAME}\\s*[,!?.]`, 'i'),
+    new RegExp(`^\\s*${NAME}\\s+(?:can|could|would|will|please|what|when|where|who|why|how|is|are|do|does)\\b`, 'i'),
+    new RegExp(`\\b(?:can|could|would|please)\\s+(?:you\\s+)?${NAME}\\b`, 'i'),
+    new RegExp(`\\bask\\s+${NAME}\\s+to\\b`, 'i'),
+    new RegExp(`[,]\\s*${NAME}\\s*[.!?]?\\s*$`, 'i'),
+];
+const NAME_MENTION = new RegExp(`\\b${NAME}\\b`, 'i');
+const DISENGAGE_PATTERNS = [
+    /^\s*(thanks|thank you)\b/i,
+    /\b(that'?s|that is)\s+all\b/i,
+    /\b(nevermind|never mind)\b/i,
+];
+/**
+ * The WHOLE utterance is a stop command, optionally with the agent's name.
+ * Deliberately anchored at both ends: "we should stop by the office" must not
+ * cancel a ten-minute run.
+ */
+const STOP_CORE = "(?:stop|stop it|stop that|stop talking|cancel|cancel that|cancel it|abort|shut up|be quiet|quiet|enough|that'?s enough|never ?mind)";
+const HARD_STOP = new RegExp(`^\\s*(?:(?:hey|ok|okay)\\s+)?(?:${NAME}\\s*[,.!]?\\s*)?(?:please\\s+)?${STOP_CORE}(?:\\s+please)?(?:\\s*[,.!]?\\s*${NAME})?\\s*[.!]*\\s*$`, 'i');
+const AFFIRMATIVE = /^\s*(?:yes|yeah|yep|yup|sure|please|please do|go ahead|go for it|do it|that was for you|yes please|ok|okay)\b[\s,.!]*(?:vox\s?agent|vox)?[\s,.!]*(?:please|go ahead|do it)?[\s.!]*$/i;
+const NEGATIVE = /^\s*(?:no|nope|nah|not you|no thanks|not now|never ?mind)\b[\s,.!]*(?:vox\s?agent|vox)?[\s.!]*$/i;
+const FOLLOW_UP_WINDOW_MS = 15_000;
+export function mentionsAgentName(text) {
+    return NAME_MENTION.test(text);
+}
+export function hasDirectAgentAddress(text) {
+    return DIRECT_ADDRESS_PATTERNS.some((pattern) => pattern.test(text));
+}
+export function isDisengagePhrase(text) {
+    return DISENGAGE_PATTERNS.some((pattern) => pattern.test(text));
+}
+export function isHardStop(text) {
+    return HARD_STOP.test(text);
+}
+export function isAffirmative(text) {
+    return AFFIRMATIVE.test(text);
+}
+export function isNegative(text) {
+    return NEGATIVE.test(text);
+}
+export function createInitialAddressingState() {
+    return { engagedSpeakerId: null, lastAgentRunEndMs: null };
+}
+export function noteAgentRunEnded(state, nowMs) {
+    if (!state.engagedSpeakerId)
+        return state;
+    return { ...state, lastAgentRunEndMs: nowMs };
+}
+/** Fallback-only. With jev available, follow-ups are a judgment, not a timer. */
+export function evaluateAddressing(options) {
+    const text = options.text.trim();
+    if (text.length === 0) {
+        return { addressed: false, reason: 'ignore', nextState: options.state };
+    }
+    if (isDisengagePhrase(text)) {
+        return { addressed: false, reason: 'disengage', nextState: createInitialAddressingState() };
+    }
+    if (hasDirectAgentAddress(text)) {
+        return {
+            addressed: true,
+            reason: 'wake',
+            nextState: {
+                engagedSpeakerId: options.speakerId,
+                lastAgentRunEndMs: options.state.lastAgentRunEndMs,
+            },
+        };
+    }
+    if (options.state.engagedSpeakerId === options.speakerId &&
+        options.state.lastAgentRunEndMs !== null &&
+        options.nowMs - options.state.lastAgentRunEndMs <= FOLLOW_UP_WINDOW_MS) {
+        return { addressed: true, reason: 'follow_up', nextState: options.state };
+    }
+    return { addressed: false, reason: 'ignore', nextState: options.state };
+}
+//# sourceMappingURL=addressing.js.map

package/dist/trigger/addressing.js.map

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

package/dist/trigger/decide.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @file Pure mapping from jev answers + run state → what the agent does.
+ *
+ * No I/O, no timers, no clocks. jev gives calibrated probabilities; every
+ * product judgment about what those probabilities MEAN lives here, where it
+ * can be table-tested (`decide.test.ts`) and retuned without touching the
+ * question wording.
+ *
+ * Asymmetry to keep in mind when changing thresholds: a false wake makes the
+ * agent talk over people and may run tools on the host's machine; a false
+ * ignore costs the speaker one "Vox, ..." retry. So waking is strict, and
+ * stopping is lenient.
+ */
+import type { RunSnapshot, TriggerAction, TriggerAnswers, TriggerSettings } from './types.js';
+export interface DecideInput {
+    answers: TriggerAnswers;
+    run: RunSnapshot;
+    /** The utterance contains "Vox" / "VoxAgent". Evidence, not a gate. */
+    nameMentioned: boolean;
+    humanCount: number;
+    /** The hold for this burst already timed out — don't hold again. */
+    forceComplete: boolean;
+    /** False while a nudge is pending or cooling down. */
+    canNudge: boolean;
+    settings: TriggerSettings;
+}
+/**
+ * `probabilities.agent` needed before the agent acts. A name or a solo room
+ * is strong prior evidence, so they lower the bar; risk raises it.
+ */
+export declare function wakeThresholdFor(input: DecideInput): number;
+export declare function decide(input: DecideInput): TriggerAction;
+//# sourceMappingURL=decide.d.ts.map

package/dist/trigger/decide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../../src/trigger/decide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAkB,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9G,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,GAAG,EAAE,WAAW,CAAC;IACjB,uEAAuE;IACvE,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,aAAa,EAAE,OAAO,CAAC;IACvB,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;CAC3B;AASD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAQ3D;AAgED,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,aAAa,CAoDxD"}

package/dist/trigger/decide.js

@@ -0,0 +1,133 @@
+/**
+ * @file Pure mapping from jev answers + run state → what the agent does.
+ *
+ * No I/O, no timers, no clocks. jev gives calibrated probabilities; every
+ * product judgment about what those probabilities MEAN lives here, where it
+ * can be table-tested (`decide.test.ts`) and retuned without touching the
+ * question wording.
+ *
+ * Asymmetry to keep in mind when changing thresholds: a false wake makes the
+ * agent talk over people and may run tools on the host's machine; a false
+ * ignore costs the speaker one "Vox, ..." retry. So waking is strict, and
+ * stopping is lenient.
+ */
+const MIN_HOLD_MS = 600;
+const MAX_WAKE_THRESHOLD = 0.95;
+function fmt(value) {
+    return value.toFixed(2);
+}
+/**
+ * `probabilities.agent` needed before the agent acts. A name or a solo room
+ * is strong prior evidence, so they lower the bar; risk raises it.
+ */
+export function wakeThresholdFor(input) {
+    const { settings, answers } = input;
+    let threshold = settings.wakeThreshold;
+    if (input.nameMentioned)
+        threshold = settings.wakeThresholdWithName;
+    else if (input.humanCount <= 1)
+        threshold = settings.wakeThresholdSolo;
+    const riskLevel = Math.round(answers.risk.score);
+    threshold += settings.riskBump * Math.max(0, riskLevel);
+    return Math.min(MAX_WAKE_THRESHOLD, threshold);
+}
+function holdMs(thoughtComplete, settings) {
+    // Less sure the thought is finished → wait longer.
+    const openness = 1 - Math.min(1, thoughtComplete / settings.holdBelow);
+    return Math.round(Math.max(MIN_HOLD_MS, settings.maxHoldMs * openness));
+}
+function decideWhileBusy(input, pAgent, wake) {
+    const { answers, run, settings } = input;
+    const relation = answers.relation;
+    if (!relation) {
+        // Relation wasn't asked (run started between classify and decide).
+        return pAgent >= wake
+            ? { kind: 'supersede', reason: `addressee agent ${fmt(pAgent)}, no relation answer` }
+            : { kind: 'ignore', reason: `busy, addressee agent ${fmt(pAgent)} < ${fmt(wake)}` };
+    }
+    const p = relation.probabilities;
+    // Stopping is lenient: it's cheap to undo and the alternative is the agent
+    // talking over someone. It needs far less "this was for the agent" evidence
+    // than starting work does.
+    const stopFloor = Math.min(wake, settings.stopAddressFloor);
+    if (pAgent >= stopFloor) {
+        if (p.abort_work >= settings.abortThreshold) {
+            return { kind: 'abort', reason: `abort_work ${fmt(p.abort_work)}` };
+        }
+        const stopMass = p.stop_talking + p.abort_work;
+        if (run.status === 'speaking' && stopMass >= settings.stopTalkingThreshold) {
+            return { kind: 'stop_talking', reason: `stop_talking+abort ${fmt(stopMass)} while speaking` };
+        }
+    }
+    if (pAgent < wake) {
+        return { kind: 'ignore', reason: `busy, addressee agent ${fmt(pAgent)} < ${fmt(wake)}` };
+    }
+    if (answers.hypotheticalOrQuoted >= settings.hypotheticalVeto && !input.nameMentioned) {
+        return { kind: 'ignore', reason: `hypothetical ${fmt(answers.hypotheticalOrQuoted)}` };
+    }
+    // Pick among the three "new input for the agent" relations only; the stop
+    // and backchannel mass was handled above / means "nothing to do".
+    const work = [
+        ['append', p.adds_detail],
+        ['supersede', p.redirects],
+        ['queue', p.unrelated],
+    ];
+    const workMass = work.reduce((sum, [, value]) => sum + value, 0);
+    if (p.backchannel >= workMass) {
+        return { kind: 'ignore', reason: `backchannel ${fmt(p.backchannel)}` };
+    }
+    if (!input.forceComplete && answers.thoughtComplete < settings.holdBelow) {
+        return {
+            kind: 'hold',
+            waitMs: holdMs(answers.thoughtComplete, settings),
+            reason: `thought_complete ${fmt(answers.thoughtComplete)}`,
+        };
+    }
+    const [kind, value] = work.reduce((best, next) => (next[1] > best[1] ? next : best));
+    return { kind, reason: `addressee agent ${fmt(pAgent)}, relation ${kind} ${fmt(value)}` };
+}
+export function decide(input) {
+    const { answers, settings } = input;
+    const pAgent = answers.addressee.probabilities.agent ?? 0;
+    const wake = wakeThresholdFor(input);
+    if (input.run.status !== 'idle')
+        return decideWhileBusy(input, pAgent, wake);
+    const vetoed = answers.hypotheticalOrQuoted >= settings.hypotheticalVeto && !input.nameMentioned;
+    if (pAgent >= wake && !vetoed) {
+        if (!input.forceComplete && answers.thoughtComplete < settings.holdBelow) {
+            return {
+                kind: 'hold',
+                waitMs: holdMs(answers.thoughtComplete, settings),
+                reason: `addressee agent ${fmt(pAgent)}, thought_complete ${fmt(answers.thoughtComplete)}`,
+            };
+        }
+        return { kind: 'run', reason: `addressee agent ${fmt(pAgent)} >= ${fmt(wake)}` };
+    }
+    if (vetoed) {
+        return { kind: 'ignore', reason: `hypothetical ${fmt(answers.hypotheticalOrQuoted)}` };
+    }
+    // Nothing below speaks. A nudge is a pill on the agent tile.
+    const thoughtDone = input.forceComplete || answers.thoughtComplete >= settings.holdBelow;
+    if (input.canNudge && thoughtDone) {
+        if (pAgent >= settings.nudgeFloor) {
+            return {
+                kind: 'nudge',
+                nudgeKind: 'unsure',
+                reason: `addressee agent ${fmt(pAgent)} in [${fmt(settings.nudgeFloor)}, ${fmt(wake)})`,
+            };
+        }
+        const openFloor = answers.addressee.choice === 'group' || answers.addressee.choice === 'nobody';
+        if (settings.proactive === 'nudge' &&
+            openFloor &&
+            answers.isRequest >= settings.proactiveThreshold &&
+            answers.agentCapable >= settings.proactiveThreshold) {
+            return {
+                kind: 'nudge',
+                nudgeKind: 'offer',
+                reason: `open request ${fmt(answers.isRequest)}, agent_capable ${fmt(answers.agentCapable)}`,
+            };
+        }
+    }
+    return { kind: 'ignore', reason: `addressee agent ${fmt(pAgent)} < ${fmt(wake)}` };
+}
+//# sourceMappingURL=decide.js.map

package/dist/trigger/decide.js.map

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

package/dist/trigger/effort.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @file Effort score → per-run model routing ("Auto" in the model picker).
+ *
+ * jev judges effort from the utterance alone — it can't see the repo, so
+ * "fix the login bug" is genuinely uncertain. We therefore err UPWARD: take
+ * the highest level that still carries real probability rather than the mean.
+ * An over-provisioned turn costs a little; an under-provisioned one fails in
+ * front of the room.
+ */
+import type { AgentBackend } from '../protocol.js';
+import type { RunPlan, ScoreAnswer } from './types.js';
+export declare function pickEffortLevel(effort: ScoreAnswer): number;
+/**
+ * Parses `VOXAGENT_AUTO_MODELS=a,b,c,d` — one model per effort level, low to
+ * high. Returns `null` for anything that isn't exactly four entries.
+ */
+export declare function parseAutoModels(raw: string | undefined): string[] | null;
+export declare function planRun(options: {
+    effort: ScoreAnswer | null;
+    backend: AgentBackend;
+    /** True when the host picked "Auto" (`--llm-model auto`). */
+    autoModel: boolean;
+    modelOverrides?: string[] | null;
+    ack?: boolean;
+}): RunPlan;
+//# sourceMappingURL=effort.d.ts.map

package/dist/trigger/effort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effort.d.ts","sourceRoot":"","sources":["../../src/trigger/effort.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgCvD,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAK3D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,IAAI,CAIxE;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE;IAC/B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACjC,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAiBV"}

package/dist/trigger/effort.js

@@ -0,0 +1,66 @@
+/**
+ * @file Effort score → per-run model routing ("Auto" in the model picker).
+ *
+ * jev judges effort from the utterance alone — it can't see the repo, so
+ * "fix the login bug" is genuinely uncertain. We therefore err UPWARD: take
+ * the highest level that still carries real probability rather than the mean.
+ * An over-provisioned turn costs a little; an under-provisioned one fails in
+ * front of the room.
+ */
+/** A level needs at least this much probability to be picked. */
+const LEVEL_FLOOR = 0.25;
+/** At/above this level the agent says something before the LLM's first token. */
+const ACK_FROM_LEVEL = 2;
+const ACK_LINE = 'On it.';
+/**
+ * Claude rungs are CLI aliases, not dated IDs, so Auto follows whatever the
+ * host's Claude Code considers current.
+ */
+const CLAUDE_LADDER = [
+    { model: 'haiku' },
+    { model: 'sonnet' },
+    { model: 'sonnet', maxThinkingTokens: 8_000 },
+    { model: 'opus', maxThinkingTokens: 16_000 },
+];
+const CODEX_LADDER = [
+    { model: 'gpt-5.4-mini', reasoningEffort: 'low' },
+    { model: 'gpt-5.4', reasoningEffort: 'low' },
+    { model: 'gpt-5.4', reasoningEffort: 'medium' },
+    { model: 'gpt-5.4', reasoningEffort: 'high' },
+];
+export function pickEffortLevel(effort) {
+    for (let level = effort.probabilities.length - 1; level >= 0; level -= 1) {
+        if ((effort.probabilities[level] ?? 0) >= LEVEL_FLOOR)
+            return level;
+    }
+    return Math.round(effort.score);
+}
+/**
+ * Parses `VOXAGENT_AUTO_MODELS=a,b,c,d` — one model per effort level, low to
+ * high. Returns `null` for anything that isn't exactly four entries.
+ */
+export function parseAutoModels(raw) {
+    if (!raw)
+        return null;
+    const models = raw.split(',').map((value) => value.trim()).filter(Boolean);
+    return models.length === 4 ? models : null;
+}
+export function planRun(options) {
+    // No classifier answer (regex fallback): assume a real task.
+    const effortLevel = options.effort ? pickEffortLevel(options.effort) : ACK_FROM_LEVEL;
+    const plan = { effortLevel };
+    if (options.autoModel) {
+        const ladder = options.backend === 'codex' ? CODEX_LADDER : CLAUDE_LADDER;
+        const rung = ladder[Math.min(effortLevel, ladder.length - 1)] ?? ladder[ladder.length - 1];
+        plan.model = options.modelOverrides?.[effortLevel] ?? rung.model;
+        if (rung.maxThinkingTokens !== undefined)
+            plan.maxThinkingTokens = rung.maxThinkingTokens;
+        if (rung.reasoningEffort !== undefined)
+            plan.reasoningEffort = rung.reasoningEffort;
+    }
+    if (options.ack !== false && options.effort && effortLevel >= ACK_FROM_LEVEL) {
+        plan.ack = ACK_LINE;
+    }
+    return plan;
+}
+//# sourceMappingURL=effort.js.map

package/dist/trigger/effort.js.map

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

package/dist/trigger/engine.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @file Trigger engine — turns a stream of finalized transcript lines into
+ * agent actions.
+ *
+ * Owns the state a pure function can't: the transcript window, the utterance
+ * being held while a speaker finishes a thought, the pending nudge, and the
+ * classifier circuit breaker. All judgment lives in `decide.ts`; all I/O goes
+ * through the injected `Classifier` and `TriggerHost`, so this file has no
+ * transport or network imports and runs under fake timers in tests.
+ *
+ * Ordering: lines are processed one at a time through a promise chain. A
+ * speaker's second fragment must see the hold created by their first, and a
+ * classifier call takes 100-500 ms — without serialization "Hey Vox, can you"
+ * + "check the logs" would race into two runs. Hard stops bypass the chain.
+ */
+import type { AgentAttentionEvent, AgentBackend, AgentTriggerDecisionEvent, PromptDisposition } from '../protocol.js';
+import { type AgentDescriptor, type Classifier, type RoomInfo, type RunPlan, type RunSnapshot, type TranscriptLine, type TriggerSettings } from './types.js';
+export interface TriggerPrompt {
+    promptId: string;
+    speaker: string;
+    speakerIdentity: string;
+    /** The merged burst. */
+    text: string;
+    window: TranscriptLine[];
+    room: RoomInfo;
+    disposition: PromptDisposition;
+    plan: RunPlan;
+}
+/** What the engine needs from the runtime that hosts it. */
+export interface TriggerHost {
+    getRunSnapshot(): RunSnapshot;
+    startRun(prompt: TriggerPrompt): void;
+    /** Silence TTS, keep the run going. */
+    stopTalking(): void;
+    /** Cancel the active run and anything queued. */
+    abort(): void;
+    publishAttention(event: Omit<AgentAttentionEvent, 'type'>): void;
+    publishDecision(event: Omit<AgentTriggerDecisionEvent, 'type'>): void;
+}
+export interface TimerApi {
+    set(callback: () => void, ms: number): unknown;
+    clear(handle: unknown): void;
+}
+export interface TriggerEngineOptions {
+    /** `shadow`: the regex decides, jev's verdict is only reported. */
+    mode: 'jev' | 'regex' | 'shadow';
+    classifier: Classifier | null;
+    host: TriggerHost;
+    agent: AgentDescriptor;
+    /** Participant identity of the bridge host, for the host-authority rule. */
+    hostIdentity: string | null;
+    backend: AgentBackend;
+    autoModel: boolean;
+    modelOverrides?: string[] | null;
+    ack?: boolean;
+    settings?: Partial<TriggerSettings>;
+    now?: () => number;
+    timers?: TimerApi;
+    newId?: () => string;
+}
+export interface FinalLineInput {
+    entryId: string;
+    speaker: string;
+    speakerIdentity: string;
+    text: string;
+    timestampMs: number;
+    confidence?: number;
+    room: RoomInfo;
+}
+export declare class TriggerEngine {
+    private readonly options;
+    private readonly settings;
+    private readonly now;
+    private readonly timers;
+    private readonly newId;
+    private window;
+    private seenEntryIds;
+    private chain;
+    private hold;
+    private pendingNudge;
+    private lastNudgeAtMs;
+    private lastActivityAtMs;
+    private lastAgentText;
+    private lastAgentSpokeAtMs;
+    private addressingState;
+    private consecutiveFailures;
+    private breakerOpenUntilMs;
+    private disposed;
+    constructor(options: TriggerEngineOptions);
+    /** Resolves once this line (and everything queued before it) is handled. */
+    onFinal(input: FinalLineInput): Promise<void>;
+    /** Interim speech from a speaker — keeps their hold open while they talk. */
+    onSpeechActivity(speakerIdentity: string): void;
+    onNudgeResponse(nudgeId: string, decision: 'accept' | 'dismiss'): void;
+    /** The agent finished saying something; keeps it in the classifier's view. */
+    noteAgentSaid(text: string): void;
+    noteRunEnded(): void;
+    dispose(): void;
+    private rememberEntry;
+    private pushWindow;
+    private process;
+    private classifierUsable;
+    private classify;
+    private chooseAction;
+    private decideByRegex;
+    private canNudge;
+    private apply;
+    private onHoldTimer;
+    private resolveHold;
+    private clearHold;
+    /** Drops the hold and retires the Listening state on every browser. */
+    private releaseHold;
+    private buildPlan;
+    private startRun;
+    private startNudge;
+    private acceptNudge;
+    private endNudge;
+    private publishDecision;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/trigger/engine.d.ts.map

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