@framers/agentos 0.1.74 → 0.1.76

package/dist/voice/types.d.ts

@@ -99,7 +99,7 @@ export interface CallRecord {
  * Normalized webhook event from any telephony provider.
  * Uses a discriminated union on the `kind` field.
  */
-export type NormalizedCallEvent = NormalizedCallRinging | NormalizedCallAnswered | NormalizedCallCompleted | NormalizedCallFailed | NormalizedCallBusy | NormalizedCallNoAnswer | NormalizedCallVoicemail | NormalizedCallHangupUser | NormalizedCallError | NormalizedTranscript | NormalizedSpeechStart | NormalizedMediaStreamConnected;
+export type NormalizedCallEvent = NormalizedCallRinging | NormalizedCallAnswered | NormalizedCallCompleted | NormalizedCallFailed | NormalizedCallBusy | NormalizedCallNoAnswer | NormalizedCallVoicemail | NormalizedCallHangupUser | NormalizedCallError | NormalizedTranscript | NormalizedSpeechStart | NormalizedMediaStreamConnected | NormalizedDtmfReceived;
 interface NormalizedEventBase {
     /** Provider-assigned event ID for idempotency. */
     eventId: string;
@@ -150,6 +150,14 @@ export interface NormalizedMediaStreamConnected extends NormalizedEventBase {
     kind: 'media-stream-connected';
     streamSid: string;
 }
+/** DTMF digit received during a call. */
+export interface NormalizedDtmfReceived extends NormalizedEventBase {
+    kind: 'call-dtmf';
+    /** The digit pressed: '0'-'9', '*', '#' */
+    digit: string;
+    /** How long the key was pressed (ms), if available from provider */
+    durationMs?: number;
+}
 /** Raw webhook context passed to provider verification. */
 export interface WebhookContext {
     /** HTTP method (usually POST). */

package/dist/voice/types.d.ts.map

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

package/dist/voice-pipeline/AcousticEndpointDetector.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @module voice-pipeline/AcousticEndpointDetector
+ *
+ * Acoustic-only endpoint detector that wraps {@link SilenceDetector} to convert
+ * VAD events into turn-completion decisions. It ignores transcript content entirely
+ * and relies solely on the duration of post-speech silence to decide when the user
+ * has finished speaking.
+ *
+ * Emits:
+ * - `'turn_complete'` ({@link TurnCompleteEvent}) — silence exceeded the configured
+ *   `utteranceEndThresholdMs` after the most recent `speech_end` VAD event.
+ * - `'speech_start'` () — re-emitted when a `speech_start` VAD event is received.
+ */
+import { EventEmitter } from 'node:events';
+import type { IEndpointDetector, VadEvent, TranscriptEvent } from './types.js';
+/**
+ * Constructor options for {@link AcousticEndpointDetector}.
+ */
+export interface AcousticEndpointDetectorConfig {
+    /**
+     * Silence duration after speech (ms) that triggers a "significant pause"
+     * notification on the underlying {@link SilenceDetector}. Does not directly
+     * cause `turn_complete` to fire, but is forwarded to the SilenceDetector.
+     * @defaultValue 1500
+     */
+    significantPauseThresholdMs?: number;
+    /**
+     * Silence duration after speech (ms) that triggers `turn_complete` with
+     * `reason: 'silence_timeout'`.
+     * @defaultValue 3000
+     */
+    utteranceEndThresholdMs?: number;
+}
+/**
+ * Purely acoustic endpoint detector.
+ *
+ * Delegates silence timing to a {@link SilenceDetector} instance. VAD
+ * `speech_end` events start the silence clock; `speech_start` events cancel
+ * any pending turn-complete emission. Transcript content is completely ignored.
+ *
+ * @example
+ * ```ts
+ * const detector = new AcousticEndpointDetector({ utteranceEndThresholdMs: 2000 });
+ * detector.on('turn_complete', (event) => console.log('Turn done:', event));
+ * detector.pushVadEvent({ type: 'speech_end', timestamp: Date.now() });
+ * ```
+ */
+export declare class AcousticEndpointDetector extends EventEmitter implements IEndpointDetector {
+    /** @inheritdoc */
+    readonly mode: "acoustic";
+    /** Underlying silence-duration tracker. */
+    private readonly silenceDetector;
+    /**
+     * Timestamp (ms) when the current speech segment began. Tracked so that
+     * `durationMs` in the emitted {@link TurnCompleteEvent} can be computed.
+     */
+    private speechStartTimeMs;
+    /**
+     * Timestamp (ms) when the most recent `speech_end` VAD event was received.
+     * Used to calculate `durationMs` for the turn-complete event.
+     */
+    private speechEndTimeMs;
+    /**
+     * Creates a new AcousticEndpointDetector.
+     *
+     * @param config - Optional silence-threshold overrides.
+     */
+    constructor(config?: AcousticEndpointDetectorConfig);
+    /**
+     * Converts a {@link VadEvent} into the SilenceDetector's expected API calls.
+     *
+     * - `speech_start` — resets silence state and re-emits `'speech_start'` on self.
+     * - `speech_end` — starts the silence clock.
+     * - `silence` — treated as ongoing non-speech frames.
+     *
+     * @param event - Incoming VAD event.
+     */
+    pushVadEvent(event: VadEvent): void;
+    /**
+     * No-op — this detector is purely acoustic and does not use transcript content.
+     *
+     * @param _event - Ignored transcript event.
+     */
+    pushTranscript(_event: TranscriptEvent): void;
+    /**
+     * Resets all internal state and timers. Call at the start of each new turn.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=AcousticEndpointDetector.d.ts.map

package/dist/voice-pipeline/AcousticEndpointDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcousticEndpointDetector.d.ts","sourceRoot":"","sources":["../../src/voice-pipeline/AcousticEndpointDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EACV,iBAAiB,EACjB,QAAQ,EACR,eAAe,EAEhB,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;;OAKG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAMD;;;;;;;;;;;;;GAaG;AACH,qBAAa,wBAAyB,SAAQ,YAAa,YAAW,iBAAiB;IACrF,kBAAkB;IAClB,SAAgB,IAAI,EAAG,UAAU,CAAU;IAE3C,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAElD;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CAAuB;IAEhD;;;OAGG;IACH,OAAO,CAAC,eAAe,CAAuB;IAI9C;;;;OAIG;gBACS,MAAM,GAAE,8BAAmC;IAgCvD;;;;;;;;OAQG;IACI,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAyB1C;;;;OAIG;IACI,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAIpD;;OAEG;IACI,KAAK,IAAI,IAAI;CAKrB"}

package/dist/voice-pipeline/AcousticEndpointDetector.js

@@ -0,0 +1,123 @@
+/**
+ * @module voice-pipeline/AcousticEndpointDetector
+ *
+ * Acoustic-only endpoint detector that wraps {@link SilenceDetector} to convert
+ * VAD events into turn-completion decisions. It ignores transcript content entirely
+ * and relies solely on the duration of post-speech silence to decide when the user
+ * has finished speaking.
+ *
+ * Emits:
+ * - `'turn_complete'` ({@link TurnCompleteEvent}) — silence exceeded the configured
+ *   `utteranceEndThresholdMs` after the most recent `speech_end` VAD event.
+ * - `'speech_start'` () — re-emitted when a `speech_start` VAD event is received.
+ */
+import { EventEmitter } from 'node:events';
+import { SilenceDetector } from '../core/audio/SilenceDetector.js';
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+/**
+ * Purely acoustic endpoint detector.
+ *
+ * Delegates silence timing to a {@link SilenceDetector} instance. VAD
+ * `speech_end` events start the silence clock; `speech_start` events cancel
+ * any pending turn-complete emission. Transcript content is completely ignored.
+ *
+ * @example
+ * ```ts
+ * const detector = new AcousticEndpointDetector({ utteranceEndThresholdMs: 2000 });
+ * detector.on('turn_complete', (event) => console.log('Turn done:', event));
+ * detector.pushVadEvent({ type: 'speech_end', timestamp: Date.now() });
+ * ```
+ */
+export class AcousticEndpointDetector extends EventEmitter {
+    // ---------------------------------------------------------------------------
+    /**
+     * Creates a new AcousticEndpointDetector.
+     *
+     * @param config - Optional silence-threshold overrides.
+     */
+    constructor(config = {}) {
+        super();
+        /** @inheritdoc */
+        this.mode = 'acoustic';
+        /**
+         * Timestamp (ms) when the current speech segment began. Tracked so that
+         * `durationMs` in the emitted {@link TurnCompleteEvent} can be computed.
+         */
+        this.speechStartTimeMs = null;
+        /**
+         * Timestamp (ms) when the most recent `speech_end` VAD event was received.
+         * Used to calculate `durationMs` for the turn-complete event.
+         */
+        this.speechEndTimeMs = null;
+        const sdConfig = {
+            significantPauseThresholdMs: config.significantPauseThresholdMs ?? 1500,
+            utteranceEndThresholdMs: config.utteranceEndThresholdMs ?? 3000,
+        };
+        this.silenceDetector = new SilenceDetector(sdConfig);
+        // When SilenceDetector decides the utterance has ended, fire turn_complete.
+        this.silenceDetector.on('utterance_end_detected', (_silenceDurationMs) => {
+            const durationMs = this.speechStartTimeMs !== null && this.speechEndTimeMs !== null
+                ? this.speechEndTimeMs - this.speechStartTimeMs
+                : 0;
+            const event = {
+                transcript: '', // Acoustic mode has no transcript access
+                confidence: 0,
+                durationMs,
+                reason: 'silence_timeout',
+            };
+            this.emit('turn_complete', event);
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // IEndpointDetector
+    // ---------------------------------------------------------------------------
+    /**
+     * Converts a {@link VadEvent} into the SilenceDetector's expected API calls.
+     *
+     * - `speech_start` — resets silence state and re-emits `'speech_start'` on self.
+     * - `speech_end` — starts the silence clock.
+     * - `silence` — treated as ongoing non-speech frames.
+     *
+     * @param event - Incoming VAD event.
+     */
+    pushVadEvent(event) {
+        // Minimal VADResult stub — SilenceDetector's public methods only use it as
+        // a pass-through parameter and don't inspect its contents.
+        const vadResultStub = { timestamp: event.timestamp };
+        switch (event.type) {
+            case 'speech_start':
+                this.speechStartTimeMs = event.timestamp;
+                this.speechEndTimeMs = null;
+                this.silenceDetector.handleSpeechStart(vadResultStub);
+                this.emit('speech_start');
+                break;
+            case 'speech_end':
+                this.speechEndTimeMs = event.timestamp;
+                this.silenceDetector.handleSpeechEnd(vadResultStub, 0);
+                break;
+            case 'silence':
+                // Periodic silence heartbeat — pass as a non-speech frame.
+                this.silenceDetector.handleNoVoiceActivity(vadResultStub);
+                break;
+        }
+    }
+    /**
+     * No-op — this detector is purely acoustic and does not use transcript content.
+     *
+     * @param _event - Ignored transcript event.
+     */
+    pushTranscript(_event) {
+        // Intentional no-op: acoustic mode ignores linguistic content.
+    }
+    /**
+     * Resets all internal state and timers. Call at the start of each new turn.
+     */
+    reset() {
+        this.speechStartTimeMs = null;
+        this.speechEndTimeMs = null;
+        this.silenceDetector.reset();
+    }
+}
+//# sourceMappingURL=AcousticEndpointDetector.js.map

package/dist/voice-pipeline/AcousticEndpointDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcousticEndpointDetector.js","sourceRoot":"","sources":["../../src/voice-pipeline/AcousticEndpointDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAA8B,MAAM,kCAAkC,CAAC;AAgC/F,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,wBAAyB,SAAQ,YAAY;IAmBxD,8EAA8E;IAE9E;;;;OAIG;IACH,YAAY,SAAyC,EAAE;QACrD,KAAK,EAAE,CAAC;QA1BV,kBAAkB;QACF,SAAI,GAAG,UAAmB,CAAC;QAK3C;;;WAGG;QACK,sBAAiB,GAAkB,IAAI,CAAC;QAEhD;;;WAGG;QACK,oBAAe,GAAkB,IAAI,CAAC;QAY5C,MAAM,QAAQ,GAA0B;YACtC,2BAA2B,EAAE,MAAM,CAAC,2BAA2B,IAAI,IAAI;YACvE,uBAAuB,EAAE,MAAM,CAAC,uBAAuB,IAAI,IAAI;SAChE,CAAC;QAEF,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC;QAErD,4EAA4E;QAC5E,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,wBAAwB,EAAE,CAAC,kBAA0B,EAAE,EAAE;YAC/E,MAAM,UAAU,GACd,IAAI,CAAC,iBAAiB,KAAK,IAAI,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI;gBAC9D,CAAC,CAAC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,iBAAiB;gBAC/C,CAAC,CAAC,CAAC,CAAC;YAER,MAAM,KAAK,GAAsB;gBAC/B,UAAU,EAAE,EAAE,EAAI,yCAAyC;gBAC3D,UAAU,EAAE,CAAC;gBACb,UAAU;gBACV,MAAM,EAAE,iBAAiB;aAC1B,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAC9E,oBAAoB;IACpB,8EAA8E;IAE9E;;;;;;;;OAQG;IACI,YAAY,CAAC,KAAe;QACjC,2EAA2E;QAC3E,2DAA2D;QAC3D,MAAM,aAAa,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAW,CAAC;QAE9D,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,cAAc;gBACjB,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC,SAAS,CAAC;gBACzC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;gBAC5B,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;gBACtD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBAC1B,MAAM;YAER,KAAK,YAAY;gBACf,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,SAAS,CAAC;gBACvC,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;gBACvD,MAAM;YAER,KAAK,SAAS;gBACZ,2DAA2D;gBAC3D,IAAI,CAAC,eAAe,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC;gBAC1D,MAAM;QACV,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,cAAc,CAAC,MAAuB;QAC3C,+DAA+D;IACjE,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/dist/voice-pipeline/HardCutBargeinHandler.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @module voice-pipeline/HardCutBargeinHandler
+ *
+ * Implements a hard-cut barge-in policy: when the user speaks over TTS output
+ * for at least `minSpeechMs` milliseconds, playback is stopped immediately with
+ * no fade-out. Short detections below the threshold are treated as accidental
+ * noise and ignored.
+ */
+import type { BargeinAction, BargeinContext, IBargeinHandler } from './types.js';
+/**
+ * Construction options for {@link HardCutBargeinHandler}.
+ */
+export interface HardCutBargeinHandlerOptions {
+    /**
+     * Minimum confirmed speech duration (in milliseconds) required before a
+     * barge-in is treated as intentional. Detections shorter than this value are
+     * returned as `{ type: 'ignore' }` to avoid reacting to background noise.
+     *
+     * @defaultValue 300
+     */
+    minSpeechMs?: number;
+}
+/**
+ * Barge-in handler that applies a hard-cut strategy.
+ *
+ * When the user speaks over an active TTS stream, this handler immediately
+ * cancels playback if the detected speech exceeds `minSpeechMs`. Below that
+ * threshold the interruption is considered noise and playback continues
+ * uninterrupted.
+ *
+ * @example
+ * ```ts
+ * const handler = new HardCutBargeinHandler({ minSpeechMs: 250 });
+ * const action = handler.handleBargein({ speechDurationMs: 400, ... });
+ * // action.type === 'cancel'
+ * ```
+ */
+export declare class HardCutBargeinHandler implements IBargeinHandler {
+    /**
+     * The interruption strategy implemented by this handler.
+     * Always `'hard-cut'`.
+     */
+    readonly mode: "hard-cut";
+    /**
+     * Minimum speech duration in milliseconds before the interruption is
+     * considered intentional.
+     */
+    private readonly minSpeechMs;
+    /**
+     * Constructs a new {@link HardCutBargeinHandler}.
+     *
+     * @param options - Optional configuration. Defaults to `{ minSpeechMs: 300 }`.
+     */
+    constructor(options?: HardCutBargeinHandlerOptions);
+    /**
+     * Evaluate the barge-in context and return the action the pipeline should take.
+     *
+     * - If `context.speechDurationMs >= minSpeechMs`, returns
+     *   `{ type: 'cancel', injectMarker: '[interrupted]' }` to immediately halt TTS.
+     * - Otherwise returns `{ type: 'ignore' }` to continue playback.
+     *
+     * @param context - Snapshot of the barge-in state at the moment of detection.
+     * @returns The pipeline action to execute.
+     */
+    handleBargein(context: BargeinContext): BargeinAction;
+}
+//# sourceMappingURL=HardCutBargeinHandler.d.ts.map

package/dist/voice-pipeline/HardCutBargeinHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HardCutBargeinHandler.d.ts","sourceRoot":"","sources":["../../src/voice-pipeline/HardCutBargeinHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC3D;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAEpC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC;;;;OAIG;gBACS,OAAO,GAAE,4BAAiC;IAItD;;;;;;;;;OASG;IACH,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa;CAMtD"}

package/dist/voice-pipeline/HardCutBargeinHandler.js

@@ -0,0 +1,55 @@
+/**
+ * @module voice-pipeline/HardCutBargeinHandler
+ *
+ * Implements a hard-cut barge-in policy: when the user speaks over TTS output
+ * for at least `minSpeechMs` milliseconds, playback is stopped immediately with
+ * no fade-out. Short detections below the threshold are treated as accidental
+ * noise and ignored.
+ */
+/**
+ * Barge-in handler that applies a hard-cut strategy.
+ *
+ * When the user speaks over an active TTS stream, this handler immediately
+ * cancels playback if the detected speech exceeds `minSpeechMs`. Below that
+ * threshold the interruption is considered noise and playback continues
+ * uninterrupted.
+ *
+ * @example
+ * ```ts
+ * const handler = new HardCutBargeinHandler({ minSpeechMs: 250 });
+ * const action = handler.handleBargein({ speechDurationMs: 400, ... });
+ * // action.type === 'cancel'
+ * ```
+ */
+export class HardCutBargeinHandler {
+    /**
+     * Constructs a new {@link HardCutBargeinHandler}.
+     *
+     * @param options - Optional configuration. Defaults to `{ minSpeechMs: 300 }`.
+     */
+    constructor(options = {}) {
+        /**
+         * The interruption strategy implemented by this handler.
+         * Always `'hard-cut'`.
+         */
+        this.mode = 'hard-cut';
+        this.minSpeechMs = options.minSpeechMs ?? 300;
+    }
+    /**
+     * Evaluate the barge-in context and return the action the pipeline should take.
+     *
+     * - If `context.speechDurationMs >= minSpeechMs`, returns
+     *   `{ type: 'cancel', injectMarker: '[interrupted]' }` to immediately halt TTS.
+     * - Otherwise returns `{ type: 'ignore' }` to continue playback.
+     *
+     * @param context - Snapshot of the barge-in state at the moment of detection.
+     * @returns The pipeline action to execute.
+     */
+    handleBargein(context) {
+        if (context.speechDurationMs >= this.minSpeechMs) {
+            return { type: 'cancel', injectMarker: '[interrupted]' };
+        }
+        return { type: 'ignore' };
+    }
+}
+//# sourceMappingURL=HardCutBargeinHandler.js.map

package/dist/voice-pipeline/HardCutBargeinHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HardCutBargeinHandler.js","sourceRoot":"","sources":["../../src/voice-pipeline/HardCutBargeinHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkBH;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,qBAAqB;IAahC;;;;OAIG;IACH,YAAY,UAAwC,EAAE;QAjBtD;;;WAGG;QACM,SAAI,GAAG,UAAmB,CAAC;QAclC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC;IAChD,CAAC;IAED;;;;;;;;;OASG;IACH,aAAa,CAAC,OAAuB;QACnC,IAAI,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACjD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;QAC3D,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/voice-pipeline/HeuristicEndpointDetector.d.ts

@@ -0,0 +1,128 @@
+/**
+ * @module voice-pipeline/HeuristicEndpointDetector
+ *
+ * A lightweight, rule-based endpoint detector that combines terminal punctuation
+ * analysis with a configurable silence timeout to determine when the user has
+ * finished speaking. Suitable for low-latency deployments where an LLM-based
+ * semantic detector would add unacceptable round-trip overhead.
+ *
+ * Detection strategy:
+ *   1. On `speech_end`, if the accumulated final transcript ends with `.`, `?`, or `!`,
+ *      fire `turn_complete` immediately with reason `'punctuation'`.
+ *   2. Otherwise, start a silence timer (default 1 500 ms). If speech does not
+ *      resume before the timer fires, emit `turn_complete` with reason `'silence_timeout'`.
+ *   3. Backchannel phrases (e.g. "uh huh", "yeah") are recognised, suppressed from
+ *      accumulation, and re-emitted as `'backchannel_detected'` events so the
+ *      pipeline can decide whether to suppress an agent response.
+ */
+import { EventEmitter } from 'node:events';
+import type { IEndpointDetector, TranscriptEvent, VadEvent } from './types.js';
+/**
+ * Constructor options for {@link HeuristicEndpointDetector}.
+ */
+export interface HeuristicEndpointDetectorOptions {
+    /**
+     * How long (ms) to wait after `speech_end` before emitting `turn_complete`
+     * when no terminal punctuation is detected.
+     * @defaultValue 1500
+     */
+    silenceTimeoutMs?: number;
+}
+/**
+ * Heuristic endpoint detector that uses terminal punctuation and a silence
+ * timeout to decide when the user's turn is complete.
+ *
+ * Emits:
+ * - `'turn_complete'` ({@link TurnCompleteEvent}) — user turn has ended.
+ * - `'backchannel_detected'` (`{ text: string }`) — a backchannel phrase was
+ *   recognised; accumulation is suppressed for this utterance.
+ *
+ * @example
+ * ```typescript
+ * const detector = new HeuristicEndpointDetector({ silenceTimeoutMs: 1000 });
+ * detector.on('turn_complete', (event) => console.log('Turn done:', event));
+ * detector.pushTranscript({ text: 'Hello there.', isFinal: true, confidence: 0.95, words: [] });
+ * detector.pushVadEvent({ type: 'speech_end', timestamp: Date.now(), source: 'vad' });
+ * // → 'turn_complete' fires immediately with reason 'punctuation'
+ * ```
+ */
+export declare class HeuristicEndpointDetector extends EventEmitter implements IEndpointDetector {
+    /**
+     * Active detection strategy label.
+     * Typed as `'hybrid'` to satisfy {@link IEndpointDetector.mode}; consumers
+     * that need to distinguish heuristic detectors may inspect `instanceof`.
+     */
+    readonly mode: IEndpointDetector['mode'];
+    /** Resolved silence timeout in milliseconds. */
+    private readonly silenceTimeoutMs;
+    /** The latest final transcript text accumulated for the current turn. */
+    private accumulatedText;
+    /** Whether the VAD currently reports active speech. */
+    private speechActive;
+    /** Handle to a pending silence timeout, or `null` if none is running. */
+    private silenceTimer;
+    /** Wall-clock timestamp (ms) when the current turn's speech started. */
+    private turnStartMs;
+    /** Confidence of the most recent final transcript. */
+    private lastConfidence;
+    /**
+     * Create a new {@link HeuristicEndpointDetector}.
+     *
+     * @param options — Optional configuration overrides.
+     */
+    constructor(options?: HeuristicEndpointDetectorOptions);
+    /**
+     * Ingest a transcript event from the upstream STT session.
+     *
+     * Only final events (`isFinal: true`) affect internal state. Interim results
+     * are silently ignored — they may arrive very frequently and their text is
+     * unstable.
+     *
+     * If the final text is a recognised backchannel phrase the detector emits
+     * `'backchannel_detected'` and returns without accumulating the text, so that
+     * a subsequent `speech_end` event does not trigger `turn_complete`.
+     *
+     * @param transcript — Transcript event from the STT session.
+     */
+    pushTranscript(transcript: TranscriptEvent): void;
+    /**
+     * Ingest a VAD (voice activity detection) event.
+     *
+     * - `speech_start`: marks the turn as active and cancels any pending silence
+     *   timer (the user resumed speaking before the timeout elapsed).
+     * - `speech_end`: if accumulated text is available, either fires
+     *   `turn_complete` immediately (punctuation) or starts the silence timer.
+     * - `silence`: heartbeat events are ignored; only explicit `speech_end`
+     *   drives the timeout logic.
+     *
+     * @param event — VAD transition event.
+     */
+    pushVadEvent(event: VadEvent): void;
+    /**
+     * Reset all internal state, cancel pending timers, and prepare the detector
+     * for the next user turn. Should be called by the pipeline after each
+     * `turn_complete` event before audio for the next turn begins to arrive.
+     */
+    reset(): void;
+    /**
+     * Emit `turn_complete` with the currently accumulated transcript and then
+     * reset internal state so the detector is ready for the next turn.
+     *
+     * @param reason — The semantic reason driving this completion.
+     * @param speechEndTimestamp — Unix epoch ms timestamp of the `speech_end` event,
+     *   used to compute `durationMs`.
+     */
+    private _emitTurnComplete;
+    /**
+     * Start the silence-timeout timer. If the user does not resume speaking
+     * within {@link silenceTimeoutMs} ms the detector fires `turn_complete`.
+     *
+     * @param speechEndTimestamp — Timestamp passed through to `_emitTurnComplete`.
+     */
+    private _startSilenceTimer;
+    /**
+     * Cancel a pending silence timer without any side effects.
+     */
+    private _clearSilenceTimer;
+}
+//# sourceMappingURL=HeuristicEndpointDetector.d.ts.map

package/dist/voice-pipeline/HeuristicEndpointDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeuristicEndpointDetector.d.ts","sourceRoot":"","sources":["../../src/voice-pipeline/HeuristicEndpointDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,QAAQ,EAET,MAAM,YAAY,CAAC;AAwCpB;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,yBACX,SAAQ,YACR,YAAW,iBAAiB;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAe;IAEvD,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C,yEAAyE;IACzE,OAAO,CAAC,eAAe,CAAM;IAE7B,uDAAuD;IACvD,OAAO,CAAC,YAAY,CAAS;IAE7B,yEAAyE;IACzE,OAAO,CAAC,YAAY,CAA8C;IAElE,wEAAwE;IACxE,OAAO,CAAC,WAAW,CAAuB;IAE1C,sDAAsD;IACtD,OAAO,CAAC,cAAc,CAAK;IAM3B;;;;OAIG;gBACS,OAAO,GAAE,gCAAqC;IAS1D;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAwBjD;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAyCnC;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAYb;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAM3B"}