@voltagent/core 1.2.13 → 1.2.15

package/dist/index.js

@@ -253,7 +253,7 @@ __export(index_exports, {
   context: () => import_api8.context,
   convertUsage: () => convertUsage,
   cosineSimilarity: () => cosineSimilarity,
-  createAsyncIterableStream: () => import_utils19.createAsyncIterableStream,
+  createAsyncIterableStream: () => import_utils20.createAsyncIterableStream,
   createDefaultInputSafetyGuardrails: () => createDefaultInputSafetyGuardrails,
   createDefaultPIIGuardrails: () => createDefaultPIIGuardrails,
   createDefaultSafetyGuardrails: () => createDefaultSafetyGuardrails,
@@ -7370,7 +7370,7 @@ __name(createWorkflowChain, "createWorkflowChain");
 
 // src/agent/agent.ts
 var import_api15 = require("@opentelemetry/api");
-var import_utils17 = require("@voltagent/internal/utils");
+var import_utils18 = require("@voltagent/internal/utils");
 var import_ai4 = require("ai");
 var import_zod3 = require("zod");
 
@@ -11072,6 +11072,70 @@ var createVoltOpsClient = /* @__PURE__ */ __name((options) => {
   return new VoltOpsClient(options);
 }, "createVoltOpsClient");
 
+// src/agent/error-utils.ts
+var import_utils11 = require("@voltagent/internal/utils");
+function buildToolErrorResult(error, toolCallId, toolName) {
+  const errorResult = {
+    error: true,
+    name: error.name,
+    message: error.message,
+    stack: error.stack,
+    toolCallId,
+    toolName
+  };
+  const cause = error.cause;
+  if (cause !== void 0) {
+    errorResult.cause = cause instanceof Error ? {
+      name: cause.name,
+      message: cause.message,
+      stack: cause.stack
+    } : sanitizeErrorValue(cause);
+  }
+  for (const key of Object.getOwnPropertyNames(error)) {
+    if (["name", "message", "stack", "cause", "error"].includes(key)) {
+      continue;
+    }
+    const value = error[key];
+    if (value === void 0 || typeof value === "function") {
+      continue;
+    }
+    errorResult[key] = sanitizeErrorValue(value);
+  }
+  return errorResult;
+}
+__name(buildToolErrorResult, "buildToolErrorResult");
+function sanitizeErrorValue(value) {
+  if (value === null || value === void 0) {
+    return value;
+  }
+  const type = typeof value;
+  if (type === "string" || type === "number" || type === "boolean") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => sanitizeErrorValue(item));
+  }
+  if (value instanceof Error) {
+    return {
+      name: value.name,
+      message: value.message,
+      stack: value.stack
+    };
+  }
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  if (value instanceof Map || value instanceof Set) {
+    return (0, import_utils11.safeStringify)(value);
+  }
+  try {
+    return (0, import_utils11.safeStringify)(value);
+  } catch {
+    return String(value);
+  }
+}
+__name(sanitizeErrorValue, "sanitizeErrorValue");
+
 // src/agent/errors/client-http-errors.ts
 var ClientHTTPError = class extends Error {
   constructor(name, httpStatus, code, message) {
@@ -11206,10 +11270,10 @@ var VoltAgentError = class extends Error {
 
 // src/agent/eval.ts
 var import_api10 = require("@opentelemetry/api");
-var import_utils13 = require("@voltagent/internal/utils");
+var import_utils14 = require("@voltagent/internal/utils");
 
 // src/eval/runtime/runtime.ts
-var import_utils11 = require("@voltagent/internal/utils");
+var import_utils12 = require("@voltagent/internal/utils");
 var RUNTIME_METADATA_KEY = "__runtime";
 async function runLocalScorers(args) {
   const { payload, scorers, defaultSampling, baseArgs } = args;
@@ -11427,7 +11491,7 @@ function cloneRecord(value) {
     return void 0;
   }
   try {
-    return JSON.parse((0, import_utils11.safeStringify)(value));
+    return JSON.parse((0, import_utils12.safeStringify)(value));
   } catch {
     return { ...value };
   }
@@ -11445,7 +11509,7 @@ function parseStatus(value) {
 __name(parseStatus, "parseStatus");
 
 // src/eval/create-scorer.ts
-var import_utils12 = require("@voltagent/internal/utils");
+var import_utils13 = require("@voltagent/internal/utils");
 function createScorer(options) {
   const {
     id,
@@ -11560,7 +11624,7 @@ function cloneMetadata(value) {
     return null;
   }
   try {
-    return JSON.parse((0, import_utils12.safeStringify)(value));
+    return JSON.parse((0, import_utils13.safeStringify)(value));
   } catch {
     return { ...value };
   }
@@ -11575,7 +11639,7 @@ function getErrorMetadata(error) {
     return null;
   }
   try {
-    return JSON.parse((0, import_utils12.safeStringify)(metadata));
+    return JSON.parse((0, import_utils13.safeStringify)(metadata));
   } catch {
     return { ...metadata };
   }
@@ -12064,7 +12128,7 @@ function finalizeScorerSpan(span, host, descriptor, config, storagePayload, metr
   span.setAttributes(attributes);
   if (metrics.combinedMetadata && Object.keys(metrics.combinedMetadata).length > 0) {
     try {
-      span.setAttribute("eval.scorer.metadata", (0, import_utils13.safeStringify)(metrics.combinedMetadata));
+      span.setAttribute("eval.scorer.metadata", (0, import_utils14.safeStringify)(metrics.combinedMetadata));
     } catch {
       span.setAttribute("eval.scorer.metadata", "[unserializable]");
     }
@@ -12423,7 +12487,7 @@ function ensureScorerText(value) {
   }
   if (typeof value === "object") {
     try {
-      return (0, import_utils13.safeStringify)(value);
+      return (0, import_utils14.safeStringify)(value);
     } catch {
       return String(value);
     }
@@ -12459,11 +12523,11 @@ function normalizeEvalString(value) {
   if (typeof value === "string") {
     return value;
   }
-  return (0, import_utils13.safeStringify)(value);
+  return (0, import_utils14.safeStringify)(value);
 }
 __name(normalizeEvalString, "normalizeEvalString");
 function cloneEvalPayload(payload) {
-  return JSON.parse((0, import_utils13.safeStringify)(payload));
+  return JSON.parse((0, import_utils14.safeStringify)(payload));
 }
 __name(cloneEvalPayload, "cloneEvalPayload");
 function combineEvalMetadata(payload, scorerMetadata) {
@@ -12702,7 +12766,7 @@ function extractErrorMessage(error) {
     return error;
   }
   try {
-    return (0, import_utils13.safeStringify)(error);
+    return (0, import_utils14.safeStringify)(error);
   } catch {
     return String(error);
   }
@@ -13477,7 +13541,7 @@ var ConversationBuffer = class {
 
 // src/agent/guardrail.ts
 var import_api12 = require("@opentelemetry/api");
-var import_utils14 = require("@voltagent/internal/utils");
+var import_utils15 = require("@voltagent/internal/utils");
 var import_ai2 = require("ai");
 
 // src/utils/message-helpers.ts
@@ -13888,7 +13952,7 @@ function serializeGuardrailValue(value) {
   if (typeof value === "string") {
     return value;
   }
-  return (0, import_utils14.safeStringify)(value);
+  return (0, import_utils15.safeStringify)(value);
 }
 __name(serializeGuardrailValue, "serializeGuardrailValue");
 function extractInputTextForGuardrail(value) {
@@ -13937,7 +14001,7 @@ function extractOutputTextForGuardrail(value) {
   }
   if (typeof value === "object") {
     try {
-      return (0, import_utils14.safeStringify)(value);
+      return (0, import_utils15.safeStringify)(value);
     } catch {
       return void 0;
     }
@@ -13974,8 +14038,8 @@ async function runInputGuardrails(input, oc, guardrails, operation, agent) {
           "guardrail.name": guardrail.name,
           ...guardrail.description ? { "guardrail.description": guardrail.description } : {},
           ...guardrail.severity ? { "guardrail.severity": guardrail.severity } : {},
-          ...guardrail.tags && guardrail.tags.length > 0 ? { "guardrail.tags": (0, import_utils14.safeStringify)(guardrail.tags) } : {},
-          ...guardrail.metadata ? { "guardrail.metadata": (0, import_utils14.safeStringify)(guardrail.metadata) } : {},
+          ...guardrail.tags && guardrail.tags.length > 0 ? { "guardrail.tags": (0, import_utils15.safeStringify)(guardrail.tags) } : {},
+          ...guardrail.metadata ? { "guardrail.metadata": (0, import_utils15.safeStringify)(guardrail.metadata) } : {},
           "guardrail.input.original": serializeGuardrailValue(originalInput),
           "guardrail.input.current": serializeGuardrailValue(currentInput)
         }
@@ -14003,7 +14067,7 @@ async function runInputGuardrails(input, oc, guardrails, operation, agent) {
         span.setAttribute("guardrail.message", resolvedDecision.message);
       }
       if (resolvedDecision.metadata) {
-        span.setAttribute("guardrail.result.metadata", (0, import_utils14.safeStringify)(resolvedDecision.metadata));
+        span.setAttribute("guardrail.result.metadata", (0, import_utils15.safeStringify)(resolvedDecision.metadata));
       }
       if (!pass || action === "block") {
         const message = resolvedDecision.message ?? "Input blocked by guardrail";
@@ -14081,8 +14145,8 @@ async function runOutputGuardrails({
             "guardrail.name": guardrail.name,
             ...guardrail.description ? { "guardrail.description": guardrail.description } : {},
             ...guardrail.severity ? { "guardrail.severity": guardrail.severity } : {},
-            ...guardrail.tags && guardrail.tags.length > 0 ? { "guardrail.tags": (0, import_utils14.safeStringify)(guardrail.tags) } : {},
-            ...guardrail.metadata ? { "guardrail.metadata": (0, import_utils14.safeStringify)(guardrail.metadata) } : {}
+            ...guardrail.tags && guardrail.tags.length > 0 ? { "guardrail.tags": (0, import_utils15.safeStringify)(guardrail.tags) } : {},
+            ...guardrail.metadata ? { "guardrail.metadata": (0, import_utils15.safeStringify)(guardrail.metadata) } : {}
           }
         }
       );
@@ -14090,13 +14154,13 @@ async function runOutputGuardrails({
     span?.setAttribute("guardrail.output.original", serializeGuardrailValue(originalOutput));
     span?.setAttribute("guardrail.output.current", serializeGuardrailValue(currentOutput));
     if (metadata.usage !== void 0) {
-      span?.setAttribute("guardrail.usage", (0, import_utils14.safeStringify)(metadata.usage));
+      span?.setAttribute("guardrail.usage", (0, import_utils15.safeStringify)(metadata.usage));
     }
     if (metadata.finishReason !== void 0 && metadata.finishReason !== null) {
       span?.setAttribute("guardrail.finish_reason", metadata.finishReason);
     }
     if (metadata.warnings && metadata.warnings.length > 0) {
-      span?.setAttribute("guardrail.warnings", (0, import_utils14.safeStringify)(metadata.warnings));
+      span?.setAttribute("guardrail.warnings", (0, import_utils15.safeStringify)(metadata.warnings));
     }
     try {
       const decision = await oc.traceContext.withSpan(
@@ -14123,7 +14187,7 @@ async function runOutputGuardrails({
         span?.setAttribute("guardrail.message", resolvedDecision.message);
       }
       if (resolvedDecision.metadata) {
-        span?.setAttribute("guardrail.result.metadata", (0, import_utils14.safeStringify)(resolvedDecision.metadata));
+        span?.setAttribute("guardrail.result.metadata", (0, import_utils15.safeStringify)(resolvedDecision.metadata));
       }
       if (!pass || action === "block") {
         const message = resolvedDecision.message ?? "Output blocked by guardrail";
@@ -14659,7 +14723,7 @@ var import_ai3 = require("ai");
 
 // src/agent/streaming/output-guardrail-stream-runner.ts
 var import_api13 = require("@opentelemetry/api");
-var import_utils15 = require("@voltagent/internal/utils");
+var import_utils16 = require("@voltagent/internal/utils");
 var isTextDelta = /* @__PURE__ */ __name((part) => part.type === "text-delta", "isTextDelta");
 var extractChunkText = /* @__PURE__ */ __name((part) => {
   if (!isTextDelta(part)) {
@@ -14914,8 +14978,8 @@ var OutputGuardrailStreamRunner = class {
           "guardrail.name": guardrail.name,
           ...guardrail.description ? { "guardrail.description": guardrail.description } : {},
           ...guardrail.severity ? { "guardrail.severity": guardrail.severity } : {},
-          ...guardrail.tags && guardrail.tags.length > 0 ? { "guardrail.tags": (0, import_utils15.safeStringify)(guardrail.tags) } : {},
-          ...guardrail.metadata ? { "guardrail.metadata": (0, import_utils15.safeStringify)(guardrail.metadata) } : {}
+          ...guardrail.tags && guardrail.tags.length > 0 ? { "guardrail.tags": (0, import_utils16.safeStringify)(guardrail.tags) } : {},
+          ...guardrail.metadata ? { "guardrail.metadata": (0, import_utils16.safeStringify)(guardrail.metadata) } : {}
         }
       }
     );
@@ -15443,7 +15507,7 @@ __name(convertFullStreamChunkToUIMessageStream, "convertFullStreamChunkToUIMessa
 
 // src/agent/subagent/index.ts
 var import_api14 = require("@opentelemetry/api");
-var import_utils16 = require("@voltagent/internal/utils");
+var import_utils17 = require("@voltagent/internal/utils");
 var import_zod2 = require("zod");
 
 // src/agent/subagent/types.ts
@@ -15596,10 +15660,13 @@ var SubAgentManager = class {
    */
   extractAgentPurpose(agentConfig) {
     const agent = this.extractAgent(agentConfig);
+    if (agent.purpose) {
+      return agent.purpose;
+    }
     if (typeof agent.instructions === "string") {
-      return agent.purpose ?? agent.instructions;
+      return agent.instructions;
     }
-    return agent.purpose ?? "Dynamic instructions";
+    return "Dynamic instructions";
   }
   /**
    * Type guard to check if a SubAgentConfig is a direct AgentV2 instance
@@ -15746,7 +15813,7 @@ ${guidelinesText}
         taskContent = `Task handed off from ${sourceAgent?.name || this.agentName} to ${targetAgent.name}:
 ${task}
 
-Context: ${(0, import_utils16.safeStringify)(contextObj, { indentation: 2 })}`;
+Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
       }
       const taskMessage = {
         id: crypto.randomUUID(),
@@ -15903,7 +15970,7 @@ Context: ${(0, import_utils16.safeStringify)(contextObj, { indentation: 2 })}`;
           options2
         );
         const finalObject = await response.object;
-        finalResult = (0, import_utils16.safeStringify)(finalObject);
+        finalResult = (0, import_utils17.safeStringify)(finalObject);
         const assistantMessage = {
           id: crypto.randomUUID(),
           role: "assistant",
@@ -15917,7 +15984,7 @@ Context: ${(0, import_utils16.safeStringify)(contextObj, { indentation: 2 })}`;
           targetAgentConfig.schema,
           options2
         );
-        finalResult = (0, import_utils16.safeStringify)(response);
+        finalResult = (0, import_utils17.safeStringify)(response);
         usage = response.usage;
         const assistantMessage = {
           id: crypto.randomUUID(),
@@ -16329,12 +16396,12 @@ var Agent = class {
         );
         const contextMap = Object.fromEntries(oc.context.entries());
         if (Object.keys(contextMap).length > 0) {
-          rootSpan.setAttribute("agent.context", (0, import_utils17.safeStringify)(contextMap));
+          rootSpan.setAttribute("agent.context", (0, import_utils18.safeStringify)(contextMap));
         }
-        rootSpan.setAttribute("agent.messages", (0, import_utils17.safeStringify)(messages));
-        rootSpan.setAttribute("agent.messages.ui", (0, import_utils17.safeStringify)(uiMessages));
+        rootSpan.setAttribute("agent.messages", (0, import_utils18.safeStringify)(messages));
+        rootSpan.setAttribute("agent.messages.ui", (0, import_utils18.safeStringify)(uiMessages));
         const agentState = this.getFullState();
-        rootSpan.setAttribute("agent.stateSnapshot", (0, import_utils17.safeStringify)(agentState));
+        rootSpan.setAttribute("agent.stateSnapshot", (0, import_utils18.safeStringify)(agentState));
         methodLogger.debug(
           buildAgentLogMessage(
             this.name,
@@ -16484,7 +16551,7 @@ var Agent = class {
           operation: "generateText",
           metadata: {
             finishReason: result.finishReason,
-            usage: result.usage ? JSON.parse((0, import_utils17.safeStringify)(result.usage)) : void 0,
+            usage: result.usage ? JSON.parse((0, import_utils18.safeStringify)(result.usage)) : void 0,
             toolCalls: aggregatedToolCalls
           }
         });
@@ -16594,12 +16661,12 @@ var Agent = class {
           );
           const contextMap = Object.fromEntries(oc.context.entries());
           if (Object.keys(contextMap).length > 0) {
-            rootSpan2.setAttribute("agent.context", (0, import_utils17.safeStringify)(contextMap));
+            rootSpan2.setAttribute("agent.context", (0, import_utils18.safeStringify)(contextMap));
           }
-          rootSpan2.setAttribute("agent.messages", (0, import_utils17.safeStringify)(messages));
-          rootSpan2.setAttribute("agent.messages.ui", (0, import_utils17.safeStringify)(uiMessages));
+          rootSpan2.setAttribute("agent.messages", (0, import_utils18.safeStringify)(messages));
+          rootSpan2.setAttribute("agent.messages.ui", (0, import_utils18.safeStringify)(uiMessages));
           const agentState = this.getFullState();
-          rootSpan2.setAttribute("agent.stateSnapshot", (0, import_utils17.safeStringify)(agentState));
+          rootSpan2.setAttribute("agent.stateSnapshot", (0, import_utils18.safeStringify)(agentState));
         }
         methodLogger.debug(
           buildAgentLogMessage(
@@ -16797,7 +16864,7 @@ var Agent = class {
               operation: "streamText",
               metadata: {
                 finishReason: finalResult.finishReason,
-                usage: finalResult.totalUsage ? JSON.parse((0, import_utils17.safeStringify)(finalResult.totalUsage)) : void 0,
+                usage: finalResult.totalUsage ? JSON.parse((0, import_utils18.safeStringify)(finalResult.totalUsage)) : void 0,
                 toolCalls: finalResult.toolCalls
               }
             });
@@ -17051,12 +17118,12 @@ var Agent = class {
         );
         const contextMap = Object.fromEntries(oc.context.entries());
         if (Object.keys(contextMap).length > 0) {
-          rootSpan.setAttribute("agent.context", (0, import_utils17.safeStringify)(contextMap));
+          rootSpan.setAttribute("agent.context", (0, import_utils18.safeStringify)(contextMap));
         }
-        rootSpan.setAttribute("agent.messages", (0, import_utils17.safeStringify)(messages));
-        rootSpan.setAttribute("agent.messages.ui", (0, import_utils17.safeStringify)(uiMessages));
+        rootSpan.setAttribute("agent.messages", (0, import_utils18.safeStringify)(messages));
+        rootSpan.setAttribute("agent.messages.ui", (0, import_utils18.safeStringify)(uiMessages));
         const agentState = this.getFullState();
-        rootSpan.setAttribute("agent.stateSnapshot", (0, import_utils17.safeStringify)(agentState));
+        rootSpan.setAttribute("agent.stateSnapshot", (0, import_utils18.safeStringify)(agentState));
         methodLogger.debug(
           buildAgentLogMessage(
             this.name,
@@ -17122,7 +17189,7 @@ var Agent = class {
             parts: [
               {
                 type: "text",
-                text: (0, import_utils17.safeStringify)(finalObject)
+                text: (0, import_utils18.safeStringify)(finalObject)
               }
             ]
           };
@@ -17130,7 +17197,7 @@ var Agent = class {
           const step = {
             id: randomUUID(),
             type: "text",
-            content: (0, import_utils17.safeStringify)(finalObject),
+            content: (0, import_utils18.safeStringify)(finalObject),
             role: "assistant",
             usage: usageInfo
           };
@@ -17145,7 +17212,7 @@ var Agent = class {
           operation: "generateObject",
           metadata: {
             finishReason: result.finishReason,
-            usage: result.usage ? JSON.parse((0, import_utils17.safeStringify)(result.usage)) : void 0,
+            usage: result.usage ? JSON.parse((0, import_utils18.safeStringify)(result.usage)) : void 0,
             schemaName
           }
         });
@@ -17229,12 +17296,12 @@ var Agent = class {
         );
         const contextMap = Object.fromEntries(oc.context.entries());
         if (Object.keys(contextMap).length > 0) {
-          rootSpan.setAttribute("agent.context", (0, import_utils17.safeStringify)(contextMap));
+          rootSpan.setAttribute("agent.context", (0, import_utils18.safeStringify)(contextMap));
         }
-        rootSpan.setAttribute("agent.messages", (0, import_utils17.safeStringify)(messages));
-        rootSpan.setAttribute("agent.messages.ui", (0, import_utils17.safeStringify)(uiMessages));
+        rootSpan.setAttribute("agent.messages", (0, import_utils18.safeStringify)(messages));
+        rootSpan.setAttribute("agent.messages.ui", (0, import_utils18.safeStringify)(uiMessages));
         const agentState = this.getFullState();
-        rootSpan.setAttribute("agent.stateSnapshot", (0, import_utils17.safeStringify)(agentState));
+        rootSpan.setAttribute("agent.stateSnapshot", (0, import_utils18.safeStringify)(agentState));
         methodLogger.debug(
           buildAgentLogMessage(
             this.name,
@@ -17327,7 +17394,7 @@ var Agent = class {
                   parts: [
                     {
                       type: "text",
-                      text: (0, import_utils17.safeStringify)(finalObject)
+                      text: (0, import_utils18.safeStringify)(finalObject)
                     }
                   ]
                 };
@@ -17335,7 +17402,7 @@ var Agent = class {
                 const step = {
                   id: randomUUID(),
                   type: "text",
-                  content: (0, import_utils17.safeStringify)(finalObject),
+                  content: (0, import_utils18.safeStringify)(finalObject),
                   role: "assistant",
                   usage: usageInfo
                 };
@@ -17384,7 +17451,7 @@ var Agent = class {
                 operation: "streamObject",
                 metadata: {
                   finishReason: finalResult.finishReason,
-                  usage: finalResult.usage ? JSON.parse((0, import_utils17.safeStringify)(finalResult.usage)) : void 0,
+                  usage: finalResult.usage ? JSON.parse((0, import_utils18.safeStringify)(finalResult.usage)) : void 0,
                   schemaName
                 }
               });
@@ -17725,12 +17792,12 @@ var Agent = class {
       attrs["llm.top_p"] = topP;
     }
     if (callOptions.stop !== void 0) {
-      attrs["llm.stop_condition"] = (0, import_utils17.safeStringify)(callOptions.stop);
+      attrs["llm.stop_condition"] = (0, import_utils18.safeStringify)(callOptions.stop);
     }
     if (params.messages && params.messages.length > 0) {
       attrs["llm.messages.count"] = params.messages.length;
       const trimmedMessages = params.messages.slice(-10);
-      attrs["llm.messages"] = (0, import_utils17.safeStringify)(
+      attrs["llm.messages"] = (0, import_utils18.safeStringify)(
         trimmedMessages.map((msg) => ({
           role: msg.role,
           content: msg.content
@@ -17745,7 +17812,7 @@ var Agent = class {
       }
     }
     if (params.providerOptions) {
-      attrs["llm.provider_options"] = (0, import_utils17.safeStringify)(params.providerOptions);
+      attrs["llm.provider_options"] = (0, import_utils18.safeStringify)(params.providerOptions);
     }
     return attrs;
   }
@@ -17903,7 +17970,7 @@ var Agent = class {
           attributes: {
             "memory.operation": "read",
             "memory.semantic": isSemanticSearch,
-            input: (0, import_utils17.safeStringify)(spanInput),
+            input: (0, import_utils18.safeStringify)(spanInput),
             ...isSemanticSearch && {
               "memory.semantic.limit": semanticLimit,
               "memory.semantic.threshold": semanticThreshold,
@@ -18035,13 +18102,13 @@ var Agent = class {
           rootSpan.setAttribute("prompt.version", metadata.version);
         }
         if (metadata.labels && metadata.labels.length > 0) {
-          rootSpan.setAttribute("prompt.labels", (0, import_utils17.safeStringify)(metadata.labels));
+          rootSpan.setAttribute("prompt.labels", (0, import_utils18.safeStringify)(metadata.labels));
         }
         if (metadata.tags && metadata.tags.length > 0) {
-          rootSpan.setAttribute("prompt.tags", (0, import_utils17.safeStringify)(metadata.tags));
+          rootSpan.setAttribute("prompt.tags", (0, import_utils18.safeStringify)(metadata.tags));
         }
         if (metadata.config) {
-          rootSpan.setAttribute("prompt.config", (0, import_utils17.safeStringify)(metadata.config));
+          rootSpan.setAttribute("prompt.config", (0, import_utils18.safeStringify)(metadata.config));
         }
       }
     }
@@ -18215,7 +18282,7 @@ ${retrieverContext}`;
       label: this.retriever.tool.name || "Retriever",
       attributes: {
         "retriever.name": this.retriever.tool.name || "Retriever",
-        input: typeof input === "string" ? input : (0, import_utils17.safeStringify)(input)
+        input: typeof input === "string" ? input : (0, import_utils18.safeStringify)(input)
       }
     });
     try {
@@ -18361,9 +18428,9 @@ ${retrieverContext}`;
           "tool.name": tool2.name,
           "tool.call.id": toolCallId,
           "tool.description": tool2.description,
-          ...toolTags && toolTags.length > 0 ? { "tool.tags": (0, import_utils17.safeStringify)(toolTags) } : {},
-          "tool.parameters": (0, import_utils17.safeStringify)(tool2.parameters),
-          input: args ? (0, import_utils17.safeStringify)(args) : void 0
+          ...toolTags && toolTags.length > 0 ? { "tool.tags": (0, import_utils18.safeStringify)(toolTags) } : {},
+          "tool.parameters": (0, import_utils18.safeStringify)(tool2.parameters),
+          input: args ? (0, import_utils18.safeStringify)(args) : void 0
         },
         kind: import_api15.SpanKind.CLIENT
       });
@@ -18384,7 +18451,7 @@ ${retrieverContext}`;
           }
           const result = await tool2.execute(args, executionOptions);
           const validatedResult = await this.validateToolOutput(result, tool2);
-          toolSpan.setAttribute("output", (0, import_utils17.safeStringify)(result));
+          toolSpan.setAttribute("output", (0, import_utils18.safeStringify)(result));
           toolSpan.setStatus({ code: import_api15.SpanStatusCode.OK });
           toolSpan.end();
           await hooks.onToolEnd?.({
@@ -18398,7 +18465,16 @@ ${retrieverContext}`;
           return result;
         } catch (e) {
           const error = e instanceof Error ? e : new Error(String(e));
-          const errorResult = { error: true, ...error };
+          const voltAgentError = createVoltAgentError(error, {
+            stage: "tool_execution",
+            toolError: {
+              toolCallId,
+              toolName: tool2.name,
+              toolExecutionError: error,
+              toolArguments: args
+            }
+          });
+          const errorResult = buildToolErrorResult(error, toolCallId, tool2.name);
           toolSpan.setStatus({ code: import_api15.SpanStatusCode.ERROR, message: error.message });
           toolSpan.recordException(error);
           toolSpan.end();
@@ -18406,7 +18482,7 @@ ${retrieverContext}`;
             agent: this,
             tool: tool2,
             output: void 0,
-            error: errorResult,
+            error: voltAgentError,
             context: oc,
             options: executionOptions
           });
@@ -18574,7 +18650,7 @@ ${retrieverContext}`;
           oc.conversationSteps?.push({
             id: toolCall.toolCallId || randomUUID(),
             type: "tool_call",
-            content: (0, import_utils17.safeStringify)(toolCall.input ?? {}),
+            content: (0, import_utils18.safeStringify)(toolCall.input ?? {}),
             role: "assistant",
             name: toolCall.toolName,
             arguments: toolCall.input || {},
@@ -18606,7 +18682,7 @@ ${retrieverContext}`;
           oc.conversationSteps?.push({
             id: toolResult.toolCallId || randomUUID(),
             type: "tool_result",
-            content: (0, import_utils17.safeStringify)(toolResult.output),
+            content: (0, import_utils18.safeStringify)(toolResult.output),
             role: "assistant",
             name: toolResult.toolName,
             result: toolResult.output,
@@ -21975,7 +22051,7 @@ var import_node_crypto = __toESM(require("crypto"));
 var import_node_fs = __toESM(require("fs"));
 var import_node_os = __toESM(require("os"));
 var import_node_path = __toESM(require("path"));
-var import_utils18 = require("@voltagent/internal/utils");
+var import_utils19 = require("@voltagent/internal/utils");
 var getEnvPaths = /* @__PURE__ */ __name((name) => {
   const homedir = import_node_os.default.homedir();
   const tmpdir = import_node_os.default.tmpdir();
@@ -22045,7 +22121,7 @@ var writeUpdateCache = /* @__PURE__ */ __name(async (projectPath, cache) => {
   try {
     ensureCacheDir();
     const cacheFilePath = getCacheFilePath(projectPath);
-    import_node_fs.default.writeFileSync(cacheFilePath, (0, import_utils18.safeStringify)(cache, { indentation: 2 }), "utf8");
+    import_node_fs.default.writeFileSync(cacheFilePath, (0, import_utils19.safeStringify)(cache, { indentation: 2 }), "utf8");
   } catch (error) {
     const logger = new LoggerProxy({ component: "update-cache" });
     logger.error("Error writing update cache", { error });
@@ -22938,7 +23014,7 @@ var VoltAgent = class {
 };
 
 // src/index.ts
-var import_utils19 = require("@voltagent/internal/utils");
+var import_utils20 = require("@voltagent/internal/utils");
 var import_ai6 = require("ai");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {