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

package/dist/interactive/index.d.ts

@@ -1,71 +1,11 @@
-import { i as SlackInteractiveRequestRecord, k as SlackInteractiveRequestStore, b as SlackInteractiveApprovalRequest, S as SlackInteractiveActionIds, e as SlackInteractiveHumanInputRequest, m as SlackInteractiveResolution, d as SlackInteractiveControllerOptions, c as SlackInteractiveController } from '../types-Crpil4kb.js';
-export { a as SlackInteractiveActor, f as SlackInteractiveMessageTarget, g as SlackInteractivePendingWaiter, h as SlackInteractivePostedMessage, j as SlackInteractiveRequestStatus, l as SlackInteractiveRequestWaitOptions, n as SlackInteractiveStoredRequest } from '../types-Crpil4kb.js';
-import { View } from '@slack/types';
+import { b as SlackInteractiveControllerOptions, a as SlackInteractiveController } from '../types-Bz4OYEAV.js';
+export { S as SlackInteractiveApprovalRequest, c as SlackInteractiveHumanInputRequest, d as SlackInteractivePendingWaiter, e as SlackInteractivePostedMessage, f as SlackInteractiveRequestWaitOptions, g as SlackInteractiveResolution } from '../types-Bz4OYEAV.js';
 import '@cuylabs/agent-core';
+import '@cuylabs/channel-slack/interactive';
 import '@slack/bolt';
-import '../interactive-o_NZb-Xg.js';
+import '../interactive-BigrPKnu.js';
 import '@cuylabs/channel-slack/core';
 
-declare function createInMemorySlackInteractiveRequestStore(): SlackInteractiveRequestStore;
-declare function nowIso(): string;
-declare function cloneRecord(record: SlackInteractiveRequestRecord): SlackInteractiveRequestRecord;
-
-interface SlackInteractivePostgresClient {
-    end?: () => Promise<void>;
-    query<T = unknown>(sql: string, values?: readonly unknown[]): Promise<{
-        rows: T[];
-        rowCount?: number | null;
-    }>;
-}
-interface PostgresSlackInteractiveRequestStoreOptions {
-    client?: SlackInteractivePostgresClient;
-    connectionString?: string;
-    ensureSchema?: boolean;
-    onPruneError?: (error: unknown) => void;
-    pruneBatchSize?: number;
-    pruneIntervalMs?: number;
-    retentionMs?: number;
-    schema?: string;
-    tableName?: string;
-}
-interface PostgresSlackInteractiveRequestStore extends SlackInteractiveRequestStore {
-    close(): Promise<void>;
-    prune(): Promise<PostgresSlackInteractiveRequestPruneResult>;
-}
-interface PostgresSlackInteractiveRequestPruneResult {
-    deleted: number;
-}
-declare function createPostgresSlackInteractiveRequestStore({ client, connectionString, ensureSchema, onPruneError, pruneBatchSize, pruneIntervalMs, retentionMs, schema, tableName, }: PostgresSlackInteractiveRequestStoreOptions): PostgresSlackInteractiveRequestStore;
-declare function initializePostgresSlackInteractiveRequestStore({ client, ensureSchema, schema, tableName, }: {
-    client: SlackInteractivePostgresClient;
-    ensureSchema?: boolean;
-    schema?: string;
-    tableName?: string;
-}): Promise<void>;
-declare function prunePostgresSlackInteractiveRequestStore({ client, pruneBatchSize, retentionMs, schema, tableName, }: {
-    client: SlackInteractivePostgresClient;
-    pruneBatchSize?: number;
-    retentionMs?: number;
-    schema?: string;
-    tableName?: string;
-}): Promise<PostgresSlackInteractiveRequestPruneResult>;
-
-declare function buildApprovalRequestMessage(request: SlackInteractiveApprovalRequest, actionIds: SlackInteractiveActionIds): {
-    text: string;
-    blocks: unknown[];
-};
-declare function buildHumanInputRequestMessage(request: SlackInteractiveHumanInputRequest, actionIds: SlackInteractiveActionIds): {
-    text: string;
-    blocks: unknown[];
-};
-declare function buildResolvedMessage(label: string, resolution: SlackInteractiveResolution): {
-    text: string;
-    blocks: unknown[];
-};
-declare function buildHumanInputModal(request: SlackInteractiveHumanInputRequest, actionIds: SlackInteractiveActionIds): View;
-declare function encodeActionValue(payload: Record<string, unknown>): string;
-declare function decodeActionValue(value: unknown): Record<string, unknown>;
-
 declare function createSlackInteractiveController(options?: SlackInteractiveControllerOptions): SlackInteractiveController;
 
-export { type PostgresSlackInteractiveRequestPruneResult, type PostgresSlackInteractiveRequestStore, type PostgresSlackInteractiveRequestStoreOptions, SlackInteractiveActionIds, SlackInteractiveApprovalRequest, SlackInteractiveController, SlackInteractiveControllerOptions, SlackInteractiveHumanInputRequest, type SlackInteractivePostgresClient, SlackInteractiveRequestRecord, SlackInteractiveRequestStore, SlackInteractiveResolution, buildApprovalRequestMessage, buildHumanInputModal, buildHumanInputRequestMessage, buildResolvedMessage, cloneRecord, createInMemorySlackInteractiveRequestStore, createPostgresSlackInteractiveRequestStore, createSlackInteractiveController, decodeActionValue, encodeActionValue, initializePostgresSlackInteractiveRequestStore, nowIso, prunePostgresSlackInteractiveRequestStore };
+export { SlackInteractiveController, SlackInteractiveControllerOptions, createSlackInteractiveController };

package/dist/interactive/index.js

@@ -1,30 +1,6 @@
 import {
-  buildApprovalRequestMessage,
-  buildHumanInputModal,
-  buildHumanInputRequestMessage,
-  buildResolvedMessage,
-  cloneRecord,
-  createInMemorySlackInteractiveRequestStore,
-  createPostgresSlackInteractiveRequestStore,
-  createSlackInteractiveController,
-  decodeActionValue,
-  encodeActionValue,
-  initializePostgresSlackInteractiveRequestStore,
-  nowIso,
-  prunePostgresSlackInteractiveRequestStore
-} from "../chunk-X7ILLZZP.js";
+  createSlackInteractiveController
+} from "../chunk-OP27SSZU.js";
 export {
-  buildApprovalRequestMessage,
-  buildHumanInputModal,
-  buildHumanInputRequestMessage,
-  buildResolvedMessage,
-  cloneRecord,
-  createInMemorySlackInteractiveRequestStore,
-  createPostgresSlackInteractiveRequestStore,
-  createSlackInteractiveController,
-  decodeActionValue,
-  encodeActionValue,
-  initializePostgresSlackInteractiveRequestStore,
-  nowIso,
-  prunePostgresSlackInteractiveRequestStore
+  createSlackInteractiveController
 };

package/dist/interactive-BigrPKnu.d.ts

@@ -0,0 +1,30 @@
+import { AgentEvent } from '@cuylabs/agent-core';
+import { SlackInteractiveRequestBaseContext as SlackInteractiveRequestBaseContext$1, SlackInteractiveRequestContext as SlackInteractiveRequestContext$1 } from '@cuylabs/channel-slack/interactive';
+import { SlackActivityInfo, SlackUserIdentity } from '@cuylabs/channel-slack/core';
+
+/**
+ * Agent Core interactive request contracts for the Slack event bridge.
+ *
+ * Generic Slack message/responder primitives live in `@cuylabs/channel-slack`.
+ * This module narrows the request payloads to Agent Core events.
+ */
+
+type SlackApprovalRequest = Extract<AgentEvent, {
+    type: "approval-request";
+}>["request"];
+type SlackHumanInputRequest = Extract<AgentEvent, {
+    type: "human-input-request";
+}>["request"];
+type SlackInteractiveRequest = SlackApprovalRequest | SlackHumanInputRequest;
+interface SlackInteractiveRequestBaseContext extends Omit<SlackInteractiveRequestBaseContext$1, "request"> {
+    request: SlackInteractiveRequest;
+}
+interface SlackInteractiveRequestContext extends Omit<SlackInteractiveRequestContext$1, "request"> {
+    slackActivity: SlackActivityInfo;
+    user: SlackUserIdentity;
+    request: SlackInteractiveRequest;
+}
+type SlackInteractiveRequestHandler = (context: SlackInteractiveRequestContext) => boolean | void | Promise<boolean | void>;
+type SlackEventInteractiveRequestHandler = (context: SlackInteractiveRequestBaseContext) => boolean | void | Promise<boolean | void>;
+
+export type { SlackApprovalRequest as S, SlackEventInteractiveRequestHandler as a, SlackHumanInputRequest as b, SlackInteractiveRequest as c, SlackInteractiveRequestBaseContext as d, SlackInteractiveRequestContext as e, SlackInteractiveRequestHandler as f };

