@inkeep/agents-run-api 0.23.4 → 0.24.0

package/dist/index.js

@@ -1,10 +1,10 @@
 import { flushBatchProcessor } from './chunk-TVLDBLRZ.js';
-import { getFormattedConversationHistory, createDefaultConversationHistoryConfig, saveA2AMessageResponse } from './chunk-T5AYIGCU.js';
+import { getFormattedConversationHistory, createDefaultConversationHistoryConfig, saveA2AMessageResponse } from './chunk-XLUE6U2L.js';
 import { dbClient_default } from './chunk-IBMWBEXH.js';
 import { env } from './chunk-LHCIBW34.js';
 import { getLogger } from './chunk-A2S7GSHL.js';
 import { __publicField } from './chunk-PKBMQBKP.js';
-import { getTracer, HeadersScopeSchema, getRequestExecutionContext, createApiError, getAgentWithDefaultSubAgent, contextValidationMiddleware, getConversationId, getFullAgent, createOrGetConversation, getActiveAgentForConversation, setActiveAgentForConversation, getSubAgentById, handleContextResolution, createMessage, commonGetErrorResponses, loggerFactory, getDataComponent, getProject, createDefaultCredentialStores, CredentialStoreRegistry, listTaskIdsByContextId, getTask, getLedgerArtifacts, upsertLedgerArtifact, createTask, updateTask, setSpanWithError, updateConversation, handleApiError, TaskState, setActiveAgentForThread, getConversation, getAgentById, getRelatedAgentsForAgent, getToolsForAgent, getDataComponentsForAgent, getArtifactComponentsForAgent, dbResultToMcpTool, validateAndGetApiKey, ContextResolver, CredentialStuffer, MCPServerType, getCredentialReference, McpClient, getFunctionToolsForSubAgent, getFunction, getContextConfigById, getFullAgentDefinition, TemplateEngine, agentHasArtifactComponents, MCPTransportType, SPAN_KEYS, getExternalAgent } from '@inkeep/agents-core';
+import { getTracer, HeadersScopeSchema, getRequestExecutionContext, createApiError, getAgentWithDefaultSubAgent, contextValidationMiddleware, getConversationId, getFullAgent, createOrGetConversation, getActiveAgentForConversation, setActiveAgentForConversation, getSubAgentById, handleContextResolution, createMessage, generateId, commonGetErrorResponses, loggerFactory, getDataComponent, getProject, createDefaultCredentialStores, CredentialStoreRegistry, listTaskIdsByContextId, getTask, getLedgerArtifacts, upsertLedgerArtifact, createTask, updateTask, setSpanWithError, updateConversation, handleApiError, TaskState, setActiveAgentForThread, getConversation, getAgentById, getRelatedAgentsForAgent, getToolsForAgent, getDataComponentsForAgent, getArtifactComponentsForAgent, dbResultToMcpTool, validateAndGetApiKey, ContextResolver, CredentialStuffer, MCPServerType, getCredentialReference, McpClient, getFunctionToolsForSubAgent, getFunction, getContextConfigById, getFullAgentDefinition, TemplateEngine, agentHasArtifactComponents, MCPTransportType, SPAN_KEYS, getExternalAgent } from '@inkeep/agents-core';
 import { otel } from '@hono/otel';
 import { OpenAPIHono, createRoute, z as z$1 } from '@hono/zod-openapi';
 import { trace, propagation, context, SpanStatusCode } from '@opentelemetry/api';
@@ -16,7 +16,6 @@ import { createMiddleware } from 'hono/factory';
 import { swaggerUI } from '@hono/swagger-ui';
 import z5, { z } from 'zod';
 import { streamSSE, stream } from 'hono/streaming';
-import { nanoid } from 'nanoid';
 import { createUIMessageStream, JsonToSseTransformStream, streamObject, parsePartialJson, generateObject, tool, streamText, generateText } from 'ai';
 import { createAnthropic, anthropic } from '@ai-sdk/anthropic';
 import { createGateway, gateway } from '@ai-sdk/gateway';
