@cuylabs/channel-slack-agent-core 0.5.1 → 0.7.0

package/dist/index.js

@@ -1,16 +1,10 @@
 import {
-  mountSlackAgentAppSocket,
-  mountSlackAssistantAgentSocket
-} from "./chunk-IWUYIAY5.js";
-import {
-  targets_exports
-} from "./chunk-K2E6A377.js";
-import {
-  users_exports
-} from "./chunk-HFT2FXJP.js";
+  createSlackFinalResponseArtifactPublisher
+} from "./chunk-NNCVHQC4.js";
 import {
-  history_exports
-} from "./chunk-PX4RGO3N.js";
+  emptySlackAgentTurnHistoryContextResult,
+  loadSlackAgentTurnHistoryContext
+} from "./chunk-P7PFQ3SQ.js";
 import {
   buildApprovalRequestMessage,
   buildHumanInputModal,
@@ -18,152 +12,76 @@ import {
   buildResolvedMessage,
   cloneRecord,
   createInMemorySlackInteractiveRequestStore,
+  createPostgresSlackInteractiveRequestStore,
   createSlackInteractiveController,
   decodeActionValue,
   encodeActionValue,
-  nowIso
-} from "./chunk-IXY3BXU5.js";
-import {
-  SLACK_MCP_URL,
-  createSlackMcpServerConfig
-} from "./chunk-RFHXERNL.js";
-import {
-  policy_exports
-} from "./chunk-2SUAW6MV.js";
-import {
-  setup_exports
-} from "./chunk-645NNJIM.js";
+  initializePostgresSlackInteractiveRequestStore,
+  nowIso,
+  prunePostgresSlackInteractiveRequestStore
+} from "./chunk-X7ILLZZP.js";
 import {
   DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY,
   createSlackContextFragmentMiddleware
-} from "./chunk-NIPAN4KA.js";
+} from "./chunk-A2PLAVW6.js";
+import {
+  coalesceSlackAgentEvents,
+  createSlackSubagentCompletionNotifier,
+  formatDefaultSlackSubagentCompletionMessage,
+  immediateSlackTextResponse,
+  inspectSlackTurnStatusVisibility,
+  isAbortLikeError,
+  isRunningAgentTurnError,
+  isSlackCancelMessage,
+  isSlackSubagentTerminalEvent,
+  isSlackTerminalTurnPhase,
+  isSlackWaitingForHumanTurnPhase,
+  recordSlackTurnActivity,
+  resolveSlackTurnStatusVisibilityOptions,
+  resolveSlackTypedApprovalAction,
+  routeSlackAgentEvent,
+  shouldInspectSlackTurnStatusVisibility,
+  shouldQueueSlackAgentEvent
+} from "./chunk-C7VSW4ZM.js";
+import {
+  createSlackAgentViewWorkflowController,
+  extractSlackAgentViewStateValues,
+  readSlackAgentViewStateValue
+} from "./chunk-C7CHMYV6.js";
 import {
   mountSlackAgentApp
-} from "./chunk-CYEBGC6G.js";
-import "./chunk-M64Z6TYL.js";
-import {
-  diagnostics_exports
-} from "./chunk-NDVXBI7Z.js";
+} from "./chunk-76SRS54H.js";
 import {
   mountSlackAssistantAgent
-} from "./chunk-JMLB7A2V.js";
+} from "./chunk-DJPKRKGP.js";
+import {
+  mountSlackAgent
+} from "./chunk-TCNJY7QA.js";
+import {
+  SLACK_MCP_URL,
+  createSlackMcpServerConfig
+} from "./chunk-RFHXERNL.js";
+import {
+  mountSlackAgentAppSocket,
+  mountSlackAssistantAgentSocket
+} from "./chunk-VMVQIDNR.js";
+import "./chunk-7DUO5BMW.js";
 import {
   createSlackAssistantBridge,
   createSlackAssistantThreadContextStore,
   parseSlackMessageActivityFromMessageEvent,
   resolveAssistantSessionId
-} from "./chunk-BFUPAJON.js";
-import "./chunk-VHGV66M7.js";
-import {
-  mountSlackAgent
-} from "./chunk-WO4BJMF3.js";
+} from "./chunk-MGBNGG4D.js";
+import "./chunk-ELR6MQD7.js";
 import {
   createSlackChannelAdapter,
-  createSlackSessionMap,
-  resolveThreadAwareSlackSessionId
-} from "./chunk-FDRQOG7Q.js";
-import {
-  extractSlackActionToken,
-  extractSlackAttachmentsText,
-  extractSlackAuthContext,
-  extractSlackBlocksText,
-  extractSlackMessageText,
-  extractSlackUserIdentity,
-  isProcessableMessage,
-  markdownToSlackMrkdwn,
-  parseSlackMentionActivity,
-  parseSlackMessageActivity,
-  resolveSlackChannelType,
-  resolveSlackMessageFormatter,
-  stripLeadingMentions
-} from "./chunk-GNXWTKQ6.js";
+  createSlackSessionMap
+} from "./chunk-FQWFB54C.js";
 import {
   UnsupportedSlackInteractiveRequestError,
   bridgeAgentEventsToSlack,
-  currentSlackTurnContext,
-  resolveSlackEventBridgeOptions,
-  runWithSlackTurnContext
-} from "./chunk-DHPD4XH5.js";
-import {
-  bolt_exports
-} from "./chunk-ANIZ5NT4.js";
-import {
-  __export,
-  __reExport
-} from "./chunk-I2KLQ2HA.js";
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY: () => DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY,
-  SLACK_MCP_URL: () => SLACK_MCP_URL,
-  UnsupportedSlackInteractiveRequestError: () => UnsupportedSlackInteractiveRequestError,
-  bridgeAgentEventsToSlack: () => bridgeAgentEventsToSlack,
-  buildApprovalRequestMessage: () => buildApprovalRequestMessage,
-  buildHumanInputModal: () => buildHumanInputModal,
-  buildHumanInputRequestMessage: () => buildHumanInputRequestMessage,
-  buildResolvedMessage: () => buildResolvedMessage,
-  cloneRecord: () => cloneRecord,
-  createInMemorySlackInteractiveRequestStore: () => createInMemorySlackInteractiveRequestStore,
-  createSlackAssistantBridge: () => createSlackAssistantBridge,
-  createSlackAssistantThreadContextStore: () => createSlackAssistantThreadContextStore,
-  createSlackChannelAdapter: () => createSlackChannelAdapter,
-  createSlackContextFragmentMiddleware: () => createSlackContextFragmentMiddleware,
-  createSlackInteractiveController: () => createSlackInteractiveController,
-  createSlackMcpServerConfig: () => createSlackMcpServerConfig,
-  createSlackSessionMap: () => createSlackSessionMap,
-  createSlackSupplementalHistoryPolicy: () => history_exports.createSlackSupplementalHistoryPolicy,
-  createSlackSupplementalHistoryVisibilityPolicy: () => history_exports.createSlackSupplementalHistoryVisibilityPolicy,
-  currentSlackTurnContext: () => currentSlackTurnContext,
-  decodeActionValue: () => decodeActionValue,
-  encodeActionValue: () => encodeActionValue,
-  extractSlackActionToken: () => extractSlackActionToken,
-  extractSlackAttachmentsText: () => extractSlackAttachmentsText,
-  extractSlackAuthContext: () => extractSlackAuthContext,
-  extractSlackBlocksText: () => extractSlackBlocksText,
-  extractSlackMessageText: () => extractSlackMessageText,
-  extractSlackUserIdentity: () => extractSlackUserIdentity,
-  formatSlackAttributedFollowUp: () => formatSlackAttributedFollowUp,
-  formatSlackHistoryForPrompt: () => history_exports.formatSlackHistoryForPrompt,
-  isProcessableMessage: () => isProcessableMessage,
-  loadSlackTurnHistoryContext: () => history_exports.loadSlackTurnHistoryContext,
-  markdownToSlackMrkdwn: () => markdownToSlackMrkdwn,
-  mountSlackAgent: () => mountSlackAgent,
-  mountSlackAgentApp: () => mountSlackAgentApp,
-  mountSlackAgentAppSocket: () => mountSlackAgentAppSocket,
-  mountSlackAssistantAgent: () => mountSlackAssistantAgent,
-  mountSlackAssistantAgentSocket: () => mountSlackAssistantAgentSocket,
-  nowIso: () => nowIso,
-  parseSlackMentionActivity: () => parseSlackMentionActivity,
-  parseSlackMessageActivity: () => parseSlackMessageActivity,
-  parseSlackMessageActivityFromMessageEvent: () => parseSlackMessageActivityFromMessageEvent,
-  readSlackChannelHistory: () => history_exports.readSlackChannelHistory,
-  readSlackThreadHistory: () => history_exports.readSlackThreadHistory,
-  resolveAssistantSessionId: () => resolveAssistantSessionId,
-  resolveSlackChannelType: () => resolveSlackChannelType,
-  resolveSlackEventBridgeOptions: () => resolveSlackEventBridgeOptions,
-  resolveSlackMessageFormatter: () => resolveSlackMessageFormatter,
-  resolveThreadAwareSlackSessionId: () => resolveThreadAwareSlackSessionId,
-  runWithSlackTurnContext: () => runWithSlackTurnContext,
-  stripLeadingMentions: () => stripLeadingMentions
-});
-
-// src/shared/follow-up.ts
-import { formatSlackAttributedFollowUp } from "@cuylabs/channel-slack/core";
-
-// src/index.ts
-__reExport(index_exports, bolt_exports);
-__reExport(index_exports, policy_exports);
-__reExport(index_exports, users_exports);
-__reExport(index_exports, diagnostics_exports);
-__reExport(index_exports, setup_exports);
-__reExport(index_exports, targets_exports);
-var export_createSlackSupplementalHistoryPolicy = history_exports.createSlackSupplementalHistoryPolicy;
-var export_createSlackSupplementalHistoryVisibilityPolicy = history_exports.createSlackSupplementalHistoryVisibilityPolicy;
-var export_formatSlackHistoryForPrompt = history_exports.formatSlackHistoryForPrompt;
-var export_loadSlackTurnHistoryContext = history_exports.loadSlackTurnHistoryContext;
-var export_readSlackChannelHistory = history_exports.readSlackChannelHistory;
-var export_readSlackThreadHistory = history_exports.readSlackThreadHistory;
+  resolveSlackEventBridgeOptions
+} from "./chunk-TMADMHBN.js";
 export {
   DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY,
   SLACK_MCP_URL,
@@ -174,46 +92,49 @@ export {
   buildHumanInputRequestMessage,
   buildResolvedMessage,
   cloneRecord,
+  coalesceSlackAgentEvents,
   createInMemorySlackInteractiveRequestStore,
+  createPostgresSlackInteractiveRequestStore,
+  createSlackAgentViewWorkflowController,
   createSlackAssistantBridge,
   createSlackAssistantThreadContextStore,
   createSlackChannelAdapter,
   createSlackContextFragmentMiddleware,
+  createSlackFinalResponseArtifactPublisher,
   createSlackInteractiveController,
   createSlackMcpServerConfig,
   createSlackSessionMap,
-  export_createSlackSupplementalHistoryPolicy as createSlackSupplementalHistoryPolicy,
-  export_createSlackSupplementalHistoryVisibilityPolicy as createSlackSupplementalHistoryVisibilityPolicy,
-  currentSlackTurnContext,
+  createSlackSubagentCompletionNotifier,
   decodeActionValue,
+  emptySlackAgentTurnHistoryContextResult,
   encodeActionValue,
-  extractSlackActionToken,
-  extractSlackAttachmentsText,
-  extractSlackAuthContext,
-  extractSlackBlocksText,
-  extractSlackMessageText,
-  extractSlackUserIdentity,
-  formatSlackAttributedFollowUp,
-  export_formatSlackHistoryForPrompt as formatSlackHistoryForPrompt,
-  isProcessableMessage,
-  export_loadSlackTurnHistoryContext as loadSlackTurnHistoryContext,
-  markdownToSlackMrkdwn,
+  extractSlackAgentViewStateValues,
+  formatDefaultSlackSubagentCompletionMessage,
+  immediateSlackTextResponse,
+  initializePostgresSlackInteractiveRequestStore,
+  inspectSlackTurnStatusVisibility,
+  isAbortLikeError,
+  isRunningAgentTurnError,
+  isSlackCancelMessage,
+  isSlackSubagentTerminalEvent,
+  isSlackTerminalTurnPhase,
+  isSlackWaitingForHumanTurnPhase,
+  loadSlackAgentTurnHistoryContext,
   mountSlackAgent,
   mountSlackAgentApp,
   mountSlackAgentAppSocket,
   mountSlackAssistantAgent,
   mountSlackAssistantAgentSocket,
   nowIso,
-  parseSlackMentionActivity,
-  parseSlackMessageActivity,
   parseSlackMessageActivityFromMessageEvent,
-  export_readSlackChannelHistory as readSlackChannelHistory,
-  export_readSlackThreadHistory as readSlackThreadHistory,
+  prunePostgresSlackInteractiveRequestStore,
+  readSlackAgentViewStateValue,
+  recordSlackTurnActivity,
   resolveAssistantSessionId,
-  resolveSlackChannelType,
   resolveSlackEventBridgeOptions,
-  resolveSlackMessageFormatter,
-  resolveThreadAwareSlackSessionId,
-  runWithSlackTurnContext,
-  stripLeadingMentions
+  resolveSlackTurnStatusVisibilityOptions,
+  resolveSlackTypedApprovalAction,
+  routeSlackAgentEvent,
+  shouldInspectSlackTurnStatusVisibility,
+  shouldQueueSlackAgentEvent
 };

package/dist/interactive/index.d.ts

@@ -0,0 +1,71 @@
+import { i as SlackInteractiveRequestRecord, k as SlackInteractiveRequestStore, b as SlackInteractiveApprovalRequest, S as SlackInteractiveActionIds, e as SlackInteractiveHumanInputRequest, m as SlackInteractiveResolution, d as SlackInteractiveControllerOptions, c as SlackInteractiveController } from '../types-Crpil4kb.js';
+export { a as SlackInteractiveActor, f as SlackInteractiveMessageTarget, g as SlackInteractivePendingWaiter, h as SlackInteractivePostedMessage, j as SlackInteractiveRequestStatus, l as SlackInteractiveRequestWaitOptions, n as SlackInteractiveStoredRequest } from '../types-Crpil4kb.js';
+import { View } from '@slack/types';
+import '@cuylabs/agent-core';
+import '@slack/bolt';
+import '../interactive-o_NZb-Xg.js';
+import '@cuylabs/channel-slack/core';
+
+declare function createInMemorySlackInteractiveRequestStore(): SlackInteractiveRequestStore;
+declare function nowIso(): string;
+declare function cloneRecord(record: SlackInteractiveRequestRecord): SlackInteractiveRequestRecord;
+
+interface SlackInteractivePostgresClient {
+    end?: () => Promise<void>;
+    query<T = unknown>(sql: string, values?: readonly unknown[]): Promise<{
+        rows: T[];
+        rowCount?: number | null;
+    }>;
+}
+interface PostgresSlackInteractiveRequestStoreOptions {
+    client?: SlackInteractivePostgresClient;
+    connectionString?: string;
+    ensureSchema?: boolean;
+    onPruneError?: (error: unknown) => void;
+    pruneBatchSize?: number;
+    pruneIntervalMs?: number;
+    retentionMs?: number;
+    schema?: string;
+    tableName?: string;
+}
+interface PostgresSlackInteractiveRequestStore extends SlackInteractiveRequestStore {
+    close(): Promise<void>;
+    prune(): Promise<PostgresSlackInteractiveRequestPruneResult>;
+}
+interface PostgresSlackInteractiveRequestPruneResult {
+    deleted: number;
+}
+declare function createPostgresSlackInteractiveRequestStore({ client, connectionString, ensureSchema, onPruneError, pruneBatchSize, pruneIntervalMs, retentionMs, schema, tableName, }: PostgresSlackInteractiveRequestStoreOptions): PostgresSlackInteractiveRequestStore;
+declare function initializePostgresSlackInteractiveRequestStore({ client, ensureSchema, schema, tableName, }: {
+    client: SlackInteractivePostgresClient;
+    ensureSchema?: boolean;
+    schema?: string;
+    tableName?: string;
+}): Promise<void>;
+declare function prunePostgresSlackInteractiveRequestStore({ client, pruneBatchSize, retentionMs, schema, tableName, }: {
+    client: SlackInteractivePostgresClient;
+    pruneBatchSize?: number;
+    retentionMs?: number;
+    schema?: string;
+    tableName?: string;
+}): Promise<PostgresSlackInteractiveRequestPruneResult>;
+
+declare function buildApprovalRequestMessage(request: SlackInteractiveApprovalRequest, actionIds: SlackInteractiveActionIds): {
+    text: string;
+    blocks: unknown[];
+};
+declare function buildHumanInputRequestMessage(request: SlackInteractiveHumanInputRequest, actionIds: SlackInteractiveActionIds): {
+    text: string;
+    blocks: unknown[];
+};
+declare function buildResolvedMessage(label: string, resolution: SlackInteractiveResolution): {
+    text: string;
+    blocks: unknown[];
+};
+declare function buildHumanInputModal(request: SlackInteractiveHumanInputRequest, actionIds: SlackInteractiveActionIds): View;
+declare function encodeActionValue(payload: Record<string, unknown>): string;
+declare function decodeActionValue(value: unknown): Record<string, unknown>;
+
+declare function createSlackInteractiveController(options?: SlackInteractiveControllerOptions): SlackInteractiveController;
+
+export { type PostgresSlackInteractiveRequestPruneResult, type PostgresSlackInteractiveRequestStore, type PostgresSlackInteractiveRequestStoreOptions, SlackInteractiveActionIds, SlackInteractiveApprovalRequest, SlackInteractiveController, SlackInteractiveControllerOptions, SlackInteractiveHumanInputRequest, type SlackInteractivePostgresClient, SlackInteractiveRequestRecord, SlackInteractiveRequestStore, SlackInteractiveResolution, buildApprovalRequestMessage, buildHumanInputModal, buildHumanInputRequestMessage, buildResolvedMessage, cloneRecord, createInMemorySlackInteractiveRequestStore, createPostgresSlackInteractiveRequestStore, createSlackInteractiveController, decodeActionValue, encodeActionValue, initializePostgresSlackInteractiveRequestStore, nowIso, prunePostgresSlackInteractiveRequestStore };

package/dist/{interactive.js → interactive/index.js}

@@ -5,12 +5,14 @@ import {
   buildResolvedMessage,
   cloneRecord,
   createInMemorySlackInteractiveRequestStore,
+  createPostgresSlackInteractiveRequestStore,
   createSlackInteractiveController,
   decodeActionValue,
   encodeActionValue,
-  nowIso
-} from "./chunk-IXY3BXU5.js";
-import "./chunk-I2KLQ2HA.js";
+  initializePostgresSlackInteractiveRequestStore,
+  nowIso,
+  prunePostgresSlackInteractiveRequestStore
+} from "../chunk-X7ILLZZP.js";
 export {
   buildApprovalRequestMessage,
   buildHumanInputModal,
@@ -18,8 +20,11 @@ export {
   buildResolvedMessage,
   cloneRecord,
   createInMemorySlackInteractiveRequestStore,
+  createPostgresSlackInteractiveRequestStore,
   createSlackInteractiveController,
   decodeActionValue,
   encodeActionValue,
-  nowIso
+  initializePostgresSlackInteractiveRequestStore,
+  nowIso,
+  prunePostgresSlackInteractiveRequestStore
 };

package/dist/mcp.js

@@ -2,7 +2,6 @@ import {
   SLACK_MCP_URL,
   createSlackMcpServerConfig
 } from "./chunk-RFHXERNL.js";
-import "./chunk-I2KLQ2HA.js";
 export {
   SLACK_MCP_URL,
   createSlackMcpServerConfig

package/dist/{options-C7OYeNR-.d.ts → options-BcDReOJv.d.ts}

@@ -1,4 +1,5 @@
 import { AgentEvent, ApprovalEvent } from '@cuylabs/agent-core';
+import { SlackFinalResponseArtifactPublisher, SlackFinalResponseArtifactDeliveryMode, SlackFinalResponseArtifactContext, SlackFinalResponseArtifactResult } from './artifacts/index.js';
 import { a as SlackEventInteractiveRequestHandler } from './interactive-o_NZb-Xg.js';
 
 /**
@@ -13,6 +14,9 @@ type HumanInputEvent = Extract<AgentEvent, {
 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. */
@@ -24,6 +28,13 @@ interface SlackEventBridgeOptions {
     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;
@@ -65,6 +76,43 @@ interface SlackEventBridgeOptions {
     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;
 

package/dist/{options-Uf-qmQKN.d.ts → options-CdqBABcM.d.ts}

@@ -3,7 +3,7 @@ import { AssistantUserMessageMiddleware, AssistantThreadStartedMiddleware, Assis
 import { WebClient } from '@slack/web-api';
 import { SlackAuthContext, SlackAssistantThreadContext, SlackAssistantUtilities, SlackTurnPreparation, SlackAssistantTaskDisplayMode, SlackAssistantStatusUpdate, SlackAssistantSuggestedPrompts, SlackChatStreamStartArgs, SlackMessageFormattingOptions } from '@cuylabs/channel-slack/core';
 import { h as SlackInteractiveRequestHandler } from './interactive-o_NZb-Xg.js';
-import { S as SlackEventBridgeOptions } from './options-C7OYeNR-.js';
+import { S as SlackEventBridgeOptions } from './options-BcDReOJv.js';
 import { SlackFeedbackBlockOptions, SlackFeedbackHandler } from '@cuylabs/channel-slack/feedback';
 import { ParsedAssistantUserMessage } from '@cuylabs/channel-slack/assistant';
 
@@ -201,6 +201,7 @@ interface CreateSlackAssistantBridgeOptions {
     formatToolTitle?: (toolName: string) => string;
     formatToolUpdate?: (toolName: string) => string;
     formatToolDetails?: SlackEventBridgeOptions["formatToolDetails"];
+    formatToolResultOutput?: SlackEventBridgeOptions["formatToolResultOutput"];
     formatToolError?: (toolName: string, error: string) => string;
     formatReasoningUpdate?: () => string;
     chatStreamBufferSize?: number;
@@ -223,6 +224,30 @@ interface CreateSlackAssistantBridgeOptions {
      * blocks.
      */
     chatStreamFinalArgs?: SlackEventBridgeOptions["chatStreamFinalArgs"];
+    /**
+     * Optional publisher for rich artifacts derived from the final accumulated
+     * answer, such as creating a Slack Canvas for long responses.
+     */
+    publishFinalResponseArtifact?: SlackEventBridgeOptions["publishFinalResponseArtifact"];
+    /**
+     * Controls whether final-response artifacts are supplemental or replace long
+     * Slack text with a compact artifact pointer.
+     *
+     * @default "supplemental"
+     */
+    finalResponseArtifactMode?: SlackEventBridgeOptions["finalResponseArtifactMode"];
+    /**
+     * Raw-character threshold for replacement-mode streaming suppression.
+     *
+     * @default 4000
+     */
+    finalResponseArtifactStreamThreshold?: SlackEventBridgeOptions["finalResponseArtifactStreamThreshold"];
+    /** Notice emitted when replacement mode moves the remaining response to an artifact. */
+    formatFinalResponseArtifactContinuationNotice?: SlackEventBridgeOptions["formatFinalResponseArtifactContinuationNotice"];
+    /** Compact final Slack message emitted after artifact publication succeeds. */
+    formatFinalResponseArtifactMessage?: SlackEventBridgeOptions["formatFinalResponseArtifactMessage"];
+    /** Diagnostics hook for final-response artifact publishing failures. */
+    onFinalResponseArtifactError?: SlackEventBridgeOptions["onFinalResponseArtifactError"];
     formatChatMarkdown?: SlackMessageFormattingOptions;
     formatStreamError?: (error: Error) => string;
     /**

package/dist/{shared.d.ts → shared/index.d.ts}

@@ -1,9 +1,11 @@
-import { SlackAmbientTurnContext } from '@cuylabs/channel-slack/core';
-export * from '@cuylabs/channel-slack/core';
-import { AgentEvent, AgentContextFragmentBuildContext, AgentContextFragmentInput, AgentContextFragmentKind, AgentContextFragmentRole, AgentContextFragmentPlacement, AgentContextFragmentLifetime, AgentContextFragmentBudgetBehavior, AgentMiddleware } from '@cuylabs/agent-core';
-import { S as SlackEventBridgeOptions } from './options-C7OYeNR-.js';
-export { r as resolveSlackEventBridgeOptions } from './options-C7OYeNR-.js';
-import './interactive-o_NZb-Xg.js';
+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-BcDReOJv.js';
+export { r as resolveSlackEventBridgeOptions } from '../options-BcDReOJv.js';
+import { SlackArtifactClient } from '@cuylabs/channel-slack/artifacts';
+export { S as SlackApprovalRequest, a as SlackEventInteractiveRequestHandler, b as SlackHumanInputRequest, c as SlackInteractiveMessage, d as SlackInteractiveMessageRef, e as SlackInteractiveRequest, f as SlackInteractiveRequestBaseContext, g as SlackInteractiveRequestContext, h as SlackInteractiveRequestHandler, i as SlackInteractiveRequestKind, j as SlackInteractiveResponder } from '../interactive-o_NZb-Xg.js';
+import '@cuylabs/channel-slack/core';
+import '../artifacts/index.js';
 
 /**
  * Slack response-sink contracts consumed by the event bridge.
@@ -13,6 +15,7 @@ import './interactive-o_NZb-Xg.js';
  * interface separate makes the bridge testable without a live Slack
  * connection.
  */
+
 type SlackStreamTaskStatus = "pending" | "in_progress" | "complete" | "error";
 type SlackStreamChunk = {
     type: "markdown_text";
@@ -41,7 +44,19 @@ interface SlackChatStream {
 /**
  * Minimal Slack posting interface consumed by the event bridge.
  */
+interface SlackArtifactPublicationTarget {
+    channelId: string;
+    threadTs?: string;
+}
 interface SlackResponseSink {
+    /**
+     * Slack Web API surface used by optional artifact publishers.
+     */
+    artifactClient?: SlackArtifactClient;
+    /**
+     * Channel/thread target used by optional artifact publishers.
+     */
+    artifactTarget?: SlackArtifactPublicationTarget;
     /**
      * Post a new message to the channel / thread.
      * Returns the channel ID and message timestamp needed for updates.
@@ -90,9 +105,8 @@ declare function bridgeAgentEventsToSlack(events: AsyncGenerator<AgentEvent>, si
  * `human-input-request` event reaches the Slack transport in a mode that
  * does not support in-channel resolution.
  *
- * Hosts can catch this error to fall back to message-and-error mode or to
- * route the request through a custom block / view flow. Future work will
- * add a first-class Slack rendering path here.
+ * Hosts can catch this error to fall back to message-and-error mode, or install
+ * `createSlackInteractiveController` to render and resolve requests in Slack.
  */
 declare class UnsupportedSlackInteractiveRequestError extends Error {
     readonly kind: "approval" | "human-input";
@@ -100,30 +114,4 @@ declare class UnsupportedSlackInteractiveRequestError extends Error {
     constructor(kind: "approval" | "human-input", requestId: string, message: string);
 }
 
-declare const DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY = "slackContextFragment";
-interface SlackContextFragmentPayload extends Partial<Pick<AgentContextFragmentInput, "budgetBehavior" | "dedupeKey" | "kind" | "lifetime" | "maxChars" | "metadata" | "placement" | "role" | "source" | "title">> {
-    content: string;
-}
-interface SlackContextFragmentResolverContext {
-    slack: Readonly<SlackAmbientTurnContext>;
-    step: AgentContextFragmentBuildContext;
-}
-type SlackContextFragmentResolver = (context: SlackContextFragmentResolverContext) => AgentContextFragmentInput | SlackContextFragmentPayload | string | undefined | Promise<AgentContextFragmentInput | SlackContextFragmentPayload | string | undefined>;
-interface SlackContextFragmentMiddlewareOptions {
-    name?: string;
-    contextKey?: string;
-    resolve?: SlackContextFragmentResolver;
-    kind?: AgentContextFragmentKind;
-    role?: AgentContextFragmentRole;
-    placement?: AgentContextFragmentPlacement;
-    lifetime?: AgentContextFragmentLifetime;
-    title?: string;
-    source?: string;
-    budgetBehavior?: AgentContextFragmentBudgetBehavior;
-    maxChars?: number;
-    dedupeKey?: string | ((context: SlackContextFragmentResolverContext) => string | undefined);
-    metadata?: Record<string, unknown> | ((context: SlackContextFragmentResolverContext) => Record<string, unknown> | undefined);
-}
-declare function createSlackContextFragmentMiddleware(options?: SlackContextFragmentMiddlewareOptions): AgentMiddleware;
-
-export { DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY, type SlackChatStream, type SlackContextFragmentMiddlewareOptions, type SlackContextFragmentPayload, type SlackContextFragmentResolver, type SlackContextFragmentResolverContext, SlackEventBridgeOptions, type SlackResponseSink, type SlackStreamChunk, type SlackStreamTaskStatus, UnsupportedSlackInteractiveRequestError, bridgeAgentEventsToSlack, createSlackContextFragmentMiddleware };
+export { type SlackArtifactPublicationTarget, type SlackChatStream, SlackEventBridgeOptions, type SlackResponseSink, type SlackStreamChunk, type SlackStreamTaskStatus, UnsupportedSlackInteractiveRequestError, bridgeAgentEventsToSlack };

package/dist/{shared.js → shared/index.js}

@@ -1,16 +1,12 @@
 import {
   DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY,
   createSlackContextFragmentMiddleware
-} from "./chunk-NIPAN4KA.js";
+} from "../chunk-A2PLAVW6.js";
 import {
   UnsupportedSlackInteractiveRequestError,
   bridgeAgentEventsToSlack,
   resolveSlackEventBridgeOptions
-} from "./chunk-DHPD4XH5.js";
-import "./chunk-I2KLQ2HA.js";
-
-// src/shared.ts
-export * from "@cuylabs/channel-slack/core";
+} from "../chunk-TMADMHBN.js";
 export {
   DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY,
   UnsupportedSlackInteractiveRequestError,

package/dist/socket.d.ts

@@ -1,16 +1,21 @@
 import { App } from '@slack/bolt';
-import { SlackDirectAuthOptions, CreateSlackSocketBoltAppOptions, SlackDirectAuthMode } from '@cuylabs/channel-slack/bolt';
-import { S as SlackAssistantBridge, C as CreateSlackAssistantBridgeOptions, b as SlackAssistantFeedbackConfig } from './options-Uf-qmQKN.js';
+import { CreateSlackSocketBoltAppOptions } from '@cuylabs/channel-slack/transports/socket';
+import { SlackDirectAuthOptions, SlackDirectAuthMode } from '@cuylabs/channel-slack/auth';
+import { S as SlackAssistantBridge, C as CreateSlackAssistantBridgeOptions, b as SlackAssistantFeedbackConfig } from './options-CdqBABcM.js';
 import { SlackAgentAppSurfaceOptions } from './app-surface.js';
 import { SlackFeedbackHandler } from '@cuylabs/channel-slack/feedback';
 import '@cuylabs/agent-core';
 import '@slack/web-api';
 import '@cuylabs/channel-slack/core';
 import './interactive-o_NZb-Xg.js';
-import './options-C7OYeNR-.js';
+import './options-BcDReOJv.js';
+import './artifacts/index.js';
+import '@cuylabs/channel-slack/artifacts';
 import '@cuylabs/channel-slack/assistant';
-import './types-BqRzb_Cd.js';
+import './types-CRWzJB5G.js';
 import './types-Crpil4kb.js';
+import './types-CiwGU6zC.js';
+import '@cuylabs/channel-slack/views';
 
 /**
  * Socket Mode helpers for direct Slack.