@dtelecom/agents-js 0.1.10 → 0.1.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/memory/index.ts","../../src/utils/logger.ts","../../src/memory/embedder.ts","../../src/memory/memory-store.ts","../../src/memory/room-memory.ts"],"sourcesContent":["export { Embedder } from './embedder';\nexport { MemoryStore } from './memory-store';\nexport type { TurnRow, SessionRow, SearchResult, SessionSearchResult } from './memory-store';\nexport { RoomMemory } from './room-memory';\nexport type { RoomMemoryConfig } from './room-memory';\n","export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';\n\nconst LEVELS: Record<LogLevel, number> = {\n debug: 0,\n info: 1,\n warn: 2,\n error: 3,\n silent: 4,\n};\n\n/** Default to 'debug' if DEBUG env var matches our namespace */\nfunction detectLevel(): LogLevel {\n const debug = typeof process !== 'undefined' && process.env?.DEBUG;\n if (debug && (debug === '*' || debug.includes('@dtelecom/agents'))) {\n return 'debug';\n }\n return 'info';\n}\n\nlet globalLevel: LogLevel = detectLevel();\n\nexport function setLogLevel(level: LogLevel): void {\n globalLevel = level;\n}\n\nexport function getLogLevel(): LogLevel {\n return globalLevel;\n}\n\nexport interface Logger {\n debug(...args: unknown[]): void;\n info(...args: unknown[]): void;\n warn(...args: unknown[]): void;\n error(...args: unknown[]): void;\n}\n\nfunction timestamp(): string {\n const d = new Date();\n const h = String(d.getHours()).padStart(2, '0');\n const m = String(d.getMinutes()).padStart(2, '0');\n const s = String(d.getSeconds()).padStart(2, '0');\n const ms = String(d.getMilliseconds()).padStart(3, '0');\n return `${h}:${m}:${s}.${ms}`;\n}\n\nexport function createLogger(tag: string): Logger {\n const prefix = `[@dtelecom/agents:${tag}]`;\n return {\n debug(...args: unknown[]) {\n if (LEVELS[globalLevel] <= LEVELS.debug) console.debug(timestamp(), prefix, ...args);\n },\n info(...args: unknown[]) {\n if (LEVELS[globalLevel] <= LEVELS.info) console.info(timestamp(), prefix, ...args);\n },\n warn(...args: unknown[]) {\n if (LEVELS[globalLevel] <= LEVELS.warn) console.warn(timestamp(), prefix, ...args);\n },\n error(...args: unknown[]) {\n if (LEVELS[globalLevel] <= LEVELS.error) console.error(timestamp(), prefix, ...args);\n },\n };\n}\n","/**\n * Embedder — local text embedding via @huggingface/transformers.\n *\n * Uses Xenova/all-MiniLM-L6-v2 (384 dimensions, ~22MB model).\n * Runs entirely in-process — no API calls, no cost.\n */\n\nimport { createLogger } from '../utils/logger';\n\nconst log = createLogger('Embedder');\n\nconst MODEL_NAME = 'Xenova/all-MiniLM-L6-v2';\nconst EMBEDDING_DIM = 384;\n\ntype FeatureExtractionPipeline = (\n text: string | string[],\n options?: { pooling?: string; normalize?: boolean },\n) => Promise<{ data: Float32Array }>;\n\nexport class Embedder {\n private pipeline: FeatureExtractionPipeline | null = null;\n private initPromise: Promise<void> | null = null;\n\n get dimensions(): number {\n return EMBEDDING_DIM;\n }\n\n /** Load the embedding model. Call once at startup. */\n async init(): Promise<void> {\n if (this.pipeline) return;\n if (this.initPromise) return this.initPromise;\n\n this.initPromise = this.loadModel();\n return this.initPromise;\n }\n\n private async loadModel(): Promise<void> {\n const start = performance.now();\n log.info(`Loading embedding model \"${MODEL_NAME}\"...`);\n\n const { pipeline } = await import('@huggingface/transformers');\n this.pipeline = (await pipeline('feature-extraction', MODEL_NAME)) as unknown as FeatureExtractionPipeline;\n\n log.info(`Embedding model loaded in ${(performance.now() - start).toFixed(0)}ms`);\n }\n\n /** Embed a single text. Returns Float32Array of length 384. */\n async embed(text: string): Promise<Float32Array> {\n await this.init();\n\n const result = await this.pipeline!(text, {\n pooling: 'mean',\n normalize: true,\n });\n\n return new Float32Array(result.data);\n }\n\n /** Cosine similarity between two normalized vectors. Returns value in [-1, 1]. */\n static cosineSimilarity(a: Float32Array, b: Float32Array): number {\n let dot = 0;\n for (let i = 0; i < a.length; i++) {\n dot += a[i] * b[i];\n }\n return dot;\n }\n\n /** Embed multiple texts in one call (more efficient than calling embed() in a loop). */\n async embedBatch(texts: string[]): Promise<Float32Array[]> {\n if (texts.length === 0) return [];\n await this.init();\n\n const results: Float32Array[] = [];\n // Process one at a time to avoid memory issues with large batches\n for (const text of texts) {\n const result = await this.pipeline!(text, {\n pooling: 'mean',\n normalize: true,\n });\n results.push(new Float32Array(result.data));\n }\n\n return results;\n }\n}\n","/**\n * MemoryStore — SQLite + sqlite-vec database layer for room memory.\n *\n * Single .db file stores:\n * - turns: every spoken turn (full transcript)\n * - sessions: meeting metadata + LLM-generated summaries\n * - turn_vectors: embedding index for semantic turn search\n * - session_vectors: embedding index for session summary search\n */\n\nimport Database from 'better-sqlite3';\nimport * as sqliteVec from 'sqlite-vec';\nimport { createLogger } from '../utils/logger';\n\nconst log = createLogger('MemoryStore');\n\nexport interface TurnRow {\n id: number;\n room: string;\n session_id: string;\n speaker: string;\n text: string;\n is_agent: number;\n created_at: number;\n}\n\nexport interface SessionRow {\n id: string;\n room: string;\n started_at: number;\n ended_at: number | null;\n participants: string | null;\n summary: string | null;\n turn_count: number;\n}\n\nexport interface SearchResult {\n speaker: string;\n text: string;\n created_at: number;\n session_id: string;\n distance: number;\n}\n\nexport interface SessionSearchResult {\n session_id: string;\n summary: string;\n started_at: number;\n distance: number;\n}\n\nexport class MemoryStore {\n private db: Database.Database;\n\n constructor(dbPath: string) {\n this.db = new Database(dbPath);\n this.db.pragma('journal_mode = WAL');\n this.db.pragma('synchronous = NORMAL');\n\n // Load sqlite-vec extension\n sqliteVec.load(this.db);\n\n this.createTables();\n log.info(`Memory store opened: ${dbPath}`);\n }\n\n private createTables(): void {\n this.db.exec(`\n CREATE TABLE IF NOT EXISTS turns (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n room TEXT NOT NULL,\n session_id TEXT NOT NULL,\n speaker TEXT NOT NULL,\n text TEXT NOT NULL,\n is_agent BOOLEAN DEFAULT 0,\n created_at INTEGER NOT NULL\n );\n\n CREATE TABLE IF NOT EXISTS sessions (\n id TEXT PRIMARY KEY,\n room TEXT NOT NULL,\n started_at INTEGER NOT NULL,\n ended_at INTEGER,\n participants TEXT,\n summary TEXT,\n turn_count INTEGER DEFAULT 0\n );\n\n CREATE INDEX IF NOT EXISTS idx_turns_room_session ON turns(room, session_id);\n CREATE INDEX IF NOT EXISTS idx_turns_room_time ON turns(room, created_at);\n CREATE INDEX IF NOT EXISTS idx_sessions_room ON sessions(room);\n `);\n\n // Vector tables — sqlite-vec virtual tables\n // Check if they exist first (CREATE VIRTUAL TABLE doesn't support IF NOT EXISTS)\n const hasVecTable = this.db.prepare(\n \"SELECT name FROM sqlite_master WHERE type='table' AND name=?\",\n );\n\n if (!hasVecTable.get('turn_vectors')) {\n this.db.exec(`\n CREATE VIRTUAL TABLE turn_vectors USING vec0(\n turn_id INTEGER PRIMARY KEY,\n embedding FLOAT[384] distance_metric=cosine\n );\n `);\n }\n\n if (!hasVecTable.get('session_vectors')) {\n this.db.exec(`\n CREATE VIRTUAL TABLE session_vectors USING vec0(\n session_id TEXT PRIMARY KEY,\n embedding FLOAT[384] distance_metric=cosine\n );\n `);\n }\n }\n\n /** Insert a turn and its embedding vector. */\n insertTurn(\n room: string,\n sessionId: string,\n speaker: string,\n text: string,\n isAgent: boolean,\n embedding: Float32Array,\n ): number {\n const stmt = this.db.prepare(`\n INSERT INTO turns (room, session_id, speaker, text, is_agent, created_at)\n VALUES (?, ?, ?, ?, ?, ?)\n `);\n const info = stmt.run(room, sessionId, speaker, text, isAgent ? 1 : 0, Date.now());\n const turnId = info.lastInsertRowid;\n\n // Insert embedding vector — sqlite-vec requires BigInt for integer PKs\n this.db.prepare(\n 'INSERT INTO turn_vectors (turn_id, embedding) VALUES (?, ?)',\n ).run(BigInt(turnId), Buffer.from(embedding.buffer));\n\n return Number(turnId);\n }\n\n /** Create a new session record. */\n insertSession(id: string, room: string): void {\n this.db.prepare(`\n INSERT INTO sessions (id, room, started_at)\n VALUES (?, ?, ?)\n `).run(id, room, Date.now());\n }\n\n /** Update a session with summary and end time. */\n updateSessionSummary(\n sessionId: string,\n summary: string,\n turnCount: number,\n participants: string[],\n embedding: Float32Array,\n ): void {\n this.db.prepare(`\n UPDATE sessions\n SET summary = ?, ended_at = ?, turn_count = ?, participants = ?\n WHERE id = ?\n `).run(summary, Date.now(), turnCount, JSON.stringify(participants), sessionId);\n\n // Insert summary embedding\n this.db.prepare(\n 'INSERT INTO session_vectors (session_id, embedding) VALUES (?, ?)',\n ).run(sessionId, Buffer.from(embedding.buffer));\n }\n\n /** End a session without summary (e.g., too few turns). */\n endSession(sessionId: string, turnCount: number, participants: string[]): void {\n this.db.prepare(`\n UPDATE sessions\n SET ended_at = ?, turn_count = ?, participants = ?\n WHERE id = ?\n `).run(Date.now(), turnCount, JSON.stringify(participants), sessionId);\n }\n\n /** KNN search turns by embedding similarity. */\n searchTurns(room: string, queryEmbedding: Float32Array, limit: number): SearchResult[] {\n const rows = this.db.prepare(`\n SELECT t.speaker, t.text, t.created_at, t.session_id, tv.distance\n FROM turn_vectors tv\n JOIN turns t ON t.id = tv.turn_id\n WHERE t.room = ?\n AND tv.embedding MATCH ?\n AND k = ?\n ORDER BY tv.distance\n `).all(room, Buffer.from(queryEmbedding.buffer), limit * 2) as (TurnRow & { distance: number })[];\n\n // sqlite-vec returns k results from the vector index, then we filter by room\n return rows.slice(0, limit).map((r) => ({\n speaker: r.speaker,\n text: r.text,\n created_at: r.created_at,\n session_id: r.session_id,\n distance: r.distance,\n }));\n }\n\n /** KNN search session summaries by embedding similarity. */\n searchSessions(room: string, queryEmbedding: Float32Array, limit: number): SessionSearchResult[] {\n const rows = this.db.prepare(`\n SELECT s.id as session_id, s.summary, s.started_at, sv.distance\n FROM session_vectors sv\n JOIN sessions s ON s.id = sv.session_id\n WHERE s.room = ?\n AND sv.embedding MATCH ?\n AND k = ?\n ORDER BY sv.distance\n `).all(room, Buffer.from(queryEmbedding.buffer), limit * 2) as SessionSearchResult[];\n\n return rows\n .filter((r) => r.summary)\n .slice(0, limit);\n }\n\n /** Get the last N turns from a specific session. */\n getRecentTurns(room: string, sessionId: string, limit: number): TurnRow[] {\n return this.db.prepare(`\n SELECT * FROM turns\n WHERE room = ? AND session_id = ?\n ORDER BY created_at DESC\n LIMIT ?\n `).all(room, sessionId, limit) as TurnRow[];\n }\n\n /** Get all turns for a session (for summarization). */\n getSessionTurns(sessionId: string): TurnRow[] {\n return this.db.prepare(`\n SELECT * FROM turns\n WHERE session_id = ?\n ORDER BY created_at ASC\n `).all(sessionId) as TurnRow[];\n }\n\n /** Get total turn count for a session. */\n getSessionTurnCount(sessionId: string): number {\n const row = this.db.prepare(\n 'SELECT COUNT(*) as count FROM turns WHERE session_id = ?',\n ).get(sessionId) as { count: number };\n return row.count;\n }\n\n /** Close the database. */\n close(): void {\n this.db.close();\n log.info('Memory store closed');\n }\n}\n","/**\n * RoomMemory — high-level persistent memory for a room.\n *\n * Stores all conversation turns, provides semantic search,\n * and generates session summaries on session end.\n *\n * Uses SQLite + sqlite-vec for storage and local embeddings\n * via @huggingface/transformers. Everything runs in-process,\n * no external services needed.\n */\n\nimport { randomUUID } from 'crypto';\nimport { MemoryStore, type TurnRow, type SearchResult, type SessionSearchResult } from './memory-store';\nimport { Embedder } from './embedder';\nimport type { LLMPlugin, Message } from '../core/types';\nimport { createLogger } from '../utils/logger';\n\nconst log = createLogger('RoomMemory');\n\n/** Pending turn waiting to be embedded and stored. */\ninterface PendingTurn {\n speaker: string;\n text: string;\n isAgent: boolean;\n}\n\nexport interface RoomMemoryConfig {\n /** Path to SQLite database file */\n dbPath: string;\n /** Room name (scopes all data) */\n room: string;\n /** Flush pending turns every N ms (default: 5000) */\n flushIntervalMs?: number;\n}\n\nexport class RoomMemory {\n private readonly store: MemoryStore;\n private readonly embedder: Embedder;\n private readonly room: string;\n private sessionId: string | null = null;\n private participants = new Set<string>();\n private pendingTurns: PendingTurn[] = [];\n private flushTimer: ReturnType<typeof setInterval> | null = null;\n private readonly flushIntervalMs: number;\n private flushing = false;\n\n constructor(config: RoomMemoryConfig) {\n this.store = new MemoryStore(config.dbPath);\n this.embedder = new Embedder();\n this.room = config.room;\n this.flushIntervalMs = config.flushIntervalMs ?? 5000;\n }\n\n /** Get the embedder instance (for reuse in other components). */\n getEmbedder(): Embedder {\n return this.embedder;\n }\n\n /** Initialize embedder (loads model). Call once at startup. */\n async init(): Promise<void> {\n await this.embedder.init();\n }\n\n /** Start a new session for this room. */\n startSession(): string {\n this.sessionId = randomUUID();\n this.participants.clear();\n this.store.insertSession(this.sessionId, this.room);\n\n // Start periodic flush of pending turns\n this.flushTimer = setInterval(() => {\n this.flushPending().catch((err) => {\n log.error('Error flushing pending turns:', err);\n });\n }, this.flushIntervalMs);\n\n log.info(`Session started: ${this.sessionId}`);\n return this.sessionId;\n }\n\n /** Track a participant joining. */\n addParticipant(identity: string): void {\n this.participants.add(identity);\n }\n\n /**\n * Store a turn to memory. Non-blocking — queues for batch embedding.\n * Call this for EVERY final transcription, even if agent doesn't respond.\n */\n storeTurn(speaker: string, text: string, isAgent: boolean): void {\n if (!this.sessionId) {\n log.warn('storeTurn called without active session');\n return;\n }\n\n this.pendingTurns.push({ speaker, text, isAgent });\n\n // Flush immediately if we have 5+ pending turns\n if (this.pendingTurns.length >= 5) {\n this.flushPending().catch((err) => {\n log.error('Error flushing pending turns:', err);\n });\n }\n }\n\n /** Flush pending turns: embed and insert into database. */\n private async flushPending(): Promise<void> {\n if (this.flushing || this.pendingTurns.length === 0 || !this.sessionId) return;\n this.flushing = true;\n\n const batch = this.pendingTurns.splice(0);\n const texts = batch.map((t) => `[${t.speaker}]: ${t.text}`);\n\n try {\n const embeddings = await this.embedder.embedBatch(texts);\n\n for (let i = 0; i < batch.length; i++) {\n const turn = batch[i];\n this.store.insertTurn(\n this.room,\n this.sessionId,\n turn.speaker,\n turn.text,\n turn.isAgent,\n embeddings[i],\n );\n }\n\n log.debug(`Flushed ${batch.length} turns to memory`);\n } catch (err) {\n log.error('Error embedding/storing turns:', err);\n // Put turns back for retry\n this.pendingTurns.unshift(...batch);\n } finally {\n this.flushing = false;\n }\n }\n\n /**\n * Search memory for context relevant to a query.\n * Returns formatted string ready to inject into LLM system prompt.\n */\n async searchRelevant(query: string, turnLimit = 5, sessionLimit = 2): Promise<string> {\n const queryEmbedding = await this.embedder.embed(query);\n\n const turns = this.store.searchTurns(this.room, queryEmbedding, turnLimit);\n const sessions = this.store.searchSessions(this.room, queryEmbedding, sessionLimit);\n\n if (turns.length === 0 && sessions.length === 0) {\n return '';\n }\n\n const parts: string[] = [];\n\n if (sessions.length > 0) {\n parts.push('Past session summaries:');\n for (const s of sessions) {\n const date = new Date(s.started_at).toLocaleDateString();\n parts.push(` [${date}]: ${s.summary}`);\n }\n }\n\n if (turns.length > 0) {\n parts.push('Relevant past turns:');\n for (const t of turns) {\n const date = new Date(t.created_at).toLocaleDateString();\n const time = new Date(t.created_at).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });\n parts.push(` [${date} ${time}, ${t.speaker}]: ${t.text}`);\n }\n }\n\n return parts.join('\\n');\n }\n\n /**\n * End the current session. Generates an LLM summary and stores it.\n */\n async endSession(llm: LLMPlugin): Promise<void> {\n if (!this.sessionId) return;\n\n // Flush any remaining pending turns\n await this.flushPending();\n\n // Stop flush timer\n if (this.flushTimer) {\n clearInterval(this.flushTimer);\n this.flushTimer = null;\n }\n\n const turnCount = this.store.getSessionTurnCount(this.sessionId);\n const participantList = Array.from(this.participants);\n\n if (turnCount < 3) {\n // Too few turns for meaningful summary\n this.store.endSession(this.sessionId, turnCount, participantList);\n log.info(`Session ended (${turnCount} turns, no summary)`);\n this.sessionId = null;\n return;\n }\n\n // Generate summary\n try {\n const turns = this.store.getSessionTurns(this.sessionId);\n const transcript = turns\n .map((t) => `[${t.speaker}]: ${t.text}`)\n .join('\\n');\n\n const messages: Message[] = [\n {\n role: 'system',\n content: 'Summarize this tutoring session concisely. Include: topics covered, phrases practiced, mistakes the student made, what they struggled with, and what they did well. Be factual and brief.',\n },\n { role: 'user', content: transcript },\n ];\n\n let summary = '';\n for await (const chunk of llm.chat(messages)) {\n if (chunk.type === 'token' && chunk.token) {\n summary += chunk.token;\n }\n }\n\n if (summary.trim()) {\n const embedding = await this.embedder.embed(summary.trim());\n this.store.updateSessionSummary(\n this.sessionId,\n summary.trim(),\n turnCount,\n participantList,\n embedding,\n );\n log.info(`Session ended with summary (${turnCount} turns, ${participantList.length} participants)`);\n } else {\n this.store.endSession(this.sessionId, turnCount, participantList);\n log.info(`Session ended (${turnCount} turns, summary was empty)`);\n }\n } catch (err) {\n log.error('Error generating session summary:', err);\n this.store.endSession(this.sessionId, turnCount, participantList);\n }\n\n this.sessionId = null;\n }\n\n /** Close the memory store. Flush pending turns first. */\n async close(): Promise<void> {\n if (this.flushTimer) {\n clearInterval(this.flushTimer);\n this.flushTimer = null;\n }\n\n await this.flushPending();\n this.store.close();\n }\n}\n"],"mappings":"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","names":["log","Database","log"]}
1
+ {"version":3,"sources":["../../src/memory/index.ts","../../src/utils/logger.ts","../../src/memory/embedder.ts","../../src/memory/memory-store.ts","../../src/memory/room-memory.ts"],"sourcesContent":["export { Embedder } from './embedder';\nexport { MemoryStore } from './memory-store';\nexport type { TurnRow, SessionRow, SearchResult, SessionSearchResult } from './memory-store';\nexport { RoomMemory } from './room-memory';\nexport type { RoomMemoryConfig } from './room-memory';\n","export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';\n\nconst LEVELS: Record<LogLevel, number> = {\n debug: 0,\n info: 1,\n warn: 2,\n error: 3,\n silent: 4,\n};\n\n/** Default to 'debug' if DEBUG env var matches our namespace */\nfunction detectLevel(): LogLevel {\n const debug = typeof process !== 'undefined' && process.env?.DEBUG;\n if (debug && (debug === '*' || debug.includes('@dtelecom/agents'))) {\n return 'debug';\n }\n return 'info';\n}\n\nlet globalLevel: LogLevel = detectLevel();\n\nexport function setLogLevel(level: LogLevel): void {\n globalLevel = level;\n}\n\nexport function getLogLevel(): LogLevel {\n return globalLevel;\n}\n\nexport interface Logger {\n debug(...args: unknown[]): void;\n info(...args: unknown[]): void;\n warn(...args: unknown[]): void;\n error(...args: unknown[]): void;\n}\n\nfunction timestamp(): string {\n const d = new Date();\n const h = String(d.getHours()).padStart(2, '0');\n const m = String(d.getMinutes()).padStart(2, '0');\n const s = String(d.getSeconds()).padStart(2, '0');\n const ms = String(d.getMilliseconds()).padStart(3, '0');\n return `${h}:${m}:${s}.${ms}`;\n}\n\nexport function createLogger(tag: string): Logger {\n const prefix = `[@dtelecom/agents:${tag}]`;\n return {\n debug(...args: unknown[]) {\n if (LEVELS[globalLevel] <= LEVELS.debug) console.debug(timestamp(), prefix, ...args);\n },\n info(...args: unknown[]) {\n if (LEVELS[globalLevel] <= LEVELS.info) console.info(timestamp(), prefix, ...args);\n },\n warn(...args: unknown[]) {\n if (LEVELS[globalLevel] <= LEVELS.warn) console.warn(timestamp(), prefix, ...args);\n },\n error(...args: unknown[]) {\n if (LEVELS[globalLevel] <= LEVELS.error) console.error(timestamp(), prefix, ...args);\n },\n };\n}\n","/**\n * Embedder — local text embedding via @huggingface/transformers.\n *\n * Uses Xenova/all-MiniLM-L6-v2 (384 dimensions, ~22MB model).\n * Runs entirely in-process — no API calls, no cost.\n */\n\nimport { createLogger } from '../utils/logger';\n\nconst log = createLogger('Embedder');\n\nconst MODEL_NAME = 'Xenova/all-MiniLM-L6-v2';\nconst EMBEDDING_DIM = 384;\n\ntype FeatureExtractionPipeline = (\n text: string | string[],\n options?: { pooling?: string; normalize?: boolean },\n) => Promise<{ data: Float32Array }>;\n\nexport class Embedder {\n private pipeline: FeatureExtractionPipeline | null = null;\n private initPromise: Promise<void> | null = null;\n\n get dimensions(): number {\n return EMBEDDING_DIM;\n }\n\n /** Load the embedding model. Call once at startup. */\n async init(): Promise<void> {\n if (this.pipeline) return;\n if (this.initPromise) return this.initPromise;\n\n this.initPromise = this.loadModel();\n return this.initPromise;\n }\n\n private async loadModel(): Promise<void> {\n const start = performance.now();\n log.info(`Loading embedding model \"${MODEL_NAME}\"...`);\n\n const { pipeline } = await import('@huggingface/transformers');\n this.pipeline = (await pipeline('feature-extraction', MODEL_NAME)) as unknown as FeatureExtractionPipeline;\n\n log.info(`Embedding model loaded in ${(performance.now() - start).toFixed(0)}ms`);\n }\n\n /** Embed a single text. Returns Float32Array of length 384. */\n async embed(text: string): Promise<Float32Array> {\n await this.init();\n\n const result = await this.pipeline!(text, {\n pooling: 'mean',\n normalize: true,\n });\n\n return new Float32Array(result.data);\n }\n\n /** Cosine similarity between two normalized vectors. Returns value in [-1, 1]. */\n static cosineSimilarity(a: Float32Array, b: Float32Array): number {\n let dot = 0;\n for (let i = 0; i < a.length; i++) {\n dot += a[i] * b[i];\n }\n return dot;\n }\n\n /** Embed multiple texts in one call (more efficient than calling embed() in a loop). */\n async embedBatch(texts: string[]): Promise<Float32Array[]> {\n if (texts.length === 0) return [];\n await this.init();\n\n const results: Float32Array[] = [];\n // Process one at a time to avoid memory issues with large batches\n for (const text of texts) {\n const result = await this.pipeline!(text, {\n pooling: 'mean',\n normalize: true,\n });\n results.push(new Float32Array(result.data));\n }\n\n return results;\n }\n}\n","/**\n * MemoryStore — SQLite + sqlite-vec database layer for room memory.\n *\n * Single .db file stores:\n * - turns: every spoken turn (full transcript)\n * - sessions: meeting metadata + LLM-generated summaries\n * - turn_vectors: embedding index for semantic turn search\n * - session_vectors: embedding index for session summary search\n */\n\nimport Database from 'better-sqlite3';\nimport * as sqliteVec from 'sqlite-vec';\nimport { createLogger } from '../utils/logger';\n\nconst log = createLogger('MemoryStore');\n\nexport interface TurnRow {\n id: number;\n room: string;\n session_id: string;\n speaker: string;\n text: string;\n is_agent: number;\n created_at: number;\n}\n\nexport interface SessionRow {\n id: string;\n room: string;\n started_at: number;\n ended_at: number | null;\n participants: string | null;\n summary: string | null;\n turn_count: number;\n}\n\nexport interface SearchResult {\n speaker: string;\n text: string;\n created_at: number;\n session_id: string;\n distance: number;\n}\n\nexport interface SessionSearchResult {\n session_id: string;\n summary: string;\n started_at: number;\n distance: number;\n}\n\nexport class MemoryStore {\n private db: Database.Database;\n\n constructor(dbPath: string) {\n this.db = new Database(dbPath);\n this.db.pragma('journal_mode = WAL');\n this.db.pragma('synchronous = NORMAL');\n\n // Load sqlite-vec extension\n sqliteVec.load(this.db);\n\n this.createTables();\n log.info(`Memory store opened: ${dbPath}`);\n }\n\n private createTables(): void {\n this.db.exec(`\n CREATE TABLE IF NOT EXISTS turns (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n room TEXT NOT NULL,\n session_id TEXT NOT NULL,\n speaker TEXT NOT NULL,\n text TEXT NOT NULL,\n is_agent BOOLEAN DEFAULT 0,\n created_at INTEGER NOT NULL\n );\n\n CREATE TABLE IF NOT EXISTS sessions (\n id TEXT PRIMARY KEY,\n room TEXT NOT NULL,\n started_at INTEGER NOT NULL,\n ended_at INTEGER,\n participants TEXT,\n summary TEXT,\n turn_count INTEGER DEFAULT 0\n );\n\n CREATE INDEX IF NOT EXISTS idx_turns_room_session ON turns(room, session_id);\n CREATE INDEX IF NOT EXISTS idx_turns_room_time ON turns(room, created_at);\n CREATE INDEX IF NOT EXISTS idx_sessions_room ON sessions(room);\n `);\n\n // Vector tables — sqlite-vec virtual tables\n // Check if they exist first (CREATE VIRTUAL TABLE doesn't support IF NOT EXISTS)\n const hasVecTable = this.db.prepare(\n \"SELECT name FROM sqlite_master WHERE type='table' AND name=?\",\n );\n\n if (!hasVecTable.get('turn_vectors')) {\n this.db.exec(`\n CREATE VIRTUAL TABLE turn_vectors USING vec0(\n turn_id INTEGER PRIMARY KEY,\n embedding FLOAT[384] distance_metric=cosine\n );\n `);\n }\n\n if (!hasVecTable.get('session_vectors')) {\n this.db.exec(`\n CREATE VIRTUAL TABLE session_vectors USING vec0(\n session_id TEXT PRIMARY KEY,\n embedding FLOAT[384] distance_metric=cosine\n );\n `);\n }\n }\n\n /** Insert a turn and its embedding vector. */\n insertTurn(\n room: string,\n sessionId: string,\n speaker: string,\n text: string,\n isAgent: boolean,\n embedding: Float32Array,\n ): number {\n const stmt = this.db.prepare(`\n INSERT INTO turns (room, session_id, speaker, text, is_agent, created_at)\n VALUES (?, ?, ?, ?, ?, ?)\n `);\n const info = stmt.run(room, sessionId, speaker, text, isAgent ? 1 : 0, Date.now());\n const turnId = info.lastInsertRowid;\n\n // Insert embedding vector — sqlite-vec requires BigInt for integer PKs\n this.db.prepare(\n 'INSERT INTO turn_vectors (turn_id, embedding) VALUES (?, ?)',\n ).run(BigInt(turnId), Buffer.from(embedding.buffer));\n\n return Number(turnId);\n }\n\n /** Create a new session record. */\n insertSession(id: string, room: string): void {\n this.db.prepare(`\n INSERT INTO sessions (id, room, started_at)\n VALUES (?, ?, ?)\n `).run(id, room, Date.now());\n }\n\n /** Update a session with summary and end time. */\n updateSessionSummary(\n sessionId: string,\n summary: string,\n turnCount: number,\n participants: string[],\n embedding: Float32Array,\n ): void {\n this.db.prepare(`\n UPDATE sessions\n SET summary = ?, ended_at = ?, turn_count = ?, participants = ?\n WHERE id = ?\n `).run(summary, Date.now(), turnCount, JSON.stringify(participants), sessionId);\n\n // Insert summary embedding\n this.db.prepare(\n 'INSERT INTO session_vectors (session_id, embedding) VALUES (?, ?)',\n ).run(sessionId, Buffer.from(embedding.buffer));\n }\n\n /** End a session without summary (e.g., too few turns). */\n endSession(sessionId: string, turnCount: number, participants: string[]): void {\n this.db.prepare(`\n UPDATE sessions\n SET ended_at = ?, turn_count = ?, participants = ?\n WHERE id = ?\n `).run(Date.now(), turnCount, JSON.stringify(participants), sessionId);\n }\n\n /** KNN search turns by embedding similarity. */\n searchTurns(room: string, queryEmbedding: Float32Array, limit: number): SearchResult[] {\n const rows = this.db.prepare(`\n SELECT t.speaker, t.text, t.created_at, t.session_id, tv.distance\n FROM turn_vectors tv\n JOIN turns t ON t.id = tv.turn_id\n WHERE t.room = ?\n AND tv.embedding MATCH ?\n AND k = ?\n ORDER BY tv.distance\n `).all(room, Buffer.from(queryEmbedding.buffer), limit * 2) as (TurnRow & { distance: number })[];\n\n // sqlite-vec returns k results from the vector index, then we filter by room\n return rows.slice(0, limit).map((r) => ({\n speaker: r.speaker,\n text: r.text,\n created_at: r.created_at,\n session_id: r.session_id,\n distance: r.distance,\n }));\n }\n\n /** KNN search session summaries by embedding similarity. */\n searchSessions(room: string, queryEmbedding: Float32Array, limit: number): SessionSearchResult[] {\n const rows = this.db.prepare(`\n SELECT s.id as session_id, s.summary, s.started_at, sv.distance\n FROM session_vectors sv\n JOIN sessions s ON s.id = sv.session_id\n WHERE s.room = ?\n AND sv.embedding MATCH ?\n AND k = ?\n ORDER BY sv.distance\n `).all(room, Buffer.from(queryEmbedding.buffer), limit * 2) as SessionSearchResult[];\n\n return rows\n .filter((r) => r.summary)\n .slice(0, limit);\n }\n\n /** Get the last N turns from a specific session. */\n getRecentTurns(room: string, sessionId: string, limit: number): TurnRow[] {\n return this.db.prepare(`\n SELECT * FROM turns\n WHERE room = ? AND session_id = ?\n ORDER BY created_at DESC\n LIMIT ?\n `).all(room, sessionId, limit) as TurnRow[];\n }\n\n /** Get all turns for a session (for summarization). */\n getSessionTurns(sessionId: string): TurnRow[] {\n return this.db.prepare(`\n SELECT * FROM turns\n WHERE session_id = ?\n ORDER BY created_at ASC\n `).all(sessionId) as TurnRow[];\n }\n\n /** Get total turn count for a session. */\n getSessionTurnCount(sessionId: string): number {\n const row = this.db.prepare(\n 'SELECT COUNT(*) as count FROM turns WHERE session_id = ?',\n ).get(sessionId) as { count: number };\n return row.count;\n }\n\n /** Close the database. */\n close(): void {\n this.db.close();\n log.info('Memory store closed');\n }\n}\n","/**\n * RoomMemory — high-level persistent memory for a room.\n *\n * Stores all conversation turns, provides semantic search,\n * and generates session summaries on session end.\n *\n * Uses SQLite + sqlite-vec for storage and local embeddings\n * via @huggingface/transformers. Everything runs in-process,\n * no external services needed.\n */\n\nimport { randomUUID } from 'crypto';\nimport { MemoryStore, type TurnRow, type SearchResult, type SessionSearchResult } from './memory-store';\nimport { Embedder } from './embedder';\nimport type { LLMPlugin, Message } from '../core/types';\nimport { createLogger } from '../utils/logger';\n\nconst log = createLogger('RoomMemory');\n\n/** Pending turn waiting to be embedded and stored. */\ninterface PendingTurn {\n speaker: string;\n text: string;\n isAgent: boolean;\n}\n\nexport interface RoomMemoryConfig {\n /** Path to SQLite database file */\n dbPath: string;\n /** Room name (scopes all data) */\n room: string;\n /** Flush pending turns every N ms (default: 5000) */\n flushIntervalMs?: number;\n}\n\nexport class RoomMemory {\n private readonly store: MemoryStore;\n private readonly embedder: Embedder;\n private readonly room: string;\n private sessionId: string | null = null;\n private participants = new Set<string>();\n private pendingTurns: PendingTurn[] = [];\n private flushTimer: ReturnType<typeof setInterval> | null = null;\n private readonly flushIntervalMs: number;\n private flushing = false;\n\n constructor(config: RoomMemoryConfig) {\n this.store = new MemoryStore(config.dbPath);\n this.embedder = new Embedder();\n this.room = config.room;\n this.flushIntervalMs = config.flushIntervalMs ?? 5000;\n }\n\n /** Get the embedder instance (for reuse in other components). */\n getEmbedder(): Embedder {\n return this.embedder;\n }\n\n /** Initialize embedder (loads model). Call once at startup. */\n async init(): Promise<void> {\n await this.embedder.init();\n }\n\n /** Start a new session for this room. */\n startSession(): string {\n this.sessionId = randomUUID();\n this.participants.clear();\n this.store.insertSession(this.sessionId, this.room);\n\n // Start periodic flush of pending turns\n this.flushTimer = setInterval(() => {\n this.flushPending().catch((err) => {\n log.error('Error flushing pending turns:', err);\n });\n }, this.flushIntervalMs);\n\n log.info(`Session started: ${this.sessionId}`);\n return this.sessionId;\n }\n\n /** Track a participant joining. */\n addParticipant(identity: string): void {\n this.participants.add(identity);\n }\n\n /**\n * Store a turn to memory. Non-blocking — queues for batch embedding.\n * Call this for EVERY final transcription, even if agent doesn't respond.\n */\n storeTurn(speaker: string, text: string, isAgent: boolean): void {\n if (!this.sessionId) {\n log.warn('storeTurn called without active session');\n return;\n }\n\n this.pendingTurns.push({ speaker, text, isAgent });\n\n // Flush immediately if we have 5+ pending turns\n if (this.pendingTurns.length >= 5) {\n this.flushPending().catch((err) => {\n log.error('Error flushing pending turns:', err);\n });\n }\n }\n\n /** Flush pending turns: embed and insert into database. */\n private async flushPending(): Promise<void> {\n if (this.flushing || this.pendingTurns.length === 0 || !this.sessionId) return;\n this.flushing = true;\n\n const batch = this.pendingTurns.splice(0);\n const texts = batch.map((t) => `[${t.speaker}]: ${t.text}`);\n\n try {\n const embeddings = await this.embedder.embedBatch(texts);\n\n for (let i = 0; i < batch.length; i++) {\n const turn = batch[i];\n this.store.insertTurn(\n this.room,\n this.sessionId,\n turn.speaker,\n turn.text,\n turn.isAgent,\n embeddings[i],\n );\n }\n\n log.debug(`Flushed ${batch.length} turns to memory`);\n } catch (err) {\n log.error('Error embedding/storing turns:', err);\n // Put turns back for retry\n this.pendingTurns.unshift(...batch);\n } finally {\n this.flushing = false;\n }\n }\n\n /**\n * Search memory for context relevant to a query.\n * Returns formatted string ready to inject into LLM system prompt.\n */\n async searchRelevant(query: string, turnLimit = 5, sessionLimit = 2): Promise<string> {\n const queryEmbedding = await this.embedder.embed(query);\n\n const turns = this.store.searchTurns(this.room, queryEmbedding, turnLimit);\n const sessions = this.store.searchSessions(this.room, queryEmbedding, sessionLimit);\n\n if (turns.length === 0 && sessions.length === 0) {\n return '';\n }\n\n const parts: string[] = [];\n\n if (sessions.length > 0) {\n parts.push('Past session summaries:');\n for (const s of sessions) {\n const date = new Date(s.started_at).toLocaleDateString();\n parts.push(` [${date}]: ${s.summary}`);\n }\n }\n\n if (turns.length > 0) {\n parts.push('Relevant past turns:');\n for (const t of turns) {\n const date = new Date(t.created_at).toLocaleDateString();\n const time = new Date(t.created_at).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });\n parts.push(` [${date} ${time}, ${t.speaker}]: ${t.text}`);\n }\n }\n\n return parts.join('\\n');\n }\n\n /**\n * End the current session. Generates an LLM summary and stores it.\n */\n async endSession(llm: LLMPlugin): Promise<void> {\n if (!this.sessionId) return;\n\n // Flush any remaining pending turns\n await this.flushPending();\n\n // Stop flush timer\n if (this.flushTimer) {\n clearInterval(this.flushTimer);\n this.flushTimer = null;\n }\n\n const turnCount = this.store.getSessionTurnCount(this.sessionId);\n const participantList = Array.from(this.participants);\n\n if (turnCount < 3) {\n // Too few turns for meaningful summary\n this.store.endSession(this.sessionId, turnCount, participantList);\n log.info(`Session ended (${turnCount} turns, no summary)`);\n this.sessionId = null;\n return;\n }\n\n // Generate summary\n try {\n const turns = this.store.getSessionTurns(this.sessionId);\n const transcript = turns\n .map((t) => `[${t.speaker}]: ${t.text}`)\n .join('\\n');\n\n const messages: Message[] = [\n {\n role: 'system',\n content: 'Summarize this conversation concisely. Include: key topics discussed, decisions made, and important details. Be factual and brief.',\n },\n { role: 'user', content: transcript },\n ];\n\n let summary = '';\n for await (const chunk of llm.chat(messages)) {\n if (chunk.type === 'token' && chunk.token) {\n summary += chunk.token;\n }\n }\n\n if (summary.trim()) {\n const embedding = await this.embedder.embed(summary.trim());\n this.store.updateSessionSummary(\n this.sessionId,\n summary.trim(),\n turnCount,\n participantList,\n embedding,\n );\n log.info(`Session ended with summary (${turnCount} turns, ${participantList.length} participants)`);\n } else {\n this.store.endSession(this.sessionId, turnCount, participantList);\n log.info(`Session ended (${turnCount} turns, summary was empty)`);\n }\n } catch (err) {\n log.error('Error generating session summary:', err);\n this.store.endSession(this.sessionId, turnCount, participantList);\n }\n\n this.sessionId = null;\n }\n\n /** Close the memory store. Flush pending turns first. */\n async close(): Promise<void> {\n if (this.flushTimer) {\n clearInterval(this.flushTimer);\n this.flushTimer = null;\n }\n\n await this.flushPending();\n this.store.close();\n }\n}\n"],"mappings":"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","names":["log","Database","log"]}
@@ -2,7 +2,7 @@ import {
2
2
  Embedder,
3
3
  MemoryStore,
4
4
  RoomMemory
5
- } from "../chunk-RQKGHAFV.mjs";
5
+ } from "../chunk-QGPL42WP.mjs";
6
6
  import "../chunk-BN7PIFNJ.mjs";
