@framers/agentos 0.1.46 → 0.1.48

package/dist/rag/HydeRetriever.js

@@ -0,0 +1,143 @@
+/**
+ * @fileoverview HyDE (Hypothetical Document Embedding) retriever.
+ *
+ * Instead of embedding the raw user query for retrieval, HyDE first generates
+ * a hypothetical answer using an LLM, then embeds THAT answer to search the
+ * vector store. The hypothesis is semantically closer to stored answers than
+ * the raw question, improving retrieval quality.
+ *
+ * Supports adaptive thresholding: starts at a high similarity threshold and
+ * steps down until content is found, ensuring full coverage.
+ *
+ * Based on: Gao et al. 2023 "Precise Zero-Shot Dense Retrieval without
+ * Relevance Labels" and Lei et al. 2025 "Never Come Up Empty: Adaptive HyDE
+ * Retrieval for Improving LLM Developer Support".
+ *
+ * @module agentos/rag/HydeRetriever
+ */
+export const DEFAULT_HYDE_CONFIG = {
+    enabled: false,
+    initialThreshold: 0.7,
+    minThreshold: 0.3,
+    thresholdStep: 0.1,
+    adaptiveThreshold: true,
+    maxHypothesisTokens: 200,
+    hypothesisSystemPrompt: 'You are a knowledgeable assistant. Generate a concise, factual answer to the following question. ' +
+        'This answer will be used for semantic search, so be specific and include relevant technical terms.',
+    fullAnswerGranularity: true,
+};
+/** Merge partial config with defaults. */
+export function resolveHydeConfig(partial) {
+    return { ...DEFAULT_HYDE_CONFIG, ...partial };
+}
+// ── Core Retriever ─────────────────────────────────────────────────────────
+/**
+ * HyDE retriever: generates a hypothetical answer, embeds it, and searches
+ * the vector store with adaptive thresholding.
+ */
+export class HydeRetriever {
+    constructor(opts) {
+        this.config = resolveHydeConfig(opts.config);
+        this.llmCaller = opts.llmCaller;
+        this.embeddingManager = opts.embeddingManager;
+    }
+    /** Whether HyDE is enabled. */
+    get enabled() {
+        return this.config.enabled;
+    }
+    /**
+     * Generate a hypothetical answer for a query.
+     */
+    async generateHypothesis(query) {
+        const start = Date.now();
+        const hypothesis = await this.llmCaller(this.config.hypothesisSystemPrompt, query);
+        return {
+            hypothesis: hypothesis.trim(),
+            latencyMs: Date.now() - start,
+        };
+    }
+    /**
+     * Embed the hypothesis and search the vector store.
+     * Uses adaptive thresholding: starts at initialThreshold, steps down
+     * until results are found or minThreshold is reached.
+     */
+    async retrieve(opts) {
+        // Step 1: Generate hypothesis
+        let hypothesis;
+        let hypothesisLatencyMs;
+        if (opts.hypothesis) {
+            hypothesis = opts.hypothesis;
+            hypothesisLatencyMs = 0;
+        }
+        else {
+            const result = await this.generateHypothesis(opts.query);
+            hypothesis = result.hypothesis;
+            hypothesisLatencyMs = result.latencyMs;
+        }
+        // Step 2: Embed the hypothesis
+        const retrievalStart = Date.now();
+        const embeddingResponse = await this.embeddingManager.generateEmbeddings({
+            texts: [hypothesis],
+        });
+        if (!embeddingResponse.embeddings?.[0]?.length) {
+            // Embedding failed — return empty result
+            return {
+                hypothesis,
+                hypothesisEmbedding: [],
+                queryResult: { documents: [] },
+                effectiveThreshold: this.config.initialThreshold,
+                thresholdSteps: 0,
+                hypothesisLatencyMs,
+                retrievalLatencyMs: Date.now() - retrievalStart,
+            };
+        }
+        const hypothesisEmbedding = embeddingResponse.embeddings[0];
+        // Step 3: Adaptive threshold search
+        let threshold = this.config.initialThreshold;
+        let steps = 0;
+        let queryResult = { documents: [] };
+        while (threshold >= this.config.minThreshold) {
+            const queryOpts = {
+                topK: opts.queryOptions?.topK ?? 5,
+                minSimilarityScore: threshold,
+                includeTextContent: true,
+                includeMetadata: true,
+                ...opts.queryOptions,
+            };
+            queryResult = await opts.vectorStore.query(opts.collectionName, hypothesisEmbedding, queryOpts);
+            if (queryResult.documents.length > 0 || !this.config.adaptiveThreshold) {
+                break;
+            }
+            // Step down threshold
+            threshold = Math.round((threshold - this.config.thresholdStep) * 100) / 100;
+            steps++;
+        }
+        return {
+            hypothesis,
+            hypothesisEmbedding,
+            queryResult,
+            effectiveThreshold: Math.max(threshold, this.config.minThreshold),
+            thresholdSteps: steps,
+            hypothesisLatencyMs,
+            retrievalLatencyMs: Date.now() - retrievalStart,
+        };
+    }
+    /**
+     * Convenience: retrieve and format as augmented context string.
+     */
+    async retrieveContext(opts) {
+        const result = await this.retrieve(opts);
+        const separator = opts.separator ?? '\n\n---\n\n';
+        const chunks = result.queryResult.documents
+            .map((doc) => doc.textContent || '')
+            .filter(Boolean);
+        return {
+            context: chunks.join(separator),
+            hypothesis: result.hypothesis,
+            effectiveThreshold: result.effectiveThreshold,
+            chunkCount: chunks.length,
+            latencyMs: result.hypothesisLatencyMs + result.retrievalLatencyMs,
+        };
+    }
+}
+//# sourceMappingURL=HydeRetriever.js.map

