@cuylabs/channel-slack-agent-core 0.10.0 → 0.11.0

package/dist/chunk-Q2GU4QLZ.js

@@ -1,187 +0,0 @@
-import {
-  createSlackAssistantBridge
-} from "./chunk-GEFK72VO.js";
-import {
-  createSlackFeedbackBlock
-} from "./chunk-ELR6MQD7.js";
-import {
-  createSlackChannelAdapter
-} from "./chunk-KQPUQJ57.js";
-
-// src/app-surface.ts
-var DEFAULT_TIMEOUT_MS = 12e4;
-var DEFAULT_STREAM_ERROR_MESSAGE = "I ran into an error while preparing this answer. Please try again.";
-function installSlackAgentAppSurface(boltApp, options) {
-  const {
-    respondToMentions,
-    respondToMessages,
-    respondToChannelMessages,
-    resolveMessage,
-    feedback: feedbackOption,
-    onFeedback,
-    timeoutMs,
-    logger,
-    source,
-    prepareTurn,
-    resolveSession,
-    interactive,
-    viewWorkflows,
-    ...assistantBridgeOptions
-  } = options;
-  const feedbackConfig = feedbackOption === false ? void 0 : feedbackOption ?? (onFeedback ? { onFeedback } : {});
-  const assistantFeedback = feedbackOption === false ? false : feedbackConfig;
-  const feedbackBlock = feedbackConfig ? createSlackFeedbackBlock(feedbackConfig) : void 0;
-  const formatStreamError = assistantBridgeOptions.formatStreamError ?? (() => DEFAULT_STREAM_ERROR_MESSAGE);
-  const formatting = assistantBridgeOptions.formatChatMarkdown;
-  const channelSource = createErrorTranslatingSource(source, formatStreamError);
-  const channelFinalArgs = mergeChatStreamFinalArgs(
-    assistantBridgeOptions.chatStreamFinalArgs,
-    feedbackBlock
-  );
-  const bridge = createSlackAssistantBridge({
-    ...assistantBridgeOptions,
-    source,
-    ...assistantFeedback !== void 0 ? { feedback: assistantFeedback } : {},
-    ...timeoutMs !== void 0 ? { timeoutMs } : {},
-    ...logger ? { logger } : {},
-    ...prepareTurn ? { prepareTurn: toAssistantPrepareTurn(prepareTurn) } : {},
-    ...resolveSession ? { resolveSession: toAssistantResolveSession(resolveSession) } : {},
-    ...interactive ? { handleInteractiveRequest: interactive.handleInteractiveRequest } : {}
-  });
-  bridge.install(boltApp);
-  const channelAdapter = createSlackChannelAdapter({
-    source: channelSource,
-    sessionStrategy: assistantBridgeOptions.sessionStrategy,
-    ...resolveSession ? { resolveSession } : {},
-    ...prepareTurn ? { prepareTurn } : {},
-    ...interactive ? { handleInteractiveRequest: interactive.handleInteractiveRequest } : {},
-    streamingMode: "chat-stream",
-    showReasoning: assistantBridgeOptions.showReasoning,
-    showToolUsage: assistantBridgeOptions.showToolUsage,
-    showSubagentToolUsage: assistantBridgeOptions.showSubagentToolUsage,
-    showSubagentResultInTask: assistantBridgeOptions.showSubagentResultInTask,
-    formatToolTitle: assistantBridgeOptions.formatToolTitle,
-    formatToolUpdate: assistantBridgeOptions.formatToolUpdate,
-    formatToolDetails: assistantBridgeOptions.formatToolDetails,
-    formatToolResultOutput: assistantBridgeOptions.formatToolResultOutput,
-    formatToolError: assistantBridgeOptions.formatToolError,
-    formatReasoningUpdate: assistantBridgeOptions.formatReasoningUpdate,
-    chatStreamBufferSize: assistantBridgeOptions.chatStreamBufferSize,
-    chatStreamStartArgs: {
-      ...assistantBridgeOptions.chatStreamStartArgs ?? {},
-      task_display_mode: assistantBridgeOptions.taskDisplayMode ?? "timeline"
-    },
-    publishFinalResponseArtifact: assistantBridgeOptions.publishFinalResponseArtifact,
-    finalResponseArtifactMode: assistantBridgeOptions.finalResponseArtifactMode,
-    finalResponseArtifactStreamThreshold: assistantBridgeOptions.finalResponseArtifactStreamThreshold,
-    formatFinalResponseArtifactContinuationNotice: assistantBridgeOptions.formatFinalResponseArtifactContinuationNotice,
-    formatFinalResponseArtifactMessage: assistantBridgeOptions.formatFinalResponseArtifactMessage,
-    onFinalResponseArtifactError: assistantBridgeOptions.onFinalResponseArtifactError,
-    ...typeof assistantBridgeOptions.initialStatus === "object" && assistantBridgeOptions.initialStatus !== null ? { initialStatus: assistantBridgeOptions.initialStatus } : {},
-    ...formatting?.formatChatMarkdown !== void 0 ? { formatChatMarkdown: formatting.formatChatMarkdown } : {},
-    ...formatting?.formatMessageText ? { formatMessageText: formatting.formatMessageText } : {},
-    timeout: timeoutMs ?? DEFAULT_TIMEOUT_MS,
-    respondToMentions: respondToMentions !== false,
-    respondToMessages: respondToMessages !== false,
-    respondToChannelMessages: respondToChannelMessages === true,
-    ...resolveMessage ? { resolveMessage } : {},
-    chatStreamFinalArgs: channelFinalArgs,
-    ...logger ? { logger } : {},
-    ...logger ? {
-      onError: async (error, info) => {
-        logger.warn?.("slack channel turn failed", {
-          error: formatErrorForLog(error),
-          channelId: info.channelId,
-          userId: info.userId
-        });
-      }
-    } : {}
-  });
-  channelAdapter.mount(boltApp);
-  interactive?.install(boltApp);
-  viewWorkflows?.install(boltApp);
-  return { bridge };
-}
-function mergeChatStreamFinalArgs(base, feedbackBlock) {
-  if (!base && !feedbackBlock) {
-    return void 0;
-  }
-  const configuredBlocks = Array.isArray(base?.blocks) ? base.blocks : [];
-  const blocks = feedbackBlock ? [...configuredBlocks, feedbackBlock] : configuredBlocks;
-  return {
-    ...base ?? {},
-    ...blocks.length > 0 ? { blocks } : {}
-  };
-}
-function toAssistantPrepareTurn(prepareTurn) {
-  return (request) => prepareTurn(toAppTurnRequest(request));
-}
-function toAssistantResolveSession(resolveSession) {
-  return (request) => resolveSession(toAppTurnRequest(request));
-}
-function toAppTurnRequest(request) {
-  const user = {
-    userId: request.message.userId,
-    channelId: request.message.channelId,
-    teamId: request.message.teamId ?? request.auth.teamId,
-    threadTs: request.message.threadTs,
-    messageTs: request.message.messageTs
-  };
-  return {
-    slackActivity: request.message,
-    user,
-    sessionId: request.sessionId,
-    message: request.message.text,
-    auth: request.auth,
-    threadContext: request.threadContext,
-    assistant: request.assistant,
-    client: request.client,
-    rawArgs: request.rawArgs
-  };
-}
-function createErrorTranslatingSource(source, formatStreamError) {
-  return {
-    chat(sessionId, message, options) {
-      const events = source.chat(sessionId, message, options);
-      return translateErrors(events, formatStreamError);
-    }
-  };
-}
-async function* translateErrors(events, formatStreamError) {
-  try {
-    for await (const event of events) {
-      if (event.type === "error") {
-        yield {
-          type: "text-delta",
-          text: `
-
-${formatStreamError(toError(event.error))}`
-        };
-        yield { type: "complete" };
-        return;
-      }
-      yield event;
-    }
-  } catch (error) {
-    yield {
-      type: "text-delta",
-      text: `
-
-${formatStreamError(toError(error))}`
-    };
-    yield { type: "complete" };
-  }
-}
-function toError(value) {
-  return value instanceof Error ? value : new Error(String(value));
-}
-function formatErrorForLog(error) {
-  if (error instanceof Error) {
-    return error.stack ?? error.message;
-  }
-  return String(error);
-}
-
-export {
-  installSlackAgentAppSurface
-};

