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

package/README.md

@@ -8,7 +8,8 @@ surfaces for Express Events API, Socket Mode, Slack Assistant, app mentions,
 DMs, feedback, approvals, or human input.
 
 Generic Slack mechanics such as parsing, policy, history, setup, auth, targets,
-users, entrypoints, artifacts, and transports live in `@cuylabs/channel-slack`.
+users, entrypoints, artifacts, interactive stores/builders, response sinks, and
+transports live in `@cuylabs/channel-slack`.
 
 ## Install
 
@@ -22,7 +23,8 @@ 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
+Postgres-backed interactive request storage lives in
+`@cuylabs/channel-slack/interactive` and lazy-loads `pg` when you pass a
 connection string. Install `pg` only when your application uses that helper
 without injecting its own client.
 

package/dist/adapter/index.d.ts

@@ -1,12 +1,13 @@
-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';
+export { c as createSlackChannelAdapter } from '../adapter-vbqtraAr.js';
+import { a as SlackChannelOptions } from '../types-BeGPexio.js';
+export { S as SlackChannelAdapter, b as SlackSessionStrategy, c as SlackStreamingMode, d as SlackToolStartEvent } from '../types-BeGPexio.js';
 import { SlackActivityInfo } from '@cuylabs/channel-slack/core';
 import '@cuylabs/agent-core';
-import '../options-BcDReOJv.js';
+import '../options-CGUfVStV.js';
 import '../artifacts/index.js';
 import '@cuylabs/channel-slack/artifacts';
-import '../interactive-o_NZb-Xg.js';
+import '../interactive-BigrPKnu.js';
+import '@cuylabs/channel-slack/interactive';
 
 /**
  * Session mapping — Slack activity info to agent-core session IDs.

package/dist/adapter/index.js

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

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

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

package/dist/app-surface.d.ts

@@ -1,14 +1,15 @@
 import { AgentTurnSource, Logger } from '@cuylabs/agent-core';
 import { App } from '@slack/bolt';
 import { WebClient } from '@slack/web-api';
-import { C as CreateSlackAssistantBridgeOptions, d as SlackAssistantFeedbackConfig, S as SlackAssistantBridge } from './options-C7-VXmhD.js';
-import { a as SlackChannelOptions } from './types-CRWzJB5G.js';
+import { C as CreateSlackAssistantBridgeOptions, d as SlackAssistantFeedbackConfig, S as SlackAssistantBridge } from './options-ByNm2o89.js';
+import { a as SlackChannelOptions } from './types-BeGPexio.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 { a as SlackInteractiveController } from './types-Bz4OYEAV.js';
 import { d as SlackAgentViewWorkflowController } from './types-CiwGU6zC.js';
-import './interactive-o_NZb-Xg.js';
-import './options-BcDReOJv.js';
+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/assistant';

package/dist/app-surface.js

@@ -1,10 +1,10 @@
 import {
   installSlackAgentAppSurface
-} from "./chunk-6T6N4MRK.js";
-import "./chunk-7YZWCSML.js";
+} from "./chunk-Q2GU4QLZ.js";
+import "./chunk-GEFK72VO.js";
 import "./chunk-ELR6MQD7.js";
-import "./chunk-FQWFB54C.js";
-import "./chunk-TMADMHBN.js";
+import "./chunk-KQPUQJ57.js";
+import "./chunk-L5RAGYVJ.js";
 export {
   installSlackAgentAppSurface
 };

package/dist/app.d.ts

@@ -5,17 +5,18 @@ 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-C7-VXmhD.js';
+import { S as SlackAssistantBridge } from './options-ByNm2o89.js';
 import '@cuylabs/agent-core';
 import '@slack/web-api';
-import './types-CRWzJB5G.js';
+import './types-BeGPexio.js';
 import '@cuylabs/channel-slack/core';
-import './options-BcDReOJv.js';
+import './options-CGUfVStV.js';
 import './artifacts/index.js';
 import '@cuylabs/channel-slack/artifacts';
-import './interactive-o_NZb-Xg.js';
+import './interactive-BigrPKnu.js';
+import '@cuylabs/channel-slack/interactive';
 import '@cuylabs/channel-slack/feedback';
-import './types-Crpil4kb.js';
+import './types-Bz4OYEAV.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-236WN6JD.js";
-import "./chunk-6T6N4MRK.js";
-import "./chunk-7YZWCSML.js";
+} from "./chunk-P2DIC42J.js";
+import "./chunk-Q2GU4QLZ.js";
+import "./chunk-GEFK72VO.js";
 import "./chunk-ELR6MQD7.js";
-import "./chunk-FQWFB54C.js";
-import "./chunk-TMADMHBN.js";
+import "./chunk-KQPUQJ57.js";
+import "./chunk-L5RAGYVJ.js";
 export {
   mountSlackAgentApp
 };

package/dist/assistant/index.d.ts

@@ -1,12 +1,13 @@
-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';
+import { C as CreateSlackAssistantBridgeOptions, S as SlackAssistantBridge } from '../options-ByNm2o89.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-ByNm2o89.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-BcDReOJv.js';
+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';

package/dist/assistant/index.js

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

package/dist/{chunk-YSDFYHPC.js → chunk-6EMFBOXD.js}

@@ -1,9 +1,9 @@
 import {
   installSlackAgentAppSurface
-} from "./chunk-6T6N4MRK.js";
+} from "./chunk-Q2GU4QLZ.js";
 import {
   createSlackAssistantBridge
-} from "./chunk-7YZWCSML.js";
+} from "./chunk-GEFK72VO.js";
 
 // src/socket.ts
 import { createSlackSocketBoltApp } from "@cuylabs/channel-slack/transports/socket";

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

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

package/dist/{chunk-7YZWCSML.js → chunk-GEFK72VO.js}

@@ -7,7 +7,7 @@ import {
   UnsupportedSlackInteractiveRequestError,
   bridgeAgentEventsToSlack,
   resolveSlackEventBridgeOptions
-} from "./chunk-TMADMHBN.js";
+} from "./chunk-L5RAGYVJ.js";
 
 // src/assistant/bridge.ts
 import { Assistant } from "@slack/bolt";

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

@@ -2,7 +2,7 @@ import {
   UnsupportedSlackInteractiveRequestError,
   bridgeAgentEventsToSlack,
   resolveSlackEventBridgeOptions
-} from "./chunk-TMADMHBN.js";
+} from "./chunk-L5RAGYVJ.js";
 
 // src/adapter/adapter.ts
 import { withinScope } from "@cuylabs/agent-core";

package/dist/chunk-L5RAGYVJ.js

@@ -0,0 +1,245 @@
+// src/shared/event-bridge/agent-event-mapper.ts
+function mapAgentEventToSlackTurnEvent(event) {
+  switch (event.type) {
+    case "text-start":
+    case "text-delta":
+    case "text-end":
+    case "reasoning-start":
+    case "reasoning-end":
+    case "tool-start":
+    case "tool-result":
+    case "tool-error":
+    case "subagent-start":
+    case "subagent-complete":
+    case "subagent-error":
+    case "status":
+    case "complete":
+    case "error":
+    case "approval-request":
+    case "approval-resolved":
+    case "human-input-request":
+    case "human-input-resolved":
+      return { ...event };
+    case "subagent-event":
+      return {
+        ...event,
+        event: mapAgentEventToSlackTurnEvent(event.event)
+      };
+    case "reasoning-delta":
+    case "step-start":
+    case "step-finish":
+    case "turn-boundary":
+    case "message":
+    case "computer-call":
+    case "computer-result":
+    case "intervention-applied":
+    case "follow-up-queued":
+    case "doom-loop":
+    case "context-overflow":
+    case "context-compaction":
+    case "turn-summary":
+    case "retry":
+      return mapIgnoredAgentEvent(event);
+    default:
+      return mapIgnoredAgentEvent(event);
+  }
+}
+function mapIgnoredAgentEvent(event) {
+  return { ...event };
+}
+
+// src/shared/event-bridge/options-adapter.ts
+function mapAgentSlackEventBridgeOptionsToRuntimeOptions(options) {
+  return {
+    showReasoning: options.showReasoning,
+    showToolUsage: options.showToolUsage,
+    showSubagentToolUsage: options.showSubagentToolUsage,
+    showSubagentResultInTask: options.showSubagentResultInTask,
+    ...options.formatToolTitle ? { formatToolTitle: options.formatToolTitle } : {},
+    formatToolUpdate: options.formatToolUpdate,
+    ...options.formatToolDetails ? {
+      formatToolDetails: (event) => options.formatToolDetails?.(
+        event
+      )
+    } : {},
+    ...options.formatToolResultOutput ? {
+      formatToolResultOutput: (event) => options.formatToolResultOutput?.(
+        event
+      )
+    } : {},
+    formatToolError: options.formatToolError,
+    formatReasoningUpdate: options.formatReasoningUpdate,
+    formatMessageText: options.formatMessageText,
+    streamingMode: options.streamingMode,
+    progressiveUpdateThreshold: options.progressiveUpdateThreshold,
+    progressiveUpdateIntervalMs: options.progressiveUpdateIntervalMs,
+    chatStreamBufferSize: options.chatStreamBufferSize,
+    maxTaskUpdates: options.maxTaskUpdates,
+    maxTaskUpdateTextChars: options.maxTaskUpdateTextChars,
+    maxTaskUpdateFieldChars: options.maxTaskUpdateFieldChars,
+    interactiveMode: options.interactiveMode,
+    ...options.handleInteractiveRequest ? {
+      handleInteractiveRequest: (context) => options.handleInteractiveRequest?.(
+        context
+      )
+    } : {},
+    formatApprovalRequired: (request) => options.formatApprovalRequired(request),
+    formatHumanInputRequired: (request) => options.formatHumanInputRequired(request),
+    ...options.onStatusChange ? {
+      onStatusChange: (label, event) => options.onStatusChange?.(
+        label,
+        event
+      )
+    } : {},
+    ...options.chatStreamFinalArgs ? { chatStreamFinalArgs: options.chatStreamFinalArgs } : {},
+    ...options.publishFinalResponseArtifact ? { publishFinalResponseArtifact: options.publishFinalResponseArtifact } : {},
+    ...options.finalResponseArtifactMode ? { finalResponseArtifactMode: options.finalResponseArtifactMode } : {},
+    ...options.finalResponseArtifactStreamThreshold ? {
+      finalResponseArtifactStreamThreshold: options.finalResponseArtifactStreamThreshold
+    } : {},
+    ...options.formatFinalResponseArtifactContinuationNotice ? {
+      formatFinalResponseArtifactContinuationNotice: options.formatFinalResponseArtifactContinuationNotice
+    } : {},
+    ...options.formatFinalResponseArtifactMessage ? {
+      formatFinalResponseArtifactMessage: options.formatFinalResponseArtifactMessage
+    } : {},
+    ...options.onFinalResponseArtifactError ? { onFinalResponseArtifactError: options.onFinalResponseArtifactError } : {}
+  };
+}
+
+// src/shared/event-bridge/bridge.ts
+import {
+  bridgeSlackTurnEventsToSlack
+} from "@cuylabs/channel-slack/runtime";
+async function bridgeAgentEventsToSlack(events, sink, options) {
+  return bridgeSlackTurnEventsToSlack(
+    toSlackTurnEvents(events),
+    sink,
+    mapAgentSlackEventBridgeOptionsToRuntimeOptions(options)
+  );
+}
+async function* toSlackTurnEvents(events) {
+  for await (const event of events) {
+    yield mapAgentEventToSlackTurnEvent(event);
+  }
+}
+
+// src/shared/event-bridge/options.ts
+var DEFAULT_OPTIONS = {
+  showReasoning: false,
+  showToolUsage: true,
+  showSubagentToolUsage: false,
+  showSubagentResultInTask: false,
+  formatToolTitle: (toolName) => toolName,
+  formatToolUpdate: (toolName) => `\u{1F50D} Using tool: ${toolName}...`,
+  formatToolError: (toolName, _error) => `\u26A0\uFE0F Tool ${toolName} encountered an error`,
+  formatReasoningUpdate: () => "Thinking...",
+  formatMessageText: (text) => text,
+  streamingMode: "progressive",
+  progressiveUpdateThreshold: 150,
+  progressiveUpdateIntervalMs: 3e3,
+  chatStreamBufferSize: 256,
+  maxTaskUpdates: 200,
+  maxTaskUpdateTextChars: 2e4,
+  maxTaskUpdateFieldChars: 500,
+  interactiveMode: "message-and-error",
+  formatApprovalRequired: (request) => `This turn requires approval for "${request.tool}", but in-channel approval is not configured for this Slack host.`,
+  formatHumanInputRequired: (request) => `This turn is waiting for input: ${request.title}. In-channel human input is not configured for this Slack host.`,
+  finalResponseArtifactMode: "supplemental",
+  finalResponseArtifactStreamThreshold: 4e3,
+  formatFinalResponseArtifactContinuationNotice: () => "\n\nFull response is long. I will publish the complete answer as a Slack artifact when it finishes.",
+  formatFinalResponseArtifactMessage: (result) => {
+    const title = result.publication.artifact.title.trim() || "Agent response";
+    if (result.publication.method === "canvas") {
+      return `I created a Slack Canvas for the full response: ${title}`;
+    }
+    if (result.publication.method === "file") {
+      return `I uploaded the full response as a file: ${title}`;
+    }
+    return `I published the full response as a Slack artifact: ${title}`;
+  }
+};
+function resolveSlackEventBridgeOptions(partial) {
+  return {
+    showReasoning: partial.showReasoning ?? DEFAULT_OPTIONS.showReasoning,
+    showToolUsage: partial.showToolUsage ?? DEFAULT_OPTIONS.showToolUsage,
+    showSubagentToolUsage: partial.showSubagentToolUsage ?? DEFAULT_OPTIONS.showSubagentToolUsage,
+    showSubagentResultInTask: partial.showSubagentResultInTask ?? DEFAULT_OPTIONS.showSubagentResultInTask,
+    formatToolTitle: partial.formatToolTitle ?? DEFAULT_OPTIONS.formatToolTitle,
+    formatToolUpdate: partial.formatToolUpdate ?? DEFAULT_OPTIONS.formatToolUpdate,
+    ...partial.formatToolDetails ? { formatToolDetails: partial.formatToolDetails } : {},
+    ...partial.formatToolResultOutput ? { formatToolResultOutput: partial.formatToolResultOutput } : {},
+    formatToolError: partial.formatToolError ?? DEFAULT_OPTIONS.formatToolError,
+    formatReasoningUpdate: partial.formatReasoningUpdate ?? DEFAULT_OPTIONS.formatReasoningUpdate,
+    formatMessageText: partial.formatMessageText ?? DEFAULT_OPTIONS.formatMessageText,
+    streamingMode: partial.streamingMode ?? DEFAULT_OPTIONS.streamingMode,
+    progressiveUpdateThreshold: partial.progressiveUpdateThreshold ?? DEFAULT_OPTIONS.progressiveUpdateThreshold,
+    progressiveUpdateIntervalMs: partial.progressiveUpdateIntervalMs ?? DEFAULT_OPTIONS.progressiveUpdateIntervalMs,
+    chatStreamBufferSize: partial.chatStreamBufferSize ?? DEFAULT_OPTIONS.chatStreamBufferSize,
+    maxTaskUpdates: resolveNonNegativeInteger(
+      partial.maxTaskUpdates,
+      DEFAULT_OPTIONS.maxTaskUpdates
+    ),
+    maxTaskUpdateTextChars: resolveNonNegativeInteger(
+      partial.maxTaskUpdateTextChars,
+      DEFAULT_OPTIONS.maxTaskUpdateTextChars
+    ),
+    maxTaskUpdateFieldChars: resolveNonNegativeInteger(
+      partial.maxTaskUpdateFieldChars,
+      DEFAULT_OPTIONS.maxTaskUpdateFieldChars
+    ),
+    interactiveMode: partial.interactiveMode ?? DEFAULT_OPTIONS.interactiveMode,
+    ...partial.handleInteractiveRequest ? { handleInteractiveRequest: partial.handleInteractiveRequest } : {},
+    formatApprovalRequired: partial.formatApprovalRequired ?? DEFAULT_OPTIONS.formatApprovalRequired,
+    formatHumanInputRequired: partial.formatHumanInputRequired ?? DEFAULT_OPTIONS.formatHumanInputRequired,
+    ...partial.onStatusChange ? { onStatusChange: partial.onStatusChange } : {},
+    ...partial.chatStreamFinalArgs ? { chatStreamFinalArgs: partial.chatStreamFinalArgs } : {},
+    ...partial.publishFinalResponseArtifact ? { publishFinalResponseArtifact: partial.publishFinalResponseArtifact } : {},
+    finalResponseArtifactMode: partial.finalResponseArtifactMode ?? DEFAULT_OPTIONS.finalResponseArtifactMode,
+    finalResponseArtifactStreamThreshold: resolvePositiveInteger(
+      partial.finalResponseArtifactStreamThreshold,
+      DEFAULT_OPTIONS.finalResponseArtifactStreamThreshold ?? 4e3
+    ),
+    formatFinalResponseArtifactContinuationNotice: partial.formatFinalResponseArtifactContinuationNotice ?? DEFAULT_OPTIONS.formatFinalResponseArtifactContinuationNotice,
+    formatFinalResponseArtifactMessage: partial.formatFinalResponseArtifactMessage ?? DEFAULT_OPTIONS.formatFinalResponseArtifactMessage,
+    ...partial.onFinalResponseArtifactError ? { onFinalResponseArtifactError: partial.onFinalResponseArtifactError } : {}
+  };
+}
+function resolveNonNegativeInteger(value, fallback) {
+  if (value === void 0) {
+    return fallback;
+  }
+  if (!Number.isFinite(value) || value < 0) {
+    return fallback;
+  }
+  return Math.floor(value);
+}
+function resolvePositiveInteger(value, fallback) {
+  if (value === void 0) {
+    return fallback;
+  }
+  if (!Number.isFinite(value) || value < 1) {
+    return fallback;
+  }
+  return Math.floor(value);
+}
+
+// src/shared/event-bridge/interactive.ts
+var UnsupportedSlackInteractiveRequestError = class extends Error {
+  kind;
+  requestId;
+  constructor(kind, requestId, message) {
+    super(message);
+    this.name = "UnsupportedSlackInteractiveRequestError";
+    this.kind = kind;
+    this.requestId = requestId;
+  }
+};
+
+export {
+  mapAgentEventToSlackTurnEvent,
+  mapAgentSlackEventBridgeOptionsToRuntimeOptions,
+  bridgeAgentEventsToSlack,
+  resolveSlackEventBridgeOptions,
+  UnsupportedSlackInteractiveRequestError
+};