@cursor/bdk 0.2.1

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

@@ -0,0 +1,53 @@
+/**
+ * Slack platform channel pack for agent-serve.
+ *
+ * ```ts
+ * import { slackChannel } from "@cursor/bdk/channels/slack";
+ *
+ * // Single agent: SLACK_BOT_TOKEN + SLACK_APP_TOKEN
+ * export default slackChannel();
+ *
+ * // Multi-agent serve: one Slack app per agent
+ * export default slackChannel({ envPrefix: "MY_AGENT" });
+ * // → MY_AGENT_SLACK_BOT_TOKEN + MY_AGENT_SLACK_APP_TOKEN
+ * ```
+ */
+export { dashboardSessionUrl } from "../../dashboard-session-url.js";
+export * from "./api.js";
+export * from "./approvals.js";
+export * from "./assistant.js";
+export * from "./attachments.js";
+export * from "./auth.js";
+export * from "./blocks.js";
+export * from "./bot-mentions.js";
+export * from "./channel-watch.js";
+export * from "./code-fences.js";
+export * from "./constants.js";
+export * from "./credentials.js";
+export * from "./defaults.js";
+export * from "./dispatch.js";
+export * from "./doctor.js";
+export * from "./eval-directive.js";
+export * from "./event-id-dedupe.js";
+export * from "./external-policy.js";
+export * from "./footer.js";
+export * from "./inbound.js";
+export * from "./init.js";
+export * from "./interactive.js";
+export * from "./links.js";
+export * from "./log.js";
+export * from "./manifest.js";
+export * from "./message-body.js";
+export * from "./nudge-carrier.js";
+export * from "./nudge-store.js";
+export * from "./pr-ref.js";
+export * from "./setup.js";
+export * from "./slack-channel.js";
+export * from "./socket-mode.js";
+export * from "./stop.js";
+export * from "./stream.js";
+export * from "./thread-context.js";
+export * from "./tool-approval-events.js";
+export { defaultToolCardDetails } from "./tool-cards.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/channels/slack/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,cAAc,YAAY,CAAC"}

package/dist/channels/slack/index.js

@@ -0,0 +1,52 @@
+/**
+ * Slack platform channel pack for agent-serve.
+ *
+ * ```ts
+ * import { slackChannel } from "@cursor/bdk/channels/slack";
+ *
+ * // Single agent: SLACK_BOT_TOKEN + SLACK_APP_TOKEN
+ * export default slackChannel();
+ *
+ * // Multi-agent serve: one Slack app per agent
+ * export default slackChannel({ envPrefix: "MY_AGENT" });
+ * // → MY_AGENT_SLACK_BOT_TOKEN + MY_AGENT_SLACK_APP_TOKEN
+ * ```
+ */
+export { dashboardSessionUrl } from "../../dashboard-session-url.js";
+export * from "./api.js";
+export * from "./approvals.js";
+export * from "./assistant.js";
+export * from "./attachments.js";
+export * from "./auth.js";
+export * from "./blocks.js";
+export * from "./bot-mentions.js";
+export * from "./channel-watch.js";
+export * from "./code-fences.js";
+export * from "./constants.js";
+export * from "./credentials.js";
+export * from "./defaults.js";
+export * from "./dispatch.js";
+export * from "./doctor.js";
+export * from "./eval-directive.js";
+export * from "./event-id-dedupe.js";
+export * from "./external-policy.js";
+export * from "./footer.js";
+export * from "./inbound.js";
+export * from "./init.js";
+export * from "./interactive.js";
+export * from "./links.js";
+export * from "./log.js";
+export * from "./manifest.js";
+export * from "./message-body.js";
+export * from "./nudge-carrier.js";
+export * from "./nudge-store.js";
+export * from "./pr-ref.js";
+export * from "./setup.js";
+export * from "./slack-channel.js";
+export * from "./socket-mode.js";
+export * from "./stop.js";
+export * from "./stream.js";
+export * from "./thread-context.js";
+export * from "./tool-approval-events.js";
+export { defaultToolCardDetails } from "./tool-cards.js";
+export * from "./types.js";

