@voltagent/core 0.1.16 → 0.1.18

package/dist/index.d.ts

@@ -35,6 +35,14 @@ type Toolkit = {
      */
     tools: Tool<ToolSchema>[];
 };
+/**
+ * Helper function for creating a new toolkit.
+ * Provides default values and ensures the basic structure is met.
+ *
+ * @param options - The configuration options for the toolkit.
+ * @returns A Toolkit object.
+ */
+declare const createToolkit: (options: Toolkit) => Toolkit;
 
 /**
  * Status of a tool at any given time
@@ -457,6 +465,10 @@ type AgentOptions = {
      * Sub-agents that this agent can delegate tasks to
      */
     subAgents?: any[];
+    /**
+     * Optional user-defined context to be passed around
+     */
+    userContext?: Map<string | symbol, unknown>;
 } & ({
     /**
      * @deprecated Use `instructions` instead.
@@ -528,6 +540,7 @@ interface CommonGenerateOptions {
     signal?: AbortSignal;
     historyEntryId?: string;
     operationContext?: OperationContext;
+    userContext?: Map<string | symbol, unknown>;
 }
 /**
  * Public-facing generate options for external users
@@ -623,6 +636,10 @@ type AgentHandoffOptions = {
      * Parent history entry ID
      */
     parentHistoryEntryId?: string;
+    /**
+     * Optional user-defined context to be passed from the supervisor agent
+     */
+    userContext?: Map<string | symbol, unknown>;
 };
 /**
  * Result of a handoff to another agent
@@ -1805,6 +1822,7 @@ declare class SubAgentManager {
      */
     handoffToMultiple(options: Omit<AgentHandoffOptions, "targetAgent"> & {
         targetAgents: Agent<any>[];
+        userContext?: Map<string | symbol, unknown>;
     }): Promise<AgentHandoffResult[]>;
     /**
      * Create a delegate tool for sub-agents
@@ -2975,4 +2993,4 @@ declare class VoltAgent {
     shutdownTelemetry(): Promise<void>;
 }
 
-export { Agent, AgentHistoryEntry, AgentHookOnEnd, AgentHookOnHandoff, AgentHookOnStart, AgentHookOnToolEnd, AgentHookOnToolStart, AgentHooks, AgentOptions, AgentRegistry, AgentResponse, AgentTool, AllowedVariableValue, AnyToolConfig, BaseLLMOptions, BaseMessage, BaseRetriever, BaseTool, BaseToolCall, ClientInfo, Conversation, CreateConversationInput, CreateReasoningToolsOptions, DEFAULT_INSTRUCTIONS, DataContent, ExtractVariableNames, FEW_SHOT_EXAMPLES, FilePart, GenerateObjectOptions, GenerateTextOptions, HTTPServerConfig, ImagePart, InMemoryStorage, InferGenerateObjectResponse, InferGenerateTextResponse, InferMessage, InferModel, InferProviderParams, InferStreamResponse, InferTool, LLMProvider, LibSQLStorage, MCPClient, MCPClientConfig, MCPClientEvents, MCPConfiguration, MCPOptions, MCPServerConfig, MCPToolCall, MCPToolResult, Memory, MemoryManager, MemoryMessage, MemoryOptions, MessageContent, MessageFilterOptions, MessageRole, ModelToolCall, NextAction, NodeType, OnEndHookArgs, OnHandoffHookArgs, OnStartHookArgs, OnToolEndHookArgs, OnToolStartHookArgs, OperationContext, PackageUpdateInfo, PromptCreator, PromptTemplate, ProviderObjectResponse, ProviderObjectStreamResponse, ProviderParams, ProviderResponse, ProviderTextResponse, ProviderTextStreamResponse, ReadableStreamType, ReasoningStep, ReasoningStepSchema, ReasoningToolExecuteOptions, Retriever, RetrieverOptions, RetryConfig, StdioServerConfig, StepChunkCallback, StepFinishCallback, StepWithContent, StreamObjectFinishResult, StreamObjectOnFinishCallback, StreamObjectOptions, StreamTextFinishResult, StreamTextOnFinishCallback, StreamTextOptions, TemplateVariables, TextPart, Tool, ToolCall, ToolErrorInfo, ToolExecuteOptions, ToolExecutionContext, ToolManager, ToolOptions, ToolSchema, ToolStatus, ToolStatusInfo, Toolkit, ToolsetMap, ToolsetWithTools, TransportError, UsageInfo, Voice, VoiceEventData, VoiceEventType, VoiceMetadata, VoiceOptions, VoltAgent, VoltAgentError, checkForUpdates, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createTool, VoltAgent as default, getNodeTypeFromNodeId, serializeValueForDebug, tool, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
+export { Agent, AgentHistoryEntry, AgentHookOnEnd, AgentHookOnHandoff, AgentHookOnStart, AgentHookOnToolEnd, AgentHookOnToolStart, AgentHooks, AgentOptions, AgentRegistry, AgentResponse, AgentTool, AllowedVariableValue, AnyToolConfig, BaseLLMOptions, BaseMessage, BaseRetriever, BaseTool, BaseToolCall, ClientInfo, Conversation, CreateConversationInput, CreateReasoningToolsOptions, DEFAULT_INSTRUCTIONS, DataContent, ExtractVariableNames, FEW_SHOT_EXAMPLES, FilePart, GenerateObjectOptions, GenerateTextOptions, HTTPServerConfig, ImagePart, InMemoryStorage, InferGenerateObjectResponse, InferGenerateTextResponse, InferMessage, InferModel, InferProviderParams, InferStreamResponse, InferTool, LLMProvider, LibSQLStorage, MCPClient, MCPClientConfig, MCPClientEvents, MCPConfiguration, MCPOptions, MCPServerConfig, MCPToolCall, MCPToolResult, Memory, MemoryManager, MemoryMessage, MemoryOptions, MessageContent, MessageFilterOptions, MessageRole, ModelToolCall, NextAction, NodeType, OnEndHookArgs, OnHandoffHookArgs, OnStartHookArgs, OnToolEndHookArgs, OnToolStartHookArgs, OperationContext, PackageUpdateInfo, PromptCreator, PromptTemplate, ProviderObjectResponse, ProviderObjectStreamResponse, ProviderParams, ProviderResponse, ProviderTextResponse, ProviderTextStreamResponse, ReadableStreamType, ReasoningStep, ReasoningStepSchema, ReasoningToolExecuteOptions, Retriever, RetrieverOptions, RetryConfig, StdioServerConfig, StepChunkCallback, StepFinishCallback, StepWithContent, StreamObjectFinishResult, StreamObjectOnFinishCallback, StreamObjectOptions, StreamTextFinishResult, StreamTextOnFinishCallback, StreamTextOptions, TemplateVariables, TextPart, Tool, ToolCall, ToolErrorInfo, ToolExecuteOptions, ToolExecutionContext, ToolManager, ToolOptions, ToolSchema, ToolStatus, ToolStatusInfo, Toolkit, ToolsetMap, ToolsetWithTools, TransportError, UsageInfo, Voice, VoiceEventData, VoiceEventType, VoiceMetadata, VoiceOptions, VoltAgent, VoltAgentError, checkForUpdates, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createTool, createToolkit, VoltAgent as default, getNodeTypeFromNodeId, serializeValueForDebug, tool, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };

package/dist/index.js

@@ -112,6 +112,7 @@ __export(src_exports, {
   createReasoningTools: () => createReasoningTools,
   createRetrieverTool: () => createRetrieverTool,
   createTool: () => createTool,
+  createToolkit: () => createToolkit,
   default: () => src_default,
   getNodeTypeFromNodeId: () => getNodeTypeFromNodeId,
   serializeValueForDebug: () => serializeValueForDebug,
@@ -3959,6 +3960,26 @@ var ToolManager = class {
 };
 __name(ToolManager, "ToolManager");
 
+// src/tool/toolkit.ts
+var createToolkit = /* @__PURE__ */ __name((options) => {
+  if (!options.name) {
+    throw new Error("Toolkit name is required");
+  }
+  if (!options.tools || options.tools.length === 0) {
+    console.warn(`Toolkit '${options.name}' created without any tools.`);
+  }
+  return {
+    name: options.name,
+    description: options.description || "",
+    // Default empty description
+    instructions: options.instructions,
+    addInstructions: options.addInstructions || false,
+    // Default to false
+    tools: options.tools || []
+    // Default to empty array if not provided (though warned above)
+  };
+}, "createToolkit");
+
 // src/tool/index.ts
 var Tool = class {
   /**
@@ -4380,7 +4401,8 @@ ${agentsMemory || "No previous agent interactions available."}
         userId,
         sourceAgent,
         parentAgentId,
-        parentHistoryEntryId
+        parentHistoryEntryId,
+        userContext
       } = options;
       const handoffConversationId = conversationId || crypto.randomUUID();
       try {
@@ -4398,7 +4420,8 @@ Context: ${JSON.stringify(context)}`
           conversationId: handoffConversationId,
           userId,
           parentAgentId: (sourceAgent == null ? void 0 : sourceAgent.id) || parentAgentId,
-          parentHistoryEntryId
+          parentHistoryEntryId,
+          userContext
         });
         return {
           result: response.text,
@@ -4429,7 +4452,19 @@ Context: ${JSON.stringify(context)}`
    */
   handoffToMultiple(options) {
     return __async(this, null, function* () {
-      const _a = options, { targetAgents, conversationId, parentAgentId, parentHistoryEntryId } = _a, restOptions = __objRest(_a, ["targetAgents", "conversationId", "parentAgentId", "parentHistoryEntryId"]);
+      const _a = options, {
+        targetAgents,
+        conversationId,
+        parentAgentId,
+        parentHistoryEntryId,
+        userContext
+      } = _a, restOptions = __objRest(_a, [
+        "targetAgents",
+        "conversationId",
+        "parentAgentId",
+        "parentHistoryEntryId",
+        "userContext"
+      ]);
       const handoffConversationId = conversationId || crypto.randomUUID();
       const results = yield Promise.all(
         targetAgents.map((agent) => __async(this, null, function* () {
@@ -4438,7 +4473,8 @@ Context: ${JSON.stringify(context)}`
               targetAgent: agent,
               conversationId: handoffConversationId,
               parentAgentId,
-              parentHistoryEntryId
+              parentHistoryEntryId,
+              userContext
             }));
           } catch (error) {
             console.error(`Error in handoffToMultiple for agent ${agent.name}:`, error);
@@ -4497,6 +4533,8 @@ Context: ${JSON.stringify(context)}`
             );
           }
           const sourceAgent = options.sourceAgent;
+          const operationContext = options.operationContext;
+          const supervisorUserContext = operationContext == null ? void 0 : operationContext.userContext;
           const currentHistoryEntryId = options.currentHistoryEntryId;
           const results = yield this.handoffToMultiple(__spreadValues({
             task,
@@ -4505,7 +4543,9 @@ Context: ${JSON.stringify(context)}`
             sourceAgent,
             // Pass parent context for event propagation
             parentAgentId: sourceAgent == null ? void 0 : sourceAgent.id,
-            parentHistoryEntryId: currentHistoryEntryId
+            parentHistoryEntryId: currentHistoryEntryId,
+            // Pass the supervisor's userContext to the handoff options
+            userContext: supervisorUserContext
           }, options));
           return results.map((result, index) => {
             const status = result.status || "success";
@@ -5137,7 +5177,7 @@ ${context}`;
       });
       const opContext = {
         operationId: historyEntry.id,
-        userContext: /* @__PURE__ */ new Map(),
+        userContext: options.userContext ? new Map(options.userContext) : /* @__PURE__ */ new Map(),
         historyEntry,
         eventUpdaters: /* @__PURE__ */ new Map(),
         isActive: true,
@@ -5240,12 +5280,14 @@ ${context}`;
         conversationId: initialConversationId,
         parentAgentId,
         parentHistoryEntryId,
-        contextLimit = 10
+        contextLimit = 10,
+        userContext
       } = internalOptions;
       const operationContext = yield this.initializeHistory(input, "working", {
         parentAgentId,
         parentHistoryEntryId,
-        operationName: "generateText"
+        operationName: "generateText",
+        userContext
       });
       const { messages: contextMessages, conversationId: finalConversationId } = yield this.memoryManager.prepareConversationContext(
         operationContext,
@@ -5438,12 +5480,14 @@ ${context}`;
         conversationId: initialConversationId,
         parentAgentId,
         parentHistoryEntryId,
-        contextLimit = 10
+        contextLimit = 10,
+        userContext
       } = internalOptions;
       const operationContext = yield this.initializeHistory(input, "working", {
         parentAgentId,
         parentHistoryEntryId,
-        operationName: "streamText"
+        operationName: "streamText",
+        userContext
       });
       const { messages: contextMessages, conversationId: finalConversationId } = yield this.memoryManager.prepareConversationContext(
         operationContext,
@@ -5687,12 +5731,14 @@ ${context}`;
         conversationId: initialConversationId,
         parentAgentId,
         parentHistoryEntryId,
-        contextLimit = 10
+        contextLimit = 10,
+        userContext
       } = internalOptions;
       const operationContext = yield this.initializeHistory(input, "working", {
         parentAgentId,
         parentHistoryEntryId,
-        operationName: "generateObject"
+        operationName: "generateObject",
+        userContext
       });
       const { messages: contextMessages, conversationId: finalConversationId } = yield this.memoryManager.prepareConversationContext(
         operationContext,
@@ -5823,12 +5869,14 @@ ${context}`;
         parentAgentId,
         parentHistoryEntryId,
         provider,
-        contextLimit = 10
+        contextLimit = 10,
+        userContext
       } = internalOptions;
       const operationContext = yield this.initializeHistory(input, "working", {
         parentAgentId,
         parentHistoryEntryId,
-        operationName: "streamObject"
+        operationName: "streamObject",
+        userContext
       });
       const { messages: contextMessages, conversationId: finalConversationId } = yield this.memoryManager.prepareConversationContext(
         operationContext,
@@ -6209,26 +6257,6 @@ var analyzeTool = createTool({
   })
 });
 
-// src/tool/toolkit.ts
-var createToolkit = /* @__PURE__ */ __name((options) => {
-  if (!options.name) {
-    throw new Error("Toolkit name is required");
-  }
-  if (!options.tools || options.tools.length === 0) {
-    console.warn(`Toolkit '${options.name}' created without any tools.`);
-  }
-  return {
-    name: options.name,
-    description: options.description || "",
-    // Default empty description
-    instructions: options.instructions,
-    addInstructions: options.addInstructions || false,
-    // Default to false
-    tools: options.tools || []
-    // Default to empty array if not provided (though warned above)
-  };
-}, "createToolkit");
-
 // src/tool/reasoning/index.ts
 var DEFAULT_INSTRUCTIONS = `
 You are equipped with 'think' and 'analyze' capabilities to methodically tackle problems and organize your reasoning process. ALWAYS utilize 'think' before initiating any tool calls or formulating a response.
@@ -7140,6 +7168,7 @@ if (typeof require !== "undefined" && typeof module !== "undefined" && require.m
   createReasoningTools,
   createRetrieverTool,
   createTool,
+  createToolkit,
   getNodeTypeFromNodeId,
   serializeValueForDebug,
   tool,