@openclaw/slack 2026.9.1-beta.1 → 2026.9.2

package/skills/block-kit/references/official-common-patterns.md

@@ -0,0 +1,385 @@
+# Common Block Kit Patterns
+
+> Starting scaffolds for frequent use cases — copy one and customize rather than building from scratch.
+> They were valid when written, but the live docs (the skill's **Source of Truth**) remain authoritative for field schemas, and Block Kit evolves. Confirm any field you change against the component's doc page, and re-run the customized payload through `blocks.validate` (Step 5) before shipping.
+
+---
+
+## Approval Message [M]
+
+A notification with context and Approve/Reject buttons.
+
+```json
+{
+  "channel": "C0123456789",
+  "text": "New request from Jane awaiting approval",
+  "blocks": [
+    {
+      "type": "header",
+      "text": { "type": "plain_text", "text": "New Approval Request" }
+    },
+    {
+      "type": "section",
+      "text": {
+        "type": "mrkdwn",
+        "text": "*Requester:* <@U0123456789>\n*Type:* Access request\n*Details:* Production database read access"
+      }
+    },
+    { "type": "divider" },
+    {
+      "type": "actions",
+      "block_id": "approval_actions",
+      "elements": [
+        {
+          "type": "button",
+          "text": { "type": "plain_text", "text": "Approve" },
+          "style": "primary",
+          "action_id": "approve_btn",
+          "value": "request_123"
+        },
+        {
+          "type": "button",
+          "text": { "type": "plain_text", "text": "Reject" },
+          "style": "danger",
+          "action_id": "reject_btn",
+          "value": "request_123"
+        }
+      ]
+    }
+  ]
+}
+```
+
+**Customization points:** Header text, section fields, button values, adding a confirmation dialog to the Reject button.
+
+---
+
+## Simple Form Modal [V]
+
+A modal with text input, select menu, and optional checkbox.
+
+```json
+{
+  "type": "modal",
+  "callback_id": "feedback_form",
+  "title": { "type": "plain_text", "text": "Submit Feedback" },
+  "submit": { "type": "plain_text", "text": "Submit" },
+  "close": { "type": "plain_text", "text": "Cancel" },
+  "blocks": [
+    {
+      "type": "input",
+      "block_id": "category_block",
+      "label": { "type": "plain_text", "text": "Category" },
+      "element": {
+        "type": "static_select",
+        "action_id": "category_select",
+        "placeholder": { "type": "plain_text", "text": "Choose a category" },
+        "options": [
+          { "text": { "type": "plain_text", "text": "Bug Report" }, "value": "bug" },
+          { "text": { "type": "plain_text", "text": "Feature Request" }, "value": "feature" },
+          { "text": { "type": "plain_text", "text": "General Feedback" }, "value": "general" }
+        ]
+      }
+    },
+    {
+      "type": "input",
+      "block_id": "description_block",
+      "label": { "type": "plain_text", "text": "Description" },
+      "element": {
+        "type": "plain_text_input",
+        "action_id": "description_input",
+        "multiline": true,
+        "placeholder": { "type": "plain_text", "text": "Tell us more..." }
+      }
+    },
+    {
+      "type": "input",
+      "block_id": "urgency_block",
+      "label": { "type": "plain_text", "text": "Priority" },
+      "element": {
+        "type": "radio_buttons",
+        "action_id": "urgency_select",
+        "options": [
+          { "text": { "type": "plain_text", "text": "Low" }, "value": "low" },
+          { "text": { "type": "plain_text", "text": "Medium" }, "value": "medium" },
+          { "text": { "type": "plain_text", "text": "High" }, "value": "high" }
+        ]
+      },
+      "optional": true
+    }
+  ]
+}
+```
+
+**Customization points:** Title, callback_id, input types, options list, adding/removing input blocks.
+
+---
+
+## Notification Alert [M]
+
+An alert banner with description and timestamp context.
+
+```json
+{
+  "channel": "C0123456789",
+  "text": "Alert: Deployment failed for api-gateway",
+  "blocks": [
+    {
+      "type": "alert",
+      "text": { "type": "plain_text", "text": "Deployment failed for api-gateway" },
+      "level": "error"
+    },
+    {
+      "type": "section",
+      "text": {
+        "type": "mrkdwn",
+        "text": "The deployment to *production* failed during the health check phase.\n\n*Error:* `Connection timeout after 30s`\n*Commit:* `a1b2c3d`"
+      }
+    },
+    {
+      "type": "context",
+      "elements": [
+        {
+          "type": "mrkdwn",
+          "text": "Triggered by <@U0123456789> | <!date^1700000000^{date_short} at {time}|Nov 14, 2023>"
+        }
+      ]
+    },
+    {
+      "type": "actions",
+      "elements": [
+        {
+          "type": "button",
+          "text": { "type": "plain_text", "text": "View Logs" },
+          "url": "https://logs.example.com/deploy/456",
+          "action_id": "view_logs_btn"
+        },
+        {
+          "type": "button",
+          "text": { "type": "plain_text", "text": "Retry" },
+          "style": "primary",
+          "action_id": "retry_deploy_btn"
+        }
+      ]
+    }
+  ]
+}
+```
+
+**Customization points:** Level (`info`, `warning`, `error`, `success`), description text, action buttons.
+
+---
+
+## Dashboard Home Tab [H]
+
+A welcome dashboard with metrics fields and quick-action buttons.
+
+```json
+{
+  "type": "home",
+  "blocks": [
+    {
+      "type": "header",
+      "text": { "type": "plain_text", "text": "Welcome to AppName" }
+    },
+    {
+      "type": "section",
+      "text": { "type": "mrkdwn", "text": "Here's your overview for today:" }
+    },
+    {
+      "type": "section",
+      "fields": [
+        { "type": "mrkdwn", "text": "*Open Tickets:*\n12" },
+        { "type": "mrkdwn", "text": "*Resolved Today:*\n5" },
+        { "type": "mrkdwn", "text": "*Avg Response:*\n2.4 hrs" },
+        { "type": "mrkdwn", "text": "*SLA Status:*\n:white_check_mark: On Track" }
+      ]
+    },
+    { "type": "divider" },
+    {
+      "type": "actions",
+      "elements": [
+        {
+          "type": "button",
+          "text": { "type": "plain_text", "text": "New Ticket" },
+          "style": "primary",
+          "action_id": "new_ticket_btn"
+        },
+        {
+          "type": "button",
+          "text": { "type": "plain_text", "text": "My Queue" },
+          "action_id": "my_queue_btn"
+        },
+        {
+          "type": "button",
+          "text": { "type": "plain_text", "text": "Settings" },
+          "action_id": "settings_btn"
+        }
+      ]
+    }
+  ]
+}
+```
+
+**Customization points:** Metrics fields, action buttons, adding image blocks or additional sections.
+
+---
+
+## Confirmation with Dialog [M]
+
+An action button with a confirmation dialog attached (prevents accidental clicks).
+
+```json
+{
+  "channel": "C0123456789",
+  "text": "Server shutdown requested",
+  "blocks": [
+    {
+      "type": "section",
+      "text": { "type": "mrkdwn", "text": "Are you sure you want to shut down *prod-server-01*?" }
+    },
+    {
+      "type": "actions",
+      "elements": [
+        {
+          "type": "button",
+          "text": { "type": "plain_text", "text": "Shut Down" },
+          "style": "danger",
+          "action_id": "shutdown_btn",
+          "value": "prod-server-01",
+          "confirm": {
+            "title": { "type": "plain_text", "text": "Confirm Shutdown" },
+            "text": {
+              "type": "plain_text",
+              "text": "This will immediately terminate the server. Active connections will be dropped."
+            },
+            "confirm": { "type": "plain_text", "text": "Shut Down" },
+            "deny": { "type": "plain_text", "text": "Cancel" },
+            "style": "danger"
+          }
+        }
+      ]
+    }
+  ]
+}
+```
+
+**Customization points:** Confirmation title/text (title max 100 chars, text max 300 chars, confirm/deny max 30 chars), button style.
+
+---
+
+## Data Table [M]
+
+A structured table for displaying tabular data. Only one table block per message.
+
+```json
+{
+  "channel": "C0123456789",
+  "text": "Team sprint summary",
+  "blocks": [
+    {
+      "type": "header",
+      "text": { "type": "plain_text", "text": "Sprint Summary" }
+    },
+    {
+      "type": "table",
+      "column_settings": [{ "is_wrapped": true }, { "align": "center" }, { "align": "right" }],
+      "rows": [
+        [
+          { "type": "raw_text", "text": "Name" },
+          { "type": "raw_text", "text": "Status" },
+          { "type": "raw_text", "text": "Points" }
+        ],
+        [
+          { "type": "raw_text", "text": "Auth refactor" },
+          { "type": "raw_text", "text": "In Progress" },
+          { "type": "raw_text", "text": "5" }
+        ],
+        [
+          { "type": "raw_text", "text": "API docs update" },
+          { "type": "raw_text", "text": "Done" },
+          { "type": "raw_text", "text": "2" }
+        ],
+        [
+          { "type": "raw_text", "text": "Bug #1234" },
+          { "type": "raw_text", "text": "Blocked" },
+          { "type": "raw_text", "text": "3" }
+        ]
+      ]
+    }
+  ]
+}
+```
+
+**Customization points:** Column settings (alignment: `left`/`center`/`right`, wrapping: `is_wrapped`), row data, cell type (`raw_text` for plain content, `rich_text` for formatted content with links/emoji/mentions). Max 100 rows, max 20 cells per row. First row is the header. Only one table block per message.
+
+---
+
+## Settings Modal with Multiple Input Types [V]
+
+A modal combining different input types for a settings/preferences form.
+
+```json
+{
+  "type": "modal",
+  "callback_id": "settings_modal",
+  "title": { "type": "plain_text", "text": "Notification Settings" },
+  "submit": { "type": "plain_text", "text": "Save" },
+  "close": { "type": "plain_text", "text": "Cancel" },
+  "blocks": [
+    {
+      "type": "input",
+      "block_id": "channel_block",
+      "label": { "type": "plain_text", "text": "Notification Channel" },
+      "element": {
+        "type": "conversations_select",
+        "action_id": "channel_select",
+        "default_to_current_conversation": true
+      }
+    },
+    {
+      "type": "input",
+      "block_id": "frequency_block",
+      "label": { "type": "plain_text", "text": "Digest Frequency" },
+      "element": {
+        "type": "static_select",
+        "action_id": "frequency_select",
+        "options": [
+          { "text": { "type": "plain_text", "text": "Real-time" }, "value": "realtime" },
+          { "text": { "type": "plain_text", "text": "Hourly" }, "value": "hourly" },
+          { "text": { "type": "plain_text", "text": "Daily" }, "value": "daily" }
+        ],
+        "initial_option": { "text": { "type": "plain_text", "text": "Daily" }, "value": "daily" }
+      }
+    },
+    {
+      "type": "input",
+      "block_id": "events_block",
+      "label": { "type": "plain_text", "text": "Notify me about" },
+      "element": {
+        "type": "checkboxes",
+        "action_id": "events_checkboxes",
+        "options": [
+          { "text": { "type": "plain_text", "text": "New deployments" }, "value": "deploys" },
+          { "text": { "type": "plain_text", "text": "Failed builds" }, "value": "failures" },
+          { "text": { "type": "plain_text", "text": "PR reviews needed" }, "value": "reviews" }
+        ]
+      }
+    },
+    {
+      "type": "input",
+      "block_id": "quiet_hours_block",
+      "label": { "type": "plain_text", "text": "Quiet hours start" },
+      "element": {
+        "type": "timepicker",
+        "action_id": "quiet_start",
+        "initial_time": "22:00",
+        "placeholder": { "type": "plain_text", "text": "Select time" }
+      },
+      "optional": true
+    }
+  ]
+}
+```
+
+**Customization points:** Input types, options, initial values, adding `hint` text to inputs, marking fields as `optional`.

package/skills/slack/SKILL.md

@@ -17,4 +17,4 @@ Use the `message` tool with `channel: "slack"`. The tool schema lists the action
 - When multiple Slack accounts are configured, pass `accountId` rather than guessing.
 - Confirm destructive deletes when the target or intent is unclear.
 
-Slack formatting, mentions, tables, charts, and interactive controls are described automatically by the current `message` tool hints. Follow those hints instead of maintaining a second action or formatting catalog here.
+Slack formatting, mentions, and available actions are described automatically by the current `message` tool hints. Follow those hints instead of maintaining a second action catalog here.

package/dist/action-runtime.runtime-Dpa16J87.js

@@ -1,2 +0,0 @@
-import { t as handleSlackAction } from "./action-runtime-BoSeX09X.js";
-export { handleSlackAction };

package/dist/conversation-binding-route-DFVLUdYF.js

@@ -1,115 +0,0 @@
-import { a as parseSlackTarget } from "./target-parsing-BnMD2ZqZ.js";
-import "./targets-Cx5W_n3W.js";
-import { resolveConfiguredBindingRoute, resolveRuntimeConversationBindingRoute } from "openclaw/plugin-sdk/conversation-runtime";
-//#region extensions/slack/src/account-reply-mode.ts
-function normalizeSlackChatType(raw) {
-	const value = raw?.trim().toLowerCase();
-	if (!value) return;
-	if (value === "direct" || value === "dm") return "direct";
-	if (value === "group" || value === "channel") return value;
-}
-function resolveSlackReplyToMode(account, chatType) {
-	const normalized = normalizeSlackChatType(chatType ?? void 0);
-	if (normalized && account.replyToModeByChatType?.[normalized] !== void 0) return account.replyToModeByChatType[normalized] ?? "off";
-	return account.replyToMode ?? "off";
-}
-//#endregion
-//#region extensions/slack/src/conversation-binding-route.ts
-const slackRouteBindingConfigCache = /* @__PURE__ */ new WeakMap();
-function slackTargetDefaultKindForPeer(kind) {
-	return kind === "direct" ? "user" : "channel";
-}
-function slackTargetKindMatchesPeer(peerKind, targetKind) {
-	if (targetKind === "user") return peerKind === "direct";
-	return peerKind === "channel" || peerKind === "group";
-}
-function normalizeSlackRouteBindingPeer(peer) {
-	const rawId = peer.id.trim();
-	if (!rawId || rawId === "*") return peer;
-	const target = (() => {
-		try {
-			return parseSlackTarget(rawId, { defaultKind: slackTargetDefaultKindForPeer(peer.kind) });
-		} catch {
-			return;
-		}
-	})();
-	if (!target || !slackTargetKindMatchesPeer(peer.kind, target.kind)) return peer;
-	const normalizedId = target.teamId ? `team:${target.teamId}:${target.kind}:${target.id}` : target.id;
-	return normalizedId === peer.id ? peer : {
-		...peer,
-		id: normalizedId
-	};
-}
-function normalizeSlackRouteBindingConfig(cfg) {
-	const bindings = cfg.bindings;
-	const cached = slackRouteBindingConfigCache.get(cfg);
-	if (cached && cached.bindingsRef === bindings) return cached.normalizedCfg;
-	if (!Array.isArray(bindings)) return cfg;
-	let changed = false;
-	const normalizedBindings = bindings.map((binding) => {
-		if (binding.type === "acp" || binding.match.channel.trim().toLowerCase() !== "slack") return binding;
-		const peer = binding.match.peer;
-		if (!peer) return binding;
-		const normalizedPeer = normalizeSlackRouteBindingPeer(peer);
-		if (normalizedPeer === peer) return binding;
-		changed = true;
-		return {
-			...binding,
-			match: {
-				...binding.match,
-				peer: normalizedPeer
-			}
-		};
-	});
-	const normalizedCfg = changed ? {
-		...cfg,
-		bindings: normalizedBindings
-	} : cfg;
-	slackRouteBindingConfigCache.set(cfg, {
-		bindingsRef: bindings,
-		normalizedCfg
-	});
-	return normalizedCfg;
-}
-function resolveSlackConversationBindingRoute(params) {
-	const boundThreadRoute = params.bindingsEnabled && params.runtimeBindingThreadId ? resolveRuntimeConversationBindingRoute({
-		route: params.route,
-		touchBinding: params.touchBinding,
-		conversation: {
-			channel: "slack",
-			accountId: params.accountId,
-			conversationId: params.runtimeBindingThreadId,
-			parentConversationId: params.baseConversationId
-		}
-	}) : null;
-	const runtimeRoute = !params.bindingsEnabled ? {
-		bindingOwnerAvailable: true,
-		route: params.route,
-		bindingRecord: null,
-		boundSessionKey: void 0
-	} : boundThreadRoute?.boundSessionKey || boundThreadRoute?.bindingRecord ? boundThreadRoute : resolveRuntimeConversationBindingRoute({
-		route: params.route,
-		touchBinding: params.touchBinding,
-		conversation: {
-			channel: "slack",
-			accountId: params.accountId,
-			conversationId: params.baseConversationId
-		}
-	});
-	const configuredRoute = params.bindingsEnabled && !runtimeRoute.boundSessionKey && !runtimeRoute.bindingRecord ? resolveConfiguredBindingRoute({
-		cfg: params.cfg,
-		route: params.route,
-		conversation: {
-			channel: "slack",
-			accountId: params.accountId,
-			conversationId: params.baseConversationId
-		}
-	}) : null;
-	return {
-		runtimeRoute,
-		configuredRoute,
-		route: runtimeRoute.boundSessionKey ? runtimeRoute.route : configuredRoute?.route ?? params.route
-	};
-}
-//#endregion
-export { resolveSlackConversationBindingRoute as n, resolveSlackReplyToMode as r, normalizeSlackRouteBindingConfig as t };

package/dist/slack-client-kind-hSfjXyUM.js

@@ -1,94 +0,0 @@
-import { F as renderSlackBlockFallbackText } from "./group-policy-CU1tEGpS.js";
-import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { normalizeHostname } from "openclaw/plugin-sdk/host-runtime";
-import { fetchWithRuntimeDispatcher } from "openclaw/plugin-sdk/runtime-fetch";
-import { saveRemoteMedia } from "openclaw/plugin-sdk/media-runtime";
-//#region extensions/slack/src/monitor/block-text.ts
-function readSlackBlockType(block) {
-	return block && typeof block === "object" && !Array.isArray(block) ? block.type : void 0;
-}
-function hasSlackTableBlock(blocks) {
-	return blocks?.some((block) => readSlackBlockType(block) === "table") ?? false;
-}
-function hasSlackMessageTableBlock(message) {
-	return hasSlackTableBlock(message.blocks) || message.attachments?.some((attachment) => !isSlackUnfurlAttachment(attachment) && hasSlackTableBlock(attachment.blocks)) === true;
-}
-function isSlackUnfurlAttachment(attachment) {
-	return attachment.is_msg_unfurl === true || attachment.is_app_unfurl === true || typeof attachment.app_unfurl_url === "string" && attachment.app_unfurl_url.trim().length > 0;
-}
-function resolveSlackBlocksText(blocks) {
-	if (!blocks?.length) return;
-	const parts = [];
-	let hasRichText = false;
-	let hasNativeData = false;
-	for (const block of blocks) {
-		const blockType = readSlackBlockType(block);
-		hasRichText ||= blockType === "rich_text";
-		hasNativeData ||= blockType === "data_visualization" || blockType === "data_table" || blockType === "table";
-		const text = renderSlackBlockFallbackText(block, { nativeDataFormat: "plain" });
-		if (text) parts.push(text);
-	}
-	return parts.length > 0 ? {
-		text: parts.join("\n"),
-		hasRichText,
-		hasNativeData
-	} : void 0;
-}
-function appendDistinctSlackText(base, addition) {
-	if (!base) return addition;
-	const comparableBase = `\n${base.replace(/\r\n?/g, "\n")}\n`;
-	const comparableAddition = `\n${addition.replace(/\r\n?/g, "\n")}\n`;
-	if (comparableBase.includes(comparableAddition)) return base;
-	return `${base}\n${addition}`;
-}
-function resolveSlackAttachmentTableTexts(attachments) {
-	const seen = /* @__PURE__ */ new Set();
-	const texts = [];
-	for (const attachment of attachments ?? []) {
-		if (isSlackUnfurlAttachment(attachment)) continue;
-		for (const block of attachment.blocks ?? []) {
-			if (readSlackBlockType(block) !== "table") continue;
-			const text = renderSlackBlockFallbackText(block, { nativeDataFormat: "plain" });
-			if (!text || seen.has(text)) continue;
-			seen.add(text);
-			texts.push(text);
-		}
-	}
-	return texts;
-}
-/** Resolve agent-visible Slack text while admitting only native tables from attachments. */
-function resolveSlackMessageText(message, options = {}) {
-	let resolved = chooseSlackPrimaryText({
-		messageText: options.preserveMessageTextWhitespace ? typeof message.text === "string" && message.text.trim().length > 0 ? message.text : void 0 : normalizeOptionalString(message.text),
-		blocksText: resolveSlackBlocksText(message.blocks)
-	});
-	for (const tableText of resolveSlackAttachmentTableTexts(message.attachments)) resolved = appendDistinctSlackText(resolved, tableText);
-	return resolved;
-}
-function chooseSlackPrimaryText(params) {
-	const { messageText, blocksText } = params;
-	if (!blocksText) return messageText;
-	if (!messageText) return blocksText.text;
-	if (blocksText.hasNativeData) {
-		const comparableMessageText = messageText.replace(/\s+/g, " ").trim();
-		const comparableBlocksText = blocksText.text.replace(/\s+/g, " ").trim();
-		if (comparableMessageText.includes(comparableBlocksText)) return messageText;
-		return comparableBlocksText.startsWith(comparableMessageText) ? blocksText.text : `${messageText}\n${blocksText.text}`;
-	}
-	if (blocksText.hasRichText && blocksText.text.length > messageText.length) return blocksText.text;
-	return blocksText.text.length > messageText.length && blocksText.text.startsWith(messageText) ? blocksText.text : messageText;
-}
-//#endregion
-//#region extensions/slack/src/monitor/slack-client-kind.ts
-/** Detects the isolated GovSlack API plane without consulting mutable config. */
-function isGovSlackClient(client) {
-	if (!client?.slackApiUrl) return false;
-	try {
-		const apiUrl = new URL(client.slackApiUrl);
-		return apiUrl.protocol === "https:" && !apiUrl.port && normalizeHostname(apiUrl.hostname) === "slack-gov.com";
-	} catch {
-		return false;
-	}
-}
-//#endregion
-export { hasSlackTableBlock as a, resolveSlackMessageText as c, hasSlackMessageTableBlock as i, fetchWithRuntimeDispatcher as n, isSlackUnfurlAttachment as o, saveRemoteMedia as r, resolveSlackBlocksText as s, isGovSlackClient as t };