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

package/README.md

@@ -3,13 +3,17 @@
 Slack adapter for `@cuylabs/agent-core`, built on
 `@cuylabs/channel-slack`.
 
-Use this package when an Agent Core application needs ready-to-mount Slack
-surfaces for Express Events API, Socket Mode, Slack Assistant, app mentions,
-DMs, feedback, approvals, or human input.
+Use this package when an Agent Core application needs Agent Core-specific Slack
+bindings: event mapping, source adaptation, context fragments, history helpers,
+or MCP token bridging.
 
-Generic Slack mechanics such as parsing, policy, history, setup, auth, targets,
-users, entrypoints, artifacts, interactive stores/builders, response sinks, and
-transports live in `@cuylabs/channel-slack`.
+Generic Slack mechanics, mounts, Assistant rendering, classic message routing,
+feedback, artifacts, interactive request rendering/storage and controller
+wiring, response sinks, and transports live in `@cuylabs/channel-slack`.
+
+For Slack-native approvals and human input, import the controller from
+`@cuylabs/channel-slack/interactive`; this package does not provide an
+`interactive` subpath.
 
 ## Install
 
@@ -33,10 +37,11 @@ without injecting its own client.
 Socket Mode:
 
 ```typescript
-import { mountSlackAssistantAgentSocket } from "@cuylabs/channel-slack-agent-core";
+import { mountSlackAppSocket } from "@cuylabs/channel-slack/socket";
+import { adaptAgentTurnSourceToSlackTurnSource } from "@cuylabs/channel-slack-agent-core";
 
-await mountSlackAssistantAgentSocket({
-  source: agent,
+await mountSlackAppSocket({
+  source: adaptAgentTurnSourceToSlackTurnSource(agent),
   appToken: process.env.SLACK_APP_TOKEN,
   botToken: process.env.SLACK_BOT_TOKEN,
 });
@@ -45,9 +50,11 @@ await mountSlackAssistantAgentSocket({
 Express Events API:
 
 ```typescript
-import { mountSlackAgent } from "@cuylabs/channel-slack-agent-core";
+import { mountSlackApp } from "@cuylabs/channel-slack/app";
+import { adaptAgentTurnSourceToSlackTurnSource } from "@cuylabs/channel-slack-agent-core";
 
