felona-voice 0.1.0

package/dist/tts/eleven-labs.js

@@ -0,0 +1,73 @@
+/**
+ * ElevenLabsTTS — Streaming Text-to-Speech using ElevenLabs' API.
+ *
+ * Uses the streaming endpoint for chunk-by-chunk audio delivery,
+ * so the agent can start speaking before the full response is generated.
+ */
+export class ElevenLabsTTS {
+    name = "elevenlabs";
+    apiKey;
+    defaultVoice;
+    baseUrl;
+    modelId;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.defaultVoice = options.voice ?? "21m00Tcm4TlvDq8ikWAM"; // Rachel
+        this.modelId = options.modelId ?? "eleven_turbo_v2_5";
+        this.baseUrl = options.baseUrl ?? "https://api.elevenlabs.io/v1";
+    }
+    async *synthesize(text, options) {
+        const voiceId = options?.voice ?? this.defaultVoice;
+        const response = await fetch(`${this.baseUrl}/text-to-speech/${voiceId}/stream`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "xi-api-key": this.apiKey,
+            },
+            body: JSON.stringify({
+                text,
+                model_id: this.modelId,
+                voice_settings: {
+                    stability: 0.5,
+                    similarity_boost: 0.75,
+                    speed: options?.speed ?? 1.0,
+                },
+                output_format: "pcm_16000",
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`ElevenLabs TTS failed: ${response.status} ${error}`);
+        }
+        if (!response.body) {
+            throw new Error("ElevenLabs TTS returned no body");
+        }
+        const reader = response.body.getReader();
+        let timestampMs = 0;
+        const bytesPerSecond = 16000 * 2; // 16kHz * 16-bit = 32000 bytes/sec
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                const chunk = {
+                    data: Buffer.from(value),
+                    sampleRate: 16000,
+                    channels: 1,
+                    bitDepth: 16,
+                    timestampMs,
+                };
+                // Calculate timestamp based on audio duration
+                timestampMs += (value.length / bytesPerSecond) * 1000;
+                yield chunk;
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+}
+export function createElevenLabsTTS(options) {
+    return new ElevenLabsTTS(options);
+}
+//# sourceMappingURL=eleven-labs.js.map

package/dist/tts/eleven-labs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eleven-labs.js","sourceRoot":"","sources":["../../src/tts/eleven-labs.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,YAAY,CAAC;IACZ,MAAM,CAAS;IACf,YAAY,CAAS;IACrB,OAAO,CAAS;IAChB,OAAO,CAAS;IAEjC,YAAY,OAKX;QACC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,KAAK,IAAI,sBAAsB,CAAC,CAAC,SAAS;QACtE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,mBAAmB,CAAC;QACtD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,8BAA8B,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,CAAC,UAAU,CACf,IAAY,EACZ,OAAoB;QAEpB,MAAM,OAAO,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC;QAEpD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,IAAI,CAAC,OAAO,mBAAmB,OAAO,SAAS,EAClD;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,YAAY,EAAE,IAAI,CAAC,MAAM;aAC1B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI;gBACJ,QAAQ,EAAE,IAAI,CAAC,OAAO;gBACtB,cAAc,EAAE;oBACd,SAAS,EAAE,GAAG;oBACd,gBAAgB,EAAE,IAAI;oBACtB,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG;iBAC7B;gBACD,aAAa,EAAE,WAAW;aAC3B,CAAC;SACH,CACF,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,0BAA0B,QAAQ,CAAC,MAAM,IAAI,KAAK,EAAE,CACrD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACzC,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,MAAM,cAAc,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,mCAAmC;QAErE,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI;oBAAE,MAAM;gBAEhB,MAAM,KAAK,GAAe;oBACxB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;oBACxB,UAAU,EAAE,KAAK;oBACjB,QAAQ,EAAE,CAAC;oBACX,QAAQ,EAAE,EAAE;oBACZ,WAAW;iBACZ,CAAC;gBAEF,8CAA8C;gBAC9C,WAAW,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,cAAc,CAAC,GAAG,IAAI,CAAC;gBAEtD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,OAInC;IACC,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/tts/index.d.ts

