@cuylabs/channel-slack-agent-core 0.6.0 → 0.7.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, b as SlackAssistantFeedbackConfig, S as SlackAssistantBridge } from './options-CdqBABcM.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-7DUO5BMW.js";
+import "./chunk-MGBNGG4D.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-CdqBABcM.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-76SRS54H.js";
+import "./chunk-7DUO5BMW.js";
+import "./chunk-MGBNGG4D.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-CdqBABcM.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-CdqBABcM.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-MGBNGG4D.js";
 import "../chunk-ELR6MQD7.js";
-import "../chunk-NOVWLAVP.js";
+import "../chunk-TMADMHBN.js";
 export {
   createSlackAssistantBridge,
   createSlackAssistantThreadContextStore,

package/dist/{chunk-FNT4TXNQ.js → chunk-76SRS54H.js}

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

package/dist/{chunk-P7KK5GQG.js → chunk-7DUO5BMW.js}

@@ -1,13 +1,13 @@
 import {
   createSlackAssistantBridge
-} from "./chunk-ZDVD46RT.js";
+} from "./chunk-MGBNGG4D.js";
 import {
   createSlackFeedbackBlock,
   registerSlackFeedbackAction
 } 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 +26,7 @@ function installSlackAgentAppSurface(boltApp, options) {
     prepareTurn,
     resolveSession,
     interactive,
+    viewWorkflows,
     ...assistantBridgeOptions
   } = options;
   const feedbackConfig = feedbackOption === false ? void 0 : feedbackOption ?? (onFeedback ? { onFeedback } : {});
@@ -63,6 +64,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 +72,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 } : {},
@@ -101,6 +109,7 @@ function installSlackAgentAppSurface(boltApp, options) {
     });
   }
   interactive?.install(boltApp);
+  viewWorkflows?.install(boltApp);
   return { bridge };
 }
 function mergeChatStreamFinalArgs(base, feedbackBlock) {

package/dist/chunk-C7CHMYV6.js

@@ -0,0 +1,226 @@
+// src/views/controller.ts
+import { registerSlackViewWorkflow } from "@cuylabs/channel-slack/views";
+
+// src/views/state.ts
+function extractSlackAgentViewStateValues(viewOrState) {
+  const state = isRecord(viewOrState) ? isRecord(viewOrState.state) ? viewOrState.state : viewOrState : {};
+  const rawValues = isRecord(state.values) ? state.values : {};
+  const values = {};
+  for (const [blockId, rawActions] of Object.entries(rawValues)) {
+    if (!isRecord(rawActions)) {
+      continue;
+    }
+    const actions = {};
+    for (const [actionId, rawAction] of Object.entries(rawActions)) {
+      actions[actionId] = extractSlackAgentViewActionValue(rawAction);
+    }
+    values[blockId] = actions;
+  }
+  return values;
+}
+function readSlackAgentViewStateValue(valuesOrView, blockId, actionId) {
+  const values = looksLikeExtractedStateValues(valuesOrView) ? valuesOrView : extractSlackAgentViewStateValues(valuesOrView);
+  return values[blockId]?.[actionId];
+}
+function extractSlackAgentViewActionValue(rawAction) {
+  if (!isRecord(rawAction)) {
+    return void 0;
+  }
+  if ("value" in rawAction && typeof rawAction.value !== "undefined") {
+    return normalizeValue(rawAction.value);
+  }
+  if (isRecord(rawAction.selected_option)) {
+    return readOptionValue(rawAction.selected_option);
+  }
+  if (Array.isArray(rawAction.selected_options)) {
+    return rawAction.selected_options.map(readOptionValue).filter(isString);
+  }
+  for (const field of [
+    "selected_user",
+    "selected_users",
+    "selected_channel",
+    "selected_channels",
+    "selected_conversation",
+    "selected_conversations",
+    "selected_date",
+    "selected_time",
+    "selected_date_time"
+  ]) {
+    const value = rawAction[field];
+    if (typeof value !== "undefined") {
+      return normalizeValue(value);
+    }
+  }
+  if (typeof rawAction.checked === "boolean") {
+    return rawAction.checked;
+  }
+  return rawAction;
+}
+function readOptionValue(option) {
+  if (!isRecord(option)) {
+    return "";
+  }
+  if (typeof option.value === "string") {
+    return option.value;
+  }
+  const text = option.text;
+  if (isRecord(text) && typeof text.text === "string") {
+    return text.text;
+  }
+  return "";
+}
+function normalizeValue(value) {
+  if (typeof value === "string" || typeof value === "boolean" || typeof value === "number") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.filter(isString);
+  }
+  return isRecord(value) ? value : void 0;
+}
+function looksLikeExtractedStateValues(value) {
+  if (!isRecord(value) || "state" in value || "values" in value) {
+    return false;
+  }
+  return Object.values(value).every(isRecord);
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function isString(value) {
+  return typeof value === "string";
+}
+
+// src/views/controller.ts
+var DEFAULT_NAMESPACE = "agent_slack_view";
+var installedCallbackIds = /* @__PURE__ */ new WeakMap();
+function createSlackAgentViewWorkflowController({
+  namespace = DEFAULT_NAMESPACE,
+  workflows = [],
+  onError
+} = {}) {
+  const normalizedNamespace = normalizeIdentifier(namespace, "namespace");
+  const registeredWorkflows = /* @__PURE__ */ new Map();
+  const installedApps = /* @__PURE__ */ new Set();
+  function register(workflow) {
+    const workflowId = normalizeIdentifier(workflow.id, "workflow id");
+    if (!workflow.onSubmission && !workflow.onClose) {
+      throw new Error(
+        `Slack agent view workflow '${workflowId}' must define onSubmission or onClose.`
+      );
+    }
+    if (registeredWorkflows.has(workflowId)) {
+      throw new Error(`Duplicate Slack agent view workflow id: ${workflowId}`);
+    }
+    const callbackId = normalizeOptionalIdentifier(workflow.callbackId) ?? callbackIdFromWorkflowId(normalizedNamespace, workflowId);
+    if ([...registeredWorkflows.values()].some(
+      (item) => item.callbackId === callbackId
+    )) {
+      throw new Error(`Duplicate Slack view callback id: ${callbackId}`);
+    }
+    const registered = {
+      ...workflow,
+      id: workflowId,
+      callbackId
+    };
+    registeredWorkflows.set(workflowId, registered);
+    for (const app of installedApps) {
+      installWorkflow(app, registered);
+    }
+    return callbackId;
+  }
+  function callbackIdFor(workflowId) {
+    const normalizedWorkflowId = normalizeIdentifier(workflowId, "workflow id");
+    return registeredWorkflows.get(normalizedWorkflowId)?.callbackId ?? callbackIdFromWorkflowId(normalizedNamespace, normalizedWorkflowId);
+  }
+  function list() {
+    return [...registeredWorkflows.values()].map(({ id, callbackId }) => ({
+      id,
+      callbackId
+    }));
+  }
+  function install(app) {
+    installedApps.add(app);
+    for (const workflow of registeredWorkflows.values()) {
+      installWorkflow(app, workflow);
+    }
+  }
+  function installWorkflow(app, workflow) {
+    const callbackIds = callbackIdsForApp(app);
+    if (callbackIds.has(workflow.callbackId)) {
+      throw new Error(
+        `Slack view callback id '${workflow.callbackId}' is already installed on this Bolt app.`
+      );
+    }
+    callbackIds.add(workflow.callbackId);
+    registerSlackViewWorkflow({
+      boltApp: app,
+      callbackId: workflow.callbackId,
+      ...workflow.decodePrivateMetadata ? { decodePrivateMetadata: workflow.decodePrivateMetadata } : {},
+      ...workflow.onSubmission ? {
+        onSubmission: async (context) => await workflow.onSubmission(enrichContext(workflow, context))
+      } : {},
+      ...workflow.onClose ? {
+        onClose: async (context) => await workflow.onClose(enrichContext(workflow, context))
+      } : {},
+      onError: async (error, context) => {
+        const enriched = enrichContext(workflow, {
+          ...context,
+          metadata: context.metadata
+        });
+        if (workflow.onError) {
+          await workflow.onError(error, enriched);
+          return;
+        }
+        await onError?.(error, enriched);
+      }
+    });
+  }
+  for (const workflow of workflows) {
+    register(workflow);
+  }
+  return {
+    namespace: normalizedNamespace,
+    register,
+    callbackIdFor,
+    list,
+    install
+  };
+}
+function enrichContext(workflow, context) {
+  const stateValues = extractSlackAgentViewStateValues(context.view);
+  return {
+    ...context,
+    workflow: { id: workflow.id, callbackId: workflow.callbackId },
+    stateValues,
+    getStateValue: (blockId, actionId) => readSlackAgentViewStateValue(stateValues, blockId, actionId)
+  };
+}
+function callbackIdsForApp(app) {
+  let callbackIds = installedCallbackIds.get(app);
+  if (!callbackIds) {
+    callbackIds = /* @__PURE__ */ new Set();
+    installedCallbackIds.set(app, callbackIds);
+  }
+  return callbackIds;
+}
+function callbackIdFromWorkflowId(namespace, workflowId) {
+  return `${namespace}_${workflowId}`;
+}
+function normalizeOptionalIdentifier(value) {
+  const normalized = value?.trim();
+  return normalized ? normalized : void 0;
+}
+function normalizeIdentifier(value, label) {
+  const normalized = value.trim().replace(/[^A-Za-z0-9_-]+/g, "_").replace(/^_+|_+$/g, "");
+  if (!normalized) {
+    throw new Error(`Slack agent view workflow ${label} cannot be empty.`);
+  }
+  return normalized;
+}
+
+export {
+  extractSlackAgentViewStateValues,
+  readSlackAgentViewStateValue,
+  createSlackAgentViewWorkflowController
+};

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

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

package/dist/{chunk-TIQGJ52F.js → chunk-FQWFB54C.js}

@@ -2,7 +2,7 @@ import {
   UnsupportedSlackInteractiveRequestError,
   bridgeAgentEventsToSlack,
   resolveSlackEventBridgeOptions
-} from "./chunk-NOVWLAVP.js";
+} from "./chunk-TMADMHBN.js";
 
 // src/adapter/adapter.ts
 import { withinScope } from "@cuylabs/agent-core";
@@ -73,6 +73,11 @@ function buildThreadPayload(info, respondInThread) {
 function buildResponseSink(say, client, info, respondInThread, chatStreamStartArgs, sayStream) {
   const threadPayload = buildThreadPayload(info, respondInThread);
   return {
+    artifactClient: client,
+    artifactTarget: {
+      channelId: info.channelId,
+      ...threadPayload.thread_ts ? { threadTs: threadPayload.thread_ts } : {}
+    },
     async postMessage(text) {
       const result = await say({ text, ...threadPayload });
       const response = result;
@@ -167,6 +172,7 @@ function createSlackChannelAdapter(options) {
       formatToolTitle: options.formatToolTitle,
       formatToolUpdate: options.formatToolUpdate,
       formatToolDetails: options.formatToolDetails,
+      formatToolResultOutput: options.formatToolResultOutput,
       formatToolError: options.formatToolError,
       formatReasoningUpdate: options.formatReasoningUpdate,
       interactiveMode: options.interactiveMode,
@@ -180,7 +186,13 @@ function createSlackChannelAdapter(options) {
       maxTaskUpdates: options.maxTaskUpdates,
       maxTaskUpdateTextChars: options.maxTaskUpdateTextChars,
       maxTaskUpdateFieldChars: options.maxTaskUpdateFieldChars,
-      chatStreamFinalArgs: options.chatStreamFinalArgs
+      chatStreamFinalArgs: options.chatStreamFinalArgs,
+      publishFinalResponseArtifact: options.publishFinalResponseArtifact,
+      finalResponseArtifactMode: options.finalResponseArtifactMode,
+      finalResponseArtifactStreamThreshold: options.finalResponseArtifactStreamThreshold,
+      formatFinalResponseArtifactContinuationNotice: options.formatFinalResponseArtifactContinuationNotice,
+      formatFinalResponseArtifactMessage: options.formatFinalResponseArtifactMessage,
+      onFinalResponseArtifactError: options.onFinalResponseArtifactError
     }
   );
   const timeout = options.timeout ?? 12e4;

package/dist/{chunk-ZDVD46RT.js → chunk-MGBNGG4D.js}

@@ -7,7 +7,7 @@ import {
   UnsupportedSlackInteractiveRequestError,
   bridgeAgentEventsToSlack,
   resolveSlackEventBridgeOptions
-} from "./chunk-NOVWLAVP.js";
+} from "./chunk-TMADMHBN.js";
 
 // src/assistant/bridge.ts
 import { Assistant } from "@slack/bolt";
@@ -239,6 +239,11 @@ function createAssistantSink(params) {
     return stream;
   }
   return {
+    artifactClient: params.client,
+    artifactTarget: {
+      channelId: params.channel,
+      threadTs: params.threadTs
+    },
     async postMessage() {
       throw new Error(
         "Assistant bridge uses chat-stream mode and does not support postMessage."
@@ -427,6 +432,7 @@ function createUserMessageHandler(deps) {
         ...options.formatToolTitle ? { formatToolTitle: options.formatToolTitle } : {},
         ...options.formatToolUpdate ? { formatToolUpdate: options.formatToolUpdate } : {},
         ...options.formatToolDetails ? { formatToolDetails: options.formatToolDetails } : {},
+        ...options.formatToolResultOutput ? { formatToolResultOutput: options.formatToolResultOutput } : {},
         ...options.formatToolError ? { formatToolError: options.formatToolError } : {},
         ...options.formatReasoningUpdate ? { formatReasoningUpdate: options.formatReasoningUpdate } : {},
         ...options.chatStreamBufferSize !== void 0 ? { chatStreamBufferSize: options.chatStreamBufferSize } : {},
@@ -434,6 +440,22 @@ function createUserMessageHandler(deps) {
         ...options.maxTaskUpdateTextChars !== void 0 ? { maxTaskUpdateTextChars: options.maxTaskUpdateTextChars } : {},
         ...options.maxTaskUpdateFieldChars !== void 0 ? { maxTaskUpdateFieldChars: options.maxTaskUpdateFieldChars } : {},
         ...chatStreamFinalArgs ? { chatStreamFinalArgs } : {},
+        ...options.publishFinalResponseArtifact ? {
+          publishFinalResponseArtifact: options.publishFinalResponseArtifact
+        } : {},
+        ...options.finalResponseArtifactMode ? { finalResponseArtifactMode: options.finalResponseArtifactMode } : {},
+        ...options.finalResponseArtifactStreamThreshold !== void 0 ? {
+          finalResponseArtifactStreamThreshold: options.finalResponseArtifactStreamThreshold
+        } : {},
+        ...options.formatFinalResponseArtifactContinuationNotice ? {
+          formatFinalResponseArtifactContinuationNotice: options.formatFinalResponseArtifactContinuationNotice
+        } : {},
+        ...options.formatFinalResponseArtifactMessage ? {
+          formatFinalResponseArtifactMessage: options.formatFinalResponseArtifactMessage
+        } : {},
+        ...options.onFinalResponseArtifactError ? {
+          onFinalResponseArtifactError: options.onFinalResponseArtifactError
+        } : {},
         formatMessageText: messageFormatter,
         onStatusChange: async (label, event) => {
           const update = await resolveStatusUpdate(