@pipedream/slack_v2 0.8.0 → 1.0.0

package/actions/reply-to-a-message/reply-to-a-message.mjs

@@ -1,3 +1,4 @@
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 import common from "../common/send-message.mjs";
 
@@ -5,8 +6,15 @@ export default {
   ...common,
   key: "slack_v2-reply-to-a-message",
   name: "Reply to a Message Thread",
-  description: "Send a message as a threaded reply. See [postMessage](https://api.slack.com/methods/chat.postMessage) or [scheduleMessage](https://api.slack.com/methods/chat.scheduleMessage) docs here",
-  version: "0.2.6",
+  description:
+    "Send a message as a threaded reply to an existing message."
+    + " Use this when the reply should be nested under a specific message rather than posted"
+    + " as a new top-level message — for example, responding to a triggering event or"
+    + " continuing a discussion. Requires `thread_ts`, the parent message's timestamp"
+    + " (e.g. `1403051575.000407`); get it from **Get Channel History** or an incoming event's"
+    + " `ts` field. For a plain, non-threaded message use **Post Message** instead."
+    + " [See the documentation](https://api.slack.com/methods/chat.postMessage)",
+  version: "0.2.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -34,21 +42,14 @@ export default {
       ],
     },
     ...common.props,
-    replyToThread: {
-      ...common.props.replyToThread,
-      hidden: true,
-    },
     thread_ts: {
       propDefinition: [
         slack,
         "messageTs",
       ],
-    },
-    thread_broadcast: {
-      propDefinition: [
-        slack,
-        "thread_broadcast",
-      ],
+      label: "Thread Timestamp",
+      description: "The `ts` timestamp of the parent message to reply to (e.g., if triggering on new Slack messages, enter `{{event.ts}}`). Avoid using a reply's `ts` value; use its parent's instead. E.g., `1403051575.000407`.",
+      optional: false,
     },
   },
 };

package/actions/search/search.mjs