-await mountSlackAgent(agent, {
+await mountSlackApp({
+  source: adaptAgentTurnSourceToSlackTurnSource(agent),
   botToken: process.env.SLACK_BOT_TOKEN,
   signingSecret: process.env.SLACK_SIGNING_SECRET,
 });

package/dist/{chunk-L5RAGYVJ.js → chunk-U6RC4SXN.js}

@@ -1,3 +1,74 @@
+// src/shared/context-fragments.ts
+import {
+  currentSlackTurnContext
+} from "@cuylabs/channel-slack/core";
+var DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY = "slackContextFragment";
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isPayload(value) {
+  return isRecord(value) && typeof value.content === "string";
+}
+function resolveContextBagValue(slack, key) {
+  const value = slack.context?.[key];
+  if (typeof value === "string") {
+    return value;
+  }
+  if (isPayload(value)) {
+    return value;
+  }
+  return void 0;
+}
+function resolveDedupeKey(options, context) {
+  return typeof options.dedupeKey === "function" ? options.dedupeKey(context) : options.dedupeKey;
+}
+function resolveMetadata(options, context) {
+  return typeof options.metadata === "function" ? options.metadata(context) : options.metadata;
+}
+function normalizeFragment(resolved, options, context) {
+  const payload = typeof resolved === "string" ? { content: resolved } : isPayload(resolved) ? resolved : void 0;
+  if (!payload) {
+    return resolved;
+  }
+  if (payload.content.trim().length === 0) {
+    return void 0;
+  }
+  const dedupeKey = payload.dedupeKey ?? resolveDedupeKey(options, context);
+  const metadata = payload.metadata ?? resolveMetadata(options, context);
+  const maxChars = payload.maxChars ?? options.maxChars;
+  return {
+    kind: payload.kind ?? options.kind ?? "slack-context",
+    content: payload.content,
+    role: payload.role ?? options.role ?? "user",
+    placement: payload.placement ?? options.placement ?? "after-latest-user",
+    lifetime: payload.lifetime ?? options.lifetime ?? "turn",
+    source: payload.source ?? options.source ?? "slack",
+    title: payload.title ?? options.title ?? "Slack Context",
+    budgetBehavior: payload.budgetBehavior ?? options.budgetBehavior ?? "droppable",
+    ...maxChars !== void 0 ? { maxChars } : {},
+    ...dedupeKey ? { dedupeKey } : {},
+    ...metadata ? { metadata } : {}
+  };
+}
+function createSlackContextFragmentMiddleware(options = {}) {
+  const contextKey = options.contextKey ?? DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY;
+  return {
+    name: options.name ?? "slack-context-fragment",
+    async contextFragments(step) {
+      const slack = currentSlackTurnContext();
+      if (!slack) {
+        return void 0;
+      }
+      const context = { slack, step };
+      const resolved = options.resolve ? await options.resolve(context) : resolveContextBagValue(slack, contextKey);
+      if (resolved === void 0) {
+        return void 0;
+      }
+      return normalizeFragment(resolved, options, context);
+    }
+  };
+}
+
 // src/shared/event-bridge/agent-event-mapper.ts
 function mapAgentEventToSlackTurnEvent(event) {
   switch (event.type) {
@@ -236,10 +307,25 @@ var UnsupportedSlackInteractiveRequestError = class extends Error {
   }
 };
 
+// src/shared/event-bridge/turn-source.ts
+function adaptAgentTurnSourceToSlackTurnSource(source) {
+  return {
+    async *chat(sessionId, message, options) {
+      const events = source.chat(sessionId, message, options);
+      for await (const event of events) {
+        yield mapAgentEventToSlackTurnEvent(event);
+      }
+    }
+  };
+}
+
 export {
+  DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY,
+  createSlackContextFragmentMiddleware,
   mapAgentEventToSlackTurnEvent,
   mapAgentSlackEventBridgeOptionsToRuntimeOptions,
   bridgeAgentEventsToSlack,
   resolveSlackEventBridgeOptions,
-  UnsupportedSlackInteractiveRequestError
+  UnsupportedSlackInteractiveRequestError,
+  adaptAgentTurnSourceToSlackTurnSource
 };

package/dist/history/index.d.ts

@@ -1,23 +1,13 @@
 import { Logger } from '@cuylabs/agent-core';
 import { SlackHistoryUnavailable, SlackSupplementalHistoryVisibilityMode } from '@cuylabs/channel-slack/history';
-import { MountSlackAgentAppTurnRequestContext } from '../app-surface.js';
+import { SlackTurnRequestContext, SlackAssistantUtilities } from '@cuylabs/channel-slack/core';
+import { WebClient } from '@slack/web-api';
 import { a as SlackContextFragmentPayload } from '../context-fragments-CQEDcjYR.js';
-import '@slack/bolt';
-import '@slack/web-api';
-import '../options-ByNm2o89.js';
-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/feedback';
-import '@cuylabs/channel-slack/assistant';
-import '../types-BeGPexio.js';
-import '../types-Bz4OYEAV.js';
-import '../types-CiwGU6zC.js';
-import '@cuylabs/channel-slack/views';
 
+interface SlackAgentHistoryTurnRequestContext extends SlackTurnRequestContext {
+    assistant?: SlackAssistantUtilities;
+    client?: WebClient;
+}
 interface SlackAgentTurnHistoryOptions {
     enabled: boolean;
     limit: number;
@@ -40,7 +30,7 @@ interface LoadSlackAgentTurnHistoryContextOptions {
     logger?: Pick<Logger, "debug" | "info" | "warn">;
     originChannelId?: string;
     profileResolver?: SlackAgentTurnHistoryProfileResolver;
-    request: MountSlackAgentAppTurnRequestContext;
+    request: SlackAgentHistoryTurnRequestContext;
 }
 type SlackAgentTurnHistoryContextResult = {
     fragment?: SlackContextFragmentPayload;

package/dist/index.d.ts

@@ -1,41 +1,14 @@
 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';
-export { UnsupportedSlackInteractiveRequestError, bridgeAgentEventsToSlack, mapAgentEventToSlackTurnEvent, mapAgentSlackEventBridgeOptionsToRuntimeOptions } from './shared/index.js';
-export { S as SlackEventBridgeOptions, r as resolveSlackEventBridgeOptions } from './options-CGUfVStV.js';
-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';
-export { c as createSlackChannelAdapter } from './adapter-vbqtraAr.js';
-export { S as SlackChannelAdapter, a as SlackChannelOptions, b as SlackSessionStrategy, c as SlackStreamingMode, d as SlackToolStartEvent } from './types-BeGPexio.js';
-export { SlackSessionMap, createSlackSessionMap } from './adapter/index.js';
-export { createSlackAssistantBridge } from './assistant/index.js';
-export { A as AssistantLifecycleArgs, a as AssistantThreadStartedArgs, C as CreateSlackAssistantBridgeOptions, M as MaybePromise, S as SlackAssistantBridge, b as SlackAssistantCancelControlOptions, c as SlackAssistantCancelControlVisibleWhen, d as SlackAssistantFeedbackConfig, e as SlackAssistantSessionStrategy, f as SlackAssistantStatusContext, g as SlackAssistantThreadContextStoreLike, h as SlackAssistantThreadStartedContext, i as SlackAssistantTurnCancelContext, j as SlackAssistantTurnControlsOptions, k as SlackAssistantTurnPreparation, l as SlackAssistantUserMessageContext, r as resolveAssistantSessionId } from './options-ByNm2o89.js';
-export { ParsedAssistantUserMessage, createSlackAssistantThreadContextStore, parseSlackMessageActivityFromMessageEvent } from '@cuylabs/channel-slack/assistant';
-export { CreateSlackFinalResponseArtifactPublisherOptions, SlackFinalResponseArtifactContext, SlackFinalResponseArtifactDeliveryMode, SlackFinalResponseArtifactPublisher, SlackFinalResponseArtifactResult, SlackFinalResponseArtifactValueResolver, createSlackFinalResponseArtifactPublisher } from './artifacts/index.js';
+export { SlackApprovalRequest, SlackEventBridgeOptions, SlackEventInteractiveRequestHandler, SlackHumanInputRequest, SlackInteractiveRequest, SlackInteractiveRequestBaseContext, SlackInteractiveRequestContext, SlackInteractiveRequestHandler, UnsupportedSlackInteractiveRequestError, adaptAgentTurnSourceToSlackTurnSource, bridgeAgentEventsToSlack, mapAgentEventToSlackTurnEvent, mapAgentSlackEventBridgeOptionsToRuntimeOptions, resolveSlackEventBridgeOptions } from './shared/index.js';
 export { LoadSlackAgentTurnHistoryContextOptions, SlackAgentTurnHistoryContextResult, SlackAgentTurnHistoryOptions, SlackAgentTurnHistoryProfileResolver, emptySlackAgentTurnHistoryContextResult, loadSlackAgentTurnHistoryContext } from './history/index.js';
-export { S as SlackInteractiveApprovalRequest, a as SlackInteractiveController, b as SlackInteractiveControllerOptions, c as SlackInteractiveHumanInputRequest, d as SlackInteractivePendingWaiter, e as SlackInteractivePostedMessage, f as SlackInteractiveRequestWaitOptions, g as SlackInteractiveResolution } from './types-Bz4OYEAV.js';
-export { createSlackInteractiveController } from './interactive/index.js';
-export { createSlackAgentViewWorkflowController } from './views/index.js';
-export { C as CreateSlackAgentViewWorkflowControllerOptions, S as SlackAgentViewStateValue, a as SlackAgentViewStateValues, b as SlackAgentViewWorkflow, c as SlackAgentViewWorkflowContext, d as SlackAgentViewWorkflowController, e as SlackAgentViewWorkflowDefinition, f as extractSlackAgentViewStateValues, r as readSlackAgentViewStateValue } from './types-CiwGU6zC.js';
 export { InspectSlackTurnStatusVisibilityOptions, ResolvedSlackTurnStatusVisibilityOptions, RouteSlackAgentEventOptions, SlackActiveToolCall, SlackAgentEventQueue, SlackAgentEventQueueState, SlackSubagentCompletionMessage, SlackSubagentCompletionMessageFormatterOptions, SlackSubagentCompletionNotifierOptions, SlackSubagentCompletionPoster, SlackSubagentCompletionRun, SlackSubagentCompletionSlackContext, SlackSubagentCompletionTurnContext, SlackTurnActivityState, SlackTurnPhase, SlackTurnStatusVisibilityOptions, SlackTurnStatusVisibilityState, SlackTurnStatusVisibilityWarning, SlackTypedApprovalAction, coalesceSlackAgentEvents, createSlackSubagentCompletionNotifier, formatDefaultSlackSubagentCompletionMessage, immediateSlackTextResponse, inspectSlackTurnStatusVisibility, isAbortLikeError, isRunningAgentTurnError, isSlackCancelMessage, isSlackSubagentTerminalEvent, isSlackTerminalTurnPhase, isSlackWaitingForHumanTurnPhase, recordSlackTurnActivity, resolveSlackTurnStatusVisibilityOptions, resolveSlackTypedApprovalAction, routeSlackAgentEvent, shouldInspectSlackTurnStatusVisibility, shouldQueueSlackAgentEvent } from './source/index.js';
-export { MountSlackAgentOptions, MountSlackAgentResult, mountSlackAgent } from './express.js';
-export { MountSlackAssistantAgentOptions, MountSlackAssistantAgentResult, mountSlackAssistantAgent } from './express-assistant.js';
-export { MountSlackAgentAppSocketOptions, MountSlackAgentAppSocketResult, MountSlackAssistantAgentSocketOptions, MountSlackAssistantAgentSocketResult, mountSlackAgentAppSocket, mountSlackAssistantAgentSocket } from './socket.js';
-export { MountSlackAgentAppOptions, MountSlackAgentAppResult, mountSlackAgentApp } from './app.js';
 export { CreateSlackMcpServerConfigOptions, SLACK_MCP_URL, createSlackMcpServerConfig } from './mcp.js';
-export { MountSlackAgentAppTurnRequestContext } from './app-surface.js';
 import '@cuylabs/agent-core';
 import '@cuylabs/channel-slack/core';
 import '@cuylabs/channel-slack/responses';
 import '@cuylabs/channel-slack/runtime';
 import '@cuylabs/channel-slack/interactive';
-import '@slack/bolt';
-import '@slack/web-api';
-import '@cuylabs/channel-slack/feedback';
-import '@cuylabs/channel-slack/artifacts';
 import '@cuylabs/channel-slack/history';
-import '@cuylabs/channel-slack/views';
+import '@slack/web-api';
 import '@cuylabs/agent-core/dispatch';
-import 'node:http';
-import 'express';
-import '@cuylabs/channel-slack/transports/http';
-import '@cuylabs/channel-slack/auth';
-import '@cuylabs/channel-slack/transports/socket';
 import '@cuylabs/agent-core/mcp';

package/dist/index.js

@@ -1,17 +1,21 @@
 import {
-  createSlackFinalResponseArtifactPublisher
-} from "./chunk-NNCVHQC4.js";
+  SLACK_MCP_URL,
+  createSlackMcpServerConfig
+} from "./chunk-RFHXERNL.js";
 import {
   emptySlackAgentTurnHistoryContextResult,
   loadSlackAgentTurnHistoryContext
 } from "./chunk-P7PFQ3SQ.js";
-import {
-  createSlackInteractiveController
-} from "./chunk-OP27SSZU.js";
 import {
   DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY,
-  createSlackContextFragmentMiddleware
-} from "./chunk-A2PLAVW6.js";
+  UnsupportedSlackInteractiveRequestError,
+  adaptAgentTurnSourceToSlackTurnSource,
+  bridgeAgentEventsToSlack,
+  createSlackContextFragmentMiddleware,
+  mapAgentEventToSlackTurnEvent,
+  mapAgentSlackEventBridgeOptionsToRuntimeOptions,
+  resolveSlackEventBridgeOptions
+} from "./chunk-U6RC4SXN.js";
 import {
   coalesceSlackAgentEvents,
   createSlackSubagentCompletionNotifier,
@@ -31,65 +35,17 @@ import {
   shouldInspectSlackTurnStatusVisibility,
   shouldQueueSlackAgentEvent
 } from "./chunk-C7VSW4ZM.js";
-import {
-  createSlackAgentViewWorkflowController,
-  extractSlackAgentViewStateValues,
-  readSlackAgentViewStateValue
-} from "./chunk-C7CHMYV6.js";
-import {
-  mountSlackAgentApp
-} from "./chunk-P2DIC42J.js";
-import {
-  mountSlackAssistantAgent
-} from "./chunk-DS6E5OEJ.js";
-import {
-  mountSlackAgent
-} from "./chunk-QFDXKCAQ.js";
-import {
-  SLACK_MCP_URL,
-  createSlackMcpServerConfig
-} from "./chunk-RFHXERNL.js";
-import {
-  mountSlackAgentAppSocket,
-  mountSlackAssistantAgentSocket
-} from "./chunk-6EMFBOXD.js";
-import "./chunk-Q2GU4QLZ.js";
-import {
-  createSlackAssistantBridge,
-  createSlackAssistantThreadContextStore,
-  parseSlackMessageActivityFromMessageEvent,
-  resolveAssistantSessionId
-} from "./chunk-GEFK72VO.js";
-import "./chunk-ELR6MQD7.js";
-import {
-  createSlackChannelAdapter,
-  createSlackSessionMap
-} from "./chunk-KQPUQJ57.js";
-import {
-  UnsupportedSlackInteractiveRequestError,
-  bridgeAgentEventsToSlack,
-  mapAgentEventToSlackTurnEvent,
-  mapAgentSlackEventBridgeOptionsToRuntimeOptions,
-  resolveSlackEventBridgeOptions
-} from "./chunk-L5RAGYVJ.js";
 export {
   DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY,
   SLACK_MCP_URL,
   UnsupportedSlackInteractiveRequestError,
+  adaptAgentTurnSourceToSlackTurnSource,
   bridgeAgentEventsToSlack,
   coalesceSlackAgentEvents,
-  createSlackAgentViewWorkflowController,
-  createSlackAssistantBridge,
-  createSlackAssistantThreadContextStore,
-  createSlackChannelAdapter,
   createSlackContextFragmentMiddleware,
-  createSlackFinalResponseArtifactPublisher,
-  createSlackInteractiveController,
   createSlackMcpServerConfig,
-  createSlackSessionMap,
   createSlackSubagentCompletionNotifier,
   emptySlackAgentTurnHistoryContextResult,
-  extractSlackAgentViewStateValues,
   formatDefaultSlackSubagentCompletionMessage,
   immediateSlackTextResponse,
   inspectSlackTurnStatusVisibility,
@@ -102,15 +58,7 @@ export {
   loadSlackAgentTurnHistoryContext,
   mapAgentEventToSlackTurnEvent,
   mapAgentSlackEventBridgeOptionsToRuntimeOptions,
-  mountSlackAgent,
-  mountSlackAgentApp,
-  mountSlackAgentAppSocket,
-  mountSlackAssistantAgent,
-  mountSlackAssistantAgentSocket,
-  parseSlackMessageActivityFromMessageEvent,
-  readSlackAgentViewStateValue,
   recordSlackTurnActivity,
-  resolveAssistantSessionId,
   resolveSlackEventBridgeOptions,
   resolveSlackTurnStatusVisibilityOptions,
   resolveSlackTypedApprovalAction,

package/dist/shared/index.d.ts

@@ -1,14 +1,148 @@
 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 { AgentEvent, ApprovalEvent, AgentTurnSource } from '@cuylabs/agent-core';
 import { SlackResponseSink } from '@cuylabs/channel-slack/responses';
-import { S as SlackEventBridgeOptions } from '../options-CGUfVStV.js';
-export { r as resolveSlackEventBridgeOptions } from '../options-CGUfVStV.js';
-import { SlackTurnEvent, SlackEventBridgeOptions as SlackEventBridgeOptions$1 } from '@cuylabs/channel-slack/runtime';
-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 '@cuylabs/channel-slack/core';
-import '../artifacts/index.js';
-import '@cuylabs/channel-slack/artifacts';
-import '@cuylabs/channel-slack/interactive';
+import { SlackFinalResponseArtifactPublisher, SlackFinalResponseArtifactDeliveryMode, SlackFinalResponseArtifactContext, SlackFinalResponseArtifactResult, SlackTurnEvent, SlackEventBridgeOptions as SlackEventBridgeOptions$1, SlackTurnSource } from '@cuylabs/channel-slack/runtime';
+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>;
+
+/**
+ * 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.
@@ -57,4 +191,6 @@ declare class UnsupportedSlackInteractiveRequestError extends Error {
     constructor(kind: "approval" | "human-input", requestId: string, message: string);
 }
 
-export { SlackEventBridgeOptions, UnsupportedSlackInteractiveRequestError, bridgeAgentEventsToSlack, mapAgentEventToSlackTurnEvent, mapAgentSlackEventBridgeOptionsToRuntimeOptions };
+declare function adaptAgentTurnSourceToSlackTurnSource(source: AgentTurnSource): SlackTurnSource;
+
+export { type SlackApprovalRequest, type SlackEventBridgeOptions, type SlackEventInteractiveRequestHandler, type SlackHumanInputRequest, type SlackInteractiveRequest, type SlackInteractiveRequestBaseContext, type SlackInteractiveRequestContext, type SlackInteractiveRequestHandler, UnsupportedSlackInteractiveRequestError, adaptAgentTurnSourceToSlackTurnSource, bridgeAgentEventsToSlack, mapAgentEventToSlackTurnEvent, mapAgentSlackEventBridgeOptionsToRuntimeOptions, resolveSlackEventBridgeOptions };

package/dist/shared/index.js

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

package/docs/README.md

@@ -2,8 +2,7 @@
 
 `@cuylabs/channel-slack-agent-core` is the `@cuylabs/agent-core` runtime binding
 for direct Slack traffic. It composes `@cuylabs/channel-slack` primitives with
-Agent Core turn sources, event streams, scopes, context fragments, approvals,
-and human-input requests.
+Agent Core turn sources, event streams, scopes, and context fragments.
 
 ## Reference
 
@@ -12,7 +11,6 @@ and human-input requests.
 
 ## Concepts
 
-- [Final response artifacts](concepts/final-response-artifacts.md)
 - [Interactive requests](concepts/interactive-requests.md)
+- [Final response artifacts](concepts/final-response-artifacts.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,