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

package/dist/shared/index.d.ts

@@ -1,36 +1,159 @@
 export { D as DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY, S as SlackContextFragmentMiddlewareOptions, a as SlackContextFragmentPayload, b as SlackContextFragmentResolver, c as SlackContextFragmentResolverContext, d as createSlackContextFragmentMiddleware } from '../context-fragments-CQEDcjYR.js';
-import { AgentEvent } from '@cuylabs/agent-core';
-import { S as SlackEventBridgeOptions } from '../options-CGUfVStV.js';
-export { r as resolveSlackEventBridgeOptions } from '../options-CGUfVStV.js';
+import { AgentEvent, ApprovalEvent, AgentTurnSource } from '@cuylabs/agent-core';
 import { SlackResponseSink } from '@cuylabs/channel-slack/responses';
-export { S as SlackApprovalRequest, a as SlackEventInteractiveRequestHandler, b as SlackHumanInputRequest, c as SlackInteractiveRequest, d as SlackInteractiveRequestBaseContext, e as SlackInteractiveRequestContext, f as SlackInteractiveRequestHandler } from '../interactive-BigrPKnu.js';
+import { SlackFinalResponseArtifactPublisher, SlackFinalResponseArtifactDeliveryMode, SlackFinalResponseArtifactContext, SlackFinalResponseArtifactResult, SlackTurnEvent, SlackEventBridgeOptions as SlackEventBridgeOptions$1, SlackTurnSource } from '@cuylabs/channel-slack/runtime';
+import { a as SlackEventInteractiveRequestHandler } from '../interactive-BigrPKnu.js';
+export { S as SlackApprovalRequest, b as SlackHumanInputRequest, c as SlackInteractiveRequest, d as SlackInteractiveRequestBaseContext, e as SlackInteractiveRequestContext, f as SlackInteractiveRequestHandler } from '../interactive-BigrPKnu.js';
 import '@cuylabs/channel-slack/core';
