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

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

@@ -1,556 +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 { resolveEffectiveAgent } from "../agent-resolution.js";
-import { createAgentListMessage, createAlreadyLinkedMessage, createErrorMessage, createJwtLinkMessage, createNotLinkedMessage, createSettingsMessage, createSettingsUpdatedMessage, createStatusMessage, createUnlinkSuccessMessage, createUpdatedHelpMessage } from "../blocks/index.js";
-import { deleteWorkAppSlackUserMapping, findWorkAppSlackUserMapping, findWorkAppSlackUserMappingBySlackUser, signSlackLinkToken, signSlackUserToken, upsertWorkAppSlackUserSettings } from "@inkeep/agents-core";
-
-//#region src/slack/services/commands/index.ts
-/**
-* Fetch all agents from the manage API.
-* This uses the proper ref-middleware and Dolt branch resolution.
-* Requires an auth token to access the manage API.
-*/
-async function fetchAgentsFromManageApi(tenantId, authToken) {
-	const apiBaseUrl = env.INKEEP_AGENTS_API_URL || "http://localhost:3002";
-	try {
-		const projectsResponse = await fetch(`${apiBaseUrl}/manage/tenants/${tenantId}/projects`, {
-			method: "GET",
-			headers: {
-				"Content-Type": "application/json",
-				Authorization: `Bearer ${authToken}`
-			}
-		});
-		if (!projectsResponse.ok) {
-			logger.error({
-				status: projectsResponse.status,
-				tenantId
-			}, "Failed to fetch projects from manage API");
-			return [];
-		}
-		const projectsData = await projectsResponse.json();
-		const projects = projectsData.data || projectsData || [];
-		logger.info({
-			projectCount: projects.length,
-			tenantId
-		}, "Fetched projects from manage API");
-		return (await Promise.all(projects.map(async (project) => {
-			try {
-				const agentsResponse = await fetch(`${apiBaseUrl}/manage/tenants/${tenantId}/projects/${project.id}/agents`, {
-					method: "GET",
-					headers: {
-						"Content-Type": "application/json",
-						Authorization: `Bearer ${authToken}`
-					}
-				});
-				if (agentsResponse.ok) {
-					const agentsData = await agentsResponse.json();
-					return (agentsData.data || agentsData || []).map((agent) => ({
-						id: agent.id,
-						name: agent.name,
-						projectId: project.id,
-						projectName: project.name
-					}));
-				}
-				return [];
-			} catch (error) {
-				logger.error({
-					error,
-					projectId: project.id
-				}, "Failed to fetch agents for project");
-				return [];
-			}
-		}))).flat();
-	} catch (error) {
-		logger.error({
-			error,
-			tenantId
-		}, "Failed to fetch agents from manage API");
-		return [];
-	}
-}
-/**
-* Find an agent by name or ID from the manage API.
-*/
-async function findAgentByIdentifier(tenantId, identifier, authToken) {
-	return (await fetchAgentsFromManageApi(tenantId, authToken)).find((a) => a.id === identifier || a.name?.toLowerCase() === identifier.toLowerCase()) || null;
-}
-const DEFAULT_CLIENT_ID = "work-apps-slack";
-const LINK_CODE_TTL_MINUTES = 10;
-const logger = getLogger("slack-commands");
-/**
-* Parse agent name and question from command text.
-* Agent name must be in quotes: "agent name" question
-*/
-function parseAgentAndQuestion(text) {
-	if (!text.trim()) return {
-		agentName: null,
-		question: null
-	};
-	const quotedMatch = text.match(/^["']([^"']+)["']\s+(.+)$/);
-	if (quotedMatch) return {
-		agentName: quotedMatch[1].trim(),
-		question: quotedMatch[2].trim()
-	};
-	return {
-		agentName: null,
-		question: null
-	};
-}
-async function handleLinkCommand(payload, dashboardUrl, tenantId) {
-	const existingLink = await findWorkAppSlackUserMapping(runDbClient_default)(tenantId, payload.userId, payload.teamId, DEFAULT_CLIENT_ID);
-	if (existingLink) return {
-		response_type: "ephemeral",
-		...createAlreadyLinkedMessage(existingLink.slackEmail || existingLink.slackUsername || "Unknown", existingLink.linkedAt, dashboardUrl)
-	};
-	try {
-		const linkToken = await signSlackLinkToken({
-			tenantId,
-			slackTeamId: payload.teamId,
-			slackUserId: payload.userId,
-			slackEnterpriseId: payload.enterpriseId,
-			slackUsername: payload.userName
-		});
-		const linkUrl = `${env.INKEEP_AGENTS_MANAGE_UI_URL || "http://localhost:3000"}/link?token=${encodeURIComponent(linkToken)}`;
-		logger.info({
-			slackUserId: payload.userId,
-			tenantId
-		}, "Generated JWT link token");
-		return {
-			response_type: "ephemeral",
-			...createJwtLinkMessage(linkUrl, LINK_CODE_TTL_MINUTES)
-		};
-	} catch (error) {
-		logger.error({
-			error,
-			slackUserId: payload.userId,
-			tenantId
-		}, "Failed to generate link token");
-		return {
-			response_type: "ephemeral",
-			...createErrorMessage("Failed to generate link. Please try again.")
-		};
-	}
-}
-async function handleUnlinkCommand(payload, tenantId) {
-	if (!await findWorkAppSlackUserMapping(runDbClient_default)(tenantId, payload.userId, payload.teamId, DEFAULT_CLIENT_ID)) return {
-		response_type: "ephemeral",
-		...createNotLinkedMessage()
-	};
-	try {
-		if (await deleteWorkAppSlackUserMapping(runDbClient_default)(tenantId, payload.userId, payload.teamId, DEFAULT_CLIENT_ID)) {
-			logger.info({
-				slackUserId: payload.userId,
-				tenantId
-			}, "User unlinked Slack account");
-			return {
-				response_type: "ephemeral",
-				...createUnlinkSuccessMessage()
-			};
-		}
-		return {
-			response_type: "ephemeral",
-			...createErrorMessage("Failed to unlink account. Please try again.")
-		};
-	} catch (error) {
-		logger.error({
-			error,
-			slackUserId: payload.userId,
-			tenantId
-		}, "Failed to unlink account");
-		return {
-			response_type: "ephemeral",
-			...createErrorMessage("Failed to unlink account. Please try again.")
-		};
-	}
-}
-async function handleStatusCommand(payload, dashboardUrl, tenantId) {
-	const existingLink = await findWorkAppSlackUserMapping(runDbClient_default)(tenantId, payload.userId, payload.teamId, DEFAULT_CLIENT_ID);
-	if (existingLink) {
-		const { getAgentConfigSources } = await import("../agent-resolution.js");
-		const agentConfigs = await getAgentConfigSources({
-			tenantId,
-			teamId: payload.teamId,
-			channelId: payload.channelId,
-			userId: payload.userId
-		});
-		return {
-			response_type: "ephemeral",
-			...createStatusMessage(existingLink.slackEmail || existingLink.slackUsername || payload.userName, existingLink.linkedAt, dashboardUrl, agentConfigs)
-		};
-	}
-	return {
-		response_type: "ephemeral",
-		...createNotLinkedMessage()
-	};
-}
-async function handleLogoutCommand(payload, tenantId) {
-	return handleUnlinkCommand(payload, tenantId);
-}
-async function handleHelpCommand() {
-	return {
-		response_type: "ephemeral",
-		...createUpdatedHelpMessage()
-	};
-}
-async function generateLinkCodeWithIntent(payload, tenantId) {
-	try {
-		const linkToken = await signSlackLinkToken({
-			tenantId,
-			slackTeamId: payload.teamId,
-			slackUserId: payload.userId,
-			slackEnterpriseId: payload.enterpriseId,
-			slackUsername: payload.userName
-		});
-		const linkUrl = `${env.INKEEP_AGENTS_MANAGE_UI_URL || "http://localhost:3000"}/link?token=${encodeURIComponent(linkToken)}`;
-		logger.info({
-			slackUserId: payload.userId,
-			tenantId
-		}, "Generated JWT link token with intent");
-		return {
-			response_type: "ephemeral",
-			...createJwtLinkMessage(linkUrl, LINK_CODE_TTL_MINUTES)
-		};
-	} catch (error) {
-		logger.error({
-			error,
-			slackUserId: payload.userId,
-			tenantId
-		}, "Failed to generate link token");
-		return {
-			response_type: "ephemeral",
-			...createErrorMessage("Failed to generate link. Please try again.")
-		};
-	}
-}
-async function handleQuestionCommand(payload, question, _dashboardUrl, tenantId) {
-	const existingLink = await findWorkAppSlackUserMappingBySlackUser(runDbClient_default)(payload.userId, payload.teamId, DEFAULT_CLIENT_ID);
-	if (!existingLink) return generateLinkCodeWithIntent(payload, tenantId);
-	const userTenantId = existingLink.tenantId;
-	const resolvedAgent = await resolveEffectiveAgent({
-		tenantId: userTenantId,
-		teamId: payload.teamId,
-		channelId: payload.channelId,
-		userId: payload.userId
-	});
-	if (!resolvedAgent) return {
-		response_type: "ephemeral",
-		...createErrorMessage("No default agent configured. Ask your admin to set a workspace default, or use `/inkeep settings set [agent]` to set your personal default.\n\nUse `/inkeep list` to see available agents.")
-	};
-	executeAgentInBackground(payload, existingLink, {
-		id: resolvedAgent.agentId,
-		name: resolvedAgent.agentName || null,
-		projectId: resolvedAgent.projectId
-	}, question, userTenantId).catch((error) => {
-		logger.error({ error }, "Background execution promise rejected");
-	});
-	return {};
-}
-async function executeAgentInBackground(payload, existingLink, targetAgent, question, tenantId) {
-	try {
-		const slackUserToken = await signSlackUserToken({
-			inkeepUserId: existingLink.inkeepUserId,
-			tenantId,
-			slackTeamId: payload.teamId,
-			slackUserId: payload.userId,
-			slackEnterpriseId: payload.enterpriseId
-		});
-		const apiBaseUrl = env.INKEEP_AGENTS_API_URL || "http://localhost:3002";
-		const response = await fetch(`${apiBaseUrl}/run/api/chat`, {
-			method: "POST",
-			headers: {
-				"Content-Type": "application/json",
-				Authorization: `Bearer ${slackUserToken}`,
-				"x-inkeep-project-id": targetAgent.projectId,
-				"x-inkeep-agent-id": targetAgent.id
-			},
-			body: JSON.stringify({
-				messages: [{
-					role: "user",
-					content: question
-				}],
-				stream: false
-			})
-		});
-		let responsePayload;
-		if (!response.ok) {
-			const errorText = await response.text();
-			logger.error({
-				status: response.status,
-				error: errorText,
-				agentId: targetAgent.id,
-				projectId: targetAgent.projectId
-			}, "Run API call failed");
-			responsePayload = {
-				response_type: "ephemeral",
-				text: `Failed to run agent: ${response.status} ${response.statusText}`
-			};
-		} else {
-			const result = await response.json();
-			const assistantMessage = result.choices?.[0]?.message?.content || result.message?.content || "No response received";
-			logger.info({
-				slackUserId: payload.userId,
-				agentId: targetAgent.id,
-				projectId: targetAgent.projectId,
-				tenantId
-			}, "Agent execution completed via Slack");
-			responsePayload = {
-				response_type: "ephemeral",
-				blocks: [{
-					type: "section",
-					text: {
-						type: "mrkdwn",
-						text: assistantMessage
-					}
-				}, {
-					type: "context",
-					elements: [{
-						type: "mrkdwn",
-						text: `Powered by *${targetAgent.name || targetAgent.id}* via Inkeep`
-					}]
-				}]
-			};
-		}
-		await fetch(payload.responseUrl, {
-			method: "POST",
-			headers: { "Content-Type": "application/json" },
-			body: JSON.stringify(responsePayload)
-		});
-	} catch (error) {
-		logger.error({
-			error,
-			slackUserId: payload.userId
-		}, "Background agent execution failed");
-		try {
-			await fetch(payload.responseUrl, {
-				method: "POST",
-				headers: { "Content-Type": "application/json" },
-				body: JSON.stringify({
-					response_type: "ephemeral",
-					text: "An error occurred while running the agent. Please try again."
-				})
-			});
-		} catch {
-			logger.error({ slackUserId: payload.userId }, "Failed to send error response to Slack");
-		}
-	}
-}
-async function handleRunCommand(payload, agentIdentifier, question, _dashboardUrl, tenantId) {
-	const existingLink = await findWorkAppSlackUserMappingBySlackUser(runDbClient_default)(payload.userId, payload.teamId, DEFAULT_CLIENT_ID);
-	if (!existingLink) return generateLinkCodeWithIntent(payload, tenantId);
-	const userTenantId = existingLink.tenantId;
-	try {
-		const targetAgent = await findAgentByIdentifier(userTenantId, agentIdentifier, await signSlackUserToken({
-			inkeepUserId: existingLink.inkeepUserId,
-			tenantId: userTenantId,
-			slackTeamId: payload.teamId,
-			slackUserId: payload.userId,
-			slackEnterpriseId: payload.enterpriseId
-		}));
-		if (!targetAgent) return {
-			response_type: "ephemeral",
-			...createErrorMessage(`Agent "${agentIdentifier}" not found. Use \`/inkeep list\` to see available agents.`)
-		};
-		executeAgentInBackground(payload, existingLink, targetAgent, question, userTenantId).catch((error) => {
-			logger.error({ error }, "Background execution promise rejected");
-		});
-		return {};
-	} catch (error) {
-		const errorMessage = error instanceof Error ? error.message : "Unknown error";
-		logger.error({
-			error: errorMessage,
-			tenantId: userTenantId
-		}, "Failed to run agent");
-		return {
-			response_type: "ephemeral",
-			...createErrorMessage("Failed to run agent. Please try again or visit the dashboard.")
-		};
-	}
-}
-async function handleSettingsCommand(payload, subCommand, agentIdentifier, dashboardUrl, _tenantId) {
-	const existingLink = await findWorkAppSlackUserMappingBySlackUser(runDbClient_default)(payload.userId, payload.teamId, DEFAULT_CLIENT_ID);
-	if (!existingLink) return {
-		response_type: "ephemeral",
-		...createNotLinkedMessage()
-	};
-	const userTenantId = existingLink.tenantId;
-	if (subCommand === "set" && agentIdentifier) try {
-		const targetAgent = await findAgentByIdentifier(userTenantId, agentIdentifier, await signSlackUserToken({
-			inkeepUserId: existingLink.inkeepUserId,
-			tenantId: userTenantId,
-			slackTeamId: payload.teamId,
-			slackUserId: payload.userId,
-			slackEnterpriseId: payload.enterpriseId
-		}));
-		if (!targetAgent) return {
-			response_type: "ephemeral",
-			...createErrorMessage(`Agent "${agentIdentifier}" not found. Use \`/inkeep list\` to see available agents.`)
-		};
-		await upsertWorkAppSlackUserSettings(runDbClient_default)({
-			tenantId: userTenantId,
-			slackTeamId: payload.teamId,
-			slackUserId: payload.userId,
-			defaultProjectId: targetAgent.projectId,
-			defaultAgentId: targetAgent.id,
-			defaultAgentName: targetAgent.name
-		});
-		logger.info({
-			slackUserId: payload.userId,
-			tenantId: userTenantId,
-			agentId: targetAgent.id,
-			agentName: targetAgent.name
-		}, "User set personal default agent");
-		return {
-			response_type: "ephemeral",
-			...createSettingsUpdatedMessage(targetAgent.name || targetAgent.id)
-		};
-	} catch (error) {
-		const errorMessage = error instanceof Error ? error.message : "Unknown error";
-		logger.error({
-			error: errorMessage,
-			tenantId: userTenantId
-		}, "Failed to update user settings");
-		return {
-			response_type: "ephemeral",
-			...createErrorMessage("Failed to update settings. Please try again.")
-		};
-	}
-	if (subCommand === "clear") try {
-		await upsertWorkAppSlackUserSettings(runDbClient_default)({
-			tenantId: userTenantId,
-			slackTeamId: payload.teamId,
-			slackUserId: payload.userId,
-			defaultProjectId: void 0,
-			defaultAgentId: void 0,
-			defaultAgentName: void 0
-		});
-		logger.info({
-			slackUserId: payload.userId,
-			tenantId: userTenantId
-		}, "User cleared personal default agent");
-		return {
-			response_type: "ephemeral",
-			blocks: [{
-				type: "section",
-				text: {
-					type: "mrkdwn",
-					text: "✅ *Personal default agent cleared*\n\nYou will now use the workspace or channel default."
-				}
-			}]
-		};
-	} catch (error) {
-		const errorMessage = error instanceof Error ? error.message : "Unknown error";
-		logger.error({
-			error: errorMessage,
-			tenantId: userTenantId
-		}, "Failed to clear user settings");
-		return {
-			response_type: "ephemeral",
-			...createErrorMessage("Failed to clear settings. Please try again.")
-		};
-	}
-	return {
-		response_type: "ephemeral",
-		...createSettingsMessage(await resolveEffectiveAgent({
-			tenantId: userTenantId,
-			teamId: payload.teamId,
-			channelId: payload.channelId,
-			userId: payload.userId
-		}), dashboardUrl)
-	};
-}
-async function handleAgentListCommand(payload, dashboardUrl, _tenantId) {
-	const existingLink = await findWorkAppSlackUserMappingBySlackUser(runDbClient_default)(payload.userId, payload.teamId, DEFAULT_CLIENT_ID);
-	if (!existingLink) return {
-		response_type: "ephemeral",
-		...createNotLinkedMessage()
-	};
-	const userTenantId = existingLink.tenantId;
-	logger.info({
-		slackUserId: payload.userId,
-		existingLinkTenantId: existingLink.tenantId,
-		existingLinkInkeepUserId: existingLink.inkeepUserId
-	}, "Found user mapping for list command");
-	try {
-		const allAgents = await fetchAgentsFromManageApi(userTenantId, await signSlackUserToken({
-			inkeepUserId: existingLink.inkeepUserId,
-			tenantId: userTenantId,
-			slackTeamId: payload.teamId,
-			slackUserId: payload.userId,
-			slackEnterpriseId: payload.enterpriseId
-		}));
-		logger.info({
-			slackUserId: payload.userId,
-			tenantId: userTenantId,
-			agentCount: allAgents.length
-		}, "Listed agents for linked Slack user");
-		if (allAgents.length === 0) return {
-			response_type: "ephemeral",
-			...createErrorMessage("No agents found. Create an agent in the Inkeep dashboard first.")
-		};
-		return {
-			response_type: "ephemeral",
-			...createAgentListMessage(allAgents, dashboardUrl.replace("/work-apps/slack", ""))
-		};
-	} catch (error) {
-		const errorMessage = error instanceof Error ? error.message : "Unknown error";
-		logger.error({
-			error: errorMessage,
-			tenantId: userTenantId
-		}, "Failed to list agents");
-		return {
-			response_type: "ephemeral",
-			...createErrorMessage("Failed to list agents. Please try again or visit the dashboard.")
-		};
-	}
-}
-async function handleCommand(payload) {
-	const text = payload.text.trim();
-	const parts = text.split(/\s+/);
-	const subcommand = parts[0]?.toLowerCase() || "";
-	const manageUiUrl = env.INKEEP_AGENTS_MANAGE_UI_URL || "http://localhost:3000";
-	const tenantId = (await findWorkspaceConnectionByTeamId(payload.teamId))?.tenantId || "default";
-	const dashboardUrl = `${manageUiUrl}/${tenantId}/work-apps/slack`;
-	logger.info({
-		command: payload.command,
-		subcommand,
-		slackUserId: payload.userId,
-		teamId: payload.teamId,
-		tenantId
-	}, "Slack command received");
-	switch (subcommand) {
-		case "link":
-		case "connect": return handleLinkCommand(payload, dashboardUrl, tenantId);
-		case "status": return handleStatusCommand(payload, dashboardUrl, tenantId);
-		case "unlink":
-		case "logout":
-		case "disconnect": return handleUnlinkCommand(payload, tenantId);
-		case "list": return handleAgentListCommand(payload, dashboardUrl, tenantId);
-		case "run": {
-			const parsed = parseAgentAndQuestion(text.slice(4).trim());
-			if (!parsed.agentName || !parsed.question) return {
-				response_type: "ephemeral",
-				...createErrorMessage("Usage: `/inkeep run \"agent name\" [question]`\n\nExample: `/inkeep run \"my agent\" What is the weather?`\n\nAgent name must be in quotes.")
-			};
-			return handleRunCommand(payload, parsed.agentName, parsed.question, dashboardUrl, tenantId);
-		}
-		case "settings": {
-			const settingsSubcommand = parts[1]?.toLowerCase();
-			let agentName;
-			if (settingsSubcommand === "set") {
-				const quotedMatch = text.match(/^settings\s+set\s+["']([^"']+)["']/i);
-				if (quotedMatch) agentName = quotedMatch[1].trim();
-			}
-			return handleSettingsCommand(payload, settingsSubcommand, agentName, dashboardUrl, tenantId);
-		}
-		case "help":
-		case "":
-			if (text === "" || text === "help") return handleHelpCommand();
-			return handleQuestionCommand(payload, text, dashboardUrl, tenantId);
-		default: return handleQuestionCommand(payload, text, dashboardUrl, tenantId);
-	}
-}
-
-//#endregion
-export { handleAgentListCommand, handleCommand, handleHelpCommand, handleLinkCommand, handleLogoutCommand, handleQuestionCommand, handleRunCommand, handleSettingsCommand, handleStatusCommand, handleUnlinkCommand };

package/dist/slack/services/events/app-mention.d.ts

@@ -1,41 +0,0 @@
-//#region src/slack/services/events/app-mention.d.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
- */
-/**
- * Metadata passed to the agent selector modal via button value
- */
-interface InlineSelectorMetadata {
-  channel: string;
-  threadTs: string;
-  messageTs: string;
-  teamId: string;
-  slackUserId: string;
-  tenantId: string;
-  threadMessageCount: number;
-}
-/**
- * Main handler for @mention events in Slack
- */
-declare function handleAppMention(params: {
-  slackUserId: string;
-  channel: string;
-  text: string;
-  threadTs: string;
-  messageTs: string;
-  teamId: string;
-  triggerId?: string;
-}): Promise<void>;
-//#endregion
-export { InlineSelectorMetadata, handleAppMention };