@inkeep/agents-run-api 0.41.0 → 0.41.1

package/dist/agents/Agent.js

@@ -1047,7 +1047,7 @@ var Agent = class {
 	}
 	getArtifactTools() {
 		return tool({
-			description: "Call this tool to get the complete artifact data with the given artifactId. This retrieves the full artifact content (not just the summary). Only use this when you need the complete artifact data and the summary shown in your context is insufficient.",
+			description: "Call this tool to retrieve EXISTING artifacts that were previously created and saved. This tool is for accessing artifacts that already exist, NOT for extracting tool results. Only use this when you need the complete artifact data and the summary shown in your context is insufficient.",
 			inputSchema: z.object({
 				artifactId: z.string().describe("The unique identifier of the artifact to get."),
 				toolCallId: z.string().describe("The tool call ID associated with this artifact.")
@@ -1643,11 +1643,13 @@ ${typeof cleanResult === "string" ? cleanResult : JSON.stringify(cleanResult, nu
 				if (error && typeof error === "object" && "name" in error && error.name === "connection_refused") return true;
 			}
 		}
-		if (steps.length >= 2) {
-			const previousStep = steps[steps.length - 2];
-			if (previousStep && "toolCalls" in previousStep && previousStep.toolCalls) {
-				const stopToolNames = includeThinkingComplete ? ["transfer_to_", "thinking_complete"] : ["transfer_to_"];
-				if (previousStep.toolCalls.some((tc) => stopToolNames.some((toolName) => toolName.endsWith("_") ? tc.toolName.startsWith(toolName) : tc.toolName === toolName)) && "toolResults" in previousStep && previousStep.toolResults) return true;
+		if (steps.length >= 1) {
+			const currentStep = steps[steps.length - 1];
+			if (currentStep && "toolCalls" in currentStep && currentStep.toolCalls) {
+				const hasTransferTool = currentStep.toolCalls.some((tc) => tc.toolName.startsWith("transfer_to_"));
+				const hasThinkingComplete = currentStep.toolCalls.some((tc) => tc.toolName === "thinking_complete");
+				if (hasTransferTool) return true;
+				if (includeThinkingComplete && hasThinkingComplete && "toolResults" in currentStep && currentStep.toolResults) return true;
 			}
 		}
 		return steps.length >= this.getMaxGenerationSteps();
@@ -1777,8 +1779,13 @@ ${output}${structureHintsFormatted}`;
 			componentSchemas.push(ArtifactReferenceSchema.getSchema());
 		}
 		let dataComponentsSchema;
-		if (componentSchemas.length === 1) dataComponentsSchema = componentSchemas[0];
-		else dataComponentsSchema = z.union(componentSchemas);
+		if (componentSchemas.length === 1) {
+			dataComponentsSchema = componentSchemas[0];
+			logger.info({ agentId: this.config.id }, "Using single schema (no union needed)");
+		} else {
+			dataComponentsSchema = z.union(componentSchemas);
+			logger.info({ agentId: this.config.id }, "Created union schema");
+		}
 		return dataComponentsSchema;
 	}
 	calculatePhase2Timeout(structuredModelSettings) {

package/dist/agents/relationTools.js

@@ -38,14 +38,24 @@ ${config.tools.map((tool$1) => {
 		const toolsList = tool$1.availableTools?.map((t) => `  - ${t.name}: ${t.description || "No description available"}`).join("\n") || "";
 		return `MCP Server: ${tool$1.name}\n${toolsList}`;
 	}).join("\n\n")}`;
-	return `Hand off the conversation to agent ${config.id}.
+	return `🚨 CRITICAL TRANSFER PROTOCOL 🚨
+
+This tool immediately transfers conversation control to agent ${config.id}. 
+
+⚠️ MANDATORY BEHAVIOR:
+1. DO NOT write any response to the user
+2. DO NOT explain what you're doing  
+3. DO NOT provide partial answers
+4. ONLY call this tool and STOP
 
 Agent Information:
 - ID: ${config.id}
 - Name: ${config.name ?? "No name 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.`;
+🔄 Use when: The user's request is better handled by this specialized agent.
+
+⛔ VIOLATION WARNING: Any text generation before/after this tool call will create a disjointed user experience. The receiving agent will provide the complete response.`;
 };
 const generateDelegateToolDescription = (delegateRelation) => {
 	const config = delegateRelation.config;
@@ -70,7 +80,7 @@ ${agentConfig.transferRelations.map((transfer) => `  - ${transfer.name || transf
 Can Delegate To:
 ${agentConfig.delegateRelations.map((delegate) => `  - ${delegate.config.name || delegate.config.id}: ${delegate.config.description || "No description available"} (${delegate.type})`).join("\n")}`;
 	}
-	return `Delegate a specific task to another agent.
+	return `Delegate a specific task to another agent and wait for their response.
 
 Agent Information:
 - ID: ${config.id}
@@ -78,7 +88,9 @@ Agent Information:
 - 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.`;
+Delegate a specific task to agent ${config.id} when it can do relevant work. The delegated agent will return results that you can incorporate into your response to the user.
+
+NOTE: Unlike transfers, delegation returns control back to you with the delegated agent's results.`;
 };
 const createTransferToAgentTool = ({ transferConfig, callingAgentId, subAgent, streamRequestId }) => {
 	return tool({

package/dist/agents/versions/v1/Phase1Config.js

@@ -103,9 +103,20 @@ var Phase1Config = class Phase1Config {
 		if (!hasTransferRelations) return "";
 		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 TRANSFER PROTOCOL 🚨
+When you determine another agent should handle a request:
+1. IMMEDIATELY call the appropriate transfer_to_* tool  
+2. Generate ZERO text in your response - no words, no explanations, no acknowledgments
+3. Do NOT stream any content - the tool call must be your ONLY output
+
+FORBIDDEN BEFORE TRANSFERS:
+❌ Do NOT acknowledge the request ("I understand you want...")
+❌ Do NOT provide partial answers ("The basics are..." then transfer) 
+❌ Do NOT explain what you're doing ("Let me search...", "I'll help you find...")
+❌ Do NOT apologize or announce transfers ("I'll need to transfer you...")
+❌ Do NOT generate ANY text content whatsoever - just call the transfer tool
+
+REMEMBER: Tool call = complete response. No additional text generation allowed.
 
 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

package/dist/create-app.d.ts

@@ -1,9 +1,9 @@
 import { SandboxConfig } from "./types/execution-context.js";
 import { CredentialStoreRegistry, ServerConfig } from "@inkeep/agents-core";
 import { Hono } from "hono";
-import * as hono_types0 from "hono/types";
+import * as hono_types3 from "hono/types";
 
 //#region src/create-app.d.ts
-declare function createExecutionHono(serverConfig: ServerConfig, credentialStores: CredentialStoreRegistry, sandboxConfig?: SandboxConfig): Hono<hono_types0.BlankEnv, hono_types0.BlankSchema, "/">;
+declare function createExecutionHono(serverConfig: ServerConfig, credentialStores: CredentialStoreRegistry, sandboxConfig?: SandboxConfig): Hono<hono_types3.BlankEnv, hono_types3.BlankSchema, "/">;
 //#endregion
 export { createExecutionHono };

package/dist/index.d.ts

@@ -3,14 +3,14 @@ import { createExecutionHono } from "./create-app.js";
 import "./env.js";
 import { CredentialStore, ServerConfig } from "@inkeep/agents-core";
 import { Hono } from "hono";
-import * as hono_types1 from "hono/types";
+import * as hono_types0 from "hono/types";
 
 //#region src/index.d.ts
-declare const app: Hono<hono_types1.BlankEnv, hono_types1.BlankSchema, "/">;
+declare const app: Hono<hono_types0.BlankEnv, hono_types0.BlankSchema, "/">;
 declare function createExecutionApp(config?: {
   serverConfig?: ServerConfig;
   credentialStores?: CredentialStore[];
   sandboxConfig?: SandboxConfig;
-}): Hono<hono_types1.BlankEnv, hono_types1.BlankSchema, "/">;
+}): Hono<hono_types0.BlankEnv, hono_types0.BlankSchema, "/">;
 //#endregion
 export { Hono, type NativeSandboxConfig, type SandboxConfig, type VercelSandboxConfig, createExecutionApp, createExecutionHono, app as default };

package/dist/services/AgentSession.js

@@ -517,16 +517,22 @@ var AgentSession = class {
 					}, "Failed to fetch conversation history for structured status update");
 				}
 				const previousSummaryContext = previousSummaries.length > 0 ? `\nPrevious updates sent to user:\n${previousSummaries.map((s, i) => `${i + 1}. ${s}`).join("\n")}\n` : "";
-				const selectionSchema = z.object(Object.fromEntries([["no_relevant_updates", z.object({ no_updates: z.boolean().default(true) }).optional().describe("Use when nothing substantially new to report. Should only use on its own.")], ...statusComponents.map((component) => [component.type, this.getComponentSchema(component).optional().describe(component.description || component.type)])]));
+				const selectionSchema = z.object({ updates: z.array(z.union([z.object({
+					type: z.literal("no_relevant_updates"),
+					data: z.object({ no_updates: z.boolean().default(true) }).describe("Use when nothing substantially new to report. Should only use on its own.")
+				}), ...statusComponents.map((component) => z.object({
+					type: z.literal(component.type),
+					data: this.getComponentSchema(component).describe(component.description || component.type)
+				}))])) });
 				const prompt = `Generate status updates for relevant components based on what the user has asked for.${conversationContext}${previousSummaries.length > 0 ? `\n${previousSummaryContext}` : ""}
 
 Activities:\n${userVisibleActivities.join("\n") || "No New Activities"}
 
-Available components: no_relevant_updates, ${statusComponents.map((c) => c.type).join(", ")}
+Available component types: no_relevant_updates, ${statusComponents.map((c) => c.type).join(", ")}
 
 Rules:
-- Fill in data for relevant components only
-- Use 'no_relevant_updates' if nothing substantially new to report. DO NOT WRITE LABELS OR USE OTHER COMPONENTS IF YOU USE THIS COMPONENT.
+- Return an array of updates for relevant components
+- Use 'no_relevant_updates' type if nothing substantially new to report. DO NOT INCLUDE OTHER COMPONENT TYPES IF YOU USE THIS ONE.
 - Never repeat previous values, make every update EXTREMELY unique. If you cannot do that the update is not worth mentioning.
 - Labels MUST be short 3-7 word phrases with ACTUAL information discovered. NEVER MAKE UP SOMETHING WITHOUT BACKING IT UP WITH ACTUAL INFORMATION.
 - Use sentence case: only capitalize the first word and proper nouns (e.g., "Admin permissions required", not "Admin Permissions Required"). ALWAYS capitalize the first word of the label.
@@ -595,21 +601,19 @@ ${this.statusUpdateState?.config.prompt?.trim() || ""}`;
 				const result = object;
 				logger.info({ result: JSON.stringify(result) }, "DEBUG: Result");
 				const summaries = [];
-				for (const [componentId, data] of Object.entries(result)) {
-					logger.info({
-						componentId,
-						data: JSON.stringify(data)
-					}, "DEBUG: Component data");
-					if (componentId === "no_relevant_updates") continue;
-					if (data && typeof data === "object" && Object.keys(data).length > 0) summaries.push({
-						type: componentId,
-						data
+				const updates = result.updates || [];
+				for (const update of updates) {
+					logger.info({ update: JSON.stringify(update) }, "DEBUG: Update data");
+					if (update.type === "no_relevant_updates") continue;
+					if (update.data && typeof update.data === "object" && Object.keys(update.data).length > 0) summaries.push({
+						type: update.type,
+						data: update.data
 					});
 				}
 				span.setAttributes({
 					"summaries.count": summaries.length,
 					"user_activities.count": userVisibleActivities.length,
-					"result_keys.count": Object.keys(result).length
+					"updates.count": updates.length
 				});
 				span.setStatus({ code: SpanStatusCode.OK });
 				return { summaries };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-run-api",
-  "version": "0.41.0",
+  "version": "0.41.1",
   "description": "Agents Run API for Inkeep Agent Framework - handles chat, agent execution, and streaming",
   "types": "dist/index.d.ts",
   "exports": {
@@ -41,7 +41,7 @@
     "hono": "^4.10.4",
     "jmespath": "^0.16.0",
     "llm-info": "^1.0.69",
-    "@inkeep/agents-core": "^0.41.0"
+    "@inkeep/agents-core": "^0.41.1"
   },
   "peerDependencies": {
     "@hono/zod-openapi": "^1.1.5",