@inkeep/agents-work-apps 0.52.0 → 0.53.1

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

@@ -8,10 +8,10 @@ import { AgentOption } from "../modals.js";
  * Called on every @mention and /inkeep command — caching avoids redundant DB queries.
  */
 declare function findCachedUserMapping(tenantId: string, slackUserId: string, teamId: string, clientId?: string): Promise<{
-  slackUserId: string;
+  id: string;
   createdAt: string;
   updatedAt: string;
-  id: string;
+  slackUserId: string;
   tenantId: string;
   clientId: string;
   slackTeamId: string;
@@ -112,6 +112,24 @@ declare function checkIfBotThread(slackClient: {
     }>;
   };
 }, channel: string, threadTs: string): Promise<boolean>;
+interface SlackAttachment {
+  text?: string;
+  fallback?: string;
+  pretext?: string;
+  author_name?: string;
+  author_id?: string;
+  channel_name?: string;
+  channel_id?: string;
+  title?: string;
+  is_msg_unfurl?: boolean;
+  is_share?: boolean;
+  from_url?: string;
+  fields?: Array<{
+    title?: string;
+    value?: string;
+  }>;
+}
+declare function formatAttachments(attachments: SlackAttachment[] | undefined): string;
 interface ThreadContextOptions {
   includeLastMessage?: boolean;
   resolveUserNames?: boolean;
@@ -128,6 +146,7 @@ declare function getThreadContext(slackClient: {
         user?: string;
         text?: string;
         ts?: string;
+        attachments?: SlackAttachment[];
       }>;
     }>;
   };
@@ -137,8 +156,10 @@ declare function getThreadContext(slackClient: {
     }) => Promise<{
       user?: {
         real_name?: string;
-        display_name?: string;
-        name?: string;
+        profile?: {
+          display_name?: string;
+          email?: string;
+        };
       };
     }>;
   };
@@ -158,4 +179,4 @@ declare function formatChannelContext(channelInfo: {
   name?: string;
 } | null): string;
 //#endregion
-export { ProjectOption, SlackErrorType, checkIfBotThread, classifyError, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, formatChannelContext, formatChannelLabel, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, resolveChannelAgentConfig, sendResponseUrlMessage, timedOp };
+export { ProjectOption, SlackAttachment, SlackErrorType, checkIfBotThread, classifyError, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, formatAttachments, formatChannelContext, formatChannelLabel, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, resolveChannelAgentConfig, sendResponseUrlMessage, timedOp };

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

