@dotdo/do 0.1.0

package/dist/ai/voice/providers.js

@@ -0,0 +1,286 @@
+/**
+ * Voice AI Provider Abstraction
+ *
+ * Unified interface across voice AI platforms:
+ * - Vapi - Voice AI agents
+ * - LiveKit - Real-time infrastructure
+ * - Retell - Voice agents
+ * - Bland - Phone AI
+ * - Daily - WebRTC platform
+ *
+ * @module ai/voice/providers
+ */
+/**
+ * Provider factory for creating voice provider adapters
+ */
+export class VoiceProviderFactory {
+    static adapters = new Map();
+    static configs = new Map();
+    /**
+     * Register a provider adapter
+     *
+     * @param adapter - Provider adapter instance
+     */
+    static register(adapter) {
+        this.adapters.set(adapter.provider, adapter);
+    }
+    /**
+     * Configure a provider with API credentials
+     *
+     * @param config - Provider configuration
+     */
+    static configure(config) {
+        this.configs.set(config.provider, config);
+    }
+    /**
+     * Get a provider adapter by name
+     *
+     * @param provider - Provider name
+     * @returns Provider adapter
+     * @throws Error if provider not registered or configured
+     */
+    static get(provider) {
+        const adapter = this.adapters.get(provider);
+        if (!adapter) {
+            throw new Error(`Voice provider not registered: ${provider}`);
+        }
+        return adapter;
+    }
+    /**
+     * Auto-select a provider based on use case
+     *
+     * @param useCase - Use case hint
+     * @returns Best provider for the use case
+     */
+    static for(useCase) {
+        const providerMap = {
+            'outbound-campaign': 'bland',
+            'inbound-support': 'vapi',
+            'web-call': 'livekit',
+            'voice-agent': 'retell',
+            'real-time': 'livekit',
+        };
+        const provider = providerMap[useCase];
+        return this.get(provider);
+    }
+    /**
+     * Create a new provider adapter with configuration
+     *
+     * @param provider - Provider name
+     * @param config - Provider configuration
+     * @returns Configured provider adapter
+     */
+    static create(provider, config) {
+        // TODO: Implement provider-specific adapter creation
+        throw new Error(`Not implemented: create adapter for ${provider}`);
+    }
+    /**
+     * Check if a provider is available (registered and configured)
+     *
+     * @param provider - Provider name
+     * @returns True if provider is available
+     */
+    static isAvailable(provider) {
+        return this.adapters.has(provider) && this.configs.has(provider);
+    }
+    /**
+     * List all available providers
+     *
+     * @returns Array of available provider names
+     */
+    static listAvailable() {
+        return Array.from(this.adapters.keys()).filter((p) => this.configs.has(p));
+    }
+}
+// =============================================================================
+// Provider Implementations (Stubs)
+// =============================================================================
+/**
+ * Vapi provider adapter
+ *
+ * @see https://docs.vapi.ai
+ */
+export class VapiAdapter {
+    config;
+    provider = 'vapi';
+    constructor(config) {
+        this.config = config;
+        if (config.provider !== 'vapi') {
+            throw new Error('Invalid provider config for VapiAdapter');
+        }
+    }
+    async createAgent(config) {
+        // TODO: Implement Vapi agent creation
+        throw new Error('Not implemented: VapiAdapter.createAgent');
+    }
+    async updateAgent(providerAgentId, config) {
+        // TODO: Implement Vapi agent update
+        throw new Error('Not implemented: VapiAdapter.updateAgent');
+    }
+    async deleteAgent(providerAgentId) {
+        // TODO: Implement Vapi agent deletion
+        throw new Error('Not implemented: VapiAdapter.deleteAgent');
+    }
+    async startCall(providerAgentId, phone, context) {
+        // TODO: Implement Vapi call start
+        throw new Error('Not implemented: VapiAdapter.startCall');
+    }
+    async endCall(providerCallId) {
+        // TODO: Implement Vapi call end
+        throw new Error('Not implemented: VapiAdapter.endCall');
+    }
+    async getCall(providerCallId) {
+        // TODO: Implement Vapi call status
+        throw new Error('Not implemented: VapiAdapter.getCall');
+    }
+    async createRoom(providerAgentId, identity) {
+        // TODO: Implement Vapi WebRTC (if supported)
+        throw new Error('Not implemented: VapiAdapter.createRoom');
+    }
+    async handleWebhook(payload, headers) {
+        // TODO: Implement Vapi webhook handling
+        throw new Error('Not implemented: VapiAdapter.handleWebhook');
+    }
+}
+/**
+ * LiveKit provider adapter
+ *
+ * @see https://docs.livekit.io
+ */
+export class LiveKitAdapter {
+    config;
+    provider = 'livekit';
+    constructor(config) {
+        this.config = config;
+        if (config.provider !== 'livekit') {
+            throw new Error('Invalid provider config for LiveKitAdapter');
+        }
+    }
+    async createAgent(config) {
+        // TODO: Implement LiveKit agent creation
+        throw new Error('Not implemented: LiveKitAdapter.createAgent');
+    }
+    async updateAgent(providerAgentId, config) {
+        // TODO: Implement LiveKit agent update
+        throw new Error('Not implemented: LiveKitAdapter.updateAgent');
+    }
+    async deleteAgent(providerAgentId) {
+        // TODO: Implement LiveKit agent deletion
+        throw new Error('Not implemented: LiveKitAdapter.deleteAgent');
+    }
+    async startCall(providerAgentId, phone, context) {
+        // TODO: Implement LiveKit call start (via SIP trunk)
+        throw new Error('Not implemented: LiveKitAdapter.startCall');
+    }
+    async endCall(providerCallId) {
+        // TODO: Implement LiveKit call end
+        throw new Error('Not implemented: LiveKitAdapter.endCall');
+    }
+    async getCall(providerCallId) {
+        // TODO: Implement LiveKit call status
+        throw new Error('Not implemented: LiveKitAdapter.getCall');
+    }
+    async createRoom(providerAgentId, identity) {
+        // TODO: Implement LiveKit room creation with access token
+        throw new Error('Not implemented: LiveKitAdapter.createRoom');
+    }
+    async handleWebhook(payload, headers) {
+        // TODO: Implement LiveKit webhook handling
+        throw new Error('Not implemented: LiveKitAdapter.handleWebhook');
+    }
+}
+/**
+ * Retell AI provider adapter
+ *
+ * @see https://docs.retellai.com
+ */
+export class RetellAdapter {
+    config;
+    provider = 'retell';
+    constructor(config) {
+        this.config = config;
+        if (config.provider !== 'retell') {
+            throw new Error('Invalid provider config for RetellAdapter');
+        }
+    }
+    async createAgent(config) {
+        // TODO: Implement Retell agent creation
+        throw new Error('Not implemented: RetellAdapter.createAgent');
+    }
+    async updateAgent(providerAgentId, config) {
+        // TODO: Implement Retell agent update
+        throw new Error('Not implemented: RetellAdapter.updateAgent');
+    }
+    async deleteAgent(providerAgentId) {
+        // TODO: Implement Retell agent deletion
+        throw new Error('Not implemented: RetellAdapter.deleteAgent');
+    }
+    async startCall(providerAgentId, phone, context) {
+        // TODO: Implement Retell call start
+        throw new Error('Not implemented: RetellAdapter.startCall');
+    }
+    async endCall(providerCallId) {
+        // TODO: Implement Retell call end
+        throw new Error('Not implemented: RetellAdapter.endCall');
+    }
+    async getCall(providerCallId) {
+        // TODO: Implement Retell call status
+        throw new Error('Not implemented: RetellAdapter.getCall');
+    }
+    async createRoom(providerAgentId, identity) {
+        // TODO: Implement Retell WebRTC
+        throw new Error('Not implemented: RetellAdapter.createRoom');
+    }
+    async handleWebhook(payload, headers) {
+        // TODO: Implement Retell webhook handling
+        throw new Error('Not implemented: RetellAdapter.handleWebhook');
+    }
+}
+/**
+ * Bland AI provider adapter
+ *
+ * @see https://docs.bland.ai
+ */
+export class BlandAdapter {
+    config;
+    provider = 'bland';
+    constructor(config) {
+        this.config = config;
+        if (config.provider !== 'bland') {
+            throw new Error('Invalid provider config for BlandAdapter');
+        }
+    }
+    async createAgent(config) {
+        // TODO: Implement Bland agent creation
+        throw new Error('Not implemented: BlandAdapter.createAgent');
+    }
+    async updateAgent(providerAgentId, config) {
+        // TODO: Implement Bland agent update
+        throw new Error('Not implemented: BlandAdapter.updateAgent');
+    }
+    async deleteAgent(providerAgentId) {
+        // TODO: Implement Bland agent deletion
+        throw new Error('Not implemented: BlandAdapter.deleteAgent');
+    }
+    async startCall(providerAgentId, phone, context) {
+        // TODO: Implement Bland call start
+        throw new Error('Not implemented: BlandAdapter.startCall');
+    }
+    async endCall(providerCallId) {
+        // TODO: Implement Bland call end
+        throw new Error('Not implemented: BlandAdapter.endCall');
+    }
+    async getCall(providerCallId) {
+        // TODO: Implement Bland call status
+        throw new Error('Not implemented: BlandAdapter.getCall');
+    }
+    async handleWebhook(payload, headers) {
+        // TODO: Implement Bland webhook handling
+        throw new Error('Not implemented: BlandAdapter.handleWebhook');
+    }
+}
+// =============================================================================
+// Exports
+// =============================================================================
+export { VoiceProviderFactory as VoiceProvider };
+//# sourceMappingURL=providers.js.map

