@cursor/bdk 0.2.3 → 0.2.4

package/src/channels/slack/reasoning-chip.ts

@@ -1,41 +0,0 @@
-/**
- * Shared reasoning-chip throttle for defaults and agentic delivery.
- * Callers write Slack first, then commit.
- */
-
-import { truncateTypingStatus } from "./api.js";
-import { firstNonEmptyLine } from "./assistant.js";
-import { SLACK_TYPING_MIN_GROWTH, SLACK_TYPING_MIN_INTERVAL_MS } from "./constants.js";
-import type { SlackChannelState } from "./types.js";
-
-export function nextReasoningChip(
-  state: SlackChannelState,
-  text: string,
-  now: number,
-): string | undefined {
-  const line = firstNonEmptyLine(text);
-  if (line === undefined) {
-    return undefined;
-  }
-  const status = truncateTypingStatus(line);
-  const previous = state.lastReasoningTypingStatus;
-  const grew =
-    previous !== null &&
-    status.startsWith(previous) &&
-    status.length >= previous.length + SLACK_TYPING_MIN_GROWTH;
-  const lastAt = state.lastReasoningTypingAtMs;
-  if (
-    !grew &&
-    lastAt !== null &&
-    now - lastAt >= 0 &&
-    now - lastAt < SLACK_TYPING_MIN_INTERVAL_MS
-  ) {
-    return undefined;
-  }
-  return status;
-}
-
-export function commitReasoningChip(state: SlackChannelState, status: string, now: number): void {
-  state.lastReasoningTypingAtMs = now;
-  state.lastReasoningTypingStatus = status;
-}

package/src/channels/slack/recording-sink.ts

@@ -1,167 +0,0 @@
-/**
- * Slack Web API transport that records calls. For evals and tests.
- */
-
-import type { SlackApiTransport } from "./types.js";
-
-export interface SlackSinkCall {
-  method: string;
-  args: Record<string, unknown>;
-  at: number;
-  ts?: string;
-}
-
-export interface ReadableSinkText {
-  text: string;
-  at: number;
-  method: string;
-}
-
-export interface RecordingSlackSink {
-  transport: SlackApiTransport;
-  calls: SlackSinkCall[];
-  methods(): string[];
-  texts(): string[];
-  firstReadable(): ReadableSinkText | undefined;
-  lastReadable(): ReadableSinkText | undefined;
-  chunks(): unknown[];
-  release(): void;
-}
-
-function readableCall(call: SlackSinkCall): ReadableSinkText | undefined {
-  if (
-    call.method !== "chat.postMessage" &&
-    call.method !== "chat.update" &&
-    call.method !== "chat.startStream" &&
-    call.method !== "chat.appendStream" &&
-    call.method !== "chat.stopStream"
-  ) {
-    return undefined;
-  }
-  const text = textOf(call.args);
-  if (text === "") {
-    return undefined;
-  }
-  return { text, at: call.at, method: call.method };
-}
-
-function firstReadableCall(calls: readonly SlackSinkCall[]): ReadableSinkText | undefined {
-  for (const call of calls) {
-    const readable = readableCall(call);
-    if (readable !== undefined) {
-      return readable;
-    }
-  }
-  return undefined;
-}
-
-function lastReadableCall(calls: readonly SlackSinkCall[]): ReadableSinkText | undefined {
-  for (let i = calls.length - 1; i >= 0; i--) {
-    const call = calls[i];
-    if (call === undefined) {
-      continue;
-    }
-    const readable = readableCall(call);
-    if (readable !== undefined) {
-      return readable;
-    }
-  }
-  return undefined;
-}
-
-function textOf(args: Record<string, unknown>): string {
-  if (typeof args.markdown_text === "string" && args.markdown_text !== "") {
-    return args.markdown_text;
-  }
-  if (typeof args.text === "string") {
-    return args.text;
-  }
-  return "";
-}
-
-export function createRecordingSlackSink(
-  options: { hold?: boolean | readonly string[] } = {},
-): RecordingSlackSink {
-  const calls: SlackSinkCall[] = [];
-  let n = 0;
-  let releaseHeld: (() => void) | undefined;
-  const holdAll = options.hold === true;
-  const holdMethods = Array.isArray(options.hold) ? new Set(options.hold) : undefined;
-  const gated = holdAll || holdMethods !== undefined;
-  const gate: Promise<void> = gated
-    ? new Promise<void>(resolve => {
-        releaseHeld = resolve;
-      })
-    : Promise.resolve();
-
-  function reply(method: string, args: Record<string, unknown>): Record<string, unknown> {
-    if (method === "chat.postMessage") {
-      return {
-        ok: true,
-        ts: `${n}.0`,
-        channel: String(args.channel ?? "C1"),
-      };
-    }
-    if (method === "chat.startStream") {
-      return {
-        ok: true,
-        ts: `s${n}.0`,
-        channel: String(args.channel ?? "C1"),
-      };
-    }
-    if (method === "files.getUploadURLExternal") {
-      return {
-        ok: true,
-        upload_url: "https://files.example.test/upload",
-        file_id: `F${n}`,
-      };
-    }
-    if (method === "files.completeUploadExternal") {
-      return { ok: true, files: [] };
-    }
-    if (method === "users.info") {
-      return {
-        ok: true,
-        user: { id: String(args.user ?? "U1"), team_id: "T1" },
-      };
-    }
-    return { ok: true };
-  }
-
-  const transport: SlackApiTransport = {
-    kind: "api-transport",
-    label: "recording",
-    async call(method, args) {
-      n += 1;
-      const result = reply(method, args);
-      const ts = typeof result.ts === "string" ? result.ts : undefined;
-      calls.push({ method, args, at: Date.now(), ts });
-      if (holdAll || holdMethods?.has(method) === true) {
-        await gate;
-      }
-      return result;
-    },
-  };
-  return {
-    transport,
-    calls,
-    methods: () => calls.map(call => call.method),
-    texts: () =>
-      calls
-        .filter(call => readableCall(call) !== undefined)
-        .map(call => textOf(call.args))
-        .filter(text => text !== ""),
-    firstReadable: () => firstReadableCall(calls),
-    lastReadable: () => lastReadableCall(calls),
-    chunks: () =>
-      calls.flatMap(call => {
-        const chunks = call.args.chunks;
-        return Array.isArray(chunks) ? chunks : [];
-      }),
-    release: () => {
-      if (releaseHeld !== undefined) {
-        releaseHeld();
-      }
-    },
-  };
-}

