@cuylabs/channel-slack 0.7.0 → 0.8.0

package/dist/chunk-3KP3CBCC.js

@@ -0,0 +1,175 @@
+// src/turn-controls/block.ts
+var SLACK_TURN_CANCEL_ACTION_ID = "agent_turn_cancel";
+function createSlackTurnCancelMessage(options) {
+  const actionId = resolveSlackTurnCancelActionId(options.actionId);
+  const controlId = options.controlId.trim();
+  if (!controlId) {
+    throw new Error(
+      "createSlackTurnCancelMessage: controlId must be a non-empty string"
+    );
+  }
+  const text = (options.messageText ?? "Request controls").trim();
+  if (!text) {
+    throw new Error(
+      "createSlackTurnCancelMessage: messageText must be a non-empty string"
+    );
+  }
+  const buttonText = (options.buttonText ?? "Cancel").trim();
+  if (!buttonText) {
+    throw new Error(
+      "createSlackTurnCancelMessage: buttonText must be a non-empty string"
+    );
+  }
+  const value = encodeSlackTurnCancelButtonValue({
+    action: "cancel",
+    controlId,
+    ...options.sessionId ? { sessionId: options.sessionId } : {},
+    ...options.turnId ? { turnId: options.turnId } : {}
+  });
+  return {
+    text,
+    blocks: [
+      {
+        type: "section",
+        text: { type: "mrkdwn", text }
+      },
+      {
+        type: "actions",
+        elements: [
+          {
+            type: "button",
+            action_id: actionId,
+            text: { type: "plain_text", text: buttonText },
+            accessibility_label: buttonText,
+            style: "danger",
+            value
+          }
+        ]
+      }
+    ]
+  };
+}
+function encodeSlackTurnCancelButtonValue(value) {
+  return JSON.stringify(value);
+}
+function decodeSlackTurnCancelButtonValue(rawValue) {
+  if (typeof rawValue !== "string" || !rawValue.trim()) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(rawValue);
+    const controlId = parseOptionalString(parsed.controlId);
+    if (parsed.action !== "cancel" || !controlId) {
+      return void 0;
+    }
+    const sessionId = parseOptionalString(parsed.sessionId);
+    const turnId = parseOptionalString(parsed.turnId);
+    return {
+      action: "cancel",
+      controlId,
+      ...sessionId ? { sessionId } : {},
+      ...turnId ? { turnId } : {}
+    };
+  } catch {
+    return void 0;
+  }
+}
+function parseOptionalString(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  return trimmed || void 0;
+}
+function resolveSlackTurnCancelActionId(actionId) {
+  const resolved = (actionId ?? SLACK_TURN_CANCEL_ACTION_ID).trim();
+  if (!resolved) {
+    throw new Error("Slack turn cancel action id cannot be empty.");
+  }
+  return resolved;
+}
+
+// src/turn-controls/action.ts
+function registerSlackTurnCancelAction(app, options) {
+  const actionId = resolveSlackTurnCancelActionId(options.actionId);
+  app.action(
+    actionId,
+    // Bolt's action args are structurally stable, but not exported as one
+    // concise public type across all action element variants.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async ({ ack, body, client, logger }) => {
+      try {
+        const ackFn = ack;
+        await ackFn();
+        if (body?.type !== "block_actions" || !Array.isArray(body.actions) || body.actions.length === 0) {
+          return;
+        }
+        const action = body.actions[0];
+        if (action?.type !== "button") {
+          return;
+        }
+        const value = decodeSlackTurnCancelButtonValue(action.value);
+        if (!value) {
+          return;
+        }
+        const channelId = body.channel?.id ?? body.container?.channel_id;
+        const userId = body.user?.id;
+        const messageTs = body.message?.ts ?? body.container?.message_ts;
+        const threadTs = body.message?.thread_ts ?? body.container?.thread_ts;
+        const teamId = body.team?.id;
+        const triggerId = typeof body.trigger_id === "string" ? body.trigger_id : void 0;
+        if (!channelId || !userId || !messageTs) {
+          return;
+        }
+        const acknowledgeEphemeral = async (text) => {
+          await client.chat.postEphemeral({
+            channel: channelId,
+            user: userId,
+            ...threadTs ? { thread_ts: threadTs } : { thread_ts: messageTs },
+            text
+          });
+        };
+        const deleteMessage = async () => {
+          await client.chat.delete({
+            channel: channelId,
+            ts: messageTs
+          });
+        };
+        const updateMessage = async (message) => {
+          await client.chat.update({
+            channel: channelId,
+            ts: messageTs,
+            text: message.text,
+            ...message.blocks ? { blocks: message.blocks } : {}
+          });
+        };
+        await options.onCancel({
+          ...value,
+          channelId,
+          userId,
+          messageTs,
+          ...threadTs ? { threadTs } : {},
+          ...teamId ? { teamId } : {},
+          ...triggerId ? { triggerId } : {},
+          acknowledgeEphemeral,
+          deleteMessage,
+          updateMessage
+        });
+      } catch (error) {
+        logger?.error?.(
+          `[channel-slack] turn cancel action failed: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  return { actionId };
+}
+
+export {
+  SLACK_TURN_CANCEL_ACTION_ID,
+  createSlackTurnCancelMessage,
+  encodeSlackTurnCancelButtonValue,
+  decodeSlackTurnCancelButtonValue,
+  resolveSlackTurnCancelActionId,
+  registerSlackTurnCancelAction
+};

package/dist/core.d.ts

@@ -1,4 +1,7 @@
 import { S as SlackActivityInfo, b as SlackUserIdentity, a as SlackChannelType } from './activity-ByrD9Ftr.js';
+export { RegisterSlackTurnCancelActionOptions, SLACK_TURN_CANCEL_ACTION_ID, SlackTurnCancelActionContext, SlackTurnCancelActionHandler, SlackTurnCancelButtonValue, SlackTurnCancelMessage, SlackTurnCancelMessageOptions, createSlackTurnCancelMessage, decodeSlackTurnCancelButtonValue, encodeSlackTurnCancelButtonValue, registerSlackTurnCancelAction, resolveSlackTurnCancelActionId } from './turn-controls/index.js';
+import '@slack/types';
+import '@slack/bolt';
 
 /**
  * Slack auth context — credentials and identifiers resolved from the inbound

package/dist/core.js

@@ -3,7 +3,15 @@ import {
   formatSlackAttributedFollowUp,
   resolveThreadAwareSlackSessionId,
   runWithSlackTurnContext
-} from "./chunk-X4WBBBYM.js";
+} from "./chunk-ISOMBQXE.js";
+import {
+  SLACK_TURN_CANCEL_ACTION_ID,
+  createSlackTurnCancelMessage,
+  decodeSlackTurnCancelButtonValue,
+  encodeSlackTurnCancelButtonValue,
+  registerSlackTurnCancelAction,
+  resolveSlackTurnCancelActionId
+} from "./chunk-3KP3CBCC.js";
 import {
   markdownToSlackMrkdwn,
   resolveSlackMessageFormatter
@@ -24,7 +32,11 @@ import {
   stripLeadingMentions
 } from "./chunk-FPCE5V5Y.js";
 export {
+  SLACK_TURN_CANCEL_ACTION_ID,
+  createSlackTurnCancelMessage,
   currentSlackTurnContext,
+  decodeSlackTurnCancelButtonValue,
+  encodeSlackTurnCancelButtonValue,
   extractSlackActionToken,
   extractSlackAttachmentsText,
   extractSlackAuthContext,
@@ -36,8 +48,10 @@ export {
   markdownToSlackMrkdwn,
   parseSlackMentionActivity,
   parseSlackMessageActivity,
+  registerSlackTurnCancelAction,
   resolveSlackChannelType,
   resolveSlackMessageFormatter,
+  resolveSlackTurnCancelActionId,
   resolveThreadAwareSlackSessionId,
   runWithSlackTurnContext,
   stripLeadingMentions

package/dist/index.d.ts

@@ -1,4 +1,7 @@
 export { S as SlackActivityInfo, a as SlackChannelType, b as SlackUserIdentity } from './activity-ByrD9Ftr.js';
 export { ExtractSlackMessageTextOptions, RawSlackActionTokenPayload, RawSlackAppMentionPayload, RawSlackAssistantThreadPayload, RawSlackMessagePayload, SlackAmbientTurnContext, SlackApprovalRequest, SlackAssistantStatusUpdate, SlackAssistantSuggestedPrompt, SlackAssistantSuggestedPrompts, SlackAssistantTaskDisplayMode, SlackAssistantThreadContext, SlackAssistantUtilities, SlackAuthContext, SlackChatStreamStartArgs, SlackEventInteractiveRequestHandler, SlackHumanInputRequest, SlackInteractiveMessage, SlackInteractiveMessageRef, SlackInteractiveRequest, SlackInteractiveRequestBaseContext, SlackInteractiveRequestContext, SlackInteractiveRequestHandler, SlackInteractiveRequestKind, SlackInteractiveResponder, SlackMessageAuthorshipOptions, SlackMessageFormatter, SlackMessageFormattingOptions, SlackMessageTextPayload, SlackThreadStatusSetter, SlackTurnPreparation, SlackTurnRequestContext, currentSlackTurnContext, extractSlackActionToken, extractSlackAttachmentsText, extractSlackAuthContext, extractSlackBlocksText, extractSlackMessageText, extractSlackUserIdentity, formatSlackAttributedFollowUp, isProcessableMessage, markdownToSlackMrkdwn, parseSlackMentionActivity, parseSlackMessageActivity, resolveSlackChannelType, resolveSlackMessageFormatter, resolveThreadAwareSlackSessionId, runWithSlackTurnContext, stripLeadingMentions } from './core.js';
+export { RegisterSlackTurnCancelActionOptions, SLACK_TURN_CANCEL_ACTION_ID, SlackTurnCancelActionContext, SlackTurnCancelActionHandler, SlackTurnCancelButtonValue, SlackTurnCancelMessage, SlackTurnCancelMessageOptions, createSlackTurnCancelMessage, decodeSlackTurnCancelButtonValue, encodeSlackTurnCancelButtonValue, registerSlackTurnCancelAction, resolveSlackTurnCancelActionId } from './turn-controls/index.js';
 export { InMemorySlackThreadParticipationStateStoreOptions, PostgresSlackMessagePolicyPruneResult, PostgresSlackMessagePolicyStateStore, PostgresSlackMessagePolicyStateStoreOptions, PostgresSlackThreadParticipationStateStore, PostgresSlackThreadParticipationStateStoreOptions, SlackAsyncMessagePolicyConfig, SlackAsyncMessagePolicyResolver, SlackChannelMessagePolicy, SlackMentionedThreadState, SlackMessagePolicyAcceptReason, SlackMessagePolicyAcceptedDecision, SlackMessagePolicyConfig, SlackMessagePolicyDecision, SlackMessagePolicyPostgresClient, SlackMessagePolicyRejectReason, SlackMessagePolicyRejectedDecision, SlackMessagePolicyResolver, SlackMessagePolicyStateContext, SlackMessagePolicyStateStore, SlackQuietThreadRejectedDecision, SlackSyncMessagePolicyStateStore, SlackThreadAwareMessagePolicyConfig, SlackThreadAwareMessagePolicyDecision, SlackThreadAwareMessagePolicyResolver, SlackThreadParticipationEligibility, SlackThreadParticipationEligibilityOptions, SlackThreadParticipationMode, SlackThreadParticipationPostgresClient, SlackThreadParticipationPruneResult, SlackThreadParticipationReactivation, SlackThreadParticipationState, SlackThreadParticipationStateContext, SlackThreadParticipationStateStore, SlackThreadReplyPolicy, createAsyncSlackMessagePolicyResolver, createAsyncSlackThreadAwareMessagePolicyResolver, createInMemorySlackMessagePolicyStateStore, createInMemorySlackThreadParticipationStateStore, createPostgresSlackMessagePolicyStateStore, createPostgresSlackThreadParticipationStateStore, createSlackMessagePolicyMessageKey, createSlackMessagePolicyResolver, createSlackMessagePolicyThreadKey, initializePostgresSlackMessagePolicyState, initializePostgresSlackThreadParticipationState, prunePostgresSlackMessagePolicyState, prunePostgresSlackThreadParticipationState, resolveSlackThreadParticipationEligibility, shouldRegisterSlackPassiveChannelMessages } from './policy/index.js';
 export { L as Logger } from './logging-Bl3HfcC8.js';
+import '@slack/types';
+import '@slack/bolt';

package/dist/index.js

@@ -20,7 +20,15 @@ import {
   formatSlackAttributedFollowUp,
   resolveThreadAwareSlackSessionId,
   runWithSlackTurnContext
-} from "./chunk-X4WBBBYM.js";
+} from "./chunk-ISOMBQXE.js";
+import {
+  SLACK_TURN_CANCEL_ACTION_ID,
+  createSlackTurnCancelMessage,
+  decodeSlackTurnCancelButtonValue,
+  encodeSlackTurnCancelButtonValue,
+  registerSlackTurnCancelAction,
+  resolveSlackTurnCancelActionId
+} from "./chunk-3KP3CBCC.js";
 import {
   markdownToSlackMrkdwn,
   resolveSlackMessageFormatter
@@ -41,6 +49,7 @@ import {
   stripLeadingMentions
 } from "./chunk-FPCE5V5Y.js";
 export {
+  SLACK_TURN_CANCEL_ACTION_ID,
   createAsyncSlackMessagePolicyResolver,
   createAsyncSlackThreadAwareMessagePolicyResolver,
   createInMemorySlackMessagePolicyStateStore,
@@ -50,7 +59,10 @@ export {
   createSlackMessagePolicyMessageKey,
   createSlackMessagePolicyResolver,
   createSlackMessagePolicyThreadKey,
+  createSlackTurnCancelMessage,
   currentSlackTurnContext,
+  decodeSlackTurnCancelButtonValue,
+  encodeSlackTurnCancelButtonValue,
   extractSlackActionToken,
   extractSlackAttachmentsText,
   extractSlackAuthContext,
@@ -66,9 +78,11 @@ export {
   parseSlackMessageActivity,
   prunePostgresSlackMessagePolicyState,
   prunePostgresSlackThreadParticipationState,
+  registerSlackTurnCancelAction,
   resolveSlackChannelType,
   resolveSlackMessageFormatter,
   resolveSlackThreadParticipationEligibility,
+  resolveSlackTurnCancelActionId,
   resolveThreadAwareSlackSessionId,
   runWithSlackTurnContext,
   shouldRegisterSlackPassiveChannelMessages,

package/dist/turn-controls/index.d.ts

@@ -0,0 +1,51 @@
+import { SectionBlock, ActionsBlock, KnownBlock } from '@slack/types';
+import { App } from '@slack/bolt';
+
+declare const SLACK_TURN_CANCEL_ACTION_ID = "agent_turn_cancel";
+interface SlackTurnCancelButtonValue {
+    action: "cancel";
+    controlId: string;
+    sessionId?: string;
+    turnId?: string;
+}
+interface SlackTurnCancelMessageOptions {
+    controlId: string;
+    actionId?: string;
+    buttonText?: string;
+    messageText?: string;
+    sessionId?: string;
+    turnId?: string;
+}
+interface SlackTurnCancelMessage {
+    text: string;
+    blocks: [SectionBlock, ActionsBlock];
+}
+declare function createSlackTurnCancelMessage(options: SlackTurnCancelMessageOptions): SlackTurnCancelMessage;
+declare function encodeSlackTurnCancelButtonValue(value: SlackTurnCancelButtonValue): string;
+declare function decodeSlackTurnCancelButtonValue(rawValue: unknown): SlackTurnCancelButtonValue | undefined;
+declare function resolveSlackTurnCancelActionId(actionId?: string): string;
+
+interface SlackTurnCancelActionContext extends SlackTurnCancelButtonValue {
+    channelId: string;
+    userId: string;
+    messageTs: string;
+    threadTs?: string;
+    teamId?: string;
+    triggerId?: string;
+    acknowledgeEphemeral: (text: string) => Promise<void>;
+    deleteMessage: () => Promise<void>;
+    updateMessage: (message: {
+        text: string;
+        blocks?: KnownBlock[];
+    }) => Promise<void>;
+}
+type SlackTurnCancelActionHandler = (context: SlackTurnCancelActionContext) => void | Promise<void>;
+interface RegisterSlackTurnCancelActionOptions {
+    actionId?: string;
+    onCancel: SlackTurnCancelActionHandler;
+}
+declare function registerSlackTurnCancelAction(app: App, options: RegisterSlackTurnCancelActionOptions): {
+    actionId: string;
+};
+
+export { type RegisterSlackTurnCancelActionOptions, SLACK_TURN_CANCEL_ACTION_ID, type SlackTurnCancelActionContext, type SlackTurnCancelActionHandler, type SlackTurnCancelButtonValue, type SlackTurnCancelMessage, type SlackTurnCancelMessageOptions, createSlackTurnCancelMessage, decodeSlackTurnCancelButtonValue, encodeSlackTurnCancelButtonValue, registerSlackTurnCancelAction, resolveSlackTurnCancelActionId };

package/dist/turn-controls/index.js

@@ -0,0 +1,16 @@
+import {
+  SLACK_TURN_CANCEL_ACTION_ID,
+  createSlackTurnCancelMessage,
+  decodeSlackTurnCancelButtonValue,
+  encodeSlackTurnCancelButtonValue,
+  registerSlackTurnCancelAction,
+  resolveSlackTurnCancelActionId
+} from "../chunk-3KP3CBCC.js";
+export {
+  SLACK_TURN_CANCEL_ACTION_ID,
+  createSlackTurnCancelMessage,
+  decodeSlackTurnCancelButtonValue,
+  encodeSlackTurnCancelButtonValue,
+  registerSlackTurnCancelAction,
+  resolveSlackTurnCancelActionId
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cuylabs/channel-slack",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Agent-runtime-agnostic Slack channel primitives for AI agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -71,6 +71,11 @@
       "import": "./dist/targets/index.js",
       "default": "./dist/targets/index.js"
     },
+    "./turn-controls": {
+      "types": "./dist/turn-controls/index.d.ts",
+      "import": "./dist/turn-controls/index.js",
+      "default": "./dist/turn-controls/index.js"
+    },
     "./transports": {
       "types": "./dist/transports/index.d.ts",
       "import": "./dist/transports/index.js",
@@ -148,9 +153,9 @@
     "node": ">=20"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/app-home.ts src/artifacts/index.ts src/core.ts src/assistant/index.ts src/auth/index.ts src/diagnostics/index.ts src/entrypoints/index.ts src/feedback/index.ts src/history/index.ts src/policy/index.ts src/setup/index.ts src/targets/index.ts src/transports/index.ts src/transports/http/index.ts src/transports/socket/index.ts src/users/index.ts src/views/index.ts --format esm --dts --clean",
+    "build": "tsup src/index.ts src/app-home.ts src/artifacts/index.ts src/core.ts src/assistant/index.ts src/auth/index.ts src/diagnostics/index.ts src/entrypoints/index.ts src/feedback/index.ts src/history/index.ts src/policy/index.ts src/setup/index.ts src/targets/index.ts src/turn-controls/index.ts src/transports/index.ts src/transports/http/index.ts src/transports/socket/index.ts src/users/index.ts src/views/index.ts --format esm --dts --clean",
     "clean": "rm -rf dist",
-    "dev": "tsup src/index.ts src/app-home.ts src/artifacts/index.ts src/core.ts src/assistant/index.ts src/auth/index.ts src/diagnostics/index.ts src/entrypoints/index.ts src/feedback/index.ts src/history/index.ts src/policy/index.ts src/setup/index.ts src/targets/index.ts src/transports/index.ts src/transports/http/index.ts src/transports/socket/index.ts src/users/index.ts src/views/index.ts --format esm --dts --watch",
+    "dev": "tsup src/index.ts src/app-home.ts src/artifacts/index.ts src/core.ts src/assistant/index.ts src/auth/index.ts src/diagnostics/index.ts src/entrypoints/index.ts src/feedback/index.ts src/history/index.ts src/policy/index.ts src/setup/index.ts src/targets/index.ts src/turn-controls/index.ts src/transports/index.ts src/transports/http/index.ts src/transports/socket/index.ts src/users/index.ts src/views/index.ts --format esm --dts --watch",
     "lint": "eslint \"src/**/*.{ts,tsx}\" \"tests/**/*.{ts,tsx}\" --max-warnings=0",
     "test": "vitest run",
     "test:watch": "vitest",