@kuralle-syrinx/core 4.4.0 → 4.5.0

package/dist/init-chain.js

@@ -0,0 +1,102 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Init Chain
+//
+// Serial initialization of pipeline components with ordered teardown on failure.
+// Each step runs synchronously in order. On failure, already-initialized steps
+// are torn down in reverse order.
+import { Route } from "./pipeline-bus.js";
+import { ErrorCategory } from "./packets.js";
+// =============================================================================
+// Error
+// =============================================================================
+export class InitializationError extends Error {
+    stage;
+    component;
+    constructor(stage, component, cause) {
+        super(`Initialization failed at ${stage}/${component}: ${cause.message}`);
+        this.stage = stage;
+        this.component = component;
+        this.name = "InitializationError";
+    }
+}
+// =============================================================================
+// Core
+// =============================================================================
+/**
+ * Run a serial init chain. Each step runs in order. On failure:
+ * 1. Emits InitializationFailedPacket through the bus.
+ * 2. Tears down already-initialized steps in reverse order.
+ * 3. Throws InitializationError.
+ *
+ * On success:
+ * 1. Emits InitStepCompletedPacket for each step (with initMs).
+ * 2. Emits InitializationCompletedPacket.
+ */
+export async function runInitChain(bus, steps) {
+    const initialized = [];
+    for (const step of steps) {
+        const startMs = performance.now();
+        try {
+            await step.run();
+            const initMs = performance.now() - startMs;
+            const completed = {
+                kind: "init.step_completed",
+                contextId: "",
+                timestampMs: Date.now(),
+                stage: step.stage,
+                component: step.name,
+                initMs,
+            };
+            bus.push(Route.Main, completed);
+            initialized.push(step);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            const failed = {
+                kind: "init.failed",
+                contextId: "",
+                timestampMs: Date.now(),
+                stage: step.stage,
+                component: step.name,
+                category: ErrorCategory.InternalFault,
+                cause: error,
+                isRecoverable: false,
+            };
+            bus.push(Route.Main, failed);
+            // Reverse teardown of already-initialized steps
+            for (const done of [...initialized].reverse()) {
+                try {
+                    await done.cleanup?.();
+                }
+                catch (cleanupErr) {
+                    // Log but don't throw — cleanup failures shouldn't mask the init error
+                    // In production, this goes to the bus as a warning
+                }
+            }
+            throw new InitializationError(step.stage, step.name, error);
+        }
+    }
+    const completed = {
+        kind: "init.completed",
+        contextId: "",
+        timestampMs: Date.now(),
+    };
+    bus.push(Route.Main, completed);
+}
+/**
+ * Run a reverse finalize chain. Steps are torn down in reverse order.
+ * Errors during teardown are logged but do not stop the chain.
+ * All steps get their cleanup called regardless of earlier failures.
+ */
+export async function runFinalizeChain(steps) {
+    for (const step of [...steps].reverse()) {
+        try {
+            await step.cleanup?.();
+        }
+        catch {
+            // Log but continue — finalize must complete
+        }
+    }
+}
+//# sourceMappingURL=init-chain.js.map

package/dist/init-chain.js.map

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

package/dist/init-stage-order.d.ts

@@ -0,0 +1,5 @@
+import { InitStage } from "./packets.js";
+export declare function pluginStage(name: string): InitStage;
+export declare function stageOrder(stage: InitStage): number;
+export declare function isAudioStage(stage: InitStage): boolean;
+//# sourceMappingURL=init-stage-order.d.ts.map

package/dist/init-stage-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-stage-order.d.ts","sourceRoot":"","sources":["../src/init-stage-order.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CA4BnD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CA2BnD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAQtD"}

package/dist/init-stage-order.js