package/dist/channels/slack/init.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Scaffold a Slack channel into an agent-serve project.
+ *
+ * `initSlackChannel` is the create-safe channel writer.
+ * only. DIY manifests + Slack CLI `.slack/` live in
+ * {@link initSlackManual} so `slack create` cannot reach them.
+ */
+export interface InitSlackOptions {
+    dir: string;
+    /** Display name for the Slack app. Defaults to directory basename. */
+    name?: string;
+    /**
+     * Env prefix for tokens (`MY_AGENT` → `MY_AGENT_SLACK_BOT_TOKEN`). Defaults to
+     * the directory basename so multi-agent serve can mount several Slack bots.
+     * Pass `""` to use the shared `SLACK_BOT_TOKEN` / `SLACK_APP_TOKEN` globals.
+     */
+    envPrefix?: string;
+}
+export interface InitSlackManualOptions extends InitSlackOptions {
+    description?: string;
+    /**
+     * Subscribe the generated manifests to `message.channels` +
+     * `message.groups` for the opt-in channel watch
+     * (`engagement.channelPosts` on `slackChannel`).
+     */
+    channelPosts?: boolean;
+}
+export interface InitSlackResult {
+    rootDir: string;
+    files: string[];
+    envPrefix: string | undefined;
+    envKeys: {
+        bot: string;
+        app: string;
+    };
+}
+/** Create-safe: write only the authored Slack channel. */
+export declare function initSlackChannel(options: InitSlackOptions): Promise<InitSlackResult>;
+/**
+ * `slack init --manual`: channel file plus DIY manifests
+ * (`managedByCursor: false`), Slack CLI `.slack/` project, env.example,
+ * and setup-status.json.
+ */
+export declare function initSlackManual(options: InitSlackManualOptions): Promise<InitSlackResult>;
+//# sourceMappingURL=init.d.ts.map

package/dist/channels/slack/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/init.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AA2DD,0DAA0D;AAC1D,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAU1F;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC,CA+C/F"}

package/dist/channels/slack/init.js