@@ -0,0 +1,2 @@
+export { ElevenLabsTTS, createElevenLabsTTS } from "./eleven-labs.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/tts/index.js

@@ -0,0 +1,2 @@
+export { ElevenLabsTTS, createElevenLabsTTS } from "./eleven-labs.js";
+//# sourceMappingURL=index.js.map

package/dist/tts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,370 @@
+/**
+ * Core type definitions for Felona Voice.
+ *
+ * These types define the contracts between all modules in the framework.
+ * Every provider, engine, and component implements interfaces defined here.
+ */
+/** Raw audio chunk flowing through the pipeline */
+export interface AudioChunk {
+    /** PCM audio data (16-bit, 16kHz mono by default) */
+    data: Buffer;
+    /** Sample rate in Hz */
+    sampleRate: number;
+    /** Number of channels (1 = mono) */
+    channels: number;
+    /** Bit depth (16 = PCM16) */
+    bitDepth: number;
+    /** Timestamp in milliseconds (relative to session start) */
+    timestampMs: number;
+}
+/** Default audio format used throughout the pipeline */
+export declare const DEFAULT_AUDIO_FORMAT: {
+    readonly sampleRate: 16000;
+    readonly channels: 1;
+    readonly bitDepth: 16;
+};
+/** Represents a single voice call/session */
+export interface Session {
+    /** Unique session identifier */
+    id: string;
+    /** When the session started */
+    startedAt: Date;
+    /** Arbitrary metadata attached to this session */
+    metadata: Record<string, unknown>;
+    /** Current session state */
+    state: SessionState;
+}
+export type SessionState = "connecting" | "active" | "paused" | "ended";
+/** A single turn in the conversation */
+export interface ConversationTurn {
+    /** Who spoke */
+    role: "user" | "agent";
+    /** The transcribed/generated text */
+    content: string;
+    /** When this turn occurred */
+    timestampMs: number;
+    /** If agent turn, which action was selected by JEV */
+    actionId?: string;
+    /** JEV confidence score for the selected action (0-1) */
+    confidence?: number;
+}
+/** Full conversation context passed to the JEV engine */
+export interface ConversationContext {
+    /** The current session */
+    session: Session;
+    /** All turns so far */
+    turns: ConversationTurn[];
+    /** The latest user utterance (may be partial for streaming) */
+    currentUtterance: string;
+    /** Extracted slots/entities */
+    slots: Record<string, unknown>;
+    /** System prompt for this agent */
+    systemPrompt: string;
+}
+/** An action the agent can take, as defined by the developer */
+export interface AgentAction {
+    /** Unique identifier for this action */
+    id: string;
+    /** Human-readable description — this gets embedded by JEV */
+    description: string;
+    /**
+     * Handler executed when JEV selects this action.
+     * Returns the text the agent should speak.
+     */
+    handler: (ctx: ActionContext) => Promise<string>;
+    /** Optional: custom metadata for analytics/logging */
+    metadata?: Record<string, unknown>;
+}
+/** Context passed to action handlers */
+export interface ActionContext {
+    /** The full conversation context */
+    conversation: ConversationContext;
+    /** LLM interface for generating responses */
+    llm: LLMInterface;
+    /** Tool executor for calling external tools */
+    tools: ToolExecutor;
+    /** Conversation memory manager */
+    memory: MemoryManager;
+    /** The current session */
+    session: Session;
+}
+/** Result of JEV action matching */
+export interface ActionMatch {
+    /** The matched action */
+    action: AgentAction;
+    /** Confidence score (0-1) — cosine similarity or predictor confidence */
+    confidence: number;
+    /** All candidates with their scores, sorted descending */
+    candidates: Array<{
+        actionId: string;
+        score: number;
+    }>;
+}
+/** Transport layer interface — handles audio I/O */
+export interface Transport {
+    /** Start listening for connections */
+    start(options: TransportOptions): Promise<void>;
+    /** Stop the transport */
+    stop(): Promise<void>;
+    /** Register handler for incoming audio */
+    onAudioChunk(handler: (sessionId: string, chunk: AudioChunk) => void): void;
+    /** Register handler for new connections */
+    onConnect(handler: (session: Session) => void): void;
+    /** Register handler for disconnections */
+    onDisconnect(handler: (session: Session) => void): void;
+    /** Send audio to a specific session */
+    sendAudio(sessionId: string, chunk: AudioChunk): Promise<void>;
+}
+export interface TransportOptions {
+    port: number;
+    host?: string;
+}
+/** Speech-to-Text provider interface */
+export interface STTProvider {
+    /** Provider name (e.g., "deepgram", "whisper") */
+    readonly name: string;
+    /** Start a streaming recognition session */
+    createStream(options?: STTStreamOptions): STTStream;
+}
+export interface STTStreamOptions {
+    /** Language code (e.g., "en-US") */
+    language?: string;
+    /** Enable interim/partial results */
+    interimResults?: boolean;
+    /** Custom vocabulary/keywords to boost */
+    keywords?: string[];
+}
+export interface STTStream {
+    /** Feed audio data into the recognizer */
+    write(chunk: AudioChunk): void;
+    /** Register handler for transcription results */
+    onResult(handler: (result: STTResult) => void): void;
+    /** Close the stream */
+    close(): Promise<void>;
+}
+export interface STTResult {
+    /** Transcribed text */
+    text: string;
+    /** Whether this is a final or interim result */
+    isFinal: boolean;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Word-level timestamps (if available) */
+    words?: Array<{
+        word: string;
+        startMs: number;
+        endMs: number;
+    }>;
+}
+/** Text-to-Speech provider interface */
+export interface TTSProvider {
+    /** Provider name (e.g., "elevenlabs", "edge-tts") */
+    readonly name: string;
+    /** Synthesize text to audio — returns a stream of audio chunks */
+    synthesize(text: string, options?: TTSOptions): AsyncIterable<AudioChunk>;
+}
+export interface TTSOptions {
+    /** Voice ID or name */
+    voice?: string;
+    /** Speaking speed multiplier (1.0 = normal) */
+    speed?: number;
+    /** Voice pitch adjustment */
+    pitch?: number;
+}
+/** Voice Activity Detection interface */
+export interface VADProvider {
+    /** Provider name */
+    readonly name: string;
+    /** Process an audio chunk and detect speech */
+    process(chunk: AudioChunk): VADResult;
+    /** Reset internal state */
+    reset(): void;
+}
+export interface VADResult {
+    /** Whether speech is detected in this chunk */
+    isSpeech: boolean;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Speech event (if a transition occurred) */
+    event?: VADEvent;
+}
+export type VADEvent = {
+    type: "speech_start";
+    timestampMs: number;
+} | {
+    type: "speech_end";
+    timestampMs: number;
+    durationMs: number;
+};
+/** LLM provider interface */
+export interface LLMProvider {
+    /** Provider name (e.g., "openai", "anthropic") */
+    readonly name: string;
+    /** Create an LLM interface with specific config */
+    create(options: LLMOptions): LLMInterface;
+}
+export interface LLMOptions {
+    /** Model name (e.g., "gpt-4o-mini") */
+    model: string;
+    /** Temperature (0-2) */
+    temperature?: number;
+    /** Max tokens to generate */
+    maxTokens?: number;
+}
+/** LLM interface used by action handlers */
+export interface LLMInterface {
+    /** Generate a response given a prompt and conversation context */
+    generate(prompt: string, context?: LLMContext): Promise<string>;
+    /** Generate a streaming response */
+    generateStream(prompt: string, context?: LLMContext): AsyncIterable<string>;
+}
+export interface LLMContext {
+    /** System prompt */
+    systemPrompt?: string;
+    /** Conversation history */
+    history?: Array<{
+        role: "user" | "assistant" | "system";
+        content: string;
+    }>;
+    /** Additional instructions */
+    instructions?: string;
+}
+/** A tool that the agent can call */
+export interface AgentTool {
+    /** Unique tool name */
+    name: string;
+    /** Description of what this tool does */
+    description: string;
+    /** JSON schema for the tool's parameters */
+    parameters: Record<string, unknown>;
+    /** Execute the tool */
+    execute: (params: Record<string, unknown>) => Promise<unknown>;
+}
+/** Tool executor interface */
+export interface ToolExecutor {
+    /** Call a registered tool by name */
+    call(toolName: string, params?: Record<string, unknown>): Promise<unknown>;
+    /** List all registered tools */
+    list(): AgentTool[];
+}
+/** Conversation memory manager */
+export interface MemoryManager {
+    /** Add a turn to memory */
+    addTurn(turn: ConversationTurn): void;
+    /** Get all turns */
+    getTurns(): ConversationTurn[];
+    /** Get the last N turns */
+    getRecentTurns(n: number): ConversationTurn[];
+    /** Set a slot value */
+    setSlot(key: string, value: unknown): void;
+    /** Get a slot value */
+    getSlot(key: string): unknown;
+    /** Get all slots */
+    getSlots(): Record<string, unknown>;
+    /** Clear all memory */
+    clear(): void;
+    /** Build the full conversation context */
+    buildContext(session: Session, systemPrompt: string): ConversationContext;
+}
+/** JEV (Joint Embedding Vector) engine interface */
+export interface JEVEngine {
+    /** Initialize the engine (load models, embed action space) */
+    initialize(actions: AgentAction[]): Promise<void>;
+    /** Full pipeline: encode context → predict → match to action */
+    decide(context: ConversationContext): Promise<ActionMatch>;
+    /** Encode conversation context into a vector */
+    encode(context: ConversationContext): Promise<Float64Array>;
+    /** Predict the next state vector from a context vector */
+    predict(contextVector: Float64Array): Promise<Float64Array>;
+    /** Match a vector to the closest action */
+    match(vector: Float64Array): Promise<ActionMatch>;
+}
+/** Embedding provider for JEV */
+export interface EmbeddingProvider {
+    /** Provider name */
+    readonly name: string;
+    /** Embed a single text string */
+    embed(text: string): Promise<Float64Array>;
+    /** Embed multiple texts in a batch */
+    embedBatch(texts: string[]): Promise<Float64Array[]>;
+    /** Dimensionality of the embeddings */
+    readonly dimensions: number;
+}
+/** Lifecycle hooks for the agent */
+export interface AgentHooks {
+    /** Called when a new session starts */
+    onCallStart?: (session: Session) => Promise<void>;
+    /** Called when JEV selects an action */
+    onActionSelected?: (action: AgentAction, confidence: number, context: ConversationContext) => Promise<void>;
+    /** Called after the agent speaks */
+    onAgentSpoke?: (text: string, session: Session) => Promise<void>;
+    /** Called after the user speaks */
+    onUserSpoke?: (text: string, session: Session) => Promise<void>;
+    /** Called when a session ends */
+    onCallEnd?: (session: Session, turns: ConversationTurn[]) => Promise<void>;
+    /** Called on any error */
+    onError?: (error: Error, session?: Session) => Promise<void>;
+    /** Called when the user interrupts (barge-in) */
+    onBargeIn?: (session: Session) => Promise<void>;
+}
+/** Full configuration for a FelAgent */
+export interface FelAgentConfig {
+    /** Agent name */
+    name: string;
+    /** System prompt that defines the agent's personality */
+    systemPrompt: string;
+    /** STT provider configuration */
+    stt: {
+        provider: string;
+        apiKey?: string;
+        language?: string;
+        [key: string]: unknown;
+    };
+    /** TTS provider configuration */
+    tts: {
+        provider: string;
+        apiKey?: string;
+        voice?: string;
+        [key: string]: unknown;
+    };
+    /** LLM provider configuration */
+    llm: {
+        provider: string;
+        apiKey?: string;
+        model?: string;
+        temperature?: number;
+        [key: string]: unknown;
+    };
+    /** JEV engine configuration */
+    jev?: {
+        /** Embedding model/provider to use */
+        embeddingProvider?: string;
+        embeddingApiKey?: string;
+        /** Path to a trained predictor model (ONNX) */
+        predictorModel?: string;
+        /** Minimum confidence threshold — below this, fall back to LLM-only */
+        confidenceThreshold?: number;
+    };
+    /** Actions the agent can take */
+    actions: AgentAction[];
+    /** Tools the agent can call */
+    tools?: AgentTool[];
+    /** Lifecycle hooks */
+    hooks?: AgentHooks;
+    /** Transport config */
+    transport?: {
+        type?: "websocket" | "webrtc";
+        port?: number;
+        host?: string;
+    };
+    /** Logging configuration */
+    logging?: {
+        /** Enable call logging for JEV training */
+        enabled?: boolean;
+        /** Directory to write logs */
+        logDir?: string;
+        /** Log level */
+        level?: "debug" | "info" | "warn" | "error";
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,13 @@
+/**
+ * Core type definitions for Felona Voice.
+ *
+ * These types define the contracts between all modules in the framework.
+ * Every provider, engine, and component implements interfaces defined here.
+ */
+/** Default audio format used throughout the pipeline */
+export const DEFAULT_AUDIO_FORMAT = {
+    sampleRate: 16000,
+    channels: 1,
+    bitDepth: 16,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,wDAAwD;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,EAAE;CACJ,CAAC"}

package/dist/vad/energy.d.ts

@@ -0,0 +1,49 @@
+import type { VADProvider, VADResult, AudioChunk } from "../types.js";
+/**
+ * EnergyVAD — Simple energy-based Voice Activity Detection.
+ *
+ * This is a lightweight, zero-dependency VAD that detects speech
+ * based on audio energy levels (RMS). It works well for most use cases
+ * and requires no model loading.
+ *
+ * For Phase 1, this replaces the Silero VAD (which needs ONNX) to
+ * avoid the heavy dependency. Silero VAD will be added in Phase 2
+ * as an optional higher-accuracy alternative.
+ *
+ * Algorithm:
+ * 1. Compute RMS energy of each audio chunk
+ * 2. Compare against adaptive threshold
+ * 3. Use hangover timer to prevent false speech-end events
+ */
+export declare class EnergyVAD implements VADProvider {
+    readonly name = "energy";
+    private readonly speechThreshold;
+    private readonly silenceThreshold;
+    private readonly hangoverMs;
+    private readonly minSpeechMs;
+    private isSpeaking;
+    private speechStartMs;
+    private lastSpeechMs;
+    private energyHistory;
+    private readonly historySize;
+    constructor(options?: {
+        /** RMS threshold to start detecting speech (0-1). Default: 0.01 */
+        speechThreshold?: number;
+        /** RMS threshold to stop detecting speech (0-1). Default: 0.005 */
+        silenceThreshold?: number;
+        /** Milliseconds to wait after last speech before emitting speech_end. Default: 800 */
+        hangoverMs?: number;
+        /** Minimum speech duration to be considered valid. Default: 100 */
+        minSpeechMs?: number;
+    });
+    process(chunk: AudioChunk): VADResult;
+    reset(): void;
+    /** Get the average energy level over the recent history */
+    get averageEnergy(): number;
+}
+export declare function createEnergyVAD(options?: {
+    speechThreshold?: number;
+    silenceThreshold?: number;
+    hangoverMs?: number;
+}): EnergyVAD;
+//# sourceMappingURL=energy.d.ts.map

package/dist/vad/energy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"energy.d.ts","sourceRoot":"","sources":["../../src/vad/energy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAY,UAAU,EAAE,MAAM,aAAa,CAAC;AAEhF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAU,YAAW,WAAW;IAC3C,QAAQ,CAAC,IAAI,YAAY;IAEzB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAM;gBAEtB,OAAO,CAAC,EAAE;QACpB,mEAAmE;QACnE,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,mEAAmE;QACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,sFAAsF;QACtF,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,mEAAmE;QACnE,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;IAOD,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS;IAyCrC,KAAK,IAAI,IAAI;IAOb,2DAA2D;IAC3D,IAAI,aAAa,IAAI,MAAM,CAM1B;CACF;AAwBD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,SAAS,CAEZ"}

package/dist/vad/energy.js

@@ -0,0 +1,108 @@
+/**
+ * EnergyVAD — Simple energy-based Voice Activity Detection.
+ *
+ * This is a lightweight, zero-dependency VAD that detects speech
+ * based on audio energy levels (RMS). It works well for most use cases
+ * and requires no model loading.
+ *
+ * For Phase 1, this replaces the Silero VAD (which needs ONNX) to
+ * avoid the heavy dependency. Silero VAD will be added in Phase 2
+ * as an optional higher-accuracy alternative.
+ *
+ * Algorithm:
+ * 1. Compute RMS energy of each audio chunk
+ * 2. Compare against adaptive threshold
+ * 3. Use hangover timer to prevent false speech-end events
+ */
+export class EnergyVAD {
+    name = "energy";
+    speechThreshold;
+    silenceThreshold;
+    hangoverMs;
+    minSpeechMs;
+    isSpeaking = false;
+    speechStartMs = 0;
+    lastSpeechMs = 0;
+    energyHistory = [];
+    historySize = 30;
+    constructor(options) {
+        this.speechThreshold = options?.speechThreshold ?? 0.01;
+        this.silenceThreshold = options?.silenceThreshold ?? 0.005;
+        this.hangoverMs = options?.hangoverMs ?? 800;
+        this.minSpeechMs = options?.minSpeechMs ?? 100;
+    }
+    process(chunk) {
+        const rms = computeRMS(chunk.data, chunk.bitDepth);
+        this.energyHistory.push(rms);
+        if (this.energyHistory.length > this.historySize) {
+            this.energyHistory.shift();
+        }
+        const now = chunk.timestampMs;
+        let event;
+        if (!this.isSpeaking && rms >= this.speechThreshold) {
+            // Speech started
+            this.isSpeaking = true;
+            this.speechStartMs = now;
+            this.lastSpeechMs = now;
+            event = { type: "speech_start", timestampMs: now };
+        }
+        else if (this.isSpeaking) {
+            if (rms >= this.silenceThreshold) {
+                // Still speaking
+                this.lastSpeechMs = now;
+            }
+            else if (now - this.lastSpeechMs >= this.hangoverMs) {
+                // Silence exceeded hangover — speech ended
+                const durationMs = this.lastSpeechMs - this.speechStartMs;
+                if (durationMs >= this.minSpeechMs) {
+                    event = {
+                        type: "speech_end",
+                        timestampMs: now,
+                        durationMs,
+                    };
+                }
+                this.isSpeaking = false;
+            }
+        }
+        return {
+            isSpeech: this.isSpeaking,
+            confidence: rms >= this.speechThreshold ? Math.min(rms / this.speechThreshold, 1) : 0,
+            event,
+        };
+    }
+    reset() {
+        this.isSpeaking = false;
+        this.speechStartMs = 0;
+        this.lastSpeechMs = 0;
+        this.energyHistory = [];
+    }
+    /** Get the average energy level over the recent history */
+    get averageEnergy() {
+        if (this.energyHistory.length === 0)
+            return 0;
+        return (this.energyHistory.reduce((a, b) => a + b, 0) /
+            this.energyHistory.length);
+    }
+}
+/**
+ * Compute RMS (Root Mean Square) energy of a PCM audio buffer.
+ * Normalized to 0-1 range.
+ */
+function computeRMS(buffer, bitDepth) {
+    const samples = bitDepth === 16 ? buffer.length / 2 : buffer.length;
+    if (samples === 0)
+        return 0;
+    let sumSquares = 0;
+    const maxVal = bitDepth === 16 ? 32768 : 128;
+    for (let i = 0; i < buffer.length; i += bitDepth === 16 ? 2 : 1) {
+        const sample = bitDepth === 16
+            ? buffer.readInt16LE(i) / maxVal
+            : (buffer[i] - 128) / maxVal;
+        sumSquares += sample * sample;
+    }
+    return Math.sqrt(sumSquares / samples);
+}
+export function createEnergyVAD(options) {
+    return new EnergyVAD(options);
+}
+//# sourceMappingURL=energy.js.map

package/dist/vad/energy.js.map

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

package/dist/vad/index.d.ts

@@ -0,0 +1,2 @@
+export { EnergyVAD, createEnergyVAD } from "./energy.js";
+//# sourceMappingURL=index.d.ts.map