@o-zakstam/voltagent-convex 1.1.1 → 1.1.3

package/src/types.ts

@@ -0,0 +1,178 @@
+/**
+ * Type definitions for VoltAgent Convex Memory Adapter
+ */
+
+/**
+ * Logger interface for the adapter
+ */
+export interface Logger {
+  debug: (message: string, ...args: unknown[]) => void;
+  info: (message: string, ...args: unknown[]) => void;
+  warn: (message: string, ...args: unknown[]) => void;
+  error: (message: string, ...args: unknown[]) => void;
+}
+
+/**
+ * Convex client interface - compatible with ConvexHttpClient and ConvexReactClient.
+ *
+ * This interface is intentionally loose to accommodate different Convex client
+ * implementations (ConvexHttpClient, ConvexReactClient) which have slightly
+ * different method signatures.
+ */
+export interface ConvexClient {
+  query: (functionReference: any, ...args: any[]) => Promise<any>;
+  mutation: (functionReference: any, ...args: any[]) => Promise<any>;
+}
+
+/**
+ * The VoltAgent API structure.
+ * This matches the wrapper functions exported from the convex/api.ts file.
+ */
+export interface VoltAgentApi {
+  createConversation: unknown;
+  getConversation: unknown;
+  getConversations: unknown;
+  getConversationsByUserId: unknown;
+  queryConversations: unknown;
+  updateConversation: unknown;
+  deleteConversation: unknown;
+  addMessage: unknown;
+  addMessages: unknown;
+  getMessages: unknown;
+  clearMessages: unknown;
+  saveConversationSteps: unknown;
+  getConversationSteps: unknown;
+  getWorkingMemory: unknown;
+  setWorkingMemory: unknown;
+  deleteWorkingMemory: unknown;
+  getWorkflowState: unknown;
+  queryWorkflowRuns: unknown;
+  setWorkflowState: unknown;
+  updateWorkflowState: unknown;
+  getSuspendedWorkflowStates: unknown;
+}
+
+/**
+ * Configuration options for ConvexMemoryAdapter
+ */
+export interface ConvexMemoryAdapterOptions {
+  /**
+   * The Convex client instance to use for queries and mutations.
+   * Can be a ConvexHttpClient or ConvexReactClient.
+   */
+  client: ConvexClient;
+
+  /**
+   * Whether to enable debug logging.
+   * @default false
+   */
+  debug?: boolean;
+
+  /**
+   * Custom logger instance.
+   * If not provided, a default console logger will be used when debug is enabled.
+   */
+  logger?: Logger;
+
+  /**
+   * The VoltAgent API from your Convex generated code.
+   *
+   * After adding the voltagent.ts file to your convex folder that re-exports
+   * the wrapper functions, import the api and pass api.voltagent here.
+   *
+   * @example
+   * ```ts
+   * import { api } from "./convex/_generated/api";
+   *
+   * const adapter = new ConvexMemoryAdapter({
+   *   client,
+   *   api: api.voltagent,
+   * });
+   * ```
+   */
+  api: VoltAgentApi;
+}
+
+/**
+ * Internal representation of a conversation in Convex
+ */
+export interface ConvexConversation {
+  _id: string;
+  visibleId: string;
+  resourceId: string;
+  userId: string;
+  title: string;
+  metadata: Record<string, unknown>;
+  createdAt: string;
+  updatedAt: string;
+}
+
+/**
+ * Internal representation of a message in Convex
+ */
+export interface ConvexMessage {
+  _id: string;
+  visibleId: string;
+  conversationId: string;
+  userId: string;
+  role: string;
+  parts: unknown[];
+  metadata?: Record<string, unknown>;
+  createdAt: string;
+}
+
+/**
+ * Internal representation of a user in Convex
+ */
+export interface ConvexUser {
+  _id: string;
+  visibleId: string;
+  metadata?: Record<string, unknown>;
+  createdAt: string;
+  updatedAt: string;
+}
+
+/**
+ * Internal representation of a workflow state in Convex
+ */
+export interface ConvexWorkflowState {
+  _id: string;
+  visibleId: string;
+  workflowId: string;
+  workflowName: string;
+  status: string;
+  input?: unknown;
+  context?: unknown;
+  suspension?: unknown;
+  events?: unknown[];
+  output?: unknown;
+  cancellation?: unknown;
+  userId?: string;
+  conversationId?: string;
+  metadata?: Record<string, unknown>;
+  createdAt: string;
+  updatedAt: string;
+}
+
+/**
+ * Internal representation of a conversation step in Convex
+ */
+export interface ConvexConversationStep {
+  _id: string;
+  visibleId: string;
+  conversationId: string;
+  userId: string;
+  agentId: string;
+  agentName?: string;
+  operationId?: string;
+  stepIndex: number;
+  type: string;
+  role: string;
+  content?: string;
+  arguments?: Record<string, unknown>;
+  result?: Record<string, unknown>;
+  usage?: Record<string, unknown>;
+  subAgentId?: string;
+  subAgentName?: string;
+  createdAt: string;
+}

package/dist/client/index.cjs

@@ -1,288 +0,0 @@
-'use strict';
-
-var server = require('convex/server');
-var values = require('convex/values');
-
-// src/client/defineVoltAgentAPI.ts
-function defineVoltAgentAPI(component) {
-  const createConversation = server.mutationGeneric({
-    args: {
-      id: values.v.string(),
-      resourceId: values.v.string(),
-      userId: values.v.string(),
-      title: values.v.string(),
-      metadata: values.v.any()
-    },
-    handler: async (ctx, args) => {
-      return ctx.runMutation(component.conversations.create, args);
-    }
-  });
-  const getConversation = server.queryGeneric({
-    args: { id: values.v.string() },
-    handler: async (ctx, args) => {
-      return ctx.runQuery(component.conversations.get, args);
-    }
-  });
-  const getConversations = server.queryGeneric({
-    args: { resourceId: values.v.string() },
-    handler: async (ctx, args) => {
-      return ctx.runQuery(component.conversations.getByResourceId, args);
-    }
-  });
-  const getConversationsByUserId = server.queryGeneric({
-    args: {
-      userId: values.v.string(),
-      limit: values.v.optional(values.v.number()),
-      offset: values.v.optional(values.v.number()),
-      orderBy: values.v.optional(values.v.string()),
-      orderDirection: values.v.optional(values.v.string())
-    },
-    handler: async (ctx, args) => {
-      return ctx.runQuery(component.conversations.getByUserId, args);
-    }
-  });
-  const queryConversations = server.queryGeneric({
-    args: {
-      userId: values.v.optional(values.v.string()),
-      resourceId: values.v.optional(values.v.string()),
-      limit: values.v.optional(values.v.number()),
-      offset: values.v.optional(values.v.number()),
-      orderBy: values.v.optional(values.v.string()),
-      orderDirection: values.v.optional(values.v.string())
-    },
-    handler: async (ctx, args) => {
-      return ctx.runQuery(component.conversations.queryConversations, args);
-    }
-  });
-  const updateConversation = server.mutationGeneric({
-    args: {
-      id: values.v.string(),
-      title: values.v.optional(values.v.string()),
-      resourceId: values.v.optional(values.v.string()),
-      metadata: values.v.optional(values.v.any())
-    },
-    handler: async (ctx, args) => {
-      return ctx.runMutation(component.conversations.update, args);
-    }
-  });
-  const deleteConversation = server.mutationGeneric({
-    args: { id: values.v.string() },
-    handler: async (ctx, args) => {
-      return ctx.runMutation(component.conversations.remove, args);
-    }
-  });
-  const addMessage = server.mutationGeneric({
-    args: {
-      id: values.v.string(),
-      conversationId: values.v.string(),
-      userId: values.v.string(),
-      role: values.v.string(),
-      parts: values.v.any(),
-      metadata: values.v.optional(values.v.any())
-    },
-    handler: async (ctx, args) => {
-      return ctx.runMutation(component.messages.add, args);
-    }
-  });
-  const addMessages = server.mutationGeneric({
-    args: {
-      messages: values.v.array(
-        values.v.object({
-          id: values.v.string(),
-          conversationId: values.v.string(),
-          userId: values.v.string(),
-          role: values.v.string(),
-          parts: values.v.any(),
-          metadata: values.v.optional(values.v.any())
-        })
-      )
-    },
-    handler: async (ctx, args) => {
-      return ctx.runMutation(component.messages.addMany, args);
-    }
-  });
-  const getMessages = server.queryGeneric({
-    args: {
-      userId: values.v.string(),
-      conversationId: values.v.string(),
-      limit: values.v.optional(values.v.number()),
-      before: values.v.optional(values.v.string()),
-      after: values.v.optional(values.v.string()),
-      roles: values.v.optional(values.v.array(values.v.string()))
-    },
-    handler: async (ctx, args) => {
-      return ctx.runQuery(component.messages.get, args);
-    }
-  });
-  const clearMessages = server.mutationGeneric({
-    args: {
-      userId: values.v.string(),
-      conversationId: values.v.optional(values.v.string())
-    },
-    handler: async (ctx, args) => {
-      return ctx.runMutation(component.messages.clear, args);
-    }
-  });
-  const saveConversationSteps = server.mutationGeneric({
-    args: {
-      steps: values.v.array(
-        values.v.object({
-          id: values.v.string(),
-          conversationId: values.v.string(),
-          userId: values.v.string(),
-          agentId: values.v.string(),
-          agentName: values.v.optional(values.v.string()),
-          operationId: values.v.optional(values.v.string()),
-          stepIndex: values.v.number(),
-          type: values.v.string(),
-          role: values.v.string(),
-          content: values.v.optional(values.v.string()),
-          arguments: values.v.optional(values.v.any()),
-          result: values.v.optional(values.v.any()),
-          usage: values.v.optional(values.v.any()),
-          subAgentId: values.v.optional(values.v.string()),
-          subAgentName: values.v.optional(values.v.string()),
-          createdAt: values.v.optional(values.v.string())
-        })
-      )
-    },
-    handler: async (ctx, args) => {
-      return ctx.runMutation(component.steps.save, args);
-    }
-  });
-  const getConversationSteps = server.queryGeneric({
-    args: {
-      userId: values.v.string(),
-      conversationId: values.v.string(),
-      limit: values.v.optional(values.v.number()),
-      operationId: values.v.optional(values.v.string())
-    },
-    handler: async (ctx, args) => {
-      return ctx.runQuery(component.steps.get, args);
-    }
-  });
-  const getWorkingMemory = server.queryGeneric({
-    args: {
-      conversationId: values.v.optional(values.v.string()),
-      userId: values.v.optional(values.v.string()),
-      scope: values.v.string()
-    },
-    handler: async (ctx, args) => {
-      return ctx.runQuery(component.workingMemory.get, args);
-    }
-  });
-  const setWorkingMemory = server.mutationGeneric({
-    args: {
-      conversationId: values.v.optional(values.v.string()),
-      userId: values.v.optional(values.v.string()),
-      content: values.v.string(),
-      scope: values.v.string()
-    },
-    handler: async (ctx, args) => {
-      return ctx.runMutation(component.workingMemory.set, args);
-    }
-  });
-  const deleteWorkingMemory = server.mutationGeneric({
-    args: {
-      conversationId: values.v.optional(values.v.string()),
-      userId: values.v.optional(values.v.string()),
-      scope: values.v.string()
-    },
-    handler: async (ctx, args) => {
-      return ctx.runMutation(component.workingMemory.remove, args);
-    }
-  });
-  const getWorkflowState = server.queryGeneric({
-    args: { executionId: values.v.string() },
-    handler: async (ctx, args) => {
-      return ctx.runQuery(component.workflows.get, args);
-    }
-  });
-  const queryWorkflowRuns = server.queryGeneric({
-    args: {
-      workflowId: values.v.optional(values.v.string()),
-      status: values.v.optional(values.v.string()),
-      from: values.v.optional(values.v.string()),
-      to: values.v.optional(values.v.string()),
-      limit: values.v.optional(values.v.number()),
-      offset: values.v.optional(values.v.number())
-    },
-    handler: async (ctx, args) => {
-      return ctx.runQuery(component.workflows.queryRuns, args);
-    }
-  });
-  const setWorkflowState = server.mutationGeneric({
-    args: {
-      executionId: values.v.string(),
-      workflowId: values.v.string(),
-      workflowName: values.v.string(),
-      status: values.v.string(),
-      input: values.v.optional(values.v.any()),
-      context: values.v.optional(values.v.any()),
-      suspension: values.v.optional(values.v.any()),
-      events: values.v.optional(values.v.any()),
-      output: values.v.optional(values.v.any()),
-      cancellation: values.v.optional(values.v.any()),
-      userId: values.v.optional(values.v.string()),
-      conversationId: values.v.optional(values.v.string()),
-      metadata: values.v.optional(values.v.any()),
-      createdAt: values.v.string(),
-      updatedAt: values.v.string()
-    },
-    handler: async (ctx, args) => {
-      return ctx.runMutation(component.workflows.set, args);
-    }
-  });
-  const updateWorkflowState = server.mutationGeneric({
-    args: {
-      executionId: values.v.string(),
-      status: values.v.optional(values.v.string()),
-      suspension: values.v.optional(values.v.any()),
-      events: values.v.optional(values.v.any()),
-      output: values.v.optional(values.v.any()),
-      cancellation: values.v.optional(values.v.any()),
-      metadata: values.v.optional(values.v.any())
-    },
-    handler: async (ctx, args) => {
-      return ctx.runMutation(component.workflows.update, args);
-    }
-  });
-  const getSuspendedWorkflowStates = server.queryGeneric({
-    args: { workflowId: values.v.string() },
-    handler: async (ctx, args) => {
-      return ctx.runQuery(component.workflows.getSuspended, args);
-    }
-  });
-  return {
-    // Conversations
-    createConversation,
-    getConversation,
-    getConversations,
-    getConversationsByUserId,
-    queryConversations,
-    updateConversation,
-    deleteConversation,
-    // Messages
-    addMessage,
-    addMessages,
-    getMessages,
-    clearMessages,
-    // Conversation Steps
-    saveConversationSteps,
-    getConversationSteps,
-    // Working Memory
-    getWorkingMemory,
-    setWorkingMemory,
-    deleteWorkingMemory,
-    // Workflow State
-    getWorkflowState,
-    queryWorkflowRuns,
-    setWorkflowState,
-    updateWorkflowState,
-    getSuspendedWorkflowStates
-  };
-}
-
-exports.defineVoltAgentAPI = defineVoltAgentAPI;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map

package/dist/client/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/client/defineVoltAgentAPI.ts"],"names":["mutationGeneric","v","queryGeneric"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * VoltAgent API Generator\n *\n * This function generates public Convex query/mutation functions that wrap\n * the VoltAgent component's internal functions. This allows external HTTP\n * clients to call the functions via ConvexHttpClient.\n *\n * Usage:\n * ```typescript\n * // convex/voltagent.ts\n * import { components } from \"./_generated/api\";\n * import { defineVoltAgentAPI } from \"@voltagent/convex/api\";\n *\n * export const {\n *   createConversation,\n *   getConversation,\n *   // ... other functions\n * } = defineVoltAgentAPI(components.voltagent);\n * ```\n */\nimport {\n  queryGeneric,\n  mutationGeneric,\n  type ApiFromModules,\n} from \"convex/server\";\nimport { v } from \"convex/values\";\nimport type { VoltAgentComponent } from \"./types.js\";\n\n/**\n * Define the VoltAgent API functions.\n *\n * @param component - The VoltAgent component reference (components.voltagent)\n * @returns An object containing all VoltAgent API functions\n */\nexport function defineVoltAgentAPI(component: VoltAgentComponent) {\n  // ============================================================================\n  // Conversation Functions\n  // ============================================================================\n\n  const createConversation = mutationGeneric({\n    args: {\n      id: v.string(),\n      resourceId: v.string(),\n      userId: v.string(),\n      title: v.string(),\n      metadata: v.any(),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runMutation(component.conversations.create, args);\n    },\n  });\n\n  const getConversation = queryGeneric({\n    args: { id: v.string() },\n    handler: async (ctx, args) => {\n      return ctx.runQuery(component.conversations.get, args);\n    },\n  });\n\n  const getConversations = queryGeneric({\n    args: { resourceId: v.string() },\n    handler: async (ctx, args) => {\n      return ctx.runQuery(component.conversations.getByResourceId, args);\n    },\n  });\n\n  const getConversationsByUserId = queryGeneric({\n    args: {\n      userId: v.string(),\n      limit: v.optional(v.number()),\n      offset: v.optional(v.number()),\n      orderBy: v.optional(v.string()),\n      orderDirection: v.optional(v.string()),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runQuery(component.conversations.getByUserId, args);\n    },\n  });\n\n  const queryConversations = queryGeneric({\n    args: {\n      userId: v.optional(v.string()),\n      resourceId: v.optional(v.string()),\n      limit: v.optional(v.number()),\n      offset: v.optional(v.number()),\n      orderBy: v.optional(v.string()),\n      orderDirection: v.optional(v.string()),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runQuery(component.conversations.queryConversations, args);\n    },\n  });\n\n  const updateConversation = mutationGeneric({\n    args: {\n      id: v.string(),\n      title: v.optional(v.string()),\n      resourceId: v.optional(v.string()),\n      metadata: v.optional(v.any()),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runMutation(component.conversations.update, args);\n    },\n  });\n\n  const deleteConversation = mutationGeneric({\n    args: { id: v.string() },\n    handler: async (ctx, args) => {\n      return ctx.runMutation(component.conversations.remove, args);\n    },\n  });\n\n  // ============================================================================\n  // Message Functions\n  // ============================================================================\n\n  const addMessage = mutationGeneric({\n    args: {\n      id: v.string(),\n      conversationId: v.string(),\n      userId: v.string(),\n      role: v.string(),\n      parts: v.any(),\n      metadata: v.optional(v.any()),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runMutation(component.messages.add, args);\n    },\n  });\n\n  const addMessages = mutationGeneric({\n    args: {\n      messages: v.array(\n        v.object({\n          id: v.string(),\n          conversationId: v.string(),\n          userId: v.string(),\n          role: v.string(),\n          parts: v.any(),\n          metadata: v.optional(v.any()),\n        }),\n      ),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runMutation(component.messages.addMany, args);\n    },\n  });\n\n  const getMessages = queryGeneric({\n    args: {\n      userId: v.string(),\n      conversationId: v.string(),\n      limit: v.optional(v.number()),\n      before: v.optional(v.string()),\n      after: v.optional(v.string()),\n      roles: v.optional(v.array(v.string())),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runQuery(component.messages.get, args);\n    },\n  });\n\n  const clearMessages = mutationGeneric({\n    args: {\n      userId: v.string(),\n      conversationId: v.optional(v.string()),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runMutation(component.messages.clear, args);\n    },\n  });\n\n  // ============================================================================\n  // Conversation Steps Functions\n  // ============================================================================\n\n  const saveConversationSteps = mutationGeneric({\n    args: {\n      steps: v.array(\n        v.object({\n          id: v.string(),\n          conversationId: v.string(),\n          userId: v.string(),\n          agentId: v.string(),\n          agentName: v.optional(v.string()),\n          operationId: v.optional(v.string()),\n          stepIndex: v.number(),\n          type: v.string(),\n          role: v.string(),\n          content: v.optional(v.string()),\n          arguments: v.optional(v.any()),\n          result: v.optional(v.any()),\n          usage: v.optional(v.any()),\n          subAgentId: v.optional(v.string()),\n          subAgentName: v.optional(v.string()),\n          createdAt: v.optional(v.string()),\n        }),\n      ),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runMutation(component.steps.save, args);\n    },\n  });\n\n  const getConversationSteps = queryGeneric({\n    args: {\n      userId: v.string(),\n      conversationId: v.string(),\n      limit: v.optional(v.number()),\n      operationId: v.optional(v.string()),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runQuery(component.steps.get, args);\n    },\n  });\n\n  // ============================================================================\n  // Working Memory Functions\n  // ============================================================================\n\n  const getWorkingMemory = queryGeneric({\n    args: {\n      conversationId: v.optional(v.string()),\n      userId: v.optional(v.string()),\n      scope: v.string(),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runQuery(component.workingMemory.get, args);\n    },\n  });\n\n  const setWorkingMemory = mutationGeneric({\n    args: {\n      conversationId: v.optional(v.string()),\n      userId: v.optional(v.string()),\n      content: v.string(),\n      scope: v.string(),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runMutation(component.workingMemory.set, args);\n    },\n  });\n\n  const deleteWorkingMemory = mutationGeneric({\n    args: {\n      conversationId: v.optional(v.string()),\n      userId: v.optional(v.string()),\n      scope: v.string(),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runMutation(component.workingMemory.remove, args);\n    },\n  });\n\n  // ============================================================================\n  // Workflow State Functions\n  // ============================================================================\n\n  const getWorkflowState = queryGeneric({\n    args: { executionId: v.string() },\n    handler: async (ctx, args) => {\n      return ctx.runQuery(component.workflows.get, args);\n    },\n  });\n\n  const queryWorkflowRuns = queryGeneric({\n    args: {\n      workflowId: v.optional(v.string()),\n      status: v.optional(v.string()),\n      from: v.optional(v.string()),\n      to: v.optional(v.string()),\n      limit: v.optional(v.number()),\n      offset: v.optional(v.number()),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runQuery(component.workflows.queryRuns, args);\n    },\n  });\n\n  const setWorkflowState = mutationGeneric({\n    args: {\n      executionId: v.string(),\n      workflowId: v.string(),\n      workflowName: v.string(),\n      status: v.string(),\n      input: v.optional(v.any()),\n      context: v.optional(v.any()),\n      suspension: v.optional(v.any()),\n      events: v.optional(v.any()),\n      output: v.optional(v.any()),\n      cancellation: v.optional(v.any()),\n      userId: v.optional(v.string()),\n      conversationId: v.optional(v.string()),\n      metadata: v.optional(v.any()),\n      createdAt: v.string(),\n      updatedAt: v.string(),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runMutation(component.workflows.set, args);\n    },\n  });\n\n  const updateWorkflowState = mutationGeneric({\n    args: {\n      executionId: v.string(),\n      status: v.optional(v.string()),\n      suspension: v.optional(v.any()),\n      events: v.optional(v.any()),\n      output: v.optional(v.any()),\n      cancellation: v.optional(v.any()),\n      metadata: v.optional(v.any()),\n    },\n    handler: async (ctx, args) => {\n      return ctx.runMutation(component.workflows.update, args);\n    },\n  });\n\n  const getSuspendedWorkflowStates = queryGeneric({\n    args: { workflowId: v.string() },\n    handler: async (ctx, args) => {\n      return ctx.runQuery(component.workflows.getSuspended, args);\n    },\n  });\n\n  return {\n    // Conversations\n    createConversation,\n    getConversation,\n    getConversations,\n    getConversationsByUserId,\n    queryConversations,\n    updateConversation,\n    deleteConversation,\n    // Messages\n    addMessage,\n    addMessages,\n    getMessages,\n    clearMessages,\n    // Conversation Steps\n    saveConversationSteps,\n    getConversationSteps,\n    // Working Memory\n    getWorkingMemory,\n    setWorkingMemory,\n    deleteWorkingMemory,\n    // Workflow State\n    getWorkflowState,\n    queryWorkflowRuns,\n    setWorkflowState,\n    updateWorkflowState,\n    getSuspendedWorkflowStates,\n  };\n}\n\n/**\n * Type for the VoltAgent API when used with ApiFromModules.\n *\n * Usage:\n * ```typescript\n * import type { VoltAgentAPI } from \"@voltagent/convex/api\";\n * ```\n */\nexport type VoltAgentAPI = ApiFromModules<{\n  voltagent: ReturnType<typeof defineVoltAgentAPI>;\n}>[\"voltagent\"];\n"]}