@inkeep/agents-run-api 0.0.0-dev-20260113172432 → 0.0.0-dev-20260115183047

package/README.md

@@ -44,7 +44,8 @@ pnpm db:migrate
 ```env
 ENVIRONMENT=development|production|test
 PORT=3003
-DATABASE_URL=postgresql://dbuser:secretpassword@database.server.com:3211/mydb
+INKEEP_AGENTS_MANAGE_DATABASE_URL=postgresql://dbuser:secretpassword@database.server.com:3211/mydb
+INKEEP_AGENTS_RUN_DATABASE_URL=postgresql://dbuser:secretpassword@database.server.com:3212/mydb
 ANTHROPIC_API_KEY=required
 OPENAI_API_KEY=optional
 LOG_LEVEL=debug|info|warn|error

package/dist/a2a/client.d.ts

@@ -1,4 +1,4 @@
-import { AgentCard, CancelTaskResponse, GetTaskPushNotificationConfigResponse, GetTaskResponse, Message, MessageSendParams, SendMessageResponse, SetTaskPushNotificationConfigResponse, Task, TaskArtifactUpdateEvent, TaskIdParams, TaskPushNotificationConfig, TaskQueryParams, TaskStatusUpdateEvent } from "@inkeep/agents-core";
+import { AgentCard, CancelTaskResponse, GetTaskPushNotificationConfigResponse, GetTaskResponse, Message, MessageSendParams, ResolvedRef, SendMessageResponse, SetTaskPushNotificationConfigResponse, Task, TaskArtifactUpdateEvent, TaskIdParams, TaskPushNotificationConfig, TaskQueryParams, TaskStatusUpdateEvent } from "@inkeep/agents-core";
 
 //#region src/a2a/client.d.ts
 type A2AStreamEventData = Message | Task | TaskStatusUpdateEvent | TaskArtifactUpdateEvent;
@@ -18,6 +18,7 @@ type RetryConfig = {
 };
 interface A2AClientOptions {
   retryConfig?: RetryConfig;
+  ref?: ResolvedRef;
   headers?: Record<string, string>;
 }
 /**
@@ -89,6 +90,7 @@ declare class A2AClient {
   getAgentCard(agentBaseUrl?: string): Promise<AgentCard>;
   /**
    * Gets the RPC service endpoint URL. Ensures the agent card has been fetched first.
+   * Adds ref as query parameter if it exists.
    * @returns A Promise that resolves to the service endpoint URL string.
    */
   private _getServiceEndpoint;

package/dist/a2a/client.js

@@ -110,16 +110,18 @@ var A2AClient = class {
 	*/
 	async _fetchAndCacheAgentCard() {
 		const agentCardUrl = `${this.agentBaseUrl}/.well-known/agent.json`;
+		const url = new URL(agentCardUrl);
+		if (this.options.ref) url.searchParams.set("ref", this.options.ref.name);
 		getLogger("a2a").info({
-			agentCardUrl,
+			agentCardUrl: url.toString(),
 			agentBaseUrl: this.agentBaseUrl
 		}, "agentCardUrl");
 		try {
-			const response = await fetch(agentCardUrl, { headers: {
+			const response = await fetch(url.toString(), { headers: {
 				Accept: "application/json",
 				...this.options.headers || {}
 			} });
-			if (!response.ok) throw new Error(`Failed to fetch Agent Card from ${agentCardUrl}: ${response.status} ${response.statusText}`);
+			if (!response.ok) throw new Error(`Failed to fetch Agent Card from ${url.toString()}: ${response.status} ${response.statusText}`);
 			const agentCard = await response.json();
 			if (!agentCard.url) throw new Error("Fetched Agent Card does not contain a valid 'url' for the service endpoint.");
 			this.serviceEndpointUrl = agentCard.url;
@@ -140,24 +142,36 @@ var A2AClient = class {
 	async getAgentCard(agentBaseUrl) {
 		if (agentBaseUrl) {
 			const agentCardUrl = `${agentBaseUrl.replace(/\/$/, "")}/.well-known/agent.json`;
-			const response = await fetch(agentCardUrl, { headers: {
+			const url = new URL(agentCardUrl);
+			if (this.options.ref) url.searchParams.set("ref", this.options.ref.name);
+			const response = await fetch(url.toString(), { headers: {
 				Accept: "application/json",
 				...this.options.headers || {}
 			} });
-			if (!response.ok) throw new Error(`Failed to fetch Agent Card from ${agentCardUrl}: ${response.status} ${response.statusText}`);
+			if (!response.ok) throw new Error(`Failed to fetch Agent Card from ${url.toString()}: ${response.status} ${response.statusText}`);
 			return await response.json();
 		}
 		return this.agentCardPromise;
 	}
 	/**
 	* Gets the RPC service endpoint URL. Ensures the agent card has been fetched first.
+	* Adds ref as query parameter if it exists.
 	* @returns A Promise that resolves to the service endpoint URL string.
 	*/
 	async _getServiceEndpoint() {
-		if (this.serviceEndpointUrl) return this.serviceEndpointUrl;
-		await this.agentCardPromise;
-		if (!this.serviceEndpointUrl) throw new Error("Agent Card URL for RPC endpoint is not available. Fetching might have failed.");
-		return this.serviceEndpointUrl;
+		let endpoint;
+		if (this.serviceEndpointUrl) endpoint = this.serviceEndpointUrl;
+		else {
+			await this.agentCardPromise;
+			if (!this.serviceEndpointUrl) throw new Error("Agent Card URL for RPC endpoint is not available. Fetching might have failed.");
+			endpoint = this.serviceEndpointUrl;
+		}
+		if (this.options.ref) {
+			const url = new URL(endpoint);
+			url.searchParams.set("ref", this.options.ref.name);
+			return url.toString();
+		}
+		return endpoint;
 	}
 	/**
 	* Retry utility functions

package/dist/a2a/handlers.js

@@ -1,10 +1,10 @@
-import { getLogger } from "../logger.js";
+import { getLogger as getLogger$1 } from "../logger.js";
 import dbClient_default from "../data/db/dbClient.js";
-import { TaskState, createMessage, createTask, generateId, getRequestExecutionContext, updateTask } from "@inkeep/agents-core";
+import { TaskState, createMessage, createTask, generateId, updateTask } from "@inkeep/agents-core";
 import { streamSSE } from "hono/streaming";
 
 //#region src/a2a/handlers.ts
-const logger = getLogger("a2aHandler");
+const logger = getLogger$1("a2aHandler");
 async function a2aHandler(c, agent) {
 	try {
 		const rpcRequest = c.get("requestBody");
@@ -49,7 +49,7 @@ async function a2aHandler(c, agent) {
 async function handleMessageSend(c, agent, request) {
 	try {
 		const params = request.params;
-		const { agentId } = getRequestExecutionContext(c);
+		const { agentId, resolvedRef } = c.get("executionContext");
 		const forwardedHeaders = {};
 		const xForwardedCookie = c.req.header("x-forwarded-cookie");
 		const cookie = c.req.header("cookie");
@@ -135,6 +135,7 @@ async function handleMessageSend(c, agent, request) {
 				agent_id: agentId || "",
 				stream_request_id: params.message.metadata?.stream_request_id
 			},
+			ref: resolvedRef,
 			subAgentId: agent.subAgentId,
 			createdAt: (/* @__PURE__ */ new Date()).toISOString(),
 			updatedAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -280,6 +281,11 @@ async function handleMessageSend(c, agent, request) {
 			id: request.id
 		});
 	} catch (error) {
+		logger.error({
+			error: error instanceof Error ? error.message : "Unknown error",
+			stack: error instanceof Error ? error.stack : void 0,
+			subAgentId: agent.subAgentId
+		}, "Error in handleMessageSend");
 		return c.json({
 			jsonrpc: "2.0",
 			error: {
@@ -294,7 +300,7 @@ async function handleMessageSend(c, agent, request) {
 async function handleMessageStream(c, agent, request) {
 	try {
 		const params = request.params;
-		const { agentId } = getRequestExecutionContext(c);
+		const { agentId } = c.get("executionContext");
 		if (!agent.agentCard.capabilities.streaming) return c.json({
 			jsonrpc: "2.0",
 			error: {

package/dist/a2a/transfer.d.ts

@@ -1,4 +1,5 @@
 import { extractTransferData, isTransferTask } from "./types.js";
+import { ResolvedRef } from "@inkeep/agents-core";
 
 //#region src/a2a/transfer.d.ts
 /**
@@ -8,12 +9,16 @@ declare function executeTransfer({
   tenantId,
   threadId,
   projectId,
-  targetSubAgentId
+  agentId,
+  targetSubAgentId,
+  ref
 }: {
   tenantId: string;
   threadId: string;
   projectId: string;
+  agentId: string;
   targetSubAgentId: string;
+  ref: ResolvedRef;
 }): Promise<{
   success: boolean;
   targetSubAgentId: string;

package/dist/a2a/transfer.js

@@ -1,14 +1,14 @@
-import { getLogger } from "../logger.js";
+import { getLogger as getLogger$1 } from "../logger.js";
 import dbClient_default from "../data/db/dbClient.js";
 import { extractTransferData, isTransferTask } from "./types.js";
 import { setActiveAgentForThread } from "@inkeep/agents-core";
 
 //#region src/a2a/transfer.ts
-const logger = getLogger("Transfer");
+const logger = getLogger$1("Transfer");
 /**
 * Executes a transfer by sending the original message to the target agent
 */
-async function executeTransfer({ tenantId, threadId, projectId, targetSubAgentId }) {
+async function executeTransfer({ tenantId, threadId, projectId, agentId, targetSubAgentId, ref }) {
 	logger.info({
 		targetAgent: targetSubAgentId,
 		threadId,
@@ -22,17 +22,21 @@ async function executeTransfer({ tenantId, threadId, projectId, targetSubAgentId
 				projectId
 			},
 			threadId,
-			subAgentId: targetSubAgentId
+			subAgentId: targetSubAgentId,
+			agentId,
+			ref
 		});
 		logger.info({
 			targetAgent: targetSubAgentId,
-			threadId
+			threadId,
+			agentId
 		}, "Successfully updated active_sub_agent_id in database");
 	} catch (error) {
 		logger.error({
 			error,
 			targetAgent: targetSubAgentId,
-			threadId
+			threadId,
+			agentId
 		}, "Failed to update active_sub_agent_id");
 		throw error;
 	}

package/dist/agents/Agent.d.ts

@@ -1,6 +1,6 @@
 import { SandboxConfig } from "../types/execution-context.js";
 import { StreamHelper } from "../utils/stream-helpers.js";
-import { AgentConversationHistoryConfig, Artifact, ArtifactComponentApiInsert, CredentialStoreRegistry, DataComponentApiInsert, McpTool, Models, SubAgentStopWhen } from "@inkeep/agents-core";
+import { AgentConversationHistoryConfig, Artifact, ArtifactComponentApiInsert, CredentialStoreRegistry, DataComponentApiInsert, FullExecutionContext, McpTool, Models, ResolvedRef, SubAgentStopWhen } from "@inkeep/agents-core";
 import { ToolSet } from "ai";
 
 //#region src/agents/Agent.d.ts
@@ -56,6 +56,7 @@ type ExternalAgentRelationConfig = {
   id: string;
   name: string;
   description: string;
+  ref: ResolvedRef;
   baseUrl: string;
   credentialReferenceId?: string | null;
   headers?: Record<string, string> | null;
@@ -64,6 +65,7 @@ type ExternalAgentRelationConfig = {
 type TeamAgentRelationConfig = {
   relationId: string;
   id: string;
+  ref: ResolvedRef;
   name: string;
   description: string;
   baseUrl: string;
@@ -96,7 +98,8 @@ declare class Agent {
   private mcpClientCache;
   private mcpConnectionLocks;
   private currentCompressor;
-  constructor(config: AgentConfig, credentialStoreRegistry?: CredentialStoreRegistry);
+  private executionContext;
+  constructor(config: AgentConfig, executionContext: FullExecutionContext, credentialStoreRegistry?: CredentialStoreRegistry);
   /**
    * Get the maximum number of generation steps for this agent
    * Uses agent's stopWhen.stepCountIs config or defaults to AGENT_EXECUTION_MAX_GENERATION_STEPS
@@ -160,9 +163,9 @@ declare class Agent {
    */
   private convertToMCPToolConfig;
   getMcpTool(tool: McpTool): Promise<{
-    tools: Record<string, any>;
+    tools: any;
     toolPolicies: Record<string, {
-      needsApproval?: boolean;
+      needsApproval?: boolean | undefined;
     }>;
     mcpServerId: string;
     mcpServerName: string;
@@ -191,6 +194,7 @@ declare class Agent {
   private createThinkingCompleteTool;
   private getDefaultTools;
   private getStreamRequestId;
+  private applyToolOverrides;
   /**
    * Format tool result for storage in conversation history
    */