@@ -0,0 +1,74 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Init Stage Ordering
+//
+// Pure mapping from plugin name → init stage, and the deterministic order in
+// which stages initialize (and, reversed, finalize). Extracted from
+// VoiceAgentSession so the orchestrator owns chain assembly, not the ordering
+// policy.
+import { InitStage } from "./packets.js";
+export function pluginStage(name) {
+    switch (name) {
+        case "stt":
+        case "deepgram":
+            return InitStage.STT;
+        case "tts":
+        case "cartesia":
+        case "elevenlabs":
+            return InitStage.TTS;
+        case "vad":
+        case "silero":
+            return InitStage.VAD;
+        case "eos":
+        case "pipecat":
+            return InitStage.EOS;
+        case "denoiser":
+        case "rnnoise":
+            return InitStage.Denoiser;
+        case "bridge":
+        case "aisdk":
+            return InitStage.Assistant;
+        case "recorder":
+            return InitStage.Recorder;
+        case "auth":
+            return InitStage.Auth;
+        default:
+            return InitStage.Assistant;
+    }
+}
+export function stageOrder(stage) {
+    switch (stage) {
+        case InitStage.Assistant:
+            return 10;
+        case InitStage.Conversation:
+            return 20;
+        case InitStage.Recorder:
+            return 30;
+        case InitStage.Normalizer:
+            return 40;
+        case InitStage.Auth:
+            return 50;
+        case InitStage.STT:
+            return 60;
+        case InitStage.TTS:
+            return 70;
+        case InitStage.VAD:
+            return 80;
+        case InitStage.EOS:
+            return 90;
+        case InitStage.Denoiser:
+            return 100;
+        case InitStage.Behavior:
+            return 110;
+        case InitStage.Telemetry:
+            return 120;
+    }
+}
+export function isAudioStage(stage) {
+    return (stage === InitStage.STT ||
+        stage === InitStage.TTS ||
+        stage === InitStage.VAD ||
+        stage === InitStage.EOS ||
+        stage === InitStage.Denoiser);
+}
+//# sourceMappingURL=init-stage-order.js.map

package/dist/init-stage-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-stage-order.js","sourceRoot":"","sources":["../src/init-stage-order.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,yCAAyC;AACzC,EAAE;AACF,6EAA6E;AAC7E,oEAAoE;AACpE,8EAA8E;AAC9E,UAAU;AAEV,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,KAAK,CAAC;QACX,KAAK,UAAU;YACb,OAAO,SAAS,CAAC,GAAG,CAAC;QACvB,KAAK,KAAK,CAAC;QACX,KAAK,UAAU,CAAC;QAChB,KAAK,YAAY;YACf,OAAO,SAAS,CAAC,GAAG,CAAC;QACvB,KAAK,KAAK,CAAC;QACX,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,GAAG,CAAC;QACvB,KAAK,KAAK,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC,GAAG,CAAC;QACvB,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC,QAAQ,CAAC;QAC5B,KAAK,QAAQ,CAAC;QACd,KAAK,OAAO;YACV,OAAO,SAAS,CAAC,SAAS,CAAC;QAC7B,KAAK,UAAU;YACb,OAAO,SAAS,CAAC,QAAQ,CAAC;QAC5B,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,IAAI,CAAC;QACxB;YACE,OAAO,SAAS,CAAC,SAAS,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAgB;IACzC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,SAAS,CAAC,SAAS;YACtB,OAAO,EAAE,CAAC;QACZ,KAAK,SAAS,CAAC,YAAY;YACzB,OAAO,EAAE,CAAC;QACZ,KAAK,SAAS,CAAC,QAAQ;YACrB,OAAO,EAAE,CAAC;QACZ,KAAK,SAAS,CAAC,UAAU;YACvB,OAAO,EAAE,CAAC;QACZ,KAAK,SAAS,CAAC,IAAI;YACjB,OAAO,EAAE,CAAC;QACZ,KAAK,SAAS,CAAC,GAAG;YAChB,OAAO,EAAE,CAAC;QACZ,KAAK,SAAS,CAAC,GAAG;YAChB,OAAO,EAAE,CAAC;QACZ,KAAK,SAAS,CAAC,GAAG;YAChB,OAAO,EAAE,CAAC;QACZ,KAAK,SAAS,CAAC,GAAG;YAChB,OAAO,EAAE,CAAC;QACZ,KAAK,SAAS,CAAC,QAAQ;YACrB,OAAO,GAAG,CAAC;QACb,KAAK,SAAS,CAAC,QAAQ;YACrB,OAAO,GAAG,CAAC;QACb,KAAK,SAAS,CAAC,SAAS;YACtB,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAgB;IAC3C,OAAO,CACL,KAAK,KAAK,SAAS,CAAC,GAAG;QACvB,KAAK,KAAK,SAAS,CAAC,GAAG;QACvB,KAAK,KAAK,SAAS,CAAC,GAAG;QACvB,KAAK,KAAK,SAAS,CAAC,GAAG;QACvB,KAAK,KAAK,SAAS,CAAC,QAAQ,CAC7B,CAAC;AACJ,CAAC"}