@@ -10,7 +10,7 @@ export default {
     + " Use **Get User Details** first to find your user ID for filtering by 'my' messages."
     + " Returns matching messages with channel context, timestamps, and permalinks."
     + " [See the documentation](https://api.slack.com/methods/assistant.search.context)",
-  version: "0.0.3",
+  version: "0.0.4",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/send-block-kit-message/send-block-kit-message.mjs

@@ -1,3 +1,4 @@
+// x-pd-ai: optimized
 import buildBlocks from "../common/build-blocks.mjs";
 import common from "../common/send-message.mjs";
 
@@ -7,7 +8,7 @@ export default {
   key: "slack_v2-send-block-kit-message",
   name: "Build and Send a Block Kit Message",
   description: "Configure custom blocks and send to a channel, group, or user. [See the documentation](https://api.slack.com/tools/block-kit-builder).",
-  version: "0.5.6",
+  version: "0.5.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/send-large-message/send-large-message.mjs

@@ -1,3 +1,4 @@
+// x-pd-ai: optimized
 import common from "../common/send-message.mjs";
 
 export default {
@@ -5,7 +6,7 @@ export default {
   key: "slack_v2-send-large-message",
   name: "Send a Large Message (3000+ characters)",
   description: "Send a large message (more than 3000 characters) to a channel, group or user. See [postMessage](https://api.slack.com/methods/chat.postMessage) or [scheduleMessage](https://api.slack.com/methods/chat.scheduleMessage) docs here",
-  version: "0.1.6",
+  version: "0.1.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/send-message/send-message.mjs

@@ -1,3 +1,4 @@
+// x-pd-ai: optimized
 import common from "../common/send-message.mjs";
 import constants from "../../common/constants.mjs";
 
@@ -6,7 +7,7 @@ export default {
   key: "slack_v2-send-message",
   name: "Send Message",
   description: "Send a message to a user, group, private channel or public channel. [See the documentation](https://api.slack.com/methods/chat.postMessage)",
-  version: "0.1.6",
+  version: "0.2.0",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -18,25 +19,14 @@ export default {
     channelType: {
       type: "string",
       label: "Channel Type",
-      description: "The type of channel to send to. User/Direct Message (im), Group (mpim), Private Channel or Public Channel",
-      async options() {
-        return constants.CHANNEL_TYPE_OPTIONS;
-      },
+      description: "The type of channel to send to: `Channels` (public or private), Group (`mpim`), or User/Direct Message (`im`). Informational only — it does not affect which value is accepted in Channel.",
+      options: constants.CHANNEL_TYPE_OPTIONS,
+      optional: true,
     },
     conversation: {
       propDefinition: [
         common.props.slack,
         "conversation",
-        (c) => ({
-          types: c.channelType === "Channels"
-            ? [
-              constants.CHANNEL_TYPE.PUBLIC,
-              constants.CHANNEL_TYPE.PRIVATE,
-            ]
-            : [
-              c.channelType,
-            ],
-        }),
       ],
     },
     text: {

package/actions/send-message-advanced/send-message-advanced.mjs

@@ -1,3 +1,5 @@
+// x-pd-ai: optimized
+import { ConfigurationError } from "@pipedream/platform";
 import common from "../common/send-message.mjs";
 import buildBlocks from "../common/build-blocks.mjs";
 
@@ -7,7 +9,7 @@ export default {
   key: "slack_v2-send-message-advanced",
   name: "Send Message (Advanced)",
   description: "Customize advanced settings and send a message to a channel, group or user. See [postMessage](https://api.slack.com/methods/chat.postMessage) or [scheduleMessage](https://api.slack.com/methods/chat.scheduleMessage) docs here",
-  version: "0.1.6",
+  version: "0.1.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -27,7 +29,8 @@ export default {
         common.props.slack,
         "text",
       ],
-      description: "If you're using `blocks`, this is used as a fallback string to display in notifications. If you aren't, this is the main body text of the message. It can be formatted as plain text, or with mrkdwn.",
+      description: "If you're using `blocks`, this is used as a fallback string to display in notifications. If you aren't, this is the main body text of the message. It can be formatted as plain text, or with mrkdwn. Required when no blocks are provided.",
+      optional: true,
     },
     mrkdwn: {
       propDefinition: [
@@ -65,11 +68,50 @@ export default {
   },
   async run({ $ }) {
     if (this.passArrayOrConfigure) {
-      this.blocks = await this.getGeneratedBlocks();  // set the blocks prop for common.run to use
+      const generated = await this.getGeneratedBlocks();
+      // Only override this.blocks when something was actually generated.
+      // When passArrayOrConfigure === "configure" but no section/context/linkButton
+      // props are filled, getGeneratedBlocks returns [] (empty array). An empty
+      // array is truthy so common.run would skip the text-block fallback and post
+      // with zero content. Checking length lets common.run fall back to a text
+      // block when the user configured no blocks.
+      this.blocks = generated?.length
+        ? generated
+        : undefined;
     }
+
+    const hasBlocks = (() => {
+      if (Array.isArray(this.blocks)) {
+        return this.blocks.length > 0;
+      }
+      if (typeof this.blocks === "string") {
+        if (!this.blocks.trim()) return false;
+        let parsed;
+        try {
+          parsed = JSON.parse(this.blocks);
+        } catch {
+          // Malformed JSON — let common.run's own JSON.parse surface the error.
+          return true;
+        }
+        if (!Array.isArray(parsed)) {
+          throw new ConfigurationError(
+            "`Blocks` must be a JSON array of Block Kit blocks, e.g. `[{\"type\":\"section\",\"text\":{\"type\":\"mrkdwn\",\"text\":\"Hello\"}}]`.",
+          );
+        }
+        return parsed.length > 0;
+      }
+      return Boolean(this.blocks);
+    })();
+
+    if (!this.text && !hasBlocks) {
+      throw new ConfigurationError(
+        "Provide `Text`, or configure at least one block (via `Blocks` or the block-builder props), before sending a message.",
+      );
+    }
+
     const resp = await common.run.call(this, {
       $,
-    });  // call common.run with the current context
+    });
     return resp;
   },
 };

package/actions/send-message-to-channel/send-message-to-channel.mjs

@@ -1,12 +1,18 @@
+// x-pd-ai: optimized
 import common from "../common/send-message.mjs";
-import constants from "../../common/constants.mjs";
 
 export default {
   ...common,
   key: "slack_v2-send-message-to-channel",
   name: "Send Message to Channel",
-  description: "Send a message to a public or private channel. [See the documentation](https://api.slack.com/methods/chat.postMessage)",
-  version: "0.1.6",
+  description:
+    "Send a message to a public or private channel."
+    + " Legacy, channel-only variant — prefer **Post Message** for new integrations: it"
+    + " covers channels, users, and groups from a single tool, and also supports threaded"
+    + " replies and unfurl settings. Use this tool only if a workflow specifically needs to"
+    + " target a channel exclusively, without the user/group support **Post Message** offers."
+    + " [See the documentation](https://api.slack.com/methods/chat.postMessage)",
+  version: "0.2.0",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -19,14 +25,8 @@ export default {
       propDefinition: [
         common.props.slack,
         "conversation",
-        () => ({
-          types: [
-            constants.CHANNEL_TYPE.PUBLIC,
-            constants.CHANNEL_TYPE.PRIVATE,
-          ],
-        }),
       ],
-      description: "Select a public or private channel",
+      description: "A public or private channel ID (e.g. `C1234567890`). Use **List Channels** to find valid IDs.",
     },
     text: {
       propDefinition: [

package/actions/send-message-to-user-or-group/send-message-to-user-or-group.mjs

@@ -1,5 +1,5 @@
+// x-pd-ai: optimized
 import common from "../common/send-message.mjs";
-import constants from "../../common/constants.mjs";
 import { ConfigurationError } from "@pipedream/platform";
 
 export default {
@@ -7,7 +7,7 @@ export default {
   key: "slack_v2-send-message-to-user-or-group",
   name: "Send Message to User or Group",
   description: "Send a message to a user or group. [See the documentation](https://api.slack.com/methods/chat.postMessage)",
-  version: "0.1.6",
+  version: "0.2.0",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -23,20 +23,15 @@ export default {
       ],
       type: "string[]",
       label: "Users",
-      description: "Select the user(s) to message",
+      description: "The user ID(s) to message (e.g. `U1234567890`). Use **Find User by Email** / **Find User by ID** to resolve an ID.",
       optional: true,
     },
     conversation: {
       propDefinition: [
         common.props.slack,
         "conversation",
-        () => ({
-          types: [
-            constants.CHANNEL_TYPE.MPIM,
-          ],
-        }),
       ],
-      description: "Select the group to message",
+      description: "The group DM conversation ID to message (e.g. `G1234567890`). Use **List Group Conversations** to find valid IDs.",
       optional: true,
     },
     text: {

package/actions/set-channel-description/set-channel-description.mjs

@@ -1,10 +1,11 @@
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-set-channel-description",
   name: "Set Channel Description",
   description: "Change the description or purpose of a channel. [See the documentation](https://api.slack.com/methods/conversations.setPurpose)",
-  version: "0.0.16",
+  version: "0.0.17",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/set-channel-topic/set-channel-topic.mjs

@@ -1,10 +1,11 @@
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-set-channel-topic",
   name: "Set Channel Topic",
   description: "Set the topic on a channel, specified by ID or by name — names are resolved automatically. [See the documentation](https://api.slack.com/methods/conversations.setTopic)",
-  version: "0.1.1",
+  version: "0.1.2",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/set-status/set-status.mjs

@@ -1,10 +1,11 @@
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-set-status",
   name: "Set Status",
   description: "Set the current status for a user. [See the documentation](https://api.slack.com/methods/users.profile.set)",
-  version: "0.0.15",
+  version: "0.0.16",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
@@ -24,7 +25,7 @@ export default {
         "icon_emoji",
       ],
       label: "Status Emoji",
-      description: "The emoji to display with the status",
+      description: "The emoji to display with the status, e.g. `fire` or `:fire:` — colons are optional, either form works.",
       optional: true,
     },
     statusExpiration: {
@@ -38,7 +39,7 @@ export default {
     const response = await this.slack.updateProfile({
       profile: {
         status_text: this.statusText,
-        status_emoji: this.statusEmoji && `:${this.statusEmoji}:`,
+        status_emoji: this.statusEmoji && `:${this.statusEmoji.replace(/^:|:$/g, "")}:`,
         status_expiration: this.statusExpiration
           && Math.floor(new Date(this.statusExpiration).getTime() / 1000),
       },

package/actions/update-group-members/update-group-members.mjs

@@ -1,10 +1,11 @@
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-update-group-members",
   name: "Update Group Members",
   description: "Update the list of users for a User Group. [See the documentation](https://api.slack.com/methods/usergroups.users.update)",
-  version: "0.0.16",
+  version: "0.0.17",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
@@ -26,7 +27,7 @@ export default {
       ],
       type: "string[]",
       label: "Users to Add",
-      description: "A list of encoded user IDs that represent the users to add to the group.",
+      description: "One or more user IDs to add to the group (e.g. `U1234567890`). Use **Find User by Email** or **List Users** to find valid IDs.",
       optional: true,
     },
     usersToRemove: {
@@ -36,7 +37,7 @@ export default {
       ],
       type: "string[]",
       label: "Users to Remove",
-      description: "A list of encoded user IDs that represent the users to remove from the group.",
+      description: "One or more user IDs to remove from the group (e.g. `U1234567890`). Use **Find User by Email** or **List Users** to find valid IDs.",
       optional: true,
     },
     team: {
@@ -45,7 +46,7 @@ export default {
         "team",
       ],
       optional: true,
-      description: "Encoded team id where the user group exists, required if org token is used.",
+      description: "The encoded team ID (e.g. `T1234567890`) where the user group exists. Required only if the connected token spans multiple teams (Enterprise Grid). Use **List Teams** to find valid IDs.",
     },
   },
   async run({ $ }) {

package/actions/update-message/update-message.mjs

@@ -1,10 +1,11 @@
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-update-message",
   name: "Update Message",
   description: "Update a message. [See the documentation](https://api.slack.com/methods/chat.update)",
-  version: "0.2.6",
+  version: "0.2.7",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
@@ -36,7 +37,7 @@ export default {
         slack,
         "as_user",
       ],
-      description: "Pass true to update the message as the authed user. Bot users in this context are considered authed users.",
+      description: "Pass `true` to update the message as the authenticated user (bot users are treated as the authed user here too). Pass `false` (default) to update using the bot token instead. Slack only allows editing a message posted by the same identity now attempting the edit — check the message's `user`/`bot_id` via **Get Channel History** first if unsure.",
     },
     attachments: {
       propDefinition: [

package/actions/update-profile/update-profile.mjs

@@ -1,3 +1,4 @@
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 import { ConfigurationError } from "@pipedream/platform";
 
@@ -5,7 +6,7 @@ export default {
   key: "slack_v2-update-profile",
   name: "Update Profile",
   description: "Update basic profile field such as name or title. [See the documentation](https://api.slack.com/methods/users.profile.set)",
-  version: "0.0.31",
+  version: "0.0.32",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
@@ -61,7 +62,7 @@ export default {
         slack,
         "user",
       ],
-      description: "ID of user to change. This argument may only be specified by admins on paid teams.",
+      description: "The ID of the user whose profile to update (e.g. `U1234567890`). Only admins on paid teams may update another user's profile — omit to update your own. Use **Find User by Email** or **List Users** to find valid IDs.",
       optional: true,
     },
   },

package/actions/upload-file/upload-file.mjs

@@ -1,3 +1,4 @@
+// x-pd-ai: optimized
 import {
   ConfigurationError, axios, getFileStreamAndMetadata,
 } from "@pipedream/platform";
@@ -8,7 +9,7 @@ export default {
   key: "slack_v2-upload-file",
   name: "Upload File",
   description: "Upload a file. [See the documentation](https://api.slack.com/messaging/files#uploading_files)",
-  version: "0.1.10",
+  version: "0.1.11",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -45,6 +46,10 @@ export default {
     },
   },
   async run({ $ }) {
+    // Accept a channel NAME as well as an ID — agents routinely pass the "#name" they read
+    // in the prompt, and completeUpload answers that with invalid_arguments.
+    const channelId = await this.slack.resolveChannelId(this.conversation);
+
     const {
       stream, metadata,
     } = await getFileStreamAndMetadata(this.content);
@@ -85,7 +90,7 @@ export default {
 
     // Complete the file upload process in Slack
     const completeUploadResponse = await this.slack.completeUpload({
-      channel_id: this.conversation,
+      channel_id: channelId,
       initial_comment: this.initialComment,
       files: [
         {

package/actions/verify-slack-signature/verify-slack-signature.mjs

@@ -1,11 +1,12 @@
+// x-pd-ai: optimized
 import crypto from "crypto";
 import slack from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-verify-slack-signature",
   name: "Verify Slack Signature",
-  description: "Verifying requests from Slack, slack signs its requests using a secret that's unique to your app. [See the documentation](https://api.slack.com/authentication/verifying-requests-from-slack)",
-  version: "0.0.5",
+  description: "Verifying requests from Slack, slack signs its requests using a secret that's unique to your app. `Request Body` must be the raw request body as a string (not a parsed object) — Slack computes its signature over the exact raw bytes it sent, so re-serializing a parsed object will not match. [See the documentation](https://api.slack.com/authentication/verifying-requests-from-slack)",
+  version: "1.0.0",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -31,7 +32,7 @@ export default {
       description: "Slack request timestamp (from X-Slack-Request-Timestamp header).",
     },
     requestBody: {
-      type: "any",
+      type: "string",
       label: "Request Body",
       description: "The body of the request to be verified.",
     },

package/common/constants.mjs

@@ -27,10 +27,26 @@ const CHANNEL_TYPE_OPTIONS = [
   },
 ];
 
+// Block Kit block-type literals used by build-blocks createBlock() branching.
+const BLOCK_TYPES = {
+  SECTION: "section",
+  CONTEXT: "context",
+  LINK_BUTTON: "link_button",
+};
+
+// Option values for the passArrayOrConfigure prop shared by build-blocks and
+// the concrete actions that spread it (send-block-kit-message, send-message-advanced).
+const PASS_ARRAY_OR_CONFIGURE_OPTIONS = {
+  ARRAY: "array",
+  CONFIGURE: "configure",
+};
+
 export default {
   MAX_RESOURCES,
   LIMIT,
   MAX_NAME_LOOKUP_PAGES,
   CHANNEL_TYPE,
   CHANNEL_TYPE_OPTIONS,
+  BLOCK_TYPES,
+  PASS_ARRAY_OR_CONFIGURE_OPTIONS,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/slack_v2",
-  "version": "0.8.0",
+  "version": "1.0.0",
   "description": "Pipedream Slack_v2 Components",
   "main": "slack_v2.app.mjs",
   "keywords": [
@@ -15,7 +15,7 @@
   },
   "dependencies": {
     "@pipedream/platform": "^3.2.5",
-    "@slack/web-api": "^7.9.0",
+    "@slack/web-api": "8.0.0",
     "async-retry": "^1.3.3",
     "lodash": "^4.18.1"
   }