@kuralle-syrinx/core 4.4.0 → 4.5.0

package/dist/pipeline-bus.d.ts

@@ -0,0 +1,92 @@
+import type { VoicePacket } from "./packets.js";
+export declare enum Route {
+    Critical = 0,// interrupts, turn changes — drained first, never bounded
+    Main = 1,// pipeline flow: audio in, STT results, LLM deltas, TTS audio
+    Background = 2
+}
+export type PacketHandler<T extends VoicePacket = VoicePacket> = (pkt: T) => void | Promise<void>;
+export interface PipelineBus {
+    /** Push one or more packets into a priority route. */
+    push<T extends readonly VoicePacket[]>(route: Route, ...packets: T): void;
+    /**
+     * Register a handler for a specific packet kind. Returns unsubscribe function.
+     *
+     * By default handlers are awaited in registration order (consumer semantics — the
+     * handler's state mutations are visible to the next packet's handlers). Pass
+     * `{ concurrent: true }` for a long-running PRODUCER handler (e.g. an LLM-generation
+     * loop that emits its own packets over time): it is dispatched fire-and-forget so it
+     * does not park the drain loop and defer subsequent Main packets / Critical interrupts
+     * behind it. Concurrent handler errors are surfaced as `pipeline.error`, like async packets.
+     */
+    on<T extends VoicePacket>(kind: T["kind"], handler: PacketHandler<T>, opts?: {
+        concurrent?: boolean;
+    }): () => void;
+    /** Start draining the bus. Resolves when stop() is called and final drain completes. */
+    start(): Promise<void>;
+    /** Stop draining. Flushes Critical+Main, discards Background. */
+    stop(): void;
+    /** Readonly stream of every packet pushed into the bus, before route dispatch. */
+    readonly allPackets: ReadableStream<{
+        route: Route;
+        packet: VoicePacket;
+    }>;
+}
+/**
+ * Configuration for PipelineBusImpl.
+ * Critical is always unbounded. Main and Background can be configured.
+ */
+export interface PipelineBusConfig {
+    /** Maximum Main queue size. Default 4096. Throws on overflow. */
+    mainCapacity?: number;
+    /** Maximum Background queue size. Default 2048. Drops oldest on overflow. */
+    bgCapacity?: number;
+    /** Maximum Critical packets to batch per tick before yielding to I/O. Default 4. */
+    criticalBatchSize?: number;
+    /** Called when a Background packet is dropped. For metrics emission. */
+    onBackgroundDrop?: (dropped: VoicePacket) => void;
+    /** Called for every packet pushed into the bus. */
+    onPacket?: (route: Route, packet: VoicePacket) => void;
+}
+export declare class PipelineBusImpl implements PipelineBus {
+    private critical;
+    private main;
+    private background;
+    private handlers;
+    private concurrentHandlers;
+    private running;
+    private resolver;
+    private drainedCount;
+    private allPacketsController;
+    readonly allPackets: ReadableStream<{
+        route: Route;
+        packet: VoicePacket;
+    }>;
+    private readonly mainCapacity;
+    private readonly bgCapacity;
+    private readonly criticalBatchSize;
+    private readonly onBgDrop;
+    private readonly onPacket;
+    constructor(config?: PipelineBusConfig);
+    push<T extends readonly VoicePacket[]>(route: Route, ...packets: T): void;
+    on<T extends VoicePacket>(kind: T["kind"], handler: PacketHandler<T>, opts?: {
+        concurrent?: boolean;
+    }): () => void;
+    start(): Promise<void>;
+    stop(): void;
+    private queueFor;
+    private publishAllPackets;
+    private enqueueBackgroundDropMetric;
+    private capacityFor;
+    /**
+     * Dequeue a batch of packets. Always drains Critical first.
+     * Critical batches up to `criticalBatchSize` per tick before yielding to I/O.
+     * Main and Background drain one packet per tick.
+     */
+    private dequeueBatch;
+    /** Dispatch one packet to registered handlers. */
+    private dispatch;
+    private emitHandlerError;
+    /** Synchronous dispatch for drain-on-stop. Swallows errors. */
+    private dispatchSync;
+}
+//# sourceMappingURL=pipeline-bus.d.ts.map