-import '../artifacts/index.js';
-import '@cuylabs/channel-slack/artifacts';
 import '@cuylabs/channel-slack/interactive';
 
 /**
- * Event bridge — maps an agent-core `AgentEvent` stream to a Slack
- * conversation via a `SlackResponseSink`.
- *
- * | Mode           | Behaviour                                              |
- * |----------------|--------------------------------------------------------|
- * | `progressive`  | Posts a placeholder, updates it as text accumulates.   |
- * | `accumulate`   | Collects the full response then posts it in one shot.  |
- * | `chat-stream`  | Uses Slack's native `chat.startStream` + append + stop |
+ * Event-bridge configuration. The bridge is mode-aware (progressive,
+ * accumulate, chat-stream) and these options control formatting, status
+ * propagation, interactive-request handling, and chat-stream finalization.
+ */
+
+type HumanInputEvent = Extract<AgentEvent, {
+    type: "human-input-request";
+}>["request"];
+type ToolStartEvent = Extract<AgentEvent, {
+    type: "tool-start";
+}>;
+type ToolResultEvent = Extract<AgentEvent, {
+    type: "tool-result";
+}>;
+interface SlackEventBridgeOptions {
+    showReasoning: boolean;
+    /** Render root-agent tool rows/status updates. */
+    showToolUsage: boolean;
+    /** Render subagent child tool rows in the parent Slack task timeline. */
+    showSubagentToolUsage: boolean;
+    /** Include full subagent completion output in the subagent task row. */
+    showSubagentResultInTask: boolean;
+    formatToolTitle?: (toolName: string) => string;
+    formatToolUpdate: (toolName: string) => string;
+    formatToolDetails?: (event: ToolStartEvent) => string | undefined;
+    /**
+     * Format the completed tool output shown in Slack task rows.
+     *
+     * Return `undefined` to use the default generic formatter. Return `null` to
+     * intentionally omit task-row output for this tool result.
+     */
+    formatToolResultOutput?: (event: ToolResultEvent) => string | null | undefined;
+    formatToolError: (toolName: string, error: string) => string;
+    formatReasoningUpdate: () => string;
+    formatMessageText: (text: string) => string;
+    streamingMode: "progressive" | "accumulate" | "chat-stream";
+    progressiveUpdateThreshold: number;
+    progressiveUpdateIntervalMs: number;
+    chatStreamBufferSize: number;
+    /**
+     * Maximum number of Slack task-update chunks the bridge will append to a
+     * single chat stream. Task rows are a bounded UI projection, not a durable
+     * event log.
+     */
+    maxTaskUpdates: number;
+    /**
+     * Maximum cumulative characters from task titles/details/output that the
+     * bridge will append to one chat stream.
+     */
+    maxTaskUpdateTextChars: number;
+    /**
+     * Maximum characters for a single task details/output field.
+     */
+    maxTaskUpdateFieldChars: number;
+    interactiveMode: "message-and-error" | "ignore";
+    handleInteractiveRequest?: SlackEventInteractiveRequestHandler;
+    formatApprovalRequired: (request: ApprovalEvent) => string;
+    formatHumanInputRequired: (request: HumanInputEvent) => string;
+    /**
+     * Optional hook called whenever the bridge's status label changes — used by
+     * the assistant bridge to update the assistant pane's status line via
+     * `assistant.threads.setStatus`. Errors are swallowed by the caller.
+     */
+    onStatusChange?: (label: string, event: AgentEvent | undefined) => void | Promise<void>;
+    /**
+     * Optional final-args passthrough for `chatStream.stop(...)`. When the
+     * bridge stops the chat stream on `complete`, these args (e.g. final
+     * `blocks` for a feedback widget) are merged into the `stop` call. The
+     * existing `markdown_text` final-text fallback always wins on text fields.
+     */
+    chatStreamFinalArgs?: {
+        blocks?: unknown[];
+    } & Record<string, unknown>;
+    /**
+     * Optional post-processing hook for publishing a rich artifact from the final
+     * accumulated response, such as a Slack Canvas for long answers.
+     */
+    publishFinalResponseArtifact?: SlackFinalResponseArtifactPublisher;
+    /**
+     * Controls whether artifact publication is additive or becomes the primary
+     * final-answer surface.
+     *
+     * - `supplemental`: finalize the Slack text normally, then publish artifact.
+     * - `replace`: publish artifact first and use a compact Slack final message.
+     *
+     * @default "supplemental"
+     */
+    finalResponseArtifactMode?: SlackFinalResponseArtifactDeliveryMode;
+    /**
+     * When replacement mode is active, continue streaming text up to this many
+     * raw characters, then suppress further text deltas and publish the full
+     * answer as an artifact at completion. This preserves normal short-answer
+     * streaming without flooding Slack for long answers.
+     *
+     * @default 4000
+     */
+    finalResponseArtifactStreamThreshold?: number;
+    /**
+     * Notice appended when replacement mode suppresses the remaining text stream.
+     */
+    formatFinalResponseArtifactContinuationNotice?: (context: Pick<SlackFinalResponseArtifactContext, "text" | "formattedText">) => string;
+    /**
+     * Final compact message used when an artifact replaces the full Slack text.
+     */
+    formatFinalResponseArtifactMessage?: (result: SlackFinalResponseArtifactResult, context: SlackFinalResponseArtifactContext) => string;
+    /**
+     * Called when `publishFinalResponseArtifact` throws. Errors from this hook
+     * are swallowed so artifact publication cannot break a completed turn.
+     */
+    onFinalResponseArtifactError?: (error: unknown, context: SlackFinalResponseArtifactContext) => void | Promise<void>;
+}
+declare function resolveSlackEventBridgeOptions(partial: Partial<SlackEventBridgeOptions>): SlackEventBridgeOptions;
+
+/**
+ * Agent Core compatibility bridge.
  *
- * The three modes share enough state (full-response accumulator, status
- * label, last-update offset) that they live in one function. Per-mode
- * branches are clearly labelled inside the event loop.
+ * The Slack renderer itself lives in `@cuylabs/channel-slack/runtime` and
+ * consumes runtime-neutral `SlackTurnEvent`s. This adapter keeps the existing
+ * `bridgeAgentEventsToSlack` API and owns the explicit Agent Core to Slack
+ * runtime mapping.
  */
 
 /**
- * Stream agent-core events to a Slack conversation via `SlackResponseSink`.
+ * Stream Agent Core events to a Slack conversation via `SlackResponseSink`.
  *
  * @returns The full accumulated response text.
  */
 declare function bridgeAgentEventsToSlack(events: AsyncGenerator<AgentEvent>, sink: SlackResponseSink, options: SlackEventBridgeOptions): Promise<string>;
 
+/**
+ * Agent Core to Slack runtime event mapping.
+ *
+ * This file is the compatibility boundary between `@cuylabs/agent-core` and
+ * the runtime-neutral Slack renderer in `@cuylabs/channel-slack/runtime`.
+ */
+
+declare function mapAgentEventToSlackTurnEvent(event: AgentEvent): SlackTurnEvent;
+
+/**
+ * Adapter from Agent Core bridge options to runtime-neutral Slack bridge
+ * options. Function-valued options are wrapped so Agent Core-specific event
+ * types do not leak into `@cuylabs/channel-slack/runtime`.
+ */
+
+declare function mapAgentSlackEventBridgeOptionsToRuntimeOptions(options: SlackEventBridgeOptions): SlackEventBridgeOptions$1;
+
 /**
  * Interactive-request error type raised when an `approval-request` or
  * `human-input-request` event reaches the Slack transport in a mode that
@@ -45,4 +168,6 @@ declare class UnsupportedSlackInteractiveRequestError extends Error {
     constructor(kind: "approval" | "human-input", requestId: string, message: string);
 }
 
-export { SlackEventBridgeOptions, UnsupportedSlackInteractiveRequestError, bridgeAgentEventsToSlack };
+declare function adaptAgentTurnSourceToSlackTurnSource(source: AgentTurnSource): SlackTurnSource;
+
+export { type SlackEventBridgeOptions, SlackEventInteractiveRequestHandler, UnsupportedSlackInteractiveRequestError, adaptAgentTurnSourceToSlackTurnSource, bridgeAgentEventsToSlack, mapAgentEventToSlackTurnEvent, mapAgentSlackEventBridgeOptionsToRuntimeOptions, resolveSlackEventBridgeOptions };

package/dist/shared/index.js

@@ -1,16 +1,20 @@
 import {
   DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY,
-  createSlackContextFragmentMiddleware
-} from "../chunk-A2PLAVW6.js";
-import {
   UnsupportedSlackInteractiveRequestError,
+  adaptAgentTurnSourceToSlackTurnSource,
   bridgeAgentEventsToSlack,
+  createSlackContextFragmentMiddleware,
+  mapAgentEventToSlackTurnEvent,
+  mapAgentSlackEventBridgeOptionsToRuntimeOptions,
   resolveSlackEventBridgeOptions
-} from "../chunk-VBGQD6JT.js";
+} from "../chunk-U6RC4SXN.js";
 export {
   DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY,
   UnsupportedSlackInteractiveRequestError,
+  adaptAgentTurnSourceToSlackTurnSource,
   bridgeAgentEventsToSlack,
   createSlackContextFragmentMiddleware,
+  mapAgentEventToSlackTurnEvent,
+  mapAgentSlackEventBridgeOptionsToRuntimeOptions,
   resolveSlackEventBridgeOptions
 };

package/docs/README.md

@@ -15,4 +15,3 @@ and human-input requests.
 - [Final response artifacts](concepts/final-response-artifacts.md)
 - [Interactive requests](concepts/interactive-requests.md)
 - [Tool task rendering](concepts/tool-task-rendering.md)
-- [View workflows](concepts/view-workflows.md)

package/docs/concepts/final-response-artifacts.md

@@ -1,12 +1,14 @@
 # Final Response Artifacts
 
-Final response artifacts let a Slack host publish a rich surface from the
-completed Agent Core response. The first built-in publisher creates a Slack
-Canvas for long answers and can fall back to a text file when Canvas
-publication is unavailable.
+Final response artifacts let a Slack host publish a rich surface from a
+completed Slack turn response. The built-in publisher creates a Slack Canvas
+for long answers and can fall back to a text file when Canvas publication is
+unavailable.
 
 ```typescript
-import { createSlackFinalResponseArtifactPublisher } from "@cuylabs/channel-slack-agent-core/artifacts";
+import { mountSlackApp } from "@cuylabs/channel-slack/app";
+import { createSlackFinalResponseArtifactPublisher } from "@cuylabs/channel-slack/artifacts";
+import { adaptAgentTurnSourceToSlackTurnSource } from "@cuylabs/channel-slack-agent-core";
 
 const publishFinalResponseArtifact = createSlackFinalResponseArtifactPublisher({
   minCharacters: 4000,
@@ -14,8 +16,8 @@ const publishFinalResponseArtifact = createSlackFinalResponseArtifactPublisher({
   fallback: "file",
 });
 
-await mountSlackAgentApp({
-  source,
+await mountSlackApp({
+  source: adaptAgentTurnSourceToSlackTurnSource(agent),
   publishFinalResponseArtifact,
   finalResponseArtifactMode: "replace",
   finalResponseArtifactStreamThreshold: 4000,

package/docs/concepts/tool-task-rendering.md

@@ -19,6 +19,8 @@ Core. Return `undefined` to use the default formatter. Return `null` to omit the
 completed task output intentionally.
 
 ```ts
+import { createSlackChannelAdapter } from "@cuylabs/channel-slack/adapter";
+
 createSlackChannelAdapter({
   source,
   streamingMode: "chat-stream",

package/docs/reference/exports.md

@@ -1,26 +1,16 @@
 # Exports
 
-Use feature subpaths when you only need one adapter surface. Generic Slack
-primitives should be imported from `@cuylabs/channel-slack` directly.
+Use feature subpaths when you only need one Agent Core binding. Generic Slack
+mounts and primitives must be imported from `@cuylabs/channel-slack` directly.
 
-| Export                                                | Depends on                                          | Notes                                                                             |
-| ----------------------------------------------------- | --------------------------------------------------- | --------------------------------------------------------------------------------- |
-| `@cuylabs/channel-slack-agent-core`                   | `@cuylabs/agent-core`, selected Slack peers         | Full adapter surface re-export                                                    |
-| `@cuylabs/channel-slack-agent-core/adapter`           | `@slack/bolt`, `@slack/web-api` types               | Classic app mention, DM, and passive channel-message adapter                      |
-| `@cuylabs/channel-slack-agent-core/app`               | `@slack/bolt`, `@slack/web-api`                     | Direct app factory for mounted Slack surfaces                                     |
-| `@cuylabs/channel-slack-agent-core/app-surface`       | `@slack/bolt`, `@slack/web-api` types               | Shared surface installer for Assistant, mentions, DMs, feedback, and interactions |
-| `@cuylabs/channel-slack-agent-core/artifacts`         | `@cuylabs/channel-slack/artifacts`                  | Agent Core final-response artifact publishers for Slack surfaces                  |
-| `@cuylabs/channel-slack-agent-core/assistant`         | `@slack/bolt`, `@slack/web-api` types               | Slack Assistant bridge and lifecycle handlers                                     |
-| `@cuylabs/channel-slack-agent-core/express`           | `@slack/bolt`, `express`                            | Express Events API mounting for classic Slack surfaces                            |
-| `@cuylabs/channel-slack-agent-core/express-assistant` | `@slack/bolt`, `express`                            | Express Events API mounting for Slack Assistant                                   |
-| `@cuylabs/channel-slack-agent-core/feedback`          | `@slack/bolt`, `@slack/types`                       | Agent Core feedback binding helpers                                               |
-| `@cuylabs/channel-slack-agent-core/history`           | `@slack/web-api`, `@cuylabs/agent-core` types       | Agent Core turn history context fragment assembly                                 |
-| `@cuylabs/channel-slack-agent-core/interactive`       | `@slack/bolt`, `@cuylabs/channel-slack/interactive` | Agent Core approval and human-input controller binding for Slack                  |
-| `@cuylabs/channel-slack-agent-core/mcp`               | `@cuylabs/agent-core/mcp` types                     | Slack OAuth token bridge for Agent Core MCP setup                                 |
-| `@cuylabs/channel-slack-agent-core/shared`            | `@cuylabs/agent-core` types                         | Context fragments, event bridge, and Agent Core interactive request contracts     |
-| `@cuylabs/channel-slack-agent-core/socket`            | `@slack/bolt`                                       | Socket Mode mounting helpers                                                      |
-| `@cuylabs/channel-slack-agent-core/source`            | `@cuylabs/agent-core` types                         | Source event queue, response helpers, and status visibility helpers               |
-| `@cuylabs/channel-slack-agent-core/views`             | `@cuylabs/channel-slack/views`, `@slack/bolt`       | Agent/product Slack modal workflow controller and submitted state helpers         |
+| Export                                      | Depends on                                          | Notes                                                                         |
+| ------------------------------------------- | --------------------------------------------------- | ----------------------------------------------------------------------------- |
+| `@cuylabs/channel-slack-agent-core`         | `@cuylabs/agent-core`                               | Agent Core event bridge, context fragments, history, interactive, source, MCP |
+| `@cuylabs/channel-slack-agent-core/history` | `@slack/web-api`, `@cuylabs/agent-core` types       | Agent Core turn history context fragment assembly                             |
+| `@cuylabs/channel-slack-agent-core/interactive` | `@slack/bolt`, `@cuylabs/channel-slack/interactive` | Agent Core approval and human-input controller binding for Slack              |
+| `@cuylabs/channel-slack-agent-core/mcp`     | `@cuylabs/agent-core/mcp` types                     | Slack OAuth token bridge for Agent Core MCP setup                             |
+| `@cuylabs/channel-slack-agent-core/shared`  | `@cuylabs/agent-core` types                         | Context fragments, Agent Core event mapping, and source adaptation            |
+| `@cuylabs/channel-slack-agent-core/source`  | `@cuylabs/agent-core` types                         | Agent Core event queue, response helpers, and status visibility helpers       |
 
 For generic Slack package exports, see
 `@cuylabs/channel-slack/docs/reference/exports.md`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cuylabs/channel-slack-agent-core",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Slack adapter for @cuylabs/agent-core built on @cuylabs/channel-slack",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,46 +11,6 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
-    "./adapter": {
-      "types": "./dist/adapter/index.d.ts",
-      "import": "./dist/adapter/index.js",
-      "default": "./dist/adapter/index.js"
-    },
-    "./app": {
-      "types": "./dist/app.d.ts",
-      "import": "./dist/app.js",
-      "default": "./dist/app.js"
-    },
-    "./app-surface": {
-      "types": "./dist/app-surface.d.ts",
-      "import": "./dist/app-surface.js",
-      "default": "./dist/app-surface.js"
-    },
-    "./artifacts": {
-      "types": "./dist/artifacts/index.d.ts",
-      "import": "./dist/artifacts/index.js",
-      "default": "./dist/artifacts/index.js"
-    },
-    "./assistant": {
-      "types": "./dist/assistant/index.d.ts",
-      "import": "./dist/assistant/index.js",
-      "default": "./dist/assistant/index.js"
-    },
-    "./express": {
-      "types": "./dist/express.d.ts",
-      "import": "./dist/express.js",
-      "default": "./dist/express.js"
-    },
-    "./express-assistant": {
-      "types": "./dist/express-assistant.d.ts",
-      "import": "./dist/express-assistant.js",
-      "default": "./dist/express-assistant.js"
-    },
-    "./feedback": {
-      "types": "./dist/feedback/index.d.ts",
-      "import": "./dist/feedback/index.js",
-      "default": "./dist/feedback/index.js"
-    },
     "./history": {
       "types": "./dist/history/index.d.ts",
       "import": "./dist/history/index.js",
@@ -71,20 +31,10 @@
       "import": "./dist/shared/index.js",
       "default": "./dist/shared/index.js"
     },
-    "./socket": {
-      "types": "./dist/socket.d.ts",
-      "import": "./dist/socket.js",
-      "default": "./dist/socket.js"
-    },
     "./source": {
       "types": "./dist/source/index.d.ts",
       "import": "./dist/source/index.js",
       "default": "./dist/source/index.js"
-    },
-    "./views": {
-      "types": "./dist/views/index.d.ts",
-      "import": "./dist/views/index.js",
-      "default": "./dist/views/index.js"
     }
   },
   "files": [
@@ -94,7 +44,7 @@
   ],
   "dependencies": {
     "@cuylabs/agent-core": "^7.2.0",
-    "@cuylabs/channel-slack": "^0.9.0"
+    "@cuylabs/channel-slack": "^0.11.0"
   },
   "peerDependencies": {
     "@slack/bolt": ">=4.7.3",
@@ -144,9 +94,9 @@
     "node": ">=20"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/shared/index.ts src/adapter/index.ts src/app.ts src/app-surface.ts src/artifacts/index.ts src/assistant/index.ts src/express.ts src/express-assistant.ts src/feedback/index.ts src/history/index.ts src/interactive/index.ts src/mcp.ts src/socket.ts src/source/index.ts src/views/index.ts --format esm --dts --clean",
+    "build": "tsup src/index.ts src/shared/index.ts src/history/index.ts src/interactive/index.ts src/mcp.ts src/source/index.ts --format esm --dts --clean",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts src/shared/index.ts src/adapter/index.ts src/app.ts src/app-surface.ts src/artifacts/index.ts src/assistant/index.ts src/express.ts src/express-assistant.ts src/feedback/index.ts src/history/index.ts src/interactive/index.ts src/mcp.ts src/socket.ts src/source/index.ts src/views/index.ts --format esm --dts --watch",
+    "dev": "tsup src/index.ts src/shared/index.ts src/history/index.ts src/interactive/index.ts src/mcp.ts src/source/index.ts --format esm --dts --watch",
     "lint": "eslint \"src/**/*.{ts,tsx}\" \"tests/**/*.{ts,tsx}\" --max-warnings=0",
     "test": "vitest run",
     "test:watch": "vitest",