@@ -34,17 +34,19 @@ async function findCachedUserMapping(tenantId, slackUserId, teamId, clientId = "
 	const cached = userMappingCache.get(cacheKey);
 	if (cached && cached.expiresAt > Date.now()) return cached.mapping;
 	const mapping = await findWorkAppSlackUserMapping(runDbClient_default)(tenantId, slackUserId, teamId, clientId);
-	if (userMappingCache.size >= USER_MAPPING_CACHE_MAX_SIZE) {
-		evictExpiredEntries();
+	if (mapping) {
 		if (userMappingCache.size >= USER_MAPPING_CACHE_MAX_SIZE) {
-			const oldestKey = userMappingCache.keys().next().value;
-			if (oldestKey) userMappingCache.delete(oldestKey);
+			evictExpiredEntries();
+			if (userMappingCache.size >= USER_MAPPING_CACHE_MAX_SIZE) {
+				const oldestKey = userMappingCache.keys().next().value;
+				if (oldestKey) userMappingCache.delete(oldestKey);
+			}
 		}
+		userMappingCache.set(cacheKey, {
+			mapping,
+			expiresAt: Date.now() + USER_MAPPING_CACHE_TTL_MS
+		});
 	}
-	userMappingCache.set(cacheKey, {
-		mapping,
-		expiresAt: Date.now() + USER_MAPPING_CACHE_TTL_MS
-	});
 	return mapping;
 }
 /**
@@ -328,6 +330,27 @@ async function checkIfBotThread(slackClient, channel, threadTs) {
 		return false;
 	}
 }
+function formatAttachments(attachments) {
+	if (!attachments || attachments.length === 0) return "";
+	const parts = [];
+	for (const att of attachments) {
+		const content = att.text || att.fallback;
+		if (!content) continue;
+		const isSharedMessage = att.is_msg_unfurl || att.is_share;
+		const meta = [];
+		if (att.author_name) meta.push(`from ${att.author_name}`);
+		if (att.channel_name) meta.push(`in #${att.channel_name}`);
+		else if (att.channel_id) meta.push(`in channel ${att.channel_id}`);
+		const label = isSharedMessage ? "Shared message" : "Attachment";
+		const metaSuffix = meta.length > 0 ? ` (${meta.join(", ")})` : "";
+		const sourceLine = att.from_url ? `\n[Source: ${att.from_url}]` : "";
+		parts.push(`[${label}${metaSuffix}]:\n\`\`\`\n${content}\n\`\`\`${sourceLine}`);
+		if (att.fields && att.fields.length > 0) {
+			for (const field of att.fields) if (field.title && field.value) parts.push(`${field.title}: ${field.value}`);
+		}
+	}
+	return parts.join("\n\n");
+}
 async function getThreadContext(slackClient, channel, threadTs, options = {}) {
 	const { includeLastMessage = false, resolveUserNames = true } = options;
 	try {
@@ -347,15 +370,15 @@ async function getThreadContext(slackClient, channel, threadTs, options = {}) {
 				try {
 					const userInfo = await slackClient.users?.info({ user: userId });
 					userNameCache.set(userId, {
-						displayName: userInfo?.user?.display_name,
+						displayName: userInfo?.user?.profile?.display_name,
 						fullName: userInfo?.user?.real_name,
-						name: userInfo?.user?.name
+						email: userInfo?.user?.profile?.email
 					});
 				} catch {
 					userNameCache.set(userId, {
 						displayName: void 0,
 						fullName: void 0,
-						name: void 0
+						email: void 0
 					});
 				}
 			}));
@@ -365,10 +388,10 @@ async function getThreadContext(slackClient, channel, threadTs, options = {}) {
 			const parts = [`userId: ${userId}`];
 			if (info.displayName) parts.push(`"${info.displayName}"`);
 			if (info.fullName) parts.push(`"${info.fullName}"`);
-			if (info.name) parts.push(`"${info.name}"`);
+			if (info.email) parts.push(info.email);
 			userDirectoryLines.push(`- ${parts.join(", ")}`);
 		}
-		return `${userDirectoryLines.length > 0 ? `Users in this thread (UserId - DisplayName, FullName, Name):\n${userDirectoryLines.join("\n")}\n\n` : ""}Messages in this thread:\n${messagesToProcess.map((msg, index) => {
+		return `${userDirectoryLines.length > 0 ? `Users in this thread (UserId - DisplayName, FullName, Email):\n${userDirectoryLines.join("\n")}\n\n` : ""}Messages in this thread:\n${messagesToProcess.map((msg, index) => {
 			const isBot = !!msg.bot_id;
 			const isParent = index === 0;
 			let role;
@@ -377,7 +400,9 @@ async function getThreadContext(slackClient, channel, threadTs, options = {}) {
 			else role = "Unknown";
 			const prefix = isParent ? "[Thread Start] " : "";
 			const messageText = msg.text || "";
-			return `${prefix}${role}: """${messageText}"""`;
+			const attachmentText = formatAttachments(msg.attachments);
+			const fullText = attachmentText ? `${messageText}\n${attachmentText}` : messageText;
+			return `${prefix}${role}: """${fullText}"""`;
 		}).join("\n\n")}`;
 	} catch (threadError) {
 		logger.warn({
@@ -412,4 +437,4 @@ function formatChannelContext(channelInfo) {
 }
 
 //#endregion
-export { SlackErrorType, checkIfBotThread, classifyError, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, formatChannelContext, formatChannelLabel, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, resolveChannelAgentConfig, sendResponseUrlMessage, timedOp };
+export { SlackErrorType, checkIfBotThread, classifyError, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, formatAttachments, formatChannelContext, formatChannelLabel, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, resolveChannelAgentConfig, sendResponseUrlMessage, timedOp };

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

@@ -1,16 +1,16 @@
 import { AgentResolutionParams, ResolvedAgentConfig, getAgentConfigSources, resolveEffectiveAgent } from "./agent-resolution.js";
-import { AgentConfigSources, ContextBlockParams, FollowUpButtonParams, ToolApprovalButtonValue, ToolApprovalButtonValueSchema, buildCitationsBlock, buildConversationResponseBlocks, buildDataArtifactBlocks, buildDataComponentBlocks, buildFollowUpButton, buildSummaryBreadcrumbBlock, buildToolApprovalBlocks, buildToolApprovalDoneBlocks, buildToolApprovalExpiredBlocks, buildToolOutputErrorBlock, createAlreadyLinkedMessage, createContextBlock, createCreateInkeepAccountMessage, createErrorMessage, createJwtLinkMessage, createNotLinkedMessage, createStatusMessage, createUnlinkSuccessMessage, createUpdatedHelpMessage } from "./blocks/index.js";
+import { AgentConfigSources, ContextBlockParams, FollowUpButtonParams, ToolApprovalButtonValue, ToolApprovalButtonValueSchema, buildCitationsBlock, buildConversationResponseBlocks, buildDataArtifactBlocks, buildDataComponentBlocks, buildFollowUpButton, buildSummaryBreadcrumbBlock, buildToolApprovalBlocks, buildToolApprovalDoneBlocks, buildToolApprovalExpiredBlocks, buildToolOutputErrorBlock, createAlreadyLinkedMessage, createContextBlock, createCreateInkeepAccountMessage, createErrorMessage, createNotLinkedMessage, createSmartLinkMessage, createStatusMessage, createUnlinkSuccessMessage, createUpdatedHelpMessage } from "./blocks/index.js";
 import { checkUserIsChannelMember, getSlackChannelInfo, getSlackChannels, getSlackClient, getSlackTeamInfo, getSlackUserInfo, postMessage, postMessageInThread, revokeSlackToken } from "./client.js";
 import { DefaultAgentConfig, SlackWorkspaceConnection, WorkspaceInstallData, clearWorkspaceConnectionCache, computeWorkspaceConnectionId, createConnectSession, deleteWorkspaceInstallation, findWorkspaceConnectionByTeamId, getConnectionAccessToken, getSlackIntegrationId, getSlackNango, getWorkspaceDefaultAgentFromNango, listWorkspaceInstallations, setWorkspaceDefaultAgent, storeWorkspaceInstallation, updateConnectionMetadata } from "./nango.js";
 import { SlackCommandPayload, SlackCommandResponse } from "./types.js";
 import { handleAgentPickerCommand, handleCommand, handleHelpCommand, handleLinkCommand, handleQuestionCommand, handleStatusCommand, handleUnlinkCommand } from "./commands/index.js";
+import { AgentOption, BuildAgentSelectorModalParams, BuildMessageShortcutModalParams, FollowUpModalMetadata, ModalMetadata, buildAgentSelectorModal, buildFollowUpModal, buildMessageShortcutModal } from "./modals.js";
+import { SlackErrorType, checkIfBotThread, classifyError, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, sendResponseUrlMessage } from "./events/utils.js";
 import { InlineSelectorMetadata, handleAppMention } from "./events/app-mention.js";
 import { handleMessageShortcut, handleOpenAgentSelectorModal, handleOpenFollowUpModal, handleToolApproval } 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, 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, ToolApprovalButtonValue, ToolApprovalButtonValueSchema, WorkspaceInstallData, buildAgentSelectorModal, buildCitationsBlock, buildConversationResponseBlocks, buildDataArtifactBlocks, buildDataComponentBlocks, buildFollowUpButton, buildFollowUpModal, buildMessageShortcutModal, buildSummaryBreadcrumbBlock, buildToolApprovalBlocks, buildToolApprovalDoneBlocks, buildToolApprovalExpiredBlocks, buildToolOutputErrorBlock, checkIfBotThread, checkUserIsChannelMember, classifyError, clearWorkspaceConnectionCache, computeWorkspaceConnectionId, createAlreadyLinkedMessage, createConnectSession, createContextBlock, createCreateInkeepAccountMessage, 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, handleToolApproval, 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, ToolApprovalButtonValue, ToolApprovalButtonValueSchema, WorkspaceInstallData, buildAgentSelectorModal, buildCitationsBlock, buildConversationResponseBlocks, buildDataArtifactBlocks, buildDataComponentBlocks, buildFollowUpButton, buildFollowUpModal, buildMessageShortcutModal, buildSummaryBreadcrumbBlock, buildToolApprovalBlocks, buildToolApprovalDoneBlocks, buildToolApprovalExpiredBlocks, buildToolOutputErrorBlock, checkIfBotThread, checkUserIsChannelMember, classifyError, clearWorkspaceConnectionCache, computeWorkspaceConnectionId, createAlreadyLinkedMessage, createConnectSession, createContextBlock, createCreateInkeepAccountMessage, createErrorMessage, createNotLinkedMessage, createSmartLinkMessage, 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, handleToolApproval, handleUnlinkCommand, listWorkspaceInstallations, markdownToMrkdwn, parseSlackCommandBody, parseSlackEventBody, postMessage, postMessageInThread, resolveEffectiveAgent, revokeSlackToken, sendResponseUrlMessage, setBotTokenForTeam, setWorkspaceDefaultAgent, storeWorkspaceInstallation, streamAgentResponse, updateConnectionMetadata, verifySlackRequest };

package/dist/slack/services/index.js

@@ -1,8 +1,8 @@
 import { clearWorkspaceConnectionCache, computeWorkspaceConnectionId, createConnectSession, deleteWorkspaceInstallation, findWorkspaceConnectionByTeamId, getConnectionAccessToken, getSlackIntegrationId, getSlackNango, getWorkspaceDefaultAgentFromNango, listWorkspaceInstallations, setWorkspaceDefaultAgent, storeWorkspaceInstallation, updateConnectionMetadata } from "./nango.js";
+import { SlackErrorType, checkIfBotThread, classifyError, extractApiErrorMessage, fetchAgentsForProject, fetchProjectsForTenant, findCachedUserMapping, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, markdownToMrkdwn, sendResponseUrlMessage } from "./events/utils.js";
 import { getAgentConfigSources, resolveEffectiveAgent } from "./agent-resolution.js";
-import { ToolApprovalButtonValueSchema, buildCitationsBlock, buildConversationResponseBlocks, buildDataArtifactBlocks, buildDataComponentBlocks, buildFollowUpButton, buildSummaryBreadcrumbBlock, buildToolApprovalBlocks, buildToolApprovalDoneBlocks, buildToolApprovalExpiredBlocks, buildToolOutputErrorBlock, createAlreadyLinkedMessage, createContextBlock, createCreateInkeepAccountMessage, createErrorMessage, createJwtLinkMessage, createNotLinkedMessage, createStatusMessage, createUnlinkSuccessMessage, createUpdatedHelpMessage } from "./blocks/index.js";
+import { ToolApprovalButtonValueSchema, buildCitationsBlock, buildConversationResponseBlocks, buildDataArtifactBlocks, buildDataComponentBlocks, buildFollowUpButton, buildSummaryBreadcrumbBlock, buildToolApprovalBlocks, buildToolApprovalDoneBlocks, buildToolApprovalExpiredBlocks, buildToolOutputErrorBlock, createAlreadyLinkedMessage, createContextBlock, createCreateInkeepAccountMessage, createErrorMessage, createNotLinkedMessage, createSmartLinkMessage, createStatusMessage, createUnlinkSuccessMessage, createUpdatedHelpMessage } from "./blocks/index.js";
 import { checkUserIsChannelMember, getSlackChannelInfo, getSlackChannels, getSlackClient, getSlackTeamInfo, getSlackUserInfo, postMessage, postMessageInThread, revokeSlackToken } from "./client.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 { streamAgentResponse } from "./events/streaming.js";
@@ -13,4 +13,4 @@ import "./events/index.js";
 import { parseSlackCommandBody, parseSlackEventBody, verifySlackRequest } from "./security.js";
 import { getBotTokenForTeam, setBotTokenForTeam } from "./workspace-tokens.js";
 
-export { SlackErrorType, ToolApprovalButtonValueSchema, buildAgentSelectorModal, buildCitationsBlock, buildConversationResponseBlocks, buildDataArtifactBlocks, buildDataComponentBlocks, buildFollowUpButton, buildFollowUpModal, buildMessageShortcutModal, buildSummaryBreadcrumbBlock, buildToolApprovalBlocks, buildToolApprovalDoneBlocks, buildToolApprovalExpiredBlocks, buildToolOutputErrorBlock, checkIfBotThread, checkUserIsChannelMember, classifyError, clearWorkspaceConnectionCache, computeWorkspaceConnectionId, createAlreadyLinkedMessage, createConnectSession, createContextBlock, createCreateInkeepAccountMessage, 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, handleToolApproval, handleUnlinkCommand, listWorkspaceInstallations, markdownToMrkdwn, parseSlackCommandBody, parseSlackEventBody, postMessage, postMessageInThread, resolveEffectiveAgent, revokeSlackToken, sendResponseUrlMessage, setBotTokenForTeam, setWorkspaceDefaultAgent, storeWorkspaceInstallation, streamAgentResponse, updateConnectionMetadata, verifySlackRequest };
+export { SlackErrorType, ToolApprovalButtonValueSchema, buildAgentSelectorModal, buildCitationsBlock, buildConversationResponseBlocks, buildDataArtifactBlocks, buildDataComponentBlocks, buildFollowUpButton, buildFollowUpModal, buildMessageShortcutModal, buildSummaryBreadcrumbBlock, buildToolApprovalBlocks, buildToolApprovalDoneBlocks, buildToolApprovalExpiredBlocks, buildToolOutputErrorBlock, checkIfBotThread, checkUserIsChannelMember, classifyError, clearWorkspaceConnectionCache, computeWorkspaceConnectionId, createAlreadyLinkedMessage, createConnectSession, createContextBlock, createCreateInkeepAccountMessage, createErrorMessage, createNotLinkedMessage, createSmartLinkMessage, 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, handleToolApproval, handleUnlinkCommand, listWorkspaceInstallations, markdownToMrkdwn, parseSlackCommandBody, parseSlackEventBody, postMessage, postMessageInThread, resolveEffectiveAgent, revokeSlackToken, sendResponseUrlMessage, setBotTokenForTeam, setWorkspaceDefaultAgent, storeWorkspaceInstallation, streamAgentResponse, updateConnectionMetadata, verifySlackRequest };

package/dist/slack/services/link-prompt.d.ts

@@ -0,0 +1,27 @@
+import { SlackLinkIntent } from "@inkeep/agents-core";
+import * as slack_block_builder0 from "slack-block-builder";
+
+//#region src/slack/services/link-prompt.d.ts
+type LinkPromptResult = {
+  type: 'auto_invite';
+  url: string;
+  email: string;
+  expiresInMinutes: number;
+} | {
+  type: 'jwt_link';
+  url: string;
+  expiresInMinutes: number;
+};
+interface ResolveLinkActionParams {
+  tenantId: string;
+  teamId: string;
+  slackUserId: string;
+  botToken: string;
+  slackEnterpriseId?: string;
+  slackUsername?: string;
+  intent?: SlackLinkIntent;
+}
+declare function resolveUnlinkedUserAction(params: ResolveLinkActionParams): Promise<LinkPromptResult>;
+declare function buildLinkPromptMessage(result: LinkPromptResult): Readonly<slack_block_builder0.SlackMessageDto>;
+//#endregion
+export { LinkPromptResult, ResolveLinkActionParams, buildLinkPromptMessage, resolveUnlinkedUserAction };

package/dist/slack/services/link-prompt.js

@@ -0,0 +1,142 @@
+import { env } from "../../env.js";
+import { getLogger } from "../../logger.js";
+import runDbClient_default from "../../db/runDbClient.js";
+import { createCreateInkeepAccountMessage, createSmartLinkMessage } from "./blocks/index.js";
+import { getSlackClient } from "./client.js";
+import { createInvitationInDb, findWorkAppSlackWorkspaceByTeamId, getOrganizationMemberByEmail, getPendingInvitationsByEmail, signSlackLinkToken } from "@inkeep/agents-core";
+
+//#region src/slack/services/link-prompt.ts
+const logger = getLogger("slack-link-prompt");
+const LINK_CODE_TTL_MINUTES = 10;
+async function resolveUnlinkedUserAction(params) {
+	const { tenantId, teamId, slackUserId, botToken, slackEnterpriseId, slackUsername, intent } = params;
+	const manageUiUrl = env.INKEEP_AGENTS_MANAGE_UI_URL || "http://localhost:3000";
+	const autoInvite = await tryAutoInvite({
+		tenantId,
+		teamId,
+		slackUserId,
+		botToken
+	});
+	if (autoInvite) {
+		const linkToken$1 = await signSlackLinkToken({
+			tenantId,
+			slackTeamId: teamId,
+			slackUserId,
+			slackEnterpriseId,
+			slackUsername,
+			intent
+		});
+		const authMethod = autoInvite.authMethod;
+		const linkReturnUrl = `/link?token=${encodeURIComponent(linkToken$1)}`;
+		const acceptUrl = authMethod === "email-password" ? `${manageUiUrl}/accept-invitation/${autoInvite.invitationId}?email=${encodeURIComponent(autoInvite.email)}&returnUrl=${encodeURIComponent(linkReturnUrl)}` : `${manageUiUrl}/login?invitation=${encodeURIComponent(autoInvite.invitationId)}&returnUrl=${encodeURIComponent(linkReturnUrl)}&email=${encodeURIComponent(autoInvite.email)}&authMethod=${encodeURIComponent(authMethod)}`;
+		logger.info({
+			invitationId: autoInvite.invitationId,
+			email: autoInvite.email,
+			hasIntent: !!intent
+		}, "Directing unlinked user to accept-invitation page");
+		return {
+			type: "auto_invite",
+			url: acceptUrl,
+			email: autoInvite.email,
+			expiresInMinutes: LINK_CODE_TTL_MINUTES
+		};
+	}
+	const linkToken = await signSlackLinkToken({
+		tenantId,
+		slackTeamId: teamId,
+		slackUserId,
+		slackEnterpriseId,
+		slackUsername,
+		intent
+	});
+	const linkUrl = `${manageUiUrl}/link?token=${encodeURIComponent(linkToken)}`;
+	logger.info({
+		slackUserId,
+		tenantId,
+		hasIntent: !!intent
+	}, "Generated JWT link token for unlinked user");
+	return {
+		type: "jwt_link",
+		url: linkUrl,
+		expiresInMinutes: LINK_CODE_TTL_MINUTES
+	};
+}
+function buildLinkPromptMessage(result) {
+	if (result.type === "auto_invite") return createCreateInkeepAccountMessage(result.url, result.expiresInMinutes);
+	return createSmartLinkMessage(result.url);
+}
+async function tryAutoInvite(params) {
+	const { tenantId, teamId, slackUserId, botToken } = params;
+	if (!botToken) return null;
+	try {
+		if (!(await findWorkAppSlackWorkspaceByTeamId(runDbClient_default)(tenantId, teamId))?.shouldAllowJoinFromWorkspace) {
+			logger.warn({
+				userId: slackUserId,
+				tenantId,
+				teamId
+			}, "Workspace should not allow join from workspace");
+			return null;
+		}
+		const slackClient = getSlackClient(botToken);
+		let userEmail;
+		try {
+			userEmail = (await slackClient.users.info({ user: slackUserId })).user?.profile?.email;
+		} catch (error) {
+			logger.warn({
+				error,
+				userId: slackUserId
+			}, "Failed to get user info from Slack");
+			return null;
+		}
+		if (!userEmail) {
+			logger.warn({ userId: slackUserId }, "No email found in Slack user profile");
+			return null;
+		}
+		if (await getOrganizationMemberByEmail(runDbClient_default)(tenantId, userEmail)) {
+			logger.debug({
+				userId: slackUserId,
+				email: userEmail
+			}, "User already has Inkeep account, skipping auto-invite");
+			return null;
+		}
+		const existingInvitation = (await getPendingInvitationsByEmail(runDbClient_default)(userEmail)).find((inv) => inv.organizationId === tenantId);
+		if (existingInvitation) {
+			logger.info({
+				userId: slackUserId,
+				tenantId,
+				invitationId: existingInvitation.id,
+				email: userEmail
+			}, "Reusing existing pending invitation for Slack user");
+			return {
+				invitationId: existingInvitation.id,
+				email: userEmail,
+				authMethod: existingInvitation.authMethod ?? "email-password"
+			};
+		}
+		const invitation = await createInvitationInDb(runDbClient_default)({
+			organizationId: tenantId,
+			email: userEmail
+		});
+		logger.info({
+			userId: slackUserId,
+			tenantId,
+			invitationId: invitation.id,
+			email: userEmail
+		}, "Invitation created for Slack user without Inkeep account");
+		return {
+			invitationId: invitation.id,
+			email: userEmail,
+			authMethod: invitation.authMethod
+		};
+	} catch (error) {
+		logger.warn({
+			error,
+			userId: slackUserId,
+			tenantId
+		}, "Auto-invite attempt failed");
+		return null;
+	}
+}
+
+//#endregion
+export { buildLinkPromptMessage, resolveUnlinkedUserAction };

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

@@ -24,6 +24,7 @@ interface ModalMetadata {
 interface FollowUpModalMetadata {
   conversationId: string;
   agentId: string;
+  agentName?: string;
   projectId: string;
   tenantId: string;
   teamId: string;

package/dist/slack/services/modals.js

@@ -29,12 +29,13 @@ function buildAgentSelectorModal(params) {
 	const agentOptions = agents.length > 0 ? agents.map((agent) => ({
 		text: {
 			type: "plain_text",
-			text: agent.name || agent.id,
+			text: agent.name ? `${agent.name} (${agent.id})` : agent.id,
 			emoji: true
 		},
 		value: JSON.stringify({
 			agentId: agent.id,
-			projectId: agent.projectId
+			projectId: agent.projectId,
+			agentName: agent.name
 		})
 	})) : [{
 		text: {
@@ -234,12 +235,13 @@ function buildMessageShortcutModal(params) {
 	const agentOptions = agents.length > 0 ? agents.map((agent) => ({
 		text: {
 			type: "plain_text",
-			text: agent.name || agent.id,
+			text: agent.name ? `${agent.name} (${agent.id})` : agent.id,
 			emoji: true
 		},
 		value: JSON.stringify({
 			agentId: agent.id,
-			projectId: agent.projectId
+			projectId: agent.projectId,
+			agentName: agent.name
 		})
 	})) : [{
 		text: {

package/dist/slack/services/resume-intent.d.ts

@@ -0,0 +1,15 @@
+import { SlackLinkIntent } from "@inkeep/agents-core";
+
+//#region src/slack/services/resume-intent.d.ts
+interface ResumeSmartLinkIntentParams {
+  intent: SlackLinkIntent;
+  teamId: string;
+  slackUserId: string;
+  inkeepUserId: string;
+  tenantId: string;
+  slackEnterpriseId?: string;
+  slackUsername?: string;
+}
+declare function resumeSmartLinkIntent(params: ResumeSmartLinkIntentParams): Promise<void>;
+//#endregion
+export { ResumeSmartLinkIntentParams, resumeSmartLinkIntent };