@inkeep/agents-work-apps 0.50.1 → 0.50.4

package/dist/slack/socket-mode.js

@@ -0,0 +1,130 @@
+import { __toESM } from "../_virtual/rolldown_runtime.js";
+import { getLogger } from "../logger.js";
+import { handleCommand } from "./services/commands/index.js";
+import { SLACK_SPAN_KEYS, SLACK_SPAN_NAMES, tracer } from "./tracer.js";
+import "./services/index.js";
+import { dispatchSlackEvent } from "./dispatcher.js";
+import { flushTraces } from "@inkeep/agents-core";
+import { SpanStatusCode } from "@opentelemetry/api";
+
+//#region src/slack/socket-mode.ts
+const logger = getLogger("slack-socket-mode");
+const GLOBAL_KEY = "__inkeep_slack_socket_mode_client__";
+async function startSocketMode(appToken) {
+	if (globalThis[GLOBAL_KEY]) {
+		logger.info({}, "Socket Mode client already running (HMR reload detected), skipping");
+		return;
+	}
+	const { SocketModeClient } = await import("../node_modules/.pnpm/@slack_socket-mode@2.0.5/node_modules/@slack/socket-mode/dist/src/index.js").then((m) => /* @__PURE__ */ __toESM(m.default, 1));
+	const client = new SocketModeClient({ appToken });
+	setupSocketModeListeners(client);
+	await client.start();
+	globalThis[GLOBAL_KEY] = client;
+	logger.info({}, "Slack Socket Mode client started");
+}
+function registerBackgroundWork(work) {
+	work.catch((err) => {
+		logger.error({ error: err }, "Background work failed in Socket Mode");
+	});
+}
+function setupSocketModeListeners(client) {
+	client.on("error", (...args) => {
+		logger.error({ error: args[0] }, "Socket Mode client error");
+	});
+	client.on("disconnected", () => {
+		logger.warn({}, "Socket Mode client disconnected");
+	});
+	client.on("reconnecting", () => {
+		logger.info({}, "Socket Mode client reconnecting...");
+	});
+	client.on("slack_event", async (...args) => {
+		const { ack, body, type } = args[0];
+		if (type !== "events_api") return;
+		await ack();
+		await tracer.startActiveSpan(SLACK_SPAN_NAMES.WEBHOOK, async (span) => {
+			try {
+				const eventType = body.event?.type ? "event_callback" : body.type || "";
+				span.setAttribute(SLACK_SPAN_KEYS.EVENT_TYPE, eventType);
+				span.updateName(`${SLACK_SPAN_NAMES.WEBHOOK} ${eventType}`);
+				await dispatchSlackEvent(eventType, body, { registerBackgroundWork }, span);
+			} catch (error) {
+				span.setAttribute(SLACK_SPAN_KEYS.OUTCOME, "error");
+				span.setStatus({
+					code: SpanStatusCode.ERROR,
+					message: String(error)
+				});
+				if (error instanceof Error) span.recordException(error);
+				logger.error({ error }, "Error handling Socket Mode event");
+			} finally {
+				span.end();
+				await flushTraces();
+			}
+		});
+	});
+	client.on("interactive", async (...args) => {
+		const { ack, body } = args[0];
+		const eventType = body.type || "";
+		await ack((await tracer.startActiveSpan(`${SLACK_SPAN_NAMES.WEBHOOK} ${eventType}`, async (span) => {
+			try {
+				span.setAttribute(SLACK_SPAN_KEYS.EVENT_TYPE, eventType);
+				return await dispatchSlackEvent(eventType, body, { registerBackgroundWork }, span);
+			} catch (error) {
+				span.setAttribute(SLACK_SPAN_KEYS.OUTCOME, "error");
+				span.setStatus({
+					code: SpanStatusCode.ERROR,
+					message: String(error)
+				});
+				if (error instanceof Error) span.recordException(error);
+				logger.error({ error }, "Error handling Socket Mode interactive event");
+				return { outcome: "error" };
+			} finally {
+				span.end();
+			}
+		})).response);
+		await flushTraces();
+	});
+	client.on("slash_commands", async (...args) => {
+		const { ack, body } = args[0];
+		await ack();
+		await tracer.startActiveSpan(`${SLACK_SPAN_NAMES.WEBHOOK} slash_command`, async (span) => {
+			try {
+				span.setAttribute(SLACK_SPAN_KEYS.EVENT_TYPE, "slash_command");
+				if (body.command) span.setAttribute("slack.command", body.command);
+				if (body.team_id) span.setAttribute(SLACK_SPAN_KEYS.TEAM_ID, body.team_id);
+				const commandPayload = {
+					command: body.command || "",
+					text: body.text || "",
+					userId: body.user_id || "",
+					userName: body.user_name || "",
+					teamId: body.team_id || "",
+					teamDomain: body.team_domain || "",
+					enterpriseId: body.enterprise_id,
+					channelId: body.channel_id || "",
+					channelName: body.channel_name || "",
+					responseUrl: body.response_url || "",
+					triggerId: body.trigger_id || ""
+				};
+				const response = await handleCommand(commandPayload);
+				if (Object.keys(response).length > 0 && commandPayload.responseUrl) await fetch(commandPayload.responseUrl, {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify(response)
+				});
+			} catch (error) {
+				span.setAttribute(SLACK_SPAN_KEYS.OUTCOME, "error");
+				span.setStatus({
+					code: SpanStatusCode.ERROR,
+					message: String(error)
+				});
+				if (error instanceof Error) span.recordException(error);
+				logger.error({ error }, "Error handling Socket Mode slash command");
+			} finally {
+				span.end();
+				await flushTraces();
+			}
+		});
+	});
+}
+
+//#endregion
+export { startSocketMode };