package/dist/adapter/index.d.ts

@@ -1,26 +0,0 @@
-export { c as createSlackChannelAdapter } from '../adapter-vbqtraAr.js';
-import { a as SlackChannelOptions } from '../types-BeGPexio.js';
-export { S as SlackChannelAdapter, b as SlackSessionStrategy, c as SlackStreamingMode, d as SlackToolStartEvent } from '../types-BeGPexio.js';
-import { SlackActivityInfo } from '@cuylabs/channel-slack/core';
-import '@cuylabs/agent-core';
-import '../options-CGUfVStV.js';
-import '../artifacts/index.js';
-import '@cuylabs/channel-slack/artifacts';
-import '../interactive-BigrPKnu.js';
-import '@cuylabs/channel-slack/interactive';
-
-/**
- * Session mapping — Slack activity info to agent-core session IDs.
- *
- * The default strategy (`"thread-aware"`) produces natural conversation
- * groupings by using the thread timestamp when present and falling back to
- * the channel ID for DMs and top-level messages.
- */
-
-interface SlackSessionMap {
-    /** Resolve (or create) a session ID for the given Slack activity. */
-    resolve(info: SlackActivityInfo): string | Promise<string>;
-}
-declare function createSlackSessionMap(options: SlackChannelOptions): SlackSessionMap;
-
-export { SlackChannelOptions, type SlackSessionMap, createSlackSessionMap };

