@inkeep/agents-work-apps 0.0.0-dev-20260204182014 → 0.0.0-dev-20260204210021

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

@@ -1,212 +0,0 @@
-import { env } from "../../../env.js";
-import { getLogger } from "../../../logger.js";
-import runDbClient_default from "../../../db/runDbClient.js";
-import { findWorkspaceConnectionByTeamId } from "../nango.js";
-import { getSlackClient, postMessageInThread } from "../client.js";
-import { getBotTokenForTeam } from "../workspace-tokens.js";
-import { checkIfBotThread, classifyError, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage } from "./utils.js";
-import { streamAgentResponse } from "./streaming.js";
-import { findWorkAppSlackUserMapping, signSlackUserToken } from "@inkeep/agents-core";
-
-//#region src/slack/services/events/app-mention.ts
-/**
-* Handler for Slack @mention events
-*
-* Flow:
-* 1. Resolve agent config (channel override > workspace default)
-* 2. If no agent configured → prompt to set up in dashboard
-* 3. Check if user is linked to Inkeep
-* 4. If not linked → prompt to link account
-* 5. Handle based on context:
-*    - Channel + no query → Show welcome/help message
-*    - Channel + query → Execute agent with streaming response
-*    - Thread + no query → Show modal to select agent
-*    - Thread + query → Execute agent with thread context included
-*/
-const logger = getLogger("slack-app-mention");
-/**
-* Main handler for @mention events in Slack
-*/
-async function handleAppMention(params) {
-	const { slackUserId, channel, text, threadTs, messageTs, teamId } = params;
-	const manageUiUrl = env.INKEEP_AGENTS_MANAGE_UI_URL || "http://localhost:3000";
-	logger.info({
-		slackUserId,
-		channel,
-		teamId
-	}, "Handling app mention");
-	const tenantId = (await findWorkspaceConnectionByTeamId(teamId))?.tenantId || "default";
-	const dashboardUrl = `${manageUiUrl}/${tenantId}/work-apps/slack`;
-	const botToken = await resolveBotToken(teamId);
-	if (!botToken) {
-		logger.error({ teamId }, "No bot token available");
-		return;
-	}
-	const slackClient = getSlackClient(botToken);
-	const replyThreadTs = threadTs || messageTs;
-	const isInThread = Boolean(threadTs && threadTs !== messageTs);
-	const hasQuery = Boolean(text && text.trim().length > 0);
-	try {
-		const agentConfig = await getChannelAgentConfig(teamId, channel);
-		if (!agentConfig) {
-			await slackClient.chat.postEphemeral({
-				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>*`
-			});
-			return;
-		}
-		const agentDisplayName = agentConfig.agentName || agentConfig.agentId;
-		const existingLink = await findWorkAppSlackUserMapping(runDbClient_default)(tenantId, slackUserId, teamId, "work-apps-slack");
-		if (!existingLink) {
-			await slackClient.chat.postEphemeral({
-				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}*`
-			});
-			return;
-		}
-		if (isInThread && !hasQuery) {
-			if (await checkIfBotThread(slackClient, channel, threadTs)) await slackClient.chat.postEphemeral({
-				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}_`
-			});
-			else {
-				const metadata = {
-					channel,
-					threadTs,
-					messageTs,
-					teamId,
-					slackUserId,
-					tenantId,
-					threadMessageCount: 0
-				};
-				await slackClient.chat.postEphemeral({
-					channel,
-					user: slackUserId,
-					thread_ts: threadTs,
-					text: "Select an agent to analyze this thread",
-					blocks: [{
-						type: "section",
-						text: {
-							type: "mrkdwn",
-							text: "*Run an agent on this thread*\nClick the button below to select an agent and run it with this thread as context."
-						}
-					}, {
-						type: "actions",
-						block_id: "agent_selector_trigger",
-						elements: [{
-							type: "button",
-							action_id: "open_agent_selector_modal",
-							text: {
-								type: "plain_text",
-								text: "Select Agent",
-								emoji: true
-							},
-							style: "primary",
-							value: JSON.stringify(metadata)
-						}]
-					}]
-				});
-			}
-			return;
-		}
-		if (!hasQuery) {
-			await slackClient.chat.postEphemeral({
-				channel,
-				user: slackUserId,
-				text: `*${agentDisplayName}* is your workspace's default agent.\n\n*Get started:*\n\`@Inkeep <prompt>\` — Run the agent with your prompt\n\n*In threads:*\n• \`@Inkeep <prompt>\` — Include thread context automatically\n• \`@Inkeep\` (no prompt) — Open agent selector to choose a different agent\n\nUse \`/inkeep help\` for more options.`
-			});
-			return;
-		}
-		let queryText = text;
-		if (isInThread && threadTs) {
-			const contextMessages = await getThreadContext(slackClient, channel, threadTs);
-			if (contextMessages) queryText = `Based on the following conversation:\n\n${contextMessages}\n\nUser question: ${text}`;
-		}
-		const slackUserToken = await signSlackUserToken({
-			inkeepUserId: existingLink.inkeepUserId,
-			tenantId,
-			slackTeamId: teamId,
-			slackUserId
-		});
-		const ackMessage = await slackClient.chat.postMessage({
-			channel,
-			thread_ts: replyThreadTs,
-			text: `_${agentDisplayName} is preparing a response..._`
-		});
-		const conversationId = generateSlackConversationId({
-			teamId,
-			threadTs: replyThreadTs,
-			channel,
-			isDM: false
-		});
-		logger.info({
-			projectId: agentConfig.projectId,
-			agentId: agentConfig.agentId,
-			conversationId
-		}, "Executing agent");
-		await streamAgentResponse({
-			slackClient,
-			channel,
-			threadTs: replyThreadTs,
-			thinkingMessageTs: ackMessage.ts || "",
-			slackUserId,
-			teamId,
-			jwtToken: slackUserToken,
-			projectId: agentConfig.projectId,
-			agentId: agentConfig.agentId,
-			question: queryText,
-			agentName: agentDisplayName,
-			conversationId
-		});
-	} catch (error) {
-		const errorMsg = error instanceof Error ? error.message : String(error);
-		logger.error({
-			errorMessage: errorMsg,
-			channel,
-			teamId
-		}, "Failed in app mention handler");
-		const userMessage = getUserFriendlyErrorMessage(classifyError(error));
-		try {
-			await slackClient.chat.postEphemeral({
-				channel,
-				user: slackUserId,
-				thread_ts: isInThread ? threadTs : void 0,
-				text: userMessage
-			});
-		} catch (postError) {
-			logger.error({ error: postError }, "Failed to post error message");
-			try {
-				await postMessageInThread(slackClient, channel, replyThreadTs, userMessage);
-			} catch {}
-		}
-	}
-}
-/**
-* Resolve bot token from various sources (Nango, memory cache, env)
-*/
-async function resolveBotToken(teamId) {
-	const workspaceConnection = await findWorkspaceConnectionByTeamId(teamId);
-	if (workspaceConnection?.botToken) return workspaceConnection.botToken;
-	const memoryToken = getBotTokenForTeam(teamId);
-	if (memoryToken) return memoryToken;
-	if (env.SLACK_BOT_TOKEN) return env.SLACK_BOT_TOKEN;
-	return null;
-}
-
-//#endregion
-export { handleAppMention };

