@cuylabs/channel-slack-agent-core 0.9.0 → 0.11.0

package/dist/types-BeGPexio.d.ts

@@ -1,381 +0,0 @@
-import { Agent, AgentTurnSource, AgentEvent, ApprovalEvent, Logger } from '@cuylabs/agent-core';
-import { SlackActivityInfo, SlackTurnRequestContext, SlackAssistantStatusUpdate, SlackChatStreamStartArgs, SlackUserIdentity, SlackTurnPreparation } from '@cuylabs/channel-slack/core';
-import { S as SlackEventBridgeOptions } from './options-CGUfVStV.js';
-import { f as SlackInteractiveRequestHandler } from './interactive-BigrPKnu.js';
-
-/**
- * Channel-options + adapter contract for the direct Slack adapter
- * (`createSlackChannelAdapter`).
- */
-
-type HumanInputEvent = Extract<AgentEvent, {
-    type: "human-input-request";
-}>["request"];
-type SlackToolStartEvent = Extract<AgentEvent, {
-    type: "tool-start";
-}>;
-type SlackToolResultEvent = Extract<AgentEvent, {
-    type: "tool-result";
-}>;
-type MaybePromise<T> = T | Promise<T>;
-/**
- * Session mapping strategy.
- *
- * - `"thread-aware"` *(default)* — Uses the Slack thread_ts as session ID
- *   when the message is inside a thread; falls back to the channel ID for
- *   DMs and top-level channel messages. Produces the most natural grouping.
- *
- * - `"channel-id"` — Uses the Slack channel / DM ID directly. Every
- *   message in the same channel/DM shares one session.
- *
- * - `"user-per-channel"` — Uses `${channelId}:${userId}`. Each user gets
- *   an isolated session per channel/DM. Useful for private-context bots.
- *
- * - `"user-per-thread"` — Uses `${channelId}:${threadTs}:${userId}` for
- *   threaded/channel messages and `${channelId}:${userId}` in DMs.
- *
- * - `"custom"` — Provide your own mapping via `resolveSessionId`.
- */
-type SlackSessionStrategy = "thread-aware" | "channel-id" | "user-per-channel" | "user-per-thread" | "custom";
-/**
- * Controls how the bot posts responses to Slack.
- *
- * - `"progressive"` *(default)* — Posts a placeholder message immediately,
- *   then updates it as the agent emits text. Gives a typing-like experience.
- *   Uses `chat.update` for mid-stream updates.
- *
- * - `"accumulate"` — Waits for the full response before posting. Simpler,
- *   uses one API call, but the user sees nothing until the agent finishes.
- *
- * - `"chat-stream"` — Uses Slack's native `chat.startStream`,
- *   `chat.appendStream`, and `chat.stopStream` APIs through
- *   `WebClient.chatStream`. This is the Slack-native streaming path.
- */
-type SlackStreamingMode = "progressive" | "accumulate" | "chat-stream";
-/**
- * Configuration for the Slack channel adapter.
- */
-interface SlackChannelOptions {
-    /**
-     * The agent-core Agent instance to bridge.
-     *
-     * Use `source` instead when you want to bridge a runtime/server-backed chat
-     * adapter that is not a direct `Agent` instance.
-     */
-    agent?: Agent;
-    /**
-     * Generic chat turn source understood by this package.
-     *
-     * Exactly one of `agent` or `source` must be provided.
-     */
-    source?: AgentTurnSource;
-    /**
-     * How to map Slack conversations to agent-core session IDs.
-     * @default "thread-aware"
-     */
-    sessionStrategy?: SlackSessionStrategy;
-    /**
-     * Custom session ID resolver. Required when `sessionStrategy` is `"custom"`.
-     */
-    resolveSessionId?: (info: SlackActivityInfo) => string | Promise<string>;
-    /**
-     * Optional full-request session resolver. Returning `undefined` falls back
-     * to `sessionStrategy` / `resolveSessionId`.
-     *
-     * Prefer this over `resolveSessionId` when session routing needs auth,
-     * prepared text, or other request metadata.
-     */
-    resolveSession?: (request: SlackTurnRequestContext) => string | undefined | Promise<string | undefined>;
-    /**
-     * Surface reasoning events as status updates in Slack.
-     * @default false
-     */
-    showReasoning?: boolean;
-    /**
-     * Surface tool usage as status updates (e.g. "Using tool: search...").
-     * This controls root-agent tool rows. Subagent child tool rows are controlled
-     * separately by `showSubagentToolUsage`.
-     * @default true
-     */
-    showToolUsage?: boolean;
-    /**
-     * Surface subagent child tool activity as Slack task rows. Disabled by
-     * default so delegated workers do not flood the parent turn timeline.
-     * Subagent start/complete/error lifecycle rows still render when
-     * `showToolUsage` is enabled.
-     * @default false
-     */
-    showSubagentToolUsage?: boolean;
-    /**
-     * Include the completed subagent output body in the subagent task row.
-     * Disabled by default because full child results should flow through
-     * `get_agent_results` and the root final answer, not the task timeline.
-     * @default false
-     */
-    showSubagentResultInTask?: boolean;
-    /**
-     * Format the tool-start status text.
-     * @default (toolName) => `🔍 Using tool: ${toolName}...`
-     */
-    formatToolUpdate?: (toolName: string) => string;
-    /**
-     * Format the title shown in Slack task cards for tool activity.
-     * @default (toolName) => toolName
-     */
-    formatToolTitle?: (toolName: string) => string;
-    /**
-     * Format task-card details for a tool-start event. Use this to show safe,
-     * redacted tool arguments in Slack's task UI.
-     * @default details use the tool-start status text
-     */
-    formatToolDetails?: (event: SlackToolStartEvent) => string | undefined;
-    /**
-     * Format completed tool output shown in Slack task cards.
-     *
-     * Return `undefined` to use the default generic formatter. Return `null` to
-     * intentionally omit output for this result.
-     */
-    formatToolResultOutput?: (event: SlackToolResultEvent) => string | null | undefined;
-    /**
-     * Format the tool-error status text.
-     * @default (toolName) => `⚠️ Tool ${toolName} encountered an error`
-     */
-    formatToolError?: (toolName: string, error: string) => string;
-    /**
-     * Format the reasoning status text.
-     * @default () => "Thinking..."
-     */
-    formatReasoningUpdate?: () => string;
-    /**
-     * Initial Slack thread status set before `prepareTurn` and `source.chat()`
-     * run, when Bolt provides `setStatus` for the classic message/app_mention
-     * listener. Use an object with `loading_messages` to enable Slack's rotating
-     * loading text.
-     *
-     * Return `undefined` from a function resolver to skip the initial status for
-     * a specific turn.
-     *
-     * @default { status: "Thinking..." }
-     */
-    initialStatus?: SlackAssistantStatusUpdate | ((request: SlackTurnRequestContext) => MaybePromise<SlackAssistantStatusUpdate | undefined>);
-    /**
-     * How to handle approval / human-input requests that Slack cannot satisfy
-     * in-channel. When `handleInteractiveRequest` is configured, the handler is
-     * tried first; this fallback is only used when the handler declines.
-     * @default "message-and-error"
-     */
-    interactiveMode?: "message-and-error" | "ignore";
-    /**
-     * Slack-native renderer/resolver hook for approval and human-input requests.
-     *
-     * The adapter provides the current Slack activity, resolved session, user,
-     * and a responder that can post/update Block Kit messages in the originating
-     * thread. Return `true` after rendering/recording the request to keep the
-     * agent turn alive while the request is resolved out-of-band.
-     */
-    handleInteractiveRequest?: SlackInteractiveRequestHandler;
-    /**
-     * Format the fallback message shown when tool approval is required.
-     */
-    formatApprovalRequired?: (request: ApprovalEvent) => string;
-    /**
-     * Format the fallback message shown when human input is required.
-     */
-    formatHumanInputRequired?: (request: HumanInputEvent) => string;
-    /**
-     * How the bot posts responses.
-     * @default "progressive"
-     */
-    streamingMode?: SlackStreamingMode;
-    /**
-     * Minimum number of accumulated characters before issuing a `chat.update`
-     * in progressive mode.
-     * @default 150
-     */
-    progressiveUpdateThreshold?: number;
-    /**
-     * Minimum time between `chat.update` calls in progressive mode.
-     *
-     * Slack recommends waiting at least 3 seconds between updates to longer
-     * messages. Set to `0` to disable time throttling.
-     *
-     * @default 3000
-     */
-    progressiveUpdateIntervalMs?: number;
-    /**
-     * Buffer size passed to Slack's `WebClient.chatStream` helper when
-     * `streamingMode` is `"chat-stream"`.
-     * @default 256
-     */
-    chatStreamBufferSize?: number;
-    /**
-     * Maximum number of Slack task-update chunks the bridge will append to a
-     * single chat stream. Task rows are a bounded UI projection, not a durable
-     * event log.
-     *
-     * @default 200
-     */
-    maxTaskUpdates?: number;
-    /**
-     * Maximum cumulative characters from task titles/details/output that the
-     * bridge will append to one chat stream.
-     *
-     * @default 20000
-     */
-    maxTaskUpdateTextChars?: number;
-    /**
-     * Maximum characters for a single task details/output field.
-     *
-     * @default 500
-     */
-    maxTaskUpdateFieldChars?: number;
-    /**
-     * Start arguments merged into Slack's native chat stream when
-     * `streamingMode` is `"chat-stream"`; useful for Slack-supported authorship
-     * fields such as `icon_emoji`, `icon_url`, and `username`.
-     *
-     * The adapter still owns `channel`, `thread_ts`, recipient ids, and
-     * `buffer_size`.
-     */
-    chatStreamStartArgs?: SlackChatStreamStartArgs;
-    /**
-     * Final arguments merged into `chatStream.stop(...)` when
-     * `streamingMode` is `"chat-stream"`; useful for final blocks such as a
-     * feedback widget.
-     */
-    chatStreamFinalArgs?: {
-        blocks?: unknown[];
-    } & Record<string, unknown>;
-    /**
-     * 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"];
-    /**
-     * Convert common markdown constructs emitted by models into Slack mrkdwn.
-     *
-     * @default true
-     */
-    formatChatMarkdown?: boolean;
-    /**
-     * Custom response text formatter. When provided, this takes precedence over
-     * the built-in markdown-to-mrkdwn conversion.
-     */
-    formatMessageText?: (text: string) => string;
-    /**
-     * Maximum time (ms) to wait for the agent before aborting.
-     * @default 120_000
-     */
-    timeout?: number;
-    /**
-     * When `true` (default), replies to channel messages are posted inside the
-     * originating thread. When `false`, replies are posted at channel level.
-     * Has no effect in DMs.
-     * @default true
-     */
-    respondInThread?: boolean;
-    /**
-     * Welcome message sent when the bot is added to a channel or DM.
-     * Set to `null` to disable.
-     */
-    welcomeMessage?: string | null;
-    /**
-     * When `true` (default), `app.event('app_mention')` is registered so the
-     * bot responds to `@mentions` in channels.
-     * @default true
-     */
-    respondToMentions?: boolean;
-    /**
-     * When `true` (default), `app.message()` is registered so the bot
-     * can respond to direct messages and, when enabled, plain channel messages.
-     *
-     * Set to `false` if you only want @mention-triggered responses.
-     * @default true
-     */
-    respondToMessages?: boolean;
-    /**
-     * When `true`, plain channel/group/thread messages from `app.message()` are
-     * forwarded into the agent. Direct messages still work through
-     * `respondToMessages`.
-     *
-     * Keep this disabled unless your Slack app intentionally listens to every
-     * visible channel message. @mentions are handled separately by
-     * `respondToMentions`.
-     * @default false
-     */
-    respondToChannelMessages?: boolean;
-    /**
-     * Resolve additional context to inject into the agent call.
-     *
-     * Use this to customize the system prompt per user, inject Slack identity,
-     * etc. Called before `source.chat()` on every message.
-     */
-    resolveUserContext?: (user: SlackUserIdentity) => {
-        system?: string;
-    } | Promise<{
-        system?: string;
-    }>;
-    /**
-     * Prepare an agent turn from the full Slack request context.
-     *
-     * Prefer this over `resolveUserContext` when you need structured ambient
-     * context for tools/middleware or custom scope attributes.
-     */
-    prepareTurn?: (request: SlackTurnRequestContext) => SlackTurnPreparation | Promise<SlackTurnPreparation>;
-    /**
-     * Resolve the text message forwarded to `source.chat()`.
-     *
-     * Useful when the message text needs normalisation beyond mention-stripping.
-     * Return `undefined` to skip processing this message.
-     */
-    resolveMessage?: (info: SlackActivityInfo) => string | undefined | Promise<string | undefined>;
-    /**
-     * Called on unhandled errors during turn processing.
-     */
-    onError?: (error: Error, info: SlackActivityInfo) => void | Promise<void>;
-    /**
-     * Optional diagnostics logger. Used for best-effort status/update failures
-     * and classic turn utility visibility.
-     */
-    logger?: Logger;
-}
-/**
- * Slack channel adapter returned by `createSlackChannelAdapter`.
- */
-interface SlackChannelAdapter {
-    /**
-     * Register all message/event handlers on a Bolt `App`.
-     *
-     * ```ts
-     * const adapter = createSlackChannelAdapter({ agent });
-     * adapter.mount(boltApp);
-     * ```
-     */
-    mount(app: {
-        message: (...args: any[]) => unknown;
-        event: (...args: any[]) => unknown;
-    }): void;
-    /** Resolve or look up the session ID for a given Slack activity. */
-    getSessionId(info: SlackActivityInfo): string | Promise<string>;
-}
-
-export type { SlackChannelAdapter as S, SlackChannelOptions as a, SlackSessionStrategy as b, SlackStreamingMode as c, SlackToolStartEvent as d };

package/dist/types-Bz4OYEAV.d.ts

@@ -1,87 +0,0 @@
-import { ApprovalRequest, ApprovalResolution, HumanInputRequest, HumanInputResponse, ApprovalAction, ApprovalRememberScope } from '@cuylabs/agent-core';
-import { SlackInteractiveActionIds, SlackInteractiveRequestStore, SlackInteractiveRequestRecord, SlackInteractiveActor, SlackInteractiveHumanInputRequest as SlackInteractiveHumanInputRequest$1, SlackInteractiveMessageRef } from '@cuylabs/channel-slack/interactive';
-import { App } from '@slack/bolt';
-import { e as SlackInteractiveRequestContext } from './interactive-BigrPKnu.js';
-
-type SlackInteractiveApprovalRequest = ApprovalRequest;
-type SlackInteractiveHumanInputRequest = SlackInteractiveHumanInputRequest$1 & Partial<Pick<HumanInputRequest, "sessionId" | "timestamp" | "toolCallId">>;
-type SlackInteractiveResolution = {
-    kind: "approval";
-    action: ApprovalAction;
-    feedback?: string;
-    rememberScope?: ApprovalRememberScope;
-} | {
-    kind: "human-input";
-    response: HumanInputResponse;
-};
-interface SlackInteractiveRequestWaitOptions {
-    /**
-     * Abort waiting for this request. The controller removes its local waiter and
-     * deletes the pending store record when the signal fires.
-     */
-    signal?: AbortSignal;
-    /**
-     * Override the controller-level request timeout for this request. Use `0` to
-     * disable timeout cleanup for this request.
-     */
-    timeoutMs?: number;
-}
-interface SlackInteractiveControllerOptions {
-    store?: SlackInteractiveRequestStore;
-    /**
-     * Stable namespace for default Slack action IDs. Use this when installing
-     * multiple interactive controllers in the same Slack app.
-     *
-     * @default "agent_slack"
-     */
-    namespace?: string;
-    actionIds?: Partial<SlackInteractiveActionIds>;
-    /**
-     * Default timeout for local waiters and pending store records. This should
-     * usually match the agent-core approval/human-input timeout.
-     *
-     * @default 300000
-     */
-    requestTimeoutMs?: number;
-    /**
-     * Called on every successful Slack resolution after the local waiter, if
-     * present, is resolved. Use this to fan out decisions to agent-server or
-     * another runtime that owns the turn.
-     */
-    onResolve?: (requestId: string, resolution: SlackInteractiveResolution) => void | Promise<void>;
-    /**
-     * Authorization hook for approving/responding to pending requests.
-     *
-     * Defaults to the original Slack requester only. Return `true` for delegated
-     * approvers, channel owners, or admin policy checks.
-     */
-    authorize?: (record: SlackInteractiveRequestRecord, actor: SlackInteractiveActor) => boolean | Promise<boolean>;
-}
-interface SlackInteractiveController {
-    readonly actionIds: SlackInteractiveActionIds;
-    readonly store: SlackInteractiveRequestStore;
-    approval: {
-        onRequest(request: ApprovalRequest, options?: SlackInteractiveRequestWaitOptions): Promise<ApprovalResolution>;
-    };
-    humanInput: {
-        onRequest(request: HumanInputRequest, options?: SlackInteractiveRequestWaitOptions): Promise<HumanInputResponse>;
-    };
-    /** Reject one pending in-process waiter and delete its pending store record. */
-    cancel(requestId: string, reason?: string): Promise<boolean>;
-    /** Shutdown helper: cancel every pending request created by this controller. */
-    cancelAll(reason?: string): Promise<void>;
-    handleInteractiveRequest(context: SlackInteractiveRequestContext): Promise<boolean>;
-    install(app: App): void;
-}
-type SlackInteractivePendingWaiter = {
-    resolve: (resolution: SlackInteractiveResolution) => void;
-    reject: (error: Error) => void;
-    cleanup: () => void;
-};
-interface SlackInteractivePostedMessage {
-    text: string;
-    blocks: unknown[];
-    ref: SlackInteractiveMessageRef;
-}
-
-export type { SlackInteractiveApprovalRequest as S, SlackInteractiveController as a, SlackInteractiveControllerOptions as b, SlackInteractiveHumanInputRequest as c, SlackInteractivePendingWaiter as d, SlackInteractivePostedMessage as e, SlackInteractiveRequestWaitOptions as f, SlackInteractiveResolution as g };

package/dist/types-CiwGU6zC.d.ts

@@ -1,56 +0,0 @@
-import { App } from '@slack/bolt';
-import { SlackViewPayload, RegisterSlackViewWorkflowOptions, SlackViewWorkflowContext, SlackViewSubmissionAckResponse } from '@cuylabs/channel-slack/views';
-
-type SlackAgentViewStateValue = string | string[] | boolean | number | Record<string, unknown> | undefined;
-type SlackAgentViewStateValues = Record<string, Record<string, SlackAgentViewStateValue>>;
-declare function extractSlackAgentViewStateValues(viewOrState: SlackViewPayload | unknown): SlackAgentViewStateValues;
-declare function readSlackAgentViewStateValue(valuesOrView: SlackAgentViewStateValues | SlackViewPayload | unknown, blockId: string, actionId: string): SlackAgentViewStateValue;
-
-interface SlackAgentViewWorkflow {
-    id: string;
-    callbackId: string;
-}
-interface SlackAgentViewWorkflowContext<TMetadata = unknown> extends SlackViewWorkflowContext<TMetadata> {
-    workflow: SlackAgentViewWorkflow;
-    stateValues: SlackAgentViewStateValues;
-    getStateValue(blockId: string, actionId: string): SlackAgentViewStateValue;
-}
-interface SlackAgentViewWorkflowDefinition<TMetadata = unknown> {
-    /**
-     * Stable product/agent workflow id. Used to derive the default Slack
-     * callback id as `${namespace}_${id}`.
-     */
-    id: string;
-    /**
-     * Explicit Slack view callback id. Prefer this only when integrating with an
-     * existing Slack app surface.
-     */
-    callbackId?: string;
-    decodePrivateMetadata?: RegisterSlackViewWorkflowOptions<TMetadata>["decodePrivateMetadata"];
-    onSubmission?: (context: SlackAgentViewWorkflowContext<TMetadata>) => SlackViewSubmissionAckResponse | void | Promise<SlackViewSubmissionAckResponse | void>;
-    onClose?: (context: SlackAgentViewWorkflowContext<TMetadata>) => void | Promise<void>;
-    onError?: (error: unknown, context: Omit<SlackAgentViewWorkflowContext<TMetadata>, "metadata"> & {
-        metadata?: TMetadata | undefined;
-    }) => void | Promise<void>;
-}
-interface CreateSlackAgentViewWorkflowControllerOptions {
-    /**
-     * Namespace for derived Slack callback ids.
-     *
-     * @default "agent_slack_view"
-     */
-    namespace?: string;
-    workflows?: readonly SlackAgentViewWorkflowDefinition[];
-    onError?: (error: unknown, context: Omit<SlackAgentViewWorkflowContext, "metadata"> & {
-        metadata?: unknown;
-    }) => void | Promise<void>;
-}
-interface SlackAgentViewWorkflowController {
-    readonly namespace: string;
-    register<TMetadata = unknown>(workflow: SlackAgentViewWorkflowDefinition<TMetadata>): string;
-    callbackIdFor(workflowId: string): string;
-    list(): SlackAgentViewWorkflow[];
-    install(app: App): void;
-}
-
-export { type CreateSlackAgentViewWorkflowControllerOptions as C, type SlackAgentViewStateValue as S, type SlackAgentViewStateValues as a, type SlackAgentViewWorkflow as b, type SlackAgentViewWorkflowContext as c, type SlackAgentViewWorkflowController as d, type SlackAgentViewWorkflowDefinition as e, extractSlackAgentViewStateValues as f, readSlackAgentViewStateValue as r };

package/dist/views/index.d.ts

@@ -1,8 +0,0 @@
-import { C as CreateSlackAgentViewWorkflowControllerOptions, d as SlackAgentViewWorkflowController } from '../types-CiwGU6zC.js';
-export { S as SlackAgentViewStateValue, a as SlackAgentViewStateValues, b as SlackAgentViewWorkflow, c as SlackAgentViewWorkflowContext, e as SlackAgentViewWorkflowDefinition, f as extractSlackAgentViewStateValues, r as readSlackAgentViewStateValue } from '../types-CiwGU6zC.js';
-import '@slack/bolt';
-import '@cuylabs/channel-slack/views';
-
-declare function createSlackAgentViewWorkflowController({ namespace, workflows, onError, }?: CreateSlackAgentViewWorkflowControllerOptions): SlackAgentViewWorkflowController;
-
-export { CreateSlackAgentViewWorkflowControllerOptions, SlackAgentViewWorkflowController, createSlackAgentViewWorkflowController };

package/dist/views/index.js

@@ -1,10 +0,0 @@
-import {
-  createSlackAgentViewWorkflowController,
-  extractSlackAgentViewStateValues,
-  readSlackAgentViewStateValue
-} from "../chunk-C7CHMYV6.js";
-export {
-  createSlackAgentViewWorkflowController,
-  extractSlackAgentViewStateValues,
-  readSlackAgentViewStateValue
-};

package/docs/concepts/view-workflows.md

@@ -1,52 +0,0 @@
-# View Workflows
-
-Agent view workflows connect Slack modal submissions to agent or product logic.
-They sit above `@cuylabs/channel-slack/views`: the lower package owns Slack Web
-API/Bolt mechanics, while this package adds namespaced callback ids, decoded
-metadata, submitted state values, and app-surface mounting.
-
-```typescript
-import {
-  encodeSlackViewPrivateMetadata,
-  openSlackModal,
-} from "@cuylabs/channel-slack/views";
-import { createSlackAgentViewWorkflowController } from "@cuylabs/channel-slack-agent-core/views";
-
-const viewWorkflows = createSlackAgentViewWorkflowController({
-  namespace: "cdo",
-  workflows: [
-    {
-      id: "incident_triage",
-      onSubmission: async ({ metadata, stateValues, getStateValue, actor }) => {
-        const severity = getStateValue("severity", "value");
-        // Load product-owned workflow state by metadata.workflowId, validate the
-        // submitted values, then continue an agent turn or product workflow.
-        return { response_action: "clear" };
-      },
-    },
-  ],
-});
-
-await openSlackModal({
-  client,
-  triggerId,
-  view: {
-    type: "modal",
-    callback_id: viewWorkflows.callbackIdFor("incident_triage"),
-    private_metadata: encodeSlackViewPrivateMetadata({
-      workflowId: "triage-123",
-    }),
-    title: { type: "plain_text", text: "Triage incident" },
-    submit: { type: "plain_text", text: "Continue" },
-    blocks: [],
-  },
-});
-```
-
-Pass the controller to `mountSlackAgentApp` / `installSlackAgentAppSurface` as
-`viewWorkflows`. The controller installs `view_submission` and `view_closed`
-handlers on the underlying Bolt app.
-
-Keep `private_metadata` compact. Store durable workflow state in an application
-database or existing request store and put only routing keys, such as
-`workflowId`, `requestId`, or `sessionId`, into the modal.