@inkeep/agents-api 0.0.1 → 0.42.0

package/dist/.well-known/workflow/v1/step.cjs.debug.json

@@ -1,8 +1,6 @@
 {
   "stepFiles": [
-    "/Users/andrew/Documents/code/agents/agents/agents-api/src/domains/evals/workflow/functions/runDatasetItem.ts",
-    "/Users/andrew/Documents/code/agents/agents/agents-api/dist/domains/evals/workflow/functions/evaluateConversation.js",
-    "/Users/andrew/Documents/code/agents/agents/agents-api/dist/domains/evals/workflow/functions/runDatasetItem.js",
-    "/Users/andrew/Documents/code/agents/agents/agents-api/src/domains/evals/workflow/functions/evaluateConversation.ts"
+    "/home/runner/work/agents/agents/agents-api/src/domains/evals/workflow/functions/evaluateConversation.ts",
+    "/home/runner/work/agents/agents/agents-api/src/domains/evals/workflow/functions/runDatasetItem.ts"
   ]
 }

package/dist/domains/evals/routes/datasetTriggers.d.ts

@@ -1,7 +1,7 @@
 import { OpenAPIHono } from "@hono/zod-openapi";
-import * as hono7 from "hono";
+import * as hono14 from "hono";
 
 //#region src/domains/evals/routes/datasetTriggers.d.ts
-declare const app: OpenAPIHono<hono7.Env, {}, "/">;
+declare const app: OpenAPIHono<hono14.Env, {}, "/">;
 //#endregion
 export { app as default };

package/dist/domains/evals/routes/index.d.ts

@@ -1,7 +1,7 @@
 import { OpenAPIHono } from "@hono/zod-openapi";
-import * as hono1 from "hono";
+import * as hono15 from "hono";
 
 //#region src/domains/evals/routes/index.d.ts
-declare const app: OpenAPIHono<hono1.Env, {}, "/">;
+declare const app: OpenAPIHono<hono15.Env, {}, "/">;
 //#endregion
 export { app as default };

package/dist/domains/evals/workflow/functions/evaluateConversation.d.ts

