@inkeep/agents-api 0.44.0 → 0.45.0

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

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

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

@@ -140,7 +140,8 @@ function createDelegateToAgentTool({ delegateConfig, callingAgentId, executionCo
 			if (activeSpan) activeSpan.setAttributes({
 				[SPAN_KEYS.DELEGATION_FROM_SUB_AGENT_ID]: callingAgentId,
 				[SPAN_KEYS.DELEGATION_TO_SUB_AGENT_ID]: delegateConfig.config.id ?? "unknown",
-				[SPAN_KEYS.DELEGATION_ID]: delegationId
+				[SPAN_KEYS.DELEGATION_ID]: delegationId,
+				[SPAN_KEYS.DELEGATION_TYPE]: delegateConfig.type
 			});
 			if (metadata.streamRequestId) agentSessionManager.recordEvent(metadata.streamRequestId, "delegation_sent", callingAgentId, {
 				delegationId,

package/dist/env.js

@@ -46,11 +46,11 @@ const envSchema = z.object({
 	ANTHROPIC_API_KEY: z.string().describe("Anthropic API key for Claude models (required for agent execution). Get from https://console.anthropic.com/"),
 	OPENAI_API_KEY: z.string().optional().describe("OpenAI API key for GPT models. Get from https://platform.openai.com/"),
 	GOOGLE_GENERATIVE_AI_API_KEY: z.string().optional().describe("Google Generative AI API key for Gemini models"),
-	GITHUB_APP_ID: z.string().optional(),
-	GITHUB_APP_PRIVATE_KEY: z.string().optional(),
-	GITHUB_WEBHOOK_SECRET: z.string().optional(),
-	GITHUB_STATE_SIGNING_SECRET: z.string().min(32, "GITHUB_STATE_SIGNING_SECRET must be at least 32 characters").optional(),
-	GITHUB_APP_NAME: z.string().optional(),
+	GITHUB_APP_ID: z.string().optional().describe("GitHub App ID for GitHub integration"),
+	GITHUB_APP_PRIVATE_KEY: z.string().optional().describe("GitHub App private key for authentication"),
+	GITHUB_WEBHOOK_SECRET: z.string().optional().describe("Secret for validating GitHub webhook payloads"),
+	GITHUB_STATE_SIGNING_SECRET: z.string().min(32, "GITHUB_STATE_SIGNING_SECRET must be at least 32 characters").optional().describe("Secret for signing GitHub OAuth state (minimum 32 characters)"),
+	GITHUB_APP_NAME: z.string().optional().describe("Name of the GitHub App"),
 	GITHUB_MCP_API_KEY: z.string().optional().describe("API key for the GitHub MCP"),
 	WORKFLOW_TARGET_WORLD: z.string().optional().describe("Target world for workflow execution"),
 	WORKFLOW_POSTGRES_URL: z.string().optional().describe("PostgreSQL connection URL for workflow job queue"),

package/dist/middleware/evalsAuth.d.ts

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

package/dist/middleware/manageAuth.d.ts

@@ -1,5 +1,5 @@
 import { BaseExecutionContext } from "@inkeep/agents-core";
-import * as hono3 from "hono";
+import * as hono4 from "hono";
 import { createAuth } from "@inkeep/agents-core/auth";
 
 //#region src/middleware/manageAuth.d.ts
@@ -12,7 +12,7 @@ import { createAuth } from "@inkeep/agents-core/auth";
  * 3. Database API key
  * 4. Internal service token
  */
-declare const manageApiKeyAuth: () => hono3.MiddlewareHandler<{
+declare const manageApiKeyAuth: () => hono4.MiddlewareHandler<{
   Variables: {
     executionContext: BaseExecutionContext;
     userId?: string;

package/dist/middleware/projectAccess.d.ts

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

package/dist/middleware/projectConfig.d.ts

@@ -1,11 +1,11 @@
 import { BaseExecutionContext, ResolvedRef } from "@inkeep/agents-core";
-import * as hono5 from "hono";
+import * as hono6 from "hono";
 
 //#region src/middleware/projectConfig.d.ts
 /**
  * Middleware that fetches the full project definition from the Management API
  */
-declare const projectConfigMiddleware: hono5.MiddlewareHandler<{
+declare const projectConfigMiddleware: hono6.MiddlewareHandler<{
   Variables: {
     executionContext: BaseExecutionContext;
     resolvedRef: ResolvedRef;
@@ -15,7 +15,7 @@ declare const projectConfigMiddleware: hono5.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) => hono5.MiddlewareHandler<{
+declare const projectConfigMiddlewareExcept: (skipRouteCheck: (path: string) => boolean) => hono6.MiddlewareHandler<{
   Variables: {
     executionContext: BaseExecutionContext;
     resolvedRef: ResolvedRef;

package/dist/middleware/requirePermission.d.ts

@@ -1,5 +1,5 @@
 import { ManageAppVariables } from "../types/app.js";
-import * as hono8 from "hono";
+import * as hono9 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) => hono8.MiddlewareHandler<Env$1, string, {}, Response>;
+}>(permissions: Permission) => hono9.MiddlewareHandler<Env$1, string, {}, Response>;
 //#endregion
 export { requirePermission };

package/dist/middleware/runAuth.d.ts

@@ -1,8 +1,8 @@
 import { BaseExecutionContext } from "@inkeep/agents-core";
-import * as hono9 from "hono";
+import * as hono10 from "hono";
 
 //#region src/middleware/runAuth.d.ts
-declare const runApiKeyAuth: () => hono9.MiddlewareHandler<{
+declare const runApiKeyAuth: () => hono10.MiddlewareHandler<{
   Variables: {
     executionContext: BaseExecutionContext;
   };
@@ -11,7 +11,7 @@ declare const runApiKeyAuth: () => hono9.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) => hono9.MiddlewareHandler<{
+declare const runApiKeyAuthExcept: (skipRouteCheck: (path: string) => boolean) => hono10.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: () => hono9.MiddlewareHandler<{
+declare const runOptionalAuth: () => hono10.MiddlewareHandler<{
   Variables: {
     executionContext?: BaseExecutionContext;
   };

package/dist/middleware/runAuth.js

@@ -2,7 +2,7 @@ import { getLogger as getLogger$1 } from "../logger.js";
 import { env } from "../env.js";
 import runDbClient_default from "../data/db/runDbClient.js";
 import { createBaseExecutionContext } from "../types/runExecutionContext.js";
-import { validateAndGetApiKey, validateTargetAgent, verifyServiceToken, verifyTempToken } from "@inkeep/agents-core";
+import { canUseProjectStrict, validateAndGetApiKey, validateTargetAgent, verifyServiceToken, verifyTempToken } from "@inkeep/agents-core";
 import { createMiddleware } from "hono/factory";
 import { HTTPException } from "hono/http-exception";
 
@@ -51,21 +51,56 @@ function buildExecutionContext(authResult, reqData) {
 }
 /**
 * Attempts to authenticate using a JWT temporary token
+*
+* Throws HTTPException(403) if the JWT is valid but the user lacks permission.
+* Returns null if the token is not a temp JWT (allowing fallback to other auth methods).
 */
 async function tryTempJwtAuth(apiKey) {
 	if (!apiKey.startsWith("eyJ") || !env.INKEEP_AGENTS_TEMP_JWT_PUBLIC_KEY) return null;
 	try {
 		const payload = await verifyTempToken(Buffer.from(env.INKEEP_AGENTS_TEMP_JWT_PUBLIC_KEY, "base64").toString("utf-8"), apiKey);
-		logger.info({}, "JWT temp token authenticated successfully");
+		const userId = payload.sub;
+		const projectId = payload.projectId;
+		const agentId = payload.agentId;
+		if (!projectId || !agentId) {
+			logger.warn({ userId }, "Missing projectId or agentId in JWT");
+			throw new HTTPException(400, { message: "Invalid token: missing projectId or agentId" });
+		}
+		let canUse;
+		try {
+			canUse = await canUseProjectStrict({
+				userId,
+				projectId
+			});
+		} catch (error) {
+			logger.error({
+				error,
+				userId,
+				projectId
+			}, "SpiceDB permission check failed");
+			throw new HTTPException(503, { message: "Authorization service temporarily unavailable" });
+		}
+		if (!canUse) {
+			logger.warn({
+				userId,
+				projectId
+			}, "User does not have use permission on project");
+			throw new HTTPException(403, { message: "Access denied: insufficient permissions" });
+		}
+		logger.info({
+			projectId,
+			agentId
+		}, "JWT temp token authenticated successfully");
 		return {
 			apiKey,
 			tenantId: payload.tenantId,
-			projectId: payload.projectId,
-			agentId: payload.agentId,
+			projectId,
+			agentId,
 			apiKeyId: "temp-jwt",
 			metadata: { initiatedBy: payload.initiatedBy }
 		};
 	} catch (error) {
+		if (error instanceof HTTPException) throw error;
 		logger.debug({ error }, "JWT verification failed");
 		return null;
 	}

package/dist/middleware/sessionAuth.d.ts

@@ -1,4 +1,4 @@
-import * as hono12 from "hono";
+import * as hono13 from "hono";
 
 //#region src/middleware/sessionAuth.d.ts
 
@@ -7,11 +7,11 @@ import * as hono12 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: () => hono12.MiddlewareHandler<any, string, {}, Response>;
+declare const sessionAuth: () => hono13.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: () => hono12.MiddlewareHandler<any, string, {}, Response>;
+declare const sessionContext: () => hono13.MiddlewareHandler<any, string, {}, Response>;
 //#endregion
 export { sessionAuth, sessionContext };

package/dist/middleware/tenantAccess.d.ts

@@ -1,4 +1,4 @@
-import * as hono14 from "hono";
+import * as hono15 from "hono";
 
 //#region src/middleware/tenantAccess.d.ts
 
@@ -11,7 +11,7 @@ import * as hono14 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: () => hono14.MiddlewareHandler<{
+declare const requireTenantAccess: () => hono15.MiddlewareHandler<{
   Variables: {
     userId: string;
     tenantId: string;

package/dist/middleware/tracing.d.ts

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

package/dist/openapi.d.ts

@@ -20,7 +20,6 @@ declare const TagToDescription: {
   'Function Tools': string;
   Functions: string;
   GitHub: string;
-  Invitations: string;
   MCP: string;
   'MCP Catalog': string;
   OAuth: string;
@@ -32,7 +31,6 @@ declare const TagToDescription: {
   'Third-Party MCP Servers': string;
   Tools: string;
   Triggers: string;
-  'User Organizations': string;
   'User Project Memberships': string;
   Webhooks: string;
   Workflows: string;

package/dist/openapi.js

@@ -19,7 +19,6 @@ const TagToDescription = {
 	"Function Tools": "Operations for managing function tools",
 	Functions: "Operations for managing functions",
 	GitHub: "GitHub App integration endpoints",
-	Invitations: "Operations for managing invitations",
 	MCP: "MCP (Model Context Protocol) endpoints",
 	"MCP Catalog": "Operations for MCP catalog",
 	OAuth: "OAuth authentication endpoints",
@@ -31,7 +30,6 @@ const TagToDescription = {
 	"Third-Party MCP Servers": "Operations for managing third-party MCP servers",
 	Tools: "Operations for managing MCP tools",
 	Triggers: "Operations for managing triggers",
-	"User Organizations": "Operations for managing user organizations",
 	"User Project Memberships": "Operations for managing user project memberships",
 	Webhooks: "Webhook endpoints",
 	Workflows: "Workflow trigger endpoints"

package/package.json

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