@dtelecom/agents-js 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,343 @@
+import * as _dtelecom_server_sdk_node from '@dtelecom/server-sdk-node';
+import { Room, AudioSource, RemoteAudioTrack, AudioFrame } from '@dtelecom/server-sdk-node';
+import { EventEmitter } from 'events';
+import { A as AgentConfig, a as AgentStartOptions, M as Message, L as LLMPlugin, P as PipelineOptions, b as AgentState, S as STTStream, T as TranscriptionResult } from './types-Cs5uUoTC.mjs';
+export { c as AgentEvents, d as AudioOutput, D as DataMessageHandler, E as Embedder, e as LLMChunk, f as MemoryConfig, g as PipelineEvents, R as RespondMode, h as RoomMemory, i as RoomMemoryConfig, j as STTPlugin, k as STTStreamOptions, l as TTSPlugin } from './types-Cs5uUoTC.mjs';
+
+declare class VoiceAgent extends EventEmitter {
+    private readonly config;
+    private connection;
+    private pipeline;
+    private audioInputs;
+    private audioOutput;
+    private memory;
+    private _running;
+    constructor(config: AgentConfig);
+    get running(): boolean;
+    get room(): _dtelecom_server_sdk_node.Room | null;
+    /** Enable saving raw TTS audio as WAV files to `dir` for debugging. */
+    enableAudioDump(dir: string): void;
+    private _dumpDir;
+    /**
+     * Speak text directly via TTS, bypassing the LLM.
+     * Use for greetings or announcements. Supports barge-in.
+     */
+    say(text: string): Promise<void>;
+    /** Start the agent — connect to room and begin listening. */
+    start(options: AgentStartOptions): Promise<void>;
+    /** Stop the agent — disconnect and clean up. */
+    stop(): Promise<void>;
+    private setupDataChannel;
+    private handleTrackSubscribed;
+    private handleTrackUnsubscribed;
+    private handleParticipantDisconnected;
+    private pipeAudioToSTT;
+}
+
+interface ContextManagerOptions {
+    /** System instructions for the agent */
+    instructions: string;
+    /** Max tokens before triggering summarization (default: 5000) */
+    maxContextTokens?: number;
+    /** Number of recent turns to keep verbatim (default: 4) */
+    recentTurnsToKeep?: number;
+}
+declare class ContextManager {
+    private readonly instructions;
+    private readonly maxContextTokens;
+    private readonly recentTurnsToKeep;
+    private turns;
+    private summary;
+    constructor(options: ContextManagerOptions);
+    /** Add a user's speech turn to the conversation */
+    addUserTurn(speaker: string, text: string): void;
+    /** Add the agent's response to the conversation */
+    addAgentTurn(text: string): void;
+    /**
+     * Build the messages array for the LLM call.
+     *
+     * Structure:
+     * [system prompt]
+     * [memory context, if provided]
+     * [conversation summary, if any]
+     * [recent verbatim turns]
+     *
+     * @param memoryContext - Optional relevant context injected by the application
+     */
+    buildMessages(memoryContext?: string): Message[];
+    /** Check if summarization should be triggered */
+    shouldSummarize(): boolean;
+    /**
+     * Summarize older turns using the LLM.
+     * Keeps the most recent turns verbatim.
+     */
+    summarize(llm: LLMPlugin): Promise<void>;
+    /** Get the full transcript */
+    getFullTranscript(): string;
+    /** Reset the context */
+    reset(): void;
+}
+
+/**
+ * Pipeline — coordinates the STT -> LLM -> TTS flow.
+ *
+ * Uses a producer/consumer pattern:
+ * - Producer: LLM tokens -> sentence splitter -> sentence queue
+ * - Consumer: sentence queue -> TTS -> audio output
+ * Both run concurrently so audio playback never blocks LLM consumption.
+ *
+ * Supports barge-in (interruption cancels both producer and consumer).
+ */
+
+declare class Pipeline extends EventEmitter {
+    private readonly stt;
+    private readonly llm;
+    private readonly tts;
+    private readonly audioOutput;
+    private readonly context;
+    private readonly turnDetector;
+    private readonly bargeIn;
+    private readonly splitter;
+    private readonly respondMode;
+    private readonly agentName;
+    private readonly nameVariants;
+    private readonly beforeRespond?;
+    private readonly memory?;
+    /** Active STT streams, keyed by participant identity */
+    private sttStreams;
+    private _processing;
+    private _running;
+    private _agentState;
+    /** Queued turn while current one is still processing */
+    private pendingTurn;
+    constructor(options: PipelineOptions);
+    get processing(): boolean;
+    get running(): boolean;
+    get agentState(): AgentState;
+    private setAgentState;
+    addParticipant(identity: string): STTStream;
+    removeParticipant(identity: string): Promise<void>;
+    stop(): Promise<void>;
+    getContextManager(): ContextManager;
+    private lastFinalAt;
+    private lastSttDuration;
+    private handleTranscription;
+    /**
+     * Determine if the agent should respond to this turn.
+     * In 'always' mode: responds to everything.
+     * In 'addressed' mode: only when agent name is mentioned + optional beforeRespond hook.
+     */
+    private shouldRespond;
+    private processTurn;
+    /**
+     * Speak text directly via TTS, bypassing the LLM.
+     * Supports barge-in — if the student speaks, the greeting is cut short.
+     * Adds the text to conversation context so the LLM knows what was said.
+     */
+    say(text: string): Promise<void>;
+    private synthesizeAndPlay;
+}
+
+/**
+ * SentenceSplitter — buffers streaming LLM tokens into speakable chunks
+ * for TTS synthesis.
+ *
+ * Split strategy:
+ * 1. Sentence boundary (.!?) — always split
+ * 2. Clause boundary (,;:—) — split if buffer >= MIN_CHUNK chars
+ * 3. Word boundary — forced split if buffer >= MAX_CHUNK chars
+ */
+declare class SentenceSplitter {
+    private buffer;
+    /** Add a token and get back any speakable chunks */
+    push(token: string): string[];
+    /** Flush any remaining text as a final chunk */
+    flush(): string | null;
+    /** Reset the splitter */
+    reset(): void;
+    private extractChunks;
+}
+
+interface TurnDetectorOptions {
+    /** Silence duration after final transcription before triggering (default: 800ms) */
+    silenceTimeoutMs?: number;
+}
+declare class TurnDetector {
+    private readonly silenceTimeoutMs;
+    private silenceTimer;
+    private _onTurnEnd;
+    private lastFinalText;
+    constructor(options?: TurnDetectorOptions);
+    /** Set the callback for when a turn ends */
+    set onTurnEnd(cb: (() => void) | null);
+    /**
+     * Feed a transcription result.
+     * Returns true if this result represents a completed turn.
+     */
+    handleTranscription(text: string, isFinal: boolean): boolean;
+    /** Force-trigger turn end */
+    forceTurnEnd(): void;
+    /** Reset state */
+    reset(): void;
+    private clearTimer;
+}
+
+declare class BargeIn {
+    private abortController;
+    private _interrupted;
+    private _onInterrupt;
+    get interrupted(): boolean;
+    /** Set the callback for when barge-in occurs */
+    set onInterrupt(cb: (() => void) | null);
+    /**
+     * Create a new AbortController for the current response cycle.
+     * Call this at the start of each STT->LLM->TTS cycle.
+     */
+    startCycle(): AbortSignal;
+    /** Trigger barge-in. Called when STT detects speech during agent output. */
+    trigger(): void;
+    /** Reset after the interrupted cycle is cleaned up */
+    reset(): void;
+}
+
+/**
+ * Abstract base class for STT streams.
+ * Provides typed EventEmitter interface for transcription events.
+ * Provider implementations should extend this class.
+ */
+declare abstract class BaseSTTStream extends EventEmitter implements STTStream {
+    abstract sendAudio(pcm16: Buffer): void;
+    abstract close(): Promise<void>;
+    on(event: 'transcription', cb: (result: TranscriptionResult) => void): this;
+    on(event: 'error', cb: (error: Error) => void): this;
+    emit(event: 'transcription', result: TranscriptionResult): boolean;
+    emit(event: 'error', error: Error): boolean;
+}
+
+interface RoomConnectionOptions {
+    room: string;
+    apiKey: string;
+    apiSecret: string;
+    identity?: string;
+    name?: string;
+}
+declare class RoomConnection {
+    readonly room: Room;
+    private audioSource;
+    private localTrack;
+    private _connected;
+    constructor();
+    get connected(): boolean;
+    /**
+     * Connect to a dTelecom room.
+     *
+     * 1. Create an Ed25519 JWT via AccessToken
+     * 2. Discover nearest SFU via getWsUrl()
+     * 3. Connect Room via WebRTC
+     * 4. Publish an audio track for the agent to speak through
+     */
+    connect(options: RoomConnectionOptions): Promise<void>;
+    /**
+     * Publish an audio track so the agent can speak.
+     * Returns the AudioSource to feed PCM16 audio into.
+     */
+    publishAudioTrack(): Promise<AudioSource>;
+    /** Disconnect from the room and clean up resources. */
+    disconnect(): Promise<void>;
+}
+
+declare class AudioInput {
+    readonly participantIdentity: string;
+    private stream;
+    private _closed;
+    private frameCount;
+    constructor(track: RemoteAudioTrack, participantIdentity: string);
+    get closed(): boolean;
+    /**
+     * Async iterate over PCM16 buffers from this participant.
+     * Each yielded Buffer is 16kHz mono PCM16 LE.
+     */
+    frames(): AsyncGenerator<Buffer>;
+    /** Async iterate over AudioFrame objects. */
+    audioFrames(): AsyncGenerator<AudioFrame>;
+    close(): void;
+}
+
+/**
+ * MemoryStore — SQLite + sqlite-vec database layer for room memory.
+ *
+ * Single .db file stores:
+ * - turns: every spoken turn (full transcript)
+ * - sessions: meeting metadata + LLM-generated summaries
+ * - turn_vectors: embedding index for semantic turn search
+ * - session_vectors: embedding index for session summary search
+ */
+interface TurnRow {
+    id: number;
+    room: string;
+    session_id: string;
+    speaker: string;
+    text: string;
+    is_agent: number;
+    created_at: number;
+}
+interface SessionRow {
+    id: string;
+    room: string;
+    started_at: number;
+    ended_at: number | null;
+    participants: string | null;
+    summary: string | null;
+    turn_count: number;
+}
+interface SearchResult {
+    speaker: string;
+    text: string;
+    created_at: number;
+    session_id: string;
+    distance: number;
+}
+interface SessionSearchResult {
+    session_id: string;
+    summary: string;
+    started_at: number;
+    distance: number;
+}
+declare class MemoryStore {
+    private db;
+    constructor(dbPath: string);
+    private createTables;
+    /** Insert a turn and its embedding vector. */
+    insertTurn(room: string, sessionId: string, speaker: string, text: string, isAgent: boolean, embedding: Float32Array): number;
+    /** Create a new session record. */
+    insertSession(id: string, room: string): void;
+    /** Update a session with summary and end time. */
+    updateSessionSummary(sessionId: string, summary: string, turnCount: number, participants: string[], embedding: Float32Array): void;
+    /** End a session without summary (e.g., too few turns). */
+    endSession(sessionId: string, turnCount: number, participants: string[]): void;
+    /** KNN search turns by embedding similarity. */
+    searchTurns(room: string, queryEmbedding: Float32Array, limit: number): SearchResult[];
+    /** KNN search session summaries by embedding similarity. */
+    searchSessions(room: string, queryEmbedding: Float32Array, limit: number): SessionSearchResult[];
+    /** Get the last N turns from a specific session. */
+    getRecentTurns(room: string, sessionId: string, limit: number): TurnRow[];
+    /** Get all turns for a session (for summarization). */
+    getSessionTurns(sessionId: string): TurnRow[];
+    /** Get total turn count for a session. */
+    getSessionTurnCount(sessionId: string): number;
+    /** Close the database. */
+    close(): void;
+}
+
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+declare function setLogLevel(level: LogLevel): void;
+declare function getLogLevel(): LogLevel;
+interface Logger {
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+declare function createLogger(tag: string): Logger;
+
+export { AgentConfig, AgentStartOptions, AgentState, AudioInput, BargeIn, BaseSTTStream, ContextManager, type ContextManagerOptions, LLMPlugin, type LogLevel, type Logger, MemoryStore, Message, Pipeline, PipelineOptions, RoomConnection, type RoomConnectionOptions, STTStream, type SearchResult, SentenceSplitter, type SessionRow, type SessionSearchResult, TranscriptionResult, TurnDetector, type TurnDetectorOptions, type TurnRow, VoiceAgent, createLogger, getLogLevel, setLogLevel };

package/dist/index.d.ts

@@ -0,0 +1,343 @@
+import * as _dtelecom_server_sdk_node from '@dtelecom/server-sdk-node';
+import { Room, AudioSource, RemoteAudioTrack, AudioFrame } from '@dtelecom/server-sdk-node';
+import { EventEmitter } from 'events';
+import { A as AgentConfig, a as AgentStartOptions, M as Message, L as LLMPlugin, P as PipelineOptions, b as AgentState, S as STTStream, T as TranscriptionResult } from './types-Cs5uUoTC.js';
+export { c as AgentEvents, d as AudioOutput, D as DataMessageHandler, E as Embedder, e as LLMChunk, f as MemoryConfig, g as PipelineEvents, R as RespondMode, h as RoomMemory, i as RoomMemoryConfig, j as STTPlugin, k as STTStreamOptions, l as TTSPlugin } from './types-Cs5uUoTC.js';
+
+declare class VoiceAgent extends EventEmitter {
+    private readonly config;
+    private connection;
+    private pipeline;
+    private audioInputs;
+    private audioOutput;
+    private memory;
+    private _running;
+    constructor(config: AgentConfig);
+    get running(): boolean;
+    get room(): _dtelecom_server_sdk_node.Room | null;
+    /** Enable saving raw TTS audio as WAV files to `dir` for debugging. */
+    enableAudioDump(dir: string): void;
+    private _dumpDir;
+    /**
+     * Speak text directly via TTS, bypassing the LLM.
+     * Use for greetings or announcements. Supports barge-in.
+     */
+    say(text: string): Promise<void>;
+    /** Start the agent — connect to room and begin listening. */
+    start(options: AgentStartOptions): Promise<void>;
+    /** Stop the agent — disconnect and clean up. */
+    stop(): Promise<void>;
+    private setupDataChannel;
+    private handleTrackSubscribed;
+    private handleTrackUnsubscribed;
+    private handleParticipantDisconnected;
+    private pipeAudioToSTT;
+}
+
+interface ContextManagerOptions {
+    /** System instructions for the agent */
+    instructions: string;
+    /** Max tokens before triggering summarization (default: 5000) */
+    maxContextTokens?: number;
+    /** Number of recent turns to keep verbatim (default: 4) */
+    recentTurnsToKeep?: number;
+}
+declare class ContextManager {
+    private readonly instructions;
+    private readonly maxContextTokens;
+    private readonly recentTurnsToKeep;
+    private turns;
+    private summary;
+    constructor(options: ContextManagerOptions);
+    /** Add a user's speech turn to the conversation */
+    addUserTurn(speaker: string, text: string): void;
+    /** Add the agent's response to the conversation */
+    addAgentTurn(text: string): void;
+    /**
+     * Build the messages array for the LLM call.
+     *
+     * Structure:
+     * [system prompt]
+     * [memory context, if provided]
+     * [conversation summary, if any]
+     * [recent verbatim turns]
+     *
+     * @param memoryContext - Optional relevant context injected by the application
+     */
+    buildMessages(memoryContext?: string): Message[];
+    /** Check if summarization should be triggered */
+    shouldSummarize(): boolean;
+    /**
+     * Summarize older turns using the LLM.
+     * Keeps the most recent turns verbatim.
+     */
+    summarize(llm: LLMPlugin): Promise<void>;
+    /** Get the full transcript */
+    getFullTranscript(): string;
+    /** Reset the context */
+    reset(): void;
+}
+
+/**
+ * Pipeline — coordinates the STT -> LLM -> TTS flow.
+ *
+ * Uses a producer/consumer pattern:
+ * - Producer: LLM tokens -> sentence splitter -> sentence queue
+ * - Consumer: sentence queue -> TTS -> audio output
+ * Both run concurrently so audio playback never blocks LLM consumption.
+ *
+ * Supports barge-in (interruption cancels both producer and consumer).
+ */
+
+declare class Pipeline extends EventEmitter {
+    private readonly stt;
+    private readonly llm;
+    private readonly tts;
+    private readonly audioOutput;
+    private readonly context;
+    private readonly turnDetector;
+    private readonly bargeIn;
+    private readonly splitter;
+    private readonly respondMode;
+    private readonly agentName;
+    private readonly nameVariants;
+    private readonly beforeRespond?;
+    private readonly memory?;
+    /** Active STT streams, keyed by participant identity */
+    private sttStreams;
+    private _processing;
+    private _running;
+    private _agentState;
+    /** Queued turn while current one is still processing */
+    private pendingTurn;
+    constructor(options: PipelineOptions);
+    get processing(): boolean;
+    get running(): boolean;
+    get agentState(): AgentState;
+    private setAgentState;
+    addParticipant(identity: string): STTStream;
+    removeParticipant(identity: string): Promise<void>;
+    stop(): Promise<void>;
+    getContextManager(): ContextManager;
+    private lastFinalAt;
+    private lastSttDuration;
+    private handleTranscription;
+    /**
+     * Determine if the agent should respond to this turn.
+     * In 'always' mode: responds to everything.
+     * In 'addressed' mode: only when agent name is mentioned + optional beforeRespond hook.
+     */
+    private shouldRespond;
+    private processTurn;
+    /**
+     * Speak text directly via TTS, bypassing the LLM.
+     * Supports barge-in — if the student speaks, the greeting is cut short.
+     * Adds the text to conversation context so the LLM knows what was said.
+     */
+    say(text: string): Promise<void>;
+    private synthesizeAndPlay;
+}
+
+/**
+ * SentenceSplitter — buffers streaming LLM tokens into speakable chunks
+ * for TTS synthesis.
+ *
+ * Split strategy:
+ * 1. Sentence boundary (.!?) — always split
+ * 2. Clause boundary (,;:—) — split if buffer >= MIN_CHUNK chars
+ * 3. Word boundary — forced split if buffer >= MAX_CHUNK chars
+ */
+declare class SentenceSplitter {
+    private buffer;
+    /** Add a token and get back any speakable chunks */
+    push(token: string): string[];
+    /** Flush any remaining text as a final chunk */
+    flush(): string | null;
+    /** Reset the splitter */
+    reset(): void;
+    private extractChunks;
+}
+
+interface TurnDetectorOptions {
+    /** Silence duration after final transcription before triggering (default: 800ms) */
+    silenceTimeoutMs?: number;
+}
+declare class TurnDetector {
+    private readonly silenceTimeoutMs;
+    private silenceTimer;
+    private _onTurnEnd;
+    private lastFinalText;
+    constructor(options?: TurnDetectorOptions);
+    /** Set the callback for when a turn ends */
+    set onTurnEnd(cb: (() => void) | null);
+    /**
+     * Feed a transcription result.
+     * Returns true if this result represents a completed turn.
+     */
+    handleTranscription(text: string, isFinal: boolean): boolean;
+    /** Force-trigger turn end */
+    forceTurnEnd(): void;
+    /** Reset state */
+    reset(): void;
+    private clearTimer;
+}
+
+declare class BargeIn {
+    private abortController;
+    private _interrupted;
+    private _onInterrupt;
+    get interrupted(): boolean;
+    /** Set the callback for when barge-in occurs */
+    set onInterrupt(cb: (() => void) | null);
+    /**
+     * Create a new AbortController for the current response cycle.
+     * Call this at the start of each STT->LLM->TTS cycle.
+     */
+    startCycle(): AbortSignal;
+    /** Trigger barge-in. Called when STT detects speech during agent output. */
+    trigger(): void;
+    /** Reset after the interrupted cycle is cleaned up */
+    reset(): void;
+}
+
+/**
+ * Abstract base class for STT streams.
+ * Provides typed EventEmitter interface for transcription events.
+ * Provider implementations should extend this class.
+ */
+declare abstract class BaseSTTStream extends EventEmitter implements STTStream {
+    abstract sendAudio(pcm16: Buffer): void;
+    abstract close(): Promise<void>;
+    on(event: 'transcription', cb: (result: TranscriptionResult) => void): this;
+    on(event: 'error', cb: (error: Error) => void): this;
+    emit(event: 'transcription', result: TranscriptionResult): boolean;
+    emit(event: 'error', error: Error): boolean;
+}
+
+interface RoomConnectionOptions {
+    room: string;
+    apiKey: string;
+    apiSecret: string;
+    identity?: string;
+    name?: string;
+}
+declare class RoomConnection {
+    readonly room: Room;
+    private audioSource;
+    private localTrack;
+    private _connected;
+    constructor();
+    get connected(): boolean;
+    /**
+     * Connect to a dTelecom room.
+     *
+     * 1. Create an Ed25519 JWT via AccessToken
+     * 2. Discover nearest SFU via getWsUrl()
+     * 3. Connect Room via WebRTC
+     * 4. Publish an audio track for the agent to speak through
+     */
+    connect(options: RoomConnectionOptions): Promise<void>;
+    /**
+     * Publish an audio track so the agent can speak.
+     * Returns the AudioSource to feed PCM16 audio into.
+     */
+    publishAudioTrack(): Promise<AudioSource>;
+    /** Disconnect from the room and clean up resources. */
+    disconnect(): Promise<void>;
+}
+
+declare class AudioInput {
+    readonly participantIdentity: string;
+    private stream;
+    private _closed;
+    private frameCount;
+    constructor(track: RemoteAudioTrack, participantIdentity: string);
+    get closed(): boolean;
+    /**
+     * Async iterate over PCM16 buffers from this participant.
+     * Each yielded Buffer is 16kHz mono PCM16 LE.
+     */
+    frames(): AsyncGenerator<Buffer>;
+    /** Async iterate over AudioFrame objects. */
+    audioFrames(): AsyncGenerator<AudioFrame>;
+    close(): void;
+}
+
+/**
+ * MemoryStore — SQLite + sqlite-vec database layer for room memory.
+ *
+ * Single .db file stores:
+ * - turns: every spoken turn (full transcript)
+ * - sessions: meeting metadata + LLM-generated summaries
+ * - turn_vectors: embedding index for semantic turn search
+ * - session_vectors: embedding index for session summary search
+ */
+interface TurnRow {
+    id: number;
+    room: string;
+    session_id: string;
+    speaker: string;
+    text: string;
+    is_agent: number;
+    created_at: number;
+}
+interface SessionRow {
+    id: string;
+    room: string;
+    started_at: number;
+    ended_at: number | null;
+    participants: string | null;
+    summary: string | null;
+    turn_count: number;
+}
+interface SearchResult {
+    speaker: string;
+    text: string;
+    created_at: number;
+    session_id: string;
+    distance: number;
+}
+interface SessionSearchResult {
+    session_id: string;
+    summary: string;
+    started_at: number;
+    distance: number;
+}
+declare class MemoryStore {
+    private db;
+    constructor(dbPath: string);
+    private createTables;
+    /** Insert a turn and its embedding vector. */
+    insertTurn(room: string, sessionId: string, speaker: string, text: string, isAgent: boolean, embedding: Float32Array): number;
+    /** Create a new session record. */
+    insertSession(id: string, room: string): void;
+    /** Update a session with summary and end time. */
+    updateSessionSummary(sessionId: string, summary: string, turnCount: number, participants: string[], embedding: Float32Array): void;
+    /** End a session without summary (e.g., too few turns). */
+    endSession(sessionId: string, turnCount: number, participants: string[]): void;
+    /** KNN search turns by embedding similarity. */
+    searchTurns(room: string, queryEmbedding: Float32Array, limit: number): SearchResult[];
+    /** KNN search session summaries by embedding similarity. */
+    searchSessions(room: string, queryEmbedding: Float32Array, limit: number): SessionSearchResult[];
+    /** Get the last N turns from a specific session. */
+    getRecentTurns(room: string, sessionId: string, limit: number): TurnRow[];
+    /** Get all turns for a session (for summarization). */
+    getSessionTurns(sessionId: string): TurnRow[];
+    /** Get total turn count for a session. */
+    getSessionTurnCount(sessionId: string): number;
+    /** Close the database. */
+    close(): void;
+}
+
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+declare function setLogLevel(level: LogLevel): void;
+declare function getLogLevel(): LogLevel;
+interface Logger {
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+declare function createLogger(tag: string): Logger;
+
+export { AgentConfig, AgentStartOptions, AgentState, AudioInput, BargeIn, BaseSTTStream, ContextManager, type ContextManagerOptions, LLMPlugin, type LogLevel, type Logger, MemoryStore, Message, Pipeline, PipelineOptions, RoomConnection, type RoomConnectionOptions, STTStream, type SearchResult, SentenceSplitter, type SessionRow, type SessionSearchResult, TranscriptionResult, TurnDetector, type TurnDetectorOptions, type TurnRow, VoiceAgent, createLogger, getLogLevel, setLogLevel };