@pipedream/slack_v2 0.7.0 → 1.0.0

package/actions/get-channel-history/get-channel-history.mjs

@@ -1,3 +1,4 @@
+// x-pd-ai: optimized
 import utils from "../../common/utils.mjs";
 import slack from "../../slack_v2.app.mjs";
 
@@ -5,16 +6,17 @@ export default {
   key: "slack_v2-get-channel-history",
   name: "Get Channel History",
   description:
-    "Read the recent message history from a specific channel."
+    "Read the recent message history from a specific channel or direct message (DM)."
     + " Accepts a channel ID or channel name (resolved automatically)."
-    + " Use this when you want to see a channel's latest messages — unlike **Search** which finds messages by keyword."
+    + " To read a DM, pass the other person's **user ID** (e.g. `U1234567890`) as the channel — pass your OWN user ID to read your conversation with yourself."
+    + " Use this when you want to see a channel's or DM's latest messages — unlike **Search** which finds messages by keyword."
     + " Returns messages with text, timestamps (ts), reactions, and user IDs."
     + " Message timestamps can be used with **Get Thread Replies**, **Edit Message**, and **Add Reaction**."
     + " **Pass `fields`** (e.g. `text,ts,user`) unless you need full message objects — raw Slack"
     + " messages carry blocks, attachments and edit metadata, so a busy channel can run to tens"
     + " of thousands of characters and be truncated before you see any of it."
     + " [See the documentation](https://api.slack.com/methods/conversations.history)",
-  version: "0.1.0",
+  version: "0.2.1",
   type: "action",
   annotations: {
     destructiveHint: false,
@@ -26,7 +28,7 @@ export default {
     channel: {
       type: "string",
       label: "Channel",
-      description: "Channel ID (e.g. `C1234567890`) or channel name (e.g. `general` or `#general`). Resolved automatically.",
+      description: "Channel ID (e.g. `C1234567890`) or channel name (e.g. `general` or `#general`). For a direct message, pass a user ID (e.g. `U1234567890`) — including your own, to read your self-DM. Resolved automatically.",
     },
     limit: {
       type: "integer",
@@ -38,13 +40,13 @@ export default {
     oldest: {
       type: "string",
       label: "Oldest",
-      description: "Only messages after this Unix timestamp. Inclusive.",
+      description: "Only return messages posted after this timestamp (inclusive), as a Slack timestamp, e.g. `1610000000.000000` (Unix epoch seconds, optionally with fractional microseconds).",
       optional: true,
     },
     latest: {
       type: "string",
       label: "Latest",
-      description: "Only messages before this Unix timestamp. Default: now.",
+      description: "Only return messages posted before this timestamp. Defaults to now. Same format as `Oldest`, e.g. `1610000000.000000`.",
       optional: true,
     },
     fields: {

package/actions/get-current-user/get-current-user.mjs

@@ -1,10 +1,11 @@
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-get-current-user",
   name: "Get Current User",
-  description: "Do NOT use for a plain \"who am I\" / \"what's my user ID\" question — call **Get User Details** for that; it answers the same question with a far smaller payload. Use this ONLY when you specifically need the full member profile: locale, timezone, presence/status, admin and owner flags, name variants, or workspace domain and enterprise metadata. Combines `auth.test`, `users.info`, `users.profile.get` and `team.info`. [See Slack API docs](https://api.slack.com/methods/auth.test).",
-  version: "0.0.5",
+  description: "Do NOT use for a plain \"who am I\" / \"what's my user ID\" question — call **Get User Details** for that; it answers the same question with a far smaller payload. Do NOT use to look up a DIFFERENT, specifically-identified user (by ID or email) — this only ever describes the authenticated caller; use **Find User by ID** / **Find User by Email** for someone else. Do NOT use to enumerate multiple teams/workspaces (e.g. Enterprise Grid) — use **List Teams** for that; this returns only the caller's own current team. Use this ONLY when you specifically need the full member profile: locale, timezone, presence/status, admin and owner flags, name variants, or workspace domain and enterprise metadata. Combines `auth.test`, `users.info`, `users.profile.get` and `team.info`. [See Slack API docs](https://api.slack.com/methods/auth.test).",
+  version: "0.0.7",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/get-file/get-file.mjs

@@ -1,11 +1,11 @@
-import constants from "../../common/constants.mjs";
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-get-file",
   name: "Get File",
   description: "Return information about a file. [See the documentation](https://api.slack.com/methods/files.info)",
-  version: "0.1.5",
+  version: "0.1.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -18,14 +18,7 @@ export default {
       propDefinition: [
         slack,
         "conversation",
-        () => ({
-          types: [
-            constants.CHANNEL_TYPE.PUBLIC,
-            constants.CHANNEL_TYPE.PRIVATE,
-          ],
-        }),
       ],
-      description: "Select a public or private channel",
     },
     addToChannel: {
       propDefinition: [
@@ -37,9 +30,6 @@ export default {
       propDefinition: [
         slack,
         "file",
-        (c) => ({
-          channel: c.conversation,
-        }),
       ],
     },
   },

package/actions/get-thread-replies/get-thread-replies.mjs

@@ -1,3 +1,4 @@
+// x-pd-ai: optimized
 import utils from "../../common/utils.mjs";
 import slack from "../../slack_v2.app.mjs";
 
@@ -13,7 +14,7 @@ export default {
     + " Slack messages carry blocks, attachments and edit metadata, so a long thread can run"
     + " to tens of thousands of characters and be truncated before you see any of it."
     + " [See the documentation](https://api.slack.com/methods/conversations.replies)",
-  version: "0.1.0",
+  version: "0.1.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/get-user-details/get-user-details.mjs

@@ -1,3 +1,4 @@
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 
 export default {
@@ -13,7 +14,7 @@ export default {
     + " Prefer this over **Get Current User**, which returns a much larger payload and is only"
     + " needed for full profile detail (locale, status, admin flags)."
     + " [See the documentation](https://api.slack.com/methods/auth.test)",
-  version: "0.0.2",
+  version: "0.0.4",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/invite-user-to-channel/invite-user-to-channel.mjs

@@ -1,3 +1,4 @@
+// x-pd-ai: optimized
 import { ConfigurationError } from "@pipedream/platform";
 import slack from "../../slack_v2.app.mjs";
 
@@ -5,7 +6,7 @@ export default {
   key: "slack_v2-invite-user-to-channel",
   name: "Invite User to Channel",
   description: "Invite one or more users to an existing channel. Accepts a channel ID or NAME, and a user ID, EMAIL address or display name — all resolved automatically. Pass several users as a comma-separated list. [See the documentation](https://api.slack.com/methods/conversations.invite)",
-  version: "0.1.0",
+  version: "0.1.2",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/kick-user/kick-user.mjs

@@ -1,11 +1,11 @@
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
-import constants from "../../common/constants.mjs";
 
 export default {
   key: "slack_v2-kick-user",
   name: "Kick User",
   description: "Remove a user from a conversation. [See the documentation](https://api.slack.com/methods/conversations.kick)",
-  version: "0.0.30",
+  version: "0.0.32",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
@@ -18,22 +18,12 @@ export default {
       propDefinition: [
         slack,
         "conversation",
-        () => ({
-          types: [
-            constants.CHANNEL_TYPE.PUBLIC,
-            constants.CHANNEL_TYPE.PRIVATE,
-            constants.CHANNEL_TYPE.MPIM,
-          ],
-        }),
       ],
     },
     user: {
       propDefinition: [
         slack,
         "user",
-        (c) => ({
-          channelId: c.conversation,
-        }),
       ],
     },
   },

package/actions/list-channels/list-channels.mjs

@@ -1,3 +1,4 @@
+// x-pd-ai: optimized
 import utils from "../../common/utils.mjs";
 import slack from "../../slack_v2.app.mjs";
 
@@ -6,15 +7,16 @@ export default {
   name: "List Channels",
   description:
     "Return a list of channels in a workspace."
-    + " **Always pass `fields`** with just the properties you need (e.g. `id,name`) —"
-    + " a full channel object is ~1KB, so a workspace of any real size returns a payload"
-    + " large enough to be truncated before you ever see it. `id,name` covers most tasks;"
-    + " every other tool here accepts a channel NAME and resolves it, so you rarely need more."
+    + " Pass `fields` (e.g. `[\"id\",\"name\"]`) to limit the returned properties —"
+    + " a full channel object is ~1KB, so a workspace of any real size can return a payload"
+    + " large enough to be truncated. Omit `fields` when you need the complete channel objects."
+    + " Use `namePrefix` to filter results to channels whose names start with a given string"
+    + " (e.g. `dev-`) without a client-side filter loop."
     + " Returns `has_more: true` and `next_cursor` when more channels exist than were"
     + " fetched — when you see that, raise `numPages` (or pass `cursor`) before answering"
     + " any 'how many' or 'list every' question, otherwise your answer is silently incomplete."
     + " [See the documentation](https://api.slack.com/methods/conversations.list)",
-  version: "0.2.0",
+  version: "0.3.0",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -26,7 +28,7 @@ export default {
     channelTypes: {
       type: "string",
       label: "Channel Types",
-      description: "The types of channels to list. Select `public` for public channels only, `private` for private channels only, or `all` for both public and private channels.",
+      description: "Which channel types to list. Pass `public_channel` for public channels only, `private_channel` for private channels only, or `public_channel,private_channel` for both (default).",
       options: [
         {
           label: "Public Channels",
@@ -66,9 +68,15 @@ export default {
       ],
     },
     cursor: {
+      propDefinition: [
+        slack,
+        "cursor",
+      ],
+    },
+    namePrefix: {
       type: "string",
-      label: "Cursor",
-      description: "Resume from a previous call's `next_cursor` to fetch the following page.",
+      label: "Name Prefix",
+      description: "Return only channels whose names start with this prefix (case-insensitive). Example: `dev-`. When set, ALL pages are fetched regardless of `Number of Pages` so the filter is applied across the full workspace channel list.",
       optional: true,
     },
   },
@@ -85,15 +93,26 @@ export default {
     let page = 0;
     let nextCursor;
 
+    // namePrefix filters each page as it arrives (rather than accumulating the full
+    // workspace and filtering once at the end) so memory stays bounded by the match
+    // count, not the workspace size, on large workspaces.
+    const prefix = this.namePrefix?.toLowerCase();
+
     do {
       const {
         channels, response_metadata: metadata,
       } = await this.slack.conversationsList(params);
-      allChannels.push(...channels);
+      const pageChannels = prefix
+        ? channels.filter((c) => c.name?.toLowerCase().startsWith(prefix))
+        : channels;
+      allChannels.push(...pageChannels);
       nextCursor = metadata?.next_cursor;
       params.cursor = nextCursor;
       page++;
-    } while (params.cursor && page < this.numPages);
+    // When namePrefix is active, fetch ALL pages so the filter can be applied
+    // across the full workspace channel list — matching channels may live on
+    // any page and would be silently missing if capped at numPages.
+    } while (params.cursor && (this.namePrefix || page < this.numPages));
 
     // `fields` is ADDITIVE: omitted returns exactly what this action has always
     // returned, so existing workflows are unaffected. Supplied, it plucks per channel —

package/actions/list-emojis/list-emojis.mjs

@@ -1,3 +1,4 @@
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 
 export default {
@@ -5,7 +6,7 @@ export default {
   name: "List Emojis",
   description:
     "List all available emojis in the Slack workspace. Optionally include emoji image URLs. [See the documentation](https://api.slack.com/methods/emoji.list)",
-  version: "0.0.4",
+  version: "0.0.6",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-files/list-files.mjs

@@ -1,11 +1,11 @@
-import constants from "../../common/constants.mjs";
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-list-files",
   name: "List Files",
   description: "Return a list of files within a team. [See the documentation](https://api.slack.com/methods/files.list)",
-  version: "0.1.5",
+  version: "0.1.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -18,14 +18,7 @@ export default {
       propDefinition: [
         slack,
         "conversation",
-        () => ({
-          types: [
-            constants.CHANNEL_TYPE.PUBLIC,
-            constants.CHANNEL_TYPE.PRIVATE,
-          ],
-        }),
       ],
-      description: "Select a public or private channel",
     },
     addToChannel: {
       propDefinition: [
@@ -61,15 +54,17 @@ export default {
     },
   },
   async run({ $ }) {
+    const channel = await this.slack.resolveChannelId(this.conversation);
+
     if (this.addToChannel) {
       await this.slack.maybeAddAppToChannels([
-        this.conversation,
+        channel,
       ]);
     }
 
     const allFiles = [];
     const params = {
-      channel: this.conversation,
+      channel,
       user: this.user,
       team_id: this.team_id,
       page: 1,

package/actions/list-group-conversations/list-group-conversations.mjs

@@ -0,0 +1,86 @@
+// x-pd-ai: optimized
+import slack from "../../slack_v2.app.mjs";
+
+export default {
+  key: "slack_v2-list-group-conversations",
+  name: "List Group Conversations",
+  description:
+    "Return a list of multi-person direct message (group DM) conversations the connected"
+    + " account is a member of. Use the returned `id` (e.g. `G1234567890`) wherever a Group"
+    + " conversation ID is required."
+    + " Returns `has_more: true` and `next_cursor` when more conversations exist than were"
+    + " fetched — raise `numPages` (or pass `cursor`) to see the rest."
+    + " [See the documentation](https://api.slack.com/methods/conversations.list)",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  type: "action",
+  props: {
+    slack,
+    pageSize: {
+      propDefinition: [
+        slack,
+        "pageSize",
+      ],
+    },
+    numPages: {
+      propDefinition: [
+        slack,
+        "numPages",
+      ],
+    },
+    cursor: {
+      propDefinition: [
+        slack,
+        "cursor",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const groups = [];
+    const params = {
+      types: "mpim",
+      limit: this.pageSize,
+      cursor: this.cursor,
+    };
+    let page = 0;
+    let nextCursor;
+
+    do {
+      const {
+        channels, response_metadata: metadata,
+      } = await this.slack.conversationsList(params);
+      groups.push(...channels.map(({
+        id, purpose, is_archived: isArchived,
+      }) => ({
+        id,
+        purpose: purpose?.value,
+        is_archived: isArchived,
+      })));
+      nextCursor = metadata?.next_cursor;
+      params.cursor = nextCursor;
+      page++;
+    } while (params.cursor && page < this.numPages);
+
+    const hasMore = Boolean(nextCursor);
+
+    $.export("$summary", `Successfully found ${groups.length} group conversation${groups.length === 1
+      ? ""
+      : "s"}${hasMore
+      ? " (more available — raise Number of Pages or pass the cursor)"
+      : ""}`);
+
+    return {
+      groups,
+      has_more: hasMore,
+      ...(hasMore
+        ? {
+          next_cursor: nextCursor,
+        }
+        : {}),
+    };
+  },
+};

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

@@ -1,10 +1,11 @@
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-list-group-members",
   name: "List Group Members",
   description: "List all users in a User Group. [See the documentation](https://api.slack.com/methods/usergroups.users.list)",
-  version: "0.0.14",
+  version: "0.0.16",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -25,7 +26,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.",
     },
     pageSize: {
       propDefinition: [

package/actions/list-icon-emoji-options/list-icon-emoji-options.mjs

@@ -1,10 +1,11 @@
+// x-pd-ai: optimized
 import slack_v2 from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-list-icon-emoji-options",
   name: "List Icon (emoji) Options",
-  description: "Retrieves available options for the Icon (emoji) field.",
-  version: "0.0.2",
+  description: "Retrieves available options for the Icon (emoji) field. [See the documentation](https://api.slack.com/methods/emoji.list)",
+  version: "0.0.4",
   type: "action",
   annotations: {
     destructiveHint: false,
@@ -15,7 +16,9 @@ export default {
     slack_v2,
   },
   async run({ $ }) {
-    const options = await slack_v2.propDefinitions.icon_emoji.options.call(this.slack_v2);
+    const options = await this.slack_v2.getCustomEmojis({
+      throwRateLimitError: true,
+    });
     $.export("$summary", `Successfully retrieved ${options.length} option${options.length === 1
       ? ""
       : "s"}`);

package/actions/list-members-in-channel/list-members-in-channel.mjs

@@ -1,10 +1,11 @@
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-list-members-in-channel",
   name: "List Members in Channel",
   description: "Retrieve members of a channel. Accepts a channel ID or NAME (e.g. general or #general) — names are resolved automatically. [See the documentation](https://api.slack.com/methods/conversations.members)",
-  version: "0.1.0",
+  version: "0.1.2",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-messages/list-messages.mjs

@@ -1,11 +1,16 @@
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-list-messages",
-  name: "List Messages",
+  name: "List Messages (Deprecated)",
   description:
-    "Retrieve messages from a Slack conversation, including reactions. [See the documentation](https://api.slack.com/methods/conversations.history)",
-  version: "0.0.5",
+    "DEPRECATED — do NOT use for reading a channel's or DM's messages. Use **Get Channel History** instead:"
+    + " it resolves channel names, channel IDs, and direct messages (by user ID), supports `fields`"
+    + " selection to keep responses small, and returns the same message data."
+    + " This legacy tool remains only for existing workflows: it accepts a raw conversation ID and"
+    + " returns full, untrimmed message objects. [See the documentation](https://api.slack.com/methods/conversations.history)",
+  version: "0.0.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-reminder-options/list-reminder-options.mjs

@@ -1,10 +1,11 @@
+// x-pd-ai: optimized
 import slack_v2 from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-list-reminder-options",
   name: "List Reminder Options",
-  description: "Retrieves available options for the Reminder field.",
-  version: "0.0.2",
+  description: "Retrieves available options for the Reminder field. [See the documentation](https://docs.slack.dev/reference/methods/reminders.list)",
+  version: "0.0.4",
   type: "action",
   annotations: {
     destructiveHint: false,
@@ -15,7 +16,13 @@ export default {
     slack_v2,
   },
   async run({ $ }) {
-    const options = await slack_v2.propDefinitions.reminder.options.call(this.slack_v2);
+    const { reminders } = await this.slack_v2.remindersList({
+      throwRateLimitError: true,
+    });
+    const options = reminders.map((r) => ({
+      label: r.text,
+      value: r.id,
+    }));
     $.export("$summary", `Successfully retrieved ${options.length} option${options.length === 1
       ? ""
       : "s"}`);

package/actions/list-replies/list-replies.mjs

@@ -1,11 +1,11 @@
-import constants from "../../common/constants.mjs";
+// x-pd-ai: optimized
 import slack from "../../slack_v2.app.mjs";
 
 export default {
   key: "slack_v2-list-replies",
   name: "List Replies",
   description: "Retrieve a thread of messages posted to a conversation. [See the documentation](https://api.slack.com/methods/conversations.replies)",
-  version: "0.0.30",
+  version: "0.0.32",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -18,14 +18,7 @@ export default {
       propDefinition: [
         slack,
         "conversation",
-        () => ({
-          types: [
-            constants.CHANNEL_TYPE.PUBLIC,
-            constants.CHANNEL_TYPE.PRIVATE,
-          ],
-        }),
       ],
-      description: "Select a public or private channel",
     },
     timestamp: {
       propDefinition: [

package/actions/list-teams/list-teams.mjs

@@ -0,0 +1,88 @@
+// x-pd-ai: optimized
+import slack from "../../slack_v2.app.mjs";
+
+export default {
+  key: "slack_v2-list-teams",
+  name: "List Teams",
+  description:
+    "Return the full list of teams (workspaces) accessible to the connected account,"
+    + " with pagination (`has_more`/`next_cursor`) so you know whether there could be more"
+    + " than what came back. Use this — not **Get User Details** or **Get Current User**, which"
+    + " only ever describe the caller's single current team — whenever the task asks to"
+    + " enumerate, count, or check for multiple teams/workspaces, especially on an"
+    + " Enterprise Grid org-wide token. Use the returned `id` (e.g. `T1234567890`)"
+    + " wherever a Team ID is required."
+    + " Returns `has_more: true` and `next_cursor` when more teams exist than were"
+    + " fetched — raise `numPages` (or pass `cursor`) to see the rest."
+    + " [See the documentation](https://api.slack.com/methods/auth.teams.list)",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  type: "action",
+  props: {
+    slack,
+    pageSize: {
+      propDefinition: [
+        slack,
+        "pageSize",
+      ],
+    },
+    numPages: {
+      propDefinition: [
+        slack,
+        "numPages",
+      ],
+    },
+    cursor: {
+      propDefinition: [
+        slack,
+        "cursor",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const teams = [];
+    const params = {
+      limit: this.pageSize,
+      cursor: this.cursor,
+    };
+    let page = 0;
+    let nextCursor;
+
+    do {
+      const {
+        teams: fetched, response_metadata: metadata,
+      } = await this.slack.authTeamsList(params);
+      teams.push(...fetched.map(({
+        id, name,
+      }) => ({
+        id,
+        name,
+      })));
+      nextCursor = metadata?.next_cursor;
+      params.cursor = nextCursor;
+      page++;
+    } while (params.cursor && page < this.numPages);
+
+    const hasMore = Boolean(nextCursor);
+
+    $.export("$summary", `Successfully found ${teams.length} team${teams.length === 1
+      ? ""
+      : "s"}${hasMore
+      ? " (more available — raise Number of Pages or pass the cursor)"
+      : ""}`);
+
+    return {
+      teams,
+      has_more: hasMore,
+      ...(hasMore
+        ? {
+          next_cursor: nextCursor,
+        }
+        : {}),
+    };
+  },
+};