@inkeep/agents-run-api 0.31.6 → 0.31.7

package/dist/index.cjs

@@ -2982,7 +2982,16 @@ var _ArtifactService = class _ArtifactService {
         );
         return null;
       }
-      const artifacts = await agentsCore.getLedgerArtifacts(dbClient_default)({
+      let artifacts = [];
+      artifacts = await agentsCore.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 agentsCore.getLedgerArtifacts(dbClient_default)({
         scopes: { tenantId: this.context.tenantId, projectId: this.context.projectId },
         artifactId,
         taskId: this.context.taskId
@@ -3028,7 +3037,16 @@ var _ArtifactService = class _ArtifactService {
         );
         return null;
       }
-      const artifacts = await agentsCore.getLedgerArtifacts(dbClient_default)({
+      let artifacts = [];
+      artifacts = await agentsCore.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 agentsCore.getLedgerArtifacts(dbClient_default)({
         scopes: { tenantId: this.context.tenantId, projectId: this.context.projectId },
         artifactId,
         taskId: this.context.taskId
@@ -4996,15 +5014,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,
@@ -5033,14 +5044,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"}`,
@@ -6928,24 +6939,95 @@ init_dbClient();
 init_logger();
 var logger14 = agentsCore.getLogger("relationships Tools");
 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,
@@ -6953,8 +7035,9 @@ var createTransferToAgentTool = ({
   subAgent,
   streamRequestId
 }) => {
+  const toolDescription = generateTransferToolDescription(transferConfig);
   return ai.tool({
-    description: generateTransferToolDescription(transferConfig),
+    description: toolDescription,
     inputSchema: z6__default.default.object({}),
     execute: async () => {
       const activeSpan = api.trace.getActiveSpan();
@@ -7009,7 +7092,7 @@ function createDelegateToAgentTool({
   credentialStoreRegistry
 }) {
   return ai.tool({
-    description: generateDelegateToolDescription(delegateConfig.config),
+    description: generateDelegateToolDescription(delegateConfig),
     inputSchema: z6__default.default.object({ message: z6__default.default.string() }),
     execute: async (input, context) => {
       const delegationId = `del_${agentsCore.generateId()}`;
@@ -7266,7 +7349,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>
@@ -7274,7 +7357,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
       
@@ -7292,11 +7375,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}}
@@ -7515,9 +7593,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) {
@@ -9517,6 +9610,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);
@@ -10264,9 +10360,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 agentsCore.dbResultToMcpTool(item.tool, dbClient_default, credentialStoreRegistry)
-        )
+        toolsForAgent.data.map(async (item) => {
+          const mcpTool = await agentsCore.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(
         {
@@ -10295,20 +10396,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 agentsCore.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([
+                  agentsCore.getRelatedAgentsForAgent(dbClient_default)({
+                    scopes: {
+                      tenantId: config.tenantId,
+                      projectId: config.projectId,
+                      agentId: config.agentId
+                    },
+                    subAgentId: relation.id
+                  }),
+                  agentsCore.getExternalAgentsForSubAgent(dbClient_default)({
+                    scopes: {
+                      tenantId: config.tenantId,
+                      projectId: config.projectId,
+                      agentId: config.agentId,
+                      subAgentId: relation.id
+                    }
+                  })
+                ]);
+                targetTransferRelations = transferRel;
+                targetDelegateRelations = delegateRel;
+              } catch (err) {
+                logger20.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 agentsCore.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",
@@ -10323,8 +10516,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) => ({
@@ -11781,7 +11977,27 @@ var ExecutionHandler = class {
           const firstArtifact = messageResponse.result.artifacts[0];
           const transferReason = firstArtifact?.parts[1]?.kind === "text" ? firstArtifact.parts[1].text : "Transfer initiated";
           logger24.info({ targetSubAgentId, transferReason, transferFromAgent }, "Transfer response");
-          currentMessage = `<transfer_context> ${transferReason} </transfer_context>`;
+          await agentsCore.createMessage(dbClient_default)({
+            id: agentsCore.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,

package/dist/index.js

@@ -1534,7 +1534,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 +1589,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
@@ -3548,15 +3566,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 +3596,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"}`,
@@ -5457,24 +5468,95 @@ var A2AClient = class {
 // src/agents/relationTools.ts
 var logger13 = getLogger("relationships Tools");
 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 +5564,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 +5621,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()}`;
@@ -5794,7 +5877,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 +5885,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 +5903,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 +6120,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) {
@@ -8044,6 +8137,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);
@@ -8791,9 +8887,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 +8923,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 +9043,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) => ({
@@ -10293,7 +10489,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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-run-api",
-  "version": "0.31.6",
+  "version": "0.31.7",
   "description": "Agents Run API for Inkeep Agent Framework - handles chat, agent execution, and streaming",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -53,7 +53,7 @@
     "traverse": "^0.6.11",
     "ts-pattern": "^5.7.1",
     "zod": "4.1.5",
-    "@inkeep/agents-core": "^0.31.6"
+    "@inkeep/agents-core": "^0.31.7"
   },
   "optionalDependencies": {
     "keytar": "^7.9.0"

package/templates/v1/phase1/system-prompt.xml

@@ -21,7 +21,7 @@
       - 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>
@@ -29,7 +29,7 @@
     <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
       
@@ -47,11 +47,6 @@
       - NEVER mention delegation occurred: just present the results
       - If delegation returns artifacts, reference them as if you created them
       
-      🚨 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}}