package/dist/slack/services/events/block-actions.d.ts

@@ -1,47 +0,0 @@
-import { ModalMetadata } from "../modals.js";
-
-//#region src/slack/services/events/block-actions.d.ts
-
-/**
- * Handle "Share to Thread" button click from ephemeral responses
- * Posts the response to the current thread instead of the main channel
- */
-declare function handleShareToThread(params: {
-  teamId: string;
-  channelId: string;
-  userId: string;
-  actionValue: string;
-  responseUrl: string;
-}): Promise<void>;
-/**
- * Handle "Share to Channel" button click from ephemeral responses
- */
-declare function handleShareToChannel(params: {
-  teamId: string;
-  channelId: string;
-  userId: string;
-  actionValue: string;
-  responseUrl: string;
-}): Promise<void>;
-/**
- * Handle opening the agent selector modal when user clicks "Select Agent" button
- */
-declare function handleOpenAgentSelectorModal(params: {
-  triggerId: string;
-  actionValue: string;
-  teamId: string;
-  responseUrl: string;
-}): Promise<void>;
-/**
- * Handle project selection change in modal (updates agent dropdown)
- */
-declare function handleModalProjectSelect(params: {
-  triggerId: string;
-  viewId: string;
-  teamId: string;
-  tenantId: string;
-  selectedProjectId: string;
-  currentMetadata: ModalMetadata;
-}): Promise<void>;
-//#endregion
-export { handleModalProjectSelect, handleOpenAgentSelectorModal, handleShareToChannel, handleShareToThread };

