@dotdo/do 0.1.0

package/dist/ai/voice/agents.js

@@ -0,0 +1,375 @@
+/**
+ * Voice Agent Management
+ *
+ * Voice agents are Agents with voice modality enabled.
+ * This module provides CRUD operations for voice-specific configuration
+ * that links to core Agent entities.
+ *
+ * @module ai/voice/agents
+ */
+import { VoiceProviderFactory } from './providers';
+// =============================================================================
+// Voice Agent Manager
+// =============================================================================
+/**
+ * Voice agent manager
+ *
+ * Provides CRUD operations for voice agents. Voice agents link to core Agent
+ * entities and add voice-specific configuration (voice settings, conversation
+ * config, phone integration).
+ *
+ * @example
+ * ```typescript
+ * const manager = new VoiceAgentManager(storage)
+ *
+ * // Create a voice agent
+ * const agent = await manager.create({
+ *   name: 'Sales Assistant',
+ *   provider: 'vapi',
+ *   voice: { provider: 'elevenlabs', voiceId: 'voice_rachel' },
+ *   conversation: { systemPrompt: '...', model: 'gpt-4o', modelProvider: 'openai' },
+ *   ownerRef: { $id: 'do_123', $type: 'Organization' },
+ * })
+ *
+ * // Update voice settings
+ * await manager.update(agent.id, { voice: { speed: 1.1 } })
+ *
+ * // List all agents
+ * const agents = await manager.list({ status: 'active' })
+ * ```
+ */
+export class VoiceAgentManager {
+    storage;
+    /**
+     * Create a new voice agent manager
+     *
+     * @param storage - DO storage interface
+     */
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Create a new voice agent
+     *
+     * Creates the agent in both the local DO storage and the provider's system.
+     *
+     * @param options - Agent configuration
+     * @returns Created voice agent
+     */
+    async create(options) {
+        const id = `vagent_${generateId()}`;
+        const now = Date.now();
+        // Create agent in provider's system
+        const adapter = VoiceProviderFactory.get(options.provider);
+        const providerConfig = {
+            voice: options.voice,
+            conversation: options.conversation,
+            phone: options.phone ? {
+                inboundNumber: options.phone.inboundNumber,
+                outboundCallerId: options.phone.outboundCallerId,
+            } : undefined,
+            webhooks: options.webhooks ? {
+                onCallStart: options.webhooks.onCallStart,
+                onCallEnd: options.webhooks.onCallEnd,
+                onTranscript: options.webhooks.onTranscript,
+                onToolCall: options.webhooks.onToolCall,
+            } : undefined,
+        };
+        const providerResult = await adapter.createAgent(providerConfig);
+        // Create local agent record
+        const agent = {
+            id,
+            name: options.name,
+            provider: options.provider,
+            voice: options.voice,
+            conversation: options.conversation,
+            phone: options.phone,
+            webhooks: options.webhooks,
+            ownerRef: options.ownerRef,
+            status: 'Active',
+            createdAt: now,
+            updatedAt: now,
+        };
+        // Store with provider agent ID
+        await this.storage.put(`voice_agent:${id}`, {
+            ...agent,
+            providerAgentId: providerResult.providerAgentId,
+            providerMetadata: providerResult.metadata,
+        });
+        // Index by provider agent ID for webhook lookup
+        await this.storage.put(`voice_agent_provider:${providerResult.providerAgentId}`, id);
+        return agent;
+    }
+    /**
+     * Get a voice agent by ID
+     *
+     * @param id - Voice agent ID
+     * @returns Voice agent or null if not found
+     */
+    async get(id) {
+        const data = await this.storage.get(`voice_agent:${id}`);
+        if (!data)
+            return null;
+        // Remove internal fields
+        const { providerAgentId, providerMetadata, ...agent } = data;
+        return agent;
+    }
+    /**
+     * Get a voice agent by provider agent ID
+     *
+     * Useful for webhook processing where only the provider's ID is known.
+     *
+     * @param providerAgentId - Provider's agent ID
+     * @returns Voice agent or null if not found
+     */
+    async getByProviderAgentId(providerAgentId) {
+        const id = await this.storage.get(`voice_agent_provider:${providerAgentId}`);
+        if (!id)
+            return null;
+        return this.get(id);
+    }
+    /**
+     * Update a voice agent
+     *
+     * Updates both local storage and provider's system.
+     *
+     * @param id - Voice agent ID
+     * @param options - Fields to update
+     * @returns Updated voice agent
+     * @throws Error if agent not found
+     */
+    async update(id, options) {
+        const existing = await this.storage.get(`voice_agent:${id}`);
+        if (!existing) {
+            throw new Error(`Voice agent not found: ${id}`);
+        }
+        // Update provider if voice/conversation config changed
+        if (options.voice || options.conversation || options.phone || options.webhooks) {
+            const adapter = VoiceProviderFactory.get(existing.provider);
+            const providerConfig = {};
+            if (options.voice) {
+                providerConfig.voice = { ...existing.voice, ...options.voice };
+            }
+            if (options.conversation) {
+                providerConfig.conversation = { ...existing.conversation, ...options.conversation };
+            }
+            if (options.phone) {
+                providerConfig.phone = {
+                    inboundNumber: options.phone.inboundNumber ?? existing.phone?.inboundNumber,
+                    outboundCallerId: options.phone.outboundCallerId ?? existing.phone?.outboundCallerId,
+                };
+            }
+            if (options.webhooks) {
+                providerConfig.webhooks = {
+                    onCallStart: options.webhooks.onCallStart ?? existing.webhooks?.onCallStart,
+                    onCallEnd: options.webhooks.onCallEnd ?? existing.webhooks?.onCallEnd,
+                    onTranscript: options.webhooks.onTranscript ?? existing.webhooks?.onTranscript,
+                    onToolCall: options.webhooks.onToolCall ?? existing.webhooks?.onToolCall,
+                };
+            }
+            await adapter.updateAgent(existing.providerAgentId, providerConfig);
+        }
+        // Update local storage
+        const updated = {
+            ...existing,
+            name: options.name ?? existing.name,
+            voice: options.voice ? { ...existing.voice, ...options.voice } : existing.voice,
+            conversation: options.conversation ? { ...existing.conversation, ...options.conversation } : existing.conversation,
+            phone: options.phone ? { enabled: existing.phone?.enabled ?? false, ...existing.phone, ...options.phone } : existing.phone,
+            webhooks: options.webhooks ? { ...existing.webhooks, ...options.webhooks } : existing.webhooks,
+            status: options.status ? (options.status === 'active' ? 'Active' : 'Inactive') : existing.status,
+            updatedAt: Date.now(),
+        };
+        await this.storage.put(`voice_agent:${id}`, updated);
+        const { providerAgentId, providerMetadata, ...agent } = updated;
+        return agent;
+    }
+    /**
+     * Delete a voice agent
+     *
+     * Removes from both local storage and provider's system.
+     *
+     * @param id - Voice agent ID
+     * @returns True if deleted, false if not found
+     */
+    async delete(id) {
+        const existing = await this.storage.get(`voice_agent:${id}`);
+        if (!existing) {
+            return false;
+        }
+        // Delete from provider
+        const adapter = VoiceProviderFactory.get(existing.provider);
+        await adapter.deleteAgent(existing.providerAgentId);
+        // Delete from local storage
+        await this.storage.delete(`voice_agent:${id}`);
+        await this.storage.delete(`voice_agent_provider:${existing.providerAgentId}`);
+        return true;
+    }
+    /**
+     * List voice agents
+     *
+     * @param options - Filter and pagination options
+     * @returns List of voice agents
+     */
+    async list(options = {}) {
+        const { status, provider, ownerRef, limit = 50, offset = 0 } = options;
+        // Get all agents (in production, use SQL with proper filtering)
+        const allAgents = await this.storage.list({ prefix: 'voice_agent:' });
+        let items = [];
+        for (const [, agent] of allAgents) {
+            // Apply filters
+            const statusMatch = status ? (status === 'active' ? 'Active' : status === 'inactive' ? 'Inactive' : 'Error') : null;
+            if (statusMatch && agent.status !== statusMatch)
+                continue;
+            if (provider && agent.provider !== provider)
+                continue;
+            if (ownerRef && agent.ownerRef !== ownerRef)
+                continue;
+            // Remove internal fields
+            const { providerAgentId, providerMetadata, ...cleanAgent } = agent;
+            items.push(cleanAgent);
+        }
+        // Sort by createdAt descending
+        items.sort((a, b) => b.createdAt - a.createdAt);
+        const total = items.length;
+        items = items.slice(offset, offset + limit);
+        return {
+            items,
+            total,
+            hasMore: offset + items.length < total,
+        };
+    }
+    /**
+     * Add a tool to a voice agent
+     *
+     * @param id - Voice agent ID
+     * @param tool - Tool to add
+     * @returns Updated voice agent
+     */
+    async addTool(id, tool) {
+        const existing = await this.storage.get(`voice_agent:${id}`);
+        if (!existing) {
+            throw new Error(`Voice agent not found: ${id}`);
+        }
+        const tools = existing.conversation.tools || [];
+        if (tools.some((t) => t.name === tool.name)) {
+            throw new Error(`Tool already exists: ${tool.name}`);
+        }
+        return this.update(id, {
+            conversation: {
+                tools: [...tools, tool],
+            },
+        });
+    }
+    /**
+     * Remove a tool from a voice agent
+     *
+     * @param id - Voice agent ID
+     * @param toolName - Name of tool to remove
+     * @returns Updated voice agent
+     */
+    async removeTool(id, toolName) {
+        const existing = await this.storage.get(`voice_agent:${id}`);
+        if (!existing) {
+            throw new Error(`Voice agent not found: ${id}`);
+        }
+        const tools = existing.conversation.tools || [];
+        const filtered = tools.filter((t) => t.name !== toolName);
+        if (filtered.length === tools.length) {
+            throw new Error(`Tool not found: ${toolName}`);
+        }
+        return this.update(id, {
+            conversation: {
+                tools: filtered,
+            },
+        });
+    }
+    /**
+     * Set agent status
+     *
+     * @param id - Voice agent ID
+     * @param status - New status
+     * @returns Updated voice agent
+     */
+    async setStatus(id, status) {
+        return this.update(id, { status });
+    }
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Generate a random ID
+ * @returns Random ID string
+ */
+function generateId() {
+    // TODO: Use nanoid
+    return Math.random().toString(36).substring(2, 15);
+}
+// =============================================================================
+// Singleton Access (for convenience)
+// =============================================================================
+let defaultManager = null;
+/**
+ * Voice agents singleton access
+ *
+ * @example
+ * ```typescript
+ * import { VoiceAgents } from 'do/ai/voice'
+ *
+ * const agent = await VoiceAgents.create({ ... })
+ * ```
+ */
+export const VoiceAgents = {
+    /**
+     * Initialize with storage
+     */
+    init(storage) {
+        defaultManager = new VoiceAgentManager(storage);
+    },
+    /**
+     * Create a voice agent
+     */
+    async create(options) {
+        if (!defaultManager)
+            throw new Error('VoiceAgents not initialized');
+        return defaultManager.create(options);
+    },
+    /**
+     * Get a voice agent
+     */
+    async get(id) {
+        if (!defaultManager)
+            throw new Error('VoiceAgents not initialized');
+        return defaultManager.get(id);
+    },
+    /**
+     * Update a voice agent
+     */
+    async update(id, options) {
+        if (!defaultManager)
+            throw new Error('VoiceAgents not initialized');
+        return defaultManager.update(id, options);
+    },
+    /**
+     * Delete a voice agent
+     */
+    async delete(id) {
+        if (!defaultManager)
+            throw new Error('VoiceAgents not initialized');
+        return defaultManager.delete(id);
+    },
+    /**
+     * List voice agents
+     */
+    async list(options) {
+        if (!defaultManager)
+            throw new Error('VoiceAgents not initialized');
+        return defaultManager.list(options);
+    },
+};
+// =============================================================================
+// Type Exports
+// =============================================================================
+// Note: DurableObjectStorage is a Cloudflare Workers type, imported at runtime
+//# sourceMappingURL=agents.js.map

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

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

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

@@ -0,0 +1,307 @@
+/**
+ * Outbound Campaign Management
+ *
+ * Manages automated outbound calling campaigns with
+ * scheduling, contact management, and real-time statistics.
+ *
+ * @module ai/voice/campaigns
+ */
+import type { OutboundCampaign, CampaignContact, CampaignSchedule, CampaignSettings, CampaignStats } from '../../types/voice-ai';
+import { VoiceSessionManager } from './sessions';
+import { VoiceAgentManager } from './agents';
+/**
+ * Options for creating a campaign
+ */
+export interface CreateCampaignOptions {
+    /** Campaign name */
+    name: string;
+    /** Voice agent ID to use for calls */
+    agentId: string;
+    /** Contacts to call */
+    contacts: Omit<CampaignContact, 'id' | 'status'>[];
+    /** Schedule configuration */
+    schedule?: CampaignSchedule;
+    /** Campaign settings */
+    settings: Omit<CampaignSettings, 'callerId'> & {
+        callerId: string;
+    };
+}
+/**
+ * Options for updating a campaign
+ */
+export interface UpdateCampaignOptions {
+    /** Campaign name */
+    name?: string;
+    /** Schedule configuration */
+    schedule?: Partial<CampaignSchedule>;
+    /** Campaign settings */
+    settings?: Partial<CampaignSettings>;
+}
+/**
+ * Options for listing campaigns
+ */
+export interface ListCampaignsOptions {
+    /** Filter by status */
+    status?: OutboundCampaign['status'];
+    /** Filter by agent ID */
+    agentId?: string;
+    /** Limit results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/**
+ * Result of listing campaigns
+ */
+export interface ListCampaignsResult {
+    /** Campaigns */
+    items: OutboundCampaign[];
+    /** Total count */
+    total: number;
+    /** Has more results */
+    hasMore: boolean;
+}
+/**
+ * Campaign event types
+ */
+export type CampaignEventType = 'started' | 'paused' | 'resumed' | 'completed' | 'contact_called' | 'contact_completed' | 'contact_failed' | 'stats_updated';
+/**
+ * Campaign event handler
+ */
+export type CampaignEventHandler<T = unknown> = (data: T) => void | Promise<void>;
+/**
+ * Outbound campaign manager
+ *
+ * Manages automated outbound calling campaigns with scheduling,
+ * contact list management, retry logic, and statistics.
+ *
+ * @example
+ * ```typescript
+ * const manager = new VoiceCampaignManager(storage, sessionManager, agentManager)
+ *
+ * // Create a campaign
+ * const campaign = await manager.create({
+ *   name: 'Q4 Follow-up',
+ *   agentId: 'vagent_sales',
+ *   contacts: [
+ *     { phone: '+1-555-0001', name: 'Alice' },
+ *     { phone: '+1-555-0002', name: 'Bob' },
+ *   ],
+ *   schedule: {
+ *     startDate: Date.now(),
+ *     callingHours: { start: '09:00', end: '17:00' },
+ *     daysOfWeek: [1, 2, 3, 4, 5],
+ *     timezone: 'America/New_York',
+ *     maxConcurrent: 5,
+ *   },
+ *   settings: {
+ *     maxAttempts: 3,
+ *     retryDelay: 60,
+ *     voicemailDetection: true,
+ *     callerId: '+1-555-0100',
+ *   },
+ * })
+ *
+ * // Start the campaign
+ * await manager.start(campaign.id)
+ *
+ * // Monitor stats
+ * const stats = await manager.getStats(campaign.id)
+ * ```
+ */
+export declare class VoiceCampaignManager {
+    private storage;
+    private sessionManager;
+    private agentManager;
+    private eventHandlers;
+    /**
+     * Create a campaign manager
+     *
+     * @param storage - DO storage interface
+     * @param sessionManager - Voice session manager
+     * @param agentManager - Voice agent manager
+     */
+    constructor(storage: DurableObjectStorage, sessionManager: VoiceSessionManager, agentManager: VoiceAgentManager);
+    /**
+     * Create a new campaign
+     *
+     * @param options - Campaign options
+     * @returns Created campaign
+     */
+    create(options: CreateCampaignOptions): Promise<OutboundCampaign>;
+    /**
+     * Get a campaign by ID
+     *
+     * @param id - Campaign ID
+     * @returns Campaign or null if not found
+     */
+    get(id: string): Promise<OutboundCampaign | null>;
+    /**
+     * Update a campaign
+     *
+     * Can only update draft or paused campaigns.
+     *
+     * @param id - Campaign ID
+     * @param options - Fields to update
+     * @returns Updated campaign
+     */
+    update(id: string, options: UpdateCampaignOptions): Promise<OutboundCampaign>;
+    /**
+     * Add contacts to a campaign
+     *
+     * Can only add contacts to draft or paused campaigns.
+     *
+     * @param id - Campaign ID
+     * @param contacts - Contacts to add
+     * @returns Updated campaign
+     */
+    addContacts(id: string, contacts: Omit<CampaignContact, 'id' | 'status'>[]): Promise<OutboundCampaign>;
+    /**
+     * Remove a contact from a campaign
+     *
+     * @param id - Campaign ID
+     * @param contactId - Contact ID
+     * @returns Updated campaign
+     */
+    removeContact(id: string, contactId: string): Promise<OutboundCampaign>;
+    /**
+     * Start a campaign
+     *
+     * @param id - Campaign ID
+     * @returns Updated campaign
+     */
+    start(id: string): Promise<OutboundCampaign>;
+    /**
+     * Pause a running campaign
+     *
+     * @param id - Campaign ID
+     * @returns Updated campaign
+     */
+    pause(id: string): Promise<OutboundCampaign>;
+    /**
+     * Resume a paused campaign
+     *
+     * @param id - Campaign ID
+     * @returns Updated campaign
+     */
+    resume(id: string): Promise<OutboundCampaign>;
+    /**
+     * Stop a campaign (mark as completed)
+     *
+     * @param id - Campaign ID
+     * @returns Updated campaign
+     */
+    stop(id: string): Promise<OutboundCampaign>;
+    /**
+     * Delete a campaign
+     *
+     * @param id - Campaign ID
+     * @returns True if deleted
+     */
+    delete(id: string): Promise<boolean>;
+    /**
+     * List campaigns
+     *
+     * @param options - Filter and pagination options
+     * @returns List of campaigns
+     */
+    list(options?: ListCampaignsOptions): Promise<ListCampaignsResult>;
+    /**
+     * Get campaign statistics
+     *
+     * @param id - Campaign ID
+     * @returns Campaign statistics
+     */
+    getStats(id: string): Promise<CampaignStats>;
+    /**
+     * Schedule the next batch of calls
+     *
+     * @param id - Campaign ID
+     */
+    scheduleNextBatch(id: string): Promise<void>;
+    /**
+     * Start a call for a campaign contact
+     *
+     * @param campaignId - Campaign ID
+     * @param contact - Contact to call
+     */
+    private startContactCall;
+    /**
+     * Update contact status
+     */
+    private updateContactStatus;
+    /**
+     * Update contact with session ID
+     */
+    private updateContactSession;
+    /**
+     * Handle session completion (called from webhook processor)
+     *
+     * @param campaignId - Campaign ID
+     * @param contactId - Contact ID
+     * @param outcome - Call outcome
+     */
+    handleSessionComplete(campaignId: string, contactId: string, outcome: 'Completed' | 'Failed'): Promise<void>;
+    /**
+     * Subscribe to campaign events
+     *
+     * @param campaignId - Campaign ID
+     * @param event - Event type
+     * @param handler - Event handler
+     * @returns Unsubscribe function
+     */
+    on(campaignId: string, event: CampaignEventType, handler: CampaignEventHandler): () => void;
+    /**
+     * Watch campaign stats (returns async iterator)
+     *
+     * @param campaignId - Campaign ID
+     * @returns Async iterator of stats updates
+     */
+    watchStats(campaignId: string): AsyncGenerator<CampaignStats>;
+    /**
+     * Emit a campaign event
+     */
+    private emit;
+}
+/**
+ * Voice campaigns singleton access
+ */
+export declare const VoiceCampaigns: {
+    /**
+     * Initialize with dependencies
+     */
+    init(storage: DurableObjectStorage, sessionManager: VoiceSessionManager, agentManager: VoiceAgentManager): void;
+    /**
+     * Create a campaign
+     */
+    create(options: CreateCampaignOptions): Promise<OutboundCampaign>;
+    /**
+     * Get a campaign
+     */
+    get(id: string): Promise<OutboundCampaign | null>;
+    /**
+     * Start a campaign
+     */
+    start(id: string): Promise<OutboundCampaign>;
+    /**
+     * Pause a campaign
+     */
+    pause(id: string): Promise<OutboundCampaign>;
+    /**
+     * Resume a campaign
+     */
+    resume(id: string): Promise<OutboundCampaign>;
+    /**
+     * Get campaign stats
+     */
+    getStats(id: string): Promise<CampaignStats>;
+    /**
+     * List campaigns
+     */
+    list(options?: ListCampaignsOptions): Promise<ListCampaignsResult>;
+    /**
+     * Watch campaign stats
+     */
+    watchStats(id: string): AsyncGenerator<CampaignStats>;
+};
+//# sourceMappingURL=campaigns.d.ts.map