package/dist/adapter/index.js

@@ -1,9 +0,0 @@
-import {
-  createSlackChannelAdapter,
-  createSlackSessionMap
-} from "../chunk-XA7U3GRN.js";
-import "../chunk-VBGQD6JT.js";
-export {
-  createSlackChannelAdapter,
-  createSlackSessionMap
-};

package/dist/adapter-vbqtraAr.d.ts

@@ -1,31 +0,0 @@
-import { a as SlackChannelOptions, S as SlackChannelAdapter } from './types-BeGPexio.js';
-
-/**
- * Slack Channel Adapter
- *
- * Creates a configured Bolt handler that bridges an agent-core Agent (or any
- * `AgentTurnSource`) to Slack via @slack/bolt.
- *
- * The adapter mounts message/event handlers on a Bolt `App` instance and
- * processes each turn by:
- * 1. Parsing the Slack event into a `SlackActivityInfo`.
- * 2. Resolving a session ID via the configured session strategy.
- * 3. Calling `source.chat()` with the user message.
- * 4. Streaming the response back to Slack via progressive updates or a
- *    single final post.
- *
- * @example
- * ```ts
- * import { App } from "@slack/bolt";
- * import { createSlackChannelAdapter } from "@cuylabs/channel-slack-agent-core";
- *
- * const app = new App({ token: process.env.SLACK_BOT_TOKEN, signingSecret: process.env.SLACK_SIGNING_SECRET });
- * const adapter = createSlackChannelAdapter({ agent });
- * adapter.mount(app);
- * await app.start(3000);
- * ```
- */
-
-declare function createSlackChannelAdapter(options: SlackChannelOptions): SlackChannelAdapter;
-
-export { createSlackChannelAdapter as c };

