@inkeep/agents-work-apps 0.50.1 → 0.50.4

package/dist/slack/services/events/app-mention.js

@@ -1,11 +1,11 @@
 import { env } from "../../../env.js";
 import { getLogger } from "../../../logger.js";
 import { findWorkspaceConnectionByTeamId } from "../nango.js";
+import { resolveEffectiveAgent } from "../agent-resolution.js";
 import { SlackStrings } from "../../i18n/strings.js";
 import { getSlackChannelInfo, getSlackClient, getSlackUserInfo, postMessageInThread } from "../client.js";
-import { checkIfBotThread, classifyError, findCachedUserMapping, formatChannelContext, generateSlackConversationId, getThreadContext, getUserFriendlyErrorMessage, resolveChannelAgentConfig, timedOp } from "./utils.js";
+import { checkIfBotThread, classifyError, findCachedUserMapping, formatChannelContext, generateSlackConversationId, getThreadContext, getUserFriendlyErrorMessage, timedOp } from "./utils.js";
 import { SLACK_SPAN_KEYS, SLACK_SPAN_NAMES, setSpanWithError, tracer } from "../../tracer.js";
-import { getBotTokenForTeam } from "../workspace-tokens.js";
 import { streamAgentResponse } from "./streaming.js";
 import { signSlackUserToken } from "@inkeep/agents-core";
 
@@ -60,19 +60,18 @@ async function handleAppMention(params) {
 			label: "workspace connection lookup",
 			context: { teamId }
 		});