package/dist/pipeline-bus.d.ts.map

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

package/dist/pipeline-bus.js

@@ -0,0 +1,294 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Priority Pipeline Bus
+//
+// Three priority channels (Critical, Main, Background) with strict drain order.
+// All pipeline components push packets into the bus. The bus dispatches to
+// registered handlers. Handlers are registered by packet kind (discriminated string).
+//
+// Design decisions (per RFC Q1 resolution):
+//   - Uses setTimeout(fn, 0) for the drain loop to yield to I/O between iterations.
+//   - Critical channel batches up to 4 packets per tick before yielding.
+//   - Main queue is bounded at 4096 packets; throws on overflow.
+//   - Background queue is bounded at 2048 packets; drops oldest on overflow.
+//   - Pipeline handler errors emit VoiceErrorPacket on Critical route — bus continues.
+import { ErrorCategory } from "./packets.js";
+// =============================================================================
+// Public Types
+// =============================================================================
+export var Route;
+(function (Route) {
+    Route[Route["Critical"] = 0] = "Critical";
+    Route[Route["Main"] = 1] = "Main";
+    Route[Route["Background"] = 2] = "Background";
+})(Route || (Route = {}));
+// =============================================================================
+// Implementation
+// =============================================================================
+export class PipelineBusImpl {
+    critical = [];
+    main = [];
+    background = [];
+    handlers = new Map();
+    concurrentHandlers = new Set();
+    running = false;
+    resolver = null;
+    drainedCount = 0;
+    allPacketsController = null;
+    allPackets;
+    mainCapacity;
+    bgCapacity;
+    criticalBatchSize;
+    onBgDrop;
+    onPacket;
+    constructor(config) {
+        this.mainCapacity = config?.mainCapacity ?? 4096;
+        this.bgCapacity = config?.bgCapacity ?? 2048;
+        this.criticalBatchSize = config?.criticalBatchSize ?? 4;
+        this.onBgDrop = config?.onBackgroundDrop;
+        this.onPacket = config?.onPacket;
+        this.allPackets = new ReadableStream({
+            start: (controller) => {
+                this.allPacketsController = controller;
+            },
+            cancel: () => {
+                this.allPacketsController = null;
+            },
+        });
+        if (this.mainCapacity < 1)
+            throw new Error("mainCapacity must be >= 1");
+        if (this.bgCapacity < 1)
+            throw new Error("bgCapacity must be >= 1");
+        if (this.criticalBatchSize < 1)
+            throw new Error("criticalBatchSize must be >= 1");
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    push(route, ...packets) {
+        for (const p of packets) {
+            this.publishAllPackets(route, p);
+            const q = this.queueFor(route);
+            let droppedForMetric = null;
+            if (q.length >= this.capacityFor(route)) {
+                if (route === Route.Background) {
+                    const dropped = q.shift();
+                    if (dropped && this.onBgDrop) {
+                        this.onBgDrop(dropped);
+                    }
+                    if (dropped) {
+                        droppedForMetric = dropped;
+                    }
+                    // continue — push after dropping oldest
+                }
+                else if (route === Route.Main) {
+                    throw new Error(`PipelineBus: Main queue full (${this.mainCapacity}). ` +
+                        `Backpressure required — slow down producers or increase capacity.`);
+                }
+                // Critical is never bounded
+            }
+            q.push(p);
+            if (droppedForMetric) {
+                this.enqueueBackgroundDropMetric(droppedForMetric);
+            }
+        }
+        // Wake the drain loop
+        this.resolver?.();
+        this.resolver = null;
+    }
+    on(kind, handler, opts) {
+        let set = this.handlers.get(kind);
+        if (!set) {
+            set = new Set();
+            this.handlers.set(kind, set);
+        }
+        const h = handler;
+        set.add(h);
+        if (opts?.concurrent)
+            this.concurrentHandlers.add(h);
+        return () => {
+            set.delete(h);
+            this.concurrentHandlers.delete(h);
+            if (set.size === 0) {
+                this.handlers.delete(kind);
+            }
+        };
+    }
+    async start() {
+        this.running = true;
+        while (this.running) {
+            const batch = this.dequeueBatch();
+            if (batch.length === 0) {
+                // Yield to I/O — wait for next push()
+                await new Promise((resolve) => {
+                    this.resolver = resolve;
+                });
+                continue;
+            }
+            for (const entry of batch) {
+                await this.dispatch(entry.packet);
+                this.drainedCount++;
+            }
+        }
+    }
+    stop() {
+        this.running = false;
+        // Drain remaining Critical then Main (synchronous — stop is a shutdown path)
+        while (this.critical.length > 0) {
+            const pkt = this.critical.shift();
+            void this.dispatchSync(pkt);
+        }
+        while (this.main.length > 0) {
+            const pkt = this.main.shift();
+            void this.dispatchSync(pkt);
+        }
+        // Discard Background
+        this.background.length = 0;
+        this.resolver?.();
+        this.resolver = null;
+    }
+    // ---------------------------------------------------------------------------
+    // Private
+    // ---------------------------------------------------------------------------
+    queueFor(r) {
+        if (r === Route.Critical)
+            return this.critical;
+        if (r === Route.Main)
+            return this.main;
+        return this.background;
+    }
+    publishAllPackets(route, packet) {
+        this.onPacket?.(route, packet);
+        if (!this.allPacketsController)
+            return;
+        // Only retain packets when a reader is actually attached. A ReadableStream
+        // buffers enqueue() without bound until read, so with no consumer (the default
+        // deployment — recorder is optional) this would retain every audio buffer of
+        // the whole call and OOM. `locked` is true once getReader() is called.
+        if (!this.allPackets.locked)
+            return;
+        try {
+            this.allPacketsController.enqueue({ route, packet });
+        }
+        catch {
+            this.allPacketsController = null;
+        }
+    }
+    enqueueBackgroundDropMetric(dropped) {
+        const metric = {
+            kind: "metric.conversation",
+            contextId: dropped.contextId,
+            timestampMs: Date.now(),
+            name: "pipeline.bus.background.dropped",
+            value: dropped.kind,
+        };
+        this.publishAllPackets(Route.Background, metric);
+        if (this.background.length >= this.bgCapacity) {
+            this.background.shift();
+        }
+        this.background.push(metric);
+    }
+    capacityFor(r) {
+        if (r === Route.Critical)
+            return Infinity;
+        if (r === Route.Main)
+            return this.mainCapacity;
+        return this.bgCapacity;
+    }
+    /**
+     * Dequeue a batch of packets. Always drains Critical first.
+     * Critical batches up to `criticalBatchSize` per tick before yielding to I/O.
+     * Main and Background drain one packet per tick.
+     */
+    dequeueBatch() {
+        // 1. Critical — batch up to N
+        if (this.critical.length > 0) {
+            const batch = [];
+            const count = Math.min(this.critical.length, this.criticalBatchSize);
+            for (let i = 0; i < count; i++) {
+                batch.push({
+                    route: Route.Critical,
+                    packet: this.critical.shift(),
+                });
+            }
+            return batch;
+        }
+        // 2. Main — one packet per tick
+        if (this.main.length > 0) {
+            return [{ route: Route.Main, packet: this.main.shift() }];
+        }
+        // 3. Background — one packet per tick
+        if (this.background.length > 0) {
+            return [{ route: Route.Background, packet: this.background.shift() }];
+        }
+        return [];
+    }
+    /** Dispatch one packet to registered handlers. */
+    async dispatch(pkt) {
+        const matches = this.handlers.get(pkt.kind);
+        if (!matches || matches.size === 0)
+            return;
+        // Async packets: fire-and-forget, don't await
+        if ("isAsync" in pkt && pkt.isAsync) {
+            for (const h of matches) {
+                void (async () => {
+                    try {
+                        await h(pkt);
+                    }
+                    catch {
+                        // Fire-and-forget errors are intentionally swallowed.
+                        // AsyncPackets are for non-critical telemetry/events.
+                    }
+                })();
+            }
+            return;
+        }
+        // Sync packets: await each consumer handler in registration order. Concurrent
+        // (producer) handlers are fired fire-and-forget so a long-running handler does
+        // not park the drain loop and defer subsequent Main/Critical packets behind it.
+        for (const h of matches) {
+            const handler = h;
+            if (this.concurrentHandlers.has(handler)) {
+                void (async () => {
+                    try {
+                        await handler(pkt);
+                    }
+                    catch (err) {
+                        this.emitHandlerError(pkt, err);
+                    }
+                })();
+                continue;
+            }
+            try {
+                await handler(pkt);
+            }
+            catch (err) {
+                // Handler error → emit PipelineErrorPacket on Critical.
+                // Continue processing other handlers — don't abort the bus.
+                this.emitHandlerError(pkt, err);
+            }
+        }
+    }
+    emitHandlerError(pkt, err) {
+        const errorPkt = {
+            kind: "pipeline.error",
+            contextId: pkt.contextId,
+            timestampMs: Date.now(),
+            component: "pipeline",
+            category: ErrorCategory.InternalFault,
+            cause: err instanceof Error ? err : new Error(String(err)),
+            isRecoverable: true,
+        };
+        this.push(Route.Critical, errorPkt);
+    }
+    /** Synchronous dispatch for drain-on-stop. Swallows errors. */
+    async dispatchSync(pkt) {
+        try {
+            await this.dispatch(pkt);
+        }
+        catch {
+            // Drain phase — silence errors
+        }
+    }
+}
+//# sourceMappingURL=pipeline-bus.js.map

package/dist/pipeline-bus.js.map

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

package/dist/plugin-contract.d.ts

@@ -0,0 +1,73 @@
+import type { PipelineBus } from "./pipeline-bus.js";
+export type EndpointingOwner = "provider_stt" | "smart_turn";
+export interface EndpointingCapability {
+    readonly owner: EndpointingOwner;
+    readonly disableConfig?: PluginConfig;
+}
+/**
+ * Vendor-agnostic mid-stream STT reconfiguration. Per-turn reconfigure is a COMMODITY STT capability
+ * (Deepgram Flux `Configure`, AssemblyAI `UpdateConfiguration`, Speechmatics `SetRecognitionConfig`) —
+ * the value of THIS seam is normalizing those differing wire shapes behind one interface so an
+ * InteractionPolicy can actuate any STT without vendor-specific plumbing. All fields optional; a plugin
+ * applies what it supports and ignores the rest (best-effort — e.g. Deepgram ignores `contextText`).
+ */
+export interface SttReconfigurePartial {
+    readonly keyterms?: readonly string[];
+    readonly eotThreshold?: number;
+    readonly eagerEotThreshold?: number;
+    readonly eotTimeoutMs?: number;
+    /** Silence-based endpointing (ms). Nova-style; Flux may ignore (it uses eotTimeoutMs). */
+    readonly endpointingMs?: number;
+    readonly vadThreshold?: number;
+    readonly languageHints?: readonly string[];
+    /**
+     * Hard recognition-language switch (e.g. "en-US" → "es-ES", or Nova-3 "multi" for code-switch).
+     * Distinct from `languageHints` (soft bias): this changes the recognizer's language. Providers
+     * that carry language in the connection URL (Nova) reconnect to apply it; model-fixed providers
+     * (Flux, `flux-general-en`) ignore it and rely on `languageHints`.
+     */
+    readonly language?: string;
+    /** AssemblyAI-style agent-context biasing (the agent's own prior reply). Ignored where unsupported. */
+    readonly contextText?: string;
+}
+export interface SttReconfigure {
+    reconfigure(partial: SttReconfigurePartial): void;
+}
+export interface VoicePlugin {
+    readonly endpointingCapability?: EndpointingCapability;
+    /** Present when the STT supports mid-stream reconfiguration (see {@link SttReconfigure}). */
+    readonly sttReconfigure?: SttReconfigure;
+    /**
+     * Initialize the plugin. Called during the init chain.
+     * Connect to provider, start streams, register bus handlers if needed.
+     *
+     * @param bus — The session's PipelineBus. Push all output packets here.
+     * @param config — Plugin-specific configuration (API keys, model IDs, etc.).
+     */
+    initialize(bus: PipelineBus, config: PluginConfig): Promise<void>;
+    /**
+     * Best-effort warm of remote/expensive resources (open connections, wake a scaled-to-zero
+     * endpoint). Called AFTER initialize, before the first turn. Must not throw fatally — swallow
+     * errors internally. Optional; plugins with nothing to warm omit it.
+     */
+    prewarm?(): Promise<void>;
+    /**
+     * Tear down the plugin. Called during the finalize chain (reverse order).
+     * Close connections, flush buffers, release resources.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Plugin configuration — a flat key-value bag.
+ * Plugins extract the keys they need (e.g., "api_key", "model_id", "voice_id").
+ */
+export type PluginConfig = Record<string, unknown>;
+/**
+ * Convenience: extract a string config value, throwing if missing.
+ */
+export declare function requireStringConfig(config: PluginConfig, key: string): string;
+/**
+ * Convenience: extract an optional string config value.
+ */
+export declare function optionalStringConfig(config: PluginConfig, key: string): string | undefined;
+//# sourceMappingURL=plugin-contract.d.ts.map

package/dist/plugin-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-contract.d.ts","sourceRoot":"","sources":["../src/plugin-contract.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,YAAY,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,YAAY,CAAC;CACvC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,0FAA0F;IAC1F,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,uGAAuG;IACvG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAEvD,6FAA6F;IAC7F,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IAEzC;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;;;OAIG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAMD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,GACV,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAKpB"}

package/dist/plugin-contract.js

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Plugin Contract
+//
+// Every pipeline plugin (STT, TTS, VAD, EOS, Denoiser, Bridge) implements
+// this interface. Plugins receive the PipelineBus on initialization and
+// push all output (transcripts, audio, errors, events) into the bus.
+//
+// Breaking change from v0.1: plugins now accept PipelineBus directly.
+// No callbacks, no adapters. Clean contract, one code path.
+/**
+ * Convenience: extract a string config value, throwing if missing.
+ */
+export function requireStringConfig(config, key) {
+    const value = config[key];
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error(`Plugin config missing required key: ${key}`);
+    }
+    return value;
+}
+/**
+ * Convenience: extract an optional string config value.
+ */
+export function optionalStringConfig(config, key) {
+    const value = config[key];
+    return typeof value === "string" && value.trim().length > 0
+        ? value
+        : undefined;
+}
+//# sourceMappingURL=plugin-contract.js.map

package/dist/plugin-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-contract.js","sourceRoot":"","sources":["../src/plugin-contract.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,qCAAqC;AACrC,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,qEAAqE;AACrE,EAAE;AACF,sEAAsE;AACtE,4DAA4D;AAqF5D;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAoB,EACpB,GAAW;IAEX,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAoB,EACpB,GAAW;IAEX,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACzD,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC"}

package/dist/policies/defer.d.ts

@@ -0,0 +1,11 @@
+import type { InteractionDecision, InteractionObservation, InteractionPolicy } from "../interaction-policy.js";
+/**
+ * The front owns full-duplex interaction (turn-taking, barge-in, backchannels). This policy takes no
+ * action — it observes only, so the coordinator drives nothing and the front's own decisions (surfaced
+ * by its adapter/bridge as interrupt.detected / eos.turn_complete) stand. RFC InteractionPolicy REQ-4.
+ */
+export declare class DeferInteractionPolicy implements InteractionPolicy {
+    observe(_obs: InteractionObservation): readonly InteractionDecision[];
+    reset(_contextId: string): void;
+}
+//# sourceMappingURL=defer.d.ts.map

package/dist/policies/defer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer.d.ts","sourceRoot":"","sources":["../../src/policies/defer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE/G;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,iBAAiB;IAC9D,OAAO,CAAC,IAAI,EAAE,sBAAsB,GAAG,SAAS,mBAAmB,EAAE;IAGrE,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAChC"}

package/dist/policies/defer.js

@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: MIT
+/**
+ * The front owns full-duplex interaction (turn-taking, barge-in, backchannels). This policy takes no
+ * action — it observes only, so the coordinator drives nothing and the front's own decisions (surfaced
+ * by its adapter/bridge as interrupt.detected / eos.turn_complete) stand. RFC InteractionPolicy REQ-4.
+ */
+export class DeferInteractionPolicy {
+    observe(_obs) {
+        return [];
+    }
+    reset(_contextId) { }
+}
+//# sourceMappingURL=defer.js.map

package/dist/policies/defer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer.js","sourceRoot":"","sources":["../../src/policies/defer.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAI/B;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IACjC,OAAO,CAAC,IAA4B;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,KAAK,CAAC,UAAkB,IAAS,CAAC;CACnC"}

package/dist/policies/rule-based.d.ts

@@ -0,0 +1,35 @@
+import type { PipelineBus } from "../pipeline-bus.js";
+import type { InteractionDecision, InteractionObservation, InteractionPolicy } from "../interaction-policy.js";
+import { PrimarySpeakerGate } from "../primary-speaker-gate.js";
+import { TtsPlayoutClock } from "../tts-playout-clock.js";
+import { TurnArbiter } from "../turn-arbiter.js";
+export interface RuleBasedInteractionPolicyDeps {
+    readonly bus: PipelineBus;
+    readonly primarySpeakerGate: PrimarySpeakerGate;
+    readonly ttsPlayout: TtsPlayoutClock;
+    readonly minInterruptionMs: number;
+    /** When true, the underlying TurnArbiter emits duck/resume signals during barge-in evaluation. */
+    readonly pauseThenResolveBargeIn?: boolean;
+    /** Tenant-level backchannel knobs. Default (undefined) = current behavior (`mm_hmm`). */
+    readonly backchannel?: {
+        readonly enabled?: boolean;
+        readonly cues?: readonly string[];
+    };
+}
+export declare class RuleBasedInteractionPolicy implements InteractionPolicy {
+    readonly arbiter: TurnArbiter;
+    private readonly ttsPlayout;
+    private readonly backchannelConfig;
+    private pending;
+    private bargeInAudioConsumed;
+    private delegateGapOpen;
+    private delegateCuePlayed;
+    private userSpeaking;
+    constructor(deps: RuleBasedInteractionPolicyDeps);
+    observe(obs: InteractionObservation): readonly InteractionDecision[];
+    private handleDelegateState;
+    private depsTtsActive;
+    reset(_contextId: string): void;
+    takeBargeInAudioConsumed(): boolean;
+}
+//# sourceMappingURL=rule-based.d.ts.map

package/dist/policies/rule-based.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-based.d.ts","sourceRoot":"","sources":["../../src/policies/rule-based.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC/G,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,kGAAkG;IAClG,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C,yFAAyF;IACzF,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACnC,CAAC;CACH;AAED,qBAAa,0BAA2B,YAAW,iBAAiB;IAClE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgD;IAClF,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,EAAE,8BAA8B;IAahD,OAAO,CAAC,GAAG,EAAE,sBAAsB,GAAG,SAAS,mBAAmB,EAAE;IAiEpE,OAAO,CAAC,mBAAmB;IA4B3B,OAAO,CAAC,aAAa;IAIrB,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAO/B,wBAAwB,IAAI,OAAO;CAKpC"}