package/dist/interaction-coordinator.d.ts

@@ -0,0 +1,45 @@
+import type { VadAudioPacket } from "./packets.js";
+import type { TurnEndOwner } from "./packets.js";
+import type { PipelineBus } from "./pipeline-bus.js";
+import type { InteractionObservation, InteractionPolicy } from "./interaction-policy.js";
+import type { TurnArbiter } from "./turn-arbiter.js";
+import { type Scheduler } from "./scheduler.js";
+export interface InteractionCaps {
+    readonly emitsBackchannel?: boolean;
+}
+export declare class InteractionCoordinator {
+    private readonly deps;
+    private readonly disposers;
+    private readonly pendingTakeTurns;
+    private readonly transcriptsByContext;
+    private readonly interimByContext;
+    private readonly scheduler;
+    constructor(deps: {
+        bus: PipelineBus;
+        policy: InteractionPolicy;
+        executor: TurnArbiter;
+        caps: InteractionCaps;
+        scheduler?: Scheduler;
+        isUserSpeaking?: () => boolean;
+        isTtsActive?: () => boolean;
+        hasCueAsset?: (cueId: string) => boolean;
+        onBackchannelEmitted?: (contextId: string) => void;
+        /** Session's configured endpointing owner — labels every eos this coordinator emits. */
+        endpointingOwner?: TurnEndOwner;
+        /** True when the STT force-finalize watchdog already fired for this context. */
+        wasForceFinalized?: (contextId: string) => boolean;
+    });
+    initialize(): void;
+    dispose(): void;
+    observe(obs: InteractionObservation): void;
+    observeBargeInAudio(pkt: VadAudioPacket): boolean;
+    private apply;
+    private armTakeTurn;
+    private handleSttInterim;
+    private handleSttResult;
+    private tryScheduleTurnComplete;
+    private revokePendingTakeTurn;
+    private applyBackchannel;
+    reset(contextId: string): void;
+}
+//# sourceMappingURL=interaction-coordinator.d.ts.map

package/dist/interaction-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-coordinator.d.ts","sourceRoot":"","sources":["../src/interaction-coordinator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAqC,YAAY,EAAiB,MAAM,cAAc,CAAC;AAEnG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAuB,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC9G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAUD,qBAAa,sBAAsB;IAQ/B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsC;IACvE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAwC;IAC7E,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAGnB,IAAI,EAAE;QACrB,GAAG,EAAE,WAAW,CAAC;QACjB,MAAM,EAAE,iBAAiB,CAAC;QAC1B,QAAQ,EAAE,WAAW,CAAC;QACtB,IAAI,EAAE,eAAe,CAAC;QACtB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;QAC/B,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;QAC5B,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;QACzC,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;QACnD,wFAAwF;QACxF,gBAAgB,CAAC,EAAE,YAAY,CAAC;QAChC,gFAAgF;QAChF,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;KACpD;IAKH,UAAU,IAAI,IAAI;IAelB,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,GAAG,EAAE,sBAAsB,GAAG,IAAI;IAM1C,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO;IAajD,OAAO,CAAC,KAAK;IAoBb,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,uBAAuB;IAwC/B,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,gBAAgB;IA6BxB,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAM/B"}

package/dist/interaction-coordinator.js

