@voltagent/core 0.1.9 → 0.1.11

package/dist/index.d.ts

@@ -423,6 +423,7 @@ type ProviderOptions = {
     onFinish?: (result: unknown) => Promise<void>;
     onError?: (error: unknown) => Promise<void>;
     toolExecutionContext?: ToolExecutionContext;
+    [key: string]: unknown;
 };
 /**
  * Agent configuration options

package/dist/index.js

@@ -790,11 +790,17 @@ var AgentResponseSchema = import_zod.z.object({
 }).passthrough();
 var GenerateOptionsSchema = import_zod.z.object({
   userId: import_zod.z.string().optional().openapi({ description: "Optional user ID for context tracking" }),
-  conversationId: import_zod.z.string().optional().openapi({ description: "Optional conversation ID for context tracking" }),
-  contextLimit: import_zod.z.number().int().positive().optional().default(10).openapi({ description: "Optional limit for conversation history context" }),
+  conversationId: import_zod.z.string().optional().openapi({
+    description: "Optional conversation ID for context tracking"
+  }),
+  contextLimit: import_zod.z.number().int().positive().optional().default(10).openapi({
+    description: "Optional limit for conversation history context"
+  }),
   temperature: import_zod.z.number().min(0).max(1).optional().default(0.7).openapi({ description: "Controls randomness (0-1)" }),
-  maxTokens: import_zod.z.number().int().positive().optional().default(1024).openapi({ description: "Maximum tokens to generate" }),
-  topP: import_zod.z.number().min(0).max(1).optional().default(1).openapi({ description: "Controls diversity via nucleus sampling (0-1)" }),
+  maxTokens: import_zod.z.number().int().positive().optional().default(4e3).openapi({ description: "Maximum tokens to generate" }),
+  topP: import_zod.z.number().min(0).max(1).optional().default(1).openapi({
+    description: "Controls diversity via nucleus sampling (0-1)"
+  }),
   frequencyPenalty: import_zod.z.number().min(0).max(2).optional().default(0).openapi({ description: "Penalizes repeated tokens (0-2)" }),
   presencePenalty: import_zod.z.number().min(0).max(2).optional().default(0).openapi({ description: "Penalizes tokens based on presence (0-2)" }),
   seed: import_zod.z.number().int().optional().openapi({ description: "Optional seed for reproducible results" }),
@@ -802,13 +808,78 @@ var GenerateOptionsSchema = import_zod.z.object({
   extraOptions: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional().openapi({ description: "Provider-specific options" })
   // Add other relevant options from PublicGenerateOptions if known/needed for API exposure
 }).passthrough();
+var ContentPartSchema = import_zod.z.union([
+  import_zod.z.object({
+    // Text part
+    type: import_zod.z.literal("text"),
+    text: import_zod.z.string()
+  }).openapi({ example: { type: "text", text: "Hello there!" } }),
+  import_zod.z.object({
+    // Image part
+    type: import_zod.z.literal("image"),
+    image: import_zod.z.string().openapi({ description: "Base64 encoded image data or a URL" }),
+    mimeType: import_zod.z.string().optional().openapi({ example: "image/jpeg" }),
+    alt: import_zod.z.string().optional().openapi({ description: "Alternative text for the image" })
+  }).openapi({
+    example: {
+      type: "image",
+      image: "data:image/png;base64,...",
+      mimeType: "image/png"
+    }
+  }),
+  import_zod.z.object({
+    // File part
+    type: import_zod.z.literal("file"),
+    data: import_zod.z.string().openapi({ description: "Base64 encoded file data" }),
+    filename: import_zod.z.string().openapi({ example: "document.pdf" }),
+    mimeType: import_zod.z.string().openapi({ example: "application/pdf" }),
+    size: import_zod.z.number().optional().openapi({ description: "File size in bytes" })
+  }).openapi({
+    example: {
+      type: "file",
+      data: "...",
+      filename: "report.docx",
+      mimeType: "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+    }
+  })
+]);
+var MessageContentSchema = import_zod.z.union([
+  import_zod.z.string().openapi({ description: "Plain text content" }),
+  import_zod.z.array(ContentPartSchema).openapi({ description: "An array of content parts (text, image, file)." })
+]);
+var MessageObjectSchema = import_zod.z.object({
+  role: import_zod.z.string().openapi({
+    description: "Role of the sender (e.g., 'user', 'assistant')"
+  }),
+  content: MessageContentSchema
+  // Use the reusable content schema
+}).openapi({ description: "A message object with role and content" });
 var TextRequestSchema = import_zod.z.object({
-  input: import_zod.z.string().openapi({ description: "Input text for the agent", example: "Tell me a joke!" }),
+  input: import_zod.z.union([
+    import_zod.z.string().openapi({
+      description: "Input text for the agent",
+      example: "Tell me a joke!"
+    }),
+    import_zod.z.array(MessageObjectSchema).openapi({
+      description: "An array of message objects, representing the conversation history",
+      example: [
+        { role: "user", content: "What is the weather?" },
+        { role: "assistant", content: "The weather is sunny." },
+        { role: "user", content: [{ type: "text", text: "Thanks!" }] }
+      ]
+    })
+  ]),
   options: GenerateOptionsSchema.optional().openapi({
-    description: "Optional generation parameters"
+    description: "Optional generation parameters",
+    example: {
+      userId: "unique-user-id",
+      conversationId: "unique-conversation-id",
+      contextLimit: 10,
+      temperature: 0.7,
+      maxTokens: 100
+    }
   })
-  // Use GenerateOptionsSchema
-});
+}).openapi("TextGenerationRequest");
 var TextResponseSchema = import_zod.z.object({
   success: import_zod.z.literal(true),
   data: import_zod.z.string().openapi({ description: "Generated text response" })
@@ -822,34 +893,18 @@ var StreamTextEventSchema = import_zod.z.object({
   error: import_zod.z.string().optional()
 });
 var ObjectRequestSchema = import_zod.z.object({
-  input: import_zod.z.string().openapi({ description: "Input text for the agent", example: "Tell me a joke!" }),
-  schema: import_zod.z.object({}).passthrough().openapi({
-    description: "JSON schema describing the desired output object structure.",
-    example: {
-      type: "object",
-      properties: {
-        joke_setup: {
-          type: "string",
-          description: "The setup part of the joke"
-        },
-        punchline: {
-          type: "string",
-          description: "The punchline of the joke"
-        },
-        rating: {
-          type: "number",
-          description: "A rating of how funny the joke is from 1 to 5"
-        }
-      },
-      required: ["joke_setup", "punchline"]
-    }
+  input: import_zod.z.union([
+    import_zod.z.string().openapi({ description: "Input text prompt" }),
+    import_zod.z.array(MessageObjectSchema).openapi({ description: "Conversation history" })
+  ]),
+  schema: import_zod.z.any().openapi({
+    description: "The Zod schema for the desired object output (passed as JSON)"
   }),
-  // Expect a JSON Schema object
   options: GenerateOptionsSchema.optional().openapi({
-    description: "Optional generation parameters"
+    description: "Optional object generation parameters",
+    example: { temperature: 0.2 }
   })
-  // Use GenerateOptionsSchema
-});
+}).openapi("ObjectGenerationRequest");
 var ObjectResponseSchema = import_zod.z.object({
   success: import_zod.z.literal(true),
   data: import_zod.z.object({}).passthrough().openapi({ description: "Generated object response" })
@@ -1290,12 +1345,23 @@ app.openapi(streamRoute, (c) => __async(void 0, null, function* () {
   }
   try {
     let _a;
-    const { input, options = {} } = c.req.valid("json");
+    const {
+      input,
+      options = {
+        maxTokens: 4e3,
+        temperature: 0.7
+      }
+    } = c.req.valid("json");
     const stream = new ReadableStream({
       start(controller) {
         return __async(this, null, function* () {
           try {
-            const response = yield agent.streamText(input, __spreadValues({}, options));
+            const response = yield agent.streamText(input, __spreadProps(__spreadValues({}, options), {
+              provider: {
+                maxTokens: options.maxTokens,
+                temperature: options.temperature
+              }
+            }));
             try {
               for (var iter = __forAwait(response.textStream), more, temp, error; more = !(temp = yield iter.next()).done; more = false) {
                 const chunk = temp.value;
@@ -4903,21 +4969,10 @@ ${context}`;
         this.id,
         {
           input
-          // We now always use the input field (instead of message)
         },
         "agent",
         context
       );
-      this.createStandardTimelineEvent(
-        context.historyEntry.id,
-        "start",
-        initialStatus,
-        "agent" /* AGENT */,
-        this.id,
-        {},
-        "agent",
-        context
-      );
       return context;
     });
   }