package/src/channels/slack/redact.ts

@@ -1,6 +0,0 @@
-/** Credential shapes that must never reach a Slack thread verbatim. */
-const SECRET_TOKEN = /\b(crsr_|xox[baprs]-|sk-|Bearer\s+)\S+/gi;
-
-export function redactSecretTokens(text: string): string {
-  return text.replace(SECRET_TOKEN, "[redacted]");
-}

package/src/channels/slack/reply-options.ts

@@ -1,279 +0,0 @@
-/**
- * Resolve `slackChannel({ reply, toolLabels })` — and the deprecated
- * `streaming` / `thinkingSteps` / `loadingMessages` flags — into one config
- * the default event handlers read.
- */
-
-import { emojiName } from "./agentic-signals.js";
-import { SLACK_DEFAULT_LOADING_MESSAGES } from "./constants.js";
-import type { SlackReplyFooter } from "./footer.js";
-import { defaultToolCardDetails } from "./tool-cards.js";
-import type {
-  SlackChannelOptions,
-  SlackReasoningCardOptions,
-  SlackReplyOptions,
-  SlackToolCall,
-  SlackToolCardGroup,
-  SlackToolLabels,
-  SlackToolResult,
-} from "./types.js";
-
-export type SlackReplyMode = "post" | "stream" | "agentic";
-
-export interface ResolvedSlackStatus {
-  reasoning: boolean;
-  /** `false`, or the line to show when tool calls start. */
-  tools: false | ((calls: readonly SlackToolCall[]) => string);
-  idle: string[];
-}
-
-export interface ResolvedSlackToolCards {
-  group: SlackToolCardGroup;
-  details?: (call: SlackToolCall) => string | undefined;
-  output?: (result: SlackToolResult) => string | undefined;
-}
-
-export interface ResolvedSlackReasoningCard {
-  title: string;
-  maxChars: number;
-}
-
-export interface ResolvedSlackReply {
-  mode: SlackReplyMode;
-  /** Parent reaction at turn start. Set for `agentic`. */
-  ack?: string;
-  /** Exact replaceable first line. Set when `reply.placeholder` is authored. */
-  placeholder?: string;
-  status: ResolvedSlackStatus;
-  toolCards: false | ResolvedSlackToolCards;
-  reasoningCard: false | ResolvedSlackReasoningCard;
-  toolLabel: (toolName: string) => string;
-  footer?: SlackReplyFooter;
-  /** Author-facing notices about deprecated options that were honored. */
-  deprecations: string[];
-}
-
-export const DEFAULT_ACK = "eyes";
-const STATIC_PLACEHOLDER_ERROR =
-  "slackChannel reply.placeholder must be one static 2-80 character line without mentions.";
-
-function resolveAck(raw: string | undefined): string {
-  if (raw === undefined) {
-    return DEFAULT_ACK;
-  }
-  return emojiName(raw) ?? DEFAULT_ACK;
-}
-
-function resolvePlaceholder(option: string | undefined): string | undefined {
-  if (option === undefined) {
-    return undefined;
-  }
-  if (typeof option !== "string") {
-    throw new Error(STATIC_PLACEHOLDER_ERROR);
-  }
-  const line = option.trim();
-  if (
-    line.length < 2 ||
-    line.length > 80 ||
-    line.includes("\n") ||
-    line.includes("\r") ||
-    /<!|<@/.test(line)
-  ) {
-    throw new Error(STATIC_PLACEHOLDER_ERROR);
-  }
-  return line;
-}
-
-export const DEFAULT_REASONING_CARD_TITLE = "Thinking";
-/** A modest share of `SLACK_MARKDOWN_TEXT_MAX_LEN`, which the whole streamed message shares. */
-export const DEFAULT_REASONING_CARD_MAX_CHARS = 1500;
-
-type ReplyInputs = Pick<
-  SlackChannelOptions,
-  "reply" | "toolLabels" | "streaming" | "thinkingSteps"
-> & { loadingMessages?: readonly string[] };
-
-function resolveToolLabel(labels: SlackToolLabels | undefined): (toolName: string) => string {
-  if (labels === undefined) {
-    return toolName => toolName;
-  }
-  const lookup = typeof labels === "function" ? labels : (name: string) => labels[name];
-  return toolName => {
-    const label = lookup(toolName);
-    return label === undefined || label === "" ? toolName : label;
-  };
-}
-
-function defaultToolStatusLine(
-  toolLabel: (toolName: string) => string,
-): (calls: readonly SlackToolCall[]) => string {
-  return calls => {
-    const names = [...new Set(calls.map(call => toolLabel(call.toolName)))];
-    return `Running ${names.join(", ")}…`;
-  };
-}
-
-function resolveIdle(idle: readonly string[] | undefined): string[] {
-  const cleaned = (idle ?? []).filter(line => line.trim() !== "");
-  return cleaned.length > 0 ? cleaned : [...SLACK_DEFAULT_LOADING_MESSAGES];
-}
-
-function resolveReasoningCard(
-  option: boolean | SlackReasoningCardOptions | undefined,
-): false | ResolvedSlackReasoningCard {
-  if (option === undefined || option === false) {
-    return false;
-  }
-  const options = option === true ? {} : option;
-  const title = options.title?.trim();
-  return {
-    title: title === undefined || title === "" ? DEFAULT_REASONING_CARD_TITLE : title,
-    maxChars:
-      options.maxChars !== undefined && options.maxChars > 0
-        ? options.maxChars
-        : DEFAULT_REASONING_CARD_MAX_CHARS,
-  };
-}
-
-function resolveToolCards(
-  option: SlackReplyOptions & { mode: "stream" },
-): false | ResolvedSlackToolCards {
-  const cards = option.toolCards;
-  if (cards === undefined || cards === false) {
-    return false;
-  }
-  if (cards === true) {
-    return { group: "per-tool", details: defaultToolCardDetails };
-  }
-  const group = cards.group ?? "per-tool";
-  if (cards.collapsible === false) {
-    return { group };
-  }
-  return {
-    group,
-    details: cards.details ?? defaultToolCardDetails,
-    output: cards.output,
-  };
-}
-
-/**
- * Map the deprecated flags onto a `reply` shape with their old defaults
- * (streaming on, per-call cards on), so a config that only sets these keeps
- * behaving as it did. `null` when none of them is set.
- */
-function legacyReplyOptions(
-  options: ReplyInputs,
-): { reply: SlackReplyOptions; deprecations: string[] } | null {
-  const idle = options.loadingMessages;
-  if (
-    options.streaming === undefined &&
-    options.thinkingSteps === undefined &&
-    idle === undefined
-  ) {
-    return null;
-  }
-  const deprecations: string[] = [];
-  const mode: SlackReplyMode = options.streaming === false ? "post" : "stream";
-  // What legacy streaming showed: one title-only card per call.
-  const cards = options.thinkingSteps === false ? false : LEGACY_CARDS;
-  const replacement =
-    mode === "post"
-      ? 'reply: { mode: "post" }'
-      : cards === false
-        ? 'reply: { mode: "stream" }'
-        : 'reply: { mode: "stream", toolCards: { group: "per-call", collapsible: false } }';
-  if (idle !== undefined) {
-    deprecations.push(
-      `slackChannel({ loadingMessages }) is deprecated; use reply: { mode: "${mode}", status: { idle: [...] } }.`,
-    );
-  }
-  if (options.streaming !== undefined) {
-    deprecations.push(
-      `slackChannel({ streaming: ${String(options.streaming)} }) is deprecated; use ${replacement}.`,
-    );
-  }
-  if (options.thinkingSteps !== undefined) {
-    deprecations.push(
-      mode === "post"
-        ? "slackChannel({ thinkingSteps }) has no effect in post mode; remove it."
-        : `slackChannel({ thinkingSteps: ${String(options.thinkingSteps)} }) is deprecated; use ${replacement}.`,
-    );
-  }
-  const status = { idle };
-  if (mode === "post") {
-    return { reply: { mode, status }, deprecations };
-  }
-  return { reply: { mode, status, toolCards: cards }, deprecations };
-}
-
-const LEGACY_CARDS = { group: "per-call", collapsible: false } as const;
-
-export function resolveSlackReply(options: ReplyInputs): ResolvedSlackReply {
-  const deprecations: string[] = [];
-  let reply: SlackReplyOptions = { mode: "post" };
-  const legacy = legacyReplyOptions(options);
-  if (options.reply !== undefined) {
-    reply = options.reply;
-    if (legacy !== null) {
-      const ignored = (["streaming", "thinkingSteps", "loadingMessages"] as const).filter(
-        key => options[key] !== undefined,
-      );
-      deprecations.push(
-        `slackChannel({ ${ignored.join(", ")} }) is ignored because reply is set; remove the deprecated option${ignored.length === 1 ? "" : "s"}.`,
-      );
-    }
-  } else if (legacy !== null) {
-    reply = legacy.reply;
-    deprecations.push(...legacy.deprecations);
-  }
-
-  const toolLabel = resolveToolLabel(options.toolLabels);
-  const statusInput = reply.status ?? {};
-  const tools =
-    statusInput.tools === false
-      ? false
-      : typeof statusInput.tools === "function"
-        ? statusInput.tools
-        : defaultToolStatusLine(toolLabel);
-  const reasoning = statusInput.reasoning !== false;
-  if (reply.mode === "agentic") {
-    return {
-      mode: "agentic",
-      ack: resolveAck(reply.ack),
-      placeholder: resolvePlaceholder(reply.placeholder),
-      status: { reasoning, tools, idle: [] },
-      toolCards: false,
-      reasoningCard: false,
-      toolLabel,
-      footer: reply.footer,
-      deprecations,
-    };
-  }
-
-  const status: ResolvedSlackStatus = {
-    reasoning,
-    tools,
-    idle: resolveIdle(reply.status?.idle),
-  };
-
-  if (reply.mode === "post") {
-    return {
-      mode: "post",
-      status,
-      toolCards: false,
-      reasoningCard: false,
-      toolLabel,
-      footer: reply.footer,
-      deprecations,
-    };
-  }
-  return {
-    mode: "stream",
-    status,
-    toolCards: resolveToolCards(reply),
-    reasoningCard: resolveReasoningCard(reply.reasoningCard),
-    toolLabel,
-    footer: reply.footer,
-    deprecations,
-  };
-}