@@ -13,7 +13,7 @@ type EvaluationPayload = {
  * - Do NOT call Node.js APIs directly here (no DB, no fs, etc.)
  * - All side effects must happen in step functions
  */
-declare function evaluateConversationWorkflow(payload: EvaluationPayload): Promise<{
+declare function _evaluateConversationWorkflow(payload: EvaluationPayload): Promise<{
   success: boolean;
   reason: string;
   conversationId?: undefined;
@@ -24,5 +24,8 @@ declare function evaluateConversationWorkflow(payload: EvaluationPayload): Promi
   resultCount: number;
   reason?: undefined;
 }>;
+declare const evaluateConversationWorkflow: typeof _evaluateConversationWorkflow & {
+  workflowId: string;
+};
 //#endregion
 export { evaluateConversationWorkflow };

package/dist/domains/evals/workflow/functions/evaluateConversation.js

@@ -102,7 +102,7 @@ async function logStep(message, data) {
 * - Do NOT call Node.js APIs directly here (no DB, no fs, etc.)
 * - All side effects must happen in step functions
 */
-async function evaluateConversationWorkflow(payload) {
+async function _evaluateConversationWorkflow(payload) {
 	"use workflow";
 	const { conversationId, evaluatorIds } = payload;
 	await logStep("Starting conversation evaluation", payload);
@@ -129,6 +129,7 @@ async function evaluateConversationWorkflow(payload) {
 		resultCount: results.length
 	};
 }
+const evaluateConversationWorkflow = Object.assign(_evaluateConversationWorkflow, { workflowId: "workflow//src/domains/evals/workflow/functions/evaluateConversation.ts//_evaluateConversationWorkflow" });
 
 //#endregion
 export { evaluateConversationWorkflow };

package/dist/domains/evals/workflow/functions/runDatasetItem.d.ts

@@ -25,12 +25,15 @@ type RunDatasetItemPayload = {
  * Main workflow function - processes a single dataset item through the chat API.
  * Optionally runs evaluators on the resulting conversation.
  */
-declare function runDatasetItemWorkflow(payload: RunDatasetItemPayload): Promise<{
+declare function _runDatasetItemWorkflow(payload: RunDatasetItemPayload): Promise<{
   success: boolean;
   datasetItemId: string;
   datasetRunId: string;
   conversationId: string | null;
   error: string | null;
 }>;
+declare const runDatasetItemWorkflow: typeof _runDatasetItemWorkflow & {
+  workflowId: string;
+};
 //#endregion
 export { runDatasetItemWorkflow };

package/dist/domains/evals/workflow/functions/runDatasetItem.js

@@ -173,7 +173,7 @@ async function logStep(message, data) {
 * Main workflow function - processes a single dataset item through the chat API.
 * Optionally runs evaluators on the resulting conversation.
 */
-async function runDatasetItemWorkflow(payload) {
+async function _runDatasetItemWorkflow(payload) {
 	"use workflow";
 	const { datasetItemId, datasetRunId, agentId, evaluatorIds, evaluationRunId } = payload;
 	await logStep("Starting dataset item processing", {
@@ -199,6 +199,7 @@ async function runDatasetItemWorkflow(payload) {
 		error: result.error || null
 	};
 }
+const runDatasetItemWorkflow = Object.assign(_runDatasetItemWorkflow, { workflowId: "workflow//src/domains/evals/workflow/functions/runDatasetItem.ts//_runDatasetItemWorkflow" });
 
 //#endregion
 export { runDatasetItemWorkflow };

package/dist/domains/evals/workflow/routes.d.ts

@@ -1,7 +1,7 @@
 import { Hono } from "hono";
-import * as hono_types1 from "hono/types";
+import * as hono_types5 from "hono/types";
 
 //#region src/domains/evals/workflow/routes.d.ts
-declare const workflowRoutes: Hono<hono_types1.BlankEnv, hono_types1.BlankSchema, "/">;
+declare const workflowRoutes: Hono<hono_types5.BlankEnv, hono_types5.BlankSchema, "/">;
 //#endregion
 export { workflowRoutes };

package/dist/domains/manage/routes/agent.js

@@ -206,6 +206,8 @@ app.openapi(createRoute({
 			agentId: id
 		},
 		data: {
+			name: validatedBody.name,
+			description: validatedBody.description,
 			defaultSubAgentId: validatedBody.defaultSubAgentId,
 			contextConfigId: validatedBody.contextConfigId ?? void 0
 		}

package/dist/domains/manage/routes/index.d.ts

@@ -1,7 +1,7 @@
 import { OpenAPIHono } from "@hono/zod-openapi";
-import * as hono9 from "hono";
+import * as hono16 from "hono";
 
 //#region src/domains/manage/routes/index.d.ts
-declare const app: OpenAPIHono<hono9.Env, {}, "/">;
+declare const app: OpenAPIHono<hono16.Env, {}, "/">;
 //#endregion
 export { app as default };

package/dist/domains/manage/routes/triggers.js

@@ -4,7 +4,7 @@ import runDbClient_default from "../../../data/db/runDbClient.js";
 import { requireProjectPermission } from "../../../middleware/projectAccess.js";
 import { speakeasyOffsetLimitPagination } from "../../../utils/speakeasy.js";
 import { OpenAPIHono, createRoute, z } from "@hono/zod-openapi";
-import { PaginationQueryParamsSchema, TenantProjectAgentIdParamsSchema, TenantProjectAgentParamsSchema, TriggerApiInsertSchema, TriggerApiSelectSchema, TriggerApiUpdateSchema, TriggerInvocationListResponse, TriggerInvocationResponse, TriggerInvocationStatusEnum, commonGetErrorResponses, createApiError, createTrigger, deleteTrigger, generateId, getTriggerById, getTriggerInvocationById, listTriggerInvocationsPaginated, listTriggersPaginated, updateTrigger } from "@inkeep/agents-core";
+import { PaginationQueryParamsSchema, TenantProjectAgentIdParamsSchema, TenantProjectAgentParamsSchema, TriggerApiInsertSchema, TriggerApiSelectSchema, TriggerApiUpdateSchema, TriggerInvocationListResponse, TriggerInvocationResponse, TriggerInvocationStatusEnum, commonGetErrorResponses, createApiError, createTrigger, deleteTrigger, generateId, getTriggerById, getTriggerInvocationById, hashAuthenticationHeaders, listTriggerInvocationsPaginated, listTriggersPaginated, updateTrigger } from "@inkeep/agents-core";
 
 //#region src/domains/manage/routes/triggers.ts
 const logger = getLogger$1("triggers");
@@ -167,6 +167,9 @@ app.openapi(createRoute({
 		agentId,
 		triggerId: id
 	}, "Creating trigger");
+	let hashedAuthentication;
+	const authInput = body.authentication;
+	if (authInput?.headers && authInput.headers.length > 0) hashedAuthentication = { headers: await hashAuthenticationHeaders(authInput.headers) };
 	const trigger = await createTrigger(db)({
 		id,
 		tenantId,
@@ -178,7 +181,7 @@ app.openapi(createRoute({
 		inputSchema: body.inputSchema,
 		outputTransform: body.outputTransform,
 		messageTemplate: body.messageTemplate,
-		authentication: body.authentication,
+		authentication: hashedAuthentication,
 		signingSecret: body.signingSecret
 	});
 	const { tenantId: _tid, projectId: _pid, agentId: _aid, ...triggerWithoutScopes } = trigger;
@@ -218,7 +221,7 @@ app.openapi(createRoute({
 	const { tenantId, projectId, agentId, id } = c.req.valid("param");
 	const body = c.req.valid("json");
 	const apiBaseUrl = env.INKEEP_AGENTS_API_URL;
-	if (!(body.name !== void 0 || body.description !== void 0 || body.enabled !== void 0 || body.inputSchema !== void 0 || body.outputTransform !== void 0 || body.messageTemplate !== void 0 || body.authentication !== void 0 || body.signingSecret !== void 0)) throw createApiError({
+	if (!(body.name !== void 0 || body.description !== void 0 || body.enabled !== void 0 || body.inputSchema !== void 0 || body.outputTransform !== void 0 || body.messageTemplate !== void 0 || body.authentication !== void 0 || body.signingSecret !== void 0 || body.keepExistingSigningSecret !== void 0)) throw createApiError({
 		code: "bad_request",
 		message: "No fields to update"
 	});
@@ -228,6 +231,35 @@ app.openapi(createRoute({
 		agentId,
 		triggerId: id
 	}, "Updating trigger");
+	let hashedAuthentication;
+	const authInput = body.authentication;
+	if (authInput?.headers && authInput.headers.length > 0) {
+		const existingAuth = (await getTriggerById(db)({
+			scopes: {
+				tenantId,
+				projectId,
+				agentId
+			},
+			triggerId: id
+		}))?.authentication;
+		const hashedHeaders = [];
+		for (const header of authInput.headers) if (header.keepExisting) {
+			const existingHeader = existingAuth?.headers?.find((h) => h.name === header.name);
+			if (existingHeader) hashedHeaders.push({
+				name: header.name,
+				valueHash: existingHeader.valueHash,
+				valuePrefix: existingHeader.valuePrefix
+			});
+		} else if (header.value) {
+			const hashed = await hashAuthenticationHeaders([{
+				name: header.name,
+				value: header.value
+			}]);
+			hashedHeaders.push(hashed[0]);
+		}
+		hashedAuthentication = hashedHeaders.length > 0 ? { headers: hashedHeaders } : void 0;
+	} else if (body.authentication !== void 0) hashedAuthentication = body.authentication;
+	const signingSecretUpdate = body.keepExistingSigningSecret ? void 0 : body.signingSecret;
 	const updatedTrigger = await updateTrigger(db)({
 		scopes: {
 			tenantId,
@@ -242,8 +274,8 @@ app.openapi(createRoute({
 			inputSchema: body.inputSchema,
 			outputTransform: body.outputTransform,
 			messageTemplate: body.messageTemplate,
-			authentication: body.authentication,
-			signingSecret: body.signingSecret
+			authentication: hashedAuthentication,
+			signingSecret: signingSecretUpdate
 		}
 	});
 	if (!updatedTrigger) throw createApiError({

package/dist/domains/run/a2a/handlers.js

@@ -61,11 +61,7 @@ async function handleMessageSend(c, agent, request) {
 		};
 		const task = {
 			id: generateId(),
-			input: { parts: params.message.parts.map((part) => ({
-				kind: part.kind,
-				text: part.kind === "text" ? part.text : void 0,
-				data: part.kind === "data" ? part.data : void 0
-			})) },
+			input: { parts: params.message.parts },
 			context: {
 				conversationId: params.message.contextId,
 				metadata: {
@@ -320,11 +316,7 @@ async function handleMessageStream(c, agent, request) {
 		else if (cookie) forwardedHeaders["x-forwarded-cookie"] = cookie;
 		const task = {
 			id: generateId(),
-			input: { parts: params.message.parts.map((part) => ({
-				kind: part.kind,
-				text: part.kind === "text" ? part.text : void 0,
-				data: part.kind === "data" ? part.data : void 0
-			})) },
+			input: { parts: params.message.parts },
 			context: {
 				conversationId: params.message.contextId,
 				metadata: {

package/dist/domains/run/a2a/types.d.ts

@@ -1,4 +1,4 @@
-import { AgentCard, Artifact, Message, Task, TaskState } from "@inkeep/agents-core";
+import { AgentCard, Artifact, Message, Part, Task, TaskState } from "@inkeep/agents-core";
 
 //#region src/domains/run/a2a/types.d.ts
 interface RegisteredAgent {
@@ -12,11 +12,7 @@ interface RegisteredAgent {
 interface A2ATask {
   id: string;
   input: {
-    parts: Array<{
-      kind: string;
-      text?: string;
-      data?: any;
-    }>;
+    parts: Part[];
   };
   context?: {
     conversationId?: string;

package/dist/domains/run/agents/generateTaskHandler.js

@@ -15,7 +15,13 @@ const createTaskHandler = (config, credentialStoreRegistry) => {
 	return async (task) => {
 		let agent;
 		try {
-			const userMessage = task.input.parts.filter((part) => part.text).map((part) => part.text).join(" ");
+			const textParts = task.input.parts.filter((part) => part.kind === "text").map((part) => part.text).join(" ");
+			const dataParts = task.input.parts.filter((part) => part.kind === "data" && part.data != null);
+			let userMessage = textParts;
+			if (dataParts.length > 0) userMessage = `${textParts}${dataParts.map((part) => {
+				const metadata = part.metadata;
+				return `\n\n<structured_data${metadata?.source ? ` (source: ${metadata.source})` : ""}>\n${JSON.stringify(part.data, null, 2)}\n</structured_data>`;
+			}).join("")}`;
 			if (!userMessage.trim()) return {
 				status: {
 					state: TaskState.Failed,
@@ -224,7 +230,13 @@ const createTaskHandler = (config, credentialStoreRegistry) => {
 				if (streamRequestId && tenantId && projectId) toolSessionManager.ensureAgentSession(streamRequestId, tenantId, projectId, contextId, task.id);
 			}
 			logger.info({ contextId }, "Context ID");
-			logger.info({ userMessage }, "User Message");
+			logger.info({
+				userMessage: userMessage.substring(0, 500),
+				inputPartsCount: task.input.parts.length,
+				textPartsCount: task.input.parts.filter((p) => p.kind === "text").length,
+				dataPartsCount: task.input.parts.filter((p) => p.kind === "data").length,
+				hasDataParts: task.input.parts.some((p) => p.kind === "data")
+			}, "User Message with parts breakdown");
 			const response = await agent.generate(userMessage, {
 				contextId,
 				metadata: {

package/dist/domains/run/agents/relationTools.d.ts

@@ -1,6 +1,6 @@
 import { AgentConfig, DelegateRelation } from "./Agent.js";
 import { InternalRelation } from "../utils/project.js";
-import * as _inkeep_agents_core2 from "@inkeep/agents-core";
+import * as _inkeep_agents_core1 from "@inkeep/agents-core";
 import { CredentialStoreRegistry, FullExecutionContext } from "@inkeep/agents-core";
 import * as ai0 from "ai";
 
@@ -44,7 +44,7 @@ declare function createDelegateToAgentTool({
   message: string;
 }, {
   toolCallId: any;
-  result: _inkeep_agents_core2.Message | _inkeep_agents_core2.Task;
+  result: _inkeep_agents_core1.Message | _inkeep_agents_core1.Task;
 }>;
 /**
  * Parameters for building a transfer relation config

package/dist/domains/run/handlers/executionHandler.d.ts

@@ -1,11 +1,13 @@
 import { StreamHelper } from "../utils/stream-helpers.js";
-import { FullExecutionContext } from "@inkeep/agents-core";
+import { FullExecutionContext, Part } from "@inkeep/agents-core";
 
 //#region src/domains/run/handlers/executionHandler.d.ts
 interface ExecutionHandlerParams {
   executionContext: FullExecutionContext;
   conversationId: string;
   userMessage: string;
+  /** Optional message parts for rich content (text + data). Used on first iteration only. */
+  messageParts?: Part[];
   initialAgentId: string;
   requestId: string;
   sseHelper: StreamHelper;

package/dist/domains/run/handlers/executionHandler.js

@@ -33,7 +33,7 @@ var ExecutionHandler = class {
 	* @returns
 	*/
 	async execute(params) {
-		const { executionContext, conversationId, userMessage, initialAgentId, requestId, sseHelper, emitOperations, forwardedHeaders } = params;
+		const { executionContext, conversationId, userMessage, messageParts, initialAgentId, requestId, sseHelper, emitOperations, forwardedHeaders } = params;
 		const { tenantId, projectId, project, agentId, apiKey, baseUrl, resolvedRef } = executionContext;
 		registerStreamHelper(requestId, sseHelper);
 		agentSessionManager.createSession(requestId, executionContext, conversationId);
@@ -178,13 +178,14 @@ var ExecutionHandler = class {
 					forwardedHeaders
 				};
 				if (fromSubAgentId) messageMetadata.fromSubAgentId = fromSubAgentId;
+				const partsToSend = iterations === 1 && messageParts && messageParts.length > 0 ? messageParts : [{
+					kind: "text",
+					text: currentMessage
+				}];
 				messageResponse = await a2aClient.sendMessage({
 					message: {
 						role: "user",
-						parts: [{
-							kind: "text",
-							text: currentMessage
-						}],
+						parts: partsToSend,
 						messageId: `${requestId}-iter-${iterations}`,
 						kind: "message",
 						contextId: conversationId,

package/dist/domains/run/routes/webhooks.js

@@ -94,7 +94,7 @@ app.openapi(triggerWebhookRoute, async (c) => {
 		const bodyText = await c.req.text();
 		const payload = bodyText ? JSON.parse(bodyText) : {};
 		if (trigger.authentication) {
-			const authResult = verifyTriggerAuth(c, trigger.authentication);
+			const authResult = await verifyTriggerAuth(c, trigger.authentication);
 			if (!authResult.success) {
 				if (authResult.status === 401) return c.json({ error: authResult.message || "Unauthorized" }, 401);
 				return c.json({ error: authResult.message || "Forbidden" }, 403);
@@ -132,7 +132,23 @@ app.openapi(triggerWebhookRoute, async (c) => {
 			}, "Payload transformation failed");
 			return c.json({ error: `Payload transformation failed: ${errorMessage}` }, 422);
 		}
-		const interpolatedMessage = trigger.messageTemplate ? interpolateTemplate(trigger.messageTemplate, transformedPayload) : JSON.stringify(transformedPayload);
+		const messageParts = [];
+		if (trigger.messageTemplate) {
+			const interpolatedMessage = interpolateTemplate(trigger.messageTemplate, transformedPayload);
+			messageParts.push({
+				kind: "text",
+				text: interpolatedMessage
+			});
+		}
+		if (transformedPayload != null) messageParts.push({
+			kind: "data",
+			data: transformedPayload,
+			metadata: {
+				source: "trigger",
+				triggerId
+			}
+		});
+		const userMessageText = trigger.messageTemplate ? interpolateTemplate(trigger.messageTemplate, transformedPayload) : JSON.stringify(transformedPayload);
 		const conversationId = getConversationId();
 		const invocationId = generateId();
 		await createTriggerInvocation(runDbClient_default)({
@@ -161,7 +177,8 @@ app.openapi(triggerWebhookRoute, async (c) => {
 			triggerId,
 			invocationId,
 			conversationId,
-			userMessage: interpolatedMessage,
+			userMessage: userMessageText,
+			messageParts,
 			resolvedRef
 		}).catch((error) => {
 			logger.error({
@@ -203,7 +220,7 @@ app.openapi(triggerWebhookRoute, async (c) => {
 * It updates the trigger invocation status based on success/failure.
 */
 async function invokeAgentAsync(params) {
-	const { tenantId, projectId, agentId, triggerId, invocationId, conversationId, userMessage, resolvedRef } = params;
+	const { tenantId, projectId, agentId, triggerId, invocationId, conversationId, userMessage, messageParts, resolvedRef } = params;
 	return await trace.getTracer("trigger-invocation").startActiveSpan("trigger.invocation", { attributes: {
 		"conversation.id": conversationId,
 		"tenant.id": tenantId,
@@ -213,6 +230,7 @@ async function invokeAgentAsync(params) {
 		"trigger.id": triggerId,
 		"trigger.invocation.id": invocationId,
 		"message.content": userMessage,
+		"message.parts": JSON.stringify(messageParts),
 		"message.timestamp": (/* @__PURE__ */ new Date()).toISOString()
 	} }, async (span) => {
 		let currentBag = propagation.getBaggage(context.active());
@@ -308,7 +326,7 @@ async function invokeAgentAsync(params) {
 					projectId,
 					conversationId,
 					role: "user",
-					content: { text: userMessage },
+					content: { parts: messageParts },
 					visibility: "user-facing",
 					messageType: "chat"
 				});
@@ -325,6 +343,7 @@ async function invokeAgentAsync(params) {
 					executionContext,
 					conversationId,
 					userMessage,
+					messageParts,
 					initialAgentId: agentId,
 					requestId,
 					sseHelper: noOpStreamHelper,

package/dist/domains/run/types/xml.d.ts

@@ -1,9 +1,5 @@
 //#region src/domains/run/types/xml.d.ts
-declare module '*.xml' {
-  const content: string;
-  export default content;
-}
-declare module '*.md' {
+declare module '*?raw' {
   const content: string;
   export default content;
 }

package/dist/domains/run/utils/token-estimator.d.ts

@@ -1,4 +1,4 @@
-import * as _inkeep_agents_core1 from "@inkeep/agents-core";
+import * as _inkeep_agents_core3 from "@inkeep/agents-core";
 import { BreakdownComponentDef, ContextBreakdown, calculateBreakdownTotal, createEmptyBreakdown } from "@inkeep/agents-core";
 
 //#region src/domains/run/utils/token-estimator.d.ts
@@ -17,7 +17,7 @@ interface AssembleResult {
   /** The assembled prompt string */
   prompt: string;
   /** Token breakdown for each component */
-  breakdown: _inkeep_agents_core1.ContextBreakdown;
+  breakdown: _inkeep_agents_core3.ContextBreakdown;
 }
 //#endregion
 export { AssembleResult, type BreakdownComponentDef, type ContextBreakdown, calculateBreakdownTotal, createEmptyBreakdown, estimateTokens };