@@ -0,0 +1,126 @@
+/**
+ * Scaffold a Slack channel into an agent-serve project.
+ *
+ * `initSlackChannel` is the create-safe channel writer.
+ * only. DIY manifests + Slack CLI `.slack/` live in
+ * {@link initSlackManual} so `slack create` cannot reach them.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { mkdir, writeFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { CLI_COMMAND_NAME as CLI, PACKAGE_NAME } from "../../internal/distribution.js";
+import { projectPath, resolveProjectRoot } from "../../internal/project-layout.js";
+import { writeSlackCliProject } from "./cli-project.js";
+import { envPrefixFromName, slackEnvKeys } from "./credentials.js";
+import { buildSlackManifestPair, slackManifestFileEntries } from "./manifest.js";
+import { initialSlackSetupStatus } from "./setup.js";
+function resolveSlackInitTarget(options) {
+    var _a, _b;
+    const rootDir = resolve(options.dir);
+    const envPrefix = options.envPrefix === ""
+        ? undefined
+        : ((_a = options.envPrefix) !== null && _a !== void 0 ? _a : envPrefixFromName(basename(rootDir)));
+    return {
+        rootDir,
+        name: (_b = options.name) !== null && _b !== void 0 ? _b : basename(rootDir),
+        envPrefix,
+        envKeys: slackEnvKeys(envPrefix),
+    };
+}
+function writeExclusive(rootDir, rel, contents) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const abs = join(rootDir, rel);
+        yield mkdir(join(abs, ".."), { recursive: true });
+        yield writeFile(abs, contents, { flag: "wx" });
+    });
+}
+function slackChannelSource(target, kind) {
+    const envPrefixLine = target.envPrefix === undefined ? "" : `  envPrefix: ${JSON.stringify(target.envPrefix)},\n`;
+    const tokenLines = kind === "manual"
+        ? ` * Tokens: ${target.envKeys.bot} + ${target.envKeys.app}\n * (see .agent-serve/slack/env.example).`
+        : ` * Tokens: ${target.envKeys.bot} + ${target.envKeys.app}`;
+    const setupLine = kind === "manual"
+        ? ` * Full setup: ${CLI} slack setup`
+        : ` * Full setup: ${CLI} slack create --dir .`;
+    return `import { slackChannel } from "${PACKAGE_NAME}/channels/slack";
+
+/**
+ * Slack channel (Socket Mode).
+ *
+${tokenLines}
+ *
+${setupLine}
+ */
+export default slackChannel({
+${envPrefixLine}  // Streaming and thinking steps default to true.
+  suggestedPrompts: [
+    { title: "Help", message: "How can you help me?" },
+    { title: "Status", message: "What are you working on?" },
+  ],
+});
+`;
+}
+/** Create-safe: write only the authored Slack channel. */
+export function initSlackChannel(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const target = resolveSlackInitTarget(options);
+        const channelPath = projectPath(resolveProjectRoot(target.rootDir), "channels/slack.ts");
+        yield writeExclusive(target.rootDir, channelPath, slackChannelSource(target, "create"));
+        return {
+            rootDir: target.rootDir,
+            files: [channelPath],
+            envPrefix: target.envPrefix,
+            envKeys: target.envKeys,
+        };
+    });
+}
+/**
+ * `slack init --manual`: channel file plus DIY manifests
+ * (`managedByCursor: false`), Slack CLI `.slack/` project, env.example,
+ * and setup-status.json.
+ */
+export function initSlackManual(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const target = resolveSlackInitTarget(options);
+        const channelPath = projectPath(resolveProjectRoot(target.rootDir), "channels/slack.ts");
+        const files = [];
+        const write = (rel, contents) => __awaiter(this, void 0, void 0, function* () {
+            yield writeExclusive(target.rootDir, rel, contents);
+            files.push(rel);
+        });
+        yield write(channelPath, slackChannelSource(target, "manual"));
+        const pair = buildSlackManifestPair({
+            name: target.name,
+            managedByCursor: false,
+            description: options.description,
+            channelPosts: options.channelPosts,
+        });
+        yield write(".agent-serve/slack/env.example", `# Copy to .env.local (or export in your shell). Use the *dev* Slack app
+# for local development; use the Prod app tokens in deployment secrets.
+#
+# Multi-agent serve needs a distinct Slack app (and token pair) per agent.
+
+${target.envKeys.bot}=xoxb-...
+${target.envKeys.app}=xapp-...
+`);
+        yield write(".agent-serve/slack/setup-status.json", `${JSON.stringify(initialSlackSetupStatus({
+            envPrefix: target.envPrefix,
+            envKeys: target.envKeys,
+        }), null, 2)}\n`);
+        files.push(...(yield writeSlackCliProject(target.rootDir, slackManifestFileEntries(pair))));
+        return {
+            rootDir: target.rootDir,
+            files,
+            envPrefix: target.envPrefix,
+            envKeys: target.envKeys,
+        };
+    });
+}

package/dist/channels/slack/interactive.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Socket Mode interactive payloads (Block Kit clicks).
+ *
+ * Built-in tool-approval Approve/Deny actions resolve parked calls
+ * ({@link dispatchInteractiveFromPayload}); everything else can be routed
+ * to an author handler ({@link dispatchBlockAction} via
+ * `slackChannel({ onBlockAction })`).
+ */
+import type { ContinuationIdentity } from "../../internal/continuation-identity.js";
+import type { ApprovalDecision, ArtifactsApi, AuthContext, ChannelSession, HostContext, PendingApproval, PendingAuth, SendMessageFn } from "../../types.js";
+import { type SlackLog } from "./log.js";
+import type { SlackBlockAction, SlackBlockActionHandler, SlackBotToken, SlackContinuationProbes, SlackCredentials } from "./types.js";
+export interface SlackInteractiveDispatchDeps {
+    credentials: SlackCredentials | undefined;
+    getSession: (sessionId: string) => Promise<ChannelSession | null>;
+    resolveApproval: (sessionId: string, callId: string, decision: ApprovalDecision, auth: AuthContext | null) => Promise<PendingApproval>;
+    resolveAuth: (sessionId: string, callId: string, decision: ApprovalDecision, auth: AuthContext | null) => Promise<PendingAuth>;
+    waitUntil: (promise: Promise<unknown>) => void;
+    log?: SlackLog;
+    /** Defaults to true. */
+    blockExternals?: boolean;
+}
+/**
+ * Handle a Socket Mode `interactive` body. Returns true when this was
+ * an agent-serve approval action (handled or rejected with a reason).
+ */
+export declare function dispatchInteractiveFromPayload(payload: unknown, deps: SlackInteractiveDispatchDeps): Promise<boolean>;
+/**
+ * Parse a Socket Mode `block_actions` payload into a {@link SlackBlockAction}.
+ * Returns null for non-`block_actions` payloads (view submissions, shortcuts)
+ * and malformed bodies.
+ */
+export declare function parseSlackBlockAction(payload: unknown): SlackBlockAction | null;
+/**
+ * Swap the clicked message's actions row for a context note (`chat.update`).
+ * Strips only the row the click came from (`action.blockId`); every other
+ * block survives. Soft: false when the payload carried no message blocks or
+ * the update failed — callers treat the dispatched turn as the durable
+ * record and the card as best-effort UI.
+ */
+export declare function resolveBlockActionCard(args: {
+    botToken: SlackBotToken | undefined;
+    action: SlackBlockAction;
+    note: string;
+}): Promise<boolean>;
+export interface SlackBlockActionDispatchDeps extends SlackContinuationProbes {
+    handler: SlackBlockActionHandler;
+    send: SendMessageFn;
+    continuation?: ContinuationIdentity;
+    credentials: SlackCredentials | undefined;
+    host: HostContext;
+    artifacts: ArtifactsApi;
+    log?: SlackLog;
+    /** Defaults to true. */
+    blockExternals?: boolean;
+    /** Install workspace from `auth.test`; baseline for the external gate. */
+    installTeamId?: string;
+}
+/**
+ * Route a non-approval `block_actions` payload to the author handler and
+ * dispatch its decision as a turn on the click's thread. Returns true when
+ * the payload was a block action (dispatched or deliberately skipped).
+ */
+export declare function dispatchBlockAction(payload: unknown, deps: SlackBlockActionDispatchDeps): Promise<boolean>;
+//# sourceMappingURL=interactive.d.ts.map

package/dist/channels/slack/interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/interactive.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAEpF,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,eAAe,EACf,WAAW,EACX,aAAa,EACd,MAAM,gBAAgB,CAAC;AAUxB,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC1C,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAClE,eAAe,EAAE,CACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,WAAW,GAAG,IAAI,KACrB,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9B,WAAW,EAAE,CACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,WAAW,GAAG,IAAI,KACrB,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1B,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAC/C,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,wBAAwB;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,4BAA4B,GACjC,OAAO,CAAC,OAAO,CAAC,CAmHlB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAiF/E;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,MAAM,EAAE,gBAAgB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBnB;AAED,MAAM,WAAW,4BAA6B,SAAQ,uBAAuB;IAC3E,OAAO,EAAE,uBAAuB,CAAC;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,WAAW,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC1C,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,YAAY,CAAC;IACxB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,wBAAwB;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA4BD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,4BAA4B,GACjC,OAAO,CAAC,OAAO,CAAC,CAkDlB"}

package/dist/channels/slack/interactive.js

@@ -0,0 +1,310 @@
+/**
+ * Socket Mode interactive payloads (Block Kit clicks).
+ *
+ * Built-in tool-approval Approve/Deny actions resolve parked calls
+ * ({@link dispatchInteractiveFromPayload}); everything else can be routed
+ * to an author handler ({@link dispatchBlockAction} via
+ * `slackChannel({ onBlockAction })`).
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { isSlackImChannel } from "../../internal/slack-thread-key.js";
+import { updateMessage } from "./api.js";
+import { decisionFromActionId, decisionFromAuthActionId, parseApprovalActionValue, } from "./approvals.js";
+import { buildSlackInteractiveApprovalAuth } from "./auth.js";
+import { dispatchInboundMessage } from "./dispatch.js";
+import { isExternalSlackSender } from "./external-policy.js";
+import { defaultSlackLog } from "./log.js";
+/**
+ * Handle a Socket Mode `interactive` body. Returns true when this was
+ * an agent-serve approval action (handled or rejected with a reason).
+ */
+export function dispatchInteractiveFromPayload(payload, deps) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        var _c, _d, _e, _f;
+        const log = (_c = deps.log) !== null && _c !== void 0 ? _c : defaultSlackLog;
+        const parsed = parseSlackBlockAction(payload);
+        if (parsed === null) {
+            return false;
+        }
+        const approvalDecision = decisionFromActionId(parsed.actionId);
+        const authDecision = decisionFromAuthActionId(parsed.actionId);
+        const value = parseApprovalActionValue(parsed.value);
+        if (value === null || (approvalDecision === null && authDecision === null)) {
+            return false;
+        }
+        const decision = approvalDecision !== null && approvalDecision !== void 0 ? approvalDecision : authDecision;
+        if (decision === null) {
+            return false;
+        }
+        const kind = approvalDecision !== null ? "approval" : "auth";
+        log.info("interactive approval", {
+            decision,
+            session: value.sessionId,
+            call_id: value.callId,
+            user: parsed.userId,
+            channel: parsed.channelId,
+        });
+        const session = yield deps.getSession(value.sessionId);
+        if (session === null) {
+            log.warn("interactive approval: unknown session", {
+                session: value.sessionId,
+            });
+            return true;
+        }
+        const attrs = (_d = (_a = session.info.auth) === null || _a === void 0 ? void 0 : _a.attributes) !== null && _d !== void 0 ? _d : {};
+        const sessionChannel = (_e = attrs.channel_id) !== null && _e !== void 0 ? _e : "";
+        const sessionThread = (_f = attrs.thread_ts) !== null && _f !== void 0 ? _f : "";
+        if (sessionChannel !== "" && parsed.channelId !== "" && sessionChannel !== parsed.channelId) {
+            log.warn("interactive approval: channel mismatch", {
+                session: value.sessionId,
+                expected: sessionChannel,
+                got: parsed.channelId,
+            });
+            return true;
+        }
+        if (!isSlackImChannel(parsed.channelId) &&
+            sessionThread !== "" &&
+            parsed.threadTs !== "" &&
+            sessionThread !== parsed.threadTs) {
+            log.warn("interactive approval: thread mismatch", {
+                session: value.sessionId,
+                expected: sessionThread,
+                got: parsed.threadTs,
+            });
+            return true;
+        }
+        const sessionAuth = session.info.auth;
+        if (sessionAuth === undefined || sessionAuth === null) {
+            log.warn("interactive approval: session has no auth", {
+                session: value.sessionId,
+            });
+            return true;
+        }
+        const teamId = attrs.team_id;
+        if (deps.blockExternals !== false && parsed.userId !== "") {
+            if (teamId === undefined || teamId === "") {
+                log.info("interactive approval dropped (missing team)", {
+                    session: value.sessionId,
+                    user: parsed.userId,
+                });
+                return true;
+            }
+            if (yield isExternalSlackSender({
+                botToken: (_b = deps.credentials) === null || _b === void 0 ? void 0 : _b.botToken,
+                slackTeamId: teamId,
+                userId: parsed.userId,
+            })) {
+                log.info("interactive approval dropped (external sender)", {
+                    session: value.sessionId,
+                    user: parsed.userId,
+                    team: teamId,
+                });
+                return true;
+            }
+        }
+        const clickingAuth = buildSlackInteractiveApprovalAuth({
+            sessionAuth,
+            channelId: parsed.channelId || sessionChannel,
+            threadTs: parsed.threadTs || sessionThread,
+            teamId: teamId === undefined || teamId === "" ? undefined : teamId,
+            clickingUserId: parsed.userId,
+        });
+        try {
+            if (kind === "auth") {
+                yield deps.resolveAuth(value.sessionId, value.callId, decision, clickingAuth);
+            }
+            else {
+                yield deps.resolveApproval(value.sessionId, value.callId, decision, clickingAuth);
+            }
+        }
+        catch (error) {
+            log.warn("interactive approval resolve failed", {
+                session: value.sessionId,
+                call_id: value.callId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        return true;
+    });
+}
+/**
+ * Parse a Socket Mode `block_actions` payload into a {@link SlackBlockAction}.
+ * Returns null for non-`block_actions` payloads (view submissions, shortcuts)
+ * and malformed bodies.
+ */
+export function parseSlackBlockAction(payload) {
+    if (typeof payload !== "object" || payload === null) {
+        return null;
+    }
+    const record = payload;
+    if (record.type !== "block_actions") {
+        return null;
+    }
+    const actions = record.actions;
+    if (!Array.isArray(actions) || actions.length === 0) {
+        return null;
+    }
+    const first = actions[0];
+    if (typeof first !== "object" || first === null) {
+        return null;
+    }
+    const action = first;
+    if (typeof action.action_id !== "string") {
+        return null;
+    }
+    const channel = typeof record.channel === "object" && record.channel !== null
+        ? record.channel
+        : {};
+    const message = typeof record.message === "object" && record.message !== null
+        ? record.message
+        : {};
+    const user = typeof record.user === "object" && record.user !== null
+        ? record.user
+        : {};
+    const team = typeof record.team === "object" && record.team !== null
+        ? record.team
+        : {};
+    const channelId = typeof channel.id === "string" ? channel.id : "";
+    const messageTs = typeof message.ts === "string" ? message.ts : "";
+    const threadTs = typeof message.thread_ts === "string"
+        ? message.thread_ts
+        : typeof record.container === "object" &&
+            record.container !== null &&
+            typeof record.container.thread_ts === "string"
+            ? record.container.thread_ts
+            : messageTs;
+    const userId = typeof user.id === "string" ? user.id : "";
+    const userName = typeof user.username === "string"
+        ? user.username
+        : typeof user.name === "string"
+            ? user.name
+            : undefined;
+    // Payload `team.id` only — never `user.team_id` (Connect home team).
+    // Membership gates must baseline the install workspace separately.
+    const teamId = typeof team.id === "string" ? team.id : undefined;
+    const label = typeof action.text === "object" &&
+        action.text !== null &&
+        typeof action.text.text === "string"
+        ? action.text.text
+        : undefined;
+    const actionTs = typeof action.action_ts === "string" ? action.action_ts : "";
+    const messageBlocks = Array.isArray(message.blocks) ? message.blocks : undefined;
+    return {
+        actionId: action.action_id,
+        blockId: typeof action.block_id === "string" ? action.block_id : "",
+        value: typeof action.value === "string" ? action.value : "",
+        label,
+        channelId,
+        threadTs,
+        messageTs,
+        messageBlocks,
+        userId,
+        userName,
+        teamId,
+        actionTs,
+    };
+}
+/**
+ * Swap the clicked message's actions row for a context note (`chat.update`).
+ * Strips only the row the click came from (`action.blockId`); every other
+ * block survives. Soft: false when the payload carried no message blocks or
+ * the update failed — callers treat the dispatched turn as the durable
+ * record and the card as best-effort UI.
+ */
+export function resolveBlockActionCard(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { action, note } = args;
+        if (action.messageBlocks === undefined) {
+            return false;
+        }
+        const clicked = (block) => typeof block === "object" &&
+            block !== null &&
+            block.type === "actions" &&
+            block.block_id === action.blockId;
+        const result = yield updateMessage({
+            botToken: args.botToken,
+            channel: action.channelId,
+            ts: action.messageTs,
+            text: note,
+            blocks: [
+                ...action.messageBlocks.filter(block => !clicked(block)),
+                { type: "context", elements: [{ type: "mrkdwn", text: note }] },
+            ],
+        });
+        return result.ok;
+    });
+}
+/**
+ * The click as an inbound-message stand-in: the synthetic ts is the click's
+ * `action_ts` (unique per click, never a real thread message), so ask-dedupe
+ * claims and `<slack_thread>` exclusions stay per-click.
+ */
+function blockActionAsMessage(action, installTeamId) {
+    var _a;
+    const text = `[clicked: ${(_a = action.label) !== null && _a !== void 0 ? _a : action.actionId}]`;
+    return {
+        text,
+        body: text,
+        markdown: text,
+        ts: action.actionTs,
+        threadTs: action.threadTs,
+        channelId: action.channelId,
+        teamId: installTeamId,
+        author: {
+            userId: action.userId,
+            userName: action.userName,
+            isBot: false,
+        },
+    };
+}
+/**
+ * Route a non-approval `block_actions` payload to the author handler and
+ * dispatch its decision as a turn on the click's thread. Returns true when
+ * the payload was a block action (dispatched or deliberately skipped).
+ */
+export function dispatchBlockAction(payload, deps) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const log = (_a = deps.log) !== null && _a !== void 0 ? _a : defaultSlackLog;
+        const action = parseSlackBlockAction(payload);
+        if (action === null) {
+            return false;
+        }
+        if (action.channelId === "" || action.threadTs === "") {
+            log.warn("block action skipped (no conversation)", {
+                action_id: action.actionId,
+                user: action.userId,
+            });
+            return true;
+        }
+        // Slack stamps every real click; without one the synthetic message ts
+        // would alias another click's dedupe claim.
+        if (action.actionTs === "") {
+            log.warn("block action skipped (no action_ts)", {
+                action_id: action.actionId,
+                user: action.userId,
+            });
+            return true;
+        }
+        log.info("block action", {
+            action_id: action.actionId,
+            channel: action.channelId,
+            thread_ts: action.threadTs,
+            message_ts: action.messageTs,
+            user: action.userId,
+        });
+        yield dispatchInboundMessage(Object.assign({ kind: "block_action", message: blockActionAsMessage(action, deps.installTeamId), handler: ctx => deps.handler(ctx, action), send: deps.send, credentials: deps.credentials, host: deps.host, artifacts: deps.artifacts, log, 
+            // Click text is synthetic — never treat it as a stop/eval directive.
+            evalCommandsEnabled: false, blockExternals: deps.blockExternals, hasContinuationSession: deps.hasContinuationSession, isContinuationBusy: deps.isContinuationBusy, getContinuationLastBotMessageTs: deps.getContinuationLastBotMessageTs, interruptContinuation: deps.interruptContinuation }, (deps.continuation === undefined ? {} : { continuation: deps.continuation })));
+        return true;
+    });
+}