package/src/channels/slack/setup.ts

@@ -1,125 +0,0 @@
-import { CLI_COMMAND_NAME as CLI } from "../../internal/distribution.js";
-/**
- * Slack setup guide printed by `agent-sdk slack setup`.
- *
- * Dedicated Socket Mode app via `slack create` (dashboard wizard).
- * `slack init --manual` is the unmanaged Slack CLI / paste path.
- * {@link SLACK_SETUP_PHASES} is that checklist; its ids key
- * `.agent-serve/slack/setup-status.json`.
- */
-
-export interface SlackSetupPhase {
-  id: string;
-  actor: "agent" | "human";
-  title: string;
-  steps: string[];
-}
-
-export const SLACK_SETUP_PHASES: SlackSetupPhase[] = [
-  {
-    id: "generate",
-    actor: "agent",
-    title: "Generate channel + manifests",
-    steps: [
-      `${CLI} slack init --manual --dir . --name My Agent`,
-      "Installs the Slack app when Slack CLI is logged in. Otherwise next asks the user to install it.",
-      "Manifests default to Socket Mode (no public Request URL).",
-    ],
-  },
-  {
-    id: "createApps",
-    actor: "human",
-    title: "Create two Slack apps from manifests",
-    steps: [
-      "Preferred: Slack CLI at ~/.slack/bin/slack. slack login --no-prompt, then slack app install --environment local --team <T> --force",
-      "Prod: SLACK_ENV=deployed slack app install --environment deployed --team <T> --force",
-      "Do not slack deploy; Agent SDK serve owns Socket Mode",
-      "Fallback: https://api.slack.com/apps -> Create New App from a manifest",
-      "Paste .slack/manifest.dev.json, then manifest.prod.json",
-    ],
-  },
-  {
-    id: "install",
-    actor: "human",
-    title: "Install + mint App-Level Token",
-    steps: [
-      "Slack CLI install leaves tokens in that process only. Copy xoxb from OAuth & Permissions at https://api.slack.com/apps/<appId>",
-      "App-Level Tokens: create token with connections:write; copy xapp-...",
-      "If Slack CLI wrote SLACK_* to .env, copy them into .env.local using env.example names",
-    ],
-  },
-  {
-    id: "env",
-    actor: "agent",
-    title: "Wire environment",
-    steps: [
-      "Write per-agent tokens into .env.local (see .agent-serve/slack/env.example)",
-      "Multi-agent: <PREFIX>_SLACK_BOT_TOKEN + <PREFIX>_SLACK_APP_TOKEN",
-      "Single agent: SLACK_BOT_TOKEN + SLACK_APP_TOKEN (--no-prefix)",
-      `${CLI} slack doctor --prefix <PREFIX>`,
-    ],
-  },
-  {
-    id: "serve",
-    actor: "agent",
-    title: "Serve",
-    steps: [`${CLI} serve --dir . --dev`, "Confirm log: [agent-sdk/slack] Socket Mode connected"],
-  },
-  {
-    id: "smoke",
-    actor: "human",
-    title: "Smoke test",
-    steps: [
-      "Invite the bot to a channel",
-      "@mention it or DM it",
-      "Confirm logs: inbound → session start → reply delivered",
-      "Confirm streaming reply and rotating status",
-    ],
-  },
-];
-
-/** Seed `.agent-serve/slack/setup-status.json` after `slack init --manual`. */
-export function initialSlackSetupStatus(options: {
-  envPrefix: string | undefined;
-  envKeys: { bot: string; app: string };
-}): {
-  updatedAt: string;
-  envPrefix: string | null;
-  envKeys: { bot: string; app: string };
-  phases: Record<string, boolean>;
-} {
-  const completed = SLACK_SETUP_PHASES[0]?.id;
-  return {
-    updatedAt: new Date().toISOString(),
-    envPrefix: options.envPrefix ?? null,
-    envKeys: options.envKeys,
-    phases: Object.fromEntries(SLACK_SETUP_PHASES.map(phase => [phase.id, phase.id === completed])),
-  };
-}
-
-export function formatSlackSetupGuide(): string {
-  const lines: string[] = [
-    `${CLI} — Slack setup`,
-    "",
-    "Dedicated Slack app (Socket Mode) via the dashboard wizard:",
-    `  ${CLI} slack create --dir .`,
-    "  Finish Slack consent and the bot name there. The CLI writes",
-    "  tokens into .env.local.",
-    "",
-    "Manual Slack app: `slack init --manual` (Slack CLI, or paste at api.slack.com).",
-    "Goal: importable dev + prod Slack apps over Socket Mode (no public URL).",
-    "App-Level Token (xapp-...) + Bot Token (xoxb-...) required.",
-    "",
-  ];
-  for (const [index, phase] of SLACK_SETUP_PHASES.entries()) {
-    lines.push(`## Phase ${index} — ${phase.title} (${phase.actor})`);
-    for (const step of phase.steps) {
-      lines.push(`  - ${step}`);
-    }
-    lines.push("");
-  }
-  lines.push("Status file: .agent-serve/slack/setup-status.json");
-  lines.push("Skill (Cursor): packages/agent-serve/skills/setup-slack/SKILL.md");
-  lines.push("");
-  return lines.join("\n");
-}