@inkeep/agents-work-apps 0.47.5 → 0.48.0

package/dist/slack/services/modals.js

@@ -0,0 +1,355 @@
+import { env } from "../../env.js";
+import { SlackStrings } from "../i18n/strings.js";
+
+//#region src/slack/services/modals.ts
+const manageUiBaseUrl = env.INKEEP_AGENTS_MANAGE_UI_URL || "http://localhost:3000";
+/**
+* Build the agent selector modal.
+*
+* Shows:
+* - Project dropdown
+* - Agent dropdown (updates based on project selection)
+* - Include thread context checkbox (if in thread)
+* - Question/instructions input
+* - Dashboard link
+*
+* All responses from this modal are private (ephemeral).
+*/
+function buildAgentSelectorModal(params) {
+	const { projects, agents, metadata, selectedProjectId } = params;
+	const isInThread = metadata.isInThread;
+	const projectOptions = projects.map((project) => ({
+		text: {
+			type: "plain_text",
+			text: project.name,
+			emoji: true
+		},
+		value: project.id
+	}));
+	const agentOptions = agents.length > 0 ? agents.map((agent) => ({
+		text: {
+			type: "plain_text",
+			text: agent.name || agent.id,
+			emoji: true
+		},
+		value: JSON.stringify({
+			agentId: agent.id,
+			projectId: agent.projectId
+		})
+	})) : [{
+		text: {
+			type: "plain_text",
+			text: SlackStrings.status.noAgentsAvailable,
+			emoji: true
+		},
+		value: "none"
+	}];
+	const selectedProjectOption = selectedProjectId ? projectOptions.find((p) => p.value === selectedProjectId) : projectOptions[0];
+	const blocks = [{
+		type: "input",
+		block_id: "project_select_block",
+		dispatch_action: true,
+		element: {
+			type: "static_select",
+			action_id: "modal_project_select",
+			placeholder: {
+				type: "plain_text",
+				text: SlackStrings.placeholders.selectProject
+			},
+			options: projectOptions,
+			...selectedProjectOption ? { initial_option: selectedProjectOption } : {}
+		},
+		label: {
+			type: "plain_text",
+			text: SlackStrings.labels.project,
+			emoji: true
+		}
+	}, {
+		type: "input",
+		block_id: "agent_select_block",
+		element: {
+			type: "static_select",
+			action_id: "agent_select",
+			placeholder: {
+				type: "plain_text",
+				text: SlackStrings.placeholders.selectAgent
+			},
+			options: agentOptions,
+			...agents.length > 0 ? { initial_option: agentOptions[0] } : {}
+		},
+		label: {
+			type: "plain_text",
+			text: SlackStrings.labels.agent,
+			emoji: true
+		}
+	}];
+	if (isInThread) blocks.push({
+		type: "input",
+		block_id: "context_block",
+		element: {
+			type: "checkboxes",
+			action_id: "include_context_checkbox",
+			options: [{
+				text: {
+					type: "plain_text",
+					text: SlackStrings.visibility.includeThreadContext,
+					emoji: true
+				},
+				value: "include_context"
+			}],
+			initial_options: [{
+				text: {
+					type: "plain_text",
+					text: SlackStrings.visibility.includeThreadContext,
+					emoji: true
+				},
+				value: "include_context"
+			}]
+		},
+		label: {
+			type: "plain_text",
+			text: SlackStrings.labels.context,
+			emoji: true
+		},
+		optional: true
+	});
+	blocks.push({
+		type: "input",
+		block_id: "question_block",
+		element: {
+			type: "plain_text_input",
+			action_id: "question_input",
+			multiline: true,
+			placeholder: {
+				type: "plain_text",
+				text: isInThread ? SlackStrings.placeholders.additionalInstructionsOptional : SlackStrings.placeholders.enterPrompt
+			}
+		},
+		label: {
+			type: "plain_text",
+			text: isInThread ? SlackStrings.labels.additionalInstructions : SlackStrings.labels.prompt,
+			emoji: true
+		},
+		optional: isInThread
+	});
+	const dashboardUrl = `${metadata.tenantId ? `/${metadata.tenantId}` : ""}/work-apps/slack`;
+	blocks.push({
+		type: "context",
+		elements: [{
+			type: "mrkdwn",
+			text: `⚙️ <${manageUiBaseUrl}${dashboardUrl}|Open Dashboard>`
+		}]
+	});
+	return {
+		type: "modal",
+		callback_id: "agent_selector_modal",
+		private_metadata: JSON.stringify(metadata),
+		title: {
+			type: "plain_text",
+			text: isInThread ? SlackStrings.modals.triggerAgentThread : SlackStrings.modals.triggerAgent,
+			emoji: true
+		},
+		submit: {
+			type: "plain_text",
+			text: SlackStrings.buttons.triggerAgent,
+			emoji: true
+		},
+		close: {
+			type: "plain_text",
+			text: SlackStrings.buttons.cancel,
+			emoji: true
+		},
+		blocks
+	};
+}
+/**
+* Build a follow-up modal for continuing a conversation.
+*
+* Shows only a prompt input. Agent and project are carried from the previous turn
+* via metadata. The conversationId ensures the agent has full history.
+*/
+function buildFollowUpModal(metadata) {
+	const blocks = [{
+		type: "input",
+		block_id: "question_block",
+		element: {
+			type: "plain_text_input",
+			action_id: "question_input",
+			multiline: true,
+			placeholder: {
+				type: "plain_text",
+				text: SlackStrings.placeholders.enterPrompt
+			}
+		},
+		label: {
+			type: "plain_text",
+			text: SlackStrings.labels.prompt,
+			emoji: true
+		}
+	}];
+	return {
+		type: "modal",
+		callback_id: "follow_up_modal",
+		private_metadata: JSON.stringify(metadata),
+		title: {
+			type: "plain_text",
+			text: SlackStrings.modals.followUp,
+			emoji: true
+		},
+		submit: {
+			type: "plain_text",
+			text: SlackStrings.buttons.send,
+			emoji: true
+		},
+		close: {
+			type: "plain_text",
+			text: SlackStrings.buttons.cancel,
+			emoji: true
+		},
+		blocks
+	};
+}
+/**
+* Build the modal for message shortcut (context menu on a message).
+*
+* Shows:
+* - Message context (read-only display)
+* - Project dropdown
+* - Agent dropdown
+* - Additional instructions input
+* - Dashboard link
+*
+* All responses from this modal are private (ephemeral).
+*/
+function buildMessageShortcutModal(params) {
+	const { projects, agents, metadata, selectedProjectId, messageContext } = params;
+	const projectOptions = projects.map((project) => ({
+		text: {
+			type: "plain_text",
+			text: project.name,
+			emoji: true
+		},
+		value: project.id
+	}));
+	const agentOptions = agents.length > 0 ? agents.map((agent) => ({
+		text: {
+			type: "plain_text",
+			text: agent.name || agent.id,
+			emoji: true
+		},
+		value: JSON.stringify({
+			agentId: agent.id,
+			projectId: agent.projectId
+		})
+	})) : [{
+		text: {
+			type: "plain_text",
+			text: SlackStrings.status.noAgentsAvailable,
+			emoji: true
+		},
+		value: "none"
+	}];
+	const selectedProjectOption = selectedProjectId ? projectOptions.find((p) => p.value === selectedProjectId) : projectOptions[0];
+	const truncatedContext = messageContext.length > 500 ? `${messageContext.slice(0, 500)}...` : messageContext;
+	const blocks = [
+		{
+			type: "section",
+			block_id: "message_context_display",
+			text: {
+				type: "mrkdwn",
+				text: `*${SlackStrings.messageContext.label}*\n>${truncatedContext.split("\n").join("\n>")}`
+			}
+		},
+		{ type: "divider" },
+		{
+			type: "input",
+			block_id: "project_select_block",
+			dispatch_action: true,
+			element: {
+				type: "static_select",
+				action_id: "modal_project_select",
+				placeholder: {
+					type: "plain_text",
+					text: SlackStrings.placeholders.selectProject
+				},
+				options: projectOptions,
+				...selectedProjectOption ? { initial_option: selectedProjectOption } : {}
+			},
+			label: {
+				type: "plain_text",
+				text: SlackStrings.labels.project,
+				emoji: true
+			}
+		},
+		{
+			type: "input",
+			block_id: "agent_select_block",
+			element: {
+				type: "static_select",
+				action_id: "agent_select",
+				placeholder: {
+					type: "plain_text",
+					text: SlackStrings.placeholders.selectAgent
+				},
+				options: agentOptions,
+				...agents.length > 0 ? { initial_option: agentOptions[0] } : {}
+			},
+			label: {
+				type: "plain_text",
+				text: SlackStrings.labels.agent,
+				emoji: true
+			}
+		},
+		{
+			type: "input",
+			block_id: "question_block",
+			element: {
+				type: "plain_text_input",
+				action_id: "question_input",
+				multiline: true,
+				placeholder: {
+					type: "plain_text",
+					text: SlackStrings.placeholders.additionalInstructionsMessage
+				}
+			},
+			label: {
+				type: "plain_text",
+				text: SlackStrings.labels.additionalInstructions,
+				emoji: true
+			},
+			optional: true
+		}
+	];
+	const dashboardUrl = `${metadata.tenantId ? `/${metadata.tenantId}` : ""}/work-apps/slack`;
+	blocks.push({
+		type: "context",
+		elements: [{
+			type: "mrkdwn",
+			text: `⚙️ <${manageUiBaseUrl}${dashboardUrl}|Open Dashboard>`
+		}]
+	});
+	return {
+		type: "modal",
+		callback_id: "agent_selector_modal",
+		private_metadata: JSON.stringify(metadata),
+		title: {
+			type: "plain_text",
+			text: SlackStrings.modals.askAboutMessage,
+			emoji: true
+		},
+		submit: {
+			type: "plain_text",
+			text: SlackStrings.buttons.triggerAgent,
+			emoji: true
+		},
+		close: {
+			type: "plain_text",
+			text: SlackStrings.buttons.cancel,
+			emoji: true
+		},
+		blocks
+	};
+}
+
+//#endregion
+export { buildAgentSelectorModal, buildFollowUpModal, buildMessageShortcutModal };

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