package/dist/app-surface.d.ts

@@ -1,82 +0,0 @@
-import { AgentTurnSource, Logger } from '@cuylabs/agent-core';
-import { App } from '@slack/bolt';
-import { WebClient } from '@slack/web-api';
-import { C as CreateSlackAssistantBridgeOptions, d as SlackAssistantFeedbackConfig, S as SlackAssistantBridge } from './options-ByNm2o89.js';
-import { a as SlackChannelOptions } from './types-BeGPexio.js';
-import { SlackTurnRequestContext, SlackAssistantUtilities, SlackTurnPreparation } from '@cuylabs/channel-slack/core';
-import { SlackFeedbackHandler } from '@cuylabs/channel-slack/feedback';
-import { a as SlackInteractiveController } from './types-Bz4OYEAV.js';
-import { d as SlackAgentViewWorkflowController } from './types-CiwGU6zC.js';
-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';
-import '@cuylabs/channel-slack/views';
-
-/**
- * Shared installer for the direct Slack app surfaces.
- *
- * HTTP Events API and Socket Mode differ only in how Bolt receives inbound
- * events. The Assistant pane, app_mention, DM/channel routing, feedback, and
- * interactive request wiring are mounted here so both transports behave the
- * same.
- */
-
-interface MountSlackAgentAppTurnRequestContext extends SlackTurnRequestContext {
-    /** Present only for Assistant-pane turns. */
-    assistant?: SlackAssistantUtilities;
-    /** Present for Assistant-pane turns; use direct history helpers for Slack API context. */
-    client?: WebClient;
-    /** Raw Bolt assistant args for advanced hosts. */
-    rawArgs?: unknown;
-}
-interface SlackAgentAppSurfaceOptions extends Omit<CreateSlackAssistantBridgeOptions, "feedback" | "source" | "prepareTurn" | "resolveSession" | "handleInteractiveRequest"> {
-    /** Source of agent turns. */
-    source: AgentTurnSource;
-    /**
-     * Prepare an agent turn for every direct Slack surface registered by this
-     * mount: Assistant pane, @mentions, and DMs.
-     */
-    prepareTurn?: (request: MountSlackAgentAppTurnRequestContext) => SlackTurnPreparation | Promise<SlackTurnPreparation>;
-    /**
-     * Resolve the agent session for every direct Slack surface. Returning
-     * `undefined` falls back to the configured session strategy.
-     */
-    resolveSession?: (request: MountSlackAgentAppTurnRequestContext) => string | undefined | Promise<string | undefined>;
-    /** Register `app.event("app_mention", ...)`. @default true */
-    respondToMentions?: boolean;
-    /** Register `app.message(...)` for DMs. @default true */
-    respondToMessages?: boolean;
-    /** Forward plain channel/group messages too. @default false */
-    respondToChannelMessages?: boolean;
-    /** Resolve or skip classic Slack channel-adapter messages. Return undefined to skip. */
-    resolveMessage?: SlackChannelOptions["resolveMessage"];
-    /** Feedback config. Pass `false` to omit feedback blocks. */
-    feedback?: SlackAssistantFeedbackConfig | false;
-    /** Convenience feedback handler. Ignored when `feedback` is set. */
-    onFeedback?: SlackFeedbackHandler;
-    /** Maximum turn runtime in ms. Set `0` to disable. @default 120_000 */
-    timeoutMs?: number;
-    /** Optional logger for diagnostics. */
-    logger?: Logger;
-    /**
-     * Slack-native approval/human-input controller. Pair this with
-     * `interactive.approval.onRequest` / `interactive.humanInput.onRequest` in
-     * the agent config, or with `interactive.onResolve` for server-backed turns.
-     */
-    interactive?: SlackInteractiveController;
-    /**
-     * Product/agent Slack modal workflow controller. Use this for workflows that
-     * are richer than approval/human-input, such as incident triage forms or
-     * report-generation setup modals.
-     */
-    viewWorkflows?: SlackAgentViewWorkflowController;
-}
-interface SlackAgentAppSurfaceResult {
-    bridge: SlackAssistantBridge;
-}
-declare function installSlackAgentAppSurface(boltApp: App, options: SlackAgentAppSurfaceOptions): SlackAgentAppSurfaceResult;
-
-export { type MountSlackAgentAppTurnRequestContext, type SlackAgentAppSurfaceOptions, type SlackAgentAppSurfaceResult, installSlackAgentAppSurface };

