@voltagent/core 2.3.6 → 2.3.8

package/dist/index.d.mts

@@ -1552,6 +1552,8 @@ interface WorkflowRunQuery {
     to?: Date;
     limit?: number;
     offset?: number;
+    userId?: string;
+    metadata?: Record<string, unknown>;
 }
 /**
  * Working memory scope - conversation or user level
@@ -2808,6 +2810,8 @@ interface ManagedMemoryQueryWorkflowRunsInput {
     to?: Date;
     limit?: number;
     offset?: number;
+    userId?: string;
+    metadata?: Record<string, unknown>;
 }
 interface ManagedMemoryWorkflowStateUpdateInput {
     executionId: string;
@@ -9229,6 +9233,7 @@ declare class Agent {
      * Enrich instructions with additional context and modifiers
      */
     private enrichInstructions;
+    private extractToolkits;
     /**
      * Prepare agents memory for supervisor
      */
@@ -14526,14 +14531,7 @@ declare class InMemoryStorageAdapter implements StorageAdapter {
     /**
      * Query workflow states with optional filters
      */
-    queryWorkflowRuns(query: {
-        workflowId?: string;
-        status?: WorkflowStateEntry["status"];
-        from?: Date;
-        to?: Date;
-        limit?: number;
-        offset?: number;
-    }): Promise<WorkflowStateEntry[]>;
+    queryWorkflowRuns(query: WorkflowRunQuery): Promise<WorkflowStateEntry[]>;
     /**
      * Set workflow state
      */

package/dist/index.d.ts

@@ -1552,6 +1552,8 @@ interface WorkflowRunQuery {
     to?: Date;
     limit?: number;
     offset?: number;
+    userId?: string;
+    metadata?: Record<string, unknown>;
 }
 /**
  * Working memory scope - conversation or user level
@@ -2808,6 +2810,8 @@ interface ManagedMemoryQueryWorkflowRunsInput {
     to?: Date;
     limit?: number;
     offset?: number;
+    userId?: string;
+    metadata?: Record<string, unknown>;
 }
 interface ManagedMemoryWorkflowStateUpdateInput {
     executionId: string;
@@ -9229,6 +9233,7 @@ declare class Agent {
      * Enrich instructions with additional context and modifiers
      */
     private enrichInstructions;
+    private extractToolkits;
     /**
      * Prepare agents memory for supervisor
      */
@@ -14526,14 +14531,7 @@ declare class InMemoryStorageAdapter implements StorageAdapter {
     /**
      * Query workflow states with optional filters
      */
-    queryWorkflowRuns(query: {
-        workflowId?: string;
-        status?: WorkflowStateEntry["status"];
-        from?: Date;
-        to?: Date;
-        limit?: number;
-        offset?: number;
-    }): Promise<WorkflowStateEntry[]>;
+    queryWorkflowRuns(query: WorkflowRunQuery): Promise<WorkflowStateEntry[]>;
     /**
      * Set workflow state
      */

package/dist/index.js

@@ -6046,6 +6046,42 @@ Remember:
 
 // src/memory/adapters/storage/in-memory.ts
 var import_utils16 = require("@voltagent/internal/utils");
+function areMetadataValuesEqual(left, right) {
+  if (Object.is(left, right)) {
+    return true;
+  }
+  if (typeof left !== "object" || left === null || typeof right !== "object" || right === null) {
+    return false;
+  }
+  if (Array.isArray(left) || Array.isArray(right)) {
+    if (!Array.isArray(left) || !Array.isArray(right) || left.length !== right.length) {
+      return false;
+    }
+    for (let index = 0; index < left.length; index++) {
+      if (!areMetadataValuesEqual(left[index], right[index])) {
+        return false;
+      }
+    }
+    return true;
+  }
+  const leftRecord = left;
+  const rightRecord = right;
+  const leftKeys = Object.keys(leftRecord);
+  const rightKeys = Object.keys(rightRecord);
+  if (leftKeys.length !== rightKeys.length) {
+    return false;
+  }
+  for (const key of leftKeys) {
+    if (!Object.prototype.hasOwnProperty.call(rightRecord, key)) {
+      return false;
+    }
+    if (!areMetadataValuesEqual(leftRecord[key], rightRecord[key])) {
+      return false;
+    }
+  }
+  return true;
+}
+__name(areMetadataValuesEqual, "areMetadataValuesEqual");
 var InMemoryStorageAdapter = class {
   static {
     __name(this, "InMemoryStorageAdapter");
@@ -6426,6 +6462,20 @@ var InMemoryStorageAdapter = class {
       if (query.to && state.createdAt > query.to) {
         return false;
       }
+      if (query.userId && state.userId !== query.userId) {
+        return false;
+      }
+      if (query.metadata) {
+        const stateMetadata = state.metadata ?? {};
+        for (const [key, value] of Object.entries(query.metadata)) {
+          if (!Object.prototype.hasOwnProperty.call(stateMetadata, key)) {
+            return false;
+          }
+          if (!areMetadataValuesEqual(stateMetadata[key], value)) {
+            return false;
+          }
+        }
+      }
       return true;
     }).sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
     const start = query.offset ?? 0;
@@ -9065,8 +9115,8 @@ var WorkflowRegistry = class _WorkflowRegistry extends SimpleEventEmitter {
     this.logger.trace(`Added suspension controller for resumed execution ${executionId}`);
     const resumeOptions = {
       executionId,
-      userId: workflowState.metadata?.userId,
-      conversationId: workflowState.metadata?.conversationId,
+      userId: workflowState.userId ?? workflowState.metadata?.userId,
+      conversationId: workflowState.conversationId ?? workflowState.metadata?.conversationId,
       suspendController,
       resumeFrom: {
         executionId,
@@ -9089,7 +9139,10 @@ var WorkflowRegistry = class _WorkflowRegistry extends SimpleEventEmitter {
     }
     this.logger.debug(`Resuming workflow from step ${resumeOptions.resumeFrom.resumeStepIndex}`);
     try {
-      const inputToUse = workflowState.input;
+      const workflowStartEventInput = workflowState.events?.find(
+        (event) => event.type === "workflow-start"
+      )?.input;
+      const inputToUse = workflowState.input ?? workflowStartEventInput;
       if (resumeData !== void 0) {
         resumeOptions.resumeFrom = {
           ...resumeOptions.resumeFrom,
@@ -9705,6 +9758,8 @@ function createWorkflow({
           input: input2,
           context: options?.context ? Array.from(options.context.entries()) : void 0,
           workflowState: workflowStateStore,
+          userId: options?.userId,
+          conversationId: options?.conversationId,
           metadata: {
             traceId: rootSpan.spanContext().traceId,
             spanId: rootSpan.spanContext().spanId
@@ -16508,13 +16563,21 @@ var VoltOpsClient = class _VoltOpsClient {
     }
   }
   async getManagedMemoryWorkflowStates(databaseId, input) {
+    const metadataQueryParams = input.metadata && Object.keys(input.metadata).length > 0 ? Object.fromEntries(
+      Object.entries(input.metadata).map(([key, value]) => [
+        `metadata.${key}`,
+        value === null ? "null" : typeof value === "string" ? value : typeof value === "number" || typeof value === "boolean" ? String(value) : (0, import_internal7.safeStringify)(value)
+      ])
+    ) : void 0;
     const query = this.buildQueryString({
       workflowId: input.workflowId,
       status: input.status,
       from: input.from?.toISOString(),
       to: input.to?.toISOString(),
       limit: input.limit,
-      offset: input.offset
+      offset: input.offset,
+      userId: input.userId,
+      ...metadataQueryParams ?? {}
     });
     const payload = await this.request("GET", `/managed-memory/projects/databases/${databaseId}/workflow-states${query}`);
     if (!payload?.success) {
@@ -29958,8 +30021,12 @@ Metadata: ${(0, import_utils33.safeStringify)(metadata)}`;
    * Common preparation for all execution methods
    */
   async prepareExecution(input, oc, options) {
+    const dynamicToolList = await this.resolveValue(this.dynamicTools, oc) || [];
+    const optionToolsArray = options?.tools || [];
+    const adHocTools = [...dynamicToolList, ...optionToolsArray];
+    const runtimeToolkits = this.extractToolkits(adHocTools);
     const buffer = this.getConversationBuffer(oc);
-    const uiMessages = await this.prepareMessages(input, oc, options, buffer);
+    const uiMessages = await this.prepareMessages(input, oc, options, buffer, runtimeToolkits);
     const hooks = this.getMergedHooks(options);
     let messages = await (0, import_ai7.convertToModelMessages)(uiMessages);
     if (hooks.onPrepareModelMessages) {
@@ -29976,9 +30043,6 @@ Metadata: ${(0, import_utils33.safeStringify)(metadata)}`;
     messages = stripDanglingOpenAIReasoningFromModelMessages(messages);
     const maxSteps = options?.maxSteps ?? this.calculateMaxSteps();
     const modelName = this.getModelName();
-    const dynamicToolList = await this.resolveValue(this.dynamicTools, oc) || [];
-    const optionToolsArray = options?.tools || [];
-    const adHocTools = [...dynamicToolList, ...optionToolsArray];
     const tools = await this.prepareTools(adHocTools, oc, maxSteps, options);
     return {
       messages,
@@ -30549,10 +30613,10 @@ Metadata: ${(0, import_utils33.safeStringify)(metadata)}`;
    * Prepare messages with system prompt and memory
    */
   // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: legacy message preparation pipeline
-  async prepareMessages(input, oc, options, buffer) {
+  async prepareMessages(input, oc, options, buffer, runtimeToolkits = []) {
     const resolvedInput = await this.validateIncomingUIMessages(input, oc);
     const messages = [];
-    const systemMessage = await this.getSystemMessage(resolvedInput, oc, options);
+    const systemMessage = await this.getSystemMessage(resolvedInput, oc, options, runtimeToolkits);
     if (systemMessage) {
       const systemMessagesAsUI = (() => {
         if (typeof systemMessage === "string") {
@@ -30747,7 +30811,7 @@ Metadata: ${(0, import_utils33.safeStringify)(metadata)}`;
    * Get system message with dynamic instructions and retriever context
    */
   // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: legacy system message assembly
-  async getSystemMessage(input, oc, options) {
+  async getSystemMessage(input, oc, options, runtimeToolkits = []) {
     const promptHelper = VoltOpsClient.createPromptHelperWithFallback(
       this.id,
       this.name,
@@ -30872,7 +30936,8 @@ ${additionalContext}`
           baseContent2,
           retrieverContext,
           workingMemoryContext,
-          oc
+          oc,
+          runtimeToolkits
         );
         return {
           role: "system",
@@ -30885,7 +30950,8 @@ ${additionalContext}`
       baseContent,
       retrieverContext,
       workingMemoryContext,
-      oc
+      oc,
+      runtimeToolkits
     );
     return {
       role: "system",
@@ -30895,8 +30961,30 @@ ${additionalContext}`
   /**
    * Add toolkit instructions
    */
-  addToolkitInstructions(baseInstructions) {
-    const toolkits = this.toolManager.getToolkits();
+  addToolkitInstructions(baseInstructions, runtimeToolkits = []) {
+    const toolkits = this.toolManager.getToolkits().map((toolkit) => ({
+      name: toolkit.name,
+      instructions: toolkit.instructions,
+      addInstructions: toolkit.addInstructions
+    }));
+    const toolkitIndexByName = /* @__PURE__ */ new Map();
+    for (const [index, toolkit] of toolkits.entries()) {
+      toolkitIndexByName.set(toolkit.name, index);
+    }
+    for (const runtimeToolkit of runtimeToolkits) {
+      const runtimeToolkitSource = {
+        name: runtimeToolkit.name,
+        instructions: runtimeToolkit.instructions,
+        addInstructions: runtimeToolkit.addInstructions
+      };
+      const existingIndex = toolkitIndexByName.get(runtimeToolkit.name);
+      if (existingIndex === void 0) {
+        toolkitIndexByName.set(runtimeToolkit.name, toolkits.length);
+        toolkits.push(runtimeToolkitSource);
+        continue;
+      }
+      toolkits[existingIndex] = runtimeToolkitSource;
+    }
     let toolInstructions = "";
     for (const toolkit of toolkits) {
       if (toolkit.addInstructions && toolkit.instructions) {
@@ -30910,9 +30998,9 @@ ${toolkit.instructions}`;
   /**
    * Enrich instructions with additional context and modifiers
    */
-  async enrichInstructions(baseContent, retrieverContext, workingMemoryContext, oc) {
+  async enrichInstructions(baseContent, retrieverContext, workingMemoryContext, oc, runtimeToolkits = []) {
     let content = baseContent;
-    content = this.addToolkitInstructions(content);
+    content = this.addToolkitInstructions(content, runtimeToolkits);
     if (this.markdown) {
       content = `${content}
 
@@ -30937,6 +31025,11 @@ ${retrieverContext}`;
     }
     return content;
   }
+  extractToolkits(items) {
+    return items.filter(
+      (item) => typeof item === "object" && item !== null && "tools" in item && Array.isArray(item.tools)
+    );
+  }
   /**
    * Prepare agents memory for supervisor
    */