@@ -4983,6 +5038,7 @@ ${context}`;
         parentAgentId: internalOptions.parentAgentId,
         parentHistoryEntryId: internalOptions.parentHistoryEntryId
       });
+      let messages = [];
       try {
         yield (_b = (_a = this.hooks).onStart) == null ? void 0 : _b.call(_a, { agent: this, context: operationContext });
         const { userId, conversationId, contextLimit = 10, provider, signal } = internalOptions;
@@ -4998,8 +5054,20 @@ ${context}`;
           historyEntryId: operationContext.historyEntry.id,
           contextMessages
         });
-        let messages = [systemMessage, ...contextMessages];
+        messages = [systemMessage, ...contextMessages];
         messages = yield this.formatInputMessages(messages, input);
+        this.createStandardTimelineEvent(
+          operationContext.historyEntry.id,
+          "start",
+          "working",
+          "agent" /* AGENT */,
+          this.id,
+          {
+            input: messages
+          },
+          "agent",
+          operationContext
+        );
         const onStepFinish = this.memoryManager.createStepFinishHandler(
           operationContext,
           userId,
@@ -5040,7 +5108,11 @@ ${context}`;
                 );
                 operationContext.eventUpdaters.set(step.id, eventUpdater);
                 if (tool2) {
-                  yield (_b2 = (_a2 = this.hooks).onToolStart) == null ? void 0 : _b2.call(_a2, { agent: this, tool: tool2, context: operationContext });
+                  yield (_b2 = (_a2 = this.hooks).onToolStart) == null ? void 0 : _b2.call(_a2, {
+                    agent: this,
+                    tool: tool2,
+                    context: operationContext
+                  });
                 }
               }
             } else if (step.type === "tool_result") {
@@ -5083,6 +5155,7 @@ ${context}`;
           status: "completed"
         });
         this.addAgentEvent(operationContext, "finished", "completed", {
+          input: messages,
           output: response.text,
           usage: response.usage,
           affectedNodeId: `agent_${this.id}`,
@@ -5111,6 +5184,7 @@ ${context}`;
         const voltagentError = error;
         operationContext.eventUpdaters.clear();
         this.addAgentEvent(operationContext, "finished", "error", {
+          input: messages,
           error: voltagentError,
           errorMessage: voltagentError.message,
           affectedNodeId: `agent_${this.id}`,
@@ -5164,6 +5238,18 @@ ${context}`;
       });
       let messages = [systemMessage, ...contextMessages];
       messages = yield this.formatInputMessages(messages, input);