package/dist/slack/tracer.d.ts

@@ -36,6 +36,8 @@ declare const SLACK_SPAN_KEYS: {
   readonly IS_IN_THREAD: "slack.is_in_thread";
   readonly STREAM_FINALIZATION_FAILED: "slack.stream_finalization_failed";
   readonly CONTENT_ALREADY_DELIVERED: "slack.content_already_delivered";
+  readonly AUTHORIZED: "slack.authorized";
+  readonly AUTH_SOURCE: "slack.auth_source";
 };
 type SlackOutcome = 'handled' | 'ignored_bot_message' | 'ignored_unknown_event' | 'ignored_no_action_match' | 'ignored_slack_retry' | 'url_verification' | 'validation_error' | 'signature_invalid' | 'error';
 //#endregion

package/dist/slack/tracer.js

@@ -34,7 +34,9 @@ const SLACK_SPAN_KEYS = {
 	HAS_QUERY: "slack.has_query",
 	IS_IN_THREAD: "slack.is_in_thread",
 	STREAM_FINALIZATION_FAILED: "slack.stream_finalization_failed",
-	CONTENT_ALREADY_DELIVERED: "slack.content_already_delivered"
+	CONTENT_ALREADY_DELIVERED: "slack.content_already_delivered",
+	AUTHORIZED: "slack.authorized",
+	AUTH_SOURCE: "slack.auth_source"
 };
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-work-apps",
-  "version": "0.50.1",
+  "version": "0.50.4",
   "description": "First party integrations for Inkeep Agents",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -33,13 +33,14 @@
     "jose": "^6.1.0",
     "minimatch": "^10.1.1",
     "slack-block-builder": "^2.8.0",
-    "@inkeep/agents-core": "0.50.1"
+    "@inkeep/agents-core": "0.50.4"
   },
   "peerDependencies": {
     "@hono/zod-openapi": "^1.1.5",
     "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@slack/socket-mode": "^2.0.5",
     "@types/node": "^20.11.24",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4"