@inkeep/agents-api 0.0.0-dev-20260212083055 → 0.0.0-dev-20260212085218

package/dist/middleware/manageAuth.d.ts

@@ -1,5 +1,5 @@
 import { BaseExecutionContext } from "@inkeep/agents-core";
-import * as hono7 from "hono";
+import * as hono1 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: () => hono7.MiddlewareHandler<{
+declare const manageApiKeyAuth: () => hono1.MiddlewareHandler<{
   Variables: {
     executionContext: BaseExecutionContext;
     userId?: string;

package/dist/middleware/manageAuth.js

@@ -1,6 +1,6 @@
 import { env } from "../env.js";
 import runDbClient_default from "../data/db/runDbClient.js";
-import { getLogger, isInternalServiceToken, validateAndGetApiKey, verifyInternalServiceAuthHeader } from "@inkeep/agents-core";
+import { getLogger, isInternalServiceToken, isSlackUserToken, validateAndGetApiKey, verifyInternalServiceAuthHeader, verifySlackUserToken } from "@inkeep/agents-core";
 import { createMiddleware } from "hono/factory";
 import { HTTPException } from "hono/http-exception";
 
@@ -58,6 +58,21 @@ const manageApiKeyAuth = () => createMiddleware(async (c, next) => {
 		await next();
 		return;
 	}
+	if (isSlackUserToken(token)) {
+		const result = await verifySlackUserToken(token);
+		if (!result.valid || !result.payload) throw new HTTPException(401, { message: result.error || "Invalid Slack user token" });
+		logger.info({
+			inkeepUserId: result.payload.sub,
+			tenantId: result.payload.tenantId,
+			slackTeamId: result.payload.slack.teamId,
+			slackUserId: result.payload.slack.userId
+		}, "Slack user JWT authenticated successfully");
+		c.set("userId", result.payload.sub);
+		if (result.payload.slack.email) c.set("userEmail", result.payload.slack.email);
+		c.set("tenantId", result.payload.tenantId);
+		await next();
+		return;
+	}
 	if (isInternalServiceToken(token)) {
 		const result = await verifyInternalServiceAuthHeader(authHeader);
 		if (!result.valid || !result.payload) throw new HTTPException(401, { message: result.error || "Invalid internal service token" });

package/dist/middleware/projectAccess.d.ts

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

package/dist/middleware/requirePermission.d.ts

@@ -1,5 +1,5 @@
 import { ManageAppVariables } from "../types/app.js";
-import * as hono1 from "hono";
+import * as hono6 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) => hono1.MiddlewareHandler<Env$1, string, {}, Response>;
+}>(permissions: Permission) => hono6.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 hono11 from "hono";
+import * as hono8 from "hono";
 
 //#region src/middleware/runAuth.d.ts
-declare const runApiKeyAuth: () => hono11.MiddlewareHandler<{
+declare const runApiKeyAuth: () => hono8.MiddlewareHandler<{
   Variables: {
     executionContext: BaseExecutionContext;
   };
@@ -11,7 +11,7 @@ declare const runApiKeyAuth: () => hono11.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) => hono11.MiddlewareHandler<{
+declare const runApiKeyAuthExcept: (skipRouteCheck: (path: string) => boolean) => hono8.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: () => hono11.MiddlewareHandler<{
+declare const runOptionalAuth: () => hono8.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 { canUseProjectStrict, validateAndGetApiKey, validateTargetAgent, verifyServiceToken, verifyTempToken } from "@inkeep/agents-core";
+import { canUseProjectStrict, isSlackUserToken, validateAndGetApiKey, validateTargetAgent, verifyServiceToken, verifySlackUserToken, verifyTempToken } from "@inkeep/agents-core";
 import { createMiddleware } from "hono/factory";
 import { HTTPException } from "hono/http-exception";
 
@@ -125,6 +125,73 @@ async function tryApiKeyAuth(apiKey) {
 	};
 }
 /**
+* Authenticate using a Slack user JWT token (for Slack work app delegation)
+*/
+async function trySlackUserJwtAuth(token, reqData) {
+	if (!isSlackUserToken(token)) return { authResult: null };
+	const result = await verifySlackUserToken(token);
+	if (!result.valid || !result.payload) {
+		logger.warn({ error: result.error }, "Invalid Slack user JWT token");
+		return {
+			authResult: null,
+			failureMessage: `Invalid Slack user token: ${result.error || "Invalid token"}`
+		};
+	}
+	const payload = result.payload;
+	if (!reqData.projectId || !reqData.agentId) {
+		logger.warn({
+			hasProjectId: !!reqData.projectId,
+			hasAgentId: !!reqData.agentId
+		}, "Slack user JWT requires x-inkeep-project-id and x-inkeep-agent-id headers");
+		return {
+			authResult: null,
+			failureMessage: "Slack user token requires x-inkeep-project-id and x-inkeep-agent-id headers"
+		};
+	}
+	try {
+		if (!await canUseProjectStrict({
+			userId: payload.sub,
+			projectId: reqData.projectId
+		})) {
+			logger.warn({
+				userId: payload.sub,
+				tenantId: payload.tenantId,
+				projectId: reqData.projectId
+			}, "Slack user JWT: user does not have access to requested project");
+			return {
+				authResult: null,
+				failureMessage: "Access denied: insufficient permissions for the requested project"
+			};
+		}
+	} catch (error) {
+		logger.error({
+			error,
+			userId: payload.sub,
+			projectId: reqData.projectId
+		}, "SpiceDB permission check failed for Slack JWT");
+		throw new HTTPException(503, { message: "Authorization service temporarily unavailable" });
+	}
+	logger.info({
+		inkeepUserId: payload.sub,
+		tenantId: payload.tenantId,
+		slackTeamId: payload.slack.teamId,
+		slackUserId: payload.slack.userId,
+		projectId: reqData.projectId,
+		agentId: reqData.agentId
+	}, "Slack user JWT token authenticated successfully");
+	return { authResult: {
+		apiKey: "slack-user-jwt",
+		tenantId: payload.tenantId,
+		projectId: reqData.projectId,
+		agentId: reqData.agentId,
+		apiKeyId: "slack-user-token",
+		metadata: { initiatedBy: {
+			type: "user",
+			id: payload.sub
+		} }
+	} };
+}
+/**
 * Authenticate using a team agent JWT token (for intra-tenant delegation)
 */
 async function tryTeamAgentAuth(token, expectedSubAgentId) {
@@ -210,6 +277,9 @@ async function authenticateRequest(reqData) {
 	if (jwtResult) return { authResult: jwtResult };
 	const bypassResult = tryBypassAuth(apiKey, reqData);
 	if (bypassResult) return { authResult: bypassResult };
+	const slackAttempt = await trySlackUserJwtAuth(apiKey, reqData);
+	if (slackAttempt.authResult) return { authResult: slackAttempt.authResult };
+	if (slackAttempt.failureMessage) return slackAttempt;
 	const apiKeyResult = await tryApiKeyAuth(apiKey);
 	if (apiKeyResult) return { authResult: apiKeyResult };
 	const teamAttempt = await tryTeamAgentAuth(apiKey, subAgentId);

package/dist/middleware/sessionAuth.d.ts

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

package/dist/middleware/tenantAccess.d.ts

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

package/dist/middleware/tracing.d.ts

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

package/dist/middleware/workAppsAuth.d.ts

@@ -0,0 +1,7 @@
+import { Context, Next } from "hono";
+
+//#region src/middleware/workAppsAuth.d.ts
+
+declare const workAppsAuth: (c: Context, next: Next) => Promise<void | Response>;
+//#endregion
+export { workAppsAuth };

package/dist/middleware/workAppsAuth.js

@@ -0,0 +1,52 @@
+import { env } from "../env.js";
+import { sessionAuth } from "./sessionAuth.js";
+import { manageApiKeyAuth } from "./manageAuth.js";
+import { createApiError } from "@inkeep/agents-core";
+
+//#region src/middleware/workAppsAuth.ts
+/**
+* Work Apps Authentication Middleware
+*
+* Shared session/API key auth for protected work app routes (Slack, GitHub, etc.).
+* Most work app routes are unauthenticated (events, commands, webhooks),
+* but workspace management and user endpoints require session auth.
+*
+* Auth flow:
+* 1. Test environment → bypass
+* 2. Dev localhost → bypass with dev-user context
+* 3. Bearer token → manageApiKeyAuth
+* 4. Session cookie → sessionAuth
+*/
+const isTestEnvironment = () => env.ENVIRONMENT === "test";
+const workAppsAuth = async (c, next) => {
+	if (isTestEnvironment()) {
+		await next();
+		return;
+	}
+	if (env.ENVIRONMENT === "development") {
+		const origin = c.req.header("Origin");
+		if (origin) try {
+			const originUrl = new URL(origin);
+			if (originUrl.hostname === "localhost" || originUrl.hostname === "127.0.0.1") {
+				c.set("userId", "dev-user");
+				c.set("tenantId", "default");
+				c.set("tenantRole", "owner");
+				await next();
+				return;
+			}
+		} catch {}
+	}
+	if (c.req.header("Authorization")?.startsWith("Bearer ")) return manageApiKeyAuth()(c, next);
+	await sessionAuth()(c, async () => {
+		const session = c.get("session");
+		if (!session?.activeOrganizationId) throw createApiError({
+			code: "forbidden",
+			message: "No active organization selected. Please select an organization first."
+		});
+		c.set("tenantId", session.activeOrganizationId);
+		await next();
+	});
+};
+
+//#endregion
+export { workAppsAuth };

package/dist/openapi.d.ts

@@ -8,6 +8,7 @@ declare const TagToDescription: {
   Agents: string;
   'Artifact Components': string;
   Branches: string;
+  Channels: string;
   CLI: string;
   Chat: string;
   'Context Configs': string;
@@ -28,13 +29,17 @@ declare const TagToDescription: {
   Projects: string;
   Refs: string;
   Skills: string;
+  Slack: string;
   SubAgents: string;
   'Third-Party MCP Servers': string;
   Tools: string;
   Triggers: string;
   'User Project Memberships': string;
+  Users: string;
   Webhooks: string;
+  'Work Apps': string;
   Workflows: string;
+  Workspaces: string;
 };
 declare function setupOpenAPIRoutes<E extends Env = Env>(app: OpenAPIHono<E>): void;
 //#endregion

package/dist/openapi.js

@@ -7,6 +7,7 @@ const TagToDescription = {
 	Agents: "Operations for managing agents",
 	"Artifact Components": "Operations for managing artifact components",
 	Branches: "Operations for managing branches",
+	Channels: "Operations for managing Slack channels",
 	CLI: "CLI authentication endpoints",
 	Chat: "Chat completions endpoints",
 	"Context Configs": "Operations for managing context configurations",
@@ -27,13 +28,17 @@ const TagToDescription = {
 	Projects: "Operations for managing projects",
 	Refs: "Operations for the resolved ref (branch name, tag name, or commit hash)",
 	Skills: "Reusable instruction blocks that can be attached to multiple sub-agents and ordered for priority",
+	Slack: "Slack App integration endpoints",
 	SubAgents: "Operations for managing sub agents",
 	"Third-Party MCP Servers": "Operations for managing third-party MCP servers",
 	Tools: "Operations for managing MCP tools",
 	Triggers: "Operations for managing triggers",
 	"User Project Memberships": "Operations for managing user project memberships",
+	Users: "Operations for managing users",
 	Webhooks: "Webhook endpoints",
-	Workflows: "Workflow trigger endpoints"
+	"Work Apps": "Work app integrations (Slack, Teams, etc.)",
+	Workflows: "Workflow trigger endpoints",
+	Workspaces: "Operations for managing Slack workspaces"
 };
 function setupOpenAPIRoutes(app) {
 	app.get("/openapi.json", (c) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-api",
-  "version": "0.0.0-dev-20260212083055",
+  "version": "0.0.0-dev-20260212085218",
   "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.0.0-dev-20260212083055",
-    "@inkeep/agents-manage-mcp": "^0.0.0-dev-20260212083055",
-    "@inkeep/agents-mcp": "^0.0.0-dev-20260212083055",
-    "@inkeep/agents-work-apps": "^0.0.0-dev-20260212083055"
+    "@inkeep/agents-core": "^0.0.0-dev-20260212085218",
+    "@inkeep/agents-manage-mcp": "^0.0.0-dev-20260212085218",
+    "@inkeep/agents-mcp": "^0.0.0-dev-20260212085218",
+    "@inkeep/agents-work-apps": "^0.0.0-dev-20260212085218"
   },
   "peerDependencies": {
     "@hono/zod-openapi": "^1.1.5",