package/dist/{options-CdqBABcM.d.ts → options-ByNm2o89.d.ts}

@@ -2,11 +2,34 @@ import { AgentTurnSource, AgentEvent, Logger } from '@cuylabs/agent-core';
 import { AssistantUserMessageMiddleware, AssistantThreadStartedMiddleware, Assistant, App } from '@slack/bolt';
 import { WebClient } from '@slack/web-api';
 import { SlackAuthContext, SlackAssistantThreadContext, SlackAssistantUtilities, SlackTurnPreparation, SlackAssistantTaskDisplayMode, SlackAssistantStatusUpdate, SlackAssistantSuggestedPrompts, SlackChatStreamStartArgs, SlackMessageFormattingOptions } from '@cuylabs/channel-slack/core';
-import { h as SlackInteractiveRequestHandler } from './interactive-o_NZb-Xg.js';
-import { S as SlackEventBridgeOptions } from './options-BcDReOJv.js';
+import { f as SlackInteractiveRequestHandler } from './interactive-BigrPKnu.js';
+import { S as SlackEventBridgeOptions } from './options-CGUfVStV.js';
 import { SlackFeedbackBlockOptions, SlackFeedbackHandler } from '@cuylabs/channel-slack/feedback';
 import { ParsedAssistantUserMessage } from '@cuylabs/channel-slack/assistant';
 
+type SlackAssistantCancelControlVisibleWhen = "before-output" | "always-while-active";
+interface SlackAssistantCancelControlOptions {
+    actionId?: string;
+    buttonText?: string;
+    messageText?: string;
+    visibleWhen?: SlackAssistantCancelControlVisibleWhen;
+    canceledAck?: string | false;
+    alreadyCompletedAck?: string | false;
+    unauthorizedAck?: string | false;
+    onCancel?: (context: SlackAssistantTurnCancelContext) => MaybePromise<void>;
+}
+interface SlackAssistantTurnControlsOptions {
+    cancel?: true | SlackAssistantCancelControlOptions;
+}
+interface SlackAssistantTurnCancelContext {
+    controlId: string;
+    sessionId: string;
+    channelId: string;
+    threadTs: string;
+    userId: string;
+    teamId?: string;
+}
+
 /**
  * Session strategies for the Bolt Assistant bridge.
  *
@@ -187,6 +210,13 @@ interface CreateSlackAssistantBridgeOptions {
      * - `false`: omit the feedback block entirely.
      */
     feedback?: SlackAssistantFeedbackConfig | false;
+    /**
+     * Optional active-turn controls rendered in Slack while an assistant turn is
+     * running. The cancel control aborts the underlying `AgentTurnSource` via
+     * the per-turn `AbortSignal`, so any runtime implementing that contract can
+     * participate without Slack-specific code.
+     */
+    turnControls?: SlackAssistantTurnControlsOptions;
     /**
      * Bridge options forwarded to `bridgeAgentEventsToSlack`. Streaming mode is
      * pinned to `"chat-stream"` and cannot be overridden here.
@@ -283,6 +313,11 @@ interface SlackAssistantBridge {
      * The resolved feedback action id, or `undefined` when feedback is disabled.
      */
     feedbackActionId?: string;
+    /**
+     * The resolved cancel action id, or `undefined` when turn cancel controls are
+     * disabled.
+     */
+    turnCancelActionId?: string;
 }
 
-export { type AssistantLifecycleArgs as A, type CreateSlackAssistantBridgeOptions as C, type MaybePromise as M, type SlackAssistantBridge as S, type AssistantThreadStartedArgs as a, type SlackAssistantFeedbackConfig as b, type SlackAssistantSessionStrategy as c, type SlackAssistantStatusContext as d, type SlackAssistantThreadContextStoreLike as e, type SlackAssistantThreadStartedContext as f, type SlackAssistantTurnPreparation as g, type SlackAssistantUserMessageContext as h, resolveAssistantSessionId as r };
+export { type AssistantLifecycleArgs as A, type CreateSlackAssistantBridgeOptions as C, type MaybePromise as M, type SlackAssistantBridge as S, type AssistantThreadStartedArgs as a, type SlackAssistantCancelControlOptions as b, type SlackAssistantCancelControlVisibleWhen as c, type SlackAssistantFeedbackConfig as d, type SlackAssistantSessionStrategy as e, type SlackAssistantStatusContext as f, type SlackAssistantThreadContextStoreLike as g, type SlackAssistantThreadStartedContext as h, type SlackAssistantTurnCancelContext as i, type SlackAssistantTurnControlsOptions as j, type SlackAssistantTurnPreparation as k, type SlackAssistantUserMessageContext as l, resolveAssistantSessionId as r };