@@ -278,7 +277,7 @@ async function handleMessageSend(c, agent, request) {
     const executionContext = getRequestExecutionContext(c);
     const { agentId } = executionContext;
     const task = {
-      id: nanoid(),
+      id: generateId(),
       input: {
         parts: params.message.parts.map((part) => ({
           kind: part.kind,
@@ -371,7 +370,7 @@ async function handleMessageSend(c, agent, request) {
       const messageText = params.message.parts.filter((part) => part.kind === "text" && "text" in part && part.text).map((part) => part.text).join(" ");
       try {
         const messageData = {
-          id: nanoid(),
+          id: generateId(),
           tenantId: agent.tenantId,
           projectId: agent.projectId,
           conversationId: effectiveContextId,
@@ -453,7 +452,7 @@ async function handleMessageSend(c, agent, request) {
             },
             artifacts: [
               {
-                artifactId: nanoid(),
+                artifactId: generateId(),
                 parts: [
                   {
                     kind: "data",
@@ -482,7 +481,7 @@ async function handleMessageSend(c, agent, request) {
     if (params.configuration?.blocking === false) {
       const taskResponse = {
         id: task.id,
-        contextId: params.message.contextId || nanoid(),
+        contextId: params.message.contextId || generateId(),
         status: taskStatus,
         artifacts: result.artifacts,
         kind: "task"
@@ -494,7 +493,7 @@ async function handleMessageSend(c, agent, request) {
       });
     }
     const messageResponse = {
-      messageId: nanoid(),
+      messageId: generateId(),
       parts: result.artifacts?.[0]?.parts || [
         {
           kind: "text",
@@ -539,7 +538,7 @@ async function handleMessageStream(c, agent, request) {
       });
     }
     const task = {
-      id: nanoid(),
+      id: generateId(),
       input: {
         parts: params.message.parts.map((part) => ({
           kind: part.kind,
@@ -560,7 +559,7 @@ async function handleMessageStream(c, agent, request) {
       try {
         const initialTask = {
           id: task.id,
-          contextId: params.message.contextId || nanoid(),
+          contextId: params.message.contextId || generateId(),
           status: {
             state: TaskState.Working,
             timestamp: (/* @__PURE__ */ new Date()).toISOString()
@@ -608,7 +607,7 @@ async function handleMessageStream(c, agent, request) {
           }
         }
         const messageResponse = {
-          messageId: nanoid(),
+          messageId: generateId(),
           parts: result.artifacts?.[0]?.parts || [
             {
               kind: "text",
@@ -674,14 +673,14 @@ async function handleTasksGet(c, _agent, request) {
     const params = request.params;
     const task = {
       id: params.id,
-      contextId: nanoid(),
+      contextId: generateId(),
       status: {
         state: TaskState.Completed,
         timestamp: (/* @__PURE__ */ new Date()).toISOString()
       },
       artifacts: [
         {
-          artifactId: nanoid(),
+          artifactId: generateId(),
           parts: [
             {
               kind: "text",
@@ -780,7 +779,7 @@ async function handleTasksResubscribe(c, agent, request) {
       try {
         const task = {
           id: params.taskId,
-          contextId: nanoid(),
+          contextId: generateId(),
           status: {
             state: TaskState.Completed,
             timestamp: (/* @__PURE__ */ new Date()).toISOString()
@@ -1029,7 +1028,7 @@ var _ToolSessionManager = class _ToolSessionManager {
    * Create a new tool session for an agent execution
    */
   createSession(tenantId, projectId, contextId, taskId) {
-    const sessionId = nanoid();
+    const sessionId = generateId();
     return this.createSessionWithId(sessionId, tenantId, projectId, contextId, taskId);
   }
   /**
@@ -4105,7 +4104,7 @@ function errorOp(message, subAgentId, severity = "error", code) {
   };
 }
 function generateToolId() {
-  return `tool_${nanoid(8)}`;
+  return `tool_${generateId(8)}`;
 }
 var logger11 = getLogger("DataComponentSchema");
 function jsonSchemaToZod(jsonSchema) {
@@ -5202,7 +5201,7 @@ function createDelegateToAgentTool({
     description: generateDelegateToolDescription(delegateConfig.config),
     inputSchema: z5.object({ message: z5.string() }),
     execute: async (input, context) => {
-      const delegationId = `del_${nanoid()}`;
+      const delegationId = `del_${generateId()}`;
       const activeSpan = trace.getActiveSpan();
       if (activeSpan) {
         activeSpan.setAttributes({
@@ -5299,7 +5298,7 @@ function createDelegateToAgentTool({
       const messageToSend = {
         role: "agent",
         parts: [{ text: input.message, kind: "text" }],
-        messageId: nanoid(),
+        messageId: generateId(),
         kind: "message",
         contextId,
         metadata: {
@@ -5314,7 +5313,7 @@ function createDelegateToAgentTool({
       };
       logger13.info({ messageToSend }, "messageToSend");
       await createMessage(dbClient_default)({
-        id: nanoid(),
+        id: generateId(),
         tenantId,
         projectId,
         conversationId: contextId,
@@ -7343,7 +7342,7 @@ var Agent = class {
       inputSchema: tool3.inputSchema || tool3.parameters || {},
       usageGuidelines: name.startsWith("transfer_to_") || name.startsWith("delegate_to_") ? `Use this tool to ${name.startsWith("transfer_to_") ? "transfer" : "delegate"} to another agent when appropriate.` : "Use this tool when appropriate for the task at hand."
     }));
-    const { getConversationScopedArtifacts } = await import('./conversations-6OGSD67W.js');
+    const { getConversationScopedArtifacts } = await import('./conversations-H2TSLD3U.js');
     const historyConfig = this.config.conversationHistoryConfig ?? createDefaultConversationHistoryConfig();
     const referenceArtifacts = await getConversationScopedArtifacts({
       tenantId: this.config.tenantId,
@@ -7677,326 +7676,334 @@ var Agent = class {
     }
   }
   async generate(userMessage, runtimeContext) {
-    return tracer.startActiveSpan("agent.generate", async (span) => {
-      const contextId = runtimeContext?.contextId || "default";
-      const taskId = runtimeContext?.metadata?.taskId || "unknown";
-      const streamRequestId = runtimeContext?.metadata?.streamRequestId;
-      const sessionId = streamRequestId || "fallback-session";
-      try {
-        this.streamRequestId = streamRequestId;
-        this.streamHelper = streamRequestId ? getStreamHelper(streamRequestId) : void 0;
-        const conversationId = runtimeContext?.metadata?.conversationId;
-        if (conversationId) {
-          this.setConversationId(conversationId);
+    return tracer.startActiveSpan(
+      "agent.generate",
+      {
+        attributes: {
+          "subagent.id": this.config.id,
+          "subagent.name": this.config.name
         }
-        const [
-          mcpTools,
-          systemPrompt,
-          thinkingSystemPrompt,
-          functionTools,
-          relationTools,
-          defaultTools
-        ] = await tracer.startActiveSpan(
-          "agent.load_tools",
-          {
-            attributes: {
-              "subAgent.name": this.config.name,
-              "session.id": sessionId
-            }
-          },
-          async (childSpan) => {
-            try {
-              const result = await Promise.all([
-                this.getMcpTools(sessionId, streamRequestId),
-                this.buildSystemPrompt(runtimeContext, false),
-                // Normal prompt with data components
-                this.buildSystemPrompt(runtimeContext, true),
-                // Thinking prompt without data components
-                this.getFunctionTools(sessionId, streamRequestId),
-                Promise.resolve(this.getRelationTools(runtimeContext, sessionId)),
-                this.getDefaultTools(streamRequestId)
-              ]);
-              childSpan.setStatus({ code: SpanStatusCode.OK });
-              return result;
-            } catch (err) {
-              const errorObj = err instanceof Error ? err : new Error(String(err));
-              setSpanWithError(childSpan, errorObj);
-              throw err;
-            } finally {
-              childSpan.end();
-            }
-          }
-        );
-        const allTools = {
-          ...mcpTools,
-          ...functionTools,
-          ...relationTools,
-          ...defaultTools
-        };
-        const sanitizedTools = this.sanitizeToolsForAISDK(allTools);
-        let conversationHistory = "";
-        const historyConfig = this.config.conversationHistoryConfig ?? createDefaultConversationHistoryConfig();
-        if (historyConfig && historyConfig.mode !== "none") {
-          if (historyConfig.mode === "full") {
-            conversationHistory = await getFormattedConversationHistory({
-              tenantId: this.config.tenantId,
-              projectId: this.config.projectId,
-              conversationId: contextId,
-              currentMessage: userMessage,
-              options: historyConfig,
-              filters: {}
-            });
-          } else if (historyConfig.mode === "scoped") {
-            conversationHistory = await getFormattedConversationHistory({
-              tenantId: this.config.tenantId,
-              projectId: this.config.projectId,
-              conversationId: contextId,
-              currentMessage: userMessage,
-              options: historyConfig,
-              filters: {
-                subAgentId: this.config.id,
-                taskId
-              }
-            });
+      },
+      async (span) => {
+        const contextId = runtimeContext?.contextId || "default";
+        const taskId = runtimeContext?.metadata?.taskId || "unknown";
+        const streamRequestId = runtimeContext?.metadata?.streamRequestId;
+        const sessionId = streamRequestId || "fallback-session";
+        try {
+          this.streamRequestId = streamRequestId;
+          this.streamHelper = streamRequestId ? getStreamHelper(streamRequestId) : void 0;
+          const conversationId = runtimeContext?.metadata?.conversationId;
+          if (conversationId) {
+            this.setConversationId(conversationId);
           }
-        }
-        const primaryModelSettings = this.getPrimaryModel();
-        const modelSettings = ModelFactory.prepareGenerationConfig(primaryModelSettings);
-        let response;
-        let textResponse;
-        const hasStructuredOutput = this.config.dataComponents && this.config.dataComponents.length > 0;
-        const shouldStreamPhase1 = this.getStreamingHelper() && !hasStructuredOutput;
-        const MAX_ALLOWED_TIMEOUT_MS = 6e5;
-        const configuredTimeout = modelSettings.maxDuration ? Math.min(modelSettings.maxDuration * 1e3, MAX_ALLOWED_TIMEOUT_MS) : shouldStreamPhase1 ? CONSTANTS.PHASE_1_TIMEOUT_MS : CONSTANTS.NON_STREAMING_PHASE_1_TIMEOUT_MS;
-        const timeoutMs = Math.min(configuredTimeout, MAX_ALLOWED_TIMEOUT_MS);
-        if (modelSettings.maxDuration && modelSettings.maxDuration * 1e3 > MAX_ALLOWED_TIMEOUT_MS) {
-          logger15.warn(
+          const [
+            mcpTools,
+            systemPrompt,
+            thinkingSystemPrompt,
+            functionTools,
+            relationTools,
+            defaultTools
+          ] = await tracer.startActiveSpan(
+            "agent.load_tools",
             {
-              requestedTimeout: modelSettings.maxDuration * 1e3,
-              appliedTimeout: timeoutMs,
-              maxAllowed: MAX_ALLOWED_TIMEOUT_MS
-            },
-            "Requested timeout exceeded maximum allowed, capping to 10 minutes"
-          );
-        }
-        const phase1SystemPrompt = hasStructuredOutput ? thinkingSystemPrompt : systemPrompt;
-        const messages = [];
-        messages.push({ role: "system", content: phase1SystemPrompt });
-        if (conversationHistory.trim() !== "") {
-          messages.push({ role: "user", content: conversationHistory });
-        }
-        messages.push({
-          role: "user",
-          content: userMessage
-        });
-        if (shouldStreamPhase1) {
-          const streamConfig = {
-            ...modelSettings,
-            toolChoice: "auto"
-            // Allow natural text + tools
-          };
-          const streamResult = streamText({
-            ...streamConfig,
-            messages,
-            tools: sanitizedTools,
-            stopWhen: async ({ steps }) => {
-              const last = steps.at(-1);
-              if (last && "text" in last && last.text) {
-                try {
-                  await agentSessionManager.recordEvent(
-                    this.getStreamRequestId(),
-                    "agent_reasoning",
-                    this.config.id,
-                    {
-                      parts: [{ type: "text", content: last.text }]
-                    }
-                  );
-                } catch (error) {
-                  logger15.debug({ error }, "Failed to track agent reasoning");
-                }
-              }
-              if (steps.length >= 2) {
-                const previousStep = steps[steps.length - 2];
-                if (previousStep && "toolCalls" in previousStep && previousStep.toolCalls) {
-                  const hasTransferCall = previousStep.toolCalls.some(
-                    (tc) => tc.toolName.startsWith("transfer_to_")
-                  );
-                  if (hasTransferCall && "toolResults" in previousStep && previousStep.toolResults) {
-                    return true;
-                  }
-                }
+              attributes: {
+                "subAgent.name": this.config.name,
+                "session.id": sessionId
               }
-              return steps.length >= this.getMaxGenerationSteps();
             },
-            experimental_telemetry: {
-              isEnabled: true,
-              functionId: this.config.id,
-              recordInputs: true,
-              recordOutputs: true
-            },
-            abortSignal: AbortSignal.timeout(timeoutMs)
-          });
-          const streamHelper = this.getStreamingHelper();
-          if (!streamHelper) {
-            throw new Error("Stream helper is unexpectedly undefined in streaming context");
-          }
-          const session = toolSessionManager.getSession(sessionId);
-          const artifactParserOptions = {
-            sessionId,
-            taskId: session?.taskId,
-            projectId: session?.projectId,
-            artifactComponents: this.artifactComponents,
-            streamRequestId: this.getStreamRequestId(),
-            subAgentId: this.config.id
-          };
-          const parser = new IncrementalStreamParser(
-            streamHelper,
-            this.config.tenantId,
-            contextId,
-            artifactParserOptions
+            async (childSpan) => {
+              try {
+                const result = await Promise.all([
+                  this.getMcpTools(sessionId, streamRequestId),
+                  this.buildSystemPrompt(runtimeContext, false),
+                  // Normal prompt with data components
+                  this.buildSystemPrompt(runtimeContext, true),
+                  // Thinking prompt without data components
+                  this.getFunctionTools(sessionId, streamRequestId),
+                  Promise.resolve(this.getRelationTools(runtimeContext, sessionId)),
+                  this.getDefaultTools(streamRequestId)
+                ]);
+                childSpan.setStatus({ code: SpanStatusCode.OK });
+                return result;
+              } catch (err) {
+                const errorObj = err instanceof Error ? err : new Error(String(err));
+                setSpanWithError(childSpan, errorObj);
+                throw err;
+              } finally {
+                childSpan.end();
+              }
+            }
           );
-          for await (const event of streamResult.fullStream) {
-            switch (event.type) {
-              case "text-delta":
-                await parser.processTextChunk(event.text);
-                break;
-              case "tool-call":
-                parser.markToolResult();
-                break;
-              case "tool-result":
-                parser.markToolResult();
-                break;
-              case "finish":
-                if (event.finishReason === "tool-calls") {
-                  parser.markToolResult();
-                }
-                break;
-              case "error":
-                if (event.error instanceof Error) {
-                  throw event.error;
-                } else {
-                  const errorMessage = event.error?.error?.message;
-                  throw new Error(errorMessage);
+          const allTools = {
+            ...mcpTools,
+            ...functionTools,
+            ...relationTools,
+            ...defaultTools
+          };
+          const sanitizedTools = this.sanitizeToolsForAISDK(allTools);
+          let conversationHistory = "";
+          const historyConfig = this.config.conversationHistoryConfig ?? createDefaultConversationHistoryConfig();
+          if (historyConfig && historyConfig.mode !== "none") {
+            if (historyConfig.mode === "full") {
+              conversationHistory = await getFormattedConversationHistory({
+                tenantId: this.config.tenantId,
+                projectId: this.config.projectId,
+                conversationId: contextId,
+                currentMessage: userMessage,
+                options: historyConfig,
+                filters: {}
+              });
+            } else if (historyConfig.mode === "scoped") {
+              conversationHistory = await getFormattedConversationHistory({
+                tenantId: this.config.tenantId,
+                projectId: this.config.projectId,
+                conversationId: contextId,
+                currentMessage: userMessage,
+                options: historyConfig,
+                filters: {
+                  subAgentId: this.config.id,
+                  taskId
                 }
+              });
             }
           }
-          await parser.finalize();
-          response = await streamResult;
-          const collectedParts = parser.getCollectedParts();
-          if (collectedParts.length > 0) {
-            response.formattedContent = {
-              parts: collectedParts.map((part) => ({
-                kind: part.kind,
-                ...part.kind === "text" && { text: part.text },
-                ...part.kind === "data" && { data: part.data }
-              }))
-            };
+          const primaryModelSettings = this.getPrimaryModel();
+          const modelSettings = ModelFactory.prepareGenerationConfig(primaryModelSettings);
+          let response;
+          let textResponse;
+          const hasStructuredOutput = this.config.dataComponents && this.config.dataComponents.length > 0;
+          const shouldStreamPhase1 = this.getStreamingHelper() && !hasStructuredOutput;
+          const MAX_ALLOWED_TIMEOUT_MS = 6e5;
+          const configuredTimeout = modelSettings.maxDuration ? Math.min(modelSettings.maxDuration * 1e3, MAX_ALLOWED_TIMEOUT_MS) : shouldStreamPhase1 ? CONSTANTS.PHASE_1_TIMEOUT_MS : CONSTANTS.NON_STREAMING_PHASE_1_TIMEOUT_MS;
+          const timeoutMs = Math.min(configuredTimeout, MAX_ALLOWED_TIMEOUT_MS);
+          if (modelSettings.maxDuration && modelSettings.maxDuration * 1e3 > MAX_ALLOWED_TIMEOUT_MS) {
+            logger15.warn(
+              {
+                requestedTimeout: modelSettings.maxDuration * 1e3,
+                appliedTimeout: timeoutMs,
+                maxAllowed: MAX_ALLOWED_TIMEOUT_MS
+              },
+              "Requested timeout exceeded maximum allowed, capping to 10 minutes"
+            );
           }
-          const streamedContent = parser.getAllStreamedContent();
-          if (streamedContent.length > 0) {
-            response.streamedContent = {
-              parts: streamedContent.map((part) => ({
-                kind: part.kind,
-                ...part.kind === "text" && { text: part.text },
-                ...part.kind === "data" && { data: part.data }
-              }))
-            };
+          const phase1SystemPrompt = hasStructuredOutput ? thinkingSystemPrompt : systemPrompt;
+          const messages = [];
+          messages.push({ role: "system", content: phase1SystemPrompt });
+          if (conversationHistory.trim() !== "") {
+            messages.push({ role: "user", content: conversationHistory });
           }
-        } else {
-          let genConfig;
-          if (hasStructuredOutput) {
-            genConfig = {
-              ...modelSettings,
-              toolChoice: "required"
-              // Force tool usage, prevent text generation
-            };
-          } else {
-            genConfig = {
+          messages.push({
+            role: "user",
+            content: userMessage
+          });
+          if (shouldStreamPhase1) {
+            const streamConfig = {
               ...modelSettings,
               toolChoice: "auto"
-              // Allow both tools and text generation
+              // Allow natural text + tools
             };
-          }
-          response = await generateText({
-            ...genConfig,
-            messages,
-            tools: sanitizedTools,
-            stopWhen: async ({ steps }) => {
-              const last = steps.at(-1);
-              if (last && "text" in last && last.text) {
-                try {
-                  await agentSessionManager.recordEvent(
-                    this.getStreamRequestId(),
-                    "agent_reasoning",
-                    this.config.id,
-                    {
-                      parts: [{ type: "text", content: last.text }]
-                    }
-                  );
-                } catch (error) {
-                  logger15.debug({ error }, "Failed to track agent reasoning");
+            const streamResult = streamText({
+              ...streamConfig,
+              messages,
+              tools: sanitizedTools,
+              stopWhen: async ({ steps }) => {
+                const last = steps.at(-1);
+                if (last && "text" in last && last.text) {
+                  try {
+                    await agentSessionManager.recordEvent(
+                      this.getStreamRequestId(),
+                      "agent_reasoning",
+                      this.config.id,
+                      {
+                        parts: [{ type: "text", content: last.text }]
+                      }
+                    );
+                  } catch (error) {
+                    logger15.debug({ error }, "Failed to track agent reasoning");
+                  }
                 }
-              }
-              if (steps.length >= 2) {
-                const previousStep = steps[steps.length - 2];
-                if (previousStep && "toolCalls" in previousStep && previousStep.toolCalls) {
-                  const hasStopTool = previousStep.toolCalls.some(
-                    (tc) => tc.toolName.startsWith("transfer_to_") || tc.toolName === "thinking_complete"
-                  );
-                  if (hasStopTool && "toolResults" in previousStep && previousStep.toolResults) {
-                    return true;
+                if (steps.length >= 2) {
+                  const previousStep = steps[steps.length - 2];
+                  if (previousStep && "toolCalls" in previousStep && previousStep.toolCalls) {
+                    const hasTransferCall = previousStep.toolCalls.some(
+                      (tc) => tc.toolName.startsWith("transfer_to_")
+                    );
+                    if (hasTransferCall && "toolResults" in previousStep && previousStep.toolResults) {
+                      return true;
+                    }
                   }
                 }
+                return steps.length >= this.getMaxGenerationSteps();
+              },
+              experimental_telemetry: {
+                isEnabled: true,
+                functionId: this.config.id,
+                recordInputs: true,
+                recordOutputs: true
+              },
+              abortSignal: AbortSignal.timeout(timeoutMs)
+            });
+            const streamHelper = this.getStreamingHelper();
+            if (!streamHelper) {
+              throw new Error("Stream helper is unexpectedly undefined in streaming context");
+            }
+            const session = toolSessionManager.getSession(sessionId);
+            const artifactParserOptions = {
+              sessionId,
+              taskId: session?.taskId,
+              projectId: session?.projectId,
+              artifactComponents: this.artifactComponents,
+              streamRequestId: this.getStreamRequestId(),
+              subAgentId: this.config.id
+            };
+            const parser = new IncrementalStreamParser(
+              streamHelper,
+              this.config.tenantId,
+              contextId,
+              artifactParserOptions
+            );
+            for await (const event of streamResult.fullStream) {
+              switch (event.type) {
+                case "text-delta":
+                  await parser.processTextChunk(event.text);
+                  break;
+                case "tool-call":
+                  parser.markToolResult();
+                  break;
+                case "tool-result":
+                  parser.markToolResult();
+                  break;
+                case "finish":
+                  if (event.finishReason === "tool-calls") {
+                    parser.markToolResult();
+                  }
+                  break;
+                case "error":
+                  if (event.error instanceof Error) {
+                    throw event.error;
+                  } else {
+                    const errorMessage = event.error?.error?.message;
+                    throw new Error(errorMessage);
+                  }
               }
-              return steps.length >= this.getMaxGenerationSteps();
-            },
-            experimental_telemetry: {
-              isEnabled: true,
-              functionId: this.config.id,
-              recordInputs: true,
-              recordOutputs: true,
-              metadata: {
-                phase: "planning"
-              }
-            },
-            abortSignal: AbortSignal.timeout(timeoutMs)
-          });
-        }
-        if (response.steps) {
-          const resolvedSteps = await response.steps;
-          response = { ...response, steps: resolvedSteps };
-        }
-        if (hasStructuredOutput && !hasToolCallWithPrefix("transfer_to_")(response)) {
-          const thinkingCompleteCall = response.steps?.flatMap((s) => s.toolCalls || [])?.find((tc) => tc.toolName === "thinking_complete");
-          if (thinkingCompleteCall) {
-            const reasoningFlow = [];
-            if (response.steps) {
-              response.steps.forEach((step) => {
-                if (step.toolCalls && step.toolResults) {
-                  step.toolCalls.forEach((call, index) => {
-                    const result = step.toolResults[index];
-                    if (result) {
-                      const storedResult = toolSessionManager.getToolResult(
-                        sessionId,
-                        result.toolCallId
-                      );
-                      const toolName = storedResult?.toolName || call.toolName;
-                      if (toolName === "thinking_complete") {
-                        return;
+            }
+            await parser.finalize();
+            response = await streamResult;
+            const collectedParts = parser.getCollectedParts();
+            if (collectedParts.length > 0) {
+              response.formattedContent = {
+                parts: collectedParts.map((part) => ({
+                  kind: part.kind,
+                  ...part.kind === "text" && { text: part.text },
+                  ...part.kind === "data" && { data: part.data }
+                }))
+              };
+            }
+            const streamedContent = parser.getAllStreamedContent();
+            if (streamedContent.length > 0) {
+              response.streamedContent = {
+                parts: streamedContent.map((part) => ({
+                  kind: part.kind,
+                  ...part.kind === "text" && { text: part.text },
+                  ...part.kind === "data" && { data: part.data }
+                }))
+              };
+            }
+          } else {
+            let genConfig;
+            if (hasStructuredOutput) {
+              genConfig = {
+                ...modelSettings,
+                toolChoice: "required"
+                // Force tool usage, prevent text generation
+              };
+            } else {
+              genConfig = {
+                ...modelSettings,
+                toolChoice: "auto"
+                // Allow both tools and text generation
+              };
+            }
+            response = await generateText({
+              ...genConfig,
+              messages,
+              tools: sanitizedTools,
+              stopWhen: async ({ steps }) => {
+                const last = steps.at(-1);
+                if (last && "text" in last && last.text) {
+                  try {
+                    await agentSessionManager.recordEvent(
+                      this.getStreamRequestId(),
+                      "agent_reasoning",
+                      this.config.id,
+                      {
+                        parts: [{ type: "text", content: last.text }]
                       }
-                      const actualResult = storedResult?.result || result.result || result;
-                      const actualArgs = storedResult?.args || call.args;
-                      const cleanResult = actualResult && typeof actualResult === "object" && !Array.isArray(actualResult) ? Object.fromEntries(
-                        Object.entries(actualResult).filter(
-                          ([key]) => key !== "_structureHints"
-                        )
-                      ) : actualResult;
-                      const input = actualArgs ? JSON.stringify(actualArgs, null, 2) : "No input";
-                      const output = typeof cleanResult === "string" ? cleanResult : JSON.stringify(cleanResult, null, 2);
-                      let structureHintsFormatted = "";
-                      if (actualResult?._structureHints && this.artifactComponents && this.artifactComponents.length > 0) {
-                        const hints = actualResult._structureHints;
-                        structureHintsFormatted = `
+                    );
+                  } catch (error) {
+                    logger15.debug({ error }, "Failed to track agent reasoning");
+                  }
+                }
+                if (steps.length >= 2) {
+                  const previousStep = steps[steps.length - 2];
+                  if (previousStep && "toolCalls" in previousStep && previousStep.toolCalls) {
+                    const hasStopTool = previousStep.toolCalls.some(
+                      (tc) => tc.toolName.startsWith("transfer_to_") || tc.toolName === "thinking_complete"
+                    );
+                    if (hasStopTool && "toolResults" in previousStep && previousStep.toolResults) {
+                      return true;
+                    }
+                  }
+                }
+                return steps.length >= this.getMaxGenerationSteps();
+              },
+              experimental_telemetry: {
+                isEnabled: true,
+                functionId: this.config.id,
+                recordInputs: true,
+                recordOutputs: true,
+                metadata: {
+                  phase: "planning"
+                }
+              },
+              abortSignal: AbortSignal.timeout(timeoutMs)
+            });
+          }
+          if (response.steps) {
+            const resolvedSteps = await response.steps;
+            response = { ...response, steps: resolvedSteps };
+          }
+          if (hasStructuredOutput && !hasToolCallWithPrefix("transfer_to_")(response)) {
+            const thinkingCompleteCall = response.steps?.flatMap((s) => s.toolCalls || [])?.find((tc) => tc.toolName === "thinking_complete");
+            if (thinkingCompleteCall) {
+              const reasoningFlow = [];
+              if (response.steps) {
+                response.steps.forEach((step) => {
+                  if (step.toolCalls && step.toolResults) {
+                    step.toolCalls.forEach((call, index) => {
+                      const result = step.toolResults[index];
+                      if (result) {
+                        const storedResult = toolSessionManager.getToolResult(
+                          sessionId,
+                          result.toolCallId
+                        );
+                        const toolName = storedResult?.toolName || call.toolName;
+                        if (toolName === "thinking_complete") {
+                          return;
+                        }
+                        const actualResult = storedResult?.result || result.result || result;
+                        const actualArgs = storedResult?.args || call.args;
+                        const cleanResult = actualResult && typeof actualResult === "object" && !Array.isArray(actualResult) ? Object.fromEntries(
+                          Object.entries(actualResult).filter(
+                            ([key]) => key !== "_structureHints"
+                          )
+                        ) : actualResult;
+                        const input = actualArgs ? JSON.stringify(actualArgs, null, 2) : "No input";
+                        const output = typeof cleanResult === "string" ? cleanResult : JSON.stringify(cleanResult, null, 2);
+                        let structureHintsFormatted = "";
+                        if (actualResult?._structureHints && this.artifactComponents && this.artifactComponents.length > 0) {
+                          const hints = actualResult._structureHints;
+                          structureHintsFormatted = `
 ### \u{1F4CA} Structure Hints for Artifact Creation
 
 **Terminal Field Paths (${hints.terminalPaths?.length || 0} found):**
@@ -8020,8 +8027,8 @@ ${hints.commonFields?.map((field) => `  \u2022 ${field}`).join("\n") || "  None
 
 **Forbidden Syntax:** ${hints.forbiddenSyntax || "Use these paths for artifact base selectors."}
 `;
-                      }
-                      const formattedResult = `## Tool: ${call.toolName}
+                        }
+                        const formattedResult = `## Tool: ${call.toolName}
 
 ### \u{1F527} TOOL_CALL_ID: ${result.toolCallId}
 
@@ -8030,130 +8037,61 @@ ${input}
 
 ### Output
 ${output}${structureHintsFormatted}`;
-                      reasoningFlow.push({
-                        role: "assistant",
-                        content: formattedResult
-                      });
-                    }
-                  });
-                }
-              });
-            }
-            const componentSchemas = [];
-            if (this.config.dataComponents && this.config.dataComponents.length > 0) {
-              this.config.dataComponents.forEach((dc) => {
-                const propsSchema = jsonSchemaToZod(dc.props);
-                componentSchemas.push(
-                  z.object({
-                    id: z.string(),
-                    name: z.literal(dc.name),
-                    props: propsSchema
-                  })
-                );
-              });
-            }
-            if (this.artifactComponents.length > 0) {
-              const artifactCreateSchemas = ArtifactCreateSchema.getSchemas(
-                this.artifactComponents
-              );
-              componentSchemas.push(...artifactCreateSchemas);
-              componentSchemas.push(ArtifactReferenceSchema.getSchema());
-            }
-            let dataComponentsSchema;
-            if (componentSchemas.length === 1) {
-              dataComponentsSchema = componentSchemas[0];
-            } else {
-              dataComponentsSchema = z.union(
-                componentSchemas
-              );
-            }
-            const structuredModelSettings = ModelFactory.prepareGenerationConfig(
-              this.getStructuredOutputModel()
-            );
-            const phase2TimeoutMs = structuredModelSettings.maxDuration ? structuredModelSettings.maxDuration * 1e3 : CONSTANTS.PHASE_2_TIMEOUT_MS;
-            const shouldStreamPhase2 = this.getStreamingHelper();
-            if (shouldStreamPhase2) {
-              const phase2Messages = [
-                {
-                  role: "system",
-                  content: await this.buildPhase2SystemPrompt(runtimeContext)
-                }
-              ];
-              if (conversationHistory.trim() !== "") {
-                phase2Messages.push({ role: "user", content: conversationHistory });
-              }
-              phase2Messages.push({ role: "user", content: userMessage });
-              phase2Messages.push(...reasoningFlow);
-              const streamResult = streamObject({
-                ...structuredModelSettings,
-                messages: phase2Messages,
-                schema: z.object({
-                  dataComponents: z.array(dataComponentsSchema)
-                }),
-                experimental_telemetry: {
-                  isEnabled: true,
-                  functionId: this.config.id,
-                  recordInputs: true,
-                  recordOutputs: true,
-                  metadata: {
-                    phase: "structured_generation"
+                        reasoningFlow.push({
+                          role: "assistant",
+                          content: formattedResult
+                        });
+                      }
+                    });
                   }
-                },
-                abortSignal: AbortSignal.timeout(phase2TimeoutMs)
-              });
-              const streamHelper = this.getStreamingHelper();
-              if (!streamHelper) {
-                throw new Error("Stream helper is unexpectedly undefined in streaming context");
+                });
               }
-              const session = toolSessionManager.getSession(sessionId);
-              const artifactParserOptions = {
-                sessionId,
-                taskId: session?.taskId,
-                projectId: session?.projectId,
-                artifactComponents: this.artifactComponents,
-                streamRequestId: this.getStreamRequestId(),
-                subAgentId: this.config.id
-              };
-              const parser = new IncrementalStreamParser(
-                streamHelper,
-                this.config.tenantId,
-                contextId,
-                artifactParserOptions
-              );
-              for await (const delta of streamResult.partialObjectStream) {
-                if (delta) {
-                  await parser.processObjectDelta(delta);
-                }
+              const componentSchemas = [];
+              if (this.config.dataComponents && this.config.dataComponents.length > 0) {
+                this.config.dataComponents.forEach((dc) => {
+                  const propsSchema = jsonSchemaToZod(dc.props);
+                  componentSchemas.push(
+                    z.object({
+                      id: z.string(),
+                      name: z.literal(dc.name),
+                      props: propsSchema
+                    })
+                  );
+                });
               }
-              await parser.finalize();
-              const structuredResponse = await streamResult;
-              const collectedParts = parser.getCollectedParts();
-              if (collectedParts.length > 0) {
-                response.formattedContent = {
-                  parts: collectedParts.map((part) => ({
-                    kind: part.kind,
-                    ...part.kind === "text" && { text: part.text },
-                    ...part.kind === "data" && { data: part.data }
-                  }))
-                };
+              if (this.artifactComponents.length > 0) {
+                const artifactCreateSchemas = ArtifactCreateSchema.getSchemas(
+                  this.artifactComponents
+                );
+                componentSchemas.push(...artifactCreateSchemas);
+                componentSchemas.push(ArtifactReferenceSchema.getSchema());
               }
-              response = {
-                ...response,
-                object: structuredResponse.object
-              };
-              textResponse = JSON.stringify(structuredResponse.object, null, 2);
-            } else {
-              const { withJsonPostProcessing } = await import('./json-postprocessor-VOMU4E5L.js');
-              const phase2Messages = [
-                { role: "system", content: await this.buildPhase2SystemPrompt(runtimeContext) }
-              ];
-              if (conversationHistory.trim() !== "") {
-                phase2Messages.push({ role: "user", content: conversationHistory });
+              let dataComponentsSchema;
+              if (componentSchemas.length === 1) {
+                dataComponentsSchema = componentSchemas[0];
+              } else {
+                dataComponentsSchema = z.union(
+                  componentSchemas
+                );
               }
-              phase2Messages.push({ role: "user", content: userMessage });
-              phase2Messages.push(...reasoningFlow);
-              const structuredResponse = await generateObject(
-                withJsonPostProcessing({
+              const structuredModelSettings = ModelFactory.prepareGenerationConfig(
+                this.getStructuredOutputModel()
+              );
+              const phase2TimeoutMs = structuredModelSettings.maxDuration ? structuredModelSettings.maxDuration * 1e3 : CONSTANTS.PHASE_2_TIMEOUT_MS;
+              const shouldStreamPhase2 = this.getStreamingHelper();
+              if (shouldStreamPhase2) {
+                const phase2Messages = [
+                  {
+                    role: "system",
+                    content: await this.buildPhase2SystemPrompt(runtimeContext)
+                  }
+                ];
+                if (conversationHistory.trim() !== "") {
+                  phase2Messages.push({ role: "user", content: conversationHistory });
+                }
+                phase2Messages.push({ role: "user", content: userMessage });
+                phase2Messages.push(...reasoningFlow);
+                const streamResult = streamObject({
                   ...structuredModelSettings,
                   messages: phase2Messages,
                   schema: z.object({
@@ -8169,65 +8107,135 @@ ${output}${structureHintsFormatted}`;
                     }
                   },
                   abortSignal: AbortSignal.timeout(phase2TimeoutMs)
-                })
-              );
-              response = {
-                ...response,
-                object: structuredResponse.object
-              };
-              textResponse = JSON.stringify(structuredResponse.object, null, 2);
+                });
+                const streamHelper = this.getStreamingHelper();
+                if (!streamHelper) {
+                  throw new Error("Stream helper is unexpectedly undefined in streaming context");
+                }
+                const session = toolSessionManager.getSession(sessionId);
+                const artifactParserOptions = {
+                  sessionId,
+                  taskId: session?.taskId,
+                  projectId: session?.projectId,
+                  artifactComponents: this.artifactComponents,
+                  streamRequestId: this.getStreamRequestId(),
+                  subAgentId: this.config.id
+                };
+                const parser = new IncrementalStreamParser(
+                  streamHelper,
+                  this.config.tenantId,
+                  contextId,
+                  artifactParserOptions
+                );
+                for await (const delta of streamResult.partialObjectStream) {
+                  if (delta) {
+                    await parser.processObjectDelta(delta);
+                  }
+                }
+                await parser.finalize();
+                const structuredResponse = await streamResult;
+                const collectedParts = parser.getCollectedParts();
+                if (collectedParts.length > 0) {
+                  response.formattedContent = {
+                    parts: collectedParts.map((part) => ({
+                      kind: part.kind,
+                      ...part.kind === "text" && { text: part.text },
+                      ...part.kind === "data" && { data: part.data }
+                    }))
+                  };
+                }
+                response = {
+                  ...response,
+                  object: structuredResponse.object
+                };
+                textResponse = JSON.stringify(structuredResponse.object, null, 2);
+              } else {
+                const { withJsonPostProcessing } = await import('./json-postprocessor-VOMU4E5L.js');
+                const phase2Messages = [
+                  { role: "system", content: await this.buildPhase2SystemPrompt(runtimeContext) }
+                ];
+                if (conversationHistory.trim() !== "") {
+                  phase2Messages.push({ role: "user", content: conversationHistory });
+                }
+                phase2Messages.push({ role: "user", content: userMessage });
+                phase2Messages.push(...reasoningFlow);
+                const structuredResponse = await generateObject(
+                  withJsonPostProcessing({
+                    ...structuredModelSettings,
+                    messages: phase2Messages,
+                    schema: z.object({
+                      dataComponents: z.array(dataComponentsSchema)
+                    }),
+                    experimental_telemetry: {
+                      isEnabled: true,
+                      functionId: this.config.id,
+                      recordInputs: true,
+                      recordOutputs: true,
+                      metadata: {
+                        phase: "structured_generation"
+                      }
+                    },
+                    abortSignal: AbortSignal.timeout(phase2TimeoutMs)
+                  })
+                );
+                response = {
+                  ...response,
+                  object: structuredResponse.object
+                };
+                textResponse = JSON.stringify(structuredResponse.object, null, 2);
+              }
+            } else {
+              textResponse = response.text || "";
             }
           } else {
-            textResponse = response.text || "";
+            textResponse = response.steps[response.steps.length - 1].text || "";
           }
-        } else {
-          textResponse = response.steps[response.steps.length - 1].text || "";
-        }
-        span.setStatus({ code: SpanStatusCode.OK });
-        span.end();
-        let formattedContent = response.formattedContent || null;
-        if (!formattedContent) {
-          const session = toolSessionManager.getSession(sessionId);
-          const responseFormatter = new ResponseFormatter(this.config.tenantId, {
-            sessionId,
-            taskId: session?.taskId,
-            projectId: session?.projectId,
-            contextId,
-            artifactComponents: this.artifactComponents,
-            streamRequestId: this.getStreamRequestId(),
-            subAgentId: this.config.id
-          });
-          if (response.object) {
-            formattedContent = await responseFormatter.formatObjectResponse(
-              response.object,
-              contextId
-            );
-          } else if (textResponse) {
-            formattedContent = await responseFormatter.formatResponse(textResponse, contextId);
+          span.setStatus({ code: SpanStatusCode.OK });
+          span.end();
+          let formattedContent = response.formattedContent || null;
+          if (!formattedContent) {
+            const session = toolSessionManager.getSession(sessionId);
+            const responseFormatter = new ResponseFormatter(this.config.tenantId, {
+              sessionId,
+              taskId: session?.taskId,
+              projectId: session?.projectId,
+              contextId,
+              artifactComponents: this.artifactComponents,
+              streamRequestId: this.getStreamRequestId(),
+              subAgentId: this.config.id
+            });
+            if (response.object) {
+              formattedContent = await responseFormatter.formatObjectResponse(
+                response.object,
+                contextId
+              );
+            } else if (textResponse) {
+              formattedContent = await responseFormatter.formatResponse(textResponse, contextId);
+            }
           }
+          const formattedResponse = {
+            ...response,
+            formattedContent
+          };
+          if (streamRequestId) {
+            const generationType = response.object ? "object_generation" : "text_generation";
+            agentSessionManager.recordEvent(streamRequestId, "agent_generate", this.config.id, {
+              parts: (formattedContent?.parts || []).map((part) => ({
+                type: part.kind === "text" ? "text" : part.kind === "data" ? "tool_result" : "text",
+                content: part.text || JSON.stringify(part.data)
+              })),
+              generationType
+            });
+          }
+          return formattedResponse;
+        } catch (error) {
+          const errorToThrow = error instanceof Error ? error : new Error(String(error));
+          setSpanWithError(span, errorToThrow);
+          span.end();
+          throw errorToThrow;
         }
-        const formattedResponse = {
-          ...response,
-          formattedContent
-        };
-        if (streamRequestId) {
-          const generationType = response.object ? "object_generation" : "text_generation";
-          agentSessionManager.recordEvent(streamRequestId, "agent_generate", this.config.id, {
-            parts: (formattedContent?.parts || []).map((part) => ({
-              type: part.kind === "text" ? "text" : part.kind === "data" ? "tool_result" : "text",
-              content: part.text || JSON.stringify(part.data)
-            })),
-            generationType
-          });
-        }
-        return formattedResponse;
-      } catch (error) {
-        const errorToThrow = error instanceof Error ? error : new Error(String(error));
-        setSpanWithError(span, errorToThrow);
-        span.end();
-        throw errorToThrow;
       }
-    });
+    );
   }
 };
 
@@ -8518,7 +8526,7 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
                 },
                 artifacts: [
                   {
-                    artifactId: nanoid(),
+                    artifactId: generateId(),
                     parts: [
                       {
                         kind: "data",
@@ -8551,7 +8559,7 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
         status: { state: TaskState.Completed },
         artifacts: [
           {
-            artifactId: nanoid(),
+            artifactId: generateId(),
             parts
           }
         ]
@@ -9880,7 +9888,7 @@ var ExecutionHandler = class {
                 "ai.subAgent.name": currentAgentId
               });
               await createMessage(dbClient_default)({
-                id: nanoid(),
+                id: generateId(),
                 tenantId,
                 projectId,
                 conversationId,
@@ -10269,7 +10277,7 @@ app2.openapi(chatCompletionsRoute, async (c) => {
         });
       }
       await createMessage(dbClient_default)({
-        id: nanoid(),
+        id: generateId(),
         tenantId,
         projectId,
         conversationId,
@@ -10498,7 +10506,7 @@ app3.openapi(chatDataStreamRoute, async (c) => {
         });
       }
       await createMessage(dbClient_default)({
-        id: nanoid(),
+        id: generateId(),
         tenantId,
         projectId,
         conversationId,
@@ -10948,7 +10956,7 @@ var processUserMessage = async (tenantId, projectId, conversationId, query) => {
     });
   }
   await createMessage(dbClient_default)({
-    id: nanoid(),
+    id: generateId(),
     tenantId,
     projectId,
     conversationId,