@inkeep/agents-run-api 0.31.6 → 0.32.0

package/dist/index.js

@@ -1,10 +1,11 @@
-import { flushBatchProcessor } from './chunk-DWEFKQTA.js';
-import { getFormattedConversationHistory, createDefaultConversationHistoryConfig, saveA2AMessageResponse } from './chunk-IMJLQGAX.js';
-import { dbClient_default } from './chunk-TRNLEUK2.js';
-import { env } from './chunk-Z4TYO3W3.js';
+import { flushBatchProcessor } from './chunk-YBBSNUL3.js';
+import { getFormattedConversationHistory, createDefaultConversationHistoryConfig, saveA2AMessageResponse } from './chunk-54Z7AOV4.js';
+import { dbClient_default } from './chunk-BYF2SHLS.js';
+import { env } from './chunk-N2FZD53W.js';
 import { getLogger } from './chunk-A2S7GSHL.js';
+import { STREAM_PARSER_MAX_SNAPSHOT_SIZE, STREAM_PARSER_MAX_STREAMED_SIZE, STREAM_PARSER_MAX_COLLECTED_PARTS, STREAM_BUFFER_MAX_SIZE_BYTES, SESSION_CLEANUP_INTERVAL_MS, STREAM_MAX_LIFETIME_MS, STREAM_TEXT_GAP_THRESHOLD_MS, AGENT_EXECUTION_MAX_CONSECUTIVE_ERRORS, SESSION_TOOL_RESULT_CACHE_TIMEOUT_MS, ARTIFACT_GENERATION_MAX_RETRIES, ARTIFACT_SESSION_MAX_PENDING, STATUS_UPDATE_DEFAULT_INTERVAL_SECONDS, STATUS_UPDATE_DEFAULT_NUM_EVENTS, ARTIFACT_SESSION_MAX_PREVIOUS_SUMMARIES, ARTIFACT_GENERATION_BACKOFF_INITIAL_MS, ARTIFACT_GENERATION_BACKOFF_MAX_MS, AGENT_EXECUTION_MAX_GENERATION_STEPS, FUNCTION_TOOL_SANDBOX_VCPUS_DEFAULT, FUNCTION_TOOL_EXECUTION_TIMEOUT_MS_DEFAULT, LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS, LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_STREAMING, LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_NON_STREAMING, LLM_GENERATION_SUBSEQUENT_CALL_TIMEOUT_MS, DELEGATION_TOOL_BACKOFF_MAX_ELAPSED_TIME_MS, DELEGATION_TOOL_BACKOFF_EXPONENT, DELEGATION_TOOL_BACKOFF_MAX_INTERVAL_MS, DELEGATION_TOOL_BACKOFF_INITIAL_INTERVAL_MS } from './chunk-IVALDC72.js';
 import { __publicField } from './chunk-PKBMQBKP.js';