+      this.createStandardTimelineEvent(
+        operationContext.historyEntry.id,
+        "start",
+        "working",
+        "agent" /* AGENT */,
+        this.id,
+        {
+          input: messages
+        },
+        "agent",
+        operationContext
+      );
       const onStepFinish = this.memoryManager.createStepFinishHandler(
         operationContext,
         userId,
@@ -5180,6 +5266,7 @@ ${context}`;
         maxSteps,
         tools,
         signal,
+        provider,
         toolExecutionContext: {
           operationContext,
           agentId: this.id,
@@ -5202,7 +5289,11 @@ ${context}`;
               );
               operationContext.eventUpdaters.set(chunk.id, eventUpdater);
               if (tool2) {
-                yield (_b2 = (_a2 = this.hooks).onToolStart) == null ? void 0 : _b2.call(_a2, { agent: this, tool: tool2, context: operationContext });
+                yield (_b2 = (_a2 = this.hooks).onToolStart) == null ? void 0 : _b2.call(_a2, {
+                  agent: this,
+                  tool: tool2,
+                  context: operationContext
+                });
               }
             }
           } else if (chunk.type === "tool_result") {
@@ -5244,6 +5335,9 @@ ${context}`;
         }),
         onFinish: (result) => __async(this, null, function* () {
           var _a2, _b2;
+          if (!operationContext.isActive) {
+            return;
+          }
           operationContext.eventUpdaters.clear();
           this.updateHistoryEntry(operationContext, {
             output: result.text,
@@ -5253,6 +5347,7 @@ ${context}`;
             status: "completed"
           });
           this.addAgentEvent(operationContext, "finished", "completed", {
+            input: messages,
             output: result.text,
             usage: result.usage,
             affectedNodeId: `agent_${this.id}`,
@@ -5315,6 +5410,7 @@ ${context}`;
             errorMessage: error.message,
             // Use the main message
             affectedNodeId: `agent_${this.id}`,
+            input: messages,
             status: "error",
             metadata: __spreadValues({
               // Include metadata if available
@@ -5356,6 +5452,7 @@ ${context}`;
         parentAgentId: internalOptions.parentAgentId,
         parentHistoryEntryId: internalOptions.parentHistoryEntryId
       });
