@kuralle-syrinx/core 4.4.0 → 4.5.0

package/dist/error-handler.js

@@ -0,0 +1,136 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Error Handler
+//
+// Categorizes errors from external service providers and determines
+// whether they are recoverable (retry with backoff) or fatal (terminate session).
+//
+// Each component (STT, TTS, LLM) has its own categorization logic.
+// The session manager uses these to decide retry vs. terminate.
+import { ErrorCategory } from "./packets.js";
+// =============================================================================
+// Error Categorization
+// =============================================================================
+/**
+ * Categorize an error from the STT provider.
+ *
+ * Heuristic:
+ *   - HTTP 429 → RateLimit (recoverable)
+ *   - Network errors (ECONNRESET, ETIMEDOUT, ENOTFOUND) → NetworkTimeout (recoverable)
+ *   - HTTP 401/403 → Authentication (fatal)
+ *   - HTTP 400/422 → InvalidInput (fatal)
+ *   - HTTP 402 → ResourceExhausted (fatal)
+ *   - Everything else → InternalFault (fatal)
+ */
+export function categorizeSttError(err) {
+    const msg = extractMessage(err).toLowerCase();
+    const code = extractHttpStatus(err);
+    if (code === 429 ||
+        msg.includes("rate limit") ||
+        msg.includes("rate_limit") ||
+        msg.includes("too many requests") ||
+        // Provider concurrency limits (e.g. Cartesia) — recoverable, retry with backoff.
+        msg.includes("concurrency limit") ||
+        msg.includes("concurrency_limit") ||
+        msg.includes("concurrent limit") ||
+        msg.includes("too many concurrent") ||
+        msg.includes("max concurrency") ||
+        (msg.includes("concurren") && (msg.includes("exceed") || msg.includes("limit")))) {
+        return ErrorCategory.RateLimit;
+    }
+    if (code === 401 || code === 403 || msg.includes("unauthorized") || msg.includes("forbidden")) {
+        return ErrorCategory.Authentication;
+    }
+    if (code === 400 || code === 422 || msg.includes("invalid") || msg.includes("bad request")) {
+        return ErrorCategory.InvalidInput;
+    }
+    if (msg.includes("data-000")) {
+        return ErrorCategory.InvalidInput;
+    }
+    if (code === 402 || msg.includes("payment required") || msg.includes("insufficient")) {
+        return ErrorCategory.ResourceExhausted;
+    }
+    if (msg.includes("econnreset") ||
+        msg.includes("etimedout") ||
+        msg.includes("enotfound") ||
+        msg.includes("network") ||
+        msg.includes("net-000") ||
+        msg.includes("timeout") ||
+        msg.includes("timed out") ||
+        msg.includes("econnrefused") ||
+        msg.includes("socket hang up") ||
+        msg.includes("code=1011") ||
+        msg.includes("internal error has occurred") ||
+        (code !== null && code >= 500 && code <= 599)) {
+        return ErrorCategory.NetworkTimeout;
+    }
+    return ErrorCategory.InternalFault;
+}
+/**
+ * Categorize an error from the TTS provider.
+ * Same heuristic as STT — TTS providers have similar error patterns.
+ */
+export function categorizeTtsError(err) {
+    return categorizeSttError(err); // Same logic applies
+}
+/**
+ * Categorize an error from the LLM provider.
+ *
+ * Additional LLM-specific heuristics:
+ *   - "context length exceeded" → InvalidInput (fatal)
+ *   - "content filter" / "safety" → InvalidInput (fatal)
+ */
+export function categorizeLlmError(err) {
+    const msg = extractMessage(err).toLowerCase();
+    if (msg.includes("context length") || msg.includes("token limit") || msg.includes("too many tokens")) {
+        return ErrorCategory.InvalidInput;
+    }
+    if (msg.includes("content filter") || msg.includes("safety") || msg.includes("blocked")) {
+        return ErrorCategory.InvalidInput;
+    }
+    if (msg.includes("malformed_function_call")) {
+        return ErrorCategory.NetworkTimeout;
+    }
+    return categorizeSttError(err); // Base logic for HTTP errors
+}
+// =============================================================================
+// Recoverability
+// =============================================================================
+/**
+ * Returns true if the error category is recoverable (retry with backoff).
+ */
+export function isRecoverable(category) {
+    return category === ErrorCategory.RateLimit || category === ErrorCategory.NetworkTimeout;
+}
+/**
+ * Returns true if the error packet represents a fatal error.
+ */
+export function isFatalError(pkt) {
+    return !pkt.isRecoverable;
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+function extractMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === "string")
+        return err;
+    if (err && typeof err === "object" && "message" in err) {
+        return String(err.message);
+    }
+    return String(err);
+}
+function extractHttpStatus(err) {
+    if (err && typeof err === "object") {
+        const e = err;
+        if (typeof e.status === "number")
+            return e.status;
+        if (typeof e.statusCode === "number")
+            return e.statusCode;
+        if (typeof e.code === "number")
+            return e.code;
+    }
+    return null;
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/error-handler.js.map

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

package/dist/idle-timeout.d.ts

@@ -0,0 +1,69 @@
+import type { PipelineBus } from "./pipeline-bus.js";
+import type { StartIdleTimeoutPacket, StopIdleTimeoutPacket } from "./packets.js";
+import { type Scheduler } from "./scheduler.js";
+export interface IdleTimeoutConfig {
+    /** Base duration before triggering idle behavior (ms). Default: 15000 */
+    durationMs: number;
+    /**
+     * Number of consecutive timeouts before disconnecting.
+     * 0 = never disconnect (just inject messages repeatedly).
+     * Default: 3
+     */
+    maxConsecutive: number;
+    /**
+     * Messages to inject at each consecutive idle.
+     * Index 0 = first timeout, index 1 = second timeout, etc.
+     * If more timeouts occur than messages, the last message repeats.
+     * Default: ["Are you still there?", "I'll end this call soon."]
+     */
+    escalationMessages: string[];
+    /**
+     * Whether to disconnect the session after maxConsecutive is reached.
+     * If false, the maxConsecutive counter stops incrementing and the
+     * last escalation message repeats indefinitely.
+     * Default: true
+     */
+    disconnectAfterMax: boolean;
+}
+export declare const DEFAULT_IDLE_TIMEOUT_CONFIG: IdleTimeoutConfig;
+export declare class IdleTimeoutManager {
+    private timerScheduled;
+    private count;
+    private readonly config;
+    private readonly bus;
+    private currentContextId;
+    private readonly scheduler;
+    constructor(bus: PipelineBus, config?: Partial<IdleTimeoutConfig>, scheduler?: Scheduler);
+    /** Set the current turn context ID (used for injected message context). */
+    setContextId(id: string): void;
+    /** Start (or restart) the idle timeout timer. */
+    start(): void;
+    /**
+     * Stop the idle timeout timer.
+     * @param resetCount — If true, resets the consecutive idle counter.
+     *   Use true when the user actively engages (speaks or types).
+     *   Use false for system-driven stops (e.g., TTS still playing).
+     */
+    stop(resetCount: boolean): void;
+    /**
+     * Extend the current timer by a duration (e.g., TTS audio playback time).
+     * Stops the current timer and restarts with the remaining time + extension.
+     */
+    extend(ms: number): void;
+    /** Clean up — stop timer without side effects. */
+    dispose(): void;
+    private clearTimer;
+    /**
+     * Resolve a non-empty context id for injected idle turns. If no turn context has been seen yet
+     * (e.g. the idle timer fired before the first user turn completed), synthesize a stable one —
+     * an empty contextId propagates downstream and is rejected by providers that validate it
+     * (e.g. Cartesia TTS: "context_id must be alphanumeric/_/-").
+     */
+    private ensureContextId;
+    private onTimeout;
+    /** Handle a StartIdleTimeoutPacket from the bus. */
+    handleStart(pkt: StartIdleTimeoutPacket): void;
+    /** Handle a StopIdleTimeoutPacket from the bus. */
+    handleStop(pkt: StopIdleTimeoutPacket): void;
+}
+//# sourceMappingURL=idle-timeout.d.ts.map

package/dist/idle-timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-timeout.d.ts","sourceRoot":"","sources":["../src/idle-timeout.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EAGtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhE,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B;;;;;OAKG;IACH,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,2BAA2B,EAAE,iBAKzC,CAAC;AAMF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAGpC,GAAG,EAAE,WAAW,EAChB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,EACnC,SAAS,CAAC,EAAE,SAAS;IAYvB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI9B,iDAAiD;IACjD,KAAK,IAAI,IAAI;IAWb;;;;;OAKG;IACH,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAO/B;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAUxB,kDAAkD;IAClD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,UAAU;IAMlB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,SAAS;IA4CjB,oDAAoD;IACpD,WAAW,CAAC,GAAG,EAAE,sBAAsB,GAAG,IAAI;IAK9C,mDAAmD;IACnD,UAAU,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI;CAG7C"}

package/dist/idle-timeout.js

@@ -0,0 +1,149 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Idle Timeout Manager
+//
+// Tracks user silence and escalates: inject message → inject warning → disconnect.
+// Configurable duration, escalation messages, and consecutive backoff.
+//
+// Design decision (per RFC Q4 resolution): idle messages are injected as
+// synthetic LlmDeltaPacket + LlmDonePacket through the normal TTS path.
+// This keeps voice style, logging, interruption, and abort semantics consistent.
+import { Route } from "./pipeline-bus.js";
+import { TimerScheduler } from "./scheduler.js";
+export const DEFAULT_IDLE_TIMEOUT_CONFIG = {
+    durationMs: 15_000,
+    maxConsecutive: 3,
+    escalationMessages: ["Are you still there?", "I'll end this call soon."],
+    disconnectAfterMax: true,
+};
+// =============================================================================
+// Manager
+// =============================================================================
+export class IdleTimeoutManager {
+    timerScheduled = false;
+    count = 0;
+    config;
+    bus;
+    currentContextId;
+    scheduler;
+    constructor(bus, config, scheduler) {
+        this.bus = bus;
+        this.config = { ...DEFAULT_IDLE_TIMEOUT_CONFIG, ...config };
+        this.currentContextId = "";
+        this.scheduler = scheduler ?? new TimerScheduler();
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    /** Set the current turn context ID (used for injected message context). */
+    setContextId(id) {
+        this.currentContextId = id;
+    }
+    /** Start (or restart) the idle timeout timer. */
+    start() {
+        this.clearTimer();
+        if (this.config.durationMs <= 0)
+            return;
+        this.timerScheduled = true;
+        this.scheduler.schedule("voice.idle_timeout", this.config.durationMs, () => {
+            this.timerScheduled = false;
+            this.onTimeout();
+        });
+    }
+    /**
+     * Stop the idle timeout timer.
+     * @param resetCount — If true, resets the consecutive idle counter.
+     *   Use true when the user actively engages (speaks or types).
+     *   Use false for system-driven stops (e.g., TTS still playing).
+     */
+    stop(resetCount) {
+        this.clearTimer();
+        if (resetCount) {
+            this.count = 0;
+        }
+    }
+    /**
+     * Extend the current timer by a duration (e.g., TTS audio playback time).
+     * Stops the current timer and restarts with the remaining time + extension.
+     */
+    extend(ms) {
+        this.clearTimer();
+        if (this.config.durationMs <= 0)
+            return;
+        this.timerScheduled = true;
+        this.scheduler.schedule("voice.idle_timeout", this.config.durationMs + ms, () => {
+            this.timerScheduled = false;
+            this.onTimeout();
+        });
+    }
+    /** Clean up — stop timer without side effects. */
+    dispose() {
+        this.clearTimer();
+    }
+    // -------------------------------------------------------------------------
+    // Private
+    // -------------------------------------------------------------------------
+    clearTimer() {
+        if (!this.timerScheduled)
+            return;
+        this.scheduler.cancel("voice.idle_timeout");
+        this.timerScheduled = false;
+    }
+    /**
+     * Resolve a non-empty context id for injected idle turns. If no turn context has been seen yet
+     * (e.g. the idle timer fired before the first user turn completed), synthesize a stable one —
+     * an empty contextId propagates downstream and is rejected by providers that validate it
+     * (e.g. Cartesia TTS: "context_id must be alphanumeric/_/-").
+     */
+    ensureContextId() {
+        if (this.currentContextId === "") {
+            this.currentContextId = `idle-${String(Date.now())}`;
+        }
+        return this.currentContextId;
+    }
+    onTimeout() {
+        this.count++;
+        const contextId = this.ensureContextId();
+        // Check if we should disconnect
+        if (this.config.maxConsecutive > 0 &&
+            this.count >= this.config.maxConsecutive &&
+            this.config.disconnectAfterMax) {
+            const disconnect = {
+                kind: "session.disconnect",
+                contextId,
+                timestampMs: Date.now(),
+                reason: `idle_timeout: ${this.count} consecutive`,
+            };
+            this.bus.push(Route.Critical, disconnect);
+            return;
+        }
+        // Inject escalation message
+        const msgIdx = Math.min(this.count - 1, this.config.escalationMessages.length - 1);
+        const message = this.config.escalationMessages[msgIdx];
+        if (message) {
+            const inject = {
+                kind: "inject.message",
+                contextId,
+                timestampMs: Date.now(),
+                text: message,
+            };
+            this.bus.push(Route.Main, inject);
+        }
+        // Restart timer for next escalation
+        this.start();
+    }
+    // -------------------------------------------------------------------------
+    // Bus packet handlers (for integration with VoiceAgentSession)
+    // -------------------------------------------------------------------------
+    /** Handle a StartIdleTimeoutPacket from the bus. */
+    handleStart(pkt) {
+        if (pkt.contextId)
+            this.setContextId(pkt.contextId);
+        this.start();
+    }
+    /** Handle a StopIdleTimeoutPacket from the bus. */
+    handleStop(pkt) {
+        this.stop(pkt.resetCount);
+    }
+}
+//# sourceMappingURL=idle-timeout.js.map

package/dist/idle-timeout.js.map

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

package/dist/incremental-unit.d.ts

@@ -0,0 +1,17 @@
+export type IuState = "hypothesized" | "committed" | "revoked";
+export interface IncrementalUnitId {
+    readonly contextId: string;
+    readonly iuId: string;
+    readonly epoch: number;
+}
+export interface IncrementalUnit {
+    readonly id: IncrementalUnitId;
+    readonly kind: "user_turn" | "assistant_response" | "tts_segment";
+    state: IuState;
+    /** For assistant/tts IUs: the committed character/ms prefix (heard). */
+    committedPrefix?: {
+        chars?: number;
+        ms?: number;
+    };
+}
+//# sourceMappingURL=incremental-unit.d.ts.map

package/dist/incremental-unit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incremental-unit.d.ts","sourceRoot":"","sources":["../src/incremental-unit.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG,WAAW,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,oBAAoB,GAAG,aAAa,CAAC;IAClE,KAAK,EAAE,OAAO,CAAC;IACf,wEAAwE;IACxE,eAAe,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD"}

package/dist/incremental-unit.js

@@ -0,0 +1,5 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Incremental-Unit identity + state (IU substrate, RFC incremental-unit-substrate)
+export {};
+//# sourceMappingURL=incremental-unit.js.map

package/dist/incremental-unit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incremental-unit.js","sourceRoot":"","sources":["../src/incremental-unit.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,sGAAsG"}

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+export { type AudioFormat, type VoicePacket, type AsyncPacket, type VoiceErrorPacket, ErrorCategory, SessionState, InitStage, type InitStepCompletedPacket, type InitializationFailedPacket, type InitializationCompletedPacket, } from "./packets.js";
+export { type UserAudioReceivedPacket, type UserTextReceivedPacket, type DenoiseAudioPacket, type DenoisedAudioPacket, type VadAudioPacket, type VadSpeechStartedPacket, type VadSpeechEndedPacket, type VadSpeechActivityPacket, type SpeechToTextAudioPacket, type SttInterimPacket, type SttPartialPacket, type SttResultPacket, type FinalizeSttPacket, type SttReconfigurePacket, type SttErrorPacket, type EndOfSpeechAudioPacket, type EndOfSpeechPacket, type InterimEndOfSpeechPacket, type EndOfSpeechRetractedPacket, type TurnEndOwner, type TurnEndReason, type UserInputPacket, } from "./packets.js";
+export { type InterruptionDetectedPacket, type InterruptTtsPacket, type InterruptLlmPacket, type InterruptSttPacket, type TurnChangePacket, } from "./packets.js";
+export { type DtmfDigit, type DtmfReceivedPacket, type DtmfSendPacket, type CallTransferMode, type CallTransferPacket, } from "./packets.js";
+export { parseDtmfDigit, dtmfReceived, dtmfSend, callTransfer } from "./packet-factories.js";
+export { type LlmDeltaPacket, type LlmResponseDonePacket, type LlmErrorPacket, type LlmToolCallPacket, type LlmToolResultPacket, } from "./packets.js";
+export { type ReasoningSuspendedPacket, type ReasoningResumePacket, } from "./packets.js";
+export { type DelegateQueryPacket, type DelegateResultPacket, type DelegatePacket, type RealtimeResumptionHandlePacket, } from "./packets.js";
+export { InMemoryReasonerSessionStore, type ReasonerSessionStore, } from "./reasoner-session-store.js";
+export { type IuState, type IncrementalUnitId, type IncrementalUnit, } from "./incremental-unit.js";
+export { type IuLedger, type IuLedgerAnomaly, InMemoryIuLedger, } from "./iu-ledger.js";
+export { type TextToSpeechTextPacket, type TextToSpeechDonePacket, type TextToSpeechAudioPacket, type TextToSpeechEndPacket, type TextToSpeechPlayoutStartedPacket, type TextToSpeechPlayoutProgressPacket, type TextToSpeechWordTimestampsPacket, type TtsWordTimestamp, type TtsErrorPacket, } from "./packets.js";
+export { type RecordAssistantAudioDataPacket, type RecordAssistantAudioPacket, type RecordAssistantAudioTruncatePacket, type RecordUserAudioPacket, type StartIdleTimeoutPacket, type StopIdleTimeoutPacket, type InjectMessagePacket, type DisconnectRequestedPacket, } from "./packets.js";
+export { type ModeSwitchRequestedPacket, type ModeSwitchCompletedPacket, } from "./packets.js";
+export { type MessageCreatePacket, type ConversationMetricPacket, type AcousticSignalPacket, type AcousticSignal, type TurnLocalizationPacket, type UsageStage, type UsageRecordedPacket, type TurnBoundaryKind, type TurnBoundaryEventPacket, type ObservabilityPacket, type PipelineErrorPacket, } from "./packets.js";
+export { type SttPrice, type LlmPrice, type TtsPrice, type PriceCatalog, type CostResult, DEFAULT_PRICE_CATALOG, costOf, } from "./pricing.js";
+export { SpendCapGuard, type SpendCapConfig, type SpendCapCheck, } from "./spend-cap.js";
+export { monotonicNowMs, type MetricTags, type ObservabilityLayer, type TurnLocalizationVerdict, type TurnLocalizationSignals, localizeTurn, type SpanHandle, type MetricsExporter, noopMetricsExporter, InMemoryMetricsExporter, reconstructTurnTimeline, type TurnTimelineStep, } from "./observability.js";
+export { ObservabilityObserver, type ObservabilityObserverDeps, type ObservabilityDims, } from "./observability-observer.js";
+export { PipelineBusImpl, Route, type PipelineBus, type PipelineBusConfig, type PacketHandler } from "./pipeline-bus.js";
+export { runInitChain, runFinalizeChain, type InitStep, InitializationError } from "./init-chain.js";
+export { type VoicePlugin, type PluginConfig, type EndpointingOwner, type EndpointingCapability, type SttReconfigure, type SttReconfigurePartial, requireStringConfig, optionalStringConfig, } from "./plugin-contract.js";
+export { categorizeSttError, categorizeTtsError, categorizeLlmError, isRecoverable, isFatalError } from "./error-handler.js";
+export { DEFAULT_RETRY_CONFIG, VOICE_PROVIDER_RETRY_CONFIG, VOICE_PROVIDER_OUTAGE_RETRY_CONFIG, readRetryConfig, readProviderRetryConfig, retryDelayMs, waitForRetryDelay, type RetryConfig } from "./retry.js";
+export { ProviderFallback, type FallbackProvider, type ProviderFallbackOptions } from "./provider-fallback.js";
+export { TimerScheduler, type Scheduler, type ScheduledCallback } from "./scheduler.js";
+export { IdleTimeoutManager, type IdleTimeoutConfig, DEFAULT_IDLE_TIMEOUT_CONFIG } from "./idle-timeout.js";
+export { ModeSwitcher, type ModeSwitchHandlers } from "./mode-switcher.js";
+export { type ConversationEvent, createConversationEventStream } from "./conversation-event.js";
+export { SYRINX_AUDIO_ENVELOPE_NAME, SYRINX_AUDIO_ENVELOPE_MAGIC, assertAudioFormat, assertAudioPayload, encodeSyrinxAudioEnvelope, decodeSyrinxAudioEnvelope, hasSyrinxAudioEnvelope, type SyrinxAudioEnvelope, type SyrinxAudioEnvelopeHeader, } from "./audio-envelope.js";
+export { StreamingPcm16Resampler, createLoudnessState, normalizeLoudness, type LoudnessConfig, type LoudnessState, } from "./audio/index.js";
+export { type InteractionPolicy, type LifecycleInteractionPolicy, isLifecycleInteractionPolicy, type InteractionObservation, type InteractionDecision, type AcousticSignalObservation, type AcousticSignalSink, type WordTiming, } from "./interaction-policy.js";
+export { confidenceToWaitMs, type ConfidenceToWaitConfig } from "./confidence-to-wait.js";
+export { RuleBasedInteractionPolicy } from "./policies/rule-based.js";
+export { DeferInteractionPolicy } from "./policies/defer.js";
+export { InteractionCoordinator, type InteractionCaps } from "./interaction-coordinator.js";
+export { type InteractionBackchannelPacket, type InteractionDuckPacket, type InteractionResumePacket, } from "./packets.js";
+export { VoiceAgentSession, type VoiceAgentSessionConfig, type VoiceAgentSessionEvents, type SessionStageUsage, } from "./voice-agent-session.js";
+export { PrimarySpeakerGate, extractSpeakerFingerprint, fingerprintSimilarity, type SpeakerFingerprint, type PrimarySpeakerGateDecision, type PrimarySpeakerGateConfig, } from "./primary-speaker-gate.js";
+export { synthesizeTonePcm16, mixPcm16, PRIMARY_SPEAKER_TONE_HZ, BYSTANDER_SPEAKER_TONE_HZ, ASSISTANT_ECHO_TONE_HZ, } from "./primary-speaker-fixtures.js";
+export { LatencyFillerController, selectLatencyFillerConnective, stripRedundantFillerPrefix, LATENCY_FILLER_CONNECTIVES, type LatencyFillerConfig, type LatencyFillerState, type LatencyFillerConnective, } from "./latency-filler.js";
+export { LATENCY_FILLER_FIXTURES, type LatencyFillerFixture, } from "./latency-filler-fixtures.js";
+export { normalizeForSpeech, stripLeakedToolCalls } from "./voice-text.js";
+export { type Reasoner, type ReasonerTurn, type ReasonerMessage, type ReasonerUsage, type ReasoningPart, } from "./reasoner.js";
+export { HedgedReasoner, type HedgedReasonerOptions } from "./reasoner-hedge.js";
+export { RoutingReasoner, type RoutingReasonerOptions, type ReasonerRoute, } from "./reasoner-route.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,61 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Public API
+//
+// Everything a consumer needs to build voice agents with the new kernel.
+// Core types
+export { ErrorCategory, SessionState, InitStage, } from "./packets.js";
+export { parseDtmfDigit, dtmfReceived, dtmfSend, callTransfer } from "./packet-factories.js";
+// Durable reasoner session state (G4)
+export { InMemoryReasonerSessionStore, } from "./reasoner-session-store.js";
+export { InMemoryIuLedger, } from "./iu-ledger.js";
+// Metering: price catalog + spend-cap guard (standalone; session wires later)
+export { DEFAULT_PRICE_CATALOG, costOf, } from "./pricing.js";
+export { SpendCapGuard, } from "./spend-cap.js";
+// Observability backbone (VE-07)
+export { monotonicNowMs, localizeTurn, noopMetricsExporter, InMemoryMetricsExporter, reconstructTurnTimeline, } from "./observability.js";
+export { ObservabilityObserver, } from "./observability-observer.js";
+// PipelineBus
+export { PipelineBusImpl, Route } from "./pipeline-bus.js";
+// Init chain
+export { runInitChain, runFinalizeChain, InitializationError } from "./init-chain.js";
+// Plugin contract
+export { requireStringConfig, optionalStringConfig, } from "./plugin-contract.js";
+// Error handler
+export { categorizeSttError, categorizeTtsError, categorizeLlmError, isRecoverable, isFatalError } from "./error-handler.js";
+// Retry helpers
+export { DEFAULT_RETRY_CONFIG, VOICE_PROVIDER_RETRY_CONFIG, VOICE_PROVIDER_OUTAGE_RETRY_CONFIG, readRetryConfig, readProviderRetryConfig, retryDelayMs, waitForRetryDelay } from "./retry.js";
+// Provider fallback/degradation
+export { ProviderFallback } from "./provider-fallback.js";
+// Runtime scheduler seam
+export { TimerScheduler } from "./scheduler.js";
+// Idle timeout
+export { IdleTimeoutManager, DEFAULT_IDLE_TIMEOUT_CONFIG } from "./idle-timeout.js";
+// Mode switcher
+export { ModeSwitcher } from "./mode-switcher.js";
+// Conversation events
+export { createConversationEventStream } from "./conversation-event.js";
+// Websocket audio envelope
+export { SYRINX_AUDIO_ENVELOPE_NAME, SYRINX_AUDIO_ENVELOPE_MAGIC, assertAudioFormat, assertAudioPayload, encodeSyrinxAudioEnvelope, decodeSyrinxAudioEnvelope, hasSyrinxAudioEnvelope, } from "./audio-envelope.js";
+export { StreamingPcm16Resampler, createLoudnessState, normalizeLoudness, } from "./audio/index.js";
+// Interaction policy seam (IP-C1)
+export { isLifecycleInteractionPolicy, } from "./interaction-policy.js";
+export { confidenceToWaitMs } from "./confidence-to-wait.js";
+export { RuleBasedInteractionPolicy } from "./policies/rule-based.js";
+export { DeferInteractionPolicy } from "./policies/defer.js";
+export { InteractionCoordinator } from "./interaction-coordinator.js";
+// VoiceAgentSession
+export { VoiceAgentSession, } from "./voice-agent-session.js";
+// Primary-speaker barge-in gate (VE-02)
+export { PrimarySpeakerGate, extractSpeakerFingerprint, fingerprintSimilarity, } from "./primary-speaker-gate.js";
+export { synthesizeTonePcm16, mixPcm16, PRIMARY_SPEAKER_TONE_HZ, BYSTANDER_SPEAKER_TONE_HZ, ASSISTANT_ECHO_TONE_HZ, } from "./primary-speaker-fixtures.js";
+// Latency-hiding filler track (VE-03)
+export { LatencyFillerController, selectLatencyFillerConnective, stripRedundantFillerPrefix, LATENCY_FILLER_CONNECTIVES, } from "./latency-filler.js";
+export { LATENCY_FILLER_FIXTURES, } from "./latency-filler-fixtures.js";
+// Voice text: markdown/formatting normalization + leaked-tool-call guard before TTS
+export { normalizeForSpeech, stripLeakedToolCalls } from "./voice-text.js";
+// Hedged reasoner (Lever C — reasoner-latency RFC)
+export { HedgedReasoner } from "./reasoner-hedge.js";
+// Routing reasoner (Lever B — reasoner-latency RFC)
+export { RoutingReasoner, } from "./reasoner-route.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/init-chain.d.ts

@@ -0,0 +1,35 @@
+import type { PipelineBus } from "./pipeline-bus.js";
+import type { InitStage } from "./packets.js";
+export interface InitStep {
+    /** Human-readable name for logging and error messages. */
+    readonly name: string;
+    /** Which initialization stage this step represents. */
+    readonly stage: InitStage;
+    /** Run the initialization. Throws on failure. */
+    run(): Promise<void>;
+    /** Clean up resources. Called during teardown (on failure) or finalize chain. */
+    cleanup?(): Promise<void>;
+}
+export declare class InitializationError extends Error {
+    readonly stage: InitStage;
+    readonly component: string;
+    constructor(stage: InitStage, component: string, cause: Error);
+}
+/**
+ * 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 declare function runInitChain(bus: PipelineBus, steps: readonly InitStep[]): Promise<void>;
+/**
+ * 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 declare function runFinalizeChain(steps: readonly InitStep[]): Promise<void>;
+//# sourceMappingURL=init-chain.d.ts.map

package/dist/init-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-chain.d.ts","sourceRoot":"","sources":["../src/init-chain.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EACV,SAAS,EAIV,MAAM,cAAc,CAAC;AAOtB,MAAM,WAAW,QAAQ;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,iDAAiD;IACjD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,iFAAiF;IACjF,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAMD,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,KAAK,EAAE,SAAS;aAChB,SAAS,EAAE,MAAM;gBADjB,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,MAAM,EACjC,KAAK,EAAE,KAAK;CAKf;AAMD;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,SAAS,QAAQ,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CAsDf;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,SAAS,QAAQ,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CAQf"}