-import { getTracer, HeadersScopeSchema, getRequestExecutionContext, createApiError, getAgentWithDefaultSubAgent, contextValidationMiddleware, getConversationId, getFullAgent, createOrGetConversation, getActiveAgentForConversation, setActiveAgentForConversation, getSubAgentById, handleContextResolution, createMessage, generateId, commonGetErrorResponses, loggerFactory, createDefaultCredentialStores, CredentialStoreRegistry, listTaskIdsByContextId, getTask, getLedgerArtifacts, upsertLedgerArtifact, createTask, updateTask, setSpanWithError, updateConversation, handleApiError, TaskState, setActiveAgentForThread, getConversation, getAgentById, getRelatedAgentsForAgent, getExternalAgentsForSubAgent, getTeamAgentsForSubAgent, getToolsForAgent, getDataComponentsForAgent, getArtifactComponentsForAgent, dbResultToMcpTool, validateAndGetApiKey, verifyServiceToken, validateTargetAgent, getProject, ContextResolver, CredentialStuffer, MCPServerType, getCredentialReference, McpClient, getFunctionToolsForSubAgent, getFunction, getContextConfigById, getFullAgentDefinition, TemplateEngine, agentHasArtifactComponents, MCPTransportType, SPAN_KEYS, headers, generateServiceToken } from '@inkeep/agents-core';
+import { getTracer, HeadersScopeSchema, getRequestExecutionContext, createApiError, getAgentWithDefaultSubAgent, contextValidationMiddleware, getConversationId, getFullAgent, createOrGetConversation, getActiveAgentForConversation, setActiveAgentForConversation, getSubAgentById, handleContextResolution, createMessage, generateId, commonGetErrorResponses, loggerFactory, createDefaultCredentialStores, CredentialStoreRegistry, listTaskIdsByContextId, getTask, getLedgerArtifacts, upsertLedgerArtifact, createTask, updateTask, setSpanWithError, AGENT_EXECUTION_TRANSFER_COUNT_DEFAULT, updateConversation, handleApiError, CONVERSATION_HISTORY_MAX_OUTPUT_TOKENS_DEFAULT, CONVERSATION_HISTORY_DEFAULT_LIMIT, TaskState, setActiveAgentForThread, getConversation, getAgentById, getRelatedAgentsForAgent, getExternalAgentsForSubAgent, getTeamAgentsForSubAgent, getToolsForAgent, getDataComponentsForAgent, getArtifactComponentsForAgent, dbResultToMcpTool, validateAndGetApiKey, verifyServiceToken, validateTargetAgent, getProject, ContextResolver, CredentialStuffer, MCPServerType, getCredentialReference, McpClient, getFunctionToolsForSubAgent, getFunction, getContextConfigById, getFullAgentDefinition, TemplateEngine, agentHasArtifactComponents, MCPTransportType, SPAN_KEYS, headers, generateServiceToken } 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';
@@ -1120,11 +1121,9 @@ __publicField(_ModelFactory, "BUILT_IN_PROVIDERS", [
 var ModelFactory = _ModelFactory;
 var logger4 = getLogger("ToolSessionManager");
 var _ToolSessionManager = class _ToolSessionManager {
-  // 5 minutes
   constructor() {
     __publicField(this, "sessions", /* @__PURE__ */ new Map());
-    __publicField(this, "SESSION_TIMEOUT", 5 * 60 * 1e3);
-    setInterval(() => this.cleanupExpiredSessions(), 6e4);
+    setInterval(() => this.cleanupExpiredSessions(), SESSION_CLEANUP_INTERVAL_MS);
   }
   static getInstance() {
     if (!_ToolSessionManager.instance) {
@@ -1269,7 +1268,7 @@ var _ToolSessionManager = class _ToolSessionManager {
     const now = Date.now();
     const expiredSessions = [];
     for (const [sessionId, session] of this.sessions.entries()) {
-      if (now - session.createdAt > this.SESSION_TIMEOUT) {
+      if (now - session.createdAt > SESSION_TOOL_RESULT_CACHE_TIMEOUT_MS) {
         expiredSessions.push(sessionId);
       }
     }
@@ -1534,7 +1533,16 @@ var _ArtifactService = class _ArtifactService {
         );
         return null;
       }
-      const artifacts = await getLedgerArtifacts(dbClient_default)({
+      let artifacts = [];
+      artifacts = await getLedgerArtifacts(dbClient_default)({
+        scopes: { tenantId: this.context.tenantId, projectId: this.context.projectId },
+        artifactId,
+        toolCallId
+      });
+      if (artifacts.length > 0) {
+        return this.formatArtifactSummaryData(artifacts[0], artifactId, toolCallId);
+      }
+      artifacts = await getLedgerArtifacts(dbClient_default)({
         scopes: { tenantId: this.context.tenantId, projectId: this.context.projectId },
         artifactId,
         taskId: this.context.taskId
@@ -1580,7 +1588,16 @@ var _ArtifactService = class _ArtifactService {
         );
         return null;
       }
-      const artifacts = await getLedgerArtifacts(dbClient_default)({
+      let artifacts = [];
+      artifacts = await getLedgerArtifacts(dbClient_default)({
+        scopes: { tenantId: this.context.tenantId, projectId: this.context.projectId },
+        artifactId,
+        toolCallId
+      });
+      if (artifacts.length > 0) {
+        return this.formatArtifactFullData(artifacts[0], artifactId, toolCallId);
+      }
+      artifacts = await getLedgerArtifacts(dbClient_default)({
         scopes: { tenantId: this.context.tenantId, projectId: this.context.projectId },
         artifactId,
         taskId: this.context.taskId
@@ -2423,8 +2440,8 @@ var AgentSession = class {
     // Track pending artifact processing
     __publicField(this, "artifactProcessingErrors", /* @__PURE__ */ new Map());
     // Track errors per artifact
-    __publicField(this, "MAX_ARTIFACT_RETRIES", 3);
-    __publicField(this, "MAX_PENDING_ARTIFACTS", 100);
+    __publicField(this, "MAX_ARTIFACT_RETRIES", ARTIFACT_GENERATION_MAX_RETRIES);
+    __publicField(this, "MAX_PENDING_ARTIFACTS", ARTIFACT_SESSION_MAX_PENDING);
     // Prevent unbounded growth
     __publicField(this, "scheduledTimeouts");
     // Track scheduled timeouts for cleanup
@@ -2544,8 +2561,8 @@ var AgentSession = class {
       summarizerModel,
       baseModel,
       config: {
-        numEvents: config.numEvents || 1,
-        timeInSeconds: config.timeInSeconds || 2,
+        numEvents: config.numEvents || STATUS_UPDATE_DEFAULT_NUM_EVENTS,
+        timeInSeconds: config.timeInSeconds || STATUS_UPDATE_DEFAULT_INTERVAL_SECONDS,
         ...config
       }
     };
@@ -2888,7 +2905,7 @@ var AgentSession = class {
         }
         return;
       }
-      if (this.previousSummaries.length > 3) {
+      if (this.previousSummaries.length > ARTIFACT_SESSION_MAX_PREVIOUS_SUMMARIES) {
         this.previousSummaries.shift();
       }
       if (this.statusUpdateState) {
@@ -3001,9 +3018,8 @@ var AgentSession = class {
                 projectId: this.projectId,
                 conversationId: this.sessionId,
                 options: {
-                  limit: 10,
-                  // Get recent conversation context
-                  maxOutputTokens: 2e3
+                  limit: CONVERSATION_HISTORY_DEFAULT_LIMIT,
+                  maxOutputTokens: CONVERSATION_HISTORY_MAX_OUTPUT_TOKENS_DEFAULT
                 },
                 filters: {}
               });
@@ -3532,7 +3548,10 @@ Make it specific and relevant.`;
                       `Artifact name/description generation failed, attempt ${attempt}/${maxRetries}`
                     );
                     if (attempt < maxRetries) {
-                      const backoffMs = Math.min(1e3 * 2 ** (attempt - 1), 1e4);
+                      const backoffMs = Math.min(
+                        ARTIFACT_GENERATION_BACKOFF_INITIAL_MS * 2 ** (attempt - 1),
+                        ARTIFACT_GENERATION_BACKOFF_MAX_MS
+                      );
                       await new Promise((resolve) => setTimeout(resolve, backoffMs));
                     }
                   }
@@ -3548,15 +3567,8 @@ Make it specific and relevant.`;
             );
             result = object;
           }
-          const artifactService = new ArtifactService({
-            tenantId: artifactData.tenantId,
-            projectId: artifactData.projectId,
-            contextId: artifactData.contextId,
-            taskId: artifactData.taskId,
-            sessionId: this.sessionId
-          });
           try {
-            await artifactService.saveArtifact({
+            await this.artifactService.saveArtifact({
               artifactId: artifactData.artifactId,
               name: result.name,
               description: result.description,
@@ -3585,14 +3597,14 @@ Make it specific and relevant.`;
           if (!mainSaveSucceeded) {
             try {
               if (artifactData.tenantId && artifactData.projectId) {
-                const artifactService2 = new ArtifactService({
+                const artifactService = new ArtifactService({
                   tenantId: artifactData.tenantId,
                   projectId: artifactData.projectId,
                   contextId: artifactData.contextId || "unknown",
                   taskId: artifactData.taskId,
                   sessionId: this.sessionId
                 });
-                await artifactService2.saveArtifact({
+                await artifactService.saveArtifact({
                   artifactId: artifactData.artifactId,
                   name: `Artifact ${artifactData.artifactId.substring(0, 8)}`,
                   description: `${artifactData.artifactType || "Data"} from ${artifactData.metadata?.toolName || "tool results"}`,
@@ -4247,11 +4259,11 @@ ${chunk}`;
     }
   }
 };
-__publicField(_IncrementalStreamParser, "MAX_SNAPSHOT_SIZE", 100);
+__publicField(_IncrementalStreamParser, "MAX_SNAPSHOT_SIZE", STREAM_PARSER_MAX_SNAPSHOT_SIZE);
 // Max number of snapshots to keep
-__publicField(_IncrementalStreamParser, "MAX_STREAMED_SIZE", 1e3);
+__publicField(_IncrementalStreamParser, "MAX_STREAMED_SIZE", STREAM_PARSER_MAX_STREAMED_SIZE);
 // Max number of streamed component IDs to track
-__publicField(_IncrementalStreamParser, "MAX_COLLECTED_PARTS", 1e4);
+__publicField(_IncrementalStreamParser, "MAX_COLLECTED_PARTS", STREAM_PARSER_MAX_COLLECTED_PARTS);
 var IncrementalStreamParser = _IncrementalStreamParser;
 
 // src/services/ResponseFormatter.ts
@@ -5456,25 +5468,97 @@ var A2AClient = class {
 
 // src/agents/relationTools.ts
 var logger13 = getLogger("relationships Tools");
+var A2A_RETRY_STATUS_CODES = ["429", "500", "502", "503", "504"];
 var generateTransferToolDescription = (config) => {
-  return `Hand off the conversation to agent ${config.id}.
+  let toolsSection = "";
+  let transferSection = "";
+  if (config.transferRelations && config.transferRelations.length > 0) {
+    const transferList = config.transferRelations.map(
+      (transfer) => `  - ${transfer.name || transfer.id}: ${transfer.description || "No description available"}`
+    ).join("\n");
+    transferSection = `
+
+Can Transfer To:
+${transferList}`;
+  }
+  let delegateSection = "";
+  if (config.delegateRelations && config.delegateRelations.length > 0) {
+    const delegateList = config.delegateRelations.map(
+      (delegate) => `  - ${delegate.config.name || delegate.config.id}: ${delegate.config.description || "No description available"} (${delegate.type})`
+    ).join("\n");
+    delegateSection = `
+
+Can Delegate To:
+${delegateList}`;
+  }
+  if (config.tools && config.tools.length > 0) {
+    const toolDescriptions = config.tools.map((tool3) => {
+      const toolsList = tool3.availableTools?.map((t) => `  - ${t.name}: ${t.description || "No description available"}`).join("\n") || "";
+      return `MCP Server: ${tool3.name}
+${toolsList}`;
+    }).join("\n\n");
+    toolsSection = `
+
+Available Tools & Capabilities:
+${toolDescriptions}`;
+  }
+  const finalDescription = `Hand off the conversation to agent ${config.id}.
 
 Agent Information:
 - ID: ${config.id}
 - Name: ${config.name ?? "No name provided"}
-- Description: ${config.description ?? "No description provided"}
+- Description: ${config.description ?? "No description provided"}${toolsSection}${transferSection}${delegateSection}
 
 Hand off the conversation to agent ${config.id} when the user's request would be better handled by this specialized agent.`;
+  return finalDescription;
 };
-var generateDelegateToolDescription = (config) => {
-  return `Delegate a specific task to another agent.
+var generateDelegateToolDescription = (delegateRelation) => {
+  const config = delegateRelation.config;
+  let toolsSection = "";
+  let transferSection = "";
+  let delegateSection = "";
+  if (delegateRelation.type === "internal" && "tools" in config) {
+    const agentConfig = config;
+    if (agentConfig.tools && agentConfig.tools.length > 0) {
+      const toolDescriptions = agentConfig.tools.map((tool3) => {
+        const toolsList = tool3.availableTools?.map((t) => `  - ${t.name}: ${t.description || "No description available"}`).join("\n") || "";
+        return `MCP Server: ${tool3.name}
+${toolsList}`;
+      }).join("\n\n");
+      toolsSection = `
+
+Available Tools & Capabilities:
+${toolDescriptions}`;
+    }
+    if (agentConfig.transferRelations && agentConfig.transferRelations.length > 0) {
+      const transferList = agentConfig.transferRelations.map(
+        (transfer) => `  - ${transfer.name || transfer.id}: ${transfer.description || "No description available"}`
+      ).join("\n");
+      transferSection = `
+
+Can Transfer To:
+${transferList}`;
+    }
+    if (agentConfig.delegateRelations && agentConfig.delegateRelations.length > 0) {
+      const delegateList = agentConfig.delegateRelations.map(
+        (delegate) => `  - ${delegate.config.name || delegate.config.id}: ${delegate.config.description || "No description available"} (${delegate.type})`
+      ).join("\n");
+      delegateSection = `
+
+Can Delegate To:
+${delegateList}`;
+    }
+  }
+  const finalDescription = `Delegate a specific task to another agent.
 
 Agent Information:
 - ID: ${config.id}
 - Name: ${config.name}
 - Description: ${config.description || "No description provided"}
+- Type: ${delegateRelation.type}${toolsSection}${transferSection}${delegateSection}
 
 Delegate a specific task to agent ${config.id} when it seems like the agent can do relevant work.`;
+  return finalDescription;
 };
 var createTransferToAgentTool = ({
   transferConfig,
@@ -5482,8 +5566,9 @@ var createTransferToAgentTool = ({
   subAgent,
   streamRequestId
 }) => {
+  const toolDescription = generateTransferToolDescription(transferConfig);
   return tool({
-    description: generateTransferToolDescription(transferConfig),
+    description: toolDescription,
     inputSchema: z5.object({}),
     execute: async () => {
       const activeSpan = trace.getActiveSpan();
@@ -5538,7 +5623,7 @@ function createDelegateToAgentTool({
   credentialStoreRegistry
 }) {
   return tool({
-    description: generateDelegateToolDescription(delegateConfig.config),
+    description: generateDelegateToolDescription(delegateConfig),
     inputSchema: z5.object({ message: z5.string() }),
     execute: async (input, context) => {
       const delegationId = `del_${generateId()}`;
@@ -5636,13 +5721,12 @@ function createDelegateToAgentTool({
         retryConfig: {
           strategy: "backoff",
           retryConnectionErrors: true,
-          statusCodes: ["429", "500", "502", "503", "504"],
+          statusCodes: [...A2A_RETRY_STATUS_CODES],
           backoff: {
-            initialInterval: 100,
-            maxInterval: 1e4,
-            exponent: 2,
-            maxElapsedTime: 2e4
-            // 1 minute max retry time
+            initialInterval: DELEGATION_TOOL_BACKOFF_INITIAL_INTERVAL_MS,
+            maxInterval: DELEGATION_TOOL_BACKOFF_MAX_INTERVAL_MS,
+            exponent: DELEGATION_TOOL_BACKOFF_EXPONENT,
+            maxElapsedTime: DELEGATION_TOOL_BACKOFF_MAX_ELAPSED_TIME_MS
           }
         }
       });
@@ -5794,7 +5878,7 @@ var system_prompt_default = `<system_message>
       - You ARE the user's assistant - there are no other agents, specialists, or experts
       - NEVER say you are connecting them to anyone or anything
       - Continue conversations as if you personally have been handling them the entire time
-      - Answer questions directly without any transition phrases or transfer language
+      - Answer questions directly without any transition phrases or transfer language except when transferring to another agent or delegating to another agent
       {{TRANSFER_INSTRUCTIONS}}
       {{DELEGATION_INSTRUCTIONS}}
     </security>
@@ -5802,7 +5886,7 @@ var system_prompt_default = `<system_message>
     <interaction_guidelines>
       - Be helpful, accurate, and professional
       - Use tools when appropriate to provide better assistance
-      - Explain your reasoning when using tools
+      - Use tools directly without announcing or explaining what you're doing ("Let me search...", "I'll look for...", etc.)
       - Save important tool results as artifacts when they contain structured data that should be preserved and referenced
       - Ask for clarification when requests are ambiguous
       
@@ -5820,11 +5904,6 @@ var system_prompt_default = `<system_message>
       - NEVER mention delegation occurred: just present the results
       - If delegation returns artifacts, reference them as if you created them
       
-      \u{1F6A8} TRANSFER TOOL RULES - CRITICAL:
-      - When calling transfer_to_* tools, call the tool IMMEDIATELY without any explanatory text
-      - Do NOT explain the transfer, do NOT say "I'll hand this off", do NOT provide reasoning
-      - Just call the transfer tool directly when you determine it's needed
-      - The tool call is sufficient - no additional text should be generated
     </interaction_guidelines>
     
     {{THINKING_PREPARATION_INSTRUCTIONS}}
@@ -6042,9 +6121,24 @@ var Phase1Config = class _Phase1Config {
     if (!hasTransferRelations) {
       return "";
     }
-    return `- You have transfer_to_* tools that seamlessly continue the conversation
-- NEVER announce transfers - just call the tool when needed
-- The conversation continues naturally without any transfer language`;
+    return `You are part of a single unified assistant composed of specialized agents. To the user, you must always appear as one continuous, confident voice.
+
+You have transfer_to_* tools that seamlessly continue the conversation. When you determine another agent should handle a request: ONLY call the appropriate transfer_to_* tool. Do not provide any substantive answer, limitation, or explanation before transferring. NEVER announce, describe, or apologize for a transfer.
+
+Do NOT stream any text when transferring - call the transfer tool IMMEDIATELY. Do NOT acknowledge the request, do NOT say "Looking into that...", "Let me search...", "I'll help you find...", or provide ANY explanatory text. Place all reasoning or handoff details inside the transfer tool call, not in the user message. The tool call is sufficient - no additional text should be generated.
+
+CRITICAL: When you receive a user message that ends with "Please continue from where this conversation was left off" - this indicates you are continuing a conversation that another agent started. You should:
+- Review the conversation history to see what was already communicated to the user
+- Continue seamlessly from where the previous response left off
+- Do NOT repeat what was already said in the conversation history
+- Do NOT announce what you're about to do ("Let me search...", "I'll look for...", etc.)
+- Proceed directly with the appropriate tool or action
+- Act as if you have been handling the conversation from the beginning
+
+When receiving any transfer, act as if you have been engaged from the start. Continue the same tone, context, and style. Never reference other agents, tools, or roles.
+
+Your goal: preserve the illusion of a single, seamless, intelligent assistant. All user-facing behavior must feel like one continuous conversation, regardless of internal transfers.
+`;
   }
   generateDelegationInstructions(hasDelegateRelations) {
     if (!hasDelegateRelations) {
@@ -6805,12 +6899,6 @@ function hasToolCallWithPrefix(prefix) {
   };
 }
 var logger15 = getLogger("Agent");
-var CONSTANTS = {
-  MAX_GENERATION_STEPS: 12,
-  PHASE_1_TIMEOUT_MS: 27e4,
-  NON_STREAMING_PHASE_1_TIMEOUT_MS: 9e4,
-  PHASE_2_TIMEOUT_MS: 9e4
-};
 function validateModel(modelString, modelType) {
   if (!modelString?.trim()) {
     throw new Error(
@@ -6879,10 +6967,10 @@ var Agent = class {
   }
   /**
    * Get the maximum number of generation steps for this agent
-   * Uses agent's stopWhen.stepCountIs config or defaults to CONSTANTS.MAX_GENERATION_STEPS
+   * Uses agent's stopWhen.stepCountIs config or defaults to AGENT_EXECUTION_MAX_GENERATION_STEPS
    */
   getMaxGenerationSteps() {
-    return this.config.stopWhen?.stepCountIs ?? CONSTANTS.MAX_GENERATION_STEPS;
+    return this.config.stopWhen?.stepCountIs ?? AGENT_EXECUTION_MAX_GENERATION_STEPS;
   }
   /**
    * Sanitizes tool names at runtime for AI SDK compatibility.
@@ -7400,7 +7488,7 @@ var Agent = class {
       if (functionToolsData.length === 0) {
         return functionTools;
       }
-      const { SandboxExecutorFactory } = await import('./SandboxExecutorFactory-QVNCS6YN.js');
+      const { SandboxExecutorFactory } = await import('./SandboxExecutorFactory-D3OSN652.js');
       const sandboxExecutor = SandboxExecutorFactory.getInstance();
       for (const functionToolDef of functionToolsData) {
         const functionId = functionToolDef.functionId;
@@ -7438,8 +7526,8 @@ var Agent = class {
               const defaultSandboxConfig = {
                 provider: "native",
                 runtime: "node22",
-                timeout: 3e4,
-                vcpus: 4
+                timeout: FUNCTION_TOOL_EXECUTION_TIMEOUT_MS_DEFAULT,
+                vcpus: FUNCTION_TOOL_SANDBOX_VCPUS_DEFAULT
               };
               const result = await sandboxExecutor.executeFunctionTool(functionToolDef.id, args, {
                 description: functionToolDef.description || functionToolDef.name,
@@ -7694,7 +7782,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-V6DNH5MW.js');
+    const { getConversationScopedArtifacts } = await import('./conversations-ZZI6XV2G.js');
     const historyConfig = this.config.conversationHistoryConfig ?? createDefaultConversationHistoryConfig();
     const referenceArtifacts = await getConversationScopedArtifacts({
       tenantId: this.config.tenantId,
@@ -8044,6 +8132,9 @@ var Agent = class {
         try {
           this.streamRequestId = streamRequestId;
           this.streamHelper = streamRequestId ? getStreamHelper(streamRequestId) : void 0;
+          if (streamRequestId && this.artifactComponents.length > 0) {
+            agentSessionManager.updateArtifactComponents(streamRequestId, this.artifactComponents);
+          }
           const conversationId = runtimeContext?.metadata?.conversationId;
           if (conversationId) {
             this.setConversationId(conversationId);
@@ -8125,15 +8216,14 @@ var Agent = class {
           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) {
+          const configuredTimeout = modelSettings.maxDuration ? Math.min(modelSettings.maxDuration * 1e3, LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS) : shouldStreamPhase1 ? LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_STREAMING : LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_NON_STREAMING;
+          const timeoutMs = Math.min(configuredTimeout, LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS);
+          if (modelSettings.maxDuration && modelSettings.maxDuration * 1e3 > LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS) {
             logger15.warn(
               {
                 requestedTimeout: modelSettings.maxDuration * 1e3,
                 appliedTimeout: timeoutMs,
-                maxAllowed: MAX_ALLOWED_TIMEOUT_MS
+                maxAllowed: LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS
               },
               "Requested timeout exceeded maximum allowed, capping to 10 minutes"
             );
@@ -8435,7 +8525,25 @@ ${output}${structureHintsFormatted}`;
               const structuredModelSettings = ModelFactory.prepareGenerationConfig(
                 this.getStructuredOutputModel()
               );
-              const phase2TimeoutMs = structuredModelSettings.maxDuration ? structuredModelSettings.maxDuration * 1e3 : CONSTANTS.PHASE_2_TIMEOUT_MS;
+              const configuredPhase2Timeout = structuredModelSettings.maxDuration ? Math.min(
+                structuredModelSettings.maxDuration * 1e3,
+                LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS
+              ) : LLM_GENERATION_SUBSEQUENT_CALL_TIMEOUT_MS;
+              const phase2TimeoutMs = Math.min(
+                configuredPhase2Timeout,
+                LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS
+              );
+              if (structuredModelSettings.maxDuration && structuredModelSettings.maxDuration * 1e3 > LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS) {
+                logger15.warn(
+                  {
+                    requestedTimeout: structuredModelSettings.maxDuration * 1e3,
+                    appliedTimeout: phase2TimeoutMs,
+                    maxAllowed: LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS,
+                    phase: "structured_generation"
+                  },
+                  "Phase 2 requested timeout exceeded maximum allowed, capping to 10 minutes"
+                );
+              }
               const shouldStreamPhase2 = this.getStreamingHelper();
               if (shouldStreamPhase2) {
                 const phase2Messages = [
@@ -8791,9 +8899,14 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
       const models = "models" in config.agentSchema ? config.agentSchema.models : void 0;
       const stopWhen = "stopWhen" in config.agentSchema ? config.agentSchema.stopWhen : void 0;
       const toolsForAgentResult = await Promise.all(
-        toolsForAgent.data.map(
-          async (item) => await dbResultToMcpTool(item.tool, dbClient_default, credentialStoreRegistry)
-        )
+        toolsForAgent.data.map(async (item) => {
+          const mcpTool = await dbResultToMcpTool(item.tool, dbClient_default, credentialStoreRegistry);
+          if (item.selectedTools && item.selectedTools.length > 0) {
+            const selectedToolsSet = new Set(item.selectedTools);
+            mcpTool.availableTools = mcpTool.availableTools?.filter((tool3) => selectedToolsSet.has(tool3.name)) || [];
+          }
+          return mcpTool;
+        })
       ) ?? [];
       const agent = new Agent(
         {
@@ -8822,20 +8935,112 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
             subAgentRelations: [],
             transferRelations: []
           })),
-          transferRelations: enhancedInternalRelations.filter((relation) => relation.relationType === "transfer").map((relation) => ({
-            baseUrl: config.baseUrl,
-            apiKey: config.apiKey,
-            id: relation.id,
-            tenantId: config.tenantId,
-            projectId: config.projectId,
-            agentId: config.agentId,
-            name: relation.name,
-            description: relation.description,
-            prompt: "",
-            delegateRelations: [],
-            subAgentRelations: [],
-            transferRelations: []
-          })),
+          transferRelations: await Promise.all(
+            enhancedInternalRelations.filter((relation) => relation.relationType === "transfer").map(async (relation) => {
+              const targetToolsForAgent = await getToolsForAgent(dbClient_default)({
+                scopes: {
+                  tenantId: config.tenantId,
+                  projectId: config.projectId,
+                  agentId: config.agentId,
+                  subAgentId: relation.id
+                }
+              });
+              let targetTransferRelations = { data: [] };
+              let targetDelegateRelations = { data: [] };
+              try {
+                const [transferRel, delegateRel] = await Promise.all([
+                  getRelatedAgentsForAgent(dbClient_default)({
+                    scopes: {
+                      tenantId: config.tenantId,
+                      projectId: config.projectId,
+                      agentId: config.agentId
+                    },
+                    subAgentId: relation.id
+                  }),
+                  getExternalAgentsForSubAgent(dbClient_default)({
+                    scopes: {
+                      tenantId: config.tenantId,
+                      projectId: config.projectId,
+                      agentId: config.agentId,
+                      subAgentId: relation.id
+                    }
+                  })
+                ]);
+                targetTransferRelations = transferRel;
+                targetDelegateRelations = delegateRel;
+              } catch (err) {
+                logger16.info(
+                  {
+                    agentId: relation.id,
+                    error: err?.message || "Unknown error"
+                  },
+                  "Could not fetch relations for target agent (likely external/team agent), using basic info only"
+                );
+              }
+              const targetAgentTools = await Promise.all(
+                targetToolsForAgent.data.map(async (item) => {
+                  const mcpTool = await dbResultToMcpTool(
+                    item.tool,
+                    dbClient_default,
+                    credentialStoreRegistry
+                  );
+                  if (item.selectedTools && item.selectedTools.length > 0) {
+                    const selectedToolsSet = new Set(item.selectedTools);
+                    mcpTool.availableTools = mcpTool.availableTools?.filter(
+                      (tool3) => selectedToolsSet.has(tool3.name)
+                    ) || [];
+                  }
+                  return mcpTool;
+                })
+              ) ?? [];
+              const targetTransferRelationsConfig = targetTransferRelations.data.filter((rel) => rel.relationType === "transfer").map((rel) => ({
+                baseUrl: config.baseUrl,
+                apiKey: config.apiKey,
+                id: rel.id,
+                tenantId: config.tenantId,
+                projectId: config.projectId,
+                agentId: config.agentId,
+                name: rel.name,
+                description: rel.description,
+                prompt: "",
+                delegateRelations: [],
+                subAgentRelations: [],
+                transferRelations: []
+                // Note: Not including tools for nested relations to avoid infinite recursion
+              }));
+              const targetDelegateRelationsConfig = targetDelegateRelations.data.map(
+                (rel) => ({
+                  type: "external",
+                  config: {
+                    id: rel.externalAgent.id,
+                    name: rel.externalAgent.name,
+                    description: rel.externalAgent.description || "",
+                    baseUrl: rel.externalAgent.baseUrl,
+                    headers: rel.headers,
+                    credentialReferenceId: rel.externalAgent.credentialReferenceId,
+                    relationId: rel.id,
+                    relationType: "delegate"
+                  }
+                })
+              );
+              return {
+                baseUrl: config.baseUrl,
+                apiKey: config.apiKey,
+                id: relation.id,
+                tenantId: config.tenantId,
+                projectId: config.projectId,
+                agentId: config.agentId,
+                name: relation.name,
+                description: relation.description,
+                prompt: "",
+                delegateRelations: targetDelegateRelationsConfig,
+                subAgentRelations: [],
+                transferRelations: targetTransferRelationsConfig,
+                tools: targetAgentTools
+                // Include target agent's tools for transfer descriptions
+              };
+            })
+          ),
           delegateRelations: [
             ...enhancedInternalRelations.filter((relation) => relation.relationType === "delegate").map((relation) => ({
               type: "internal",
@@ -8850,8 +9055,11 @@ var createTaskHandler = (config, credentialStoreRegistry) => {
                 description: relation.description,
                 prompt: "",
                 delegateRelations: [],
+                // Simplified - no nested relations
                 subAgentRelations: [],
-                transferRelations: []
+                transferRelations: [],
+                tools: []
+                // Tools are defined in config files, not DB
               }
             })),
             ...externalRelations.data.map((relation) => ({
@@ -9669,7 +9877,6 @@ function createSSEStreamHelper(stream2, requestId2, timestamp) {
   return new SSEStreamHelper(stream2, requestId2, timestamp);
 }
 var _VercelDataStreamHelper = class _VercelDataStreamHelper {
-  // 10 minutes max lifetime
   constructor(writer) {
     this.writer = writer;
     __publicField(this, "textId", null);
@@ -9679,18 +9886,14 @@ var _VercelDataStreamHelper = class _VercelDataStreamHelper {
     __publicField(this, "completedItems", /* @__PURE__ */ new Set());
     // Track completed items
     __publicField(this, "sessionId");
-    // 5MB limit (more generous during request)
     __publicField(this, "isCompleted", false);
     __publicField(this, "isTextStreaming", false);
     __publicField(this, "queuedEvents", []);
     __publicField(this, "lastTextEndTimestamp", 0);
-    __publicField(this, "TEXT_GAP_THRESHOLD", 2e3);
-    // milliseconds - if gap between text sequences is less than this, queue operations
     __publicField(this, "connectionDropTimer");
-    __publicField(this, "MAX_LIFETIME_MS", 6e5);
     this.connectionDropTimer = setTimeout(() => {
       this.forceCleanup("Connection lifetime exceeded");
-    }, this.MAX_LIFETIME_MS);
+    }, STREAM_MAX_LIFETIME_MS);
   }
   setSessionId(sessionId) {
     this.sessionId = sessionId;
@@ -9744,7 +9947,7 @@ var _VercelDataStreamHelper = class _VercelDataStreamHelper {
     const id = this.textId;
     const startTime = Date.now();
     const gapFromLastSequence = this.lastTextEndTimestamp > 0 ? startTime - this.lastTextEndTimestamp : Number.MAX_SAFE_INTEGER;
-    if (gapFromLastSequence >= this.TEXT_GAP_THRESHOLD) {
+    if (gapFromLastSequence >= STREAM_TEXT_GAP_THRESHOLD_MS) {
       await this.flushQueuedOperations();
     }
     this.isTextStreaming = true;
@@ -9778,7 +9981,7 @@ var _VercelDataStreamHelper = class _VercelDataStreamHelper {
     if (type === "data-artifact") {
       const now = Date.now();
       const gapFromLastTextEnd = this.lastTextEndTimestamp > 0 ? now - this.lastTextEndTimestamp : Number.MAX_SAFE_INTEGER;
-      if (this.isTextStreaming || gapFromLastTextEnd < this.TEXT_GAP_THRESHOLD) {
+      if (this.isTextStreaming || gapFromLastTextEnd < STREAM_TEXT_GAP_THRESHOLD_MS) {
         this.writer.write({
           type: `${type}`,
           data
@@ -9931,7 +10134,7 @@ var _VercelDataStreamHelper = class _VercelDataStreamHelper {
     }
     const now = Date.now();
     const gapFromLastTextEnd = this.lastTextEndTimestamp > 0 ? now - this.lastTextEndTimestamp : Number.MAX_SAFE_INTEGER;
-    if (this.isTextStreaming || gapFromLastTextEnd < this.TEXT_GAP_THRESHOLD) {
+    if (this.isTextStreaming || gapFromLastTextEnd < STREAM_TEXT_GAP_THRESHOLD_MS) {
       this.queuedEvents.push({ type: "data-summary", event: summary });
       return;
     }
@@ -9949,7 +10152,7 @@ var _VercelDataStreamHelper = class _VercelDataStreamHelper {
     }
     const now = Date.now();
     const gapFromLastTextEnd = this.lastTextEndTimestamp > 0 ? now - this.lastTextEndTimestamp : Number.MAX_SAFE_INTEGER;
-    if (this.isTextStreaming || gapFromLastTextEnd < this.TEXT_GAP_THRESHOLD) {
+    if (this.isTextStreaming || gapFromLastTextEnd < STREAM_TEXT_GAP_THRESHOLD_MS) {
       this.queuedEvents.push({ type: "data-operation", event: operation });
       return;
     }
@@ -9992,7 +10195,7 @@ var _VercelDataStreamHelper = class _VercelDataStreamHelper {
     this.cleanup();
   }
 };
-__publicField(_VercelDataStreamHelper, "MAX_BUFFER_SIZE", 5 * 1024 * 1024);
+__publicField(_VercelDataStreamHelper, "MAX_BUFFER_SIZE", STREAM_BUFFER_MAX_SIZE_BYTES);
 var VercelDataStreamHelper = _VercelDataStreamHelper;
 function createVercelStreamHelper(writer) {
   return new VercelDataStreamHelper(writer);
@@ -10064,7 +10267,7 @@ var createMCPStreamHelper = createBufferingStreamHelper;
 var logger20 = getLogger("ExecutionHandler");
 var ExecutionHandler = class {
   constructor() {
-    __publicField(this, "MAX_ERRORS", 3);
+    __publicField(this, "MAX_ERRORS", AGENT_EXECUTION_MAX_CONSECUTIVE_ERRORS);
   }
   /**
    * performs exeuction loop
@@ -10161,7 +10364,7 @@ var ExecutionHandler = class {
           "Task created with metadata"
         );
       } catch (error) {
-        if (error?.message?.includes("UNIQUE constraint failed") || error?.message?.includes("PRIMARY KEY constraint failed") || error?.code === "SQLITE_CONSTRAINT_PRIMARYKEY") {
+        if (error?.cause?.code === "23505") {
           logger20.info(
             { taskId, error: error.message },
             "Task already exists, fetching existing task"
@@ -10184,7 +10387,7 @@ var ExecutionHandler = class {
       }
       logger20.debug(
         {
-          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          timestamp: /* @__PURE__ */ new Date(),
           executionType: "create_initial_task",
           conversationId,
           agentId,
@@ -10198,7 +10401,7 @@ var ExecutionHandler = class {
       );
       if (Array.isArray(task)) task = task[0];
       let currentMessage = userMessage;
-      const maxTransfers = agentConfig?.stopWhen?.transferCountIs ?? 10;
+      const maxTransfers = agentConfig?.stopWhen?.transferCountIs ?? AGENT_EXECUTION_TRANSFER_COUNT_DEFAULT;
       while (iterations < maxTransfers) {
         iterations++;
         logger20.info(
@@ -10293,7 +10496,27 @@ var ExecutionHandler = class {
           const firstArtifact = messageResponse.result.artifacts[0];
           const transferReason = firstArtifact?.parts[1]?.kind === "text" ? firstArtifact.parts[1].text : "Transfer initiated";
           logger20.info({ targetSubAgentId, transferReason, transferFromAgent }, "Transfer response");
-          currentMessage = `<transfer_context> ${transferReason} </transfer_context>`;
+          await createMessage(dbClient_default)({
+            id: generateId(),
+            tenantId,
+            projectId,
+            conversationId,
+            role: "agent",
+            content: {
+              text: transferReason,
+              parts: [
+                {
+                  kind: "text",
+                  text: transferReason
+                }
+              ]
+            },
+            visibility: "user-facing",
+            messageType: "chat",
+            fromSubAgentId: currentAgentId,
+            taskId: task.id
+          });
+          currentMessage = currentMessage + "\n\nPlease continue this conversation seamlessly. The previous response in conversation history was from another internal agent, but you must continue as if YOU made that response. All responses must appear as one unified agent - do not repeat what was already communicated.";
           const { success, targetSubAgentId: newAgentId } = await executeTransfer({
             projectId,
             tenantId,
@@ -10377,7 +10600,7 @@ var ExecutionHandler = class {
                   status: "completed",
                   metadata: {
                     ...task.metadata,
-                    completed_at: (/* @__PURE__ */ new Date()).toISOString(),
+                    completed_at: /* @__PURE__ */ new Date(),
                     response: {
                       text: textContent,
                       parts: responseParts,
@@ -10429,7 +10652,7 @@ var ExecutionHandler = class {
                 status: "failed",
                 metadata: {
                   ...task.metadata,
-                  failed_at: (/* @__PURE__ */ new Date()).toISOString(),
+                  failed_at: /* @__PURE__ */ new Date(),
                   error: errorMessage2
                 }
               }
@@ -10450,7 +10673,7 @@ var ExecutionHandler = class {
             status: "failed",
             metadata: {
               ...task.metadata,
-              failed_at: (/* @__PURE__ */ new Date()).toISOString(),
+              failed_at: /* @__PURE__ */ new Date(),
               error: errorMessage
             }
           }
@@ -10472,7 +10695,7 @@ var ExecutionHandler = class {
             status: "failed",
             metadata: {
               ...task.metadata,
-              failed_at: (/* @__PURE__ */ new Date()).toISOString(),
+              failed_at: /* @__PURE__ */ new Date(),
               error: errorMessage
             }
           }