package/dist/slack/services/events/block-actions.js

@@ -1,287 +0,0 @@
-import { getLogger } from "../../../logger.js";
-import { findWorkspaceConnectionByTeamId } from "../nango.js";
-import { getSlackClient } from "../client.js";
-import { fetchAgentsForProject, fetchProjectsForTenant, getChannelAgentConfig, sendResponseUrlMessage } from "./utils.js";
-import { buildAgentSelectorModal } from "../modals.js";
-
-//#region src/slack/services/events/block-actions.ts
-/**
-* Handlers for Slack block action events (button clicks, selections, etc.)
-*/
-const logger = getLogger("slack-block-actions");
-/**
-* Handle "Share to Thread" button click from ephemeral responses
-* Posts the response to the current thread instead of the main channel
-*/
-async function handleShareToThread(params) {
-	const { teamId, channelId, userId, actionValue, responseUrl } = params;
-	let textToShare = "";
-	let agentName = "Inkeep";
-	let threadTs = "";
-	try {
-		const valueData = JSON.parse(actionValue);
-		textToShare = valueData.text || "";
-		agentName = valueData.agentName || "Inkeep";
-		threadTs = valueData.threadTs || "";
-	} catch {
-		logger.warn({ actionValue }, "Failed to parse share_to_thread action value");
-		return;
-	}
-	if (!textToShare) {
-		if (responseUrl) await sendResponseUrlMessage(responseUrl, {
-			text: "❌ Could not find content to share.",
-			response_type: "ephemeral"
-		});
-		return;
-	}
-	if (!threadTs) {
-		if (responseUrl) await sendResponseUrlMessage(responseUrl, {
-			text: "❌ Could not find thread to share to.",
-			response_type: "ephemeral"
-		});
-		return;
-	}
-	const workspaceConnection = await findWorkspaceConnectionByTeamId(teamId);
-	if (!workspaceConnection?.botToken) {
-		logger.error({ teamId }, "No bot token for share_to_thread");
-		if (responseUrl) await sendResponseUrlMessage(responseUrl, {
-			text: "❌ Could not share to thread. Please try again.",
-			response_type: "ephemeral"
-		});
-		return;
-	}
-	const slackClient = getSlackClient(workspaceConnection.botToken);
-	try {
-		await slackClient.chat.postMessage({
-			channel: channelId,
-			thread_ts: threadTs,
-			text: textToShare,
-			blocks: [{
-				type: "section",
-				text: {
-					type: "mrkdwn",
-					text: textToShare
-				}
-			}, {
-				type: "context",
-				elements: [{
-					type: "mrkdwn",
-					text: `Shared by <@${userId}> • Powered by *${agentName}* via Inkeep`
-				}]
-			}]
-		});
-		logger.info({
-			channelId,
-			threadTs,
-			userId
-		}, "Shared message to thread");
-		if (responseUrl) await sendResponseUrlMessage(responseUrl, {
-			text: "✅ Response shared to thread!",
-			response_type: "ephemeral"
-		});
-	} catch (error) {
-		logger.error({
-			error,
-			channelId,
-			threadTs
-		}, "Failed to share message to thread");
-		if (responseUrl) await sendResponseUrlMessage(responseUrl, {
-			text: "❌ Failed to share to thread. Please try again.",
-			response_type: "ephemeral"
-		});
-	}
-}
-/**
-* Handle "Share to Channel" button click from ephemeral responses
-*/
-async function handleShareToChannel(params) {
-	const { teamId, channelId, userId, actionValue, responseUrl } = params;
-	let textToShare = "";
-	let agentName = "Inkeep";
-	try {
-		const valueData = JSON.parse(actionValue);
-		textToShare = valueData.text || "";
-		agentName = valueData.agentName || "Inkeep";
-	} catch {
-		logger.warn({ actionValue }, "Failed to parse share_to_channel action value");
-		return;
-	}
-	if (!textToShare) {
-		if (responseUrl) await sendResponseUrlMessage(responseUrl, {
-			text: "❌ Could not find content to share.",
-			response_type: "ephemeral"
-		});
-		return;
-	}
-	const workspaceConnection = await findWorkspaceConnectionByTeamId(teamId);
-	if (!workspaceConnection?.botToken) {
-		logger.error({ teamId }, "No bot token for share_to_channel");
-		if (responseUrl) await sendResponseUrlMessage(responseUrl, {
-			text: "❌ Could not share to channel. Please try again.",
-			response_type: "ephemeral"
-		});
-		return;
-	}
-	const slackClient = getSlackClient(workspaceConnection.botToken);
-	try {
-		await slackClient.chat.postMessage({
-			channel: channelId,
-			text: textToShare,
-			blocks: [{
-				type: "section",
-				text: {
-					type: "mrkdwn",
-					text: textToShare
-				}
-			}, {
-				type: "context",
-				elements: [{
-					type: "mrkdwn",
-					text: `Shared by <@${userId}> • Powered by *${agentName}* via Inkeep`
-				}]
-			}]
-		});
-		logger.info({
-			channelId,
-			userId
-		}, "Shared message to channel");
-		if (responseUrl) await sendResponseUrlMessage(responseUrl, {
-			text: "✅ Response shared to channel!",
-			response_type: "ephemeral"
-		});
-	} catch (error) {
-		logger.error({
-			error,
-			channelId
-		}, "Failed to share message to channel");
-		if (responseUrl) await sendResponseUrlMessage(responseUrl, {
-			text: "❌ Failed to share to channel. Please try again.",
-			response_type: "ephemeral"
-		});
-	}
-}
-/**
-* Handle opening the agent selector modal when user clicks "Select Agent" button
-*/
-async function handleOpenAgentSelectorModal(params) {
-	const { triggerId, actionValue, teamId, responseUrl } = params;
-	try {
-		const metadata = JSON.parse(actionValue);
-		const { channel, threadTs, slackUserId, tenantId } = metadata;
-		const workspaceConnection = await findWorkspaceConnectionByTeamId(teamId);
-		if (!workspaceConnection?.botToken) {
-			logger.error({ teamId }, "No bot token for modal");
-			return;
-		}
-		const slackClient = getSlackClient(workspaceConnection.botToken);
-		let projectList = await fetchProjectsForTenant(tenantId);
-		if (projectList.length === 0) {
-			const defaultAgent = await getChannelAgentConfig(teamId, channel);
-			if (defaultAgent) projectList = [{
-				id: defaultAgent.projectId,
-				name: defaultAgent.projectName || defaultAgent.projectId
-			}];
-		}
-		if (projectList.length === 0) {
-			await slackClient.chat.postEphemeral({
-				channel,
-				user: slackUserId,
-				thread_ts: threadTs,
-				text: "⚙️ No projects configured. Please set up projects in the dashboard."
-			});
-			return;
-		}
-		const firstProject = projectList[0];
-		let agentList = await fetchAgentsForProject(tenantId, firstProject.id);
-		if (agentList.length === 0) {
-			const defaultAgent = await getChannelAgentConfig(teamId, channel);
-			if (defaultAgent && defaultAgent.projectId === firstProject.id) agentList = [{
-				id: defaultAgent.agentId,
-				name: defaultAgent.agentName || defaultAgent.agentId,
-				projectId: defaultAgent.projectId,
-				projectName: defaultAgent.projectName || defaultAgent.projectId
-			}];
-		}
-		const modalMetadata = {
-			channel,
-			threadTs,
-			messageTs: metadata.messageTs,
-			teamId,
-			slackUserId,
-			tenantId,
-			isInThread: true,
-			threadMessageCount: 0,
-			buttonResponseUrl: responseUrl
-		};
-		const modal = buildAgentSelectorModal({
-			projects: projectList,
-			agents: agentList.map((a) => ({
-				id: a.id,
-				name: a.name,
-				projectId: a.projectId,
-				projectName: a.projectName || a.projectId
-			})),
-			metadata: modalMetadata,
-			selectedProjectId: firstProject.id
-		});
-		await slackClient.views.open({
-			trigger_id: triggerId,
-			view: modal
-		});
-		logger.info({
-			teamId,
-			channel,
-			threadTs,
-			projectCount: projectList.length,
-			agentCount: agentList.length
-		}, "Opened agent selector modal");
-	} catch (error) {
-		logger.error({
-			error,
-			teamId
-		}, "Failed to open agent selector modal");
-	}
-}
-/**
-* Handle project selection change in modal (updates agent dropdown)
-*/
-async function handleModalProjectSelect(params) {
-	const { viewId, teamId, tenantId, selectedProjectId, currentMetadata } = params;
-	try {
-		const workspaceConnection = await findWorkspaceConnectionByTeamId(teamId);
-		if (!workspaceConnection?.botToken) {
-			logger.error({ teamId }, "No bot token for modal update");
-			return;
-		}
-		const slackClient = getSlackClient(workspaceConnection.botToken);
-		const [projectList, agentList] = await Promise.all([fetchProjectsForTenant(tenantId), fetchAgentsForProject(tenantId, selectedProjectId)]);
-		const modal = buildAgentSelectorModal({
-			projects: projectList,
-			agents: agentList.map((a) => ({
-				id: a.id,
-				name: a.name,
-				projectId: a.projectId,
-				projectName: a.projectName || a.projectId
-			})),
-			metadata: currentMetadata,
-			selectedProjectId
-		});
-		await slackClient.views.update({
-			view_id: viewId,
-			view: modal
-		});
-		logger.info({
-			teamId,
-			selectedProjectId,
-			agentCount: agentList.length
-		}, "Updated modal view");
-	} catch (error) {
-		logger.error({
-			error,
-			teamId
-		}, "Failed to update modal after project select");
-	}
-}
-
-//#endregion
-export { handleModalProjectSelect, handleOpenAgentSelectorModal, handleShareToChannel, handleShareToThread };

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

