@cursor/july 0.1.16 → 0.1.18

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,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,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,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,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,cAAc,YAAY,CAAC"}

package/dist/channels/slack/index.js

@@ -21,6 +21,7 @@ export * from "./api.js";
 export * from "./approvals.js";
 export * from "./assistant.js";
 export * from "./auth.js";
+export * from "./blocks.js";
 export * from "./channel-watch.js";
 export * from "./constants.js";
 export * from "./credentials.js";
@@ -36,6 +37,7 @@ 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";

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;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;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CA+F1B"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;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;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAkG1B"}

package/dist/channels/slack/init.js

@@ -51,7 +51,10 @@ ${envPrefixLine}  // Streaming and thinking steps default to true.
   ],
 });
 `);
-        const pair = buildSlackManifestPair(Object.assign(Object.assign({ name }, (options.description === undefined
+        const pair = buildSlackManifestPair(Object.assign(Object.assign({ name, 
+            // Scaffolded for hand-import at api.slack.com; managed_app_settings is
+            // settable only with the manager app's user token.
+            managedByCursor: false }, (options.description === undefined
             ? {}
             : { description: options.description })), (options.channelPosts === true ? { channelPosts: true } : {})));
         yield write(".agent-serve/slack/manifest.dev.json", `${JSON.stringify(pair.dev, null, 2)}\n`);

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

@@ -1,9 +1,14 @@
 /**
- * Socket Mode interactive payloads (Block Kit Approve/Deny).
+ * 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 { ApprovalDecision, AuthContext, ChannelSession, PendingApproval } from "../../types.js";
+import type { ApprovalDecision, AuthContext, ChannelSession, HostContext, PendingApproval, SendMessageFn } from "../../types.js";
 import { type SlackLog } from "./log.js";
-import type { SlackCredentials } from "./types.js";
+import type { SlackBlockAction, SlackBlockActionHandler, SlackBotToken, SlackContinuationProbes, SlackCredentials } from "./types.js";
 export interface SlackInteractiveDispatchDeps {
     credentials: SlackCredentials | undefined;
     getSession: (sessionId: string) => Promise<ChannelSession | null>;
@@ -16,4 +21,35 @@ export interface SlackInteractiveDispatchDeps {
  * 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;
+    credentials: SlackCredentials | undefined;
+    host: HostContext;
+    log?: SlackLog;
+}
+/**
+ * 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

@@ -1 +1 @@
-{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/interactive.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,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,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAC/C,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,4BAA4B,GACjC,OAAO,CAAC,OAAO,CAAC,CAyFlB"}
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/interactive.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,WAAW,EACX,eAAe,EACf,aAAa,EACd,MAAM,gBAAgB,CAAC;AAKxB,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,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAC/C,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,4BAA4B,GACjC,OAAO,CAAC,OAAO,CAAC,CAyFlB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,GACf,gBAAgB,GAAG,IAAI,CAuFzB;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,WAAW,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC1C,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAyBD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,4BAA4B,GACjC,OAAO,CAAC,OAAO,CAAC,CA+ClB"}

package/dist/channels/slack/interactive.js

@@ -1,5 +1,10 @@
 /**
- * Socket Mode interactive payloads (Block Kit Approve/Deny).
+ * 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); }); }
@@ -10,8 +15,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+import { updateMessage } from "./api.js";
 import { decisionFromActionId, parseApprovalActionValue } from "./approvals.js";
 import { buildSlackInteractiveApprovalAuth } from "./auth.js";
+import { dispatchInboundMessage } from "./dispatch.js";
 import { defaultSlackLog } from "./log.js";
 /**
  * Handle a Socket Mode `interactive` body. Returns true when this was
@@ -22,7 +29,7 @@ export function dispatchInteractiveFromPayload(payload, deps) {
         var _a;
         var _b, _c, _d, _e;
         const log = (_b = deps.log) !== null && _b !== void 0 ? _b : defaultSlackLog;
-        const parsed = parseBlockActionsPayload(payload);
+        const parsed = parseSlackBlockAction(payload);
         if (parsed === null) {
             return false;
         }
@@ -90,7 +97,12 @@ export function dispatchInteractiveFromPayload(payload, deps) {
         return true;
     });
 }
-function parseBlockActionsPayload(payload) {
+/**
+ * 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;
     }
@@ -107,8 +119,7 @@ function parseBlockActionsPayload(payload) {
         return null;
     }
     const action = first;
-    if (typeof action.action_id !== "string" ||
-        typeof action.value !== "string") {
+    if (typeof action.action_id !== "string") {
         return null;
     }
     const channel = typeof record.channel === "object" && record.channel !== null
@@ -120,6 +131,9 @@ function parseBlockActionsPayload(payload) {
     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"
@@ -131,12 +145,144 @@ function parseBlockActionsPayload(payload) {
             ? 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;
+    const teamId = typeof team.id === "string"
+        ? team.id
+        : typeof user.team_id === "string"
+            ? user.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,
-        value: action.value,
+        blockId: typeof action.block_id === "string" ? action.block_id : "",
+        value: typeof action.value === "string" ? action.value : "",
+        label,
         channelId,
         threadTs,
-        userId,
         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) {
+    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: action.teamId,
+        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({
+            kind: "block_action",
+            message: blockActionAsMessage(action),
+            handler: (ctx) => deps.handler(ctx, action),
+            send: deps.send,
+            credentials: deps.credentials,
+            host: deps.host,
+            log,
+            // Click text is synthetic — never treat it as a stop/eval directive.
+            evalCommandsEnabled: false,
+            hasContinuationSession: deps.hasContinuationSession,
+            isContinuationBusy: deps.isContinuationBusy,
+            getContinuationLastBotMessageTs: deps.getContinuationLastBotMessageTs,
+            interruptContinuation: deps.interruptContinuation,
+        });
+        return true;
+    });
+}

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

@@ -3,8 +3,17 @@
  *
  * Import at https://api.slack.com/apps -> Create New App -> From a manifest.
  * Always Socket Mode — no Events Request URL.
+ *
+ * Mirrored by backend/server/src/agentServe/agentServeSlackManifest.ts (the
+ * backend cannot import this published package); keep the twins in lockstep.
  */
 import type { SlackManifestOptions } from "./types.js";
+/**
+ * Where Slack points users who open a Cursor-provisioned app's settings
+ * page. Manifest builders know neither the team slug nor the deployment
+ * id, so this is the dashboard tab root rather than a per-agent deep link.
+ */
+export declare const SLACK_EXTERNAL_APP_MANAGEMENT_URL = "https://cursor.com/dashboard/deployed-agents";
 export interface SlackAppManifest {
     display_information: {
         name: string;
@@ -44,6 +53,10 @@ export interface SlackAppManifest {
         socket_mode_enabled: boolean;
         token_rotation_enabled: boolean;
         is_mcp_enabled: boolean;
+        managed_app_settings?: {
+            is_install_from_slack_disabled: boolean;
+            external_app_management_url: string;
+        };
     };
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE;QACR,QAAQ,EAAE;YACR,YAAY,EAAE,MAAM,CAAC;YACrB,aAAa,EAAE,OAAO,CAAC;SACxB,CAAC;QACF,cAAc,CAAC,EAAE;YACf,qBAAqB,EAAE,MAAM,CAAC;YAC9B,iBAAiB,EAAE,KAAK,CAAC;gBAAE,KAAK,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SAC9D,CAAC;QACF,QAAQ,CAAC,EAAE;YACT,gBAAgB,EAAE,OAAO,CAAC;YAC1B,oBAAoB,EAAE,OAAO,CAAC;YAC9B,8BAA8B,EAAE,OAAO,CAAC;SACzC,CAAC;KACH,CAAC;IACF,YAAY,EAAE;QACZ,MAAM,EAAE;YACN,GAAG,EAAE,MAAM,EAAE,CAAC;SACf,CAAC;KACH,CAAC;IACF,QAAQ,EAAE;QACR,mBAAmB,EAAE;YACnB,UAAU,EAAE,MAAM,EAAE,CAAC;SACtB,CAAC;QACF,aAAa,EAAE;YACb,UAAU,EAAE,OAAO,CAAC;SACrB,CAAC;QACF,kBAAkB,EAAE,OAAO,CAAC;QAC5B,mBAAmB,EAAE,OAAO,CAAC;QAC7B,sBAAsB,EAAE,OAAO,CAAC;QAChC,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;CACH;AA4CD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,oBAAoB,GAC5B,gBAAgB,CA0ElB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,GACzC;IACD,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAKA"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,iDACE,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE;QACR,QAAQ,EAAE;YACR,YAAY,EAAE,MAAM,CAAC;YACrB,aAAa,EAAE,OAAO,CAAC;SACxB,CAAC;QACF,cAAc,CAAC,EAAE;YACf,qBAAqB,EAAE,MAAM,CAAC;YAC9B,iBAAiB,EAAE,KAAK,CAAC;gBAAE,KAAK,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SAC9D,CAAC;QACF,QAAQ,CAAC,EAAE;YACT,gBAAgB,EAAE,OAAO,CAAC;YAC1B,oBAAoB,EAAE,OAAO,CAAC;YAC9B,8BAA8B,EAAE,OAAO,CAAC;SACzC,CAAC;KACH,CAAC;IACF,YAAY,EAAE;QACZ,MAAM,EAAE;YACN,GAAG,EAAE,MAAM,EAAE,CAAC;SACf,CAAC;KACH,CAAC;IACF,QAAQ,EAAE;QACR,mBAAmB,EAAE;YACnB,UAAU,EAAE,MAAM,EAAE,CAAC;SACtB,CAAC;QACF,aAAa,EAAE;YACb,UAAU,EAAE,OAAO,CAAC;SACrB,CAAC;QACF,kBAAkB,EAAE,OAAO,CAAC;QAC5B,mBAAmB,EAAE,OAAO,CAAC;QAC7B,sBAAsB,EAAE,OAAO,CAAC;QAChC,cAAc,EAAE,OAAO,CAAC;QACxB,oBAAoB,CAAC,EAAE;YACrB,8BAA8B,EAAE,OAAO,CAAC;YACxC,2BAA2B,EAAE,MAAM,CAAC;SACrC,CAAC;KACH,CAAC;CACH;AAuDD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,oBAAoB,GAC5B,gBAAgB,CA+ElB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,GACzC;IACD,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAKA"}

package/dist/channels/slack/manifest.js

@@ -3,7 +3,16 @@
  *
  * Import at https://api.slack.com/apps -> Create New App -> From a manifest.
  * Always Socket Mode — no Events Request URL.
+ *
+ * Mirrored by backend/server/src/agentServe/agentServeSlackManifest.ts (the
+ * backend cannot import this published package); keep the twins in lockstep.
+ */
+/**
+ * Where Slack points users who open a Cursor-provisioned app's settings
+ * page. Manifest builders know neither the team slug nor the deployment
+ * id, so this is the dashboard tab root rather than a per-agent deep link.
  */
+export const SLACK_EXTERNAL_APP_MANAGEMENT_URL = "https://cursor.com/dashboard/deployed-agents";
 const BOT_SCOPES = [
     "app_mentions:read",
     "assistant:write",
@@ -20,6 +29,15 @@ const BOT_SCOPES = [
     "users:read",
 ];
 const BOT_EVENTS = ["app_mention", "message.im"];
+/** Slack's display_information.description bound. */
+const MAX_DESCRIPTION_LENGTH = 140;
+const DESCRIPTION_SUFFIX = " — an AI agent built with Cursor";
+/** Marketplace review rejects managed apps whose manifest omits a description. */
+function defaultDescription(name) {
+    const room = MAX_DESCRIPTION_LENGTH - DESCRIPTION_SUFFIX.length;
+    // Spread splits by code point: truncation cannot halve a surrogate pair.
+    return `${[...name].slice(0, room).join("")}${DESCRIPTION_SUFFIX}`;
+}
 function appSlug(name) {
     const base = name
         .toLowerCase()
@@ -56,6 +74,7 @@ export function buildSlackManifest(options) {
             ? `${options.name} (dev)`
             : options.name;
     const botName = (_a = options.botDisplayName) !== null && _a !== void 0 ? _a : toBotDisplayName(options.name, env);
+    const description = (_b = options.description) !== null && _b !== void 0 ? _b : defaultDescription(options.name);
     const includeAssistant = options.assistant !== false;
     const botScopes = includeAssistant
         ? [...BOT_SCOPES]
@@ -65,9 +84,10 @@ export function buildSlackManifest(options) {
         : [...BOT_EVENTS];
     const suggested = options.suggestedPrompts !== undefined ? options.suggestedPrompts : [];
     return {
-        display_information: Object.assign({ name: displayName }, (options.description === undefined
-            ? {}
-            : { description: options.description })),
+        display_information: {
+            name: displayName,
+            description,
+        },
         features: Object.assign({ bot_user: {
                 display_name: botName,
                 always_online: true,
@@ -78,7 +98,7 @@ export function buildSlackManifest(options) {
             } }, (includeAssistant
             ? {
                 assistant_view: {
-                    assistant_description: (_b = options.description) !== null && _b !== void 0 ? _b : `${options.name} agent served by agent-serve`,
+                    assistant_description: description,
                     suggested_prompts: suggested,
                 },
             }
@@ -88,21 +108,23 @@ export function buildSlackManifest(options) {
                 bot: botScopes,
             },
         },
-        settings: {
-            event_subscriptions: {
+        settings: Object.assign({ event_subscriptions: {
                 bot_events: botEvents,
-            },
-            interactivity: {
+            }, interactivity: {
                 is_enabled: options.interactivity === true,
-            },
+            }, 
             // Benny installs org-wide in the Cursor FE & ADM workspace.
-            org_deploy_enabled: benny,
+            org_deploy_enabled: benny, 
             // Always Socket Mode — agent-serve has no Events Request URL path.
             // (Do not set false even if Slack's empty-app stub defaults to off.)
-            socket_mode_enabled: true,
-            token_rotation_enabled: false,
-            is_mcp_enabled: false,
-        },
+            socket_mode_enabled: true, token_rotation_enabled: false, is_mcp_enabled: false }, (options.managedByCursor === false
+            ? {}
+            : {
+                managed_app_settings: {
+                    is_install_from_slack_disabled: true,
+                    external_app_management_url: SLACK_EXTERNAL_APP_MANAGEMENT_URL,
+                },
+            })),
     };
 }
 export function buildSlackManifestPair(options) {

package/dist/channels/slack/message-body.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Flatten a Slack message payload into readable text.
+ *
+ * Works on both raw Events API payloads and `conversations.*` API records.
+ * Alert feeds (Datadog, PagerDuty, …) post with an empty top-level `text`
+ * and put the whole notification in `attachments` / Block Kit `blocks`, so
+ * anything reading `text` alone sees an empty message.
+ */
+type JsonRecord = Record<string, unknown>;
+/** Pull readable text out of Slack attachment / Block Kit payloads. */
+export declare function slackApiMessageBody(message: JsonRecord): string;
+export {};
+//# sourceMappingURL=message-body.d.ts.map

package/dist/channels/slack/message-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-body.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/message-body.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAa1C,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAkE/D"}

package/dist/channels/slack/message-body.js

@@ -0,0 +1,82 @@
+/**
+ * Flatten a Slack message payload into readable text.
+ *
+ * Works on both raw Events API payloads and `conversations.*` API records.
+ * Alert feeds (Datadog, PagerDuty, …) post with an empty top-level `text`
+ * and put the whole notification in `attachments` / Block Kit `blocks`, so
+ * anything reading `text` alone sees an empty message.
+ */
+function asRecord(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+function asString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+/** Pull readable text out of Slack attachment / Block Kit payloads. */
+export function slackApiMessageBody(message) {
+    const parts = [];
+    const text = asString(message.text);
+    if (text !== undefined && text.trim() !== "") {
+        parts.push(text);
+    }
+    const attachments = Array.isArray(message.attachments)
+        ? message.attachments
+        : [];
+    for (const attachment of attachments) {
+        const rec = asRecord(attachment);
+        if (rec === null) {
+            continue;
+        }
+        for (const key of [
+            "pretext",
+            "title",
+            "text",
+            "fallback",
+            "footer",
+        ]) {
+            const value = asString(rec[key]);
+            if (value !== undefined && value.trim() !== "") {
+                parts.push(value);
+            }
+        }
+        const titleLink = asString(rec.title_link);
+        if (titleLink !== undefined && titleLink.trim() !== "") {
+            parts.push(titleLink);
+        }
+    }
+    const blocks = Array.isArray(message.blocks) ? message.blocks : [];
+    for (const block of blocks) {
+        const rec = asRecord(block);
+        if (rec === null) {
+            continue;
+        }
+        const blockText = asRecord(rec.text);
+        const blockTextValue = asString(blockText === null || blockText === void 0 ? void 0 : blockText.text);
+        if (blockTextValue !== undefined && blockTextValue.trim() !== "") {
+            parts.push(blockTextValue);
+        }
+        const fields = Array.isArray(rec.fields) ? rec.fields : [];
+        for (const field of fields) {
+            const fieldRec = asRecord(field);
+            const fieldText = asString(fieldRec === null || fieldRec === void 0 ? void 0 : fieldRec.text);
+            if (fieldText !== undefined && fieldText.trim() !== "") {
+                parts.push(fieldText);
+            }
+        }
+    }
+    // Dedupe identical chunks (Datadog often repeats text/fallback across fields).
+    const seen = new Set();
+    const deduped = [];
+    for (const part of parts) {
+        const trimmed = part.trim();
+        if (trimmed === "" || seen.has(trimmed)) {
+            continue;
+        }
+        seen.add(trimmed);
+        deduped.push(trimmed);
+    }
+    return deduped.join("\n");
+}

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

@@ -1,7 +1,10 @@
 /**
  * Slack setup guide printed by `agent-serve slack setup`.
  *
- * Mirrors the Cursor skill at skills/setup-slack/SKILL.md.
+ * Mirrors the Cursor skill at skills/setup-slack/SKILL.md: connection
+ * decision first (Cursor-hosted vs dedicated Socket Mode app), then the
+ * dedicated-app phases. {@link SLACK_SETUP_PHASES} stays the dedicated-app
+ * checklist — its ids key `.agent-serve/slack/setup-status.json`.
  */
 export interface SlackSetupPhase {
     id: string;

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

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/setup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,eAAO,MAAM,kBAAkB,EAAE,eAAe,EA4D/C,CAAC;AAEF,wBAAgB,qBAAqB,IAAI,MAAM,CAqB9C"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,eAAO,MAAM,kBAAkB,EAAE,eAAe,EA4D/C,CAAC;AAEF,wBAAgB,qBAAqB,IAAI,MAAM,CAgC9C"}

package/dist/channels/slack/setup.js

@@ -1,7 +1,10 @@
 /**
  * Slack setup guide printed by `agent-serve slack setup`.
  *
- * Mirrors the Cursor skill at skills/setup-slack/SKILL.md.
+ * Mirrors the Cursor skill at skills/setup-slack/SKILL.md: connection
+ * decision first (Cursor-hosted vs dedicated Socket Mode app), then the
+ * dedicated-app phases. {@link SLACK_SETUP_PHASES} stays the dedicated-app
+ * checklist — its ids key `.agent-serve/slack/setup-status.json`.
  */
 export const SLACK_SETUP_PHASES = [
     {
@@ -66,8 +69,19 @@ export const SLACK_SETUP_PHASES = [
 ];
 export function formatSlackSetupGuide() {
     const lines = [
-        "agent-serve — Slack setup (Socket Mode)",
+        "agent-serve — Slack setup",
         "",
+        "Two connections exist; decide before running the phases below.",
+        "",
+        "  A) Cursor-hosted connection (recommended default, zero Slack admin):",
+        '     slackChannel({ cursorAccount: true, agentName: "MyAgent" })',
+        "     Sign in (agent-serve login / CURSOR_API_KEY), serve, then mention",
+        '     "@Cursor MyAgent ..." in the linked workspace. No app, no tokens.',
+        "  B) Dedicated Slack app (Socket Mode) — the phases below. Choose it",
+        "     when you need your own bot user, channel watching",
+        "     (engagement.channelPosts), or approval buttons / interactivity.",
+        "",
+        "Phases 0-5 cover connection B only.",
         "Goal: importable dev + prod Slack apps over Socket Mode (no public URL).",
         "App-Level Token (xapp-...) + Bot Token (xoxb-...) required.",
         "",

package/dist/channels/slack/slack-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slack-channel.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/slack-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,iBAAiB,EAMlB,MAAM,gBAAgB,CAAC;AAsCxB,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,EAC7D,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,GAAG;IAChD,SAAS,CAAC,EAAE,oBAAoB,CAAC,IAAI,CAAC,CAAC;CACnC,GACL,iBAAiB,CAAC,iBAAiB,CAAC,CAwYtC"}
+{"version":3,"file":"slack-channel.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/slack-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,iBAAiB,EAMlB,MAAM,gBAAgB,CAAC;AAyCxB,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,EAC7D,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,GAAG;IAChD,SAAS,CAAC,EAAE,oBAAoB,CAAC,IAAI,CAAC,CAAC;CACnC,GACL,iBAAiB,CAAC,iBAAiB,CAAC,CAoatC"}