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

package/README.md

@@ -1,15 +1,14 @@
 # @cuylabs/channel-slack-agent-core
 
-Slack adapter for `@cuylabs/agent-core`, built on `@cuylabs/channel-slack`
-primitives.
+Slack adapter for `@cuylabs/agent-core`, built on
+`@cuylabs/channel-slack`.
 
-Use this package when your agent runtime is `@cuylabs/agent-core` and you want
-ready-to-mount Slack surfaces for Bolt, Express, Socket Mode, Slack Assistant,
-classic app mentions, DMs, and in-channel interactive approval or human-input
-requests.
+Use this package when an Agent Core application needs ready-to-mount Slack
+surfaces for Express Events API, Socket Mode, Slack Assistant, app mentions,
+DMs, feedback, approvals, or human input.
 
-Use `@cuylabs/channel-slack` directly when you want Slack parsing, policy,
-history, setup, auth, or formatting primitives for another agent runtime.
+Generic Slack mechanics such as parsing, policy, history, setup, auth, targets,
+users, entrypoints, artifacts, and transports live in `@cuylabs/channel-slack`.
 
 ## Install
 
@@ -23,29 +22,13 @@ Install Slack peer dependencies for the surfaces you use:
 npm install @slack/bolt @slack/web-api express
 ```
 
-## Import Map
+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.
 
-Use feature-specific imports when you only need one adapter surface.
+## Quick Start
 
-| Import | Use for |
-| --- | --- |
-| `@cuylabs/channel-slack-agent-core/adapter` | Classic app mention, DM, and passive channel-message adapter |
-| `@cuylabs/channel-slack-agent-core/assistant` | Slack Assistant bridge and lifecycle handlers |
-| `@cuylabs/channel-slack-agent-core/express` | Express Events API mounting for classic Slack surfaces |
-| `@cuylabs/channel-slack-agent-core/express-assistant` | Express Events API mounting for Slack Assistant |
-| `@cuylabs/channel-slack-agent-core/socket` | Socket Mode mounting helpers |
-| `@cuylabs/channel-slack-agent-core/interactive` | Agent-core approval and human-input binding for Slack |
-| `@cuylabs/channel-slack-agent-core/shared` | Agent-core context fragments and event bridge plus Slack core primitives |
-| `@cuylabs/channel-slack-agent-core/bolt` | Re-exported Bolt helpers from `@cuylabs/channel-slack/bolt` |
-| `@cuylabs/channel-slack-agent-core/history` | Re-exported history helpers from `@cuylabs/channel-slack/history` |
-| `@cuylabs/channel-slack-agent-core/policy` | Re-exported message policy helpers from `@cuylabs/channel-slack/policy` |
-
-The package root re-exports the full adapter surface for compatibility and
-convenience. Reusable Slack mechanics continue to live in
-`@cuylabs/channel-slack`; this package only adds the `@cuylabs/agent-core`
-binding.
-
-## Socket Mode
+Socket Mode:
 
 ```typescript
 import { mountSlackAssistantAgentSocket } from "@cuylabs/channel-slack-agent-core";
@@ -57,7 +40,7 @@ await mountSlackAssistantAgentSocket({
 });
 ```
 
-## Express Events API
+Express Events API:
 
 ```typescript
 import { mountSlackAgent } from "@cuylabs/channel-slack-agent-core";
@@ -68,13 +51,11 @@ await mountSlackAgent(agent, {
 });
 ```
 
-## Boundary
-
-This package owns only the `@cuylabs/agent-core` binding:
-
-- mapping Slack turns to `AgentTurnSource.chat(...)`
-- creating agent-core scopes and context fragments
-- converting `AgentEvent` streams to Slack messages or chat streams
-- handling agent-core approval and human-input requests in Slack
+## Documentation
 
-Reusable Slack mechanics live in `@cuylabs/channel-slack`.
+- [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.d.ts → adapter/index.d.ts}

@@ -1,10 +1,12 @@
-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';
-export { resolveThreadAwareSlackSessionId } from '@cuylabs/channel-slack/core';
 import '@cuylabs/agent-core';
-import './interactive-o_NZb-Xg.js';
+import '../options-BcDReOJv.js';
+import '../artifacts/index.js';
+import '@cuylabs/channel-slack/artifacts';
+import '../interactive-o_NZb-Xg.js';
 
 /**
  * Session mapping — Slack activity info to agent-core session IDs.

package/dist/adapter/index.js

@@ -0,0 +1,9 @@
+import {
+  createSlackChannelAdapter,
+  createSlackSessionMap
+} 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,12 +1,10 @@
 import {
   installSlackAgentAppSurface
-} from "./chunk-M64Z6TYL.js";
-import "./chunk-BFUPAJON.js";
-import "./chunk-VHGV66M7.js";
-import "./chunk-FDRQOG7Q.js";
-import "./chunk-GNXWTKQ6.js";
-import "./chunk-DHPD4XH5.js";
-import "./chunk-I2KLQ2HA.js";
+} from "./chunk-7DUO5BMW.js";
+import "./chunk-MGBNGG4D.js";
+import "./chunk-ELR6MQD7.js";
+import "./chunk-FQWFB54C.js";
+import "./chunk-TMADMHBN.js";
 export {
   installSlackAgentAppSurface
 };

package/dist/app.d.ts

@@ -1,18 +1,23 @@
 import { Server } from 'node:http';
 import { Application } from 'express';
 import { App, ExpressReceiver } from '@slack/bolt';
-import { CreateSlackBoltAppOptions, SlackDirectAuthOptions, SlackDirectAuthMode } from '@cuylabs/channel-slack/bolt';
+import { CreateSlackBoltAppOptions } from '@cuylabs/channel-slack/transports/http';
+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,14 +1,11 @@
 import {
   mountSlackAgentApp
-} from "./chunk-CYEBGC6G.js";
-import "./chunk-M64Z6TYL.js";
-import "./chunk-BFUPAJON.js";
-import "./chunk-VHGV66M7.js";
-import "./chunk-FDRQOG7Q.js";
-import "./chunk-GNXWTKQ6.js";
-import "./chunk-DHPD4XH5.js";
-import "./chunk-ANIZ5NT4.js";
-import "./chunk-I2KLQ2HA.js";
+} from "./chunk-76SRS54H.js";
+import "./chunk-7DUO5BMW.js";
+import "./chunk-MGBNGG4D.js";
+import "./chunk-ELR6MQD7.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.d.ts → 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 '../interactive-o_NZb-Xg.js';
+import '../options-BcDReOJv.js';
+import '../artifacts/index.js';
+import '@cuylabs/channel-slack/artifacts';
 import '@cuylabs/channel-slack/feedback';
 
 /**

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

@@ -3,11 +3,9 @@ import {
   createSlackAssistantThreadContextStore,
   parseSlackMessageActivityFromMessageEvent,
   resolveAssistantSessionId
-} from "./chunk-BFUPAJON.js";
-import "./chunk-VHGV66M7.js";
-import "./chunk-GNXWTKQ6.js";
-import "./chunk-DHPD4XH5.js";
-import "./chunk-I2KLQ2HA.js";
+} from "../chunk-MGBNGG4D.js";
+import "../chunk-ELR6MQD7.js";
+import "../chunk-TMADMHBN.js";
 export {
   createSlackAssistantBridge,
   createSlackAssistantThreadContextStore,

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

@@ -1,11 +1,11 @@
 import {
   installSlackAgentAppSurface
-} from "./chunk-M64Z6TYL.js";
-import {
-  bolt_exports
-} from "./chunk-ANIZ5NT4.js";
+} from "./chunk-7DUO5BMW.js";
 
 // src/app.ts
+import {
+  createSlackBoltApp
+} from "@cuylabs/channel-slack/transports/http";
 async function mountSlackAgentApp(options) {
   const {
     botToken,
@@ -27,7 +27,7 @@ async function mountSlackAgentApp(options) {
     app: expressApp,
     authMode,
     routePath
-  } = await (0, bolt_exports.createSlackBoltApp)({
+  } = await createSlackBoltApp({
     signingSecret,
     path,
     botToken,

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

@@ -1,12 +1,13 @@
 import {
   createSlackAssistantBridge
-} from "./chunk-BFUPAJON.js";
+} from "./chunk-MGBNGG4D.js";
 import {
-  feedback_exports
-} from "./chunk-VHGV66M7.js";
+  createSlackFeedbackBlock,
+  registerSlackFeedbackAction
+} from "./chunk-ELR6MQD7.js";
 import {
   createSlackChannelAdapter
-} from "./chunk-FDRQOG7Q.js";
+} from "./chunk-FQWFB54C.js";
 
 // src/app-surface.ts
 var DEFAULT_TIMEOUT_MS = 12e4;
@@ -25,11 +26,12 @@ function installSlackAgentAppSurface(boltApp, options) {
     prepareTurn,
     resolveSession,
     interactive,
+    viewWorkflows,
     ...assistantBridgeOptions
   } = options;
   const feedbackConfig = feedbackOption === false ? void 0 : feedbackOption ?? (onFeedback ? { onFeedback } : {});
   const assistantFeedback = feedbackOption === false ? false : feedbackConfig;
-  const feedbackBlock = feedbackConfig ? (0, feedback_exports.createSlackFeedbackBlock)(feedbackConfig) : void 0;
+  const feedbackBlock = feedbackConfig ? createSlackFeedbackBlock(feedbackConfig) : void 0;
   const formatStreamError = assistantBridgeOptions.formatStreamError ?? (() => DEFAULT_STREAM_ERROR_MESSAGE);
   const formatting = assistantBridgeOptions.formatChatMarkdown;
   const channelSource = createErrorTranslatingSource(source, formatStreamError);
@@ -62,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,
@@ -69,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 } : {},
@@ -92,7 +101,7 @@ function installSlackAgentAppSurface(boltApp, options) {
   channelAdapter.mount(boltApp);
   if (feedbackConfig) {
     const feedbackSessionStrategy = assistantBridgeOptions.sessionStrategy ?? "thread-aware";
-    (0, feedback_exports.registerSlackFeedbackAction)(boltApp, {
+    registerSlackFeedbackAction(boltApp, {
       ...feedbackConfig,
       resolveSessionId: (ctx) => resolveFeedbackSessionId(ctx, feedbackSessionStrategy),
       onFeedback: feedbackConfig.onFeedback ?? (async (_ctx) => {
@@ -100,6 +109,7 @@ function installSlackAgentAppSurface(boltApp, options) {
     });
   }
   interactive?.install(boltApp);
+  viewWorkflows?.install(boltApp);
   return { bridge };
 }
 function mergeChatStreamFinalArgs(base, feedbackBlock) {

package/dist/{chunk-NIPAN4KA.js → chunk-A2PLAVW6.js}

@@ -1,8 +1,7 @@
+// src/shared/context-fragments.ts
 import {
   currentSlackTurnContext
-} from "./chunk-DHPD4XH5.js";
-
-// src/shared/context-fragments.ts
+} from "@cuylabs/channel-slack/core";
 var DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY = "slackContextFragment";
 function isRecord(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);

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
+};