@framers/agentos 0.1.0

package/dist/core/storage/SqlStorageAdapter.js

@@ -0,0 +1,485 @@
+/**
+ * @file SqlStorageAdapter.ts
+ * @description SQL-based storage adapter for AgentOS using @framers/sql-storage-adapter.
+ *
+ * This implementation provides a complete persistence layer for conversations and messages
+ * using the cross-platform SQL storage adapter. It automatically handles:
+ * - Schema creation and migration
+ * - CRUD operations for conversations and messages
+ * - Transaction support for atomic operations
+ * - Cross-platform compatibility (SQLite, PostgreSQL, SQL.js, etc.)
+ *
+ * **Architecture:**
+ * ```
+ * AgentOS ConversationManager
+ *          ↓
+ *   SqlStorageAdapter (this file)
+ *          ↓
+ *   @framers/sql-storage-adapter
+ *          ↓
+ *   Database (SQLite/PostgreSQL/etc.)
+ * ```
+ *
+ * @version 1.0.0
+ * @author AgentOS Team
+ * @license MIT
+ */
+import { resolveStorageAdapter, } from '@framers/sql-storage-adapter';
+/**
+ * SQL storage adapter implementation for AgentOS.
+ *
+ * Provides full persistence for conversations and messages using a SQL database.
+ * Wraps @framers/sql-storage-adapter to provide AgentOS-specific schema and operations.
+ *
+ * **Features:**
+ * - Cross-platform SQL support (SQLite, PostgreSQL, SQL.js, Capacitor)
+ * - Automatic schema creation and migration
+ * - Efficient querying with indexes
+ * - Transaction support for atomic operations
+ * - Type-safe API with full TypeScript support
+ *
+ * **Database Schema:**
+ * - `conversations` table: Stores conversation metadata
+ * - `messages` table: Stores individual messages with foreign key to conversations
+ * - Indexes on frequently queried columns for performance
+ *
+ * @class SqlStorageAdapter
+ * @implements {IStorageAdapter}
+ *
+ * @example
+ * ```typescript
+ * // Node.js with SQLite
+ * const storage = new SqlStorageAdapter({
+ *   type: 'better-sqlite3',
+ *   database: './data/agentos.db',
+ *   enableWAL: true
+ * });
+ *
+ * await storage.initialize();
+ *
+ * // Browser with SQL.js
+ * const browserStorage = new SqlStorageAdapter({
+ *   type: 'sql.js',
+ *   database: 'agentos.db',
+ *   enableAutoMigration: true
+ * });
+ *
+ * await browserStorage.initialize();
+ * ```
+ */
+export class SqlStorageAdapter {
+    /**
+     * Creates a new SQL storage adapter instance.
+     *
+     * @param {AgentOsSqlStorageConfig} config - Storage configuration
+     *
+     * @example
+     * ```typescript
+     * const storage = new SqlStorageAdapter({
+     *   filePath: './agentos.db',
+     *   priority: ['better-sqlite3']
+     * });
+     * ```
+     */
+    constructor(config = {}) {
+        this.initialized = false;
+        this.config = {
+            enableAutoMigration: true,
+            messageRetentionDays: 0,
+            ...config,
+        };
+    }
+    /**
+     * Initializes the storage adapter and creates the database schema.
+     *
+     * **Schema created:**
+     * - `conversations` table with indexes on userId and agentId
+     * - `messages` table with indexes on conversationId and timestamp
+     * - Foreign key constraints for referential integrity
+     *
+     * **Must be called before any other operations.**
+     *
+     * @returns {Promise<void>}
+     * @throws {Error} If database connection or schema creation fails
+     *
+     * @example
+     * ```typescript
+     * await storage.initialize();
+     * console.log('Storage ready!');
+     * ```
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        // Resolve the appropriate storage adapter for the platform
+        this.adapter = await resolveStorageAdapter(this.config);
+        // Create conversations table
+        await this.adapter.exec(`
+      CREATE TABLE IF NOT EXISTS conversations (
+        id TEXT PRIMARY KEY,
+        userId TEXT NOT NULL,
+        agentId TEXT,
+        createdAt INTEGER NOT NULL,
+        lastActivity INTEGER NOT NULL,
+        title TEXT,
+        metadata TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_conversations_userId ON conversations(userId);
+      CREATE INDEX IF NOT EXISTS idx_conversations_agentId ON conversations(agentId);
+      CREATE INDEX IF NOT EXISTS idx_conversations_lastActivity ON conversations(lastActivity);
+    `);
+        // Create messages table with foreign key
+        await this.adapter.exec(`
+      CREATE TABLE IF NOT EXISTS messages (
+        id TEXT PRIMARY KEY,
+        conversationId TEXT NOT NULL,
+        role TEXT NOT NULL CHECK(role IN ('user', 'assistant', 'system', 'tool')),
+        content TEXT NOT NULL,
+        timestamp INTEGER NOT NULL,
+        model TEXT,
+        promptTokens INTEGER,
+        completionTokens INTEGER,
+        totalTokens INTEGER,
+        toolCalls TEXT,
+        toolCallId TEXT,
+        name TEXT,
+        metadata TEXT,
+        FOREIGN KEY (conversationId) REFERENCES conversations(id) ON DELETE CASCADE
+      );
+      CREATE INDEX IF NOT EXISTS idx_messages_conversationId ON messages(conversationId);
+      CREATE INDEX IF NOT EXISTS idx_messages_timestamp ON messages(timestamp);
+      CREATE INDEX IF NOT EXISTS idx_messages_role ON messages(role);
+    `);
+        this.initialized = true;
+    }
+    /**
+     * Closes the database connection and releases resources.
+     *
+     * @returns {Promise<void>}
+     *
+     * @example
+     * ```typescript
+     * await storage.close();
+     * ```
+     */
+    async close() {
+        await this.adapter.close();
+        this.initialized = false;
+    }
+    // ==================== Conversation Operations ====================
+    /**
+     * Creates a new conversation record.
+     *
+     * @param {IConversation} conversation - Conversation to create
+     * @returns {Promise<IConversation>} The created conversation
+     * @throws {Error} If conversation with same ID exists or validation fails
+     */
+    async createConversation(conversation) {
+        this.ensureInitialized();
+        const metadataJson = conversation.metadata ? JSON.stringify(conversation.metadata) : null;
+        await this.adapter.run(`INSERT INTO conversations (id, userId, agentId, createdAt, lastActivity, title, metadata)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`, [
+            conversation.id,
+            conversation.userId,
+            conversation.agentId || null,
+            conversation.createdAt,
+            conversation.lastActivity,
+            conversation.title || null,
+            metadataJson,
+        ]);
+        return conversation;
+    }
+    /**
+     * Retrieves a conversation by ID.
+     *
+     * @param {string} conversationId - The conversation ID
+     * @returns {Promise<IConversation | null>} The conversation or null if not found
+     */
+    async getConversation(conversationId) {
+        this.ensureInitialized();
+        const row = await this.adapter.get('SELECT * FROM conversations WHERE id = ?', [conversationId]);
+        if (!row) {
+            return null;
+        }
+        return this.rowToConversation(row);
+    }
+    /**
+     * Updates a conversation's fields.
+     *
+     * @param {string} conversationId - Conversation to update
+     * @param {Partial<IConversation>} updates - Fields to update
+     * @returns {Promise<IConversation>} Updated conversation
+     * @throws {Error} If conversation doesn't exist
+     */
+    async updateConversation(conversationId, updates) {
+        this.ensureInitialized();
+        const existing = await this.getConversation(conversationId);
+        if (!existing) {
+            throw new Error(`Conversation not found: ${conversationId}`);
+        }
+        const updated = { ...existing, ...updates };
+        const metadataJson = updated.metadata ? JSON.stringify(updated.metadata) : null;
+        await this.adapter.run(`UPDATE conversations 
+       SET userId = ?, agentId = ?, createdAt = ?, lastActivity = ?, title = ?, metadata = ?
+       WHERE id = ?`, [
+            updated.userId,
+            updated.agentId || null,
+            updated.createdAt,
+            updated.lastActivity,
+            updated.title || null,
+            metadataJson,
+            conversationId,
+        ]);
+        return updated;
+    }
+    /**
+     * Deletes a conversation and all its messages.
+     *
+     * @param {string} conversationId - Conversation to delete
+     * @returns {Promise<boolean>} True if deleted, false if not found
+     */
+    async deleteConversation(conversationId) {
+        this.ensureInitialized();
+        const result = await this.adapter.run('DELETE FROM conversations WHERE id = ?', [conversationId]);
+        return result.changes > 0;
+    }
+    /**
+     * Lists conversations for a user with optional filtering.
+     *
+     * @param {string} userId - User whose conversations to list
+     * @param {Object} [options] - Query options
+     * @returns {Promise<IConversation[]>} Array of conversations
+     */
+    async listConversations(userId, options) {
+        this.ensureInitialized();
+        let query = 'SELECT * FROM conversations WHERE userId = ?';
+        const params = [userId];
+        if (options?.agentId) {
+            query += ' AND agentId = ?';
+            params.push(options.agentId);
+        }
+        query += ' ORDER BY lastActivity DESC';
+        if (options?.limit) {
+            query += ' LIMIT ?';
+            params.push(options.limit);
+        }
+        if (options?.offset) {
+            query += ' OFFSET ?';
+            params.push(options.offset);
+        }
+        const rows = await this.adapter.all(query, params);
+        return rows.map((row) => this.rowToConversation(row));
+    }
+    // ==================== Message Operations ====================
+    /**
+     * Stores a message and updates conversation's lastActivity.
+     *
+     * @param {IConversationMessage} message - Message to store
+     * @returns {Promise<IConversationMessage>} The stored message
+     * @throws {Error} If conversation doesn't exist
+     */
+    async storeMessage(message) {
+        this.ensureInitialized();
+        // Verify conversation exists
+        const conversation = await this.getConversation(message.conversationId);
+        if (!conversation) {
+            throw new Error(`Conversation not found: ${message.conversationId}`);
+        }
+        const toolCallsJson = message.toolCalls ? JSON.stringify(message.toolCalls) : null;
+        const metadataJson = message.metadata ? JSON.stringify(message.metadata) : null;
+        // Insert message
+        await this.adapter.run(`INSERT INTO messages 
+       (id, conversationId, role, content, timestamp, model, promptTokens, completionTokens, totalTokens, toolCalls, toolCallId, name, metadata)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            message.id,
+            message.conversationId,
+            message.role,
+            message.content,
+            message.timestamp,
+            message.model || null,
+            message.usage?.promptTokens || null,
+            message.usage?.completionTokens || null,
+            message.usage?.totalTokens || null,
+            toolCallsJson,
+            message.toolCallId || null,
+            message.name || null,
+            metadataJson,
+        ]);
+        // Update conversation lastActivity
+        await this.adapter.run('UPDATE conversations SET lastActivity = ? WHERE id = ?', [message.timestamp, message.conversationId]);
+        return message;
+    }
+    /**
+     * Retrieves a message by ID.
+     *
+     * @param {string} messageId - Message ID
+     * @returns {Promise<IConversationMessage | null>} The message or null
+     */
+    async getMessage(messageId) {
+        this.ensureInitialized();
+        const row = await this.adapter.get('SELECT * FROM messages WHERE id = ?', [messageId]);
+        if (!row) {
+            return null;
+        }
+        return this.rowToMessage(row);
+    }
+    /**
+     * Retrieves messages for a conversation with filtering.
+     *
+     * @param {string} conversationId - Conversation ID
+     * @param {IMessageQueryOptions} [options] - Query options
+     * @returns {Promise<IConversationMessage[]>} Array of messages
+     */
+    async getMessages(conversationId, options) {
+        this.ensureInitialized();
+        let query = 'SELECT * FROM messages WHERE conversationId = ?';
+        const params = [conversationId];
+        if (options?.since) {
+            query += ' AND timestamp >= ?';
+            params.push(options.since);
+        }
+        if (options?.until) {
+            query += ' AND timestamp <= ?';
+            params.push(options.until);
+        }
+        if (options?.roles && options.roles.length > 0) {
+            const placeholders = options.roles.map(() => '?').join(',');
+            query += ` AND role IN (${placeholders})`;
+            params.push(...options.roles);
+        }
+        const order = options?.order === 'desc' ? 'DESC' : 'ASC';
+        query += ` ORDER BY timestamp ${order}`;
+        if (options?.limit) {
+            query += ' LIMIT ?';
+            params.push(options.limit);
+        }
+        if (options?.offset) {
+            query += ' OFFSET ?';
+            params.push(options.offset);
+        }
+        const rows = await this.adapter.all(query, params);
+        return rows.map((row) => this.rowToMessage(row));
+    }
+    /**
+     * Deletes a specific message.
+     *
+     * @param {string} messageId - Message to delete
+     * @returns {Promise<boolean>} True if deleted
+     */
+    async deleteMessage(messageId) {
+        this.ensureInitialized();
+        const result = await this.adapter.run('DELETE FROM messages WHERE id = ?', [messageId]);
+        return result.changes > 0;
+    }
+    /**
+     * Deletes all messages in a conversation.
+     *
+     * @param {string} conversationId - Conversation whose messages to delete
+     * @returns {Promise<number>} Number of messages deleted
+     */
+    async deleteMessagesForConversation(conversationId) {
+        this.ensureInitialized();
+        const result = await this.adapter.run('DELETE FROM messages WHERE conversationId = ?', [
+            conversationId,
+        ]);
+        return result.changes;
+    }
+    // ==================== Analytics & Utilities ====================
+    /**
+     * Counts messages in a conversation.
+     *
+     * @param {string} conversationId - Conversation to count
+     * @returns {Promise<number>} Message count
+     */
+    async getMessageCount(conversationId) {
+        this.ensureInitialized();
+        const row = await this.adapter.get('SELECT COUNT(*) as count FROM messages WHERE conversationId = ?', [conversationId]);
+        return row?.count || 0;
+    }
+    /**
+     * Calculates total token usage for a conversation.
+     *
+     * @param {string} conversationId - Conversation to analyze
+     * @returns {Promise<ITokenUsage>} Aggregated token usage
+     */
+    async getConversationTokenUsage(conversationId) {
+        this.ensureInitialized();
+        const row = await this.adapter.get(`SELECT 
+        SUM(promptTokens) as promptTokens,
+        SUM(completionTokens) as completionTokens,
+        SUM(totalTokens) as totalTokens
+       FROM messages 
+       WHERE conversationId = ?`, [conversationId]);
+        return {
+            promptTokens: row?.promptTokens || 0,
+            completionTokens: row?.completionTokens || 0,
+            totalTokens: row?.totalTokens || 0,
+        };
+    }
+    // ==================== Private Helper Methods ====================
+    /**
+     * Ensures the adapter has been initialized.
+     *
+     * @private
+     * @throws {Error} If not initialized
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('SqlStorageAdapter not initialized. Call initialize() first.');
+        }
+    }
+    /**
+     * Converts a database row to an IConversation object.
+     *
+     * @private
+     * @param {any} row - Database row
+     * @returns {IConversation} Conversation object
+     */
+    rowToConversation(row) {
+        return {
+            id: row.id,
+            userId: row.userId,
+            agentId: row.agentId || undefined,
+            createdAt: row.createdAt,
+            lastActivity: row.lastActivity,
+            title: row.title || undefined,
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+        };
+    }
+    /**
+     * Converts a database row to an IConversationMessage object.
+     *
+     * @private
+     * @param {any} row - Database row
+     * @returns {IConversationMessage} Message object
+     */
+    rowToMessage(row) {
+        const message = {
+            id: row.id,
+            conversationId: row.conversationId,
+            role: row.role,
+            content: row.content,
+            timestamp: row.timestamp,
+        };
+        if (row.model)
+            message.model = row.model;
+        if (row.promptTokens || row.completionTokens || row.totalTokens) {
+            message.usage = {
+                promptTokens: row.promptTokens || 0,
+                completionTokens: row.completionTokens || 0,
+                totalTokens: row.totalTokens || 0,
+            };
+        }
+        if (row.toolCalls)
+            message.toolCalls = JSON.parse(row.toolCalls);
+        if (row.toolCallId)
+            message.toolCallId = row.toolCallId;
+        if (row.name)
+            message.name = row.name;
+        if (row.metadata)
+            message.metadata = JSON.parse(row.metadata);
+        return message;
+    }
+}
+//# sourceMappingURL=SqlStorageAdapter.js.map

package/dist/core/storage/SqlStorageAdapter.js.map

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

package/dist/core/storage/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @file index.ts
+ * @description Barrel export for AgentOS storage module.
+ *
+ * Provides centralized access to all storage-related interfaces and implementations.
+ *
+ * @version 1.0.0
+ * @author AgentOS Team
+ * @license MIT
+ */
+export * from './IStorageAdapter.js';
+export { SqlStorageAdapter, type AgentOsSqlStorageConfig } from './SqlStorageAdapter.js';
+export { InMemoryStorageAdapter } from './InMemoryStorageAdapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/core/storage/index.js

@@ -0,0 +1,14 @@
+/**
+ * @file index.ts
+ * @description Barrel export for AgentOS storage module.
+ *
+ * Provides centralized access to all storage-related interfaces and implementations.
+ *
+ * @version 1.0.0
+ * @author AgentOS Team
+ * @license MIT
+ */
+export * from './IStorageAdapter.js';
+export { SqlStorageAdapter } from './SqlStorageAdapter.js';
+export { InMemoryStorageAdapter } from './InMemoryStorageAdapter.js';
+//# sourceMappingURL=index.js.map

package/dist/core/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAgC,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/core/streaming/IStreamClient.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @fileoverview Defines the IStreamClient interface.
+ * This interface represents the contract for any client that wishes to subscribe to
+ * and receive data chunks from a stream managed by the StreamingManager.
+ * Implementations of this interface will handle the actual transport of data
+ * to the connected client (e.g., via WebSockets, SSE, etc.).
+ *
+ * @module backend/core/streaming/IStreamClient
+ */
+import { AgentOSResponse } from '../../api/types/AgentOSResponse';
+/**
+ * Represents a unique identifier for a stream client.
+ * This could be a WebSocket connection ID, a unique user session sub-ID, etc.
+ * @typedef {string} StreamClientId
+ */
+export type StreamClientId = string;
+/**
+ * @interface IStreamClient
+ * @description Defines the essential methods that a stream client implementation
+ * must provide to interact with the StreamingManager.
+ */
+export interface IStreamClient {
+    /**
+     * A unique identifier for this specific client instance.
+     * @readonly
+     * @type {StreamClientId}
+     */
+    readonly id: StreamClientId;
+    /**
+     * Sends a data chunk to the connected client.
+     * This method should handle the specifics of the underlying transport protocol.
+     *
+     * @public
+     * @async
+     * @param {AgentOSResponse} chunk - The data chunk to send to the client.
+     * @returns {Promise<void>} A promise that resolves when the chunk has been successfully
+     * sent (or queued for sending), or rejects if an error occurs during sending.
+     * @throws {Error} If sending the chunk fails due to a transport-level issue
+     * (e.g., connection closed, buffer full).
+     */
+    sendChunk(chunk: AgentOSResponse): Promise<void>;
+    /**
+     * Notifies the client that the stream has been closed.
+     * This could be due to normal completion, an error, or explicit closure by the system.
+     *
+     * @public
+     * @async
+     * @param {string} [reason] - An optional reason for the stream closure.
+     * This might be a human-readable message or an error code.
+     * @returns {Promise<void>} A promise that resolves when the closure notification
+     * has been sent, or rejects if an error occurs.
+     */
+    notifyStreamClosed(reason?: string): Promise<void>;
+    /**
+     * Checks if the client connection is currently active and able to receive data.
+     *
+     * @public
+     * @returns {boolean} True if the client is active, false otherwise.
+     */
+    isActive(): boolean;
+    /**
+     * Optional method to gracefully close the client's connection or clean up resources
+     * from the client's perspective, possibly initiated by the StreamingManager.
+     *
+     * @public
+     * @async
+     * @param {string} [reason] - An optional reason for closing the client.
+     * @returns {Promise<void>} A promise that resolves when the client has been closed.
+     */
+    close?(reason?: string): Promise<void>;
+}
+//# sourceMappingURL=IStreamClient.d.ts.map

package/dist/core/streaming/IStreamClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IStreamClient.d.ts","sourceRoot":"","sources":["../../../src/core/streaming/IStreamClient.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAE5B;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,QAAQ,IAAI,OAAO,CAAC;IAEpB;;;;;;;;OAQG;IACH,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC"}

package/dist/core/streaming/IStreamClient.js

@@ -0,0 +1,12 @@
+// File: src/core/streaming/IStreamClient.ts
+/**
+ * @fileoverview Defines the IStreamClient interface.
+ * This interface represents the contract for any client that wishes to subscribe to
+ * and receive data chunks from a stream managed by the StreamingManager.
+ * Implementations of this interface will handle the actual transport of data
+ * to the connected client (e.g., via WebSockets, SSE, etc.).
+ *
+ * @module backend/core/streaming/IStreamClient
+ */
+export {};
+//# sourceMappingURL=IStreamClient.js.map

package/dist/core/streaming/IStreamClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IStreamClient.js","sourceRoot":"","sources":["../../../src/core/streaming/IStreamClient.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C;;;;;;;;GAQG"}