package/dist/ai/voice/providers.js.map

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

package/dist/ai/voice/sessions.d.ts

@@ -0,0 +1,294 @@
+/**
+ * Voice Session Management
+ *
+ * Manages the lifecycle of voice calls including outbound calls,
+ * inbound calls, and WebRTC sessions.
+ *
+ * @module ai/voice/sessions
+ */
+import type { VoiceSession, VoiceSessionStatus, TranscriptEntry, ToolCallRecord, CallOutcome, CallCost, SentimentAnalysis } from '../../types/voice-ai';
+import { VoiceAgentManager } from './agents';
+/**
+ * Options for starting an outbound call
+ */
+export interface StartOutboundCallOptions {
+    /** Voice agent ID */
+    agentId: string;
+    /** Phone number to call */
+    phone: string;
+    /** Context to pass to the agent */
+    context?: Record<string, unknown>;
+    /** Metadata to attach to session */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for listing sessions
+ */
+export interface ListSessionsOptions {
+    /** Filter by agent ID */
+    agentId?: string;
+    /** Filter by status */
+    status?: VoiceSessionStatus;
+    /** Filter by type */
+    type?: 'inbound' | 'outbound' | 'web';
+    /** Start time range (unix ms) */
+    startTimeFrom?: number;
+    /** Start time range (unix ms) */
+    startTimeTo?: number;
+    /** Limit results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Order by field */
+    orderBy?: 'startTime' | 'duration' | 'cost';
+    /** Order direction */
+    orderDir?: 'asc' | 'desc';
+}
+/**
+ * Result of listing sessions
+ */
+export interface ListSessionsResult {
+    /** Sessions */
+    items: VoiceSession[];
+    /** Total count */
+    total: number;
+    /** Has more results */
+    hasMore: boolean;
+}
+/**
+ * Session event types
+ */
+export type SessionEventType = 'started' | 'ringing' | 'answered' | 'transcript' | 'toolCall' | 'toolResult' | 'transferring' | 'ended' | 'error';
+/**
+ * Session event handler
+ */
+export type SessionEventHandler<T = unknown> = (data: T) => void | Promise<void>;
+/**
+ * Session update from provider webhook
+ */
+export interface SessionUpdate {
+    /** Update type */
+    type: SessionEventType;
+    /** Session ID */
+    sessionId: string;
+    /** Update data */
+    data: Record<string, unknown>;
+}
+/**
+ * Voice session manager
+ *
+ * Manages voice call sessions including lifecycle, transcripts,
+ * tool calls, and recordings.
+ *
+ * @example
+ * ```typescript
+ * const manager = new VoiceSessionManager(storage, agentManager)
+ *
+ * // Start an outbound call
+ * const session = await manager.startOutbound({
+ *   agentId: 'vagent_123',
+ *   phone: '+1-555-0123',
+ *   context: { customerName: 'John' },
+ * })
+ *
+ * // Get session status
+ * const status = await manager.get(session.id)
+ *
+ * // List recent sessions
+ * const sessions = await manager.list({ agentId: 'vagent_123', limit: 10 })
+ * ```
+ */
+export declare class VoiceSessionManager {
+    private storage;
+    private agentManager;
+    private eventHandlers;
+    /**
+     * Create a new session manager
+     *
+     * @param storage - DO storage interface
+     * @param agentManager - Voice agent manager
+     */
+    constructor(storage: DurableObjectStorage, agentManager: VoiceAgentManager);
+    /**
+     * Start an outbound call
+     *
+     * @param options - Call options
+     * @returns Created session
+     */
+    startOutbound(options: StartOutboundCallOptions): Promise<VoiceSession>;
+    /**
+     * Create a session for an inbound call (called from webhook)
+     *
+     * @param agentId - Voice agent ID
+     * @param providerCallId - Provider's call ID
+     * @param customerPhone - Customer's phone number
+     * @returns Created session
+     */
+    createInbound(agentId: string, providerCallId: string, customerPhone: string): Promise<VoiceSession>;
+    /**
+     * Get a session by ID
+     *
+     * @param id - Session ID
+     * @returns Session or null if not found
+     */
+    get(id: string): Promise<VoiceSession | null>;
+    /**
+     * Get a session by provider session ID
+     *
+     * @param providerSessionId - Provider's session ID
+     * @returns Session or null if not found
+     */
+    getByProviderSessionId(providerSessionId: string): Promise<VoiceSession | null>;
+    /**
+     * Update session status
+     *
+     * @param id - Session ID
+     * @param status - New status
+     * @param outcome - Call outcome (if completed/failed)
+     */
+    updateStatus(id: string, status: VoiceSessionStatus, outcome?: CallOutcome): Promise<VoiceSession>;
+    /**
+     * Append a transcript entry
+     *
+     * @param id - Session ID
+     * @param entry - Transcript entry
+     */
+    appendTranscript(id: string, entry: TranscriptEntry): Promise<void>;
+    /**
+     * Record a tool call
+     *
+     * @param id - Session ID
+     * @param toolCall - Tool call record
+     */
+    recordToolCall(id: string, toolCall: ToolCallRecord): Promise<void>;
+    /**
+     * Set recording URL
+     *
+     * @param id - Session ID
+     * @param recordingUrl - URL of the recording
+     */
+    setRecordingUrl(id: string, recordingUrl: string): Promise<void>;
+    /**
+     * Set call summary
+     *
+     * @param id - Session ID
+     * @param summary - AI-generated summary
+     */
+    setSummary(id: string, summary: string): Promise<void>;
+    /**
+     * Set sentiment analysis
+     *
+     * @param id - Session ID
+     * @param sentiment - Sentiment analysis
+     */
+    setSentiment(id: string, sentiment: SentimentAnalysis): Promise<void>;
+    /**
+     * Set call cost
+     *
+     * @param id - Session ID
+     * @param cost - Cost breakdown
+     */
+    setCost(id: string, cost: CallCost): Promise<void>;
+    /**
+     * End a session
+     *
+     * @param id - Session ID
+     * @returns True if ended, false if already ended or not found
+     */
+    end(id: string): Promise<boolean>;
+    /**
+     * List sessions
+     *
+     * @param options - Filter and pagination options
+     * @returns List of sessions
+     */
+    list(options?: ListSessionsOptions): Promise<ListSessionsResult>;
+    /**
+     * Get full transcript for a session
+     *
+     * @param id - Session ID
+     * @returns Transcript entries or null if session not found
+     */
+    getTranscript(id: string): Promise<TranscriptEntry[] | null>;
+    /**
+     * Get recording URL for a session
+     *
+     * @param id - Session ID
+     * @returns Recording URL or null if not available
+     */
+    getRecording(id: string): Promise<string | null>;
+    /**
+     * Subscribe to session events
+     *
+     * @param sessionId - Session ID
+     * @param event - Event type
+     * @param handler - Event handler
+     * @returns Unsubscribe function
+     */
+    on(sessionId: string, event: SessionEventType, handler: SessionEventHandler): () => void;
+    /**
+     * Map session status to event type
+     *
+     * @param status - Session status
+     * @returns Corresponding event type
+     */
+    private statusToEventType;
+    /**
+     * Emit a session event
+     *
+     * @param sessionId - Session ID
+     * @param event - Event type
+     * @param data - Event data
+     */
+    private emit;
+    /**
+     * Get session statistics
+     *
+     * @param agentId - Optional agent ID to filter
+     * @param startTime - Start of time range
+     * @param endTime - End of time range
+     * @returns Session statistics
+     */
+    getStats(agentId?: string, startTime?: number, endTime?: number): Promise<{
+        totalCalls: number;
+        completedCalls: number;
+        failedCalls: number;
+        avgDuration: number;
+        totalDuration: number;
+        totalCost: number;
+    }>;
+}
+/**
+ * Voice sessions singleton access
+ */
+export declare const VoiceSessions: {
+    /**
+     * Initialize with storage and agent manager
+     */
+    init(storage: DurableObjectStorage, agentManager: VoiceAgentManager): void;
+    /**
+     * Start an outbound call
+     */
+    startOutbound(options: StartOutboundCallOptions): Promise<VoiceSession>;
+    /**
+     * Get a session
+     */
+    get(id: string): Promise<VoiceSession | null>;
+    /**
+     * List sessions
+     */
+    list(options?: ListSessionsOptions): Promise<ListSessionsResult>;
+    /**
+     * End a session
+     */
+    end(id: string): Promise<boolean>;
+    /**
+     * Get transcript
+     */
+    getTranscript(id: string): Promise<TranscriptEntry[] | null>;
+    /**
+     * Get recording
+     */
+    getRecording(id: string): Promise<string | null>;
+};
+//# sourceMappingURL=sessions.d.ts.map

package/dist/ai/voice/sessions.d.ts.map

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