@inkeep/agents-api 0.0.0-dev-20260122085034 → 0.0.0-dev-20260122090358

package/dist/.well-known/workflow/v1/manifest.debug.json

@@ -1,16 +1,5 @@
 {
   "steps": {
-    "node_modules/.pnpm/workflow@4.0.1-beta.33_@aws-sdk+client-sts@3.970.0_@opentelemetry+api@1.9.0_@types+reac_5c488396978166b4f12e99cb3aa4a769/node_modules/workflow/dist/internal/builtins.js": {
-      "__builtin_response_array_buffer": {
-        "stepId": "__builtin_response_array_buffer"
-      },
-      "__builtin_response_json": {
-        "stepId": "__builtin_response_json"
-      },
-      "__builtin_response_text": {
-        "stepId": "__builtin_response_text"
-      }
-    },
     "src/domains/evals/workflow/functions/runDatasetItem.ts": {
       "callChatApiStep": {
         "stepId": "step//src/domains/evals/workflow/functions/runDatasetItem.ts//callChatApiStep"
@@ -25,6 +14,17 @@
         "stepId": "step//src/domains/evals/workflow/functions/runDatasetItem.ts//logStep"
       }
     },
+    "node_modules/.pnpm/workflow@4.0.1-beta.33_@aws-sdk+client-sts@3.970.0_@opentelemetry+api@1.9.0_@types+reac_5c488396978166b4f12e99cb3aa4a769/node_modules/workflow/dist/internal/builtins.js": {
+      "__builtin_response_array_buffer": {
+        "stepId": "__builtin_response_array_buffer"
+      },
+      "__builtin_response_json": {
+        "stepId": "__builtin_response_json"
+      },
+      "__builtin_response_text": {
+        "stepId": "__builtin_response_text"
+      }
+    },
     "src/domains/evals/workflow/functions/evaluateConversation.ts": {
       "executeEvaluatorStep": {
         "stepId": "step//src/domains/evals/workflow/functions/evaluateConversation.ts//executeEvaluatorStep"

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

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

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

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

package/dist/domains/evals/workflow/world.js

@@ -11,8 +11,9 @@ import { createVercelWorld } from "@workflow/world-vercel";
 * Vercel's NFT can't trace dynamic imports in bundled code.
 *
 * Set WORKFLOW_TARGET_WORLD to: 'local' | 'vercel' | '@workflow/world-postgres'
+* Defaults to 'local' for development if not set.
 */
-const targetWorld = env.WORKFLOW_TARGET_WORLD;
+const targetWorld = env.WORKFLOW_TARGET_WORLD || "local";
 let world;
 if (targetWorld === "vercel") {
 	const token = process.env.WORKFLOW_VERCEL_AUTH_TOKEN;
@@ -30,7 +31,7 @@ if (targetWorld === "vercel") {
 	jobPrefix: env.WORKFLOW_POSTGRES_JOB_PREFIX,
 	queueConcurrency: Number(env.WORKFLOW_POSTGRES_WORKER_CONCURRENCY) || 10
 });
-else if (targetWorld === "local") world = createLocalWorld();
+else world = createLocalWorld();
 
 //#endregion
 export { world };

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

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

package/dist/domains/manage/routes/evals/evaluationResults.d.ts

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

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

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

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

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

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

@@ -1,18 +1,10 @@
-import { getLogger as getLogger$1 } from "../../../logger.js";
-import { env } from "../../../env.js";
-import manageDbPool_default from "../../../data/db/manageDbPool.js";
-import runDbClient_default from "../../../data/db/runDbClient.js";
-import { createSSEStreamHelper } from "../utils/stream-helpers.js";
-import { ExecutionHandler } from "../handlers/executionHandler.js";
+import { getLogger } from "../../../logger.js";
+import { processWebhook } from "../services/TriggerService.js";
 import { OpenAPIHono, createRoute, z } from "@hono/zod-openapi";
-import { JsonTransformer, createApiError, createMessage, createOrGetConversation, createTriggerInvocation, generateId, getConversationId, getFullProjectWithRelationIds, getTriggerById, interpolateTemplate, setActiveAgentForConversation, updateTriggerInvocationStatus, verifySigningSecret, verifyTriggerAuth, withRef } from "@inkeep/agents-core";
-import { ROOT_CONTEXT, context, propagation, trace } from "@opentelemetry/api";
-import Ajv from "ajv";
 
 //#region src/domains/run/routes/webhooks.ts
 const app = new OpenAPIHono();
-const logger = getLogger$1("webhooks");
-const ajv = new Ajv({ allErrors: true });
+const logger = getLogger("webhooks");
 /**
 * Webhook endpoint for trigger invocation
 * POST /tenants/{tenantId}/projects/{projectId}/agents/{agentId}/triggers/{triggerId}
@@ -37,7 +29,8 @@ const triggerWebhookRoute = createRoute({
 			description: "Webhook accepted and trigger invoked",
 			content: { "application/json": { schema: z.object({
 				success: z.boolean(),
-				invocationId: z.string()
+				invocationId: z.string(),
+				conversationId: z.string()
 			}) } }
 		},
 		400: {
@@ -74,336 +67,36 @@ app.openapi(triggerWebhookRoute, async (c) => {
 		agentId,
 		triggerId
 	}, "Processing trigger webhook");
-	try {
-		const trigger = await withRef(manageDbPool_default, resolvedRef, (db) => getTriggerById(db)({
-			scopes: {
-				tenantId,
-				projectId,
-				agentId
-			},
-			triggerId
-		}));
-		if (!trigger) throw createApiError({
-			code: "not_found",
-			message: `Trigger ${triggerId} not found`
-		});
-		if (!trigger.enabled) throw createApiError({
-			code: "not_found",
-			message: "Trigger is disabled"
-		});
-		const bodyText = await c.req.text();
-		const payload = bodyText ? JSON.parse(bodyText) : {};
-		if (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);
-			}
-		}
-		if (trigger.signingSecret) {
-			const signatureResult = verifySigningSecret(c, trigger.signingSecret, bodyText);
-			if (!signatureResult.success) return c.json({ error: signatureResult.message || "Invalid signature" }, 403);
-		}
-		if (trigger.inputSchema) {
-			const validate = ajv.compile(trigger.inputSchema);
-			if (!validate(payload)) {
-				const errors = validate.errors?.map((err) => `${err.instancePath} ${err.message}`);
-				return c.json({
-					error: "Payload validation failed",
-					validationErrors: errors
-				}, 400);
-			}
-		}
-		let transformedPayload = payload;
-		if (trigger.outputTransform) try {
-			transformedPayload = await JsonTransformer.transformWithConfig(payload, trigger.outputTransform);
-			logger.debug({
-				triggerId,
-				tenantId,
-				projectId
-			}, "Payload transformation successful");
-		} catch (error) {
-			const errorMessage = error instanceof Error ? error.message : String(error);
-			logger.error({
-				triggerId,
-				tenantId,
-				projectId,
-				error: errorMessage
-			}, "Payload transformation failed");
-			return c.json({ error: `Payload transformation failed: ${errorMessage}` }, 422);
-		}
-		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)({
-			id: invocationId,
-			triggerId,
-			tenantId,
-			projectId,
-			agentId,
-			conversationId,
-			status: "pending",
-			requestPayload: payload,
-			transformedPayload
-		});
-		logger.info({
-			tenantId,
-			projectId,
-			agentId,
-			triggerId,
-			invocationId,
-			conversationId
-		}, "Trigger invocation created");
-		invokeAgentAsync({
-			tenantId,
-			projectId,
-			agentId,
-			triggerId,
-			invocationId,
-			conversationId,
-			userMessage: userMessageText,
-			messageParts,
-			resolvedRef
-		}).catch((error) => {
-			logger.error({
-				error,
-				tenantId,
-				projectId,
-				agentId,
-				triggerId,
-				invocationId
-			}, "Async agent invocation failed");
-		});
-		logger.info({
-			tenantId,
-			projectId,
-			agentId,
-			triggerId,
-			invocationId,
-			conversationId
-		}, "Trigger webhook accepted, agent invocation initiated");
-		return c.json({
-			success: true,
-			invocationId
-		}, 202);
-	} catch (error) {
-		logger.error({
-			error,
-			tenantId,
-			projectId,
-			agentId,
-			triggerId
-		}, "Webhook processing failed");
-		throw error;
+	const result = await processWebhook({
+		tenantId,
+		projectId,
+		agentId,
+		triggerId,
+		resolvedRef,
+		rawBody: await c.req.text(),
+		honoContext: c
+	});
+	if (!result.success) {
+		if (result.validationErrors) return c.json({
+			error: result.error,
+			validationErrors: result.validationErrors
+		}, result.status);
+		return c.json({ error: result.error }, result.status);
 	}
+	logger.info({
+		tenantId,
+		projectId,
+		agentId,
+		triggerId,
+		invocationId: result.invocationId,
+		conversationId: result.conversationId
+	}, "Trigger webhook accepted, workflow dispatched");
+	return c.json({
+		success: true,
+		invocationId: result.invocationId,
+		conversationId: result.conversationId
+	}, 202);
 });
-/**
-* Invokes an agent asynchronously for a trigger invocation.
-* This function creates a conversation, stores the user message,
-* and executes the agent using ExecutionHandler.
-* It updates the trigger invocation status based on success/failure.
-*/
-async function invokeAgentAsync(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,
-		"project.id": projectId,
-		"agent.id": agentId,
-		"invocation.type": "trigger",
-		"trigger.id": triggerId,
-		"trigger.invocation.id": invocationId,
-		"message.content": userMessage,
-		"message.parts": JSON.stringify(messageParts),
-		"message.timestamp": (/* @__PURE__ */ new Date()).toISOString()
-	} }, ROOT_CONTEXT, async (span) => {
-		const spanCtx = trace.setSpan(ROOT_CONTEXT, span);
-		let bag = propagation.getBaggage(spanCtx) ?? propagation.createBaggage();
-		bag = bag.setEntry("conversation.id", { value: conversationId }).setEntry("tenant.id", { value: tenantId }).setEntry("project.id", { value: projectId }).setEntry("agent.id", { value: agentId }).setEntry("invocation.type", { value: "trigger" }).setEntry("trigger.id", { value: triggerId }).setEntry("trigger.invocation.id", { value: invocationId });
-		const ctx = propagation.setBaggage(spanCtx, bag);
-		return await context.with(ctx, async () => {
-			try {
-				logger.info({
-					tenantId,
-					projectId,
-					agentId,
-					triggerId,
-					invocationId,
-					conversationId
-				}, "Starting async agent invocation");
-				const project = await withRef(manageDbPool_default, resolvedRef, async (db) => {
-					return await getFullProjectWithRelationIds(db)({ scopes: {
-						tenantId,
-						projectId
-					} });
-				});
-				if (!project) throw createApiError({
-					code: "not_found",
-					message: `Project ${projectId} not found`
-				});
-				const fullAgent = project.agents[agentId];
-				if (!fullAgent) throw createApiError({
-					code: "not_found",
-					message: `Agent ${agentId} not found`
-				});
-				span.setAttribute("agent.name", fullAgent.name || "");
-				logger.debug({
-					tenantId,
-					projectId,
-					agentId,
-					defaultSubAgentId: fullAgent.defaultSubAgentId,
-					subAgentKeys: Object.keys(fullAgent.subAgents || {}),
-					subAgentsCount: Object.keys(fullAgent.subAgents || {}).length
-				}, "Debug: Agent and sub-agent info");
-				const agentKeys = Object.keys(fullAgent.subAgents || {});
-				const firstAgentId = agentKeys.length > 0 ? agentKeys[0] : "";
-				const defaultSubAgentId = fullAgent.defaultSubAgentId || firstAgentId;
-				if (!defaultSubAgentId) throw createApiError({
-					code: "not_found",
-					message: "No default sub-agent found"
-				});
-				const executionContext = {
-					tenantId,
-					projectId,
-					agentId,
-					baseUrl: env.INKEEP_AGENTS_API_URL || "http://localhost:3002",
-					apiKey: env.INKEEP_AGENTS_RUN_API_BYPASS_SECRET || "",
-					apiKeyId: "trigger-invocation",
-					resolvedRef,
-					project,
-					metadata: { initiatedBy: {
-						type: "api_key",
-						id: triggerId
-					} }
-				};
-				await createOrGetConversation(runDbClient_default)({
-					tenantId,
-					projectId,
-					id: conversationId,
-					agentId,
-					activeSubAgentId: defaultSubAgentId,
-					ref: executionContext.resolvedRef
-				});
-				await setActiveAgentForConversation(runDbClient_default)({
-					scopes: {
-						tenantId,
-						projectId
-					},
-					conversationId,
-					agentId,
-					subAgentId: defaultSubAgentId,
-					ref: executionContext.resolvedRef
-				});
-				logger.info({
-					conversationId,
-					agentId,
-					defaultSubAgentId
-				}, "Conversation created and agent set");
-				await createMessage(runDbClient_default)({
-					id: generateId(),
-					tenantId,
-					projectId,
-					conversationId,
-					role: "user",
-					content: { parts: messageParts },
-					visibility: "user-facing",
-					messageType: "chat"
-				});
-				logger.info({
-					conversationId,
-					invocationId
-				}, "User message created");
-				const requestId = `trigger-${invocationId}`;
-				const noOpStreamHelper = createSSEStreamHelper({
-					writeSSE: async () => {},
-					sleep: async () => {}
-				}, requestId, Math.floor(Date.now() / 1e3));
-				await new ExecutionHandler().execute({
-					executionContext,
-					conversationId,
-					userMessage,
-					messageParts,
-					initialAgentId: agentId,
-					requestId,
-					sseHelper: noOpStreamHelper,
-					emitOperations: false
-				});
-				await updateTriggerInvocationStatus(runDbClient_default)({
-					scopes: {
-						tenantId,
-						projectId,
-						agentId
-					},
-					triggerId,
-					invocationId,
-					data: { status: "success" }
-				});
-				logger.info({
-					tenantId,
-					projectId,
-					agentId,
-					triggerId,
-					invocationId,
-					conversationId
-				}, "Agent invocation completed successfully");
-				span.end();
-			} catch (error) {
-				const errorMessage = error instanceof Error ? error.message : String(error);
-				logger.error({
-					error,
-					tenantId,
-					projectId,
-					agentId,
-					triggerId,
-					invocationId
-				}, "Agent invocation failed");
-				span.recordException(error instanceof Error ? error : new Error(errorMessage));
-				span.setStatus({
-					code: 2,
-					message: errorMessage
-				});
-				try {
-					await updateTriggerInvocationStatus(runDbClient_default)({
-						scopes: {
-							tenantId,
-							projectId,
-							agentId
-						},
-						triggerId,
-						invocationId,
-						data: {
-							status: "failed",
-							errorMessage
-						}
-					});
-				} catch (updateError) {
-					logger.error({
-						updateError,
-						invocationId
-					}, "Failed to update trigger invocation status to failed");
-				}
-				span.end();
-				throw error;
-			}
-		});
-	});
-}
 var webhooks_default = app;
 
 //#endregion

package/dist/domains/run/services/TriggerService.d.ts

@@ -0,0 +1,31 @@
+import { Context } from "hono";
+import { ResolvedRef } from "@inkeep/agents-core";
+
+//#region src/domains/run/services/TriggerService.d.ts
+
+type TriggerWebhookParams = {
+  tenantId: string;
+  projectId: string;
+  agentId: string;
+  triggerId: string;
+  resolvedRef: ResolvedRef;
+  rawBody: string;
+  honoContext: Context;
+};
+type TriggerWebhookResult = {
+  success: true;
+  invocationId: string;
+  conversationId: string;
+} | {
+  success: false;
+  error: string;
+  status: 400 | 401 | 403 | 404 | 422;
+  validationErrors?: string[];
+};
+/**
+ * Process a trigger webhook request.
+ * Handles validation, transformation, and dispatches async execution.
+ */
+declare function processWebhook(params: TriggerWebhookParams): Promise<TriggerWebhookResult>;
+//#endregion
+export { TriggerWebhookParams, TriggerWebhookResult, processWebhook };