package/dist/app-surface.js

@@ -1,10 +0,0 @@
-import {
-  installSlackAgentAppSurface
-} from "./chunk-GKZRDNEB.js";
-import "./chunk-FJP6ZFUB.js";
-import "./chunk-ELR6MQD7.js";
-import "./chunk-XA7U3GRN.js";
-import "./chunk-VBGQD6JT.js";
-export {
-  installSlackAgentAppSurface
-};

package/dist/app.d.ts

@@ -1,60 +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 { SlackAgentAppSurfaceOptions } from './app-surface.js';
-export { MountSlackAgentAppTurnRequestContext } from './app-surface.js';
-import { S as SlackAssistantBridge } from './options-ByNm2o89.js';
-import '@cuylabs/agent-core';
-import '@slack/web-api';
-import './types-BeGPexio.js';
-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';
-import '@cuylabs/channel-slack/feedback';
-import './types-Bz4OYEAV.js';
-import './types-CiwGU6zC.js';
-import '@cuylabs/channel-slack/views';
-import '@cuylabs/channel-slack/assistant';
-
-/**
- * Unified Slack agent app over the HTTP Events API.
- *
- * This file owns only the HTTP/Bolt receiver lifecycle. The actual Slack
- * surfaces (Assistant pane, app mentions, DMs/channel messages, feedback, and
- * interactive requests) are mounted by `installSlackAgentAppSurface` so Socket
- * Mode gets the exact same behavior.
- */
-
-interface MountSlackAgentAppOptions extends SlackAgentAppSurfaceOptions, Omit<CreateSlackBoltAppOptions, "app" | "path" | "botToken" | "signingSecret" | "auth"> {
-    /** Slack bot token (`xoxb-...`). @default process.env.SLACK_BOT_TOKEN */
-    botToken?: string;
-    /** Slack signing secret. @default process.env.SLACK_SIGNING_SECRET */
-    signingSecret?: string;
-    /** Direct-mode auth config (single-workspace, OAuth, custom). */
-    auth?: SlackDirectAuthOptions;
-    /** Slack Events API callback path. @default "/slack/events" */
-    path?: string;
-    /** Port to listen on. @default process.env.PORT || 3000 */
-    port?: number | null;
-    /** Optional host for `app.listen(port, host)`. */
-    host?: string;
-    /** Pre-existing Express app. */
-    app?: Application;
-}
-interface MountSlackAgentAppResult {
-    app: Application;
-    boltApp: App;
-    receiver: ExpressReceiver;
-    authMode: SlackDirectAuthMode;
-    routePath: string;
-    bridge: SlackAssistantBridge;
-    server?: Server;
-}
-declare function mountSlackAgentApp(options: MountSlackAgentAppOptions): Promise<MountSlackAgentAppResult>;
-
-export { type MountSlackAgentAppOptions, type MountSlackAgentAppResult, mountSlackAgentApp };

package/dist/app.js

@@ -1,11 +0,0 @@
-import {
-  mountSlackAgentApp
-} from "./chunk-KAEZPS3U.js";
-import "./chunk-GKZRDNEB.js";
-import "./chunk-FJP6ZFUB.js";
-import "./chunk-ELR6MQD7.js";
-import "./chunk-XA7U3GRN.js";
-import "./chunk-VBGQD6JT.js";
-export {
-  mountSlackAgentApp
-};