@@ -0,0 +1,197 @@
+// SPDX-License-Identifier: MIT
+import { Route } from "./pipeline-bus.js";
+import { confidenceToWaitMs } from "./confidence-to-wait.js";
+import { RuleBasedInteractionPolicy } from "./policies/rule-based.js";
+import { TimerScheduler } from "./scheduler.js";
+import * as make from "./packet-factories.js";
+export class InteractionCoordinator {
+    deps;
+    disposers = [];
+    pendingTakeTurns = new Map();
+    transcriptsByContext = new Map();
+    interimByContext = new Map();
+    scheduler;
+    constructor(deps) {
+        this.deps = deps;
+        this.scheduler = deps.scheduler ?? new TimerScheduler();
+    }
+    initialize() {
+        const { bus } = this.deps;
+        this.disposers.push(bus.on("stt.result", (pkt) => {
+            this.handleSttResult(pkt);
+        }), bus.on("stt.interim", (pkt) => {
+            this.handleSttInterim(pkt);
+        }), bus.on("vad.speech_started", (pkt) => {
+            this.revokePendingTakeTurn(pkt.contextId);
+        }));
+    }
+    dispose() {
+        for (const contextId of this.pendingTakeTurns.keys()) {
+            this.revokePendingTakeTurn(contextId);
+        }
+        for (const dispose of this.disposers.splice(0)) {
+            dispose();
+        }
+        this.transcriptsByContext.clear();
+        this.interimByContext.clear();
+    }
+    observe(obs) {
+        for (const d of this.deps.policy.observe(obs)) {
+            this.apply(d, obs);
+        }
+    }
+    observeBargeInAudio(pkt) {
+        this.observe({
+            kind: "vad_barge_in_audio",
+            contextId: pkt.contextId,
+            timestampMs: pkt.timestampMs,
+            audio: pkt.audio,
+        });
+        if (this.deps.policy instanceof RuleBasedInteractionPolicy) {
+            return this.deps.policy.takeBargeInAudioConsumed();
+        }
+        return this.deps.executor.observeBargeInAudio(pkt);
+    }
+    apply(d, obs) {
+        switch (d.kind) {
+            case "take_turn":
+                this.armTakeTurn(obs.contextId, d.confidence, d.waitMs, obs.timestampMs);
+                break;
+            case "hold":
+            case "keep_listening":
+                this.revokePendingTakeTurn(obs.contextId);
+                break;
+            case "interrupt":
+                this.deps.executor.emitInterruptDetected(d.interruptedContextId);
+                break;
+            case "backchannel":
+                this.applyBackchannel(d, obs);
+                break;
+            default:
+                break;
+        }
+    }
+    armTakeTurn(contextId, confidence, waitMs, timestampMs) {
+        const existing = this.pendingTakeTurns.get(contextId);
+        const pending = existing ?? {
+            confidence,
+            transcripts: [...(this.transcriptsByContext.get(contextId) ?? [])],
+            latestInterim: this.interimByContext.get(contextId) ?? "",
+            finalizeRequested: false,
+        };
+        pending.confidence = confidence;
+        pending.waitMs = waitMs;
+        this.pendingTakeTurns.set(contextId, pending);
+        if (!pending.finalizeRequested) {
+            pending.finalizeRequested = true;
+            this.deps.bus.push(Route.Critical, make.finalizeStt(contextId, timestampMs));
+        }
+        this.tryScheduleTurnComplete(contextId);
+    }
+    handleSttInterim(pkt) {
+        const text = pkt.text.trim();
+        if (!text)
+            return;
+        this.interimByContext.set(pkt.contextId, text);
+        const pending = this.pendingTakeTurns.get(pkt.contextId);
+        if (pending)
+            pending.latestInterim = text;
+    }
+    handleSttResult(pkt) {
+        const text = pkt.text.trim();
+        if (!text)
+            return;
+        const transcripts = this.transcriptsByContext.get(pkt.contextId) ?? [];
+        if (transcripts.at(-1)?.text.trim() !== text) {
+            transcripts.push(pkt);
+            this.transcriptsByContext.set(pkt.contextId, transcripts);
+        }
+        this.interimByContext.delete(pkt.contextId);
+        const pending = this.pendingTakeTurns.get(pkt.contextId);
+        if (!pending)
+            return;
+        pending.transcripts = [...transcripts];
+        pending.latestInterim = "";
+        this.tryScheduleTurnComplete(pkt.contextId);
+    }
+    tryScheduleTurnComplete(contextId) {
+        const pending = this.pendingTakeTurns.get(contextId);
+        if (!pending)
+            return;
+        // Anchor the finalize timer at the policy's commitment even before any text
+        // exists — the callback reads live transcript/interim state at fire time and
+        // is the sole gate on whether the turn actually completes.
+        const delayMs = pending.waitMs ?? confidenceToWaitMs(pending.confidence);
+        const timerKey = takeTurnTimerKey(contextId);
+        this.scheduler.cancel(timerKey);
+        this.scheduler.schedule(timerKey, delayMs, () => {
+            const live = this.pendingTakeTurns.get(contextId);
+            if (!live)
+                return;
+            const finalText = joinTranscript(live.transcripts, live.latestInterim);
+            // The policy committed to this turn. Prefer real STT finals; if none ever
+            // arrived, fall back to the latest interim so a committed turn is never
+            // silently dropped. Only bail when there is genuinely nothing to commit.
+            if (!finalText)
+                return;
+            this.pendingTakeTurns.delete(contextId);
+            const transcripts = live.transcripts.length > 0
+                ? live.transcripts
+                : [{ kind: "stt.result", contextId, timestampMs: Date.now(), text: finalText, confidence: 0 }];
+            // The policy committed to this turn, so the endpointing decision is genuinely
+            // known here — label who decided and why. A force-finalize watchdog firing
+            // underneath us is a different diagnosis from a natural endpoint.
+            const configuredOwner = this.deps.endpointingOwner;
+            const forced = this.deps.wasForceFinalized?.(contextId) === true;
+            const reason = forced ? "force_finalized" : "end_of_speech";
+            const endpointing = configuredOwner === undefined ? undefined : { owner: configuredOwner, reason };
+            this.deps.bus.push(Route.Main, make.eosTurnComplete(contextId, Date.now(), finalText, transcripts, endpointing));
+        });
+    }
+    revokePendingTakeTurn(contextId) {
+        if (!this.pendingTakeTurns.has(contextId))
+            return;
+        this.scheduler.cancel(takeTurnTimerKey(contextId));
+        this.pendingTakeTurns.delete(contextId);
+    }
+    applyBackchannel(d, obs) {
+        const contextId = obs.contextId;
+        this.deps.bus.push(Route.Background, make.metric(contextId, "backchannel.candidate", d.cue));
+        if (this.deps.caps.emitsBackchannel) {
+            this.deps.bus.push(Route.Background, make.metric(contextId, "backchannel.suppressed_caps", d.cue));
+            return;
+        }
+        if (this.deps.isTtsActive?.()) {
+            this.deps.bus.push(Route.Background, make.metric(contextId, "backchannel.suppressed_tts_active", d.cue));
+            return;
+        }
+        if (this.deps.isUserSpeaking?.()) {
+            this.deps.bus.push(Route.Background, make.metric(contextId, "backchannel.suppressed_user_speaking", d.cue));
+            return;
+        }
+        if (this.deps.hasCueAsset && !this.deps.hasCueAsset(d.cue)) {
+            this.deps.bus.push(Route.Background, make.metric(contextId, "backchannel.suppressed_missing_asset", d.cue));
+            return;
+        }
+        this.deps.bus.push(Route.Main, make.interactionBackchannel(contextId, Date.now(), d.cue));
+        this.deps.bus.push(Route.Background, make.metric(contextId, "backchannel.emitted", d.cue));
+        this.deps.onBackchannelEmitted?.(contextId);
+    }
+    reset(contextId) {
+        this.revokePendingTakeTurn(contextId);
+        this.transcriptsByContext.delete(contextId);
+        this.interimByContext.delete(contextId);
+        this.deps.policy.reset(contextId);
+    }
+}
+function takeTurnTimerKey(contextId) {
+    return `interaction.take_turn:${contextId}`;
+}
+function joinTranscript(transcripts, interim) {
+    const segments = [
+        ...transcripts.map((t) => t.text.trim()),
+        ...(interim ? [interim.trim()] : []),
+    ].filter(Boolean);
+    return segments.join(" ").replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=interaction-coordinator.js.map

package/dist/interaction-coordinator.js.map

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

package/dist/interaction-policy.d.ts

@@ -0,0 +1,103 @@
+import type { AcousticSignal } from "./packets.js";
+export interface WordTiming {
+    readonly word: string;
+    readonly startMs: number;
+    readonly endMs: number;
+    readonly confidence: number;
+}
+export type InteractionObservation = {
+    readonly kind: "vad_speech_started";
+    readonly contextId: string;
+    readonly timestampMs: number;
+    readonly confidence: number;
+    readonly interruptedContextId?: string;
+} | {
+    readonly kind: "vad_speech_activity";
+    readonly contextId: string;
+    readonly timestampMs: number;
+} | {
+    readonly kind: "vad_speech_ended";
+    readonly contextId: string;
+    readonly timestampMs: number;
+    readonly hasActiveTts: boolean;
+} | {
+    readonly kind: "vad_barge_in_audio";
+    readonly contextId: string;
+    readonly timestampMs: number;
+    readonly audio: Uint8Array;
+} | {
+    readonly kind: "stt_partial";
+    readonly contextId: string;
+    readonly timestampMs: number;
+    readonly text: string;
+    readonly confidence?: number;
+    readonly interruptedContextId?: string;
+    readonly wordTimings?: readonly WordTiming[];
+} | {
+    readonly kind: "stt_final";
+    readonly contextId: string;
+    readonly timestampMs: number;
+    readonly text: string;
+    readonly confidence?: number;
+    readonly interruptedContextId?: string;
+    readonly wordTimings?: readonly WordTiming[];
+} | {
+    readonly kind: "audio_frame";
+    readonly contextId: string;
+    readonly timestampMs: number;
+    readonly audio?: Int16Array;
+    readonly sampleRateHz?: number;
+    readonly wordTimings?: readonly WordTiming[];
+    readonly prosody?: Float32Array;
+} | {
+    readonly kind: "playout_tick";
+    readonly contextId: string;
+    readonly timestampMs: number;
+    readonly playedOutMs?: number;
+    readonly ttsActive?: boolean;
+    /** PCM queued for assistant playout. Present on audio-bearing ticks. */
+    readonly audio?: Int16Array;
+    readonly sampleRateHz?: number;
+} | {
+    readonly kind: "delegate_state";
+    readonly contextId: string;
+    readonly timestampMs: number;
+    readonly delegateInFlight?: boolean;
+    readonly toolCallPhase?: "started" | "delayed" | "complete" | "failed";
+};
+export type InteractionDecision = {
+    readonly kind: "keep_listening";
+} | {
+    readonly kind: "take_turn";
+    readonly confidence: number;
+    readonly waitMs?: number;
+}
+/** `cue` is a stable pre-cached asset id (e.g. `mm_hmm`), not free-form text. */
+ | {
+    readonly kind: "backchannel";
+    readonly cue: string;
+} | {
+    readonly kind: "hold";
+} | {
+    readonly kind: "interrupt";
+    readonly interruptedContextId: string;
+};
+export interface AcousticSignalObservation {
+    readonly contextId: string;
+    readonly timestampMs: number;
+    readonly signal: AcousticSignal;
+    readonly payload?: Readonly<Record<string, unknown>>;
+}
+export type AcousticSignalSink = (signal: AcousticSignalObservation) => void;
+export interface InteractionPolicy {
+    observe(obs: InteractionObservation): readonly InteractionDecision[];
+    reset(contextId: string): void;
+    setAcousticSignalSink?(sink: AcousticSignalSink): void;
+}
+/** Optional lifecycle for externally supplied model policies (session-owned). */
+export interface LifecycleInteractionPolicy extends InteractionPolicy {
+    initialize(config: Record<string, unknown>): Promise<void>;
+    close(): Promise<void>;
+}
+export declare function isLifecycleInteractionPolicy(policy: InteractionPolicy): policy is LifecycleInteractionPolicy;
+//# sourceMappingURL=interaction-policy.d.ts.map

package/dist/interaction-policy.d.ts.map

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

package/dist/interaction-policy.js

@@ -0,0 +1,6 @@
+// SPDX-License-Identifier: MIT
+export function isLifecycleInteractionPolicy(policy) {
+    const candidate = policy;
+    return typeof candidate.initialize === "function" && typeof candidate.close === "function";
+}
+//# sourceMappingURL=interaction-policy.js.map

package/dist/interaction-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-policy.js","sourceRoot":"","sources":["../src/interaction-policy.ts"],"names":[],"mappings":"AAAA,+BAA+B;AA8G/B,MAAM,UAAU,4BAA4B,CAC1C,MAAyB;IAEzB,MAAM,SAAS,GAAG,MAAoC,CAAC;IACvD,OAAO,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU,CAAC;AAC7F,CAAC"}

package/dist/iu-ledger.d.ts

@@ -0,0 +1,39 @@
+import type { IncrementalUnit, IncrementalUnitId, IuState } from "./incremental-unit.js";
+export interface IuLedger {
+    add(iu: IncrementalUnit): void;
+    commit(id: IncrementalUnitId, prefix?: {
+        chars?: number;
+        ms?: number;
+    }): void;
+    revoke(id: IncrementalUnitId): void;
+    get(id: IncrementalUnitId): IncrementalUnit | undefined;
+    latest(contextId: string, kind: IncrementalUnit["kind"]): IncrementalUnit | undefined;
+    clear(contextId: string): void;
+}
+export type IuLedgerAnomaly = {
+    readonly kind: "terminal_op";
+    readonly op: "commit" | "revoke";
+    readonly id: IncrementalUnitId;
+    readonly state: IuState;
+} | {
+    readonly kind: "unknown_iu";
+    readonly op: "commit" | "revoke";
+    readonly id: IncrementalUnitId;
+};
+export declare class InMemoryIuLedger implements IuLedger {
+    private readonly onEvent;
+    private readonly maxContexts;
+    private readonly byCtx;
+    constructor(onEvent?: (a: IuLedgerAnomaly) => void, maxContexts?: number);
+    add(iu: IncrementalUnit): void;
+    commit(id: IncrementalUnitId, prefix?: {
+        chars?: number;
+        ms?: number;
+    }): void;
+    revoke(id: IncrementalUnitId): void;
+    get(id: IncrementalUnitId): IncrementalUnit | undefined;
+    latest(contextId: string, kind: IncrementalUnit["kind"]): IncrementalUnit | undefined;
+    clear(contextId: string): void;
+    private ctxMap;
+}
+//# sourceMappingURL=iu-ledger.d.ts.map

package/dist/iu-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iu-ledger.d.ts","sourceRoot":"","sources":["../src/iu-ledger.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEzF,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9E,MAAM,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,GAAG,CAAC,EAAE,EAAE,iBAAiB,GAAG,eAAe,GAAG,SAAS,CAAC;IACxD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,eAAe,GAAG,SAAS,CAAC;IACtF,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC3H;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEtG,qBAAa,gBAAiB,YAAW,QAAQ;IAI7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAJ9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmD;gBAGtD,OAAO,GAAE,CAAC,CAAC,EAAE,eAAe,KAAK,IAAe,EAChD,WAAW,GAAE,MAAY;IAG5C,GAAG,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAS9B,MAAM,CAAC,EAAE,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAqB7E,MAAM,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI;IAkBnC,GAAG,CAAC,EAAE,EAAE,iBAAiB,GAAG,eAAe,GAAG,SAAS;IAQvD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,eAAe,GAAG,SAAS;IAcrF,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,CAAC,MAAM;CAQf"}