@@ -1,6 +0,0 @@
-import { InlineSelectorMetadata, handleAppMention } from "./app-mention.js";
-import { handleModalProjectSelect, handleOpenAgentSelectorModal, handleShareToChannel, handleShareToThread } from "./block-actions.js";
-import { handleModalSubmission } from "./modal-submission.js";
-import { SlackErrorType, checkIfBotThread, classifyError, fetchAgentsForProject, fetchAgentsForTenant, fetchProjectsForTenant, 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, fetchAgentsForTenant, fetchProjectsForTenant, generateSlackConversationId, getChannelAgentConfig, getThreadContext, getUserFriendlyErrorMessage, getWorkspaceDefaultAgent, handleAppMention, handleModalProjectSelect, handleModalSubmission, handleOpenAgentSelectorModal, handleShareToChannel, handleShareToThread, markdownToMrkdwn, sendResponseUrlMessage, streamAgentResponse };

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

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

package/dist/slack/services/events/modal-submission.d.ts

@@ -1,12 +0,0 @@
-//#region src/slack/services/events/modal-submission.d.ts
-/**
- * Handler for Slack modal submission events
- */
-declare function handleModalSubmission(view: {
-  private_metadata?: string;
-  state?: {
-    values?: Record<string, Record<string, unknown>>;
-  };
-}): Promise<void>;
-//#endregion
-export { handleModalSubmission };