@llmrtc/llmrtc-core 1.0.0

package/dist/orchestrator.js

@@ -0,0 +1,450 @@
+import { createTimingInfo, callHookSafe } from './hooks.js';
+import { MetricNames, NoopMetrics } from './metrics.js';
+// Sentence boundary regex: matches .!? followed by space or end of string
+// Handles common abbreviations by requiring whitespace after punctuation
+const SENTENCE_BOUNDARY = /[.!?]+(?:\s+|$)/;
+export class ConversationOrchestrator {
+    constructor(config) {
+        Object.defineProperty(this, "config", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: config
+        });
+        Object.defineProperty(this, "providers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "history", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "systemPrompt", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "historyLimit", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "logger", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "streamingTTS", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "sessionId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "hooks", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "metrics", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "sentenceChunker", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.providers = config.providers;
+        this.systemPrompt = config.systemPrompt;
+        this.historyLimit = config.historyLimit ?? 8;
+        this.logger = config.logger ?? console;
+        this.streamingTTS = config.streamingTTS ?? true;
+        this.sessionId = config.sessionId;
+        this.hooks = config.hooks ?? {};
+        this.metrics = config.metrics ?? new NoopMetrics();
+        this.sentenceChunker = config.sentenceChunker;
+    }
+    async init() {
+        await Promise.all([
+            this.providers.llm.init?.(),
+            this.providers.stt.init?.(),
+            this.providers.tts.init?.(),
+            this.providers.vision?.init?.()
+        ]);
+    }
+    /**
+     * Run a single voice+vision turn: audio -> STT -> LLM (+optional vision) -> TTS.
+     */
+    async runTurn(audio, attachments = []) {
+        const transcript = await this.providers.stt.transcribe(audio);
+        this.logger.debug?.('[orchestrator] transcript', transcript.text);
+        const userMessage = {
+            role: 'user',
+            content: transcript.text,
+            attachments: attachments.length ? attachments : undefined
+        };
+        if (this.systemPrompt && !this.history.length) {
+            this.history.push({ role: 'system', content: this.systemPrompt });
+        }
+        this.pushHistory(userMessage);
+        const llmRequest = {
+            messages: this.history.slice(-this.historyLimit),
+            config: {
+                systemPrompt: this.systemPrompt,
+                historyLimit: this.historyLimit,
+                temperature: this.config.temperature,
+                topP: this.config.topP,
+                maxTokens: this.config.maxTokens
+            }
+        };
+        const llm = await this.providers.llm.complete(llmRequest);
+        this.logger.debug?.('[orchestrator] llm response', llm.fullText);
+        const assistantMessage = { role: 'assistant', content: llm.fullText };
+        this.pushHistory(assistantMessage);
+        const tts = await this.providers.tts.speak(llm.fullText);
+        return { transcript, llm, tts };
+    }
+    /**
+     * Streaming version: yields LLM chunks as they arrive.
+     *
+     * With streaming TTS enabled (when provider supports speakStream):
+     * - Detects sentence boundaries during LLM streaming
+     * - Starts TTS generation as soon as each sentence is complete
+     * - Yields TTSChunk events with PCM audio data
+     * - User hears audio while LLM is still generating
+     *
+     * Hooks and metrics are called throughout the turn lifecycle.
+     */
+    async *runTurnStream(audio, attachments = []) {
+        // Generate turn context
+        const turnStartTime = Date.now();
+        const ctx = {
+            turnId: globalThis.crypto.randomUUID(),
+            sessionId: this.sessionId,
+            startTime: turnStartTime
+        };
+        // Call onTurnStart hook
+        await callHookSafe(this.hooks.onTurnStart, ctx, audio);
+        // -------------------------------------------------------------------------
+        // STT Phase
+        // -------------------------------------------------------------------------
+        const sttStartTime = Date.now();
+        await callHookSafe(this.hooks.onSTTStart, ctx, audio);
+        let transcript;
+        try {
+            transcript = await this.providers.stt.transcribe(audio);
+            const sttTiming = createTimingInfo(sttStartTime, Date.now());
+            this.metrics.timing(MetricNames.STT_DURATION, sttTiming.durationMs, {
+                provider: this.providers.stt.name
+            });
+            await callHookSafe(this.hooks.onSTTEnd, ctx, transcript, sttTiming);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            await callHookSafe(this.hooks.onSTTError, ctx, err);
+            this.metrics.increment(MetricNames.ERRORS, 1, { component: 'stt' });
+            throw error;
+        }
+        this.pushHistory({ role: 'user', content: transcript.text, attachments: attachments.length ? attachments : undefined });
+        yield transcript;
+        const llmRequest = {
+            messages: this.history.slice(-this.historyLimit),
+            config: {
+                systemPrompt: this.systemPrompt,
+                historyLimit: this.historyLimit,
+                temperature: this.config.temperature,
+                topP: this.config.topP,
+                maxTokens: this.config.maxTokens
+            },
+            stream: true
+        };
+        // -------------------------------------------------------------------------
+        // LLM Phase
+        // -------------------------------------------------------------------------
+        const llmStartTime = Date.now();
+        await callHookSafe(this.hooks.onLLMStart, ctx, llmRequest);
+        let llmFirstChunkTime;
+        // Non-streaming LLM fallback
+        if (!this.providers.llm.stream) {
+            try {
+                const llm = await this.providers.llm.complete(llmRequest);
+                const llmTiming = createTimingInfo(llmStartTime, Date.now());
+                this.metrics.timing(MetricNames.LLM_DURATION, llmTiming.durationMs, {
+                    provider: this.providers.llm.name
+                });
+                await callHookSafe(this.hooks.onLLMEnd, ctx, llm, llmTiming);
+                this.pushHistory({ role: 'assistant', content: llm.fullText });
+                yield llm;
+                yield* this.generateTTSWithHooks(ctx, llm.fullText);
+                // Turn complete
+                const turnTiming = createTimingInfo(turnStartTime, Date.now());
+                this.metrics.timing(MetricNames.TURN_DURATION, turnTiming.durationMs);
+                await callHookSafe(this.hooks.onTurnEnd, ctx, turnTiming);
+                return;
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                await callHookSafe(this.hooks.onLLMError, ctx, err);
+                this.metrics.increment(MetricNames.ERRORS, 1, { component: 'llm' });
+                throw error;
+            }
+        }
+        // Check if we can do streaming TTS (requires config enabled AND provider support)
+        const canStreamTTS = this.streamingTTS && !!this.providers.tts.speakStream;
+        let assembled = '';
+        let pendingText = '';
+        let ttsStarted = false;
+        let chunkIndex = 0;
+        const ttsStartTime = Date.now();
+        try {
+            for await (const chunk of this.providers.llm.stream(llmRequest)) {
+                // Track time to first token
+                if (chunkIndex === 0 && chunk.content) {
+                    llmFirstChunkTime = Date.now();
+                    this.metrics.timing(MetricNames.LLM_TTFT, llmFirstChunkTime - llmStartTime, {
+                        provider: this.providers.llm.name
+                    });
+                }
+                if (chunk.content) {
+                    assembled += chunk.content;
+                    pendingText += chunk.content;
+                }
+                // Call LLM chunk hook
+                await callHookSafe(this.hooks.onLLMChunk, ctx, chunk, chunkIndex);
+                chunkIndex++;
+                yield chunk;
+                // Only do sentence-boundary TTS if provider supports streaming
+                if (canStreamTTS && pendingText) {
+                    // Check for complete sentences using custom chunker or default
+                    const sentences = this.splitIntoSentences(pendingText);
+                    if (sentences.length > 1) {
+                        // We have at least one complete sentence
+                        const completeSentences = sentences.slice(0, -1);
+                        pendingText = sentences[sentences.length - 1];
+                        for (const completeSentence of completeSentences) {
+                            if (completeSentence.trim()) {
+                                // Signal TTS start on first sentence
+                                if (!ttsStarted) {
+                                    ttsStarted = true;
+                                    await callHookSafe(this.hooks.onTTSStart, ctx, completeSentence.trim());
+                                    yield { type: 'tts-start' };
+                                }
+                                // Stream TTS for this sentence
+                                yield* this.streamTTSChunksWithHooks(ctx, completeSentence.trim());
+                            }
+                        }
+                    }
+                }
+            }
+            // LLM complete
+            const llmEndTime = Date.now();
+            const llmTiming = createTimingInfo(llmStartTime, llmEndTime);
+            this.metrics.timing(MetricNames.LLM_DURATION, llmTiming.durationMs, {
+                provider: this.providers.llm.name
+            });
+            const llmResult = { fullText: assembled };
+            await callHookSafe(this.hooks.onLLMEnd, ctx, llmResult, llmTiming);
+            this.pushHistory({ role: 'assistant', content: assembled });
+            yield llmResult;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            await callHookSafe(this.hooks.onLLMError, ctx, err);
+            this.metrics.increment(MetricNames.ERRORS, 1, { component: 'llm' });
+            throw error;
+        }
+        // -------------------------------------------------------------------------
+        // TTS Phase (remaining text)
+        // -------------------------------------------------------------------------
+        try {
+            // Handle remaining text after LLM completes
+            if (canStreamTTS) {
+                const remainingText = pendingText.trim();
+                if (remainingText) {
+                    if (!ttsStarted) {
+                        ttsStarted = true;
+                        await callHookSafe(this.hooks.onTTSStart, ctx, remainingText);
+                        yield { type: 'tts-start' };
+                    }
+                    yield* this.streamTTSChunksWithHooks(ctx, remainingText);
+                }
+                // Signal TTS complete
+                if (ttsStarted) {
+                    const ttsTiming = createTimingInfo(ttsStartTime, Date.now());
+                    this.metrics.timing(MetricNames.TTS_DURATION, ttsTiming.durationMs, {
+                        provider: this.providers.tts.name
+                    });
+                    await callHookSafe(this.hooks.onTTSEnd, ctx, ttsTiming);
+                    yield { type: 'tts-complete' };
+                }
+            }
+            else {
+                // Fallback to non-streaming TTS
+                yield* this.generateTTSWithHooks(ctx, assembled);
+            }
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            await callHookSafe(this.hooks.onTTSError, ctx, err);
+            this.metrics.increment(MetricNames.ERRORS, 1, { component: 'tts' });
+            throw error;
+        }
+        // Turn complete
+        const turnTiming = createTimingInfo(turnStartTime, Date.now());
+        this.metrics.timing(MetricNames.TURN_DURATION, turnTiming.durationMs);
+        await callHookSafe(this.hooks.onTurnEnd, ctx, turnTiming);
+    }
+    /**
+     * Split text into sentences using custom chunker or default regex
+     */
+    splitIntoSentences(text) {
+        if (this.sentenceChunker) {
+            return this.sentenceChunker(text);
+        }
+        // Default: split on sentence boundaries, keep last part as incomplete
+        const parts = text.split(SENTENCE_BOUNDARY);
+        // The split removes the delimiter, so we need to reconstruct
+        const matches = text.match(new RegExp(SENTENCE_BOUNDARY.source, 'g')) || [];
+        const result = [];
+        for (let i = 0; i < parts.length - 1; i++) {
+            result.push(parts[i] + (matches[i] || ''));
+        }
+        // Last part is incomplete (no boundary yet)
+        if (parts.length > 0) {
+            result.push(parts[parts.length - 1]);
+        }
+        return result;
+    }
+    /**
+     * Stream TTS chunks for a sentence using PCM format with hooks.
+     * Yields TTSChunk events as audio data arrives.
+     */
+    async *streamTTSChunksWithHooks(ctx, text) {
+        if (!this.providers.tts.speakStream)
+            return;
+        let chunkIndex = 0;
+        try {
+            for await (const audioChunk of this.providers.tts.speakStream(text, { format: 'pcm' })) {
+                const ttsChunk = {
+                    type: 'tts-chunk',
+                    audio: audioChunk,
+                    format: 'pcm',
+                    sampleRate: 24000, // OpenAI/ElevenLabs PCM is 24kHz
+                    sentence: text
+                };
+                await callHookSafe(this.hooks.onTTSChunk, ctx, ttsChunk, chunkIndex);
+                chunkIndex++;
+                yield ttsChunk;
+            }
+        }
+        catch (err) {
+            this.logger.error?.('[orchestrator] TTS stream error:', err);
+            // Fallback: try non-streaming TTS
+            try {
+                const tts = await this.providers.tts.speak(text, { format: 'pcm' });
+                const ttsChunk = {
+                    type: 'tts-chunk',
+                    audio: tts.audio,
+                    format: 'pcm',
+                    sampleRate: 24000,
+                    sentence: text
+                };
+                await callHookSafe(this.hooks.onTTSChunk, ctx, ttsChunk, chunkIndex);
+                yield ttsChunk;
+            }
+            catch (fallbackErr) {
+                this.logger.error?.('[orchestrator] TTS fallback also failed:', fallbackErr);
+                throw fallbackErr;
+            }
+        }
+    }
+    /**
+     * Non-streaming TTS with hooks: generates complete audio and yields as single TTSResult.
+     */
+    async *generateTTSWithHooks(ctx, text) {
+        const ttsStartTime = Date.now();
+        await callHookSafe(this.hooks.onTTSStart, ctx, text);
+        yield { type: 'tts-start' };
+        const tts = await this.providers.tts.speak(text);
+        yield tts;
+        const ttsTiming = createTimingInfo(ttsStartTime, Date.now());
+        this.metrics.timing(MetricNames.TTS_DURATION, ttsTiming.durationMs, {
+            provider: this.providers.tts.name
+        });
+        await callHookSafe(this.hooks.onTTSEnd, ctx, ttsTiming);
+        yield { type: 'tts-complete' };
+    }
+    /**
+     * @deprecated Use streamTTSChunksWithHooks instead
+     * Stream TTS chunks for a sentence using PCM format.
+     */
+    async *streamTTSChunks(text) {
+        if (!this.providers.tts.speakStream)
+            return;
+        try {
+            for await (const audioChunk of this.providers.tts.speakStream(text, { format: 'pcm' })) {
+                yield {
+                    type: 'tts-chunk',
+                    audio: audioChunk,
+                    format: 'pcm',
+                    sampleRate: 24000, // OpenAI/ElevenLabs PCM is 24kHz
+                    sentence: text
+                };
+            }
+        }
+        catch (err) {
+            this.logger.error?.('[orchestrator] TTS stream error:', err);
+            // Fallback: try non-streaming TTS
+            try {
+                const tts = await this.providers.tts.speak(text, { format: 'pcm' });
+                yield {
+                    type: 'tts-chunk',
+                    audio: tts.audio,
+                    format: 'pcm',
+                    sampleRate: 24000,
+                    sentence: text
+                };
+            }
+            catch (fallbackErr) {
+                this.logger.error?.('[orchestrator] TTS fallback also failed:', fallbackErr);
+            }
+        }
+    }
+    /**
+     * @deprecated Use generateTTSWithHooks instead
+     * Non-streaming TTS: generates complete audio and yields as single TTSResult.
+     */
+    async *generateTTS(text) {
+        yield { type: 'tts-start' };
+        const tts = await this.providers.tts.speak(text);
+        yield tts;
+        yield { type: 'tts-complete' };
+    }
+    pushHistory(message) {
+        this.history.push(message);
+        if (this.history.length > this.historyLimit + 2) {
+            // keep system prompt if present
+            const start = this.history[0]?.role === 'system' ? 1 : 0;
+            const overflow = this.history.length - (this.historyLimit + 2);
+            this.history.splice(start, overflow);
+        }
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator.js.map

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

package/dist/playbook-engine.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Playbook Engine
+ *
+ * Evaluates transition rules and manages stage transitions in a playbook.
+ */
+import type { Playbook, PlaybookState, Stage, Transition, TransitionEvaluationResult } from './playbook.js';
+/**
+ * Options for the playbook engine
+ */
+export interface PlaybookEngineOptions {
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Custom logger */
+    logger?: {
+        debug: (msg: string, ...args: unknown[]) => void;
+        info: (msg: string, ...args: unknown[]) => void;
+        warn: (msg: string, ...args: unknown[]) => void;
+        error: (msg: string, ...args: unknown[]) => void;
+    };
+}
+/**
+ * Event emitted during playbook execution
+ */
+export type PlaybookEvent = {
+    type: 'stage_enter';
+    stage: Stage;
+    previousStage?: Stage;
+} | {
+    type: 'stage_exit';
+    stage: Stage;
+    nextStage: Stage;
+} | {
+    type: 'transition';
+    transition: Transition;
+    from: Stage;
+    to: Stage;
+} | {
+    type: 'turn_complete';
+    stage: Stage;
+    turnCount: number;
+} | {
+    type: 'playbook_complete';
+    finalStage: Stage;
+};
+/**
+ * Listener for playbook events
+ */
+export type PlaybookEventListener = (event: PlaybookEvent) => void | Promise<void>;
+/**
+ * Playbook Engine - Evaluates transitions and manages playbook state
+ */
+export declare class PlaybookEngine {
+    private readonly playbook;
+    private state;
+    private readonly options;
+    private readonly listeners;
+    private sessionMetadata;
+    constructor(playbook: Playbook, options?: PlaybookEngineOptions);
+    /**
+     * Get current playbook state
+     */
+    getState(): Readonly<PlaybookState>;
+    /**
+     * Get current stage
+     */
+    getCurrentStage(): Stage;
+    /**
+     * Get the playbook
+     */
+    getPlaybook(): Playbook;
+    /**
+     * Set session metadata
+     */
+    setSessionMetadata(metadata: Record<string, unknown>): void;
+    /**
+     * Update conversation context
+     */
+    updateContext(updates: Record<string, unknown>): void;
+    /**
+     * Subscribe to playbook events
+     */
+    on(listener: PlaybookEventListener): () => void;
+    /**
+     * Emit an event to all listeners
+     */
+    private emit;
+    /**
+     * Log a debug message
+     */
+    private log;
+    /**
+     * Build transition context for evaluation
+     */
+    private buildTransitionContext;
+    /**
+     * Evaluate a single transition condition
+     */
+    private evaluateCondition;
+    /**
+     * Evaluate all applicable transitions and return the highest priority match
+     */
+    evaluateTransitions(lastAssistantMessage?: string, lastToolCalls?: Array<{
+        name: string;
+        arguments: Record<string, unknown>;
+    }>): Promise<TransitionEvaluationResult>;
+    /**
+     * Check if a specific transition should be triggered (e.g., from playbook_transition tool)
+     */
+    evaluateExplicitTransition(targetStage: string, reason: string, data?: Record<string, unknown>): Promise<TransitionEvaluationResult>;
+    /**
+     * Execute a stage transition
+     */
+    executeTransition(transition: Transition, overrideData?: Record<string, unknown>): Promise<void>;
+    /**
+     * Increment turn count and emit event
+     */
+    completeTurn(): Promise<void>;
+    /**
+     * Mark playbook as complete
+     */
+    complete(): Promise<void>;
+    /**
+     * Get the effective system prompt for current stage
+     * (combines global prompt with stage-specific prompt)
+     */
+    getEffectiveSystemPrompt(): string;
+    /**
+     * Get all tools available in current stage
+     * (combines global tools with stage-specific tools)
+     */
+    getAvailableTools(): import('./tools.js').ToolDefinition[];
+    /**
+     * Get effective LLM config for current stage
+     */
+    getEffectiveLLMConfig(): import('./playbook.js').StageLLMConfig;
+    /**
+     * Reset engine to initial state
+     */
+    reset(): void;
+}