package/dist/rag/HydeRetriever.js.map

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

package/dist/rag/IRetrievalAugmentor.d.ts

@@ -186,6 +186,21 @@ export interface RagRetrievalOptions {
     includeEmbeddings?: boolean;
     /** Query embedding model override. */
     queryEmbeddingModelId?: string;
+    /**
+     * HyDE (Hypothetical Document Embedding) configuration.
+     * When enabled, generates a hypothetical answer before embedding for
+     * improved retrieval quality. Adds one LLM call per retrieval.
+     */
+    hyde?: {
+        /** Enable HyDE for this retrieval. Default: false. */
+        enabled?: boolean;
+        /** Initial similarity threshold for adaptive thresholding. Default: 0.7. */
+        initialThreshold?: number;
+        /** Minimum threshold to step down to. Default: 0.3. */
+        minThreshold?: number;
+        /** Pre-generated hypothesis (skip LLM call if provided). */
+        hypothesis?: string;
+    };
     /** Advisory token/character budget for final context construction. */
     tokenBudgetForContext?: number;
     /** Caller identity for logging/billing. */

package/dist/rag/IRetrievalAugmentor.d.ts.map

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

package/dist/rag/index.d.ts

@@ -90,6 +90,7 @@ export type { IRetrievalAugmentor, RagDocumentInput, RagIngestionOptions, RagIng
 export { VectorStoreManager } from './VectorStoreManager.js';
 export { EmbeddingManager } from './EmbeddingManager.js';
 export { RetrievalAugmentor } from './RetrievalAugmentor.js';
+export { HydeRetriever, type HydeConfig, type HydeLlmCaller, type HydeRetrievalResult, DEFAULT_HYDE_CONFIG, resolveHydeConfig, } from './HydeRetriever.js';
 export { InMemoryVectorStore } from './implementations/vector_stores/InMemoryVectorStore.js';
 export { SqlVectorStore, type SqlVectorStoreConfig } from './implementations/vector_stores/SqlVectorStore.js';
 export { HnswlibVectorStore, type HnswlibVectorStoreConfig } from './implementations/vector_stores/HnswlibVectorStore.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AAMH,YAAY,EACV,YAAY,EACZ,yBAAyB,EACzB,cAAc,EACd,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,KAAK,wBAAwB,EAAE,MAAM,uDAAuD,CAAC;AAC1H,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAMvH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAM7B,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AAMH,YAAY,EACV,YAAY,EACZ,yBAAyB,EACzB,cAAc,EACd,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,KAAK,wBAAwB,EAAE,MAAM,uDAAuD,CAAC;AAC1H,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAMvH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAM7B,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC"}

package/dist/rag/index.js

@@ -89,6 +89,8 @@
 export { VectorStoreManager } from './VectorStoreManager.js';
 export { EmbeddingManager } from './EmbeddingManager.js';
 export { RetrievalAugmentor } from './RetrievalAugmentor.js';
+// HyDE (Hypothetical Document Embedding) Retriever
+export { HydeRetriever, DEFAULT_HYDE_CONFIG, resolveHydeConfig, } from './HydeRetriever.js';
 // ============================================================================
 // Vector Store Implementations
 // ============================================================================

package/dist/rag/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AA+CH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,cAAc,EAA6B,MAAM,mDAAmD,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAiC,MAAM,uDAAuD,CAAC;AAC1H,OAAO,EAAE,iBAAiB,EAAgC,MAAM,sDAAsD,CAAC;AAEvH,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsBrD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GAEnB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AA+CH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,mDAAmD;AACnD,OAAO,EACL,aAAa,EAIb,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,cAAc,EAA6B,MAAM,mDAAmD,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAiC,MAAM,uDAAuD,CAAC;AAC1H,OAAO,EAAE,iBAAiB,EAAgC,MAAM,sDAAsD,CAAC;AAEvH,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsBrD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GAEnB,MAAM,kBAAkB,CAAC"}

package/dist/speech/SpeechProviderRegistry.d.ts

@@ -0,0 +1,17 @@
+import type { SpeechProviderKind, SpeechToTextProvider, SpeechVadProvider, TextToSpeechProvider, WakeWordProvider } from './types.js';
+export declare class SpeechProviderRegistry {
+    private readonly sttProviders;
+    private readonly ttsProviders;
+    private readonly vadProviders;
+    private readonly wakeWordProviders;
+    registerSttProvider(provider: SpeechToTextProvider): void;
+    registerTtsProvider(provider: TextToSpeechProvider): void;
+    registerVadProvider(provider: SpeechVadProvider): void;
+    registerWakeWordProvider(provider: WakeWordProvider): void;
+    getSttProvider(id: string): SpeechToTextProvider | undefined;
+    getTtsProvider(id: string): TextToSpeechProvider | undefined;
+    getVadProvider(id: string): SpeechVadProvider | undefined;
+    getWakeWordProvider(id: string): WakeWordProvider | undefined;
+    list(kind: SpeechProviderKind): Array<SpeechToTextProvider | TextToSpeechProvider | SpeechVadProvider | WakeWordProvider>;
+}
+//# sourceMappingURL=SpeechProviderRegistry.d.ts.map

package/dist/speech/SpeechProviderRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpeechProviderRegistry.d.ts","sourceRoot":"","sources":["../../src/speech/SpeechProviderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2C;IACxE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2C;IACxE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwC;IACrE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuC;IAEzE,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIzD,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIzD,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAItD,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAI1D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAI5D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAI5D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIzD,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI7D,IAAI,CAAC,IAAI,EAAE,kBAAkB,GAAG,KAAK,CACnC,oBAAoB,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,gBAAgB,CACnF;CAcF"}

package/dist/speech/SpeechProviderRegistry.js

@@ -0,0 +1,47 @@
+export class SpeechProviderRegistry {
+    constructor() {
+        this.sttProviders = new Map();
+        this.ttsProviders = new Map();
+        this.vadProviders = new Map();
+        this.wakeWordProviders = new Map();
+    }
+    registerSttProvider(provider) {
+        this.sttProviders.set(provider.id, provider);
+    }
+    registerTtsProvider(provider) {
+        this.ttsProviders.set(provider.id, provider);
+    }
+    registerVadProvider(provider) {
+        this.vadProviders.set(provider.id, provider);
+    }
+    registerWakeWordProvider(provider) {
+        this.wakeWordProviders.set(provider.id, provider);
+    }
+    getSttProvider(id) {
+        return this.sttProviders.get(id);
+    }
+    getTtsProvider(id) {
+        return this.ttsProviders.get(id);
+    }
+    getVadProvider(id) {
+        return this.vadProviders.get(id);
+    }
+    getWakeWordProvider(id) {
+        return this.wakeWordProviders.get(id);
+    }
+    list(kind) {
+        switch (kind) {
+            case 'stt':
+                return [...this.sttProviders.values()];
+            case 'tts':
+                return [...this.ttsProviders.values()];
+            case 'vad':
+                return [...this.vadProviders.values()];
+            case 'wake-word':
+                return [...this.wakeWordProviders.values()];
+            default:
+                return [];
+        }
+    }
+}
+//# sourceMappingURL=SpeechProviderRegistry.js.map

package/dist/speech/SpeechProviderRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpeechProviderRegistry.js","sourceRoot":"","sources":["../../src/speech/SpeechProviderRegistry.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,sBAAsB;IAAnC;QACmB,iBAAY,GAAG,IAAI,GAAG,EAAgC,CAAC;QACvD,iBAAY,GAAG,IAAI,GAAG,EAAgC,CAAC;QACvD,iBAAY,GAAG,IAAI,GAAG,EAA6B,CAAC;QACpD,sBAAiB,GAAG,IAAI,GAAG,EAA4B,CAAC;IAkD3E,CAAC;IAhDC,mBAAmB,CAAC,QAA8B;QAChD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,mBAAmB,CAAC,QAA8B;QAChD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,mBAAmB,CAAC,QAA2B;QAC7C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,wBAAwB,CAAC,QAA0B;QACjD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,cAAc,CAAC,EAAU;QACvB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,cAAc,CAAC,EAAU;QACvB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,cAAc,CAAC,EAAU;QACvB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,mBAAmB,CAAC,EAAU;QAC5B,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,IAAwB;QAG3B,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,KAAK;gBACR,OAAO,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;YACzC,KAAK,KAAK;gBACR,OAAO,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;YACzC,KAAK,KAAK;gBACR,OAAO,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;YACzC,KAAK,WAAW;gBACd,OAAO,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9C;gBACE,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/speech/SpeechRuntime.d.ts

@@ -0,0 +1,30 @@
+import type { ExtensionManager } from '../extensions/ExtensionManager.js';
+import { SpeechProviderRegistry } from './SpeechProviderRegistry.js';
+import { SpeechSession } from './SpeechSession.js';
+import type { SpeechProviderCatalogEntry, SpeechRuntimeConfig, SpeechRuntimeSessionConfig, SpeechToTextProvider, SpeechVadProvider, TextToSpeechProvider, WakeWordProvider } from './types.js';
+export declare class SpeechRuntime {
+    private readonly registry;
+    private readonly preferredSttProviderId;
+    private readonly preferredTtsProviderId;
+    constructor(config?: SpeechRuntimeConfig);
+    getProviderRegistry(): SpeechProviderRegistry;
+    registerSttProvider(provider: SpeechToTextProvider): void;
+    registerTtsProvider(provider: TextToSpeechProvider): void;
+    registerVadProvider(provider: SpeechVadProvider): void;
+    registerWakeWordProvider(provider: WakeWordProvider): void;
+    hydrateFromExtensionManager(manager: ExtensionManager): void;
+    createSession(config?: SpeechRuntimeSessionConfig): SpeechSession;
+    listProviders(): Array<SpeechProviderCatalogEntry & {
+        registered: boolean;
+    }>;
+    getProvider(id: string): SpeechToTextProvider | TextToSpeechProvider | SpeechVadProvider | WakeWordProvider | undefined;
+    private isProviderRegistered;
+    private resolveDefaultSttProvider;
+    private resolveDefaultTtsProvider;
+    private resolveDefaultVadProvider;
+    private resolveDefaultWakeWordProvider;
+}
+export declare function createSpeechRuntime(config?: SpeechRuntimeConfig): SpeechRuntime;
+export declare function createSpeechRuntimeFromEnv(env?: Record<string, string | undefined>, config?: Omit<SpeechRuntimeConfig, 'env'>): SpeechRuntime;
+export declare function getDefaultSpeechProviderId(kind: 'stt' | 'tts'): string | undefined;
+//# sourceMappingURL=SpeechRuntime.d.ts.map

package/dist/speech/SpeechRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpeechRuntime.d.ts","sourceRoot":"","sources":["../../src/speech/SpeechRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAQ1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnD,OAAO,KAAK,EACV,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAqB;IAC5D,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAqB;gBAEhD,MAAM,GAAE,mBAAwB;IA2C5C,mBAAmB,IAAI,sBAAsB;IAI7C,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIzD,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIzD,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAItD,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAI1D,2BAA2B,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAe5D,aAAa,CAAC,MAAM,GAAE,0BAA+B,GAAG,aAAa;IAkBrE,aAAa,IAAI,KAAK,CAAC,0BAA0B,GAAG;QAAE,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IAO5E,WAAW,CAAC,EAAE,EAAE,MAAM,GAClB,oBAAoB,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,gBAAgB,GAChB,SAAS;IASb,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,yBAAyB;IAWjC,OAAO,CAAC,yBAAyB;IAYjC,OAAO,CAAC,yBAAyB;IAOjC,OAAO,CAAC,8BAA8B;CAGvC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,mBAAwB,GAAG,aAAa,CAEnF;AAED,wBAAgB,0BAA0B,CACxC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,MAAM,GAAE,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAM,GAC5C,aAAa,CAEf;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAKlF"}

package/dist/speech/SpeechRuntime.js

@@ -0,0 +1,156 @@
+import { EXTENSION_KIND_STT_PROVIDER, EXTENSION_KIND_TTS_PROVIDER, EXTENSION_KIND_VAD_PROVIDER, EXTENSION_KIND_WAKE_WORD_PROVIDER, } from '../extensions/types.js';
+import { findSpeechProviderCatalogEntry, getSpeechProviderCatalog } from './providerCatalog.js';
+import { SpeechProviderRegistry } from './SpeechProviderRegistry.js';
+import { SpeechSession } from './SpeechSession.js';
+import { BuiltInAdaptiveVadProvider } from './providers/BuiltInAdaptiveVadProvider.js';
+import { ElevenLabsTextToSpeechProvider } from './providers/ElevenLabsTextToSpeechProvider.js';
+import { OpenAITextToSpeechProvider } from './providers/OpenAITextToSpeechProvider.js';
+import { OpenAIWhisperSpeechToTextProvider } from './providers/OpenAIWhisperSpeechToTextProvider.js';
+export class SpeechRuntime {
+    constructor(config = {}) {
+        this.registry = new SpeechProviderRegistry();
+        this.preferredSttProviderId =
+            typeof config.preferredSttProviderId === 'string' && config.preferredSttProviderId.trim()
+                ? config.preferredSttProviderId.trim()
+                : undefined;
+        this.preferredTtsProviderId =
+            typeof config.preferredTtsProviderId === 'string' && config.preferredTtsProviderId.trim()
+                ? config.preferredTtsProviderId.trim()
+                : undefined;
+        this.registry.registerVadProvider(new BuiltInAdaptiveVadProvider());
+        if (config.autoRegisterFromEnv !== false) {
+            const env = config.env ?? process.env;
+            const openaiApiKey = env['OPENAI_API_KEY'];
+            if (openaiApiKey) {
+                this.registry.registerSttProvider(new OpenAIWhisperSpeechToTextProvider({
+                    apiKey: openaiApiKey,
+                    model: env['WHISPER_MODEL_DEFAULT'] ?? 'whisper-1',
+                }));
+                this.registry.registerTtsProvider(new OpenAITextToSpeechProvider({
+                    apiKey: openaiApiKey,
+                    model: env['OPENAI_TTS_DEFAULT_MODEL'] ?? 'tts-1',
+                    voice: env['OPENAI_TTS_DEFAULT_VOICE'] ?? 'nova',
+                }));
+            }
+            const elevenLabsApiKey = env['ELEVENLABS_API_KEY'];
+            if (elevenLabsApiKey) {
+                this.registry.registerTtsProvider(new ElevenLabsTextToSpeechProvider({
+                    apiKey: elevenLabsApiKey,
+                    model: env['ELEVENLABS_TTS_MODEL'] ?? 'eleven_multilingual_v2',
+                    voiceId: env['ELEVENLABS_VOICE_ID'],
+                }));
+            }
+        }
+    }
+    getProviderRegistry() {
+        return this.registry;
+    }
+    registerSttProvider(provider) {
+        this.registry.registerSttProvider(provider);
+    }
+    registerTtsProvider(provider) {
+        this.registry.registerTtsProvider(provider);
+    }
+    registerVadProvider(provider) {
+        this.registry.registerVadProvider(provider);
+    }
+    registerWakeWordProvider(provider) {
+        this.registry.registerWakeWordProvider(provider);
+    }
+    hydrateFromExtensionManager(manager) {
+        for (const descriptor of manager.getRegistry(EXTENSION_KIND_STT_PROVIDER).listActive()) {
+            this.registry.registerSttProvider(descriptor.payload);
+        }
+        for (const descriptor of manager.getRegistry(EXTENSION_KIND_TTS_PROVIDER).listActive()) {
+            this.registry.registerTtsProvider(descriptor.payload);
+        }
+        for (const descriptor of manager.getRegistry(EXTENSION_KIND_VAD_PROVIDER).listActive()) {
+            this.registry.registerVadProvider(descriptor.payload);
+        }
+        for (const descriptor of manager.getRegistry(EXTENSION_KIND_WAKE_WORD_PROVIDER).listActive()) {
+            this.registry.registerWakeWordProvider(descriptor.payload);
+        }
+    }
+    createSession(config = {}) {
+        const providers = {
+            stt: config.sttProviderId
+                ? this.registry.getSttProvider(config.sttProviderId)
+                : this.resolveDefaultSttProvider(),
+            tts: config.ttsProviderId
+                ? this.registry.getTtsProvider(config.ttsProviderId)
+                : this.resolveDefaultTtsProvider(),
+            vad: config.vadProviderId
+                ? this.registry.getVadProvider(config.vadProviderId)
+                : this.resolveDefaultVadProvider(),
+            wakeWord: config.wakeWordProviderId
+                ? this.registry.getWakeWordProvider(config.wakeWordProviderId)
+                : this.resolveDefaultWakeWordProvider(),
+        };
+        return new SpeechSession(config, providers);
+    }
+    listProviders() {
+        return getSpeechProviderCatalog().map((entry) => ({
+            ...entry,
+            registered: this.isProviderRegistered(entry),
+        }));
+    }
+    getProvider(id) {
+        return (this.registry.getSttProvider(id) ??
+            this.registry.getTtsProvider(id) ??
+            this.registry.getVadProvider(id) ??
+            this.registry.getWakeWordProvider(id));
+    }
+    isProviderRegistered(entry) {
+        switch (entry.kind) {
+            case 'stt':
+                return Boolean(this.registry.getSttProvider(entry.id));
+            case 'tts':
+                return Boolean(this.registry.getTtsProvider(entry.id));
+            case 'vad':
+                return Boolean(this.registry.getVadProvider(entry.id));
+            case 'wake-word':
+                return Boolean(this.registry.getWakeWordProvider(entry.id));
+            default:
+                return false;
+        }
+    }
+    resolveDefaultSttProvider() {
+        if (this.preferredSttProviderId) {
+            const preferred = this.registry.getSttProvider(this.preferredSttProviderId);
+            if (preferred)
+                return preferred;
+        }
+        return (this.registry.getSttProvider('openai-whisper') ??
+            this.registry.list('stt')[0]);
+    }
+    resolveDefaultTtsProvider() {
+        if (this.preferredTtsProviderId) {
+            const preferred = this.registry.getTtsProvider(this.preferredTtsProviderId);
+            if (preferred)
+                return preferred;
+        }
+        return (this.registry.getTtsProvider('openai-tts') ??
+            this.registry.getTtsProvider('elevenlabs') ??
+            this.registry.list('tts')[0]);
+    }
+    resolveDefaultVadProvider() {
+        return (this.registry.getVadProvider('agentos-adaptive-vad') ??
+            this.registry.list('vad')[0]);
+    }
+    resolveDefaultWakeWordProvider() {
+        return this.registry.list('wake-word')[0];
+    }
+}
+export function createSpeechRuntime(config = {}) {
+    return new SpeechRuntime(config);
+}
+export function createSpeechRuntimeFromEnv(env = process.env, config = {}) {
+    return new SpeechRuntime({ ...config, autoRegisterFromEnv: config.autoRegisterFromEnv ?? true, env });
+}
+export function getDefaultSpeechProviderId(kind) {
+    if (kind === 'stt') {
+        return findSpeechProviderCatalogEntry('openai-whisper')?.id;
+    }
+    return findSpeechProviderCatalogEntry('openai-tts')?.id;
+}
+//# sourceMappingURL=SpeechRuntime.js.map

package/dist/speech/SpeechRuntime.js.map

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

package/dist/speech/SpeechSession.d.ts

@@ -0,0 +1,37 @@
+import { EventEmitter } from 'node:events';
+import type { SpeechSessionConfig, SpeechSessionAudioCapture, SpeechSessionBoundaryReason, SpeechSessionEventMap, SpeechSessionProviders, SpeechSessionState, SpeechSynthesisOptions, SpeechTranscriptionOptions } from './types.js';
+export declare class SpeechSession extends EventEmitter {
+    private readonly config;
+    private readonly providers;
+    private readonly calibrator;
+    private readonly vad;
+    private readonly silenceDetector;
+    private state;
+    private readonly capturedFrames;
+    private currentSpeechStartedAt;
+    private wakeWordDetected;
+    private transcriptionPromise;
+    private lastExternalVadSpeech;
+    on<U extends keyof SpeechSessionEventMap>(event: U, listener: SpeechSessionEventMap[U]): this;
+    emit<U extends keyof SpeechSessionEventMap>(event: U, ...args: Parameters<SpeechSessionEventMap[U]>): boolean;
+    constructor(config?: SpeechSessionConfig, providers?: SpeechSessionProviders);
+    getState(): SpeechSessionState;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    flush(reason?: SpeechSessionBoundaryReason): Promise<void>;
+    close(): Promise<void>;
+    ingestFrame(frame: Float32Array): Promise<void>;
+    transcribeAudio(audioBuffer: Buffer, options?: SpeechTranscriptionOptions, captureOverride?: SpeechSessionAudioCapture): Promise<void>;
+    speak(text: string, options?: SpeechSynthesisOptions): Promise<import("./types.js").SpeechSynthesisResult>;
+    interrupt(): void;
+    private bindVadEvents;
+    private bindSilenceEvents;
+    private handleExternalVadDecision;
+    private finalizeUtterance;
+    private createCapture;
+    private resetBuffers;
+    private createSyntheticVadResult;
+    private changeState;
+    private handleError;
+}
+//# sourceMappingURL=SpeechSession.d.ts.map

package/dist/speech/SpeechSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpeechSession.d.ts","sourceRoot":"","sources":["../../src/speech/SpeechSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAE3B,MAAM,YAAY,CAAC;AAEpB,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAMD;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IACrD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,sBAAsB,CAAuB;IACrD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,oBAAoB,CAA8B;IAC1D,OAAO,CAAC,qBAAqB,CAAS;IAEtB,EAAE,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACtD,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,GACjC,IAAI;IAIS,IAAI,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACxD,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,UAAU,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,GAC5C,OAAO;gBAIE,MAAM,GAAE,mBAAwB,EAAE,SAAS,GAAE,sBAA2B;IAwBpF,QAAQ,IAAI,kBAAkB;IAIxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAetB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,KAAK,CAAC,MAAM,GAAE,2BAAsC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA0C/C,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,0BAA+B,EACxC,eAAe,CAAC,EAAE,yBAAyB,GAC1C,OAAO,CAAC,IAAI,CAAC;IA6BV,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B;IAqB9D,SAAS,IAAI,IAAI;IAMjB,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,yBAAyB;YAgCnB,iBAAiB;IA0B/B,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,wBAAwB;IAUhC,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,WAAW;CAKpB"}