@dotdo/do 0.1.0

package/dist/ai/voice/webrtc.js

@@ -0,0 +1,372 @@
+/**
+ * WebRTC Session Handling
+ *
+ * Manages browser-based voice calls using WebRTC.
+ * Supports multiple providers (LiveKit, Daily, Twilio).
+ *
+ * @module ai/voice/webrtc
+ */
+import { VoiceProviderFactory } from './providers';
+// =============================================================================
+// WebRTC Session Manager
+// =============================================================================
+/**
+ * WebRTC session manager
+ *
+ * Creates and manages WebRTC sessions for browser-based voice calls.
+ * Works with LiveKit, Daily, or other WebRTC providers.
+ *
+ * @example
+ * ```typescript
+ * const manager = new WebRTCSessionManager(storage, agentManager, sessionManager)
+ *
+ * // Create a session for a user
+ * const { sessionId, roomUrl, token } = await manager.create({
+ *   agentId: 'vagent_support',
+ *   identity: 'user_123',
+ *   displayName: 'John Doe',
+ *   audioOnly: true,
+ * })
+ *
+ * // Client uses token to connect
+ * // const room = await LivekitClient.connect(roomUrl, token)
+ *
+ * // Get room info
+ * const room = await manager.getRoom(sessionId)
+ * ```
+ */
+export class WebRTCSessionManager {
+    storage;
+    agentManager;
+    sessionManager;
+    /**
+     * Create a WebRTC session manager
+     *
+     * @param storage - DO storage interface
+     * @param agentManager - Voice agent manager
+     * @param sessionManager - Voice session manager
+     */
+    constructor(storage, agentManager, sessionManager) {
+        this.storage = storage;
+        this.agentManager = agentManager;
+        this.sessionManager = sessionManager;
+    }
+    /**
+     * Create a new WebRTC session
+     *
+     * Creates a room and generates an access token for the participant.
+     *
+     * @param options - Session options
+     * @returns Session details including token and room URL
+     */
+    async create(options) {
+        const { agentId, identity, displayName, audioOnly, autoConnect, metadata, transcription } = options;
+        // Get agent
+        const agent = await this.agentManager.get(agentId);
+        if (!agent) {
+            throw new Error(`Voice agent not found: ${agentId}`);
+        }
+        // Get provider adapter
+        const adapter = VoiceProviderFactory.get(agent.provider);
+        if (!adapter.createRoom) {
+            throw new Error(`Provider ${agent.provider} does not support WebRTC`);
+        }
+        // Get provider agent ID
+        const agentData = await this.storage.get(`voice_agent:${agentId}`);
+        if (!agentData?.providerAgentId) {
+            throw new Error(`Provider agent ID not found for: ${agentId}`);
+        }
+        // Create room via provider
+        const { token, roomUrl } = await adapter.createRoom(agentData.providerAgentId, identity);
+        // Extract room name from URL
+        const roomName = extractRoomName(roomUrl);
+        // Create voice session to track the call
+        const session = await this.sessionManager.createInbound(agentId, roomName, identity);
+        // Create config
+        const config = {
+            provider: agent.provider,
+            roomName,
+            identity,
+            audioOnly: audioOnly ?? true,
+            autoConnect: autoConnect ?? true,
+            token,
+        };
+        // Store room info
+        const room = {
+            name: roomName,
+            url: roomUrl,
+            sessionId: session.id,
+            agentId,
+            provider: agent.provider,
+            participants: [
+                {
+                    identity,
+                    displayName,
+                    isAgent: false,
+                    joinedAt: Date.now(),
+                    connectionState: 'connecting',
+                },
+            ],
+            createdAt: Date.now(),
+            status: 'active',
+        };
+        await this.storage.put(`webrtc_room:${roomName}`, room);
+        await this.storage.put(`webrtc_session:${session.id}`, roomName);
+        return {
+            sessionId: session.id,
+            roomName,
+            roomUrl,
+            token,
+            config,
+        };
+    }
+    /**
+     * Get room information
+     *
+     * @param sessionId - Voice session ID
+     * @returns Room info or null if not found
+     */
+    async getRoom(sessionId) {
+        const roomName = await this.storage.get(`webrtc_session:${sessionId}`);
+        if (!roomName)
+            return null;
+        const room = await this.storage.get(`webrtc_room:${roomName}`);
+        return room ?? null;
+    }
+    /**
+     * Get room by name
+     *
+     * @param roomName - Room name
+     * @returns Room info or null if not found
+     */
+    async getRoomByName(roomName) {
+        const room = await this.storage.get(`webrtc_room:${roomName}`);
+        return room ?? null;
+    }
+    /**
+     * Generate a new token for an existing room
+     *
+     * Useful when a participant needs to reconnect.
+     *
+     * @param sessionId - Voice session ID
+     * @param identity - Participant identity
+     * @returns New access token
+     */
+    async generateToken(sessionId, identity) {
+        const room = await this.getRoom(sessionId);
+        if (!room) {
+            throw new Error(`Room not found for session: ${sessionId}`);
+        }
+        const agent = await this.agentManager.get(room.agentId);
+        if (!agent) {
+            throw new Error(`Voice agent not found: ${room.agentId}`);
+        }
+        const adapter = VoiceProviderFactory.get(agent.provider);
+        if (!adapter.createRoom) {
+            throw new Error(`Provider ${agent.provider} does not support WebRTC`);
+        }
+        const agentData = await this.storage.get(`voice_agent:${room.agentId}`);
+        if (!agentData?.providerAgentId) {
+            throw new Error(`Provider agent ID not found for: ${room.agentId}`);
+        }
+        // Create room returns new token (most providers allow re-joining existing rooms)
+        const { token } = await adapter.createRoom(agentData.providerAgentId, identity);
+        return token;
+    }
+    /**
+     * Update participant connection state
+     *
+     * Called from webhook when participant joins/leaves.
+     *
+     * @param roomName - Room name
+     * @param identity - Participant identity
+     * @param state - Connection state
+     */
+    async updateParticipantState(roomName, identity, state) {
+        const room = await this.getRoomByName(roomName);
+        if (!room)
+            return;
+        const updated = {
+            ...room,
+            participants: room.participants.map((p) => p.identity === identity ? { ...p, connectionState: state } : p),
+        };
+        await this.storage.put(`webrtc_room:${roomName}`, updated);
+    }
+    /**
+     * Add a participant to a room
+     *
+     * @param roomName - Room name
+     * @param participant - Participant info
+     */
+    async addParticipant(roomName, participant) {
+        const room = await this.getRoomByName(roomName);
+        if (!room)
+            return;
+        const exists = room.participants.some((p) => p.identity === participant.identity);
+        if (exists) {
+            // Update existing participant
+            await this.updateParticipantState(roomName, participant.identity, participant.connectionState);
+            return;
+        }
+        const updated = {
+            ...room,
+            participants: [...room.participants, participant],
+        };
+        await this.storage.put(`webrtc_room:${roomName}`, updated);
+    }
+    /**
+     * Remove a participant from a room
+     *
+     * @param roomName - Room name
+     * @param identity - Participant identity
+     */
+    async removeParticipant(roomName, identity) {
+        const room = await this.getRoomByName(roomName);
+        if (!room)
+            return;
+        const updated = {
+            ...room,
+            participants: room.participants.filter((p) => p.identity !== identity),
+        };
+        await this.storage.put(`webrtc_room:${roomName}`, updated);
+        // If no human participants left, close the room
+        const humanParticipants = updated.participants.filter((p) => !p.isAgent);
+        if (humanParticipants.length === 0) {
+            await this.closeRoom(roomName);
+        }
+    }
+    /**
+     * Close a room
+     *
+     * @param roomName - Room name
+     */
+    async closeRoom(roomName) {
+        const room = await this.getRoomByName(roomName);
+        if (!room)
+            return;
+        // Update room status
+        const updated = {
+            ...room,
+            status: 'closed',
+        };
+        await this.storage.put(`webrtc_room:${roomName}`, updated);
+        // End the voice session
+        await this.sessionManager.end(room.sessionId);
+    }
+    /**
+     * List active rooms
+     *
+     * @param agentId - Optional filter by agent
+     * @returns List of active rooms
+     */
+    async listActiveRooms(agentId) {
+        const allRooms = await this.storage.list({ prefix: 'webrtc_room:' });
+        const rooms = [];
+        for (const [, room] of allRooms) {
+            if (room.status !== 'active')
+                continue;
+            if (agentId && room.agentId !== agentId)
+                continue;
+            rooms.push(room);
+        }
+        return rooms;
+    }
+    /**
+     * Clean up old/stale rooms
+     *
+     * Should be called periodically to clean up rooms that weren't
+     * properly closed.
+     *
+     * @param maxAge - Maximum age in milliseconds (default: 24 hours)
+     */
+    async cleanup(maxAge = 24 * 60 * 60 * 1000) {
+        const cutoff = Date.now() - maxAge;
+        const allRooms = await this.storage.list({ prefix: 'webrtc_room:' });
+        let cleaned = 0;
+        for (const [key, room] of allRooms) {
+            if (room.createdAt < cutoff) {
+                await this.storage.delete(key);
+                await this.storage.delete(`webrtc_session:${room.sessionId}`);
+                cleaned++;
+            }
+        }
+        return cleaned;
+    }
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Extract room name from room URL
+ */
+function extractRoomName(roomUrl) {
+    try {
+        const url = new URL(roomUrl);
+        // Most providers use the last path segment as room name
+        const parts = url.pathname.split('/').filter(Boolean);
+        return parts[parts.length - 1] || `room_${generateId()}`;
+    }
+    catch {
+        // If not a valid URL, use as-is or generate
+        return roomUrl || `room_${generateId()}`;
+    }
+}
+/**
+ * Generate a random ID
+ */
+function generateId() {
+    // TODO: Use nanoid
+    return Math.random().toString(36).substring(2, 15);
+}
+// =============================================================================
+// Singleton Access
+// =============================================================================
+let defaultManager = null;
+/**
+ * WebRTC session singleton access
+ */
+export const WebRTCSession = {
+    /**
+     * Initialize with dependencies
+     */
+    init(storage, agentManager, sessionManager) {
+        defaultManager = new WebRTCSessionManager(storage, agentManager, sessionManager);
+    },
+    /**
+     * Create a WebRTC session
+     */
+    async create(options) {
+        if (!defaultManager)
+            throw new Error('WebRTCSession not initialized');
+        return defaultManager.create(options);
+    },
+    /**
+     * Get room info
+     */
+    async getRoom(sessionId) {
+        if (!defaultManager)
+            throw new Error('WebRTCSession not initialized');
+        return defaultManager.getRoom(sessionId);
+    },
+    /**
+     * Generate new token
+     */
+    async generateToken(sessionId, identity) {
+        if (!defaultManager)
+            throw new Error('WebRTCSession not initialized');
+        return defaultManager.generateToken(sessionId, identity);
+    },
+    /**
+     * List active rooms
+     */
+    async listActiveRooms(agentId) {
+        if (!defaultManager)
+            throw new Error('WebRTCSession not initialized');
+        return defaultManager.listActiveRooms(agentId);
+    },
+};
+// =============================================================================
+// Type Exports
+// =============================================================================
+// Note: DurableObjectStorage is a Cloudflare Workers type, imported at runtime
+//# sourceMappingURL=webrtc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webrtc.js","sourceRoot":"","sources":["../../../ai/voice/webrtc.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AA6FlD,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,oBAAoB;IASrB;IACA;IACA;IAVV;;;;;;OAMG;IACH,YACU,OAA6B,EAC7B,YAA+B,EAC/B,cAAmC;QAFnC,YAAO,GAAP,OAAO,CAAsB;QAC7B,iBAAY,GAAZ,YAAY,CAAmB;QAC/B,mBAAc,GAAd,cAAc,CAAqB;IAC1C,CAAC;IAEJ;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,OAAmC;QAC9C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAA;QAEnG,YAAY;QACZ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAClD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAA;QACtD,CAAC;QAED,uBAAuB;QACvB,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QACxD,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,QAAQ,0BAA0B,CAAC,CAAA;QACvE,CAAC;QAED,wBAAwB;QACxB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAA8B,eAAe,OAAO,EAAE,CAAC,CAAA;QAC/F,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAA;QAChE,CAAC;QAED,2BAA2B;QAC3B,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;QAExF,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;QAEzC,yCAAyC;QACzC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAEpF,gBAAgB;QAChB,MAAM,MAAM,GAAiB;YAC3B,QAAQ,EAAE,KAAK,CAAC,QAA0C;YAC1D,QAAQ;YACR,QAAQ;YACR,SAAS,EAAE,SAAS,IAAI,IAAI;YAC5B,WAAW,EAAE,WAAW,IAAI,IAAI;YAChC,KAAK;SACN,CAAA;QAED,kBAAkB;QAClB,MAAM,IAAI,GAAe;YACvB,IAAI,EAAE,QAAQ;YACd,GAAG,EAAE,OAAO;YACZ,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,OAAO;YACP,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,YAAY,EAAE;gBACZ;oBACE,QAAQ;oBACR,WAAW;oBACX,OAAO,EAAE,KAAK;oBACd,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;oBACpB,eAAe,EAAE,YAAY;iBAC9B;aACF;YACD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,MAAM,EAAE,QAAQ;SACjB,CAAA;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAA;QACvD,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,OAAO,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAA;QAEhE,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,QAAQ;YACR,OAAO;YACP,KAAK;YACL,MAAM;SACP,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAS,kBAAkB,SAAS,EAAE,CAAC,CAAA;QAC9E,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAA;QAE1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAa,eAAe,QAAQ,EAAE,CAAC,CAAA;QAC1E,OAAO,IAAI,IAAI,IAAI,CAAA;IACrB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,QAAgB;QAClC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAa,eAAe,QAAQ,EAAE,CAAC,CAAA;QAC1E,OAAO,IAAI,IAAI,IAAI,CAAA;IACrB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,QAAgB;QACrD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,+BAA+B,SAAS,EAAE,CAAC,CAAA;QAC7D,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACvD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;QAC3D,CAAC;QAED,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QACxD,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,QAAQ,0BAA0B,CAAC,CAAA;QACvE,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAA8B,eAAe,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;QACpG,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;QACrE,CAAC;QAED,iFAAiF;QACjF,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;QAE/E,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,sBAAsB,CAC1B,QAAgB,EAChB,QAAgB,EAChB,KAA2C;QAE3C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QAC/C,IAAI,CAAC,IAAI;YAAE,OAAM;QAEjB,MAAM,OAAO,GAAe;YAC1B,GAAG,IAAI;YACP,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACxC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAC/D;SACF,CAAA;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAA;IAC5D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,QAAgB,EAAE,WAA8B;QACnE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QAC/C,IAAI,CAAC,IAAI;YAAE,OAAM;QAEjB,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW,CAAC,QAAQ,CAAC,CAAA;QACjF,IAAI,MAAM,EAAE,CAAC;YACX,8BAA8B;YAC9B,MAAM,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,eAAe,CAAC,CAAA;YAC9F,OAAM;QACR,CAAC;QAED,MAAM,OAAO,GAAe;YAC1B,GAAG,IAAI;YACP,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC;SAClD,CAAA;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAA;IAC5D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,iBAAiB,CAAC,QAAgB,EAAE,QAAgB;QACxD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QAC/C,IAAI,CAAC,IAAI;YAAE,OAAM;QAEjB,MAAM,OAAO,GAAe;YAC1B,GAAG,IAAI;YACP,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC;SACvE,CAAA;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAA;QAE1D,gDAAgD;QAChD,MAAM,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACxE,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,QAAgB;QAC9B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QAC/C,IAAI,CAAC,IAAI;YAAE,OAAM;QAEjB,qBAAqB;QACrB,MAAM,OAAO,GAAe;YAC1B,GAAG,IAAI;YACP,MAAM,EAAE,QAAQ;SACjB,CAAA;QACD,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAA;QAE1D,wBAAwB;QACxB,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC/C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,OAAgB;QACpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAa,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;QAEhF,MAAM,KAAK,GAAiB,EAAE,CAAA;QAC9B,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;gBAAE,SAAQ;YACtC,IAAI,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO;gBAAE,SAAQ;YACjD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClB,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAA;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAa,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;QAEhF,IAAI,OAAO,GAAG,CAAC,CAAA;QACf,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,SAAS,GAAG,MAAM,EAAE,CAAC;gBAC5B,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBAC9B,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;gBAC7D,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;CACF;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;GAEG;AACH,SAAS,eAAe,CAAC,OAAe;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;QAC5B,wDAAwD;QACxD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACrD,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,UAAU,EAAE,EAAE,CAAA;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,4CAA4C;QAC5C,OAAO,OAAO,IAAI,QAAQ,UAAU,EAAE,EAAE,CAAA;IAC1C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,UAAU;IACjB,mBAAmB;IACnB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AACpD,CAAC;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,IAAI,cAAc,GAAgC,IAAI,CAAA;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;;OAEG;IACH,IAAI,CACF,OAA6B,EAC7B,YAA+B,EAC/B,cAAmC;QAEnC,cAAc,GAAG,IAAI,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,CAAC,CAAA;IAClF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAmC;QAC9C,IAAI,CAAC,cAAc;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;QACrE,OAAO,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,IAAI,CAAC,cAAc;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;QACrE,OAAO,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,QAAgB;QACrD,IAAI,CAAC,cAAc;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;QACrE,OAAO,cAAc,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IAC1D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,OAAgB;QACpC,IAAI,CAAC,cAAc;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;QACrE,OAAO,cAAc,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IAChD,CAAC;CACF,CAAA;AAED,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF,+EAA+E"}

package/dist/api/index.d.ts

@@ -0,0 +1,103 @@
+/**
+ * DO API Module
+ *
+ * Hono-based API layer for Digital Objects.
+ * Provides REST, RPC, and MCP endpoints with composable middleware.
+ *
+ * @example
+ * ```typescript
+ * import { createApp } from './api'
+ *
+ * // Create the app with all defaults
+ * const app = createApp()
+ *
+ * // Or customize
+ * const app = createApp({
+ *   cors: true,
+ *   rateLimit: true,
+ *   auth: false,
+ * })
+ *
+ * export default {
+ *   fetch: app.fetch,
+ * }
+ * ```
+ */
+import { Hono } from 'hono';
+import type { Env, DOContext } from './types';
+/**
+ * App configuration options
+ */
+export interface AppConfig {
+    /** Enable CORS middleware (default: true) */
+    cors?: boolean;
+    /** Enable rate limiting (default: true) */
+    rateLimit?: boolean;
+    /** Enable authentication middleware (default: false) */
+    auth?: boolean;
+    /** Enable request logging (default: true in dev, false in prod) */
+    logging?: boolean;
+    /** Enable security headers (default: true) */
+    security?: boolean;
+    /** Custom middleware to add */
+    middleware?: Array<(c: unknown, next: () => Promise<void>) => Promise<void | Response>>;
+}
+/**
+ * Create a fully configured Hono app for the DO API
+ *
+ * @example
+ * // Basic usage - all defaults
+ * const app = createApp()
+ *
+ * @example
+ * // Production setup
+ * const app = createApp({
+ *   cors: true,
+ *   rateLimit: true,
+ *   auth: true,
+ *   logging: false,
+ *   security: true,
+ * })
+ *
+ * @example
+ * // Development setup
+ * const app = createApp({
+ *   cors: true,
+ *   rateLimit: false,
+ *   auth: false,
+ *   logging: true,
+ * })
+ */
+export declare function createApp(config?: AppConfig): Hono<{
+    Bindings: Env;
+    Variables: DOContext;
+}>;
+/**
+ * Create a minimal app with just core middleware
+ * Useful for testing or when you want full control
+ */
+export declare function createMinimalApp(): Hono<{
+    Bindings: Env;
+    Variables: DOContext;
+}>;
+/**
+ * Create a production-ready app with all security features
+ */
+export declare function createProductionApp(): Hono<{
+    Bindings: Env;
+    Variables: DOContext;
+}>;
+/**
+ * Create a development app with logging and relaxed security
+ */
+export declare function createDevelopmentApp(): Hono<{
+    Bindings: Env;
+    Variables: DOContext;
+}>;
+export type { Env, DOContext, AuthUser, AuthOptions, AuthResult, APIResponse, APIErrorResponse, PaginatedResponse, PaginationInfo, RateLimitConfig, RateLimitInfo, CORSConfig, HealthCheckResponse, AIGenerateRequest, AIChatRequest, AIEmbedRequest, } from './types';
+export { createAuthMiddleware, createApiKeyMiddleware, createCorsMiddleware, createDynamicCorsMiddleware, createRateLimitMiddleware, createAIRateLimitMiddleware, createWriteRateLimitMiddleware, createContextMiddleware, createLoggingMiddleware, createErrorMiddleware, createSecurityMiddleware, composeMiddleware, getUser, requireUser, hasRole, hasPermission, } from './middleware';
+export { createHealthRoutes, createDORoutes, createAIRoutes, createRootRoute, createRPCRoutes, createAllRoutes, createRolesRoutes, } from './routes';
+export { createMCPRoutes, getTools, handleListTools, handleToolCall, handleInitialize, } from './mcp';
+export type { MCPServerInfo, MCPTool, MCPContent, MCPRequest, MCPToolCallResponse, MCPListToolsResponse, } from './mcp';
+export default createApp;
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AA2B7C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,wDAAwD;IACxD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAA;CACxF;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,MAAM,GAAE,SAAc,GAAG,IAAI,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC,CA8F/F;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC,CAQhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC,CAQnF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC,CAQpF;AAOD,YAAY,EACV,GAAG,EACH,SAAS,EACT,QAAQ,EACR,WAAW,EACX,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,2BAA2B,EAC3B,8BAA8B,EAC9B,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,OAAO,EACP,WAAW,EACX,OAAO,EACP,aAAa,GACd,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EAGf,iBAAiB,GAClB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,eAAe,EACf,QAAQ,EACR,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,OAAO,CAAA;AAEd,YAAY,EACV,aAAa,EACb,OAAO,EACP,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,OAAO,CAAA;AAMd,eAAe,SAAS,CAAA"}

package/dist/api/index.js

@@ -0,0 +1,191 @@
+/**
+ * DO API Module
+ *
+ * Hono-based API layer for Digital Objects.
+ * Provides REST, RPC, and MCP endpoints with composable middleware.
+ *
+ * @example
+ * ```typescript
+ * import { createApp } from './api'
+ *
+ * // Create the app with all defaults
+ * const app = createApp()
+ *
+ * // Or customize
+ * const app = createApp({
+ *   cors: true,
+ *   rateLimit: true,
+ *   auth: false,
+ * })
+ *
+ * export default {
+ *   fetch: app.fetch,
+ * }
+ * ```
+ */
+import { Hono } from 'hono';
+// Middleware
+import { createContextMiddleware, createErrorMiddleware, createLoggingMiddleware, createSecurityMiddleware, createCorsMiddleware, createRateLimitMiddleware, createAuthMiddleware, } from './middleware';
+// Routes
+import { createHealthRoutes } from './routes/health';
+import { createDORoutes } from './routes/do';
+import { createAIRoutes } from './routes/ai';
+import { createRootRoute, createRPCRoutes } from './routes';
+// Agents routes excluded from 0.0.1 - depends on workers module
+// import { createAgentsRoutes } from './routes/agents'
+import { createRolesRoutes } from './routes/roles';
+import { createMCPRoutes } from './mcp';
+// =============================================================================
+// App Factory
+// =============================================================================
+/**
+ * Create a fully configured Hono app for the DO API
+ *
+ * @example
+ * // Basic usage - all defaults
+ * const app = createApp()
+ *
+ * @example
+ * // Production setup
+ * const app = createApp({
+ *   cors: true,
+ *   rateLimit: true,
+ *   auth: true,
+ *   logging: false,
+ *   security: true,
+ * })
+ *
+ * @example
+ * // Development setup
+ * const app = createApp({
+ *   cors: true,
+ *   rateLimit: false,
+ *   auth: false,
+ *   logging: true,
+ * })
+ */
+export function createApp(config = {}) {
+    const app = new Hono();
+    // ==========================================================================
+    // Core Middleware (always enabled)
+    // ==========================================================================
+    // Request context (request ID, timing, hostname)
+    app.use('*', createContextMiddleware());
+    // Error handling
+    app.use('*', createErrorMiddleware());
+    // ==========================================================================
+    // Optional Middleware
+    // ==========================================================================
+    // Logging (default: true)
+    if (config.logging !== false) {
+        app.use('*', createLoggingMiddleware({
+            skipPaths: ['/_health', '/favicon.ico'],
+        }));
+    }
+    // Security headers (default: true)
+    if (config.security !== false) {
+        app.use('*', createSecurityMiddleware());
+    }
+    // CORS (default: true)
+    if (config.cors !== false) {
+        app.use('*', createCorsMiddleware());
+    }
+    // Rate limiting (default: true)
+    if (config.rateLimit !== false) {
+        app.use('*', createRateLimitMiddleware());
+    }
+    // Authentication (default: false - opt-in)
+    if (config.auth) {
+        app.use('*', createAuthMiddleware());
+    }
+    // Custom middleware
+    if (config.middleware) {
+        for (const mw of config.middleware) {
+            app.use('*', mw);
+        }
+    }
+    // ==========================================================================
+    // Routes
+    // ==========================================================================
+    // Health checks (first to ensure they're always fast)
+    app.route('/', createHealthRoutes());
+    // MCP routes
+    app.route('/', createMCPRoutes());
+    // RPC routes
+    app.route('/', createRPCRoutes());
+    // AI routes
+    app.route('/', createAIRoutes());
+    // Agents routes excluded from 0.0.1 - depends on workers module
+    // app.route('/', createAgentsRoutes())
+    // Roles routes (before generic DO routes for specific path matching)
+    app.route('/', createRolesRoutes());
+    // DO CRUD routes
+    app.route('/', createDORoutes());
+    // Root discovery (last to not interfere with other routes)
+    app.route('/', createRootRoute());
+    // ==========================================================================
+    // Catch-all: Route to DO
+    // ==========================================================================
+    app.all('*', async (c) => {
+        const url = new URL(c.req.url);
+        // Route to the appropriate DO
+        const doId = c.env.DO.idFromName(url.hostname);
+        const stub = c.env.DO.get(doId);
+        return stub.fetch(c.req.raw);
+    });
+    return app;
+}
+// =============================================================================
+// Convenience Functions
+// =============================================================================
+/**
+ * Create a minimal app with just core middleware
+ * Useful for testing or when you want full control
+ */
+export function createMinimalApp() {
+    return createApp({
+        cors: false,
+        rateLimit: false,
+        auth: false,
+        logging: false,
+        security: false,
+    });
+}
+/**
+ * Create a production-ready app with all security features
+ */
+export function createProductionApp() {
+    return createApp({
+        cors: true,
+        rateLimit: true,
+        auth: true,
+        logging: false,
+        security: true,
+    });
+}
+/**
+ * Create a development app with logging and relaxed security
+ */
+export function createDevelopmentApp() {
+    return createApp({
+        cors: true,
+        rateLimit: false,
+        auth: false,
+        logging: true,
+        security: false,
+    });
+}
+// Middleware
+export { createAuthMiddleware, createApiKeyMiddleware, createCorsMiddleware, createDynamicCorsMiddleware, createRateLimitMiddleware, createAIRateLimitMiddleware, createWriteRateLimitMiddleware, createContextMiddleware, createLoggingMiddleware, createErrorMiddleware, createSecurityMiddleware, composeMiddleware, getUser, requireUser, hasRole, hasPermission, } from './middleware';
+// Routes
+export { createHealthRoutes, createDORoutes, createAIRoutes, createRootRoute, createRPCRoutes, createAllRoutes, 
+// Agents routes excluded from 0.0.1 - depends on workers module
+// createAgentsRoutes,
+createRolesRoutes, } from './routes';
+// MCP
+export { createMCPRoutes, getTools, handleListTools, handleToolCall, handleInitialize, } from './mcp';
+// =============================================================================
+// Default Export
+// =============================================================================
+export default createApp;
+//# sourceMappingURL=index.js.map