+      let messages = [];
       try {
         yield (_b = (_a = this.hooks).onStart) == null ? void 0 : _b.call(_a, { agent: this, context: operationContext });
         const { userId, conversationId, contextLimit = 10, provider, signal } = internalOptions;
@@ -5371,8 +5468,20 @@ ${context}`;
           historyEntryId: operationContext.historyEntry.id,
           contextMessages
         });
-        let messages = [systemMessage, ...contextMessages];
+        messages = [systemMessage, ...contextMessages];
         messages = yield this.formatInputMessages(messages, input);
+        this.createStandardTimelineEvent(
+          operationContext.historyEntry.id,
+          "start",
+          "working",
+          "agent" /* AGENT */,
+          this.id,
+          {
+            input: messages
+          },
+          "agent",
+          operationContext
+        );
         const onStepFinish = this.memoryManager.createStepFinishHandler(
           operationContext,
           userId,
@@ -5383,6 +5492,7 @@ ${context}`;
           model: this.model,
           schema,
           signal,
+          provider,
           toolExecutionContext: {
             operationContext,
             agentId: this.id,
@@ -5401,7 +5511,8 @@ ${context}`;
           output: responseStr,
           usage: response.usage,
           affectedNodeId: `agent_${this.id}`,
-          status: "completed"
+          status: "completed",
+          input: messages
         });
         this.updateHistoryEntry(operationContext, {
           output: responseStr,
@@ -5433,6 +5544,7 @@ ${context}`;
           // Use the standardized message
           affectedNodeId: `agent_${this.id}`,
           status: "error",
+          input: messages,
           metadata: __spreadValues({
             // Include detailed metadata from VoltAgentError
             code: voltagentError.code,
@@ -5468,6 +5580,7 @@ ${context}`;
         parentAgentId: internalOptions.parentAgentId,
         parentHistoryEntryId: internalOptions.parentHistoryEntryId
       });
+      let messages = [];
       try {
         yield (_b = (_a = this.hooks).onStart) == null ? void 0 : _b.call(_a, { agent: this, context: operationContext });
         const { userId, conversationId, contextLimit = 10, signal } = internalOptions;
@@ -5483,8 +5596,20 @@ ${context}`;
           historyEntryId: operationContext.historyEntry.id,
           contextMessages
         });
-        let messages = [systemMessage, ...contextMessages];
+        messages = [systemMessage, ...contextMessages];
         messages = yield this.formatInputMessages(messages, input);
+        this.createStandardTimelineEvent(
+          operationContext.historyEntry.id,
+          "start",
+          "working",
+          "agent" /* AGENT */,
+          this.id,
+          {
+            input: messages
+          },
+          "agent",
+          operationContext
+        );
         const onStepFinish = this.memoryManager.createStepFinishHandler(
           operationContext,
           userId,
@@ -5494,6 +5619,7 @@ ${context}`;
           messages,
           model: this.model,
           schema,
+          provider,
           signal,
           toolExecutionContext: {
             operationContext,
@@ -5509,8 +5635,12 @@ ${context}`;
           }),
           onFinish: (result) => __async(this, null, function* () {
             var _a2, _b2;
+            if (!operationContext.isActive) {
+              return;
+            }
             const responseStr = JSON.stringify(result.object);
             this.addAgentEvent(operationContext, "finished", "completed", {
+              input: messages,
               output: responseStr,
               usage: result.usage,
               affectedNodeId: `agent_${this.id}`,
@@ -5578,6 +5708,7 @@ ${context}`;
             }
             operationContext.eventUpdaters.clear();
             this.addAgentEvent(operationContext, "finished", "error", {
+              input: messages,
               error,
               errorMessage: error.message,
               affectedNodeId: `agent_${this.id}`,
@@ -5609,6 +5740,7 @@ ${context}`;
         return typedResponse;
       } catch (error) {
         this.addAgentEvent(operationContext, "finished", "error", {
+          input: messages,
           error,
           errorMessage: error instanceof Error ? error.message : "Unknown error",
           affectedNodeId: `agent_${this.id}`,