-		const botToken = workspaceConnection?.botToken || getBotTokenForTeam(teamId) || env.SLACK_BOT_TOKEN;
-		if (!botToken) {
+		if (!workspaceConnection?.botToken) {
 			logger.error({ teamId }, "No bot token available — cannot respond to @mention");
 			span.end();
 			return;
 		}
-		const tenantId = workspaceConnection?.tenantId;
+		const { botToken, tenantId } = workspaceConnection;
 		if (!tenantId) {
 			logger.error({ teamId }, "Workspace connection has no tenantId — workspace may need reinstall");
 			await getSlackClient(botToken).chat.postEphemeral({
 				channel,
 				user: slackUserId,
-				text: "⚠️ This workspace is not properly configured. Please reinstall the Slack app from the Inkeep dashboard."
+				text: "This workspace is not properly configured. Please reinstall the Slack app from the Inkeep dashboard."
 			}).catch((e) => logger.warn({
 				error: e,
 				channel
@@ -88,7 +87,11 @@ async function handleAppMention(params) {
 		const hasQuery = Boolean(text && text.trim().length > 0);
 		let thinkingMessageTs;
 		try {
-			const { result: [agentConfig, existingLink] } = await timedOp(Promise.all([resolveChannelAgentConfig(teamId, channel, workspaceConnection), findCachedUserMapping(tenantId, slackUserId, teamId)]), {
+			const { result: [agentConfig, existingLink] } = await timedOp(Promise.all([resolveEffectiveAgent({
+				tenantId,
+				teamId,
+				channelId: channel
+			}), findCachedUserMapping(tenantId, slackUserId, teamId)]), {
 				label: "agent config / user mapping lookup",
 				context: {
 					teamId,
@@ -104,13 +107,15 @@ async function handleAppMention(params) {
 					channel,
 					user: slackUserId,
 					thread_ts: isInThread ? threadTs : void 0,
-					text: `⚙️ No agents configured for this workspace.\n\n👉 *<${dashboardUrl}|Set up agents in the dashboard>*`
+					text: `No agents configured for this workspace. *<${dashboardUrl}|Set up agents in the dashboard>*`
 				});
 				span.end();
 				return;
 			}
 			span.setAttribute(SLACK_SPAN_KEYS.AGENT_ID, agentConfig.agentId);
 			span.setAttribute(SLACK_SPAN_KEYS.PROJECT_ID, agentConfig.projectId);
+			span.setAttribute(SLACK_SPAN_KEYS.AUTHORIZED, agentConfig.grantAccessToMembers);
+			span.setAttribute(SLACK_SPAN_KEYS.AUTH_SOURCE, agentConfig.source);
 			const agentDisplayName = agentConfig.agentName || agentConfig.agentId;
 			if (!existingLink) {
 				logger.info({
@@ -122,11 +127,7 @@ async function handleAppMention(params) {
 					channel,
 					user: slackUserId,
 					thread_ts: isInThread ? threadTs : void 0,
-					text: `🔗 *Link your account to use @Inkeep*
-
-Run \`/inkeep link\` to connect your Slack and Inkeep accounts.
-
-This workspace uses: *${agentDisplayName}*`
+					text: "*Link your account to use @Inkeep*\n\nRun `/inkeep link` to connect your Slack and Inkeep accounts."
 				});
 				span.end();
 				return;
@@ -162,12 +163,7 @@ This workspace uses: *${agentDisplayName}*`
 						channel,
 						user: slackUserId,
 						thread_ts: threadTs,
-						text: `💬 *Continue the conversation*
-
-Just type your follow-up — no need to mention me in this thread.
-Or use \`@Inkeep <prompt>\` to run a new prompt.
-
-_Using: ${agentDisplayName}_`
+						text: "*Continue the conversation*\n\nType your follow-up directly in this thread — no need to mention me.\nOr use `@Inkeep <prompt>` to start a new prompt."
 					});
 					span.end();
 					return;
@@ -191,7 +187,11 @@ _Using: ${agentDisplayName}_`
 					inkeepUserId: existingLink.inkeepUserId,
 					tenantId,
 					slackTeamId: teamId,
-					slackUserId
+					slackUserId,
+					slackAuthorized: agentConfig?.grantAccessToMembers ?? false,
+					slackAuthSource: agentConfig?.source === "none" ? void 0 : agentConfig?.source,
+					slackChannelId: channel,
+					slackAuthorizedProjectId: agentConfig?.projectId
 				});
 				thinkingMessageTs = (await slackClient.chat.postMessage({
 					channel,
@@ -265,7 +265,11 @@ Respond naturally as if you're joining the conversation to help.`;
 				inkeepUserId: existingLink.inkeepUserId,
 				tenantId,
 				slackTeamId: teamId,
-				slackUserId
+				slackUserId,
+				slackAuthorized: agentConfig?.grantAccessToMembers ?? false,
+				slackAuthSource: agentConfig?.source === "none" ? void 0 : agentConfig?.source,
+				slackChannelId: channel,
+				slackAuthorizedProjectId: agentConfig?.projectId
 			});
 			thinkingMessageTs = (await slackClient.chat.postMessage({
 				channel,

package/dist/slack/services/events/index.d.ts

@@ -1,6 +1,6 @@
 import { InlineSelectorMetadata, handleAppMention } from "./app-mention.js";
 import { handleMessageShortcut, handleOpenAgentSelectorModal, handleOpenFollowUpModal } from "./block-actions.js";
 import { handleFollowUpSubmission, handleModalSubmission } from "./modal-submission.js";
-import { SlackErrorType, checkIfBotThread, classifyError, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, sendResponseUrlMessage } from "./utils.js";
+import { SlackErrorType, checkIfBotThread, classifyError, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, sendResponseUrlMessage } from "./utils.js";
 import { StreamResult, streamAgentResponse } from "./streaming.js";
-export { type InlineSelectorMetadata, SlackErrorType, type StreamResult, checkIfBotThread, classifyError, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, handleAppMention, handleFollowUpSubmission, handleMessageShortcut, handleModalSubmission, handleOpenAgentSelectorModal, handleOpenFollowUpModal, markdownToMrkdwn, sendResponseUrlMessage, streamAgentResponse };
+export { type InlineSelectorMetadata, SlackErrorType, type StreamResult, checkIfBotThread, classifyError, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, handleAppMention, handleFollowUpSubmission, handleMessageShortcut, handleModalSubmission, handleOpenAgentSelectorModal, handleOpenFollowUpModal, markdownToMrkdwn, sendResponseUrlMessage, streamAgentResponse };

package/dist/slack/services/events/index.js

@@ -1,7 +1,7 @@
-import { SlackErrorType, checkIfBotThread, classifyError, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, sendResponseUrlMessage } from "./utils.js";
+import { SlackErrorType, checkIfBotThread, classifyError, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, sendResponseUrlMessage } from "./utils.js";
 import { streamAgentResponse } from "./streaming.js";
 import { handleAppMention } from "./app-mention.js";
 import { handleMessageShortcut, handleOpenAgentSelectorModal, handleOpenFollowUpModal } from "./block-actions.js";
 import { handleFollowUpSubmission, handleModalSubmission } from "./modal-submission.js";
 
-export { SlackErrorType, checkIfBotThread, classifyError, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, handleAppMention, handleFollowUpSubmission, handleMessageShortcut, handleModalSubmission, handleOpenAgentSelectorModal, handleOpenFollowUpModal, markdownToMrkdwn, sendResponseUrlMessage, streamAgentResponse };
+export { SlackErrorType, checkIfBotThread, classifyError, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, handleAppMention, handleFollowUpSubmission, handleMessageShortcut, handleModalSubmission, handleOpenAgentSelectorModal, handleOpenFollowUpModal, markdownToMrkdwn, sendResponseUrlMessage, streamAgentResponse };

package/dist/slack/services/events/modal-submission.js

@@ -4,9 +4,9 @@ import { findWorkspaceConnectionByTeamId } from "../nango.js";
 import { SlackStrings } from "../../i18n/strings.js";
 import { buildConversationResponseBlocks } from "../blocks/index.js";
 import { getSlackClient } from "../client.js";
-import { classifyError, findCachedUserMapping, generateSlackConversationId, getThreadContext, getUserFriendlyErrorMessage, markdownToMrkdwn, sendResponseUrlMessage } from "./utils.js";
+import { classifyError, extractApiErrorMessage, findCachedUserMapping, generateSlackConversationId, getThreadContext, getUserFriendlyErrorMessage, markdownToMrkdwn, sendResponseUrlMessage } from "./utils.js";
 import { SLACK_SPAN_KEYS, SLACK_SPAN_NAMES, setSpanWithError, tracer } from "../../tracer.js";
-import { signSlackUserToken } from "@inkeep/agents-core";
+import { getInProcessFetch, signSlackUserToken } from "@inkeep/agents-core";
 
 //#region src/slack/services/events/modal-submission.ts
 /**
@@ -29,7 +29,7 @@ async function handleModalSubmission(view) {
 			span.setAttribute(SLACK_SPAN_KEYS.USER_ID, metadata.slackUserId || "");
 			span.setAttribute(SLACK_SPAN_KEYS.TENANT_ID, metadata.tenantId || "");
 			const values = view.state?.values || {};
-			const agentSelectValue = values.agent_select_block?.agent_select;
+			const agentSelectValue = Object.values(values).map((block) => block.agent_select).find(Boolean);
 			const questionValue = values.question_block?.question_input;
 			const includeContextValue = values.context_block?.include_context_checkbox;
 			const question = questionValue?.value || "";
@@ -54,6 +54,7 @@ async function handleModalSubmission(view) {
 			}
 			span.setAttribute(SLACK_SPAN_KEYS.AGENT_ID, agentId);
 			span.setAttribute(SLACK_SPAN_KEYS.PROJECT_ID, projectId);
+			span.setAttribute(SLACK_SPAN_KEYS.AUTHORIZED, false);
 			const tenantId = metadata.tenantId;
 			const [workspaceConnection, existingLink] = await Promise.all([findWorkspaceConnectionByTeamId(metadata.teamId), findCachedUserMapping(tenantId, metadata.slackUserId, metadata.teamId)]);
 			if (!workspaceConnection?.botToken) {
@@ -90,7 +91,7 @@ async function handleModalSubmission(view) {
 				await slackClient.chat.postEphemeral({
 					channel: metadata.channel,
 					user: metadata.slackUserId,
-					text: "🔗 You need to link your account first. Use `/inkeep link` to get started."
+					text: "Link your account first. Run `/inkeep link` to connect."
 				});
 				span.end();
 				return;
@@ -99,7 +100,8 @@ async function handleModalSubmission(view) {
 				inkeepUserId: existingLink.inkeepUserId,
 				tenantId,
 				slackTeamId: metadata.teamId,
-				slackUserId: metadata.slackUserId
+				slackUserId: metadata.slackUserId,
+				slackAuthorized: false
 			});
 			const conversationId = generateSlackConversationId({
 				teamId: metadata.teamId,
@@ -200,6 +202,7 @@ async function handleFollowUpSubmission(view) {
 			span.setAttribute(SLACK_SPAN_KEYS.AGENT_ID, agentId);
 			span.setAttribute(SLACK_SPAN_KEYS.PROJECT_ID, projectId);
 			span.setAttribute(SLACK_SPAN_KEYS.CONVERSATION_ID, conversationId);
+			span.setAttribute(SLACK_SPAN_KEYS.AUTHORIZED, false);
 			const [workspaceConnection, existingLink] = await Promise.all([findWorkspaceConnectionByTeamId(teamId), findCachedUserMapping(tenantId, slackUserId, teamId)]);
 			if (!workspaceConnection?.botToken) {
 				logger.error({ teamId }, "No bot token for follow-up submission");
@@ -215,7 +218,7 @@ async function handleFollowUpSubmission(view) {
 				await slackClient.chat.postEphemeral({
 					channel,
 					user: slackUserId,
-					text: "🔗 You need to link your account first. Use `/inkeep link` to get started."
+					text: "Link your account first. Run `/inkeep link` to connect."
 				});
 				span.end();
 				return;
@@ -224,7 +227,8 @@ async function handleFollowUpSubmission(view) {
 				inkeepUserId: existingLink.inkeepUserId,
 				tenantId,
 				slackTeamId: teamId,
-				slackUserId
+				slackUserId,
+				slackAuthorized: false
 			});
 			const apiBaseUrl = env.INKEEP_AGENTS_API_URL || "http://localhost:3002";
 			await slackClient.chat.postEphemeral({
@@ -305,7 +309,7 @@ async function callAgentApi(params) {
 		const timeout = setTimeout(() => controller.abort(), 3e4);
 		let response;
 		try {
-			response = await fetch(`${apiBaseUrl}/run/api/chat`, {
+			response = await getInProcessFetch()(`${apiBaseUrl}/run/api/chat`, {
 				method: "POST",
 				headers: {
 					"Content-Type": "application/json",
@@ -348,11 +352,15 @@ async function callAgentApi(params) {
 				isError: false
 			};
 		}
-		const errorText = getUserFriendlyErrorMessage(classifyError(null, response.status), agentId);
+		const errorBody = await response.text().catch(() => "");
+		const apiMessage = extractApiErrorMessage(errorBody);
+		const errorType = classifyError(null, response.status);
+		const errorText = apiMessage ? `*Error.* ${apiMessage}` : getUserFriendlyErrorMessage(errorType, agentId);
 		logger.warn({
 			status: response.status,
 			statusText: response.statusText,
-			agentId
+			agentId,
+			errorBody
 		}, "Agent API returned error");
 		apiSpan.end();
 		return {

package/dist/slack/services/events/streaming.js

@@ -1,8 +1,9 @@
 import { env } from "../../../env.js";
 import { getLogger } from "../../../logger.js";
 import { createContextBlock } from "../blocks/index.js";
-import { SlackErrorType, classifyError, getUserFriendlyErrorMessage } from "./utils.js";
+import { SlackErrorType, classifyError, extractApiErrorMessage, getUserFriendlyErrorMessage } from "./utils.js";
 import { SLACK_SPAN_KEYS, SLACK_SPAN_NAMES, setSpanWithError, tracer } from "../../tracer.js";
+import { getInProcessFetch } from "@inkeep/agents-core";
 
 //#region src/slack/services/events/streaming.ts
 /**
@@ -12,8 +13,8 @@ import { SLACK_SPAN_KEYS, SLACK_SPAN_NAMES, setSpanWithError, tracer } from "../
 * Streams responses incrementally to Slack using chatStream API.
 */
 const logger = getLogger("slack-streaming");
-const STREAM_TIMEOUT_MS = 12e4;
-const CHATSTREAM_OP_TIMEOUT_MS = 1e4;
+const STREAM_TIMEOUT_MS = 6e5;
+const CHATSTREAM_OP_TIMEOUT_MS = 2e4;
 /** Shorter timeout for best-effort cleanup in error paths to bound total error handling time. */
 const CLEANUP_TIMEOUT_MS = 3e3;
 /**
@@ -59,7 +60,7 @@ async function streamAgentResponse(params) {
 		}, STREAM_TIMEOUT_MS);
 		let response;
 		try {
-			response = await fetch(`${apiUrl.replace(/\/$/, "")}/run/api/chat`, {
+			response = await getInProcessFetch()(`${apiUrl.replace(/\/$/, "")}/run/api/chat`, {
 				method: "POST",
 				headers: {
 					"Content-Type": "application/json",
@@ -128,8 +129,9 @@ async function streamAgentResponse(params) {
 				status: response.status,
 				errorBody
 			}, "Agent streaming request failed");
+			const apiMessage = extractApiErrorMessage(errorBody);
 			const errorType = classifyError(null, response.status);
-			const errorMessage = getUserFriendlyErrorMessage(errorType, agentName);
+			const errorMessage = apiMessage ? `*Error.* ${apiMessage}` : getUserFriendlyErrorMessage(errorType, agentName);
 			await slackClient.chat.postMessage({
 				channel,
 				thread_ts: threadTs,

package/dist/slack/services/events/utils.d.ts

@@ -50,6 +50,7 @@ declare function classifyError(error: unknown, httpStatus?: number): SlackErrorT
 /**
  * Get a user-friendly error message based on error type
  */
+declare function extractApiErrorMessage(responseBody: string): string | null;
 declare function getUserFriendlyErrorMessage(errorType: SlackErrorType, agentName?: string): string;
 type ProjectOption = {
   id: string;
@@ -157,4 +158,4 @@ declare function formatChannelContext(channelInfo: {
   name?: string;
 } | null): string;
 //#endregion
-export { ProjectOption, SlackErrorType, checkIfBotThread, classifyError, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, formatChannelContext, formatChannelLabel, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, resolveChannelAgentConfig, sendResponseUrlMessage, timedOp };
+export { ProjectOption, SlackErrorType, checkIfBotThread, classifyError, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, formatChannelContext, formatChannelLabel, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, resolveChannelAgentConfig, sendResponseUrlMessage, timedOp };

package/dist/slack/services/events/utils.js

@@ -2,7 +2,7 @@ import { env } from "../../../env.js";
 import { getLogger } from "../../../logger.js";
 import runDbClient_default from "../../../db/runDbClient.js";
 import { findWorkspaceConnectionByTeamId } from "../nango.js";
-import { InternalServices, findWorkAppSlackChannelAgentConfig, findWorkAppSlackUserMapping, generateInternalServiceToken } from "@inkeep/agents-core";
+import { InternalServices, findWorkAppSlackChannelAgentConfig, findWorkAppSlackUserMapping, generateInternalServiceToken, getInProcessFetch } from "@inkeep/agents-core";
 
 //#region src/slack/services/events/utils.ts
 /**
@@ -94,14 +94,21 @@ function classifyError(error, httpStatus) {
 /**
 * Get a user-friendly error message based on error type
 */
+function extractApiErrorMessage(responseBody) {
+	try {
+		const parsed = JSON.parse(responseBody);
+		if (typeof parsed.message === "string" && parsed.message.length > 0) return parsed.message;
+	} catch {}
+	return null;
+}
 function getUserFriendlyErrorMessage(errorType, agentName) {
 	const agent = agentName || "The agent";
 	switch (errorType) {
-		case SlackErrorType.TIMEOUT: return `⏱️ *Request timed out*\n\n${agent} took too long to respond. This can happen with complex queries.\n\n*Try:*\n• Simplifying your question\n• Breaking it into smaller parts\n• Trying again in a moment`;
-		case SlackErrorType.RATE_LIMIT: return `⚠️ *Too many requests*\n\nYou've hit the rate limit. Please wait a moment before trying again.\n\n*Tip:* Space out your requests to avoid this.`;
-		case SlackErrorType.AUTH_ERROR: return `🔐 *Authentication issue*\n\nThere was a problem with your account connection.\n\n*Try:*\n• Running \`/inkeep link\` to re-link your account\n• Contacting your workspace admin if the issue persists`;
-		case SlackErrorType.API_ERROR: return `❌ *Something went wrong*\n\n${agent} encountered an error processing your request.\n\n*Try:*\n• Rephrasing your question\n• Trying again in a moment\n• Using \`/inkeep help\` for more options`;
-		default: return `❌ *Unexpected error*\n\nSomething went wrong while processing your request.\n\n*Try:*\n• Trying again in a moment\n• Using \`/inkeep help\` for more options`;
+		case SlackErrorType.TIMEOUT: return `*Request timed out.* ${agent} took too long to respond. Try again with a simpler question.`;
+		case SlackErrorType.RATE_LIMIT: return "*Rate limited.* Wait a moment and try again.";
+		case SlackErrorType.AUTH_ERROR: return "*Authentication error.* Run `/inkeep link` to reconnect your account.";
+		case SlackErrorType.API_ERROR: return `*Something went wrong.* ${agent} encountered an error. Try again in a moment.`;
+		default: return "*Unexpected error.* Something went wrong. Try again in a moment.";
 	}
 }
 const INTERNAL_FETCH_TIMEOUT_MS = 1e4;
@@ -114,7 +121,7 @@ async function fetchProjectsForTenant(tenantId) {
 	const controller = new AbortController();
 	const timeout = setTimeout(() => controller.abort(), INTERNAL_FETCH_TIMEOUT_MS);
 	try {
-		const response = await fetch(`${apiUrl}/manage/tenants/${tenantId}/projects?limit=50`, {
+		const response = await getInProcessFetch()(`${apiUrl}/manage/tenants/${tenantId}/projects?limit=50`, {
 			method: "GET",
 			headers: {
 				Authorization: `Bearer ${token}`,
@@ -160,7 +167,7 @@ async function fetchAgentsForProject(tenantId, projectId) {
 	const controller = new AbortController();
 	const timeout = setTimeout(() => controller.abort(), INTERNAL_FETCH_TIMEOUT_MS);
 	try {
-		const response = await fetch(`${apiUrl}/manage/tenants/${tenantId}/projects/${projectId}/agents?limit=50`, {
+		const response = await getInProcessFetch()(`${apiUrl}/manage/tenants/${tenantId}/projects/${projectId}/agents?limit=50`, {
 			method: "GET",
 			headers: {
 				Authorization: `Bearer ${token}`,
@@ -402,4 +409,4 @@ function formatChannelContext(channelInfo) {
 }
 
 //#endregion
-export { SlackErrorType, checkIfBotThread, classifyError, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, formatChannelContext, formatChannelLabel, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, resolveChannelAgentConfig, sendResponseUrlMessage, timedOp };
+export { SlackErrorType, checkIfBotThread, classifyError, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, formatChannelContext, formatChannelLabel, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, resolveChannelAgentConfig, sendResponseUrlMessage, timedOp };

package/dist/slack/services/index.d.ts

@@ -8,9 +8,9 @@ import { InlineSelectorMetadata, handleAppMention } from "./events/app-mention.j
 import { handleMessageShortcut, handleOpenAgentSelectorModal, handleOpenFollowUpModal } from "./events/block-actions.js";
 import { handleFollowUpSubmission, handleModalSubmission } from "./events/modal-submission.js";
 import { AgentOption, BuildAgentSelectorModalParams, BuildMessageShortcutModalParams, FollowUpModalMetadata, ModalMetadata, buildAgentSelectorModal, buildFollowUpModal, buildMessageShortcutModal } from "./modals.js";
-import { SlackErrorType, checkIfBotThread, classifyError, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, sendResponseUrlMessage } from "./events/utils.js";
+import { SlackErrorType, checkIfBotThread, classifyError, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, sendResponseUrlMessage } from "./events/utils.js";
 import { StreamResult, streamAgentResponse } from "./events/streaming.js";
 import "./events/index.js";
 import { parseSlackCommandBody, parseSlackEventBody, verifySlackRequest } from "./security.js";
 import { getBotTokenForTeam, setBotTokenForTeam } from "./workspace-tokens.js";
-export { AgentConfigSources, AgentOption, AgentResolutionParams, BuildAgentSelectorModalParams, BuildMessageShortcutModalParams, ContextBlockParams, DefaultAgentConfig, FollowUpButtonParams, FollowUpModalMetadata, InlineSelectorMetadata, ModalMetadata, ResolvedAgentConfig, SlackCommandPayload, SlackCommandResponse, SlackErrorType, SlackWorkspaceConnection, StreamResult, WorkspaceInstallData, buildAgentSelectorModal, buildConversationResponseBlocks, buildFollowUpButton, buildFollowUpModal, buildMessageShortcutModal, checkIfBotThread, checkUserIsChannelMember, classifyError, clearWorkspaceConnectionCache, computeWorkspaceConnectionId, createAlreadyLinkedMessage, createConnectSession, createContextBlock, createErrorMessage, createJwtLinkMessage, createNotLinkedMessage, createStatusMessage, createUnlinkSuccessMessage, createUpdatedHelpMessage, deleteWorkspaceInstallation, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, findWorkspaceConnectionByTeamId, generateSlackConversationId, getAgentConfigSources, getBotTokenForTeam, getChannelAgentConfig, getConnectionAccessToken, getSlackChannelInfo, getSlackChannels, getSlackClient, getSlackIntegrationId, getSlackNango, getSlackTeamInfo, getSlackUserInfo, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, getWorkspaceDefaultAgentFromNango, handleAgentPickerCommand, handleAppMention, handleCommand, handleFollowUpSubmission, handleHelpCommand, handleLinkCommand, handleMessageShortcut, handleModalSubmission, handleOpenAgentSelectorModal, handleOpenFollowUpModal, handleQuestionCommand, handleStatusCommand, handleUnlinkCommand, listWorkspaceInstallations, markdownToMrkdwn, parseSlackCommandBody, parseSlackEventBody, postMessage, postMessageInThread, resolveEffectiveAgent, revokeSlackToken, sendResponseUrlMessage, setBotTokenForTeam, setWorkspaceDefaultAgent, storeWorkspaceInstallation, streamAgentResponse, updateConnectionMetadata, verifySlackRequest };
+export { AgentConfigSources, AgentOption, AgentResolutionParams, BuildAgentSelectorModalParams, BuildMessageShortcutModalParams, ContextBlockParams, DefaultAgentConfig, FollowUpButtonParams, FollowUpModalMetadata, InlineSelectorMetadata, ModalMetadata, ResolvedAgentConfig, SlackCommandPayload, SlackCommandResponse, SlackErrorType, SlackWorkspaceConnection, StreamResult, WorkspaceInstallData, buildAgentSelectorModal, buildConversationResponseBlocks, buildFollowUpButton, buildFollowUpModal, buildMessageShortcutModal, checkIfBotThread, checkUserIsChannelMember, classifyError, clearWorkspaceConnectionCache, computeWorkspaceConnectionId, createAlreadyLinkedMessage, createConnectSession, createContextBlock, createErrorMessage, createJwtLinkMessage, createNotLinkedMessage, createStatusMessage, createUnlinkSuccessMessage, createUpdatedHelpMessage, deleteWorkspaceInstallation, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, findWorkspaceConnectionByTeamId, generateSlackConversationId, getAgentConfigSources, getBotTokenForTeam, getChannelAgentConfig, getConnectionAccessToken, getSlackChannelInfo, getSlackChannels, getSlackClient, getSlackIntegrationId, getSlackNango, getSlackTeamInfo, getSlackUserInfo, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, getWorkspaceDefaultAgentFromNango, handleAgentPickerCommand, handleAppMention, handleCommand, handleFollowUpSubmission, handleHelpCommand, handleLinkCommand, handleMessageShortcut, handleModalSubmission, handleOpenAgentSelectorModal, handleOpenFollowUpModal, handleQuestionCommand, handleStatusCommand, handleUnlinkCommand, listWorkspaceInstallations, markdownToMrkdwn, parseSlackCommandBody, parseSlackEventBody, postMessage, postMessageInThread, resolveEffectiveAgent, revokeSlackToken, sendResponseUrlMessage, setBotTokenForTeam, setWorkspaceDefaultAgent, storeWorkspaceInstallation, streamAgentResponse, updateConnectionMetadata, verifySlackRequest };

package/dist/slack/services/index.js

@@ -2,15 +2,15 @@ import { clearWorkspaceConnectionCache, computeWorkspaceConnectionId, createConn
 import { getAgentConfigSources, resolveEffectiveAgent } from "./agent-resolution.js";
 import { buildConversationResponseBlocks, buildFollowUpButton, createAlreadyLinkedMessage, createContextBlock, createErrorMessage, createJwtLinkMessage, createNotLinkedMessage, createStatusMessage, createUnlinkSuccessMessage, createUpdatedHelpMessage } from "./blocks/index.js";
 import { checkUserIsChannelMember, getSlackChannelInfo, getSlackChannels, getSlackClient, getSlackTeamInfo, getSlackUserInfo, postMessage, postMessageInThread, revokeSlackToken } from "./client.js";
-import { SlackErrorType, checkIfBotThread, classifyError, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, sendResponseUrlMessage } from "./events/utils.js";
+import { SlackErrorType, checkIfBotThread, classifyError, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, sendResponseUrlMessage } from "./events/utils.js";
 import { buildAgentSelectorModal, buildFollowUpModal, buildMessageShortcutModal } from "./modals.js";
 import { handleAgentPickerCommand, handleCommand, handleHelpCommand, handleLinkCommand, handleQuestionCommand, handleStatusCommand, handleUnlinkCommand } from "./commands/index.js";
-import { getBotTokenForTeam, setBotTokenForTeam } from "./workspace-tokens.js";
 import { streamAgentResponse } from "./events/streaming.js";
 import { handleAppMention } from "./events/app-mention.js";
 import { handleMessageShortcut, handleOpenAgentSelectorModal, handleOpenFollowUpModal } from "./events/block-actions.js";
 import { handleFollowUpSubmission, handleModalSubmission } from "./events/modal-submission.js";
 import "./events/index.js";
 import { parseSlackCommandBody, parseSlackEventBody, verifySlackRequest } from "./security.js";
+import { getBotTokenForTeam, setBotTokenForTeam } from "./workspace-tokens.js";
 
-export { SlackErrorType, buildAgentSelectorModal, buildConversationResponseBlocks, buildFollowUpButton, buildFollowUpModal, buildMessageShortcutModal, checkIfBotThread, checkUserIsChannelMember, classifyError, clearWorkspaceConnectionCache, computeWorkspaceConnectionId, createAlreadyLinkedMessage, createConnectSession, createContextBlock, createErrorMessage, createJwtLinkMessage, createNotLinkedMessage, createStatusMessage, createUnlinkSuccessMessage, createUpdatedHelpMessage, deleteWorkspaceInstallation, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, findWorkspaceConnectionByTeamId, generateSlackConversationId, getAgentConfigSources, getBotTokenForTeam, getChannelAgentConfig, getConnectionAccessToken, getSlackChannelInfo, getSlackChannels, getSlackClient, getSlackIntegrationId, getSlackNango, getSlackTeamInfo, getSlackUserInfo, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, getWorkspaceDefaultAgentFromNango, handleAgentPickerCommand, handleAppMention, handleCommand, handleFollowUpSubmission, handleHelpCommand, handleLinkCommand, handleMessageShortcut, handleModalSubmission, handleOpenAgentSelectorModal, handleOpenFollowUpModal, handleQuestionCommand, handleStatusCommand, handleUnlinkCommand, listWorkspaceInstallations, markdownToMrkdwn, parseSlackCommandBody, parseSlackEventBody, postMessage, postMessageInThread, resolveEffectiveAgent, revokeSlackToken, sendResponseUrlMessage, setBotTokenForTeam, setWorkspaceDefaultAgent, storeWorkspaceInstallation, streamAgentResponse, updateConnectionMetadata, verifySlackRequest };
+export { SlackErrorType, buildAgentSelectorModal, buildConversationResponseBlocks, buildFollowUpButton, buildFollowUpModal, buildMessageShortcutModal, checkIfBotThread, checkUserIsChannelMember, classifyError, clearWorkspaceConnectionCache, computeWorkspaceConnectionId, createAlreadyLinkedMessage, createConnectSession, createContextBlock, createErrorMessage, createJwtLinkMessage, createNotLinkedMessage, createStatusMessage, createUnlinkSuccessMessage, createUpdatedHelpMessage, deleteWorkspaceInstallation, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, findWorkspaceConnectionByTeamId, generateSlackConversationId, getAgentConfigSources, getBotTokenForTeam, getChannelAgentConfig, getConnectionAccessToken, getSlackChannelInfo, getSlackChannels, getSlackClient, getSlackIntegrationId, getSlackNango, getSlackTeamInfo, getSlackUserInfo, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, getWorkspaceDefaultAgentFromNango, handleAgentPickerCommand, handleAppMention, handleCommand, handleFollowUpSubmission, handleHelpCommand, handleLinkCommand, handleMessageShortcut, handleModalSubmission, handleOpenAgentSelectorModal, handleOpenFollowUpModal, handleQuestionCommand, handleStatusCommand, handleUnlinkCommand, listWorkspaceInstallations, markdownToMrkdwn, parseSlackCommandBody, parseSlackEventBody, postMessage, postMessageInThread, resolveEffectiveAgent, revokeSlackToken, sendResponseUrlMessage, setBotTokenForTeam, setWorkspaceDefaultAgent, storeWorkspaceInstallation, streamAgentResponse, updateConnectionMetadata, verifySlackRequest };

package/dist/slack/services/modals.js

@@ -66,7 +66,7 @@ function buildAgentSelectorModal(params) {
 		}
 	}, {
 		type: "input",
-		block_id: "agent_select_block",
+		block_id: selectedProjectId ? `agent_select_block_${selectedProjectId}` : "agent_select_block",
 		element: {
 			type: "static_select",
 			action_id: "agent_select",
@@ -137,7 +137,7 @@ function buildAgentSelectorModal(params) {
 		type: "context",
 		elements: [{
 			type: "mrkdwn",
-			text: `⚙️ <${manageUiBaseUrl}${dashboardUrl}|Open Dashboard>`
+			text: `<${manageUiBaseUrl}${dashboardUrl}|Open Dashboard>`
 		}]
 	});
 	return {
@@ -283,7 +283,7 @@ function buildMessageShortcutModal(params) {
 		},
 		{
 			type: "input",
-			block_id: "agent_select_block",
+			block_id: selectedProjectId ? `agent_select_block_${selectedProjectId}` : "agent_select_block",
 			element: {
 				type: "static_select",
 				action_id: "agent_select",
@@ -325,7 +325,7 @@ function buildMessageShortcutModal(params) {
 		type: "context",
 		elements: [{
 			type: "mrkdwn",
-			text: `⚙️ <${manageUiBaseUrl}${dashboardUrl}|Open Dashboard>`
+			text: `<${manageUiBaseUrl}${dashboardUrl}|Open Dashboard>`
 		}]
 	});
 	return {

package/dist/slack/services/nango.d.ts

@@ -18,6 +18,7 @@ interface DefaultAgentConfig {
   agentName?: string;
   projectId: string;
   projectName?: string;
+  grantAccessToMembers?: boolean;
 }
 interface SlackWorkspaceConnection {
   connectionId: string;
@@ -30,6 +31,8 @@ interface SlackWorkspaceConnection {
 /**
  * Find a workspace connection by Slack team ID.
  * Uses PostgreSQL first (O(1)) with in-memory caching, then falls back to Nango.
+ * In development mode with .slack-dev.json present, returns a local connection
+ * built from the dev config file instead of hitting Nango.
  *
  * Performance: This function is called on every @mention and command.
  * The PostgreSQL-first approach with caching provides O(1) lookups.

package/dist/slack/services/nango.js

@@ -1,6 +1,7 @@
 import { env } from "../../env.js";
 import { getLogger } from "../../logger.js";
 import runDbClient_default from "../../db/runDbClient.js";
+import { getDevDefaultAgent, isSlackDevMode, loadSlackDevConfig, saveSlackDevConfig } from "./dev-config.js";
 import { findWorkAppSlackWorkspaceBySlackTeamId } from "@inkeep/agents-core";
 import { Nango } from "@nangohq/node";
 
@@ -78,6 +79,10 @@ function getSlackIntegrationId() {
 	return env.NANGO_SLACK_INTEGRATION_ID || "slack-agent";
 }
 async function createConnectSession(params) {
+	if (isSlackDevMode()) {
+		logger.debug({}, "Skipping Nango connect session in dev mode");
+		return null;
+	}
 	try {
 		const nango = getSlackNango();
 		const integrationId = getSlackIntegrationId();
@@ -105,6 +110,7 @@ async function createConnectSession(params) {
 	}
 }
 async function getConnectionAccessToken(connectionId) {
+	if (isSlackDevMode()) return loadSlackDevConfig()?.botToken ?? null;
 	try {
 		const nango = getSlackNango();
 		const integrationId = getSlackIntegrationId();
@@ -117,9 +123,27 @@ async function getConnectionAccessToken(connectionId) {
 		return null;
 	}
 }
+function buildDevWorkspaceConnection(devConfig, teamId) {
+	const connection = {
+		connectionId: `dev:${teamId}`,
+		teamId,
+		teamName: devConfig.teamName || "dev",
+		botToken: devConfig.botToken,
+		tenantId: "default",
+		defaultAgent: getDevDefaultAgent(devConfig) ?? void 0
+	};
+	evictWorkspaceCache();
+	workspaceConnectionCache.set(teamId, {
+		connection,
+		expiresAt: Date.now() + CACHE_TTL_MS
+	});
+	return connection;
+}
 /**
 * Find a workspace connection by Slack team ID.
 * Uses PostgreSQL first (O(1)) with in-memory caching, then falls back to Nango.
+* In development mode with .slack-dev.json present, returns a local connection
+* built from the dev config file instead of hitting Nango.
 *
 * Performance: This function is called on every @mention and command.
 * The PostgreSQL-first approach with caching provides O(1) lookups.
@@ -130,6 +154,15 @@ async function findWorkspaceConnectionByTeamId(teamId) {
 		logger.debug({ teamId }, "Workspace connection cache hit");
 		return cached.connection;
 	}
+	if (isSlackDevMode()) {
+		const devConfig = loadSlackDevConfig();
+		if (devConfig) {
+			logger.debug({ teamId }, "Using .slack-dev.json for workspace connection");
+			return buildDevWorkspaceConnection(devConfig, teamId);
+		}
+		logger.debug({ teamId }, "No .slack-dev.json found returning null");
+		return null;
+	}
 	try {
 		const dbWorkspace = await findWorkAppSlackWorkspaceBySlackTeamId(runDbClient_default)(teamId);
 		if (dbWorkspace?.nangoConnectionId) {
@@ -155,7 +188,7 @@ async function findWorkspaceConnectionByTeamId(teamId) {
 			}
 		}
 		logger.debug({ teamId }, "PostgreSQL lookup failed, falling back to Nango iteration");
-		return findWorkspaceConnectionByTeamIdFromNango(teamId);
+		return await findWorkspaceConnectionByTeamIdFromNango(teamId);
 	} catch (error) {
 		logger.error({
 			error,
@@ -165,6 +198,7 @@ async function findWorkspaceConnectionByTeamId(teamId) {
 	}
 }
 async function getWorkspaceDefaultAgentFromNangoByConnectionId(connectionId) {
+	if (isSlackDevMode()) return getDevDefaultAgent(loadSlackDevConfig());
 	try {
 		const nango = getSlackNango();
 		const integrationId = getSlackIntegrationId();
@@ -234,10 +268,23 @@ function clearWorkspaceConnectionCache(teamId) {
 	else workspaceConnectionCache.clear();
 }
 async function updateConnectionMetadata(connectionId, metadata) {
+	if (isSlackDevMode()) {
+		const devConfig = loadSlackDevConfig();
+		if (!devConfig) return false;
+		devConfig.metadata = {
+			...devConfig.metadata,
+			...metadata
+		};
+		return saveSlackDevConfig(devConfig);
+	}
 	try {
 		const nango = getSlackNango();
 		const integrationId = getSlackIntegrationId();
-		await nango.updateMetadata(integrationId, connectionId, metadata);
+		const lastUpdatedAt = (/* @__PURE__ */ new Date()).toISOString();
+		await nango.updateMetadata(integrationId, connectionId, {
+			...metadata,
+			last_updated_at: lastUpdatedAt
+		});
 		return true;
 	} catch (error) {
 		logger.error({
@@ -248,6 +295,17 @@ async function updateConnectionMetadata(connectionId, metadata) {
 	}
 }
 async function setWorkspaceDefaultAgent(teamId, defaultAgent) {
+	if (isSlackDevMode()) {
+		const devConfig = loadSlackDevConfig();
+		if (!devConfig) return false;
+		devConfig.metadata = {
+			...devConfig.metadata,
+			default_agent: defaultAgent ? JSON.stringify(defaultAgent) : ""
+		};
+		const saved = saveSlackDevConfig(devConfig);
+		if (saved) clearWorkspaceConnectionCache(teamId);
+		return saved;
+	}
 	try {
 		const workspace = await findWorkspaceConnectionByTeamId(teamId);
 		if (!workspace) {
@@ -266,6 +324,7 @@ async function setWorkspaceDefaultAgent(teamId, defaultAgent) {
 	}
 }
 async function getWorkspaceDefaultAgentFromNango(teamId) {
+	if (isSlackDevMode()) return getDevDefaultAgent(loadSlackDevConfig());
 	try {
 		return (await findWorkspaceConnectionByTeamId(teamId))?.defaultAgent || null;
 	} catch (error) {
@@ -294,6 +353,13 @@ async function storeWorkspaceInstallation(data) {
 		teamId: data.teamId,
 		enterpriseId: data.enterpriseId
 	});
+	if (isSlackDevMode()) {
+		logger.debug({ connectionId }, "Skipping Nango store in dev mode");
+		return {
+			connectionId: `dev:${data.teamId}`,
+			success: true
+		};
+	}
 	try {
 		const integrationId = getSlackIntegrationId();
 		const secretKey = env.NANGO_SLACK_SECRET_KEY || env.NANGO_SECRET_KEY;
@@ -406,6 +472,18 @@ async function storeWorkspaceInstallation(data) {
 * List all workspace installations from Nango.
 */
 async function listWorkspaceInstallations() {
+	if (isSlackDevMode()) {
+		const devConfig = loadSlackDevConfig();
+		if (!devConfig) return [];
+		return [{
+			connectionId: `dev:${devConfig.teamId}`,
+			teamId: devConfig.teamId,
+			teamName: devConfig.teamName,
+			botToken: devConfig.botToken,
+			tenantId: "default",
+			defaultAgent: getDevDefaultAgent(devConfig) ?? void 0
+		}];
+	}
 	try {
 		const nango = getSlackNango();
 		const integrationId = getSlackIntegrationId();
@@ -445,6 +523,10 @@ async function listWorkspaceInstallations() {
 * Delete a workspace installation from Nango.
 */
 async function deleteWorkspaceInstallation(connectionId) {
+	if (isSlackDevMode()) {
+		logger.debug({ connectionId }, "Skipping Nango delete in dev mode");
+		return true;
+	}
 	try {
 		const nango = getSlackNango();
 		const integrationId = getSlackIntegrationId();

package/dist/slack/socket-mode.d.ts

@@ -0,0 +1,4 @@
+//#region src/slack/socket-mode.d.ts
+declare function startSocketMode(appToken: string): Promise<void>;
+//#endregion
+export { startSocketMode };