@cuylabs/channel-slack-agent-core 0.6.0 → 0.8.0

package/README.md

@@ -22,6 +22,10 @@ Install Slack peer dependencies for the surfaces you use:
 npm install @slack/bolt @slack/web-api express
 ```
 
+Postgres-backed interactive request storage lazy-loads `pg` when you pass a
+connection string. Install `pg` only when your application uses that helper
+without injecting its own client.
+
 ## Quick Start
 
 Socket Mode:
@@ -51,4 +55,7 @@ await mountSlackAgent(agent, {
 
 - [Package boundary](docs/reference/boundary.md)
 - [Exports and peer expectations](docs/reference/exports.md)
+- [Interactive requests](docs/concepts/interactive-requests.md)
+- [Final response artifacts](docs/concepts/final-response-artifacts.md)
+- [Tool task rendering](docs/concepts/tool-task-rendering.md)
 - [Docs index](docs/README.md)

package/dist/adapter/index.d.ts

@@ -1,8 +1,11 @@
-export { c as createSlackChannelAdapter } from '../adapter-Cmd2C90g.js';
-import { a as SlackChannelOptions } from '../types-BqRzb_Cd.js';
-export { S as SlackChannelAdapter, b as SlackSessionStrategy, c as SlackStreamingMode, d as SlackToolStartEvent } from '../types-BqRzb_Cd.js';
+export { c as createSlackChannelAdapter } from '../adapter-B3CI611y.js';
+import { a as SlackChannelOptions } from '../types-CRWzJB5G.js';
+export { S as SlackChannelAdapter, b as SlackSessionStrategy, c as SlackStreamingMode, d as SlackToolStartEvent } from '../types-CRWzJB5G.js';
 import { SlackActivityInfo } from '@cuylabs/channel-slack/core';
 import '@cuylabs/agent-core';
+import '../options-BcDReOJv.js';
+import '../artifacts/index.js';
+import '@cuylabs/channel-slack/artifacts';
 import '../interactive-o_NZb-Xg.js';
 
 /**

package/dist/adapter/index.js

@@ -1,8 +1,8 @@
 import {
   createSlackChannelAdapter,
   createSlackSessionMap
-} from "../chunk-TIQGJ52F.js";
-import "../chunk-NOVWLAVP.js";
+} from "../chunk-FQWFB54C.js";
+import "../chunk-TMADMHBN.js";
 export {
   createSlackChannelAdapter,
   createSlackSessionMap

package/dist/{adapter-Cmd2C90g.d.ts → adapter-B3CI611y.d.ts}

@@ -1,4 +1,4 @@
-import { a as SlackChannelOptions, S as SlackChannelAdapter } from './types-BqRzb_Cd.js';
+import { a as SlackChannelOptions, S as SlackChannelAdapter } from './types-CRWzJB5G.js';
 
 /**
  * Slack Channel Adapter

package/dist/app-surface.d.ts

@@ -1,14 +1,18 @@
 import { AgentTurnSource, Logger } from '@cuylabs/agent-core';
 import { App } from '@slack/bolt';
 import { WebClient } from '@slack/web-api';
-import { C as CreateSlackAssistantBridgeOptions, b as SlackAssistantFeedbackConfig, S as SlackAssistantBridge } from './options-Uf-qmQKN.js';
-import { a as SlackChannelOptions } from './types-BqRzb_Cd.js';
+import { C as CreateSlackAssistantBridgeOptions, d as SlackAssistantFeedbackConfig, S as SlackAssistantBridge } from './options-C7-VXmhD.js';
+import { a as SlackChannelOptions } from './types-CRWzJB5G.js';
 import { SlackTurnRequestContext, SlackAssistantUtilities, SlackTurnPreparation } from '@cuylabs/channel-slack/core';
 import { SlackFeedbackHandler } from '@cuylabs/channel-slack/feedback';
 import { c as SlackInteractiveController } from './types-Crpil4kb.js';
+import { d as SlackAgentViewWorkflowController } from './types-CiwGU6zC.js';
 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 '@cuylabs/channel-slack/views';
 
 /**
  * Shared installer for the direct Slack app surfaces.
@@ -62,6 +66,12 @@ interface SlackAgentAppSurfaceOptions extends Omit<CreateSlackAssistantBridgeOpt
      * the agent config, or with `interactive.onResolve` for server-backed turns.
      */
     interactive?: SlackInteractiveController;
+    /**
+     * Product/agent Slack modal workflow controller. Use this for workflows that
+     * are richer than approval/human-input, such as incident triage forms or
+     * report-generation setup modals.
+     */
+    viewWorkflows?: SlackAgentViewWorkflowController;
 }
 interface SlackAgentAppSurfaceResult {
     bridge: SlackAssistantBridge;

package/dist/app-surface.js

@@ -1,10 +1,10 @@
 import {
   installSlackAgentAppSurface
-} from "./chunk-P7KK5GQG.js";
-import "./chunk-ZDVD46RT.js";
+} from "./chunk-6T6N4MRK.js";
+import "./chunk-7YZWCSML.js";
 import "./chunk-ELR6MQD7.js";
-import "./chunk-TIQGJ52F.js";
-import "./chunk-NOVWLAVP.js";
+import "./chunk-FQWFB54C.js";
+import "./chunk-TMADMHBN.js";
 export {
   installSlackAgentAppSurface
 };

package/dist/app.d.ts

@@ -5,15 +5,19 @@ import { CreateSlackBoltAppOptions } from '@cuylabs/channel-slack/transports/htt
 import { SlackDirectAuthOptions, SlackDirectAuthMode } from '@cuylabs/channel-slack/auth';
 import { SlackAgentAppSurfaceOptions } from './app-surface.js';
 export { MountSlackAgentAppTurnRequestContext } from './app-surface.js';
-import { S as SlackAssistantBridge } from './options-Uf-qmQKN.js';
+import { S as SlackAssistantBridge } from './options-C7-VXmhD.js';
 import '@cuylabs/agent-core';
 import '@slack/web-api';
-import './types-BqRzb_Cd.js';
+import './types-CRWzJB5G.js';
 import '@cuylabs/channel-slack/core';
+import './options-BcDReOJv.js';
+import './artifacts/index.js';
+import '@cuylabs/channel-slack/artifacts';
 import './interactive-o_NZb-Xg.js';
 import '@cuylabs/channel-slack/feedback';
 import './types-Crpil4kb.js';
-import './options-C7OYeNR-.js';
+import './types-CiwGU6zC.js';
+import '@cuylabs/channel-slack/views';
 import '@cuylabs/channel-slack/assistant';
 
 /**

package/dist/app.js

@@ -1,11 +1,11 @@
 import {
   mountSlackAgentApp
-} from "./chunk-FNT4TXNQ.js";
-import "./chunk-P7KK5GQG.js";
-import "./chunk-ZDVD46RT.js";
+} from "./chunk-236WN6JD.js";
+import "./chunk-6T6N4MRK.js";
+import "./chunk-7YZWCSML.js";
 import "./chunk-ELR6MQD7.js";
-import "./chunk-TIQGJ52F.js";
-import "./chunk-NOVWLAVP.js";
+import "./chunk-FQWFB54C.js";
+import "./chunk-TMADMHBN.js";
 export {
   mountSlackAgentApp
 };

package/dist/artifacts/index.d.ts

@@ -0,0 +1,57 @@
+import { SlackArtifactClient, SlackArtifactPublication } from '@cuylabs/channel-slack/artifacts';
+
+interface SlackFinalResponseArtifactContext {
+    text: string;
+    formattedText: string;
+    client: SlackArtifactClient;
+    channelId: string;
+    threadTs?: string;
+}
+interface SlackFinalResponseArtifactResult {
+    publication: SlackArtifactPublication;
+}
+type SlackFinalResponseArtifactDeliveryMode = "supplemental" | "replace";
+type SlackFinalResponseArtifactPublisher = (context: SlackFinalResponseArtifactContext) => Promise<SlackFinalResponseArtifactResult | undefined>;
+type SlackFinalResponseArtifactValueResolver<T> = T | ((context: SlackFinalResponseArtifactContext) => T | Promise<T>);
+interface CreateSlackFinalResponseArtifactPublisherOptions {
+    /**
+     * Minimum raw-response characters required before publishing an artifact.
+     *
+     * @default 4000
+     */
+    minCharacters?: number;
+    /**
+     * Canvas/file title.
+     *
+     * @default "Agent response"
+     */
+    title?: SlackFinalResponseArtifactValueResolver<string | undefined>;
+    /**
+     * Optional Slack artifact summary.
+     */
+    summary?: SlackFinalResponseArtifactValueResolver<string | undefined>;
+    /**
+     * Prefer creating a channel canvas when the Slack client exposes
+     * `conversations.canvases.create`.
+     *
+     * @default true
+     */
+    channelCanvas?: boolean;
+    /**
+     * Fallback when Canvas publication fails.
+     *
+     * @default "file"
+     */
+    fallback?: "file" | "none";
+    /**
+     * Called after a Canvas or fallback file is published.
+     */
+    onPublished?: (result: SlackFinalResponseArtifactResult, context: SlackFinalResponseArtifactContext) => void | Promise<void>;
+    /**
+     * Called when Canvas publication fails and no fallback publication succeeds.
+     */
+    onError?: (error: unknown, context: SlackFinalResponseArtifactContext) => void | Promise<void>;
+}
+declare function createSlackFinalResponseArtifactPublisher({ minCharacters, title, summary, channelCanvas, fallback, onPublished, onError, }?: CreateSlackFinalResponseArtifactPublisherOptions): SlackFinalResponseArtifactPublisher;
+
+export { type CreateSlackFinalResponseArtifactPublisherOptions, type SlackFinalResponseArtifactContext, type SlackFinalResponseArtifactDeliveryMode, type SlackFinalResponseArtifactPublisher, type SlackFinalResponseArtifactResult, type SlackFinalResponseArtifactValueResolver, createSlackFinalResponseArtifactPublisher };

package/dist/artifacts/index.js

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

package/dist/assistant/index.d.ts

@@ -1,12 +1,14 @@
-import { C as CreateSlackAssistantBridgeOptions, S as SlackAssistantBridge } from '../options-Uf-qmQKN.js';
-export { A as AssistantLifecycleArgs, a as AssistantThreadStartedArgs, M as MaybePromise, b as SlackAssistantFeedbackConfig, c as SlackAssistantSessionStrategy, d as SlackAssistantStatusContext, e as SlackAssistantThreadContextStoreLike, f as SlackAssistantThreadStartedContext, g as SlackAssistantTurnPreparation, h as SlackAssistantUserMessageContext, r as resolveAssistantSessionId } from '../options-Uf-qmQKN.js';
+import { C as CreateSlackAssistantBridgeOptions, S as SlackAssistantBridge } from '../options-C7-VXmhD.js';
+export { A as AssistantLifecycleArgs, a as AssistantThreadStartedArgs, M as MaybePromise, 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-C7-VXmhD.js';
 export { ParsedAssistantUserMessage, createSlackAssistantThreadContextStore, parseSlackMessageActivityFromMessageEvent } from '@cuylabs/channel-slack/assistant';
 import '@cuylabs/agent-core';
 import '@slack/bolt';
 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/feedback';
 
 /**

package/dist/assistant/index.js

@@ -3,9 +3,9 @@ import {
   createSlackAssistantThreadContextStore,
   parseSlackMessageActivityFromMessageEvent,
   resolveAssistantSessionId
-} from "../chunk-ZDVD46RT.js";
+} from "../chunk-7YZWCSML.js";
 import "../chunk-ELR6MQD7.js";
-import "../chunk-NOVWLAVP.js";
+import "../chunk-TMADMHBN.js";
 export {
   createSlackAssistantBridge,
   createSlackAssistantThreadContextStore,

package/dist/{chunk-FNT4TXNQ.js → chunk-236WN6JD.js}

@@ -1,6 +1,6 @@
 import {
   installSlackAgentAppSurface
-} from "./chunk-P7KK5GQG.js";
+} from "./chunk-6T6N4MRK.js";
 
 // src/app.ts
 import {

package/dist/{chunk-5NQYLOAW.js → chunk-2R7B7NJR.js}

@@ -1,6 +1,6 @@
 import {
   createSlackAssistantBridge
-} from "./chunk-ZDVD46RT.js";
+} from "./chunk-7YZWCSML.js";
 
 // src/express-assistant.ts
 import {

package/dist/{chunk-P7KK5GQG.js → chunk-6T6N4MRK.js}

@@ -1,13 +1,12 @@
 import {
   createSlackAssistantBridge
-} from "./chunk-ZDVD46RT.js";
+} from "./chunk-7YZWCSML.js";
 import {
-  createSlackFeedbackBlock,
-  registerSlackFeedbackAction
+  createSlackFeedbackBlock
 } from "./chunk-ELR6MQD7.js";
 import {
   createSlackChannelAdapter
-} from "./chunk-TIQGJ52F.js";
+} from "./chunk-FQWFB54C.js";
 
 // src/app-surface.ts
 var DEFAULT_TIMEOUT_MS = 12e4;
@@ -26,6 +25,7 @@ function installSlackAgentAppSurface(boltApp, options) {
     prepareTurn,
     resolveSession,
     interactive,
+    viewWorkflows,
     ...assistantBridgeOptions
   } = options;
   const feedbackConfig = feedbackOption === false ? void 0 : feedbackOption ?? (onFeedback ? { onFeedback } : {});
@@ -48,7 +48,7 @@ function installSlackAgentAppSurface(boltApp, options) {
     ...resolveSession ? { resolveSession: toAssistantResolveSession(resolveSession) } : {},
     ...interactive ? { handleInteractiveRequest: interactive.handleInteractiveRequest } : {}
   });
-  boltApp.assistant(bridge.assistant);
+  bridge.install(boltApp);
   const channelAdapter = createSlackChannelAdapter({
     source: channelSource,
     sessionStrategy: assistantBridgeOptions.sessionStrategy,
@@ -63,6 +63,7 @@ function installSlackAgentAppSurface(boltApp, options) {
     formatToolTitle: assistantBridgeOptions.formatToolTitle,
     formatToolUpdate: assistantBridgeOptions.formatToolUpdate,
     formatToolDetails: assistantBridgeOptions.formatToolDetails,
+    formatToolResultOutput: assistantBridgeOptions.formatToolResultOutput,
     formatToolError: assistantBridgeOptions.formatToolError,
     formatReasoningUpdate: assistantBridgeOptions.formatReasoningUpdate,
     chatStreamBufferSize: assistantBridgeOptions.chatStreamBufferSize,
@@ -70,6 +71,12 @@ function installSlackAgentAppSurface(boltApp, options) {
       ...assistantBridgeOptions.chatStreamStartArgs ?? {},
       task_display_mode: assistantBridgeOptions.taskDisplayMode ?? "timeline"
     },
+    publishFinalResponseArtifact: assistantBridgeOptions.publishFinalResponseArtifact,
+    finalResponseArtifactMode: assistantBridgeOptions.finalResponseArtifactMode,
+    finalResponseArtifactStreamThreshold: assistantBridgeOptions.finalResponseArtifactStreamThreshold,
+    formatFinalResponseArtifactContinuationNotice: assistantBridgeOptions.formatFinalResponseArtifactContinuationNotice,
+    formatFinalResponseArtifactMessage: assistantBridgeOptions.formatFinalResponseArtifactMessage,
+    onFinalResponseArtifactError: assistantBridgeOptions.onFinalResponseArtifactError,
     ...typeof assistantBridgeOptions.initialStatus === "object" && assistantBridgeOptions.initialStatus !== null ? { initialStatus: assistantBridgeOptions.initialStatus } : {},
     ...formatting?.formatChatMarkdown !== void 0 ? { formatChatMarkdown: formatting.formatChatMarkdown } : {},
     ...formatting?.formatMessageText ? { formatMessageText: formatting.formatMessageText } : {},
@@ -91,16 +98,8 @@ function installSlackAgentAppSurface(boltApp, options) {
     } : {}
   });
   channelAdapter.mount(boltApp);
-  if (feedbackConfig) {
-    const feedbackSessionStrategy = assistantBridgeOptions.sessionStrategy ?? "thread-aware";
-    registerSlackFeedbackAction(boltApp, {
-      ...feedbackConfig,
-      resolveSessionId: (ctx) => resolveFeedbackSessionId(ctx, feedbackSessionStrategy),
-      onFeedback: feedbackConfig.onFeedback ?? (async (_ctx) => {
-      })
-    });
-  }
   interactive?.install(boltApp);
+  viewWorkflows?.install(boltApp);
   return { bridge };
 }
 function mergeChatStreamFinalArgs(base, feedbackBlock) {
@@ -182,17 +181,6 @@ function formatErrorForLog(error) {
   }
   return String(error);
 }
-function resolveFeedbackSessionId(context, strategy) {
-  const threadTs = context.threadTs ?? context.messageTs;
-  switch (strategy) {
-    case "channel-id":
-      return context.channelId;
-    case "user-per-thread":
-      return `${context.channelId}:${threadTs}:${context.userId}`;
-    default:
-      return `${context.channelId}:${threadTs}`;
-  }
-}
 
 export {
   installSlackAgentAppSurface