package/dist/chunk-QFDXKCAQ.js

@@ -1,82 +0,0 @@
-import {
-  createSlackChannelAdapter
-} from "./chunk-KQPUQJ57.js";
-
-// src/express.ts
-import {
-  createSlackBoltApp
-} from "@cuylabs/channel-slack/transports/http";
-async function mountSlackAgent(source, options = {}) {
-  const {
-    botToken: providedToken,
-    signingSecret,
-    auth,
-    path,
-    processBeforeResponse,
-    signatureVerification,
-    boltAppOptions,
-    receiverOptions,
-    port: portOption,
-    host,
-    app: providedApp,
-    ...adapterOptions
-  } = options;
-  const {
-    boltApp,
-    receiver,
-    app: expressApp,
-    authMode,
-    routePath
-  } = await createSlackBoltApp({
-    signingSecret,
-    path,
-    botToken: providedToken,
-    auth,
-    app: providedApp,
-    processBeforeResponse,
-    signatureVerification,
-    boltAppOptions,
-    receiverOptions
-  });
-  const channelAdapter = createSlackChannelAdapter({
-    source,
-    ...adapterOptions
-  });
-  channelAdapter.mount(boltApp);
-  mountReceiverRouter(expressApp, receiver);
-  const port = portOption === void 0 ? resolvePort(process.env.PORT) : portOption;
-  let server;
-  if (!providedApp && port !== null) {
-    const onListen = () => {
-      process.stdout.write(
-        `Slack bot listening on port ${port} at ${routePath}
-`
-      );
-    };
-    server = host ? expressApp.listen(port, host, onListen) : expressApp.listen(port, onListen);
-  }
-  return {
-    app: expressApp,
-    boltApp,
-    receiver,
-    authMode,
-    routePath,
-    channelAdapter,
-    server
-  };
-}
-function resolvePort(port) {
-  if (!port) return 3e3;
-  const parsed = Number(port);
-  if (!Number.isInteger(parsed) || parsed < 0) {
-    throw new Error(`Invalid PORT value: ${port}`);
-  }
-  return parsed;
-}
-function mountReceiverRouter(app, receiver) {
-  app.use(receiver.router);
-}
-
-export {
-  mountSlackAgent
-};

package/dist/express-assistant.d.ts

@@ -1,106 +0,0 @@
-import { Server } from 'node:http';
-import { Application } from 'express';
-import { App, ExpressReceiver } from '@slack/bolt';
-import { CreateSlackBoltAppOptions } from '@cuylabs/channel-slack/transports/http';
-import { SlackDirectAuthOptions, SlackDirectAuthMode } from '@cuylabs/channel-slack/auth';
-import { C as CreateSlackAssistantBridgeOptions, d as SlackAssistantFeedbackConfig, S as SlackAssistantBridge } from './options-ByNm2o89.js';
-import { SlackFeedbackHandler } from '@cuylabs/channel-slack/feedback';
-import '@cuylabs/agent-core';
-import '@slack/web-api';
-import '@cuylabs/channel-slack/core';
-import './interactive-BigrPKnu.js';
-import '@cuylabs/channel-slack/interactive';
-import './options-CGUfVStV.js';
-import './artifacts/index.js';
-import '@cuylabs/channel-slack/artifacts';
-import '@cuylabs/channel-slack/assistant';
-
-/**
- * Express helper for mounting the Slack assistant bridge.
- *
- * Companion to `mountSlackAgent` (which wires the classic
- * `app.message`/`app.event` listeners). This one uses
- * `createSlackAssistantBridge` so the bot uses Bolt's
- * `app.assistant(new Assistant({...}))` lifecycle — `setStatus`,
- * `setSuggestedPrompts`, `chatStream`, feedback buttons.
- *
- * @example
- * ```ts
- * import { mountSlackAssistantAgent } from "@cuylabs/channel-slack-agent-core";
- *
- * await mountSlackAssistantAgent(agent, {
- *   getSuggestedPrompts: () => ({
- *     title: "Try one of these:",
- *     prompts: [
- *       { title: "Roll some dice", message: "Roll 2d20" },
- *       { title: "Summarize this thread", message: "Summarize the last 20 messages" },
- *     ],
- *   }),
- *   onFeedback: ({ verdict, sessionId }) => {
- *     metrics.increment(`feedback.${verdict}`, { sessionId });
- *   },
- * });
- * ```
- */
-
-interface MountSlackAssistantAgentOptions extends Omit<CreateSlackAssistantBridgeOptions, "feedback">, Omit<CreateSlackBoltAppOptions, "app" | "path" | "botToken" | "signingSecret" | "auth"> {
-    /**
-     * Slack bot token (`xoxb-...`).
-     * @default process.env.SLACK_BOT_TOKEN
-     */
-    botToken?: string;
-    /**
-     * Slack signing secret used to verify incoming webhook requests.
-     * @default process.env.SLACK_SIGNING_SECRET
-     */
-    signingSecret?: string;
-    /**
-     * Structured direct-mode auth config (single-workspace, OAuth, custom).
-     * Defaults to `botToken` / `SLACK_BOT_TOKEN` single-workspace mode.
-     */
-    auth?: SlackDirectAuthOptions;
-    /**
-     * Slack Events API callback path handled by Bolt.
-     *
-     * @default "/slack/events"
-     */
-    path?: string;
-    /**
-     * Port to listen on. Set to `null` to skip `app.listen()` — caller manages
-     * the server.
-     *
-     * @default process.env.PORT || 3000
-     */
-    port?: number | null;
-    /** Optional host passed to `app.listen(port, host)`. */
-    host?: string;
-    /**
-     * Pre-existing Express app. If not provided, a new one is created and the
-     * helper calls `app.listen()` itself.
-     */
-    app?: Application;
-    /**
-     * Feedback config — block + handler. Pass `false` to omit feedback buttons
-     * entirely. Pass an object to override action ids, button labels, or the
-     * feedback handler. Pass a function as `onFeedback` for the most common
-     * case where only the handler differs.
-     */
-    feedback?: SlackAssistantFeedbackConfig | false;
-    /**
-     * Convenience shorthand: `onFeedback: handler` is equivalent to
-     * `feedback: { onFeedback: handler }`. Ignored if `feedback` is set.
-     */
-    onFeedback?: SlackFeedbackHandler;
-}
-interface MountSlackAssistantAgentResult {
-    app: Application;
-    boltApp: App;
-    receiver: ExpressReceiver;
-    authMode: SlackDirectAuthMode;
-    routePath: string;
-    bridge: SlackAssistantBridge;
-    server?: Server;
-}
-declare function mountSlackAssistantAgent(options: MountSlackAssistantAgentOptions): Promise<MountSlackAssistantAgentResult>;
-
-export { type MountSlackAssistantAgentOptions, type MountSlackAssistantAgentResult, mountSlackAssistantAgent };

package/dist/express-assistant.js

@@ -1,9 +0,0 @@
-import {
-  mountSlackAssistantAgent
-} from "./chunk-DS6E5OEJ.js";
-import "./chunk-GEFK72VO.js";
-import "./chunk-ELR6MQD7.js";
-import "./chunk-L5RAGYVJ.js";
-export {
-  mountSlackAssistantAgent
-};

package/dist/express.d.ts

@@ -1,103 +0,0 @@
-import * as _slack_bolt from '@slack/bolt';
-import { Server } from 'node:http';
-import { AgentTurnSource } from '@cuylabs/agent-core';
-import { Application } from 'express';
-import { c as createSlackChannelAdapter } from './adapter-vbqtraAr.js';
-import { a as SlackChannelOptions } from './types-BeGPexio.js';
-import { CreateSlackBoltAppOptions } from '@cuylabs/channel-slack/transports/http';
-import { SlackDirectAuthOptions, SlackDirectAuthMode } from '@cuylabs/channel-slack/auth';
-import '@cuylabs/channel-slack/core';
-import './options-CGUfVStV.js';
-import './artifacts/index.js';
-import '@cuylabs/channel-slack/artifacts';
-import './interactive-BigrPKnu.js';
-import '@cuylabs/channel-slack/interactive';
-
-interface MountSlackAgentOptions extends Omit<SlackChannelOptions, "agent" | "source">, Omit<CreateSlackBoltAppOptions, "app" | "path" | "botToken" | "signingSecret" | "auth"> {
-    /**
-     * Slack bot token (`xoxb-...`).
-     * @default process.env.SLACK_BOT_TOKEN
-     */
-    botToken?: string;
-    /**
-     * Slack signing secret used to verify incoming webhook requests.
-     * @default process.env.SLACK_SIGNING_SECRET
-     */
-    signingSecret?: string;
-    /**
-     * Structured direct-mode auth config.
-     *
-     * Use this for:
-     * - multi-workspace OAuth installs
-     * - custom Bolt authorize callbacks
-     *
-     * When omitted, `mountSlackAgent()` defaults to single-workspace mode
-     * using `botToken` / `SLACK_BOT_TOKEN`.
-     */
-    auth?: SlackDirectAuthOptions;
-    /**
-     * Exact Slack Events API callback path handled by Bolt.
-     *
-     * This becomes the request URL you configure in the Slack app:
-     * `https://<your-host>${path}`.
-     *
-     * @default "/slack/events"
-     */
-    path?: string;
-    /**
-     * Port to listen on.
-     * Set to `null` to skip `app.listen()` — caller manages the server.
-     * @default process.env.PORT || 3000
-     */
-    port?: number | null;
-    /**
-     * Optional host/interface passed to `app.listen(port, host)`.
-     */
-    host?: string;
-    /**
-     * Pre-existing Express app. If not provided, a new one is created.
-     *
-     * When provided, the Bolt receiver router is mounted on `path` and no
-     * internal `app.listen()` is called (the caller must start the server).
-     */
-    app?: Application;
-}
-interface MountSlackAgentResult {
-    /** The Express application */
-    app: Application;
-    /** The Bolt App instance */
-    boltApp: _slack_bolt.App;
-    /** The Bolt ExpressReceiver */
-    receiver: _slack_bolt.ExpressReceiver;
-    /** Resolved direct Slack auth mode */
-    authMode: SlackDirectAuthMode;
-    /** Exact Slack callback path handled by Bolt */
-    routePath: string;
-    /** The Slack channel adapter */
-    channelAdapter: ReturnType<typeof createSlackChannelAdapter>;
-    /** The Node HTTP server when `listen()` was started internally */
-    server?: Server;
-}
-/**
- * Mount an agent-core-compatible turn source as a Slack bot on an Express app.
- *
- * This is the simplest way to deploy an agent-core agent to Slack. It handles:
- * 1. Creating a Bolt `ExpressReceiver` with request verification.
- * 2. Creating a Bolt `App` using one of the supported direct auth modes.
- * 3. Creating the Slack channel adapter and mounting it on the Bolt App.
- * 4. Registering `receiver.router` on the Express app.
- * 5. Optionally starting the server.
- *
- * Single-workspace mode environment variables (if not passed explicitly):
- * - `SLACK_BOT_TOKEN` — Bot OAuth token (`xoxb-...`)
- * - `SLACK_SIGNING_SECRET` — App signing secret for request verification
- *
- * OAuth mode environment variables:
- * - `SLACK_SIGNING_SECRET`
- * - `SLACK_CLIENT_ID`
- * - `SLACK_CLIENT_SECRET`
- * - `SLACK_STATE_SECRET` unless you provide a custom state store
- */
-declare function mountSlackAgent(source: AgentTurnSource, options?: MountSlackAgentOptions): Promise<MountSlackAgentResult>;
-
-export { type MountSlackAgentOptions, type MountSlackAgentResult, mountSlackAgent };

package/dist/express.js

@@ -1,8 +0,0 @@
-import {
-  mountSlackAgent
-} from "./chunk-QFDXKCAQ.js";
-import "./chunk-KQPUQJ57.js";
-import "./chunk-L5RAGYVJ.js";
-export {
-  mountSlackAgent
-};

package/dist/feedback/index.d.ts

@@ -1 +0,0 @@
-export { RegisterSlackFeedbackOptions, SLACK_FEEDBACK_ACTION_ID, SlackFeedbackBlockOptions, SlackFeedbackButtonConfig, SlackFeedbackContext, SlackFeedbackContextBlock, SlackFeedbackHandler, SlackFeedbackVerdict, createSlackFeedbackBlock, registerSlackFeedbackAction } from '@cuylabs/channel-slack/feedback';

package/dist/feedback/index.js

@@ -1,10 +0,0 @@
-import {
-  SLACK_FEEDBACK_ACTION_ID,
-  createSlackFeedbackBlock,
-  registerSlackFeedbackAction
-} from "../chunk-ELR6MQD7.js";
-export {
-  SLACK_FEEDBACK_ACTION_ID,
-  createSlackFeedbackBlock,
-  registerSlackFeedbackAction
-};