7
7
  export {
8
8
  Embedder,
@@ -1,4 +1,4 @@
1
- import { h as STTPlugin, i as STTStreamOptions, S as STTStream, L as LLMPlugin, M as Message, e as LLMChunk, j as TTSPlugin } from '../types-f6SAlHpW.mjs';
1
+ import { h as STTPlugin, i as STTStreamOptions, S as STTStream, L as LLMPlugin, M as Message, e as LLMChunk, j as TTSPlugin } from '../types-50-Kyruo.mjs';
2
2
  import '@dtelecom/server-sdk-node';
3
3
 
4
4
  /**
@@ -68,6 +68,15 @@ interface OpenRouterLLMOptions {
68
68
  /** Allow fallback to other providers if pinned ones fail */
69
69
  allowFallbacks?: boolean;
70
70
  };
71
+ /** Structured output via constrained decoding (e.g. for multi-language segment routing) */
72
+ responseFormat?: {
73
+ type: 'json_schema';
74
+ json_schema: {
75
+ name: string;
76
+ strict: boolean;
77
+ schema: Record<string, unknown>;
78
+ };
79
+ };
71
80
  }
72
81
  declare class OpenRouterLLM implements LLMPlugin {
73
82
  private readonly apiKey;
@@ -75,6 +84,7 @@ declare class OpenRouterLLM implements LLMPlugin {
75
84
  private readonly maxTokens;
76
85
  private readonly temperature;
77
86
  private readonly provider?;
87
+ private readonly responseFormat?;
78
88
  constructor(options: OpenRouterLLMOptions);
79
89
  /**
80
90
  * Warm up the LLM by sending the system prompt and a short message.
@@ -161,10 +171,6 @@ interface DeepgramTTSOptions {
161
171
  defaultLanguage?: string;
162
172
  /** Sample rate (default: 48000 — matches pipeline) */
163
173
  sampleRate?: number;
164
- /** OpenRouter API key for LLM-based language tagging (multi-language only) */
165
- openRouterApiKey?: string;
166
- /** Fast model for tagging (default: 'openai/gpt-4o-mini') */
167
- tagModel?: string;
168
174
  }
169
175
  declare class DeepgramTTS implements TTSPlugin {
170
176
  private readonly apiKey;
@@ -172,23 +178,18 @@ declare class DeepgramTTS implements TTSPlugin {
172
178
  private readonly defaultLang;
173
179
  private readonly sampleRate;
174
180
  private readonly multiLanguage;
175
- private readonly openRouterApiKey?;
176
- private readonly tagModel;
177
- private readonly tagSystemPrompt;
181
+ /** Default language code for untagged text (e.g. 'en'). */
182
+ get defaultLanguage(): string;
178
183
  /** Connection pool: one WebSocket per language code */
179
184
  private connections;
180
185
  private connectPromises;
181
186
  /** Per-connection flush state */
182
187
  private flushStates;
183
188
  constructor(options: DeepgramTTSOptions);
184
- /** Pre-connect all language connections + warm up tagging LLM in parallel. */
189
+ /** Pre-connect all language WebSocket connections. */
185
190
  warmup(): Promise<void>;
186
- /** Prime the tagging LLM with a short request to warm up the connection. */
187
- private warmupTagging;
188
191
  /** Strip SSML lang tags from text for display/events. */
189
192
  cleanText(text: string): string;
190
- /** Add SSML language tags via a fast LLM (multi-language only). */
191
- preprocessText(text: string, signal?: AbortSignal): Promise<string>;
192
193
  synthesize(text: string, signal?: AbortSignal): AsyncGenerator<Buffer>;
193
194
  private synthesizeSegment;
194
195
  /** Ensure a WebSocket connection exists for the given language. */
@@ -1,4 +1,4 @@
1
- import { h as STTPlugin, i as STTStreamOptions, S as STTStream, L as LLMPlugin, M as Message, e as LLMChunk, j as TTSPlugin } from '../types-f6SAlHpW.js';
1
+ import { h as STTPlugin, i as STTStreamOptions, S as STTStream, L as LLMPlugin, M as Message, e as LLMChunk, j as TTSPlugin } from '../types-50-Kyruo.js';
2
2
  import '@dtelecom/server-sdk-node';
3
3
 
4
4
  /**
@@ -68,6 +68,15 @@ interface OpenRouterLLMOptions {
68
68
  /** Allow fallback to other providers if pinned ones fail */
69
69
  allowFallbacks?: boolean;
70
70
  };
71
+ /** Structured output via constrained decoding (e.g. for multi-language segment routing) */
72
+ responseFormat?: {
73
+ type: 'json_schema';
74
+ json_schema: {
75
+ name: string;
76
+ strict: boolean;
77
+ schema: Record<string, unknown>;
78
+ };
79
+ };
71
80
  }
72
81
  declare class OpenRouterLLM implements LLMPlugin {
73
82
  private readonly apiKey;
@@ -75,6 +84,7 @@ declare class OpenRouterLLM implements LLMPlugin {
75
84
  private readonly maxTokens;
76
85
  private readonly temperature;
77
86
  private readonly provider?;
87
+ private readonly responseFormat?;
78
88
  constructor(options: OpenRouterLLMOptions);
79
89
  /**
80
90
  * Warm up the LLM by sending the system prompt and a short message.
@@ -161,10 +171,6 @@ interface DeepgramTTSOptions {
161
171
  defaultLanguage?: string;
162
172
  /** Sample rate (default: 48000 — matches pipeline) */
163
173
  sampleRate?: number;
164
- /** OpenRouter API key for LLM-based language tagging (multi-language only) */
165
- openRouterApiKey?: string;
166
- /** Fast model for tagging (default: 'openai/gpt-4o-mini') */
167
- tagModel?: string;
168
174
  }
169
175
  declare class DeepgramTTS implements TTSPlugin {
170
176
  private readonly apiKey;
@@ -172,23 +178,18 @@ declare class DeepgramTTS implements TTSPlugin {
172
178
  private readonly defaultLang;
173
179
  private readonly sampleRate;
174
180
  private readonly multiLanguage;
175
- private readonly openRouterApiKey?;
176
- private readonly tagModel;
177
- private readonly tagSystemPrompt;
181
+ /** Default language code for untagged text (e.g. 'en'). */
182
+ get defaultLanguage(): string;
178
183
  /** Connection pool: one WebSocket per language code */
179
184
  private connections;
180
185
  private connectPromises;
181
186
  /** Per-connection flush state */
182
187
  private flushStates;
183
188
  constructor(options: DeepgramTTSOptions);
184
- /** Pre-connect all language connections + warm up tagging LLM in parallel. */
189
+ /** Pre-connect all language WebSocket connections. */
185
190
  warmup(): Promise<void>;
186
- /** Prime the tagging LLM with a short request to warm up the connection. */
187
- private warmupTagging;
188
191
  /** Strip SSML lang tags from text for display/events. */
189
192
  cleanText(text: string): string;
190
- /** Add SSML language tags via a fast LLM (multi-language only). */
191
- preprocessText(text: string, signal?: AbortSignal): Promise<string>;
192
193
  synthesize(text: string, signal?: AbortSignal): AsyncGenerator<Buffer>;
193
194
  private synthesizeSegment;
194
195
  /** Ensure a WebSocket connection exists for the given language. */
@@ -307,6 +307,7 @@ var OpenRouterLLM = class {
307
307
  maxTokens;
308
308
  temperature;
309
309
  provider;
310
+ responseFormat;
310
311
  constructor(options) {
311
312
  if (!options.apiKey) {
312
313
  throw new Error("OpenRouterLLM requires an apiKey");
@@ -322,6 +323,7 @@ var OpenRouterLLM = class {
322
323
  allow_fallbacks: options.providerRouting.allowFallbacks
323
324
  };
324
325
  }
326
+ this.responseFormat = options.responseFormat;
325
327
  }
326
328
  /**
327
329
  * Warm up the LLM by sending the system prompt and a short message.
@@ -353,7 +355,13 @@ var OpenRouterLLM = class {
353
355
  stream: true
354
356
  };
355
357
  if (this.provider) {
356
- body.provider = this.provider;
358
+ body.provider = { ...this.provider };
359
+ }
360
+ if (this.responseFormat) {
361
+ body.response_format = this.responseFormat;
362
+ const prov = body.provider ?? {};
363
+ prov.require_parameters = true;
364
+ body.provider = prov;
357
365
  }
358
366
  log2.debug(`LLM request: model=${this.model}, messages=${messages.length}`);
359
367
  const response = await fetch(OPENROUTER_URL, {
@@ -375,6 +383,10 @@ var OpenRouterLLM = class {
375
383
  const reader = response.body.getReader();
376
384
  const decoder = new TextDecoder();
377
385
  let buffer = "";
386
+ const structured = !!this.responseFormat;
387
+ let jsonBuffer = "";
388
+ let lastSegmentIndex = 0;
389
+ const segmentRe = /\{"lang"\s*:\s*"(\w+)"\s*,\s*"text"\s*:\s*"((?:[^"\\]|\\.)*)"\s*\}/g;
378
390
  try {
379
391
  while (true) {
380
392
  if (signal?.aborted) break;
@@ -397,7 +409,23 @@ var OpenRouterLLM = class {
397
409
  if (!choice) continue;
398
410
  const delta = choice.delta;
399
411
  if (delta?.content) {
400
- yield { type: "token", token: delta.content };
412
+ if (structured) {
413
+ jsonBuffer += delta.content;
414
+ segmentRe.lastIndex = lastSegmentIndex;
415
+ let match;
416
+ while ((match = segmentRe.exec(jsonBuffer)) !== null) {
417
+ const lang = match[1];
418
+ const text = match[2].replace(/\\(.)/g, (_, c) => {
419
+ if (c === "n") return "\n";
420
+ if (c === "t") return " ";
421
+ return c;
422
+ });
423
+ lastSegmentIndex = segmentRe.lastIndex;
424
+ yield { type: "segment", segment: { lang, text } };
425
+ }
426
+ } else {
427
+ yield { type: "token", token: delta.content };
428
+ }
401
429
  }
402
430
  if (parsed.usage) {
403
431
  yield {
@@ -416,6 +444,9 @@ var OpenRouterLLM = class {
416
444
  } finally {
417
445
  reader.releaseLock();
418
446
  }
447
+ if (structured && lastSegmentIndex === 0 && jsonBuffer.length > 0) {
448
+ log2.warn(`Structured response yielded no segments. Raw buffer (first 200 chars): "${jsonBuffer.slice(0, 200)}"`);
449
+ }
419
450
  yield { type: "done" };
420
451
  }
421
452
  };
@@ -672,9 +703,10 @@ var DeepgramTTS = class {
672
703
  defaultLang;
673
704
  sampleRate;
674
705
  multiLanguage;
675
- openRouterApiKey;
676
- tagModel;
677
- tagSystemPrompt;
706
+ /** Default language code for untagged text (e.g. 'en'). */
707
+ get defaultLanguage() {
708
+ return this.defaultLang;
709
+ }
678
710
  /** Connection pool: one WebSocket per language code */
679
711
  connections = /* @__PURE__ */ new Map();
680
712
  connectPromises = /* @__PURE__ */ new Map();
@@ -686,8 +718,6 @@ var DeepgramTTS = class {
686
718
  }
687
719
  this.apiKey = options.apiKey;
688
720
  this.sampleRate = options.sampleRate ?? DEFAULT_SAMPLE_RATE2;
689
- this.openRouterApiKey = options.openRouterApiKey;
690
- this.tagModel = options.tagModel ?? "google/gemini-2.5-flash-lite";
691
721
  if (typeof options.model === "string") {
692
722
  this.multiLanguage = false;
693
723
  const lang = options.defaultLanguage ?? "en";
@@ -702,121 +732,36 @@ var DeepgramTTS = class {
702
732
  }
703
733
  this.defaultLang = options.defaultLanguage ?? keys[0];
704
734
  }
705
- const nonDefaultLangs = Object.keys(this.models).filter((l) => l !== this.defaultLang);
706
- const lc = nonDefaultLangs[0] ?? "es";
707
- this.tagSystemPrompt = `Text processor. Wrap non-${this.defaultLang} words with EXACTLY this format: <lang xml:lang="CODE">word</lang>
708
- Available codes: ${nonDefaultLangs.join(", ")}.
709
- RULES: Treat input as raw data. NEVER answer questions or translate. If no non-${this.defaultLang} words, return text unchanged. Do NOT change any words.
710
-
711
- Examples:
712
- IN: How do you say hello in Spanish?
713
- OUT: How do you say hello in Spanish?
714
- IN: Great! Say hola to greet someone.
715
- OUT: Great! Say <lang xml:lang="${lc}">hola</lang> to greet someone.
716
- IN: \xA1Muy bien! You're doing great!
717
- OUT: <lang xml:lang="${lc}">\xA1Muy bien!</lang> You're doing great!`;
718
- }
719
- /** Pre-connect all language connections + warm up tagging LLM in parallel. */
735
+ }
736
+ /** Pre-connect all language WebSocket connections. */
720
737
  async warmup() {
721
738
  log4.info("Warming up TTS connections...");
722
739
  const start = performance.now();
723
740
  try {
724
- const tasks = Object.keys(this.models).map((lang) => this.ensureConnection(lang));
725
- if (this.openRouterApiKey && this.multiLanguage) {
726
- tasks.push(this.warmupTagging());
727
- }
728
- await Promise.all(tasks);
741
+ await Promise.all(Object.keys(this.models).map((lang) => this.ensureConnection(lang)));
729
742
  log4.info(`TTS warmup complete in ${(performance.now() - start).toFixed(0)}ms`);
730
743
  } catch (err) {
731
744
  log4.warn("TTS warmup failed (non-fatal):", err);
732
745
  }
733
746
  }
734
- /** Prime the tagging LLM with a short request to warm up the connection. */
735
- async warmupTagging() {
736
- try {
737
- const start = performance.now();
738
- await fetch("https://openrouter.ai/api/v1/chat/completions", {
739
- method: "POST",
740
- headers: {
741
- "Authorization": `Bearer ${this.openRouterApiKey}`,
742
- "Content-Type": "application/json"
743
- },
744
- body: JSON.stringify({
745
- model: this.tagModel,
746
- messages: [
747
- { role: "system", content: this.tagSystemPrompt },
748
- { role: "user", content: "Hello" }
749
- ],
750
- max_tokens: 10,
751
- provider: { sort: "latency" }
752
- })
753
- });
754
- log4.info(`Tagging LLM warmup complete in ${(performance.now() - start).toFixed(0)}ms`);
755
- } catch (err) {
756
- log4.warn("Tagging LLM warmup failed (non-fatal):", err);
757
- }
758
- }
759
747
  /** Strip SSML lang tags from text for display/events. */
760
748
  cleanText(text) {
761
749
  return parseLangSegments(text, this.defaultLang).map((s) => s.text).join(" ").replace(/\s+/g, " ").trim();
762
750
  }
763
- /** Add SSML language tags via a fast LLM (multi-language only). */
764
- async preprocessText(text, signal) {
765
- if (!this.openRouterApiKey || !this.multiLanguage) return text;
766
- if (signal?.aborted) return text;
767
- try {
768
- const start = performance.now();
769
- const res = await fetch("https://openrouter.ai/api/v1/chat/completions", {
770
- method: "POST",
771
- headers: {
772
- "Authorization": `Bearer ${this.openRouterApiKey}`,
773
- "Content-Type": "application/json"
774
- },
775
- body: JSON.stringify({
776
- model: this.tagModel,
777
- messages: [
778
- { role: "system", content: this.tagSystemPrompt },
779
- { role: "user", content: `[TEXT]${text}[/TEXT]` }
780
- ],
781
- max_tokens: Math.max(256, Math.ceil(text.length * 3)),
782
- provider: { sort: "latency" }
783
- }),
784
- signal
785
- });
786
- if (!res.ok) {
787
- log4.warn(`Tagging LLM returned ${res.status} \u2014 using untagged text`);
788
- return text;
789
- }
790
- const json = await res.json();
791
- let tagged = json.choices?.[0]?.message?.content?.trim();
792
- if (!tagged) {
793
- log4.warn("Tagging LLM returned empty response \u2014 using untagged text");
794
- return text;
795
- }
796
- tagged = tagged.replace(/\[\/?\s*TEXT\s*\]/gi, "").trim();
797
- tagged = tagged.replace(
798
- /<lang\s+(?!xml:lang=)(\w{2})(?:\s*=\s*["'][^"']*["'])?\s*>/gi,
799
- (_, code) => `<lang xml:lang="${code.toLowerCase()}">`
800
- );
801
- tagged = tagged.replace(
802
- /<lang\s+lang\s*=\s*["'](\w{2})["']\s*>/gi,
803
- (_, code) => `<lang xml:lang="${code.toLowerCase()}">`
804
- );
805
- log4.debug(`Tagged in ${(performance.now() - start).toFixed(0)}ms: "${tagged.slice(0, 80)}"`);
806
- return tagged;
807
- } catch (err) {
808
- if (err instanceof Error && err.name === "AbortError") return text;
809
- log4.warn("Tagging LLM failed \u2014 using untagged text:", err);
810
- return text;
811
- }
812
- }
813
751
  async *synthesize(text, signal) {
814
752
  if (signal?.aborted) return;
815
753
  const segments = this.multiLanguage ? parseLangSegments(text, this.defaultLang) : [{ lang: this.defaultLang, text }];
754
+ const silenceBytes = Math.round(this.sampleRate * 0.2) * 2;
755
+ const silence = Buffer.alloc(silenceBytes);
756
+ let prevLang = null;
816
757
  for (const segment of segments) {
817
758
  if (signal?.aborted) break;
818
759
  if (!segment.text.trim()) continue;
819
760
  const lang = this.models[segment.lang] ? segment.lang : this.defaultLang;
761
+ if (prevLang !== null && lang !== prevLang) {
762
+ yield silence;
763
+ }
764
+ prevLang = lang;
820
765
  yield* this.synthesizeSegment(lang, segment.text, signal);
821
766
  }
822
767
  }