@@ -0,0 +1,85 @@
+import { Nango } from "@nangohq/node";
+
+//#region src/slack/services/nango.d.ts
+
+declare function getSlackNango(): Nango;
+declare function getSlackIntegrationId(): string;
+declare function createConnectSession(params: {
+  userId: string;
+  userEmail?: string;
+  userName?: string;
+  tenantId: string;
+}): Promise<{
+  sessionToken: string;
+} | null>;
+declare function getConnectionAccessToken(connectionId: string): Promise<string | null>;
+interface DefaultAgentConfig {
+  agentId: string;
+  agentName?: string;
+  projectId: string;
+  projectName?: string;
+}
+interface SlackWorkspaceConnection {
+  connectionId: string;
+  teamId: string;
+  teamName?: string;
+  botToken: string;
+  tenantId: string;
+  defaultAgent?: DefaultAgentConfig;
+}
+/**
+ * Find a workspace connection by Slack team ID.
+ * Uses PostgreSQL first (O(1)) with in-memory caching, then falls back to Nango.
+ *
+ * Performance: This function is called on every @mention and command.
+ * The PostgreSQL-first approach with caching provides O(1) lookups.
+ */
+declare function findWorkspaceConnectionByTeamId(teamId: string): Promise<SlackWorkspaceConnection | null>;
+declare function clearWorkspaceConnectionCache(teamId?: string): void;
+declare function updateConnectionMetadata(connectionId: string, metadata: Record<string, string>): Promise<boolean>;
+declare function setWorkspaceDefaultAgent(teamId: string, defaultAgent: DefaultAgentConfig | null): Promise<boolean>;
+declare function getWorkspaceDefaultAgentFromNango(teamId: string): Promise<DefaultAgentConfig | null>;
+/**
+ * Compute a stable, deterministic connection ID for a Slack workspace.
+ * Format: "T:<team_id>" or "E:<enterprise_id>:T:<team_id>" for Enterprise Grid
+ */
+declare function computeWorkspaceConnectionId(params: {
+  teamId: string;
+  enterpriseId?: string;
+}): string;
+interface WorkspaceInstallData {
+  teamId: string;
+  teamName?: string;
+  teamDomain?: string;
+  enterpriseId?: string;
+  enterpriseName?: string;
+  botUserId?: string;
+  botToken: string;
+  botScopes?: string;
+  installerUserId?: string;
+  installerUserName?: string;
+  isEnterpriseInstall?: boolean;
+  appId?: string;
+  tenantId?: string;
+  workspaceUrl?: string;
+  workspaceIconUrl?: string;
+  installationSource?: string;
+}
+/**
+ * Store a workspace installation in Nango.
+ * Uses upsert semantics - will update if the connection already exists.
+ */
+declare function storeWorkspaceInstallation(data: WorkspaceInstallData): Promise<{
+  connectionId: string;
+  success: boolean;
+}>;
+/**
+ * List all workspace installations from Nango.
+ */
+declare function listWorkspaceInstallations(): Promise<SlackWorkspaceConnection[]>;
+/**
+ * Delete a workspace installation from Nango.
+ */
+declare function deleteWorkspaceInstallation(connectionId: string): Promise<boolean>;
+//#endregion
+export { DefaultAgentConfig, SlackWorkspaceConnection, WorkspaceInstallData, clearWorkspaceConnectionCache, computeWorkspaceConnectionId, createConnectSession, deleteWorkspaceInstallation, findWorkspaceConnectionByTeamId, getConnectionAccessToken, getSlackIntegrationId, getSlackNango, getWorkspaceDefaultAgentFromNango, listWorkspaceInstallations, setWorkspaceDefaultAgent, storeWorkspaceInstallation, updateConnectionMetadata };