@cursor/july 0.1.15 → 0.1.17

package/src/channels/slack/types.ts

@@ -175,6 +175,83 @@ export type SlackMessageHandler = (
   | undefined
   | Promise<SlackDispatchDecision | null | undefined>;
 
+/**
+ * Host probes into a Slack thread's continuation. Optional on dispatch
+ * deps; the serve host wires them at channel start.
+ */
+export interface SlackContinuationProbes {
+  /**
+   * When set, full-thread hydration runs only for cold-start turns (no
+   * existing session). Warm turns load a `<slack_thread_delta>` instead.
+   */
+  hasContinuationSession?: (continuationToken: string) => Promise<boolean>;
+  /** True when a turn is already running for this Slack continuation. */
+  isContinuationBusy?: (continuationToken: string) => Promise<boolean>;
+  /**
+   * Warm-delta watermark from session channel state (`lastBotMessageTs`).
+   * When absent, delta falls back to the last matching bot post in-thread.
+   */
+  getContinuationLastBotMessageTs?: (
+    continuationToken: string
+  ) => Promise<string | undefined>;
+  /** Cancel the active turn + clear coalesced nudges for this continuation. */
+  interruptContinuation?: (continuationToken: string) => Promise<boolean>;
+}
+
+/**
+ * A Block Kit action click (Socket Mode `block_actions` payload) that the
+ * framework does not own — the built-in tool-approval Approve/Deny actions
+ * are routed to `resolveApproval` before author handlers see anything.
+ */
+export interface SlackBlockAction {
+  /** `action_id` of the clicked element. */
+  actionId: string;
+  /** `block_id` of the actions row holding the element (Slack always sets one). */
+  blockId: string;
+  /**
+   * Element `value` payload; empty string when absent (button-style
+   * elements only — select/overflow `selected_option`s are not read).
+   */
+  value: string;
+  /** Plain-text label of the clicked element, when present. */
+  label?: string;
+  channelId: string;
+  /**
+   * Thread of the message carrying the element (the message's own ts when
+   * it is a top-level post — clicks on a thread root stay in its thread).
+   */
+  threadTs: string;
+  /** The message carrying the clicked element. */
+  messageTs: string;
+  /** That message's blocks, for `chat.update` resolution cards. */
+  messageBlocks?: unknown[];
+  /** Slack user who clicked. */
+  userId: string;
+  userName?: string;
+  teamId?: string;
+  /**
+   * Slack `action_ts` — unique per click; block-action dispatch dedupes on
+   * it. Empty when the payload omitted it (malformed; never dispatched).
+   */
+  actionTs: string;
+}
+
+/**
+ * Author handler for {@link SlackBlockAction} clicks. Return a
+ * {@link SlackDispatchDecision} to dispatch a turn on the click's thread —
+ * the click is dispatched like an inbound message from the clicking user
+ * (thread-scoped continuation, `<slack_context>` naming the clicker) — or
+ * `null` to ignore the click.
+ */
+export type SlackBlockActionHandler = (
+  ctx: SlackBinding,
+  action: SlackBlockAction
+) =>
+  | SlackDispatchDecision
+  | null
+  | undefined
+  | Promise<SlackDispatchDecision | null | undefined>;
+
 /**
  * Opt-in channel watch: dispatch on posts in explicitly allowlisted
  * channels without requiring an @mention. There is deliberately no
@@ -371,6 +448,18 @@ export interface SlackChannelOptions {
    * only — rejected on `cursorAccount: true`.
    */
   interactivity?: boolean;
+  /**
+   * Handler for Block Kit actions the framework does not own (the built-in
+   * tool-approval Approve/Deny clicks are routed to `resolveApproval`
+   * first). Return a {@link SlackDispatchDecision} — typically with a
+   * thread-scoped auth via `buildSlackAuthContext` so replies in the same
+   * thread continue the session — to dispatch a turn on the click's
+   * thread, or `null` to ignore the click. Setting this implies
+   * interactive routing; the Slack app manifest still needs
+   * `interactivity` enabled (`buildSlackManifest({ interactivity: true })`).
+   * Socket Mode only — rejected on `cursorAccount: true`.
+   */
+  onBlockAction?: SlackBlockActionHandler;
   /**
    * Suggested prompts shown when an assistant thread starts (and optionally
    * after a turn completes).

package/src/connections.ts

@@ -30,8 +30,10 @@
  * to be signed in (`agent-serve login` or `CURSOR_API_KEY`):
  *
  * ```ts
- * // agent/mcp-connections/cursor.ts — every connected server
+ * // agent/mcp-connections/cursor.ts — every connected server (no allowlist)
  * export default defineConnection({ cursorAccount: true });
+ * // equivalent explicit form:
+ * export default defineConnection({ cursorAccount: true, servers: "*" });
  *
  * // or restrict to specific connectors by name
  * export default defineConnection({ cursorAccount: true, servers: ["Linear"] });
@@ -86,6 +88,7 @@ export type {
   HostMcpRegistry,
   HostMcpToolInfo,
 } from "./types.js";
+export { normalizeCursorAccountServers } from "./types.js";
 
 export function defineConnection(
   config: ConnectionConfig