@o-zakstam/voltagent-convex 1.1.2 → 1.1.4

package/dist/index.js

@@ -1,435 +1,11 @@
-import { ConversationAlreadyExistsError, ConversationNotFoundError } from '@voltagent/core';
-
-// src/memory-adapter.ts
-var defaultLogger = {
-  debug: (message, ...args) => console.debug(`[ConvexMemory] ${message}`, ...args),
-  info: (message, ...args) => console.info(`[ConvexMemory] ${message}`, ...args),
-  warn: (message, ...args) => console.warn(`[ConvexMemory] ${message}`, ...args),
-  error: (message, ...args) => console.error(`[ConvexMemory] ${message}`, ...args)
-};
-var ConvexMemoryAdapter = class {
-  client;
-  api;
-  debug;
-  logger;
-  constructor(options) {
-    if (!options.client) {
-      throw new Error("Convex client is required");
-    }
-    if (!options.api) {
-      throw new Error("Convex API is required");
-    }
-    this.client = options.client;
-    this.api = options.api;
-    this.debug = options.debug ?? false;
-    this.logger = options.logger ?? defaultLogger;
-    this.log("Convex Memory adapter initialized");
-  }
-  /**
-   * Log debug messages
-   */
-  log(message, ...args) {
-    if (this.debug) {
-      this.logger.debug(message, ...args);
-    }
-  }
-  /**
-   * Generate a cryptographically secure random ID
-   */
-  generateId() {
-    return crypto.randomUUID();
-  }
-  // ============================================================================
-  // Message Operations
-  // ============================================================================
-  /**
-   * Add a single message to a conversation
-   */
-  async addMessage(message, userId, conversationId, _context) {
-    await this.client.mutation(this.api.addMessage, {
-      id: message.id || this.generateId(),
-      conversationId,
-      userId,
-      role: message.role,
-      parts: message.parts,
-      metadata: message.metadata || null
-    });
-    this.log(`Added message to conversation ${conversationId}`);
-  }
-  /**
-   * Add multiple messages to a conversation
-   */
-  async addMessages(messages, userId, conversationId, _context) {
-    const messagesToAdd = messages.map((message) => ({
-      id: message.id || this.generateId(),
-      conversationId,
-      userId,
-      role: message.role,
-      parts: message.parts,
-      metadata: message.metadata || null
-    }));
-    await this.client.mutation(this.api.addMessages, {
-      messages: messagesToAdd
-    });
-    this.log(
-      `Added ${messages.length} messages to conversation ${conversationId}`
-    );
-  }
-  /**
-   * Get messages from a conversation with optional filtering
-   */
-  async getMessages(userId, conversationId, options, _context) {
-    const { limit, before, after, roles } = options || {};
-    const messages = await this.client.query(this.api.getMessages, {
-      userId,
-      conversationId,
-      limit,
-      before: before?.toISOString(),
-      after: after?.toISOString(),
-      roles
-    });
-    return messages.map((msg) => ({
-      id: msg.id,
-      role: msg.role,
-      parts: msg.parts,
-      metadata: {
-        ...msg.metadata,
-        createdAt: msg.metadata?.createdAt ? new Date(msg.metadata.createdAt) : /* @__PURE__ */ new Date()
-      }
-    }));
-  }
-  /**
-   * Clear messages for a user (optionally for a specific conversation)
-   */
-  async clearMessages(userId, conversationId, _context) {
-    await this.client.mutation(this.api.clearMessages, {
-      userId,
-      conversationId
-    });
-    this.log(`Cleared messages for user ${userId}`);
-  }
-  // ============================================================================
-  // Conversation Steps Operations
-  // ============================================================================
-  /**
-   * Save conversation steps for observability
-   */
-  async saveConversationSteps(steps) {
-    if (steps.length === 0) {
-      return;
-    }
-    await this.client.mutation(this.api.saveConversationSteps, {
-      steps: steps.map((step) => ({
-        id: step.id,
-        conversationId: step.conversationId,
-        userId: step.userId,
-        agentId: step.agentId,
-        agentName: step.agentName,
-        operationId: step.operationId,
-        stepIndex: step.stepIndex,
-        type: step.type,
-        role: step.role,
-        content: step.content,
-        arguments: step.arguments,
-        result: step.result,
-        usage: step.usage,
-        subAgentId: step.subAgentId,
-        subAgentName: step.subAgentName,
-        createdAt: step.createdAt
-      }))
-    });
-    this.log(`Saved ${steps.length} conversation steps`);
-  }
-  /**
-   * Get conversation steps for observability
-   */
-  async getConversationSteps(userId, conversationId, options) {
-    const steps = await this.client.query(this.api.getConversationSteps, {
-      userId,
-      conversationId,
-      limit: options?.limit,
-      operationId: options?.operationId
-    });
-    return steps;
-  }
-  // ============================================================================
-  // Conversation Operations
-  // ============================================================================
-  /**
-   * Create a new conversation
-   */
-  async createConversation(input) {
-    try {
-      const result = await this.client.mutation(this.api.createConversation, {
-        id: input.id,
-        resourceId: input.resourceId,
-        userId: input.userId,
-        title: input.title,
-        metadata: input.metadata || {}
-      });
-      this.log(`Created conversation ${input.id}`);
-      return result;
-    } catch (error) {
-      if (error instanceof Error && error.message.includes("already exists")) {
-        throw new ConversationAlreadyExistsError(input.id);
-      }
-      throw error;
-    }
-  }
-  /**
-   * Get a conversation by ID
-   */
-  async getConversation(id) {
-    const conversation = await this.client.query(this.api.getConversation, {
-      id
-    });
-    return conversation;
-  }
-  /**
-   * Get conversations by resource ID
-   */
-  async getConversations(resourceId) {
-    const conversations = await this.client.query(this.api.getConversations, {
-      resourceId
-    });
-    return conversations;
-  }
-  /**
-   * Get conversations by user ID with optional query options
-   */
-  async getConversationsByUserId(userId, options) {
-    const conversations = await this.client.query(
-      this.api.getConversationsByUserId,
-      {
-        userId,
-        limit: options?.limit,
-        offset: options?.offset,
-        orderBy: options?.orderBy,
-        orderDirection: options?.orderDirection
-      }
-    );
-    return conversations;
-  }
-  /**
-   * Query conversations with filters
-   */
-  async queryConversations(options) {
-    const conversations = await this.client.query(this.api.queryConversations, {
-      userId: options.userId,
-      resourceId: options.resourceId,
-      limit: options.limit,
-      offset: options.offset,
-      orderBy: options.orderBy,
-      orderDirection: options.orderDirection
-    });
-    return conversations;
-  }
-  /**
-   * Update a conversation
-   */
-  async updateConversation(id, updates) {
-    try {
-      const result = await this.client.mutation(this.api.updateConversation, {
-        id,
-        title: updates.title,
-        resourceId: updates.resourceId,
-        metadata: updates.metadata
-      });
-      this.log(`Updated conversation ${id}`);
-      return result;
-    } catch (error) {
-      if (error instanceof Error && error.message.includes("not found")) {
-        throw new ConversationNotFoundError(id);
-      }
-      throw error;
-    }
-  }
-  /**
-   * Delete a conversation and its associated data
-   */
-  async deleteConversation(id) {
-    try {
-      await this.client.mutation(this.api.deleteConversation, { id });
-      this.log(`Deleted conversation ${id}`);
-    } catch (error) {
-      if (error instanceof Error && error.message.includes("not found")) {
-        throw new ConversationNotFoundError(id);
-      }
-      throw error;
-    }
-  }
-  // ============================================================================
-  // Working Memory Operations
-  // ============================================================================
-  /**
-   * Get working memory content
-   */
-  async getWorkingMemory(params) {
-    const result = await this.client.query(this.api.getWorkingMemory, {
-      conversationId: params.conversationId,
-      userId: params.userId,
-      scope: params.scope
-    });
-    return result;
-  }
-  /**
-   * Set working memory content
-   */
-  async setWorkingMemory(params) {
-    try {
-      await this.client.mutation(this.api.setWorkingMemory, {
-        conversationId: params.conversationId,
-        userId: params.userId,
-        content: params.content,
-        scope: params.scope
-      });
-      this.log(`Set working memory for ${params.scope}`);
-    } catch (error) {
-      if (error instanceof Error && error.message.includes("not found") && params.conversationId) {
-        throw new ConversationNotFoundError(params.conversationId);
-      }
-      throw error;
-    }
-  }
-  /**
-   * Delete working memory content
-   */
-  async deleteWorkingMemory(params) {
-    await this.client.mutation(this.api.deleteWorkingMemory, {
-      conversationId: params.conversationId,
-      userId: params.userId,
-      scope: params.scope
-    });
-    this.log(`Deleted working memory for ${params.scope}`);
-  }
-  // ============================================================================
-  // Workflow State Operations
-  // ============================================================================
-  /**
-   * Get workflow state by execution ID
-   */
-  async getWorkflowState(executionId) {
-    const state = await this.client.query(this.api.getWorkflowState, {
-      executionId
-    });
-    if (!state) return null;
-    const typedState = state;
-    return {
-      id: typedState.id,
-      workflowId: typedState.workflowId,
-      workflowName: typedState.workflowName,
-      status: typedState.status,
-      input: typedState.input,
-      context: typedState.context,
-      suspension: typedState.suspension,
-      events: typedState.events,
-      output: typedState.output,
-      cancellation: typedState.cancellation,
-      userId: typedState.userId,
-      conversationId: typedState.conversationId,
-      metadata: typedState.metadata,
-      createdAt: new Date(typedState.createdAt),
-      updatedAt: new Date(typedState.updatedAt)
-    };
-  }
-  /**
-   * Query workflow runs with optional filters
-   */
-  async queryWorkflowRuns(query) {
-    const states = await this.client.query(this.api.queryWorkflowRuns, {
-      workflowId: query.workflowId,
-      status: query.status,
-      from: query.from?.toISOString(),
-      to: query.to?.toISOString(),
-      limit: query.limit,
-      offset: query.offset
-    });
-    return states.map((s) => ({
-      id: s.id,
-      workflowId: s.workflowId,
-      workflowName: s.workflowName,
-      status: s.status,
-      input: s.input,
-      context: s.context,
-      suspension: s.suspension,
-      events: s.events,
-      output: s.output,
-      cancellation: s.cancellation,
-      userId: s.userId,
-      conversationId: s.conversationId,
-      metadata: s.metadata,
-      createdAt: new Date(s.createdAt),
-      updatedAt: new Date(s.updatedAt)
-    }));
-  }
-  /**
-   * Set workflow state
-   */
-  async setWorkflowState(executionId, state) {
-    await this.client.mutation(this.api.setWorkflowState, {
-      executionId,
-      workflowId: state.workflowId,
-      workflowName: state.workflowName,
-      status: state.status,
-      input: state.input,
-      context: state.context,
-      suspension: state.suspension,
-      events: state.events,
-      output: state.output,
-      cancellation: state.cancellation,
-      userId: state.userId,
-      conversationId: state.conversationId,
-      metadata: state.metadata,
-      createdAt: state.createdAt.toISOString(),
-      updatedAt: state.updatedAt.toISOString()
-    });
-    this.log(`Set workflow state ${executionId}`);
-  }
-  /**
-   * Update workflow state
-   */
-  async updateWorkflowState(executionId, updates) {
-    await this.client.mutation(this.api.updateWorkflowState, {
-      executionId,
-      status: updates.status,
-      suspension: updates.suspension,
-      events: updates.events,
-      output: updates.output,
-      cancellation: updates.cancellation,
-      metadata: updates.metadata
-    });
-    this.log(`Updated workflow state ${executionId}`);
-  }
-  /**
-   * Get suspended workflow states for a workflow
-   */
-  async getSuspendedWorkflowStates(workflowId) {
-    const states = await this.client.query(
-      this.api.getSuspendedWorkflowStates,
-      {
-        workflowId
-      }
-    );
-    return states.map((s) => ({
-      id: s.id,
-      workflowId: s.workflowId,
-      workflowName: s.workflowName,
-      status: s.status,
-      input: s.input,
-      context: s.context,
-      suspension: s.suspension,
-      events: s.events,
-      output: s.output,
-      cancellation: s.cancellation,
-      userId: s.userId,
-      conversationId: s.conversationId,
-      metadata: s.metadata,
-      createdAt: new Date(s.createdAt),
-      updatedAt: new Date(s.updatedAt)
-    }));
-  }
-};
-
-export { ConvexMemoryAdapter };
-//# sourceMappingURL=index.js.map
+/**
+ * VoltAgent Convex Storage Adapter
+ *
+ * A StorageAdapter implementation for VoltAgent that persists
+ * conversation data to Convex database using a Convex component.
+ *
+ * @packageDocumentation
+ */
+// Main adapter class
+export { ConvexMemoryAdapter } from "./memory-adapter";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/memory-adapter.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Convex Memory Adapter for VoltAgent\n *\n * A StorageAdapter implementation that persists conversation data\n * to Convex database using the VoltAgent Convex component.\n */\n\nimport {\n  ConversationAlreadyExistsError,\n  ConversationNotFoundError,\n} from \"@voltagent/core\";\nimport type {\n  Conversation,\n  ConversationQueryOptions,\n  ConversationStepRecord,\n  CreateConversationInput,\n  GetConversationStepsOptions,\n  GetMessagesOptions,\n  OperationContext,\n  StorageAdapter,\n  WorkflowStateEntry,\n  WorkingMemoryScope,\n} from \"@voltagent/core\";\nimport type { UIMessage } from \"ai\";\nimport type {\n  ConvexClient,\n  ConvexMemoryAdapterOptions,\n  Logger,\n  VoltAgentApi,\n} from \"./types\";\n\n/**\n * Default console logger implementation\n */\nconst defaultLogger: Logger = {\n  debug: (message: string, ...args: unknown[]) =>\n    console.debug(`[ConvexMemory] ${message}`, ...args),\n  info: (message: string, ...args: unknown[]) =>\n    console.info(`[ConvexMemory] ${message}`, ...args),\n  warn: (message: string, ...args: unknown[]) =>\n    console.warn(`[ConvexMemory] ${message}`, ...args),\n  error: (message: string, ...args: unknown[]) =>\n    console.error(`[ConvexMemory] ${message}`, ...args),\n};\n\n/**\n * Convex Memory Adapter for VoltAgent\n *\n * Implements the StorageAdapter interface to persist conversation history,\n * working memory, and workflow state to a Convex database.\n *\n * @example\n * ```ts\n * import { ConvexHttpClient } from \"convex/browser\";\n * import { api } from \"./convex/_generated/api\";\n * import { ConvexMemoryAdapter } from \"@voltagent/convex\";\n *\n * const client = new ConvexHttpClient(process.env.CONVEX_URL);\n *\n * const adapter = new ConvexMemoryAdapter({\n *   client,\n *   api: api.voltagent,\n * });\n *\n * const memory = new Memory({ storage: adapter });\n * ```\n */\nexport class ConvexMemoryAdapter implements StorageAdapter {\n  private client: ConvexClient;\n  private api: VoltAgentApi;\n  private debug: boolean;\n  private logger: Logger;\n\n  constructor(options: ConvexMemoryAdapterOptions) {\n    if (!options.client) {\n      throw new Error(\"Convex client is required\");\n    }\n    if (!options.api) {\n      throw new Error(\"Convex API is required\");\n    }\n\n    this.client = options.client;\n    this.api = options.api;\n    this.debug = options.debug ?? false;\n    this.logger = options.logger ?? defaultLogger;\n\n    this.log(\"Convex Memory adapter initialized\");\n  }\n\n  /**\n   * Log debug messages\n   */\n  private log(message: string, ...args: unknown[]): void {\n    if (this.debug) {\n      this.logger.debug(message, ...args);\n    }\n  }\n\n  /**\n   * Generate a cryptographically secure random ID\n   */\n  private generateId(): string {\n    return crypto.randomUUID();\n  }\n\n  // ============================================================================\n  // Message Operations\n  // ============================================================================\n\n  /**\n   * Add a single message to a conversation\n   */\n  async addMessage(\n    message: UIMessage,\n    userId: string,\n    conversationId: string,\n    _context?: OperationContext,\n  ): Promise<void> {\n    await this.client.mutation(this.api.addMessage, {\n      id: message.id || this.generateId(),\n      conversationId,\n      userId,\n      role: message.role,\n      parts: message.parts,\n      metadata: message.metadata || null,\n    });\n\n    this.log(`Added message to conversation ${conversationId}`);\n  }\n\n  /**\n   * Add multiple messages to a conversation\n   */\n  async addMessages(\n    messages: UIMessage[],\n    userId: string,\n    conversationId: string,\n    _context?: OperationContext,\n  ): Promise<void> {\n    const messagesToAdd = messages.map((message) => ({\n      id: message.id || this.generateId(),\n      conversationId,\n      userId,\n      role: message.role,\n      parts: message.parts,\n      metadata: message.metadata || null,\n    }));\n\n    await this.client.mutation(this.api.addMessages, {\n      messages: messagesToAdd,\n    });\n\n    this.log(\n      `Added ${messages.length} messages to conversation ${conversationId}`,\n    );\n  }\n\n  /**\n   * Get messages from a conversation with optional filtering\n   */\n  async getMessages(\n    userId: string,\n    conversationId: string,\n    options?: GetMessagesOptions,\n    _context?: OperationContext,\n  ): Promise<UIMessage<{ createdAt: Date }>[]> {\n    const { limit, before, after, roles } = options || {};\n\n    const messages = await this.client.query(this.api.getMessages, {\n      userId,\n      conversationId,\n      limit,\n      before: before?.toISOString(),\n      after: after?.toISOString(),\n      roles,\n    });\n\n    return (\n      messages as Array<{\n        id: string;\n        role: string;\n        parts: unknown[];\n        metadata?: Record<string, unknown> & { createdAt?: string };\n      }>\n    ).map((msg) => ({\n      id: msg.id,\n      role: msg.role as \"system\" | \"user\" | \"assistant\",\n      parts: msg.parts as UIMessage[\"parts\"],\n      metadata: {\n        ...msg.metadata,\n        createdAt: msg.metadata?.createdAt\n          ? new Date(msg.metadata.createdAt as string)\n          : new Date(),\n      },\n    }));\n  }\n\n  /**\n   * Clear messages for a user (optionally for a specific conversation)\n   */\n  async clearMessages(\n    userId: string,\n    conversationId?: string,\n    _context?: OperationContext,\n  ): Promise<void> {\n    await this.client.mutation(this.api.clearMessages, {\n      userId,\n      conversationId,\n    });\n\n    this.log(`Cleared messages for user ${userId}`);\n  }\n\n  // ============================================================================\n  // Conversation Steps Operations\n  // ============================================================================\n\n  /**\n   * Save conversation steps for observability\n   */\n  async saveConversationSteps(steps: ConversationStepRecord[]): Promise<void> {\n    if (steps.length === 0) {\n      return;\n    }\n\n    await this.client.mutation(this.api.saveConversationSteps, {\n      steps: steps.map((step) => ({\n        id: step.id,\n        conversationId: step.conversationId,\n        userId: step.userId,\n        agentId: step.agentId,\n        agentName: step.agentName,\n        operationId: step.operationId,\n        stepIndex: step.stepIndex,\n        type: step.type,\n        role: step.role,\n        content: step.content,\n        arguments: step.arguments,\n        result: step.result,\n        usage: step.usage,\n        subAgentId: step.subAgentId,\n        subAgentName: step.subAgentName,\n        createdAt: step.createdAt,\n      })),\n    });\n\n    this.log(`Saved ${steps.length} conversation steps`);\n  }\n\n  /**\n   * Get conversation steps for observability\n   */\n  async getConversationSteps(\n    userId: string,\n    conversationId: string,\n    options?: GetConversationStepsOptions,\n  ): Promise<ConversationStepRecord[]> {\n    const steps = await this.client.query(this.api.getConversationSteps, {\n      userId,\n      conversationId,\n      limit: options?.limit,\n      operationId: options?.operationId,\n    });\n\n    return steps as ConversationStepRecord[];\n  }\n\n  // ============================================================================\n  // Conversation Operations\n  // ============================================================================\n\n  /**\n   * Create a new conversation\n   */\n  async createConversation(\n    input: CreateConversationInput,\n  ): Promise<Conversation> {\n    try {\n      const result = await this.client.mutation(this.api.createConversation, {\n        id: input.id,\n        resourceId: input.resourceId,\n        userId: input.userId,\n        title: input.title,\n        metadata: input.metadata || {},\n      });\n\n      this.log(`Created conversation ${input.id}`);\n\n      return result as Conversation;\n    } catch (error) {\n      if (error instanceof Error && error.message.includes(\"already exists\")) {\n        throw new ConversationAlreadyExistsError(input.id);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Get a conversation by ID\n   */\n  async getConversation(id: string): Promise<Conversation | null> {\n    const conversation = await this.client.query(this.api.getConversation, {\n      id,\n    });\n\n    return conversation as Conversation | null;\n  }\n\n  /**\n   * Get conversations by resource ID\n   */\n  async getConversations(resourceId: string): Promise<Conversation[]> {\n    const conversations = await this.client.query(this.api.getConversations, {\n      resourceId,\n    });\n\n    return conversations as Conversation[];\n  }\n\n  /**\n   * Get conversations by user ID with optional query options\n   */\n  async getConversationsByUserId(\n    userId: string,\n    options?: Omit<ConversationQueryOptions, \"userId\">,\n  ): Promise<Conversation[]> {\n    const conversations = await this.client.query(\n      this.api.getConversationsByUserId,\n      {\n        userId,\n        limit: options?.limit,\n        offset: options?.offset,\n        orderBy: options?.orderBy,\n        orderDirection: options?.orderDirection,\n      },\n    );\n\n    return conversations as Conversation[];\n  }\n\n  /**\n   * Query conversations with filters\n   */\n  async queryConversations(\n    options: ConversationQueryOptions,\n  ): Promise<Conversation[]> {\n    const conversations = await this.client.query(this.api.queryConversations, {\n      userId: options.userId,\n      resourceId: options.resourceId,\n      limit: options.limit,\n      offset: options.offset,\n      orderBy: options.orderBy,\n      orderDirection: options.orderDirection,\n    });\n\n    return conversations as Conversation[];\n  }\n\n  /**\n   * Update a conversation\n   */\n  async updateConversation(\n    id: string,\n    updates: Partial<Omit<Conversation, \"id\" | \"createdAt\" | \"updatedAt\">>,\n  ): Promise<Conversation> {\n    try {\n      const result = await this.client.mutation(this.api.updateConversation, {\n        id,\n        title: updates.title,\n        resourceId: updates.resourceId,\n        metadata: updates.metadata,\n      });\n\n      this.log(`Updated conversation ${id}`);\n\n      return result as Conversation;\n    } catch (error) {\n      if (error instanceof Error && error.message.includes(\"not found\")) {\n        throw new ConversationNotFoundError(id);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Delete a conversation and its associated data\n   */\n  async deleteConversation(id: string): Promise<void> {\n    try {\n      await this.client.mutation(this.api.deleteConversation, { id });\n      this.log(`Deleted conversation ${id}`);\n    } catch (error) {\n      if (error instanceof Error && error.message.includes(\"not found\")) {\n        throw new ConversationNotFoundError(id);\n      }\n      throw error;\n    }\n  }\n\n  // ============================================================================\n  // Working Memory Operations\n  // ============================================================================\n\n  /**\n   * Get working memory content\n   */\n  async getWorkingMemory(params: {\n    conversationId?: string;\n    userId?: string;\n    scope: WorkingMemoryScope;\n  }): Promise<string | null> {\n    const result = await this.client.query(this.api.getWorkingMemory, {\n      conversationId: params.conversationId,\n      userId: params.userId,\n      scope: params.scope,\n    });\n\n    return result as string | null;\n  }\n\n  /**\n   * Set working memory content\n   */\n  async setWorkingMemory(params: {\n    conversationId?: string;\n    userId?: string;\n    content: string;\n    scope: WorkingMemoryScope;\n  }): Promise<void> {\n    try {\n      await this.client.mutation(this.api.setWorkingMemory, {\n        conversationId: params.conversationId,\n        userId: params.userId,\n        content: params.content,\n        scope: params.scope,\n      });\n\n      this.log(`Set working memory for ${params.scope}`);\n    } catch (error) {\n      if (\n        error instanceof Error &&\n        error.message.includes(\"not found\") &&\n        params.conversationId\n      ) {\n        throw new ConversationNotFoundError(params.conversationId);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Delete working memory content\n   */\n  async deleteWorkingMemory(params: {\n    conversationId?: string;\n    userId?: string;\n    scope: WorkingMemoryScope;\n  }): Promise<void> {\n    await this.client.mutation(this.api.deleteWorkingMemory, {\n      conversationId: params.conversationId,\n      userId: params.userId,\n      scope: params.scope,\n    });\n\n    this.log(`Deleted working memory for ${params.scope}`);\n  }\n\n  // ============================================================================\n  // Workflow State Operations\n  // ============================================================================\n\n  /**\n   * Get workflow state by execution ID\n   */\n  async getWorkflowState(\n    executionId: string,\n  ): Promise<WorkflowStateEntry | null> {\n    const state = await this.client.query(this.api.getWorkflowState, {\n      executionId,\n    });\n\n    if (!state) return null;\n\n    const typedState = state as {\n      id: string;\n      workflowId: string;\n      workflowName: string;\n      status: string;\n      input?: unknown;\n      context?: unknown;\n      suspension?: unknown;\n      events?: unknown[];\n      output?: unknown;\n      cancellation?: unknown;\n      userId?: string;\n      conversationId?: string;\n      metadata?: Record<string, unknown>;\n      createdAt: string;\n      updatedAt: string;\n    };\n\n    return {\n      id: typedState.id,\n      workflowId: typedState.workflowId,\n      workflowName: typedState.workflowName,\n      status: typedState.status as WorkflowStateEntry[\"status\"],\n      input: typedState.input,\n      context: typedState.context as WorkflowStateEntry[\"context\"],\n      suspension: typedState.suspension as WorkflowStateEntry[\"suspension\"],\n      events: typedState.events as WorkflowStateEntry[\"events\"],\n      output: typedState.output,\n      cancellation:\n        typedState.cancellation as WorkflowStateEntry[\"cancellation\"],\n      userId: typedState.userId,\n      conversationId: typedState.conversationId,\n      metadata: typedState.metadata,\n      createdAt: new Date(typedState.createdAt),\n      updatedAt: new Date(typedState.updatedAt),\n    };\n  }\n\n  /**\n   * Query workflow runs with optional filters\n   */\n  async queryWorkflowRuns(query: {\n    workflowId?: string;\n    status?: WorkflowStateEntry[\"status\"];\n    from?: Date;\n    to?: Date;\n    limit?: number;\n    offset?: number;\n  }): Promise<WorkflowStateEntry[]> {\n    const states = await this.client.query(this.api.queryWorkflowRuns, {\n      workflowId: query.workflowId,\n      status: query.status,\n      from: query.from?.toISOString(),\n      to: query.to?.toISOString(),\n      limit: query.limit,\n      offset: query.offset,\n    });\n\n    return (\n      states as Array<{\n        id: string;\n        workflowId: string;\n        workflowName: string;\n        status: string;\n        input?: unknown;\n        context?: unknown;\n        suspension?: unknown;\n        events?: unknown[];\n        output?: unknown;\n        cancellation?: unknown;\n        userId?: string;\n        conversationId?: string;\n        metadata?: Record<string, unknown>;\n        createdAt: string;\n        updatedAt: string;\n      }>\n    ).map((s) => ({\n      id: s.id,\n      workflowId: s.workflowId,\n      workflowName: s.workflowName,\n      status: s.status as WorkflowStateEntry[\"status\"],\n      input: s.input,\n      context: s.context as WorkflowStateEntry[\"context\"],\n      suspension: s.suspension as WorkflowStateEntry[\"suspension\"],\n      events: s.events as WorkflowStateEntry[\"events\"],\n      output: s.output,\n      cancellation: s.cancellation as WorkflowStateEntry[\"cancellation\"],\n      userId: s.userId,\n      conversationId: s.conversationId,\n      metadata: s.metadata,\n      createdAt: new Date(s.createdAt),\n      updatedAt: new Date(s.updatedAt),\n    }));\n  }\n\n  /**\n   * Set workflow state\n   */\n  async setWorkflowState(\n    executionId: string,\n    state: WorkflowStateEntry,\n  ): Promise<void> {\n    await this.client.mutation(this.api.setWorkflowState, {\n      executionId,\n      workflowId: state.workflowId,\n      workflowName: state.workflowName,\n      status: state.status,\n      input: state.input,\n      context: state.context,\n      suspension: state.suspension,\n      events: state.events,\n      output: state.output,\n      cancellation: state.cancellation,\n      userId: state.userId,\n      conversationId: state.conversationId,\n      metadata: state.metadata,\n      createdAt: state.createdAt.toISOString(),\n      updatedAt: state.updatedAt.toISOString(),\n    });\n\n    this.log(`Set workflow state ${executionId}`);\n  }\n\n  /**\n   * Update workflow state\n   */\n  async updateWorkflowState(\n    executionId: string,\n    updates: Partial<WorkflowStateEntry>,\n  ): Promise<void> {\n    await this.client.mutation(this.api.updateWorkflowState, {\n      executionId,\n      status: updates.status,\n      suspension: updates.suspension,\n      events: updates.events,\n      output: updates.output,\n      cancellation: updates.cancellation,\n      metadata: updates.metadata,\n    });\n\n    this.log(`Updated workflow state ${executionId}`);\n  }\n\n  /**\n   * Get suspended workflow states for a workflow\n   */\n  async getSuspendedWorkflowStates(\n    workflowId: string,\n  ): Promise<WorkflowStateEntry[]> {\n    const states = await this.client.query(\n      this.api.getSuspendedWorkflowStates,\n      {\n        workflowId,\n      },\n    );\n\n    return (\n      states as Array<{\n        id: string;\n        workflowId: string;\n        workflowName: string;\n        status: string;\n        input?: unknown;\n        context?: unknown;\n        suspension?: unknown;\n        events?: unknown[];\n        output?: unknown;\n        cancellation?: unknown;\n        userId?: string;\n        conversationId?: string;\n        metadata?: Record<string, unknown>;\n        createdAt: string;\n        updatedAt: string;\n      }>\n    ).map((s) => ({\n      id: s.id,\n      workflowId: s.workflowId,\n      workflowName: s.workflowName,\n      status: s.status as WorkflowStateEntry[\"status\"],\n      input: s.input,\n      context: s.context as WorkflowStateEntry[\"context\"],\n      suspension: s.suspension as WorkflowStateEntry[\"suspension\"],\n      events: s.events as WorkflowStateEntry[\"events\"],\n      output: s.output,\n      cancellation: s.cancellation as WorkflowStateEntry[\"cancellation\"],\n      userId: s.userId,\n      conversationId: s.conversationId,\n      metadata: s.metadata,\n      createdAt: new Date(s.createdAt),\n      updatedAt: new Date(s.updatedAt),\n    }));\n  }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAqB;AACrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/memory-adapter.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Convex Memory Adapter for VoltAgent
+ *
+ * A StorageAdapter implementation that persists conversation data
+ * to Convex database using the VoltAgent Convex component.
+ */
+import type { Conversation, ConversationQueryOptions, ConversationStepRecord, CreateConversationInput, GetConversationStepsOptions, GetMessagesOptions, OperationContext, StorageAdapter, WorkflowStateEntry, WorkingMemoryScope } from "@voltagent/core";
+import type { UIMessage } from "ai";
+import type { ConvexMemoryAdapterOptions } from "./types";
+/**
+ * Convex Memory Adapter for VoltAgent
+ *
+ * Implements the StorageAdapter interface to persist conversation history,
+ * working memory, and workflow state to a Convex database.
+ *
+ * @example
+ * ```ts
+ * import { ConvexHttpClient } from "convex/browser";
+ * import { api } from "./convex/_generated/api";
+ * import { ConvexMemoryAdapter } from "@voltagent/convex";
+ *
+ * const client = new ConvexHttpClient(process.env.CONVEX_URL);
+ *
+ * const adapter = new ConvexMemoryAdapter({
+ *   client,
+ *   api: api.voltagent,
+ * });
+ *
+ * const memory = new Memory({ storage: adapter });
+ * ```
+ */
+export declare class ConvexMemoryAdapter implements StorageAdapter {
+    private client;
+    private api;
+    private debug;
+    private logger;
+    constructor(options: ConvexMemoryAdapterOptions);
+    /**
+     * Log debug messages
+     */
+    private log;
+    /**
+     * Generate a cryptographically secure random ID
+     */
+    private generateId;
+    /**
+     * Add a single message to a conversation
+     */
+    addMessage(message: UIMessage, userId: string, conversationId: string, _context?: OperationContext): Promise<void>;
+    /**
+     * Add multiple messages to a conversation
+     */
+    addMessages(messages: UIMessage[], userId: string, conversationId: string, _context?: OperationContext): Promise<void>;
+    /**
+     * Get messages from a conversation with optional filtering
+     */
+    getMessages(userId: string, conversationId: string, options?: GetMessagesOptions, _context?: OperationContext): Promise<UIMessage<{
+        createdAt: Date;
+    }>[]>;
+    /**
+     * Clear messages for a user (optionally for a specific conversation)
+     */
+    clearMessages(userId: string, conversationId?: string, _context?: OperationContext): Promise<void>;
+    /**
+     * Save conversation steps for observability
+     */
+    saveConversationSteps(steps: ConversationStepRecord[]): Promise<void>;
+    /**
+     * Get conversation steps for observability
+     */
+    getConversationSteps(userId: string, conversationId: string, options?: GetConversationStepsOptions): Promise<ConversationStepRecord[]>;
+    /**
+     * Create a new conversation
+     */
+    createConversation(input: CreateConversationInput): Promise<Conversation>;
+    /**
+     * Get a conversation by ID
+     */
+    getConversation(id: string): Promise<Conversation | null>;
+    /**
+     * Get conversations by resource ID
+     */
+    getConversations(resourceId: string): Promise<Conversation[]>;
+    /**
+     * Get conversations by user ID with optional query options
+     */
+    getConversationsByUserId(userId: string, options?: Omit<ConversationQueryOptions, "userId">): Promise<Conversation[]>;
+    /**
+     * Query conversations with filters
+     */
+    queryConversations(options: ConversationQueryOptions): Promise<Conversation[]>;
+    /**
+     * Update a conversation
+     */
+    updateConversation(id: string, updates: Partial<Omit<Conversation, "id" | "createdAt" | "updatedAt">>): Promise<Conversation>;
+    /**
+     * Delete a conversation and its associated data
+     */
+    deleteConversation(id: string): Promise<void>;
+    /**
+     * Get working memory content
+     */
+    getWorkingMemory(params: {
+        conversationId?: string;
+        userId?: string;
+        scope: WorkingMemoryScope;
+    }): Promise<string | null>;
+    /**
+     * Set working memory content
+     */
+    setWorkingMemory(params: {
+        conversationId?: string;
+        userId?: string;
+        content: string;
+        scope: WorkingMemoryScope;
+    }): Promise<void>;
+    /**
+     * Delete working memory content
+     */
+    deleteWorkingMemory(params: {
+        conversationId?: string;
+        userId?: string;
+        scope: WorkingMemoryScope;
+    }): Promise<void>;
+    /**
+     * Get workflow state by execution ID
+     */
+    getWorkflowState(executionId: string): Promise<WorkflowStateEntry | null>;
+    /**
+     * Query workflow runs with optional filters
+     */
+    queryWorkflowRuns(query: {
+        workflowId?: string;
+        status?: WorkflowStateEntry["status"];
+        from?: Date;
+        to?: Date;
+        limit?: number;
+        offset?: number;
+    }): Promise<WorkflowStateEntry[]>;
+    /**
+     * Set workflow state
+     */
+    setWorkflowState(executionId: string, state: WorkflowStateEntry): Promise<void>;
+    /**
+     * Update workflow state
+     */
+    updateWorkflowState(executionId: string, updates: Partial<WorkflowStateEntry>): Promise<void>;
+    /**
+     * Get suspended workflow states for a workflow
+     */
+    getSuspendedWorkflowStates(workflowId: string): Promise<WorkflowStateEntry[]>;
+}
+//# sourceMappingURL=memory-adapter.d.ts.map

package/dist/memory-adapter.d.ts.map

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