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

package/README.md

@@ -3,12 +3,12 @@
 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,
+MCP token bridging, or approval/human-input controller binding.
 
-Generic Slack mechanics such as parsing, policy, history, setup, auth, targets,
-users, entrypoints, artifacts, interactive stores/builders, response sinks, and
+Generic Slack mechanics, mounts, Assistant rendering, classic message routing,
+feedback, artifacts, interactive stores/builders, response sinks, and
 transports live in `@cuylabs/channel-slack`.
 
 ## Install
@@ -33,10 +33,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 +46,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,17 @@
 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 { SlackEventBridgeOptions, UnsupportedSlackInteractiveRequestError, adaptAgentTurnSourceToSlackTurnSource, bridgeAgentEventsToSlack, mapAgentEventToSlackTurnEvent, mapAgentSlackEventBridgeOptionsToRuntimeOptions, resolveSlackEventBridgeOptions } from './shared/index.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 { 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 { SlackInteractiveApprovalRequest, SlackInteractiveController, SlackInteractiveControllerOptions, SlackInteractiveHumanInputRequest, SlackInteractivePendingWaiter, SlackInteractivePostedMessage, SlackInteractiveRequestWaitOptions, SlackInteractiveResolution, createSlackInteractiveController } from './interactive/index.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 '@slack/bolt';
 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,6 +1,7 @@
 import {
-  createSlackFinalResponseArtifactPublisher
-} from "./chunk-NNCVHQC4.js";
+  SLACK_MCP_URL,
+  createSlackMcpServerConfig
+} from "./chunk-RFHXERNL.js";
 import {
   emptySlackAgentTurnHistoryContextResult,
   loadSlackAgentTurnHistoryContext
@@ -10,8 +11,14 @@ import {
 } 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 +38,18 @@ 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 +62,7 @@ export {
   loadSlackAgentTurnHistoryContext,
   mapAgentEventToSlackTurnEvent,
   mapAgentSlackEventBridgeOptionsToRuntimeOptions,
-  mountSlackAgent,
-  mountSlackAgentApp,
-  mountSlackAgentAppSocket,
-  mountSlackAssistantAgent,
-  mountSlackAssistantAgentSocket,
-  parseSlackMessageActivityFromMessageEvent,
-  readSlackAgentViewStateValue,
   recordSlackTurnActivity,
-  resolveAssistantSessionId,
   resolveSlackEventBridgeOptions,
   resolveSlackTurnStatusVisibilityOptions,
   resolveSlackTypedApprovalAction,

package/dist/interactive/index.d.ts

@@ -1,11 +1,90 @@
-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 { ApprovalRequest, ApprovalResolution, HumanInputRequest, HumanInputResponse, ApprovalAction, ApprovalRememberScope } from '@cuylabs/agent-core';
+import { SlackInteractiveActionIds, SlackInteractiveRequestStore, SlackInteractiveRequestRecord, SlackInteractiveActor, SlackInteractiveHumanInputRequest as SlackInteractiveHumanInputRequest$1, SlackInteractiveMessageRef } from '@cuylabs/channel-slack/interactive';
+import { App } from '@slack/bolt';
+import { e as SlackInteractiveRequestContext } from '../interactive-BigrPKnu.js';
 import '@cuylabs/channel-slack/core';
 
+type SlackInteractiveApprovalRequest = ApprovalRequest;
+type SlackInteractiveHumanInputRequest = SlackInteractiveHumanInputRequest$1 & Partial<Pick<HumanInputRequest, "sessionId" | "timestamp" | "toolCallId">>;
+type SlackInteractiveResolution = {
+    kind: "approval";
+    action: ApprovalAction;
+    feedback?: string;
+    rememberScope?: ApprovalRememberScope;
+} | {
+    kind: "human-input";
+    response: HumanInputResponse;
+};
+interface SlackInteractiveRequestWaitOptions {
+    /**
+     * Abort waiting for this request. The controller removes its local waiter and
+     * deletes the pending store record when the signal fires.
+     */
+    signal?: AbortSignal;
+    /**
+     * Override the controller-level request timeout for this request. Use `0` to
+     * disable timeout cleanup for this request.
+     */
+    timeoutMs?: number;
+}
+interface SlackInteractiveControllerOptions {
+    store?: SlackInteractiveRequestStore;
+    /**
+     * Stable namespace for default Slack action IDs. Use this when installing
+     * multiple interactive controllers in the same Slack app.
+     *
+     * @default "agent_slack"
+     */
+    namespace?: string;
+    actionIds?: Partial<SlackInteractiveActionIds>;
+    /**
+     * Default timeout for local waiters and pending store records. This should
+     * usually match the agent-core approval/human-input timeout.
+     *
+     * @default 300000
+     */
+    requestTimeoutMs?: number;
+    /**
+     * Called on every successful Slack resolution after the local waiter, if
+     * present, is resolved. Use this to fan out decisions to agent-server or
+     * another runtime that owns the turn.
+     */
+    onResolve?: (requestId: string, resolution: SlackInteractiveResolution) => void | Promise<void>;
+    /**
+     * Authorization hook for approving/responding to pending requests.
+     *
+     * Defaults to the original Slack requester only. Return `true` for delegated
+     * approvers, channel owners, or admin policy checks.
+     */
+    authorize?: (record: SlackInteractiveRequestRecord, actor: SlackInteractiveActor) => boolean | Promise<boolean>;
+}
+interface SlackInteractiveController {
+    readonly actionIds: SlackInteractiveActionIds;
+    readonly store: SlackInteractiveRequestStore;
+    approval: {
+        onRequest(request: ApprovalRequest, options?: SlackInteractiveRequestWaitOptions): Promise<ApprovalResolution>;
+    };
+    humanInput: {
+        onRequest(request: HumanInputRequest, options?: SlackInteractiveRequestWaitOptions): Promise<HumanInputResponse>;
+    };
+    /** Reject one pending in-process waiter and delete its pending store record. */
+    cancel(requestId: string, reason?: string): Promise<boolean>;
+    /** Shutdown helper: cancel every pending request created by this controller. */
+    cancelAll(reason?: string): Promise<void>;
+    handleInteractiveRequest(context: SlackInteractiveRequestContext): Promise<boolean>;
+    install(app: App): void;
+}
+type SlackInteractivePendingWaiter = {
+    resolve: (resolution: SlackInteractiveResolution) => void;
+    reject: (error: Error) => void;
+    cleanup: () => void;
+};
+interface SlackInteractivePostedMessage {
+    text: string;
+    blocks: unknown[];
+    ref: SlackInteractiveMessageRef;
+}
+
 declare function createSlackInteractiveController(options?: SlackInteractiveControllerOptions): SlackInteractiveController;
 
-export { SlackInteractiveController, SlackInteractiveControllerOptions, createSlackInteractiveController };
+export { type SlackInteractiveApprovalRequest, type SlackInteractiveController, type SlackInteractiveControllerOptions, type SlackInteractiveHumanInputRequest, type SlackInteractivePendingWaiter, type SlackInteractivePostedMessage, type SlackInteractiveRequestWaitOptions, type SlackInteractiveResolution, createSlackInteractiveController };

package/dist/shared/index.d.ts

@@ -1,15 +1,126 @@
 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 { 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 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 +168,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 SlackEventBridgeOptions, SlackEventInteractiveRequestHandler, 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

@@ -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",