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

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
-};

package/dist/interactive/index.d.ts

@@ -1,11 +0,0 @@
-import { b as SlackInteractiveControllerOptions, a as SlackInteractiveController } from '../types-Bz4OYEAV.js';
-export { S as SlackInteractiveApprovalRequest, c as SlackInteractiveHumanInputRequest, d as SlackInteractivePendingWaiter, e as SlackInteractivePostedMessage, f as SlackInteractiveRequestWaitOptions, g as SlackInteractiveResolution } from '../types-Bz4OYEAV.js';
-import '@cuylabs/agent-core';
-import '@cuylabs/channel-slack/interactive';
-import '@slack/bolt';
-import '../interactive-BigrPKnu.js';
-import '@cuylabs/channel-slack/core';
-
-declare function createSlackInteractiveController(options?: SlackInteractiveControllerOptions): SlackInteractiveController;
-
-export { SlackInteractiveController, SlackInteractiveControllerOptions, createSlackInteractiveController };

package/dist/interactive/index.js

@@ -1,6 +0,0 @@
-import {
-  createSlackInteractiveController
-} from "../chunk-OP27SSZU.js";
-export {
-  createSlackInteractiveController
-};

package/dist/interactive-BigrPKnu.d.ts

@@ -1,30 +0,0 @@
-import { AgentEvent } from '@cuylabs/agent-core';
-import { SlackInteractiveRequestBaseContext as SlackInteractiveRequestBaseContext$1, SlackInteractiveRequestContext as SlackInteractiveRequestContext$1 } from '@cuylabs/channel-slack/interactive';
-import { SlackActivityInfo, SlackUserIdentity } from '@cuylabs/channel-slack/core';
-
-/**
- * Agent Core interactive request contracts for the Slack event bridge.
- *
- * Generic Slack message/responder primitives live in `@cuylabs/channel-slack`.
- * This module narrows the request payloads to Agent Core events.
- */
-
-type SlackApprovalRequest = Extract<AgentEvent, {
-    type: "approval-request";
-}>["request"];
-type SlackHumanInputRequest = Extract<AgentEvent, {
-    type: "human-input-request";
-}>["request"];
-type SlackInteractiveRequest = SlackApprovalRequest | SlackHumanInputRequest;
-interface SlackInteractiveRequestBaseContext extends Omit<SlackInteractiveRequestBaseContext$1, "request"> {
-    request: SlackInteractiveRequest;
-}
-interface SlackInteractiveRequestContext extends Omit<SlackInteractiveRequestContext$1, "request"> {
-    slackActivity: SlackActivityInfo;
-    user: SlackUserIdentity;
-    request: SlackInteractiveRequest;
-}
-type SlackInteractiveRequestHandler = (context: SlackInteractiveRequestContext) => boolean | void | Promise<boolean | void>;
-type SlackEventInteractiveRequestHandler = (context: SlackInteractiveRequestBaseContext) => boolean | void | Promise<boolean | void>;
-
-export type { SlackApprovalRequest as S, SlackEventInteractiveRequestHandler as a, SlackHumanInputRequest as b, SlackInteractiveRequest as c, SlackInteractiveRequestBaseContext as d, SlackInteractiveRequestContext as e, SlackInteractiveRequestHandler as f };