@inkeep/agents-api 0.0.0-dev-20260128035734 → 0.0.0-dev-20260128045356

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

@@ -41,15 +41,15 @@
     }
   },
   "workflows": {
-    "src/domains/evals/workflow/functions/evaluateConversation.ts": {
-      "_evaluateConversationWorkflow": {
-        "workflowId": "workflow//src/domains/evals/workflow/functions/evaluateConversation.ts//_evaluateConversationWorkflow"
-      }
-    },
     "src/domains/evals/workflow/functions/runDatasetItem.ts": {
       "_runDatasetItemWorkflow": {
         "workflowId": "workflow//src/domains/evals/workflow/functions/runDatasetItem.ts//_runDatasetItemWorkflow"
       }
+    },
+    "src/domains/evals/workflow/functions/evaluateConversation.ts": {
+      "_evaluateConversationWorkflow": {
+        "workflowId": "workflow//src/domains/evals/workflow/functions/evaluateConversation.ts//_evaluateConversationWorkflow"
+      }
     }
   }
 }

package/dist/createApp.d.ts

@@ -1,10 +1,10 @@
 import { AppConfig } from "./types/app.js";
 import "./types/index.js";
 import { Hono } from "hono";
-import * as hono_types14 from "hono/types";
+import * as hono_types0 from "hono/types";
 
 //#region src/createApp.d.ts
 declare const isWebhookRoute: (path: string) => boolean;
-declare function createAgentsHono(config: AppConfig): Hono<hono_types14.BlankEnv, hono_types14.BlankSchema, "/">;
+declare function createAgentsHono(config: AppConfig): Hono<hono_types0.BlankEnv, hono_types0.BlankSchema, "/">;
 //#endregion
 export { createAgentsHono, isWebhookRoute };

package/dist/createApp.js

@@ -20,6 +20,7 @@ import { evalApiKeyAuth } from "./middleware/evalsAuth.js";
 import { projectConfigMiddleware, projectConfigMiddlewareExcept } from "./middleware/projectConfig.js";
 import { executionBaggageMiddleware } from "./middleware/tracing.js";
 import { setupOpenAPIRoutes } from "./openapi.js";
+import { healthChecksHandler } from "./routes/healthChecks.js";
 import { OpenAPIHono, createRoute, z } from "@hono/zod-openapi";
 import { Hono } from "hono";
 import { cors } from "hono/cors";
@@ -90,16 +91,7 @@ function createAgentsHono(config) {
 	}));
 	app.onError(errorHandler);
 	app.use("*", sessionContext());
-	app.openapi(createRoute({
-		method: "get",
-		path: "/health",
-		operationId: "health",
-		summary: "Health check",
-		description: "Check if the management service is healthy",
-		responses: { 204: { description: "Service is healthy" } }
-	}), (c) => {
-		return c.body(null, 204);
-	});
+	app.route("/", healthChecksHandler);
 	app.openapi(createRoute({
 		method: "get",
 		path: "/api/workflow/process",

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

@@ -1,7 +1,7 @@
 import { OpenAPIHono } from "@hono/zod-openapi";
-import * as hono9 from "hono";
+import * as hono14 from "hono";
 
 //#region src/domains/evals/routes/datasetTriggers.d.ts
-declare const app: OpenAPIHono<hono9.Env, {}, "/">;
+declare const app: OpenAPIHono<hono14.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_types9 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_types9.BlankEnv, hono_types9.BlankSchema, "/">;
 //#endregion
 export { workflowRoutes };

package/dist/domains/github/index.d.ts

@@ -3,10 +3,10 @@ import { GenerateInstallationAccessTokenResult, GenerateTokenError, GenerateToke
 import { GetJwkResult, JwksError, JwksResult, clearJwksCache, getJwkForToken, getJwksCacheStatus } from "./jwks.js";
 import { GitHubOidcClaims, ValidateOidcTokenResult, ValidateTokenError, ValidateTokenResult, validateOidcToken } from "./oidcToken.js";
 import { Hono } from "hono";
-import * as hono_types3 from "hono/types";
+import * as hono_types5 from "hono/types";
 
 //#region src/domains/github/index.d.ts
-declare function createGithubRoutes(): Hono<hono_types3.BlankEnv, hono_types3.BlankSchema, "/">;
-declare const githubRoutes: Hono<hono_types3.BlankEnv, hono_types3.BlankSchema, "/">;
+declare function createGithubRoutes(): Hono<hono_types5.BlankEnv, hono_types5.BlankSchema, "/">;
+declare const githubRoutes: Hono<hono_types5.BlankEnv, hono_types5.BlankSchema, "/">;
 //#endregion
 export { type GenerateInstallationAccessTokenResult, type GenerateTokenError, type GenerateTokenResult, type GetJwkResult, type GitHubAppConfig, type GitHubOidcClaims, type InstallationAccessToken, type InstallationInfo, type JwksError, type JwksResult, type LookupInstallationError, type LookupInstallationForRepoResult, type LookupInstallationResult, type ValidateOidcTokenResult, type ValidateTokenError, type ValidateTokenResult, clearJwksCache, createGithubRoutes, generateInstallationAccessToken, getGitHubAppConfig, getJwkForToken, getJwksCacheStatus, githubRoutes, isGitHubAppConfigured, lookupInstallationForRepo, validateOidcToken };

package/dist/domains/github/routes/tokenExchange.d.ts

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

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

@@ -1,7 +1,7 @@
 import { OpenAPIHono } from "@hono/zod-openapi";
-import * as hono16 from "hono";
+import * as hono17 from "hono";
 
 //#region src/domains/manage/routes/conversations.d.ts
-declare const app: OpenAPIHono<hono16.Env, {}, "/">;
+declare const app: OpenAPIHono<hono17.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 hono16 from "hono";
 
 //#region src/domains/manage/routes/evals/evaluationResults.d.ts
-declare const app: OpenAPIHono<hono18.Env, {}, "/">;
+declare const app: OpenAPIHono<hono16.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_types1 from "hono/types";
+import * as hono_types15 from "hono/types";
 
 //#region src/domains/manage/routes/mcp.d.ts
-declare const app: Hono<hono_types1.BlankEnv, hono_types1.BlankSchema, "/">;
+declare const app: Hono<hono_types15.BlankEnv, hono_types15.BlankSchema, "/">;
 //#endregion
 export { app as default };

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

@@ -1,10 +1,10 @@
 import { ManageAppVariables } from "../../../types/app.js";
 import { Hono } from "hono";
-import * as hono_types11 from "hono/types";
+import * as hono_types17 from "hono/types";
 
 //#region src/domains/manage/routes/signoz.d.ts
 declare const app: Hono<{
   Variables: ManageAppVariables;
-}, hono_types11.BlankSchema, "/">;
+}, hono_types17.BlankSchema, "/">;
 //#endregion
 export { app as default };

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

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

package/dist/domains/run/services/TriggerService.js

@@ -314,6 +314,19 @@ async function dispatchExecution(params) {
 		invocationId,
 		conversationId
 	}, "Trigger invocation created");
+	trace.getTracer("trigger-service").startSpan("trigger.message_received", { attributes: {
+		"tenant.id": tenantId,
+		"project.id": projectId,
+		"agent.id": agentId,
+		"trigger.id": triggerId,
+		"trigger.invocation.id": invocationId,
+		"conversation.id": conversationId,
+		"invocation.type": "trigger",
+		"message.content": userMessageText,
+		"message.timestamp": (/* @__PURE__ */ new Date()).toISOString(),
+		"message.parts": JSON.stringify(messageParts)
+	} }, ROOT_CONTEXT).end();
+	await flushBatchProcessor();
 	const executionPromise = executeAgentAsync({
 		tenantId,
 		projectId,
@@ -365,19 +378,6 @@ async function executeAgentAsync(params) {
 	const tracer = trace.getTracer("trigger-service");
 	const baggage = propagation.createBaggage().setEntry("conversation.id", { value: conversationId }).setEntry("tenant.id", { value: tenantId }).setEntry("project.id", { value: projectId }).setEntry("agent.id", { value: agentId });
 	const ctxWithBaggage = propagation.setBaggage(ROOT_CONTEXT, baggage);
-	tracer.startSpan("trigger.message_received", { attributes: {
-		"tenant.id": tenantId,
-		"project.id": projectId,
-		"agent.id": agentId,
-		"trigger.id": triggerId,
-		"trigger.invocation.id": invocationId,
-		"conversation.id": conversationId,
-		"invocation.type": "trigger",
-		"message.content": userMessage,
-		"message.timestamp": (/* @__PURE__ */ new Date()).toISOString(),
-		"message.parts": JSON.stringify(messageParts)
-	} }, ctxWithBaggage).end();
-	await flushBatchProcessor();
 	return tracer.startActiveSpan("trigger.execute_async", { attributes: {
 		"tenant.id": tenantId,
 		"project.id": projectId,

package/dist/factory.d.ts

@@ -7,7 +7,7 @@ import * as hono0 from "hono";
 import { CredentialStore, ServerConfig } from "@inkeep/agents-core";
 import * as zod0 from "zod";
 import { SSOProviderConfig, UserAuthConfig } from "@inkeep/agents-core/auth";
-import * as hono_types0 from "hono/types";
+import * as hono_types1 from "hono/types";
 import * as better_auth0 from "better-auth";
 import * as better_auth_plugins0 from "better-auth/plugins";
 import * as _better_auth_sso0 from "@better-auth/sso";
@@ -1536,6 +1536,6 @@ declare function createAgentsApp(config?: {
   auth?: UserAuthConfig;
   sandboxConfig?: SandboxConfig;
   skipInitialization?: boolean;
-}): hono0.Hono<hono_types0.BlankEnv, hono_types0.BlankSchema, "/">;
+}): hono0.Hono<hono_types1.BlankEnv, hono_types1.BlankSchema, "/">;
 //#endregion
 export { type SSOProviderConfig, type UserAuthConfig, createAgentsApp, createAgentsAuth, createAgentsHono, createAuth0Provider, createOIDCProvider, initializeDefaultUser };

package/dist/index.d.ts

@@ -8,7 +8,7 @@ import { createAuth0Provider, createOIDCProvider } from "./ssoHelpers.js";
 import { SSOProviderConfig, UserAuthConfig, createAgentsApp } from "./factory.js";
 import { Hono } from "hono";
 import * as zod205 from "zod";
-import * as hono_types16 from "hono/types";
+import * as hono_types3 from "hono/types";
 import * as better_auth78 from "better-auth";
 import * as better_auth_plugins69 from "better-auth/plugins";
 import * as _better_auth_sso10 from "@better-auth/sso";
@@ -1531,6 +1531,6 @@ declare const auth: better_auth78.Auth<{
     }>;
   }];
 }> | null;
-declare const app: Hono<hono_types16.BlankEnv, hono_types16.BlankSchema, "/">;
+declare const app: Hono<hono_types3.BlankEnv, hono_types3.BlankSchema, "/">;
 //#endregion
 export { type AppConfig, type AppVariables, Hono, type NativeSandboxConfig, type SSOProviderConfig, type SandboxConfig, type UserAuthConfig, type VercelSandboxConfig, auth, createAgentsApp, createAgentsHono, createAuth0Provider, createOIDCProvider, app as default, initializeDefaultUser };

package/dist/middleware/evalsAuth.d.ts

@@ -1,4 +1,4 @@
-import * as hono10 from "hono";
+import * as hono0 from "hono";
 import { BaseExecutionContext } from "@inkeep/agents-core";
 
 //#region src/middleware/evalsAuth.d.ts
@@ -7,7 +7,7 @@ import { BaseExecutionContext } from "@inkeep/agents-core";
  * Middleware to authenticate API requests using Bearer token authentication
  * First checks if token matches INKEEP_AGENTS_EVAL_API_BYPASS_SECRET,
  */
-declare const evalApiKeyAuth: () => hono10.MiddlewareHandler<{
+declare const evalApiKeyAuth: () => hono0.MiddlewareHandler<{
   Variables: {
     executionContext: BaseExecutionContext;
   };

package/dist/middleware/manageAuth.d.ts

@@ -1,4 +1,4 @@
-import * as hono11 from "hono";
+import * as hono1 from "hono";
 import { BaseExecutionContext } from "@inkeep/agents-core";
 import { createAuth } from "@inkeep/agents-core/auth";
 
@@ -12,7 +12,7 @@ import { createAuth } from "@inkeep/agents-core/auth";
  * 3. Database API key
  * 4. Internal service token
  */
-declare const manageApiKeyAuth: () => hono11.MiddlewareHandler<{
+declare const manageApiKeyAuth: () => hono1.MiddlewareHandler<{
   Variables: {
     executionContext: BaseExecutionContext;
     userId?: string;

package/dist/middleware/projectAccess.d.ts

@@ -1,5 +1,5 @@
 import { ManageAppVariables } from "../types/app.js";
-import * as hono12 from "hono";
+import * as hono2 from "hono";
 import { ProjectPermissionLevel } from "@inkeep/agents-core";
 
 //#region src/middleware/projectAccess.d.ts
@@ -19,6 +19,6 @@ declare const requireProjectPermission: <Env$1 extends {
   Variables: ManageAppVariables;
 } = {
   Variables: ManageAppVariables;
-}>(permission?: ProjectPermissionLevel) => hono12.MiddlewareHandler<Env$1, string, {}, Response>;
+}>(permission?: ProjectPermissionLevel) => hono2.MiddlewareHandler<Env$1, string, {}, Response>;
 //#endregion
 export { requireProjectPermission };

package/dist/middleware/projectConfig.d.ts

@@ -1,11 +1,11 @@
-import * as hono13 from "hono";
+import * as hono3 from "hono";
 import { BaseExecutionContext, ResolvedRef } from "@inkeep/agents-core";
 
 //#region src/middleware/projectConfig.d.ts
 /**
  * Middleware that fetches the full project definition from the Management API
  */
-declare const projectConfigMiddleware: hono13.MiddlewareHandler<{
+declare const projectConfigMiddleware: hono3.MiddlewareHandler<{
   Variables: {
     executionContext: BaseExecutionContext;
     resolvedRef: ResolvedRef;
@@ -15,7 +15,7 @@ declare const projectConfigMiddleware: hono13.MiddlewareHandler<{
  * Creates a middleware that applies project config fetching except for specified route patterns
  * @param skipRouteCheck - Function that returns true if the route should skip the middleware
  */
-declare const projectConfigMiddlewareExcept: (skipRouteCheck: (path: string) => boolean) => hono13.MiddlewareHandler<{
+declare const projectConfigMiddlewareExcept: (skipRouteCheck: (path: string) => boolean) => hono3.MiddlewareHandler<{
   Variables: {
     executionContext: BaseExecutionContext;
     resolvedRef: ResolvedRef;

package/dist/middleware/requirePermission.d.ts

@@ -1,5 +1,5 @@
 import { ManageAppVariables } from "../types/app.js";
-import * as hono0 from "hono";
+import * as hono5 from "hono";
 
 //#region src/middleware/requirePermission.d.ts
 type Permission = {
@@ -9,6 +9,6 @@ declare const requirePermission: <Env$1 extends {
   Variables: ManageAppVariables;
 } = {
   Variables: ManageAppVariables;
-}>(permissions: Permission) => hono0.MiddlewareHandler<Env$1, string, {}, Response>;
+}>(permissions: Permission) => hono5.MiddlewareHandler<Env$1, string, {}, Response>;
 //#endregion
 export { requirePermission };

package/dist/middleware/runAuth.d.ts

@@ -1,8 +1,8 @@
-import * as hono3 from "hono";
+import * as hono6 from "hono";
 import { BaseExecutionContext } from "@inkeep/agents-core";
 
 //#region src/middleware/runAuth.d.ts
-declare const runApiKeyAuth: () => hono3.MiddlewareHandler<{
+declare const runApiKeyAuth: () => hono6.MiddlewareHandler<{
   Variables: {
     executionContext: BaseExecutionContext;
   };
@@ -11,7 +11,7 @@ declare const runApiKeyAuth: () => hono3.MiddlewareHandler<{
  * Creates a middleware that applies API key authentication except for specified route patterns
  * @param skipRouteCheck - Function that returns true if the route should skip authentication
  */
-declare const runApiKeyAuthExcept: (skipRouteCheck: (path: string) => boolean) => hono3.MiddlewareHandler<{
+declare const runApiKeyAuthExcept: (skipRouteCheck: (path: string) => boolean) => hono6.MiddlewareHandler<{
   Variables: {
     executionContext: BaseExecutionContext;
   };
@@ -20,7 +20,7 @@ declare const runApiKeyAuthExcept: (skipRouteCheck: (path: string) => boolean) =
  * Helper middleware for endpoints that optionally support API key authentication
  * If no auth header is present, it continues without setting the executionContext
  */
-declare const runOptionalAuth: () => hono3.MiddlewareHandler<{
+declare const runOptionalAuth: () => hono6.MiddlewareHandler<{
   Variables: {
     executionContext?: BaseExecutionContext;
   };

package/dist/middleware/sessionAuth.d.ts

@@ -1,4 +1,4 @@
-import * as hono1 from "hono";
+import * as hono9 from "hono";
 
 //#region src/middleware/sessionAuth.d.ts
 
@@ -7,11 +7,11 @@ import * as hono1 from "hono";
  * Requires that a user has already been authenticated via Better Auth session.
  * Used primarily for manage routes that require an active user session.
  */
-declare const sessionAuth: () => hono1.MiddlewareHandler<any, string, {}, Response>;
+declare const sessionAuth: () => hono9.MiddlewareHandler<any, string, {}, Response>;
 /**
  * Global session middleware - sets user and session in context for all routes
  * Used for all routes that require an active user session.
  */
-declare const sessionContext: () => hono1.MiddlewareHandler<any, string, {}, Response>;
+declare const sessionContext: () => hono9.MiddlewareHandler<any, string, {}, Response>;
 //#endregion
 export { sessionAuth, sessionContext };

package/dist/middleware/tenantAccess.d.ts

@@ -1,4 +1,4 @@
-import * as hono6 from "hono";
+import * as hono11 from "hono";
 
 //#region src/middleware/tenantAccess.d.ts
 
@@ -11,7 +11,7 @@ import * as hono6 from "hono";
  * - API key user: Access only to the tenant associated with the API key
  * - Session user: Access based on organization membership
  */
-declare const requireTenantAccess: () => hono6.MiddlewareHandler<{
+declare const requireTenantAccess: () => hono11.MiddlewareHandler<{
   Variables: {
     userId: string;
     tenantId: string;

package/dist/middleware/tracing.d.ts

@@ -1,7 +1,7 @@
-import * as hono7 from "hono";
+import * as hono12 from "hono";
 
 //#region src/middleware/tracing.d.ts
-declare const otelBaggageMiddleware: () => hono7.MiddlewareHandler<any, string, {}, Response>;
-declare const executionBaggageMiddleware: () => hono7.MiddlewareHandler<any, string, {}, Response>;
+declare const otelBaggageMiddleware: () => hono12.MiddlewareHandler<any, string, {}, Response>;
+declare const executionBaggageMiddleware: () => hono12.MiddlewareHandler<any, string, {}, Response>;
 //#endregion
 export { executionBaggageMiddleware, otelBaggageMiddleware };

package/dist/routes/healthChecks.d.ts

@@ -0,0 +1,10 @@
+import { AppVariables } from "../types/app.js";
+import "../types/index.js";
+import { OpenAPIHono } from "@hono/zod-openapi";
+
+//#region src/routes/healthChecks.d.ts
+declare const healthChecksHandler: OpenAPIHono<{
+  Variables: AppVariables;
+}, {}, "/">;
+//#endregion
+export { healthChecksHandler };

package/dist/routes/healthChecks.js

@@ -0,0 +1,75 @@
+import manageDbPool_default from "../data/db/manageDbPool.js";
+import runDbClient_default from "../data/db/runDbClient.js";
+import { checkManageDb, checkRunDb } from "../utils/healthChecks.js";
+import { OpenAPIHono, createRoute, z } from "@hono/zod-openapi";
+
+//#region src/routes/healthChecks.ts
+const healthChecksHandler = new OpenAPIHono();
+healthChecksHandler.openapi(createRoute({
+	method: "get",
+	path: "/health",
+	operationId: "health",
+	tags: ["Health"],
+	summary: "Health check",
+	description: "Check if the management service is healthy",
+	responses: { 204: { description: "Service is healthy" } }
+}), (c) => {
+	return c.body(null, 204);
+});
+const ReadyResponseSchema = z.object({
+	status: z.literal("ok"),
+	manageDb: z.boolean().describe("Whether the manage database is reachable"),
+	runDb: z.boolean().describe("Whether the run database is reachable")
+}).openapi("ReadyResponse");
+const ReadyErrorChecksSchema = z.object({
+	manageDb: z.boolean().describe("Whether the manage database check passed"),
+	runDb: z.boolean().describe("Whether the run database check passed")
+}).openapi("ReadyErrorChecks");
+const ReadyErrorResponseSchema = z.object({
+	type: z.string().describe("A URI reference that identifies the problem type"),
+	title: z.string().describe("A short, human-readable summary of the problem type"),
+	status: z.number().describe("The HTTP status code"),
+	detail: z.string().describe("A human-readable explanation specific to this occurrence"),
+	checks: ReadyErrorChecksSchema
+}).openapi("ReadyErrorResponse");
+healthChecksHandler.openapi(createRoute({
+	method: "get",
+	path: "/ready",
+	operationId: "ready",
+	tags: ["Health"],
+	summary: "Readiness check",
+	description: "Check if the service is ready to serve traffic by verifying database connectivity",
+	responses: {
+		200: {
+			description: "Service is ready - all health checks passed",
+			content: { "application/json": { schema: ReadyResponseSchema } }
+		},
+		503: {
+			description: "Service is not ready - one or more health checks failed",
+			content: { "application/problem+json": { schema: ReadyErrorResponseSchema } }
+		}
+	}
+}), async (c) => {
+	const [manageDbHealthy, runDbHealthy] = await Promise.all([checkManageDb(manageDbPool_default), checkRunDb(runDbClient_default)]);
+	if (manageDbHealthy && runDbHealthy) return c.json({
+		status: "ok",
+		manageDb: true,
+		runDb: true
+	});
+	const failedChecks = [];
+	if (!manageDbHealthy) failedChecks.push("manage database");
+	if (!runDbHealthy) failedChecks.push("run database");
+	return c.json({
+		type: "https://httpstatuses.com/503",
+		title: "Service Unavailable",
+		status: 503,
+		detail: `Health checks failed: ${failedChecks.join(", ")}`,
+		checks: {
+			manageDb: manageDbHealthy,
+			runDb: runDbHealthy
+		}
+	}, 503, { "Content-Type": "application/problem+json" });
+});
+
+//#endregion
+export { healthChecksHandler };

package/dist/utils/healthChecks.d.ts

@@ -0,0 +1,8 @@
+import { AgentsRunDatabaseClient } from "@inkeep/agents-core";
+import { Pool } from "pg";
+
+//#region src/utils/healthChecks.d.ts
+declare function checkManageDb(pool: Pool): Promise<boolean>;
+declare function checkRunDb(client: AgentsRunDatabaseClient): Promise<boolean>;
+//#endregion
+export { checkManageDb, checkRunDb };

package/dist/utils/healthChecks.js

@@ -0,0 +1,38 @@
+//#region src/utils/healthChecks.ts
+const HEALTH_CHECK_TIMEOUT_MS = 5e3;
+async function withTimeout(promise, timeoutMs) {
+	let timeoutId;
+	const timeoutPromise = new Promise((_, reject) => {
+		timeoutId = setTimeout(() => {
+			reject(/* @__PURE__ */ new Error(`Health check timed out after ${timeoutMs}ms`));
+		}, timeoutMs);
+	});
+	try {
+		return await Promise.race([promise, timeoutPromise]);
+	} finally {
+		if (timeoutId !== void 0) clearTimeout(timeoutId);
+	}
+}
+async function checkManageDb(pool) {
+	try {
+		await withTimeout(pool.query("SELECT 1"), HEALTH_CHECK_TIMEOUT_MS);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function checkRunDb(client) {
+	try {
+		if ("$client" in client && client.$client) {
+			const pool = client.$client;
+			await withTimeout(pool.query("SELECT 1"), HEALTH_CHECK_TIMEOUT_MS);
+			return true;
+		}
+		return false;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+export { checkManageDb, checkRunDb };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-api",
-  "version": "0.0.0-dev-20260128035734",
+  "version": "0.0.0-dev-20260128045356",
   "description": "Unified Inkeep Agents API - combines management, runtime, and evaluation capabilities",
   "types": "dist/index.d.ts",
   "exports": {
@@ -66,9 +66,9 @@
     "openid-client": "^6.8.1",
     "pg": "^8.16.3",
     "workflow": "4.0.1-beta.33",
-    "@inkeep/agents-core": "^0.0.0-dev-20260128035734",
-    "@inkeep/agents-mcp": "^0.0.0-dev-20260128035734",
-    "@inkeep/agents-manage-mcp": "^0.0.0-dev-20260128035734"
+    "@inkeep/agents-core": "^0.0.0-dev-20260128045356",
+    "@inkeep/agents-manage-mcp": "^0.0.0-dev-20260128045356",
+    "@inkeep/agents-mcp": "^0.0.0-dev-20260128045356"
   },
   "peerDependencies": {
     "@hono/zod-openapi": "^1.1.5",