package/dist/{options-BcDReOJv.d.ts → options-CGUfVStV.d.ts}

@@ -1,6 +1,6 @@
 import { AgentEvent, ApprovalEvent } from '@cuylabs/agent-core';
 import { SlackFinalResponseArtifactPublisher, SlackFinalResponseArtifactDeliveryMode, SlackFinalResponseArtifactContext, SlackFinalResponseArtifactResult } from './artifacts/index.js';
-import { a as SlackEventInteractiveRequestHandler } from './interactive-o_NZb-Xg.js';
+import { a as SlackEventInteractiveRequestHandler } from './interactive-BigrPKnu.js';
 
 /**
  * Event-bridge configuration. The bridge is mode-aware (progressive,

package/dist/shared/index.d.ts

@@ -1,82 +1,13 @@
 export { D as DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY, S as SlackContextFragmentMiddlewareOptions, a as SlackContextFragmentPayload, b as SlackContextFragmentResolver, c as SlackContextFragmentResolverContext, d as createSlackContextFragmentMiddleware } from '../context-fragments-CQEDcjYR.js';
 import { AgentEvent } from '@cuylabs/agent-core';
-import { S as SlackEventBridgeOptions } from '../options-BcDReOJv.js';
-export { r as resolveSlackEventBridgeOptions } from '../options-BcDReOJv.js';
-import { SlackArtifactClient } from '@cuylabs/channel-slack/artifacts';
-export { S as SlackApprovalRequest, a as SlackEventInteractiveRequestHandler, b as SlackHumanInputRequest, c as SlackInteractiveMessage, d as SlackInteractiveMessageRef, e as SlackInteractiveRequest, f as SlackInteractiveRequestBaseContext, g as SlackInteractiveRequestContext, h as SlackInteractiveRequestHandler, i as SlackInteractiveRequestKind, j as SlackInteractiveResponder } from '../interactive-o_NZb-Xg.js';
+import { S as SlackEventBridgeOptions } from '../options-CGUfVStV.js';
+export { r as resolveSlackEventBridgeOptions } from '../options-CGUfVStV.js';
+import { SlackResponseSink } from '@cuylabs/channel-slack/responses';
+export { S as SlackApprovalRequest, a as SlackEventInteractiveRequestHandler, b as SlackHumanInputRequest, c as SlackInteractiveRequest, d as SlackInteractiveRequestBaseContext, e as SlackInteractiveRequestContext, f as SlackInteractiveRequestHandler } from '../interactive-BigrPKnu.js';
 import '@cuylabs/channel-slack/core';
 import '../artifacts/index.js';
-
-/**
- * Slack response-sink contracts consumed by the event bridge.
- *
- * The adapter constructs a `SlackResponseSink` from the Bolt `say` function
- * and `WebClient` instance available in each handler. Keeping the sink
- * interface separate makes the bridge testable without a live Slack
- * connection.
- */
-
-type SlackStreamTaskStatus = "pending" | "in_progress" | "complete" | "error";
-type SlackStreamChunk = {
-    type: "markdown_text";
-    text: string;
-} | {
-    type: "plan_update";
-    title: string;
-} | {
-    type: "task_update";
-    id: string;
-    title: string;
-    status: SlackStreamTaskStatus;
-    details?: string;
-    output?: string;
-};
-interface SlackChatStream {
-    append(args: {
-        markdown_text?: string;
-        chunks?: SlackStreamChunk[];
-    }): Promise<unknown>;
-    stop(args?: {
-        markdown_text?: string;
-        chunks?: SlackStreamChunk[];
-    }): Promise<unknown>;
-}
-/**
- * Minimal Slack posting interface consumed by the event bridge.
- */
-interface SlackArtifactPublicationTarget {
-    channelId: string;
-    threadTs?: string;
-}
-interface SlackResponseSink {
-    /**
-     * Slack Web API surface used by optional artifact publishers.
-     */
-    artifactClient?: SlackArtifactClient;
-    /**
-     * Channel/thread target used by optional artifact publishers.
-     */
-    artifactTarget?: SlackArtifactPublicationTarget;
-    /**
-     * Post a new message to the channel / thread.
-     * Returns the channel ID and message timestamp needed for updates.
-     */
-    postMessage(text: string): Promise<{
-        channel: string;
-        ts: string;
-    }>;
-    /**
-     * Update an existing message by channel + ts.
-     */
-    updateMessage(channel: string, ts: string, text: string): Promise<void>;
-    /**
-     * Create a native Slack chat stream. Required when `streamingMode` is
-     * `"chat-stream"`.
-     */
-    createChatStream?(options: {
-        bufferSize: number;
-    }): SlackChatStream;
-}
+import '@cuylabs/channel-slack/artifacts';
+import '@cuylabs/channel-slack/interactive';
 
 /**
  * Event bridge — maps an agent-core `AgentEvent` stream to a Slack
@@ -114,4 +45,4 @@ declare class UnsupportedSlackInteractiveRequestError extends Error {
     constructor(kind: "approval" | "human-input", requestId: string, message: string);
 }
 
-export { type SlackArtifactPublicationTarget, type SlackChatStream, SlackEventBridgeOptions, type SlackResponseSink, type SlackStreamChunk, type SlackStreamTaskStatus, UnsupportedSlackInteractiveRequestError, bridgeAgentEventsToSlack };
+export { SlackEventBridgeOptions, UnsupportedSlackInteractiveRequestError, bridgeAgentEventsToSlack };

package/dist/shared/index.js

@@ -6,7 +6,7 @@ import {
   UnsupportedSlackInteractiveRequestError,
   bridgeAgentEventsToSlack,
   resolveSlackEventBridgeOptions
-} from "../chunk-TMADMHBN.js";
+} from "../chunk-VBGQD6JT.js";
 export {
   DEFAULT_SLACK_CONTEXT_FRAGMENT_KEY,
   UnsupportedSlackInteractiveRequestError,

package/dist/socket.d.ts

@@ -1,19 +1,20 @@
 import { App } from '@slack/bolt';
 import { CreateSlackSocketBoltAppOptions } from '@cuylabs/channel-slack/transports/socket';
 import { SlackDirectAuthOptions, SlackDirectAuthMode } from '@cuylabs/channel-slack/auth';
-import { S as SlackAssistantBridge, C as CreateSlackAssistantBridgeOptions, b as SlackAssistantFeedbackConfig } from './options-CdqBABcM.js';
+import { S as SlackAssistantBridge, C as CreateSlackAssistantBridgeOptions, d as SlackAssistantFeedbackConfig } from './options-ByNm2o89.js';
 import { SlackAgentAppSurfaceOptions } from './app-surface.js';
 import { SlackFeedbackHandler } from '@cuylabs/channel-slack/feedback';
 import '@cuylabs/agent-core';
 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/assistant';
-import './types-CRWzJB5G.js';
-import './types-Crpil4kb.js';
+import './types-BeGPexio.js';
+import './types-Bz4OYEAV.js';
 import './types-CiwGU6zC.js';
 import '@cuylabs/channel-slack/views';
 

package/dist/socket.js

@@ -1,12 +1,12 @@
 import {
   mountSlackAgentAppSocket,
   mountSlackAssistantAgentSocket
-} from "./chunk-VMVQIDNR.js";
-import "./chunk-7DUO5BMW.js";
-import "./chunk-MGBNGG4D.js";
+} from "./chunk-HHXAXSG6.js";
+import "./chunk-GKZRDNEB.js";
+import "./chunk-FJP6ZFUB.js";
 import "./chunk-ELR6MQD7.js";
-import "./chunk-FQWFB54C.js";
-import "./chunk-TMADMHBN.js";
+import "./chunk-XA7U3GRN.js";
+import "./chunk-VBGQD6JT.js";
 export {
   mountSlackAgentAppSocket,
   mountSlackAssistantAgentSocket

package/dist/{types-CRWzJB5G.d.ts → types-BeGPexio.d.ts}

@@ -1,7 +1,7 @@
 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-BcDReOJv.js';
-import { h as SlackInteractiveRequestHandler } from './interactive-o_NZb-Xg.js';
+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

package/dist/{types-Crpil4kb.d.ts → types-Bz4OYEAV.d.ts}

@@ -1,11 +1,10 @@
-import { ApprovalAction, ApprovalRememberScope, HumanInputResponse, ApprovalRequest, HumanInputRequest, ApprovalResolution } from '@cuylabs/agent-core';
+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 { S as SlackApprovalRequest, b as SlackHumanInputRequest, g as SlackInteractiveRequestContext, d as SlackInteractiveMessageRef } from './interactive-o_NZb-Xg.js';
+import { e as SlackInteractiveRequestContext } from './interactive-BigrPKnu.js';
 
-type SlackInteractiveRequestStatus = "pending" | "resolved";
-type SlackInteractiveApprovalRequest = ApprovalRequest | SlackApprovalRequest;
-type SlackInteractiveHumanInputRequest = SlackHumanInputRequest & Partial<Pick<HumanInputRequest, "sessionId" | "timestamp" | "toolCallId">>;
-type SlackInteractiveStoredRequest = SlackInteractiveApprovalRequest | SlackInteractiveHumanInputRequest;
+type SlackInteractiveApprovalRequest = ApprovalRequest;
+type SlackInteractiveHumanInputRequest = SlackInteractiveHumanInputRequest$1 & Partial<Pick<HumanInputRequest, "sessionId" | "timestamp" | "toolCallId">>;
 type SlackInteractiveResolution = {
     kind: "approval";
     action: ApprovalAction;
@@ -15,54 +14,6 @@ type SlackInteractiveResolution = {
     kind: "human-input";
     response: HumanInputResponse;
 };
-interface SlackInteractiveMessageTarget {
-    channel: string;
-    ts: string;
-    threadTs?: string;
-    userId: string;
-    teamId?: string;
-}
-interface SlackInteractiveRequestRecord {
-    id: string;
-    kind: SlackInteractiveResolution["kind"];
-    request: SlackInteractiveStoredRequest;
-    status: SlackInteractiveRequestStatus;
-    createdAt: string;
-    updatedAt: string;
-    target?: SlackInteractiveMessageTarget;
-    resolution?: SlackInteractiveResolution;
-}
-interface SlackInteractiveRequestStore {
-    get(requestId: string): Promise<SlackInteractiveRequestRecord | undefined>;
-    upsert(record: SlackInteractiveRequestRecord): Promise<SlackInteractiveRequestRecord>;
-    /**
-     * Attach the Slack message target for an already-upserted request.
-     *
-     * Implementations should return `undefined` when the request does not exist;
-     * callers must upsert before attaching a target.
-     */
-    attachTarget(requestId: string, target: SlackInteractiveMessageTarget): Promise<SlackInteractiveRequestRecord | undefined>;
-    /**
-     * Mark a request resolved. Implementations must be idempotent: resolving an
-     * already-resolved request should return the existing record without
-     * overwriting the original resolution.
-     */
-    resolve(requestId: string, resolution: SlackInteractiveResolution): Promise<SlackInteractiveRequestRecord | undefined>;
-    delete(requestId: string): Promise<void>;
-}
-interface SlackInteractiveActionIds {
-    approvalAllow: string;
-    approvalDeny: string;
-    approvalRemember: string;
-    humanConfirm: string;
-    humanDeny: string;
-    humanOpen: string;
-    humanSubmit: string;
-}
-interface SlackInteractiveActor {
-    userId: string;
-    teamId?: string;
-}
 interface SlackInteractiveRequestWaitOptions {
     /**
      * Abort waiting for this request. The controller removes its local waiter and
@@ -133,4 +84,4 @@ interface SlackInteractivePostedMessage {
     ref: SlackInteractiveMessageRef;
 }
 
-export type { SlackInteractiveActionIds as S, SlackInteractiveActor as a, SlackInteractiveApprovalRequest as b, SlackInteractiveController as c, SlackInteractiveControllerOptions as d, SlackInteractiveHumanInputRequest as e, SlackInteractiveMessageTarget as f, SlackInteractivePendingWaiter as g, SlackInteractivePostedMessage as h, SlackInteractiveRequestRecord as i, SlackInteractiveRequestStatus as j, SlackInteractiveRequestStore as k, SlackInteractiveRequestWaitOptions as l, SlackInteractiveResolution as m, SlackInteractiveStoredRequest as n };
+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/docs/concepts/interactive-requests.md

@@ -4,10 +4,8 @@ Slack interactive requests render Agent Core approval and human-input requests
 as Slack buttons and modals.
 
 ```typescript
-import {
-  createPostgresSlackInteractiveRequestStore,
-  createSlackInteractiveController,
-} from "@cuylabs/channel-slack-agent-core/interactive";
+import { createSlackInteractiveController } from "@cuylabs/channel-slack-agent-core/interactive";
+import { createPostgresSlackInteractiveRequestStore } from "@cuylabs/channel-slack/interactive";
 
 const interactiveStore = createPostgresSlackInteractiveRequestStore({
   connectionString: process.env.DATABASE_URL,
@@ -30,10 +28,12 @@ const interactive = createSlackInteractiveController({
 
 ## Store Choices
 
-- `createInMemorySlackInteractiveRequestStore` is useful for tests and local
+- `createInMemorySlackInteractiveRequestStore` from
+  `@cuylabs/channel-slack/interactive` is useful for tests and local
   single-process apps.
-- `createPostgresSlackInteractiveRequestStore` persists pending requests across
-  restarts and lets multiple Slack workers resolve the same request safely.
+- `createPostgresSlackInteractiveRequestStore` from
+  `@cuylabs/channel-slack/interactive` persists pending requests across restarts
+  and lets multiple Slack workers resolve the same request safely.
 
 The Postgres store uses one table keyed by request ID. `resolve(...)` is
 idempotent: the first resolution wins, and later duplicate button clicks return

package/docs/reference/boundary.md

@@ -6,16 +6,18 @@ This package owns only the `@cuylabs/agent-core` Slack binding.
 
 - Mapping Slack turns to `AgentTurnSource.chat(...)`.
 - Creating Agent Core scopes and context fragments.
-- Converting `AgentEvent` streams to Slack messages or chat streams.
+- Converting `AgentEvent` streams through Slack response sink contracts.
 - Mounting Agent Core sources on Express Events API and Socket Mode surfaces.
 - Binding Slack Assistant lifecycle handlers to Agent Core turns.
-- Handling Agent Core approval and human-input requests in Slack.
+- Binding Agent Core approval and human-input requests to Slack interactive
+  request primitives.
 - Agent Core helpers for Slack history context fragments and source events.
 
 ## Outside This Package
 
 - Generic Slack activity parsing, formatting, setup, auth, policy, history,
-  targets, users, entrypoints, artifacts, and transport factories.
+  targets, users, entrypoints, artifacts, response sink contracts, interactive
+  request builders/stores, and transport factories.
 - Product prompts, tools, audit policy, privacy rules, and deployment policy.
 - Slack app configuration outside the reusable setup helpers.
 

package/docs/reference/exports.md

@@ -3,24 +3,24 @@
 Use feature subpaths when you only need one adapter surface. Generic Slack
 primitives should be imported from `@cuylabs/channel-slack` directly.
 
-| Export                                                | Depends on                                                                             | Notes                                                                             |
-| ----------------------------------------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
-| `@cuylabs/channel-slack-agent-core`                   | `@cuylabs/agent-core`, selected Slack peers                                            | Full adapter surface re-export                                                    |
-| `@cuylabs/channel-slack-agent-core/adapter`           | `@slack/bolt`, `@slack/web-api` types                                                  | Classic app mention, DM, and passive channel-message adapter                      |
-| `@cuylabs/channel-slack-agent-core/app`               | `@slack/bolt`, `@slack/web-api`                                                        | Direct app factory for mounted Slack surfaces                                     |
-| `@cuylabs/channel-slack-agent-core/app-surface`       | `@slack/bolt`, `@slack/web-api` types                                                  | Shared surface installer for Assistant, mentions, DMs, feedback, and interactions |
-| `@cuylabs/channel-slack-agent-core/artifacts`         | `@cuylabs/channel-slack/artifacts`                                                     | Agent Core final-response artifact publishers for Slack surfaces                  |
-| `@cuylabs/channel-slack-agent-core/assistant`         | `@slack/bolt`, `@slack/web-api` types                                                  | Slack Assistant bridge and lifecycle handlers                                     |
-| `@cuylabs/channel-slack-agent-core/express`           | `@slack/bolt`, `express`                                                               | Express Events API mounting for classic Slack surfaces                            |
-| `@cuylabs/channel-slack-agent-core/express-assistant` | `@slack/bolt`, `express`                                                               | Express Events API mounting for Slack Assistant                                   |
-| `@cuylabs/channel-slack-agent-core/feedback`          | `@slack/bolt`, `@slack/types`                                                          | Agent Core feedback binding helpers                                               |
-| `@cuylabs/channel-slack-agent-core/history`           | `@slack/web-api`, `@cuylabs/agent-core` types                                          | Agent Core turn history context fragment assembly                                 |
-| `@cuylabs/channel-slack-agent-core/interactive`       | `@slack/bolt`, `@slack/types`; `pg` only when using connection-string Postgres storage | Agent Core approval and human-input binding for Slack                             |
-| `@cuylabs/channel-slack-agent-core/mcp`               | `@cuylabs/agent-core/mcp` types                                                        | Slack OAuth token bridge for Agent Core MCP setup                                 |
-| `@cuylabs/channel-slack-agent-core/shared`            | `@cuylabs/agent-core` types                                                            | Context fragments, event bridge, and interactive request contracts                |
-| `@cuylabs/channel-slack-agent-core/socket`            | `@slack/bolt`                                                                          | Socket Mode mounting helpers                                                      |
-| `@cuylabs/channel-slack-agent-core/source`            | `@cuylabs/agent-core` types                                                            | Source event queue, response helpers, and status visibility helpers               |
-| `@cuylabs/channel-slack-agent-core/views`             | `@cuylabs/channel-slack/views`, `@slack/bolt`                                          | Agent/product Slack modal workflow controller and submitted state helpers         |
+| Export                                                | Depends on                                          | Notes                                                                             |
+| ----------------------------------------------------- | --------------------------------------------------- | --------------------------------------------------------------------------------- |
+| `@cuylabs/channel-slack-agent-core`                   | `@cuylabs/agent-core`, selected Slack peers         | Full adapter surface re-export                                                    |
+| `@cuylabs/channel-slack-agent-core/adapter`           | `@slack/bolt`, `@slack/web-api` types               | Classic app mention, DM, and passive channel-message adapter                      |
+| `@cuylabs/channel-slack-agent-core/app`               | `@slack/bolt`, `@slack/web-api`                     | Direct app factory for mounted Slack surfaces                                     |
+| `@cuylabs/channel-slack-agent-core/app-surface`       | `@slack/bolt`, `@slack/web-api` types               | Shared surface installer for Assistant, mentions, DMs, feedback, and interactions |
+| `@cuylabs/channel-slack-agent-core/artifacts`         | `@cuylabs/channel-slack/artifacts`                  | Agent Core final-response artifact publishers for Slack surfaces                  |
+| `@cuylabs/channel-slack-agent-core/assistant`         | `@slack/bolt`, `@slack/web-api` types               | Slack Assistant bridge and lifecycle handlers                                     |
+| `@cuylabs/channel-slack-agent-core/express`           | `@slack/bolt`, `express`                            | Express Events API mounting for classic Slack surfaces                            |
+| `@cuylabs/channel-slack-agent-core/express-assistant` | `@slack/bolt`, `express`                            | Express Events API mounting for Slack Assistant                                   |
+| `@cuylabs/channel-slack-agent-core/feedback`          | `@slack/bolt`, `@slack/types`                       | Agent Core feedback binding helpers                                               |
+| `@cuylabs/channel-slack-agent-core/history`           | `@slack/web-api`, `@cuylabs/agent-core` types       | Agent Core turn history context fragment assembly                                 |
+| `@cuylabs/channel-slack-agent-core/interactive`       | `@slack/bolt`, `@cuylabs/channel-slack/interactive` | Agent Core approval and human-input controller binding for Slack                  |
+| `@cuylabs/channel-slack-agent-core/mcp`               | `@cuylabs/agent-core/mcp` types                     | Slack OAuth token bridge for Agent Core MCP setup                                 |
+| `@cuylabs/channel-slack-agent-core/shared`            | `@cuylabs/agent-core` types                         | Context fragments, event bridge, and Agent Core interactive request contracts     |
+| `@cuylabs/channel-slack-agent-core/socket`            | `@slack/bolt`                                       | Socket Mode mounting helpers                                                      |
+| `@cuylabs/channel-slack-agent-core/source`            | `@cuylabs/agent-core` types                         | Source event queue, response helpers, and status visibility helpers               |
+| `@cuylabs/channel-slack-agent-core/views`             | `@cuylabs/channel-slack/views`, `@slack/bolt`       | Agent/product Slack modal workflow controller and submitted state helpers         |
 
 For generic Slack package exports, see
 `@cuylabs/channel-slack/docs/reference/exports.md`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cuylabs/channel-slack-agent-core",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Slack adapter for @cuylabs/agent-core built on @cuylabs/channel-slack",
   "type": "module",
   "main": "./dist/index.js",
@@ -94,7 +94,7 @@
   ],
   "dependencies": {
     "@cuylabs/agent-core": "^7.2.0",
-    "@cuylabs/channel-slack": "^0.7.0"
+    "@cuylabs/channel-slack": "^0.9.0"
   },
   "peerDependencies": {
     "@slack/bolt": ">=4.7.3",