@voltagent/core 1.1.1 → 1.1.2

package/README.md

@@ -95,10 +95,10 @@ This command guides you through setup.
 You'll see the starter code in `src/index.ts`, which now registers both an agent and a comprehensive workflow example found in `src/workflows/index.ts`.
 
 ```typescript
-import { VoltAgent, Agent } from "@voltagent/core";
-import { LibSQLStorage } from "@voltagent/libsql";
+import { VoltAgent, Agent, Memory } from "@voltagent/core";
+import { LibSQLMemoryAdapter } from "@voltagent/libsql";
 import { createPinoLogger } from "@voltagent/logger";
-import { VercelAIProvider } from "@voltagent/vercel-ai";
+import { honoServer } from "@voltagent/server-hono";
 import { openai } from "@ai-sdk/openai";
 import { expenseApprovalWorkflow } from "./workflows";
 import { weatherTool } from "./tools";
@@ -109,17 +109,18 @@ const logger = createPinoLogger({
   level: "info",
 });
 
+// Optional persistent memory (remove to use default in-memory)
+const memory = new Memory({
+  storage: new LibSQLMemoryAdapter({ url: "file:./.voltagent/memory.db" }),
+});
+
 // A simple, general-purpose agent for the project.
 const agent = new Agent({
   name: "my-agent",
   instructions: "A helpful assistant that can check weather and help with various tasks",
-  llm: new VercelAIProvider(),
   model: openai("gpt-4o-mini"),
   tools: [weatherTool],
-  memory: new LibSQLStorage({
-    url: "file:./.voltagent/memory.db",
-    logger: logger.child({ component: "libsql" }),
-  }),
+  memory,
 });
 
 // Initialize VoltAgent with your agent(s) and workflow(s)
@@ -130,6 +131,7 @@ new VoltAgent({
   workflows: {
     expenseApprovalWorkflow,
   },
+  server: honoServer(),
   logger,
 });
 ```

package/dist/index.d.mts

@@ -1209,6 +1209,9 @@ declare class Memory {
         currentQuery?: string;
         traceId?: string;
         logger?: Logger;
+        semanticLimit?: number;
+        semanticThreshold?: number;
+        mergeStrategy?: "prepend" | "append" | "interleave";
     }): Promise<UIMessage[]>;
     /**
      * Internal: Set resource ID (agent ID)
@@ -4792,7 +4795,7 @@ type AgentConfig<SCHEMA extends z.ZodTypeAny> = {
  *   purpose: "Process user data and generate personalized content",
  *   input: z.object({ userId: z.string(), userType: z.enum(["admin", "user"]) }),
  *   result: z.object({ processed: z.boolean(), content: z.string() }),
- *   memory: new LibSQLStorage({ url: "file:memory.db" }) // Optional workflow-specific memory
+ *   memory: new Memory({ storage: new LibSQLMemoryAdapter({ url: "file:memory.db" }) }) // Optional workflow-specific memory
  * })
  *   .andThen({
  *     id: "fetch-user",
@@ -4822,7 +4825,7 @@ type AgentConfig<SCHEMA extends z.ZodTypeAny> = {
  * // Run with optional memory override
  * const result = await workflow.run(
  *   { userId: "123", userType: "admin" },
- *   { memory: new LibSQLStorage({ url: "file:memory.db" }) }
+ *   { memory: new Memory({ storage: new LibSQLMemoryAdapter({ url: "file:memory.db" }) }) }
  * );
  * ```
  */

package/dist/index.d.ts

@@ -1209,6 +1209,9 @@ declare class Memory {
         currentQuery?: string;
         traceId?: string;
         logger?: Logger;
+        semanticLimit?: number;
+        semanticThreshold?: number;
+        mergeStrategy?: "prepend" | "append" | "interleave";
     }): Promise<UIMessage[]>;
     /**
      * Internal: Set resource ID (agent ID)
@@ -4792,7 +4795,7 @@ type AgentConfig<SCHEMA extends z.ZodTypeAny> = {
  *   purpose: "Process user data and generate personalized content",
  *   input: z.object({ userId: z.string(), userType: z.enum(["admin", "user"]) }),
  *   result: z.object({ processed: z.boolean(), content: z.string() }),
- *   memory: new LibSQLStorage({ url: "file:memory.db" }) // Optional workflow-specific memory
+ *   memory: new Memory({ storage: new LibSQLMemoryAdapter({ url: "file:memory.db" }) }) // Optional workflow-specific memory
  * })
  *   .andThen({
  *     id: "fetch-user",
@@ -4822,7 +4825,7 @@ type AgentConfig<SCHEMA extends z.ZodTypeAny> = {
  * // Run with optional memory override
  * const result = await workflow.run(
  *   { userId: "123", userType: "admin" },
- *   { memory: new LibSQLStorage({ url: "file:memory.db" }) }
+ *   { memory: new Memory({ storage: new LibSQLMemoryAdapter({ url: "file:memory.db" }) }) }
  * );
  * ```
  */

package/dist/index.js

@@ -1345,6 +1345,7 @@ function andWorkflow(workflow) {
 __name(andWorkflow, "andWorkflow");
 
 // src/workflow/core.ts
+var import_node_crypto = __toESM(require("crypto"));
 var import_zod = require("zod");
 
 // src/memory/errors.ts
@@ -1757,7 +1758,7 @@ var Memory = class {
     try {
       const queryVector = await this.getEmbedding(currentQuery);
       const semanticResults = await this.vector.search(queryVector, {
-        limit: options?.semanticLimit || 5,
+        limit: options?.semanticLimit ?? 5,
         filter: { userId, conversationId },
         threshold: options?.semanticThreshold
       });
@@ -1769,7 +1770,7 @@ var Memory = class {
       return this.mergeMessages(
         recentMessages,
         semanticMessages,
-        options?.mergeStrategy || "prepend"
+        options?.mergeStrategy ?? "append"
       );
     } catch (error) {
       console.warn("Semantic search failed, returning recent messages only:", error);
@@ -1781,12 +1782,14 @@ var Memory = class {
    */
   async getMessagesByIds(userId, conversationId, messageIds) {
     const allMessages = await this.storage.getMessages(userId, conversationId);
-    return allMessages.filter((msg) => messageIds.includes(msg.id));
+    const byId = new Map(allMessages.map((m) => [m.id, m]));
+    const ordered = messageIds.map((id) => byId.get(id)).filter((m) => Boolean(m));
+    return ordered;
   }
   /**
    * Merge two arrays of messages, removing duplicates
    */
-  mergeMessages(recentMessages, semanticMessages, strategy = "prepend") {
+  mergeMessages(recentMessages, semanticMessages, strategy = "append") {
     const recentIds = new Set(recentMessages.map((m) => m.id));
     const uniqueSemanticMessages = semanticMessages.filter((m) => !recentIds.has(m.id));
     switch (strategy) {
@@ -2197,9 +2200,9 @@ Remember:
           options.currentQuery,
           {
             limit: options.limit,
-            semanticLimit: 5,
-            semanticThreshold: 0.7,
-            mergeStrategy: "prepend"
+            semanticLimit: options.semanticLimit ?? 5,
+            semanticThreshold: options.semanticThreshold ?? 0.7,
+            mergeStrategy: options.mergeStrategy ?? "append"
           }
         );
       } else {
@@ -4725,7 +4728,7 @@ function createWorkflow({
     if (options?.resumeFrom?.executionId) {
       executionId = options.resumeFrom.executionId;
     } else {
-      executionId = options?.executionId || crypto.randomUUID();
+      executionId = options?.executionId || import_node_crypto.default.randomUUID();
     }
     const streamController = externalStreamController || null;
     const observability = getObservability();
@@ -5348,7 +5351,7 @@ function createWorkflow({
     }, "run"),
     stream: /* @__PURE__ */ __name((input2, options) => {
       const streamController = new WorkflowStreamController();
-      const executionId = options?.executionId || crypto.randomUUID();
+      const executionId = options?.executionId || import_node_crypto.default.randomUUID();
       const originalInput = input2;
       let resultResolve;
       let resultReject;
@@ -5858,14 +5861,14 @@ function createSuspendController() {
 __name(createSuspendController, "createSuspendController");
 
 // src/agent/agent.ts
-var crypto4 = __toESM(require("crypto"));
+var crypto5 = __toESM(require("crypto"));
 var import_api8 = require("@opentelemetry/api");
 var import_utils13 = require("@voltagent/internal/utils");
 var import_ai = require("ai");
 var import_zod3 = require("zod");
 
 // src/memory/manager/memory-manager.ts
-var import_node_crypto = __toESM(require("crypto"));
+var import_node_crypto2 = __toESM(require("crypto"));
 
 // src/utils/node-utils.ts
 var NodeType = /* @__PURE__ */ ((NodeType2) => {
@@ -6174,6 +6177,9 @@ var MemoryManager = class {
             conversationId,
             options.currentQuery,
             options.semanticLimit || limit,
+            options.semanticLimit,
+            options.semanticThreshold,
+            options.mergeStrategy,
             memoryLogger,
             options.traceContext,
             options.parentMemorySpan
@@ -6280,7 +6286,7 @@ var MemoryManager = class {
    * PRESERVED FROM ORIGINAL
    */
   async prepareConversationContext(context5, input, userId, conversationIdParam, contextLimit = 10) {
-    const conversationId = conversationIdParam || import_node_crypto.default.randomUUID();
+    const conversationId = conversationIdParam || import_node_crypto2.default.randomUUID();
     if (contextLimit === 0) {
       return { messages: [], conversationId };
     }
@@ -6385,7 +6391,7 @@ var MemoryManager = class {
     try {
       if (typeof input === "string") {
         const userMessage = {
-          id: import_node_crypto.default.randomUUID(),
+          id: import_node_crypto2.default.randomUUID(),
           role: "user",
           parts: [{ type: "text", text: input }]
         };
@@ -6507,7 +6513,7 @@ var MemoryManager = class {
    * Perform semantic search with proper span hierarchy
    * Extracted from getMessages for clarity
    */
-  async performSemanticSearch(userId, conversationId, query, limit, logger, traceContext, parentMemorySpan) {
+  async performSemanticSearch(userId, conversationId, query, limit, semanticLimit, semanticThreshold, mergeStrategy, logger, traceContext, parentMemorySpan) {
     if (!this.conversationMemory?.hasVectorSupport?.()) {
       logger.debug("Vector support not available, falling back to regular retrieval");
       return this.conversationMemory?.getMessages(userId, conversationId, { limit }) || [];
@@ -6560,7 +6566,10 @@ var MemoryManager = class {
               limit,
               useSemanticSearch: true,
               currentQuery: query,
-              logger
+              logger,
+              semanticLimit,
+              semanticThreshold,
+              mergeStrategy
             });
           });
           traceContext.endChildSpan(vectorSpan, "completed", {
@@ -6584,7 +6593,10 @@ var MemoryManager = class {
       limit,
       useSemanticSearch: true,
       currentQuery: query,
-      logger
+      logger,
+      semanticLimit,
+      semanticThreshold,
+      mergeStrategy
     }) || [];
   }
   /**
@@ -7074,10 +7086,10 @@ __name(createTool, "createTool");
 var tool = createTool;
 
 // src/utils/message-converter.ts
-var crypto3 = __toESM(require("crypto"));
+var crypto4 = __toESM(require("crypto"));
 async function convertResponseMessagesToUIMessages(responseMessages) {
   const uiMessage = {
-    id: crypto3.randomUUID(),
+    id: crypto4.randomUUID(),
     role: "assistant",
     parts: []
   };
@@ -7205,7 +7217,7 @@ function convertModelMessagesToUIMessages(messages) {
         for (const part of message.content) {
           if (part.type === "tool-result") {
             uiMessages.push({
-              id: crypto3.randomUUID(),
+              id: crypto4.randomUUID(),
               role: "assistant",
               parts: [
                 {
@@ -7224,7 +7236,7 @@ function convertModelMessagesToUIMessages(messages) {
       continue;
     }
     const ui = {
-      id: crypto3.randomUUID(),
+      id: crypto4.randomUUID(),
       role: message.role,
       parts: []
     };
@@ -9374,7 +9386,7 @@ var Agent = class {
         });
         if (oc.userId && oc.conversationId) {
           const message = {
-            id: crypto4.randomUUID(),
+            id: crypto5.randomUUID(),
             role: "assistant",
             parts: [
               {
@@ -9385,7 +9397,7 @@ var Agent = class {
           };
           await this.memoryManager.saveMessage(oc, message, oc.userId, oc.conversationId);
           const step = {
-            id: crypto4.randomUUID(),
+            id: crypto5.randomUUID(),
             type: "text",
             content: (0, import_utils13.safeStringify)(result.object),
             role: "assistant",
@@ -9524,7 +9536,7 @@ var Agent = class {
           onFinish: /* @__PURE__ */ __name(async (finalResult) => {
             if (oc.userId && oc.conversationId) {
               const message = {
-                id: crypto4.randomUUID(),
+                id: crypto5.randomUUID(),
                 role: "assistant",
                 parts: [
                   {
@@ -9535,7 +9547,7 @@ var Agent = class {
               };
               await this.memoryManager.saveMessage(oc, message, oc.userId, oc.conversationId);
               const step = {
-                id: crypto4.randomUUID(),
+                id: crypto5.randomUUID(),
                 type: "text",
                 content: (0, import_utils13.safeStringify)(finalResult.object),
                 role: "assistant",
@@ -9633,7 +9645,7 @@ var Agent = class {
    * Transitional helper to gradually adopt OperationContext across methods
    */
   createOperationContext(input, options) {
-    const operationId = crypto4.randomUUID();
+    const operationId = crypto5.randomUUID();
     const startTimeDate = /* @__PURE__ */ new Date();
     const runtimeContext = toContextMap(options?.context);
     const context5 = new Map([
@@ -9790,7 +9802,7 @@ var Agent = class {
     const systemMessage = await this.getSystemMessage(input, oc, options);
     if (systemMessage) {
       const systemUIMessage = {
-        id: crypto4.randomUUID(),
+        id: crypto5.randomUUID(),
         role: "system",
         parts: [
           {
@@ -9809,8 +9821,8 @@ var Agent = class {
       const useSemanticSearch = options?.semanticMemory?.enabled ?? this.hasSemanticSearchSupport();
       const currentQuery = useSemanticSearch ? this.extractUserQuery(input) : void 0;
       const semanticLimit = options?.semanticMemory?.semanticLimit ?? 5;
-      const semanticThreshold = options?.semanticMemory?.semanticThreshold ?? 0;
-      const mergeStrategy = options?.semanticMemory?.mergeStrategy ?? "prepend";
+      const semanticThreshold = options?.semanticMemory?.semanticThreshold ?? 0.7;
+      const mergeStrategy = options?.semanticMemory?.mergeStrategy ?? "append";
       const isSemanticSearch = useSemanticSearch && currentQuery;
       const traceContext = oc.traceContext;
       if (traceContext) {
@@ -9869,7 +9881,7 @@ var Agent = class {
             }
           });
           if (isSemanticSearch && !oc.conversationId) {
-            oc.conversationId = crypto4.randomUUID();
+            oc.conversationId = crypto5.randomUUID();
           }
           messages.push(...memoryResult);
           if (isSemanticSearch && oc.userId && oc.conversationId) {
@@ -9889,7 +9901,7 @@ var Agent = class {
     }
     if (typeof input === "string") {
       messages.push({
-        id: crypto4.randomUUID(),
+        id: crypto5.randomUUID(),
         role: "user",
         parts: [{ type: "text", text: input }]
       });
@@ -10230,7 +10242,7 @@ ${toolkit.instructions}`;
             label: tool2.name,
             attributes: {
               "tool.name": tool2.name,
-              "tool.call.id": crypto4.randomUUID(),
+              "tool.call.id": crypto5.randomUUID(),
               input: args ? (0, import_utils13.safeStringify)(args) : void 0
             },
             kind: import_api8.SpanKind.CLIENT
@@ -11339,7 +11351,7 @@ var import_node_fs2 = __toESM(require("fs"));
 var import_node_path2 = __toESM(require("path"));
 
 // src/utils/update/cache.ts
-var import_node_crypto2 = __toESM(require("crypto"));
+var import_node_crypto3 = __toESM(require("crypto"));
 var import_node_fs = __toESM(require("fs"));
 var import_node_os = __toESM(require("os"));
 var import_node_path = __toESM(require("path"));
@@ -11374,7 +11386,7 @@ var getSystemCacheDir = /* @__PURE__ */ __name(() => {
 }, "getSystemCacheDir");
 var getCacheFilePath = /* @__PURE__ */ __name((projectPath) => {
   const normalizedPath = import_node_path.default.resolve(projectPath);
-  const projectHash = import_node_crypto2.default.createHash("sha256").update(normalizedPath).digest("hex").substring(0, 12);
+  const projectHash = import_node_crypto3.default.createHash("sha256").update(normalizedPath).digest("hex").substring(0, 12);
   const cacheDir = getSystemCacheDir();
   return import_node_path.default.join(cacheDir, `update-check-${projectHash}.json`);
 }, "getCacheFilePath");
@@ -11387,7 +11399,7 @@ var ensureCacheDir = /* @__PURE__ */ __name(() => {
 var getPackageJsonHash = /* @__PURE__ */ __name((packageJsonPath) => {
   try {
     const content = import_node_fs.default.readFileSync(packageJsonPath, "utf8");
-    return import_node_crypto2.default.createHash("md5").update(content).digest("hex");
+    return import_node_crypto3.default.createHash("md5").update(content).digest("hex");
   } catch (error) {
     const logger = new LoggerProxy({ component: "update-cache" });
     logger.error("Error reading package.json for hash", { error });