feat(slack): add List sharing operation

Author: TheodoreSpeaks

apps/docs/content/docs/integrations/slack.mdx

@@ -1546,6 +1546,25 @@ Rename an existing Slack List.
 | --------- | ---- | ----------- |
 | `ok` | boolean | Whether Slack completed the operation |
 
+### Slack Lists Share List
+
+Grant users or channels access to a Slack List. Provide exactly one of userIds or channelIds. Read allows viewing, write allows editing, and owner grants ownership to users only; only a current owner can grant ownership.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `listId` | string | Yes | Slack List ID, from the List URL or Create List output |
+| `accessLevel` | string | Yes | Access to grant: read, write, or owner. Ownership can only be granted to users. |
+| `userIds` | json | No | Nonempty JSON array of Slack user IDs, e.g. \["U0123456789"\]. Omit channelIds. |
+| `channelIds` | json | No | Nonempty JSON array of Slack channel IDs, e.g. \["C0123456789"\]. Omit userIds. Supports read or write access. |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `ok` | boolean | Whether Slack completed the operation |
+
 ### Slack Lists List Items
 
 Read a page of Slack List rows and optionally its column schema. Pass nextCursor as cursor to continue; an empty nextCursor ends pagination.
@@ -2186,6 +2205,7 @@ Set the purpose (description) for a Slack channel (max 250 characters).
 
 Lists actions require a custom Slack bot and a paid Slack plan. **Manage Lists** is selected by default during bot setup. For an existing app, add `lists:read` and `lists:write` in Slack, reinstall it, then reconnect in Sim.
 
+- **Share List** grants access to users or channels. Choose **Share With**, enter a JSON array of Slack IDs, and select **Can view**, **Can edit**, or **Owner**. Ownership is for users only and requires the current owner. Creating a List does not automatically share it with your personal Slack account. See Slack's [sharing reference](https://docs.slack.dev/reference/methods/slackLists.access.set/).
 - Run **Read List Items** with **Include List Schema** enabled to get the column IDs used in `column_id`. Updates also need the row's `id` as `row_id`.
 - **Initial Fields** and **Cells** accept JSON arrays of typed values. Text uses `rich_text`; checkboxes use booleans. See Slack's [field formats](https://docs.slack.dev/reference/methods/slackLists.items.create/) for examples.
 - To read every row, pass `nextCursor` into **Cursor** until it is empty. **Archived Rows** reads archived rows instead of active rows.

apps/sim/blocks/blocks/slack-resources.test.ts

@@ -9,16 +9,17 @@ import { buildSlackManifest } from '@/triggers/slack/capabilities'
 const LIST_OPERATIONS = [
   ['create_list', 'slack_lists_create'],
   ['rename_list', 'slack_lists_update'],
+  ['share_list', 'slack_lists_access_set'],
   ['list_items', 'slack_lists_items_list'],
   ['get_list_item', 'slack_lists_items_info'],
   ['create_list_item', 'slack_lists_items_create'],
   ['update_list_items', 'slack_lists_items_update'],
   ['delete_list_item', 'slack_lists_items_delete'],
 ] as const
 
-function visibleFields(operation: string) {
+function visibleFields(operation: string, values: Record<string, unknown> = {}) {
   return getSlackV2ActionSubBlocks()
-    .filter((field) => evaluateSubBlockCondition(field.condition, { operation }))
+    .filter((field) => evaluateSubBlockCondition(field.condition, { operation, ...values }))
     .map((field) => field.id)
 }
 
@@ -27,6 +28,42 @@ function mapParams(params: Record<string, unknown>) {
 }
 
 describe('Slack List and Canvas operations', () => {
+  it('shares with only the selected recipient kind and defaults to view access', () => {
+    expect(
+      mapParams({
+        operation: 'share_list',
+        listCredentialId: 'bot',
+        listId: 'F1',
+        listShareUserIds: '["U1"]',
+        listShareChannelIds: 'stale invalid JSON',
+      })
+    ).toEqual({ credential: 'bot', listId: 'F1', accessLevel: 'read', userIds: ['U1'] })
+    expect(
+      mapParams({
+        operation: 'share_list',
+        listCredentialId: 'bot',
+        listId: 'F1',
+        listShareTarget: 'channels',
+        listAccessLevel: 'write',
+        listShareChannelIds: ['C1'],
+        listShareUserIds: 'stale invalid JSON',
+      })
+    ).toEqual({ credential: 'bot', listId: 'F1', accessLevel: 'write', channelIds: ['C1'] })
+    for (const [target, shown, hidden] of [
+      ['users', 'listShareUserIds', 'listShareChannelIds'],
+      ['channels', 'listShareChannelIds', 'listShareUserIds'],
+    ]) {
+      const fields = visibleFields('share_list', { listShareTarget: target })
+      expect(fields).toEqual(expect.arrayContaining(['listId', 'listAccessLevel', shown]))
+      expect(fields).not.toContain(hidden)
+    }
+    expect(() => mapParams({ operation: 'share_list', listShareUserIds: 'bad JSON' })).toThrow(
+      'User IDs'
+    )
+    expect(() => mapParams({ operation: 'share_list', listShareTarget: 'everyone' })).toThrow(
+      'Share With'
+    )
+  })
   it.each(LIST_OPERATIONS)('offers %s inside the Slack block using %s', (operationId, toolId) => {
     const operation = SlackV2Block.subBlocks.find((field) => field.id === 'operation')!
     const options =

apps/sim/blocks/blocks/slack.ts

@@ -30,6 +30,7 @@ const SLACK_V2_AGENT_OPERATIONS = [
 const SLACK_V2_LIST_OPERATIONS = [
   'create_list',
   'rename_list',
+  'share_list',
   'list_items',
   'get_list_item',
   'create_list_item',
@@ -3206,6 +3207,19 @@ function mapSlackListParams(params: Record<string, unknown>): Record<string, unk
     case 'rename_list':
       result.name = params.listName
       break
+    case 'share_list':
+      result.accessLevel = params.listAccessLevel ?? 'read'
+      switch (params.listShareTarget ?? 'users') {
+        case 'users':
+          result.userIds = parseOptionalJsonInput(params.listShareUserIds, 'User IDs')
+          break
+        case 'channels':
+          result.channelIds = parseOptionalJsonInput(params.listShareChannelIds, 'Channel IDs')
+          break
+        default:
+          throw new Error('Share With must be users or channels')
+      }
+      break
     case 'list_items':
       result.limit = parseOptionalNumberInput(params.listLimit, 'Page Size', {
         integer: true,
@@ -3272,6 +3286,7 @@ function getSlackV2ListSubBlocks(): SubBlockConfig[] {
         field: 'operation',
         value: [
           'rename_list',
+          'share_list',
           'list_items',
           'get_list_item',
           'create_list_item',
@@ -3280,6 +3295,57 @@ function getSlackV2ListSubBlocks(): SubBlockConfig[] {
         ],
       },
     },
+    {
+      id: 'listShareTarget',
+      title: 'Share With',
+      type: 'dropdown',
+      options: [
+        { label: 'Users', id: 'users' },
+        { label: 'Channels', id: 'channels' },
+      ],
+      value: () => 'users',
+      required: true,
+      condition: { field: 'operation', value: 'share_list' },
+    },
+    {
+      id: 'listShareUserIds',
+      title: 'User IDs',
+      type: 'code',
+      language: 'json',
+      placeholder: '["U0123456789"]',
+      required: true,
+      condition: {
+        field: 'operation',
+        value: 'share_list',
+        and: { field: 'listShareTarget', value: 'users' },
+      },
+    },
+    {
+      id: 'listShareChannelIds',
+      title: 'Channel IDs',
+      type: 'code',
+      language: 'json',
+      placeholder: '["C0123456789"]',
+      required: true,
+      condition: {
+        field: 'operation',
+        value: 'share_list',
+        and: { field: 'listShareTarget', value: 'channels' },
+      },
+    },
+    {
+      id: 'listAccessLevel',
+      title: 'Access Level',
+      type: 'dropdown',
+      options: [
+        { label: 'Can view', id: 'read' },
+        { label: 'Can edit', id: 'write' },
+        { label: 'Owner (users only)', id: 'owner' },
+      ],
+      value: () => 'read',
+      required: true,
+      condition: { field: 'operation', value: 'share_list' },
+    },
     {
       id: 'listName',
       title: 'Name',
@@ -3429,6 +3495,10 @@ export function getSlackV2OperationSentences() {
       { text: 'Rename list', field: 'listId', core: true },
       { text: 'to', field: 'listName' },
     ],
+    share_list: [
+      { text: 'Share list', field: 'listId', core: true },
+      { text: 'with', field: ['listShareUserIds', 'listShareChannelIds'], core: true },
+    ],
     list_items: [{ text: 'Read rows from', field: 'listId', core: true }],
     get_list_item: [
       { text: 'Read row', field: 'listItemId', core: true },
@@ -3549,6 +3619,7 @@ export const SlackV2Block: BlockConfig<SlackResponse> = {
         { label: 'Delete Canvas', id: 'delete_canvas' },
         { label: 'Create List', id: 'create_list' },
         { label: 'Rename List', id: 'rename_list' },
+        { label: 'Share List', id: 'share_list' },
         { label: 'Read List Items', id: 'list_items' },
         { label: 'Get List Item', id: 'get_list_item' },
         { label: 'Create List Item', id: 'create_list_item' },
@@ -3611,6 +3682,7 @@ export const SlackV2Block: BlockConfig<SlackResponse> = {
       'slack_delete_canvas',
       'slack_lists_create',
       'slack_lists_update',
+      'slack_lists_access_set',
       'slack_lists_items_list',
       'slack_lists_items_info',
       'slack_lists_items_create',
@@ -3638,6 +3710,8 @@ export const SlackV2Block: BlockConfig<SlackResponse> = {
             return 'slack_lists_create'
           case 'rename_list':
             return 'slack_lists_update'
+          case 'share_list':
+            return 'slack_lists_access_set'
           case 'list_items':
             return 'slack_lists_items_list'
           case 'get_list_item':
@@ -3696,6 +3770,13 @@ export const SlackV2Block: BlockConfig<SlackResponse> = {
     listId: { type: 'string', description: 'Slack List ID' },
     listItemId: { type: 'string', description: 'Slack row ID' },
     listName: { type: 'string', description: 'List name' },
+    listShareTarget: { type: 'string', description: 'Share with users or channels' },
+    listShareUserIds: { type: 'json', description: 'Slack user IDs to grant List access' },
+    listShareChannelIds: { type: 'json', description: 'Slack channel IDs to grant List access' },
+    listAccessLevel: {
+      type: 'string',
+      description: 'List access: read, write, or owner (users only)',
+    },
     listSchema: { type: 'json', description: 'Column definitions' },
     listInitialFields: { type: 'json', description: 'Initial typed cell values' },
     listCells: { type: 'json', description: 'Typed cell updates with row_id and column_id' },

apps/sim/tools/generated/tool-ids.ts

@@ -4765,6 +4765,7 @@ import {
   slackUpdateViewTool,
 } from '@/tools/slack'
 import {
+  slackListsAccessSetTool,
   slackListsCreateTool,
   slackListsItemsCreateTool,
   slackListsItemsDeleteTool,
@@ -7290,6 +7291,7 @@ export const tools: Record<string, ExecutableToolConfig> = {
   slack_set_suggested_prompts_v2: slackSetSuggestedPromptsV2Tool,
   slack_set_agent_session_status_v2: slackSetAgentSessionStatusV2Tool,
   slack_rename_agent_session_v2: slackRenameAgentSessionV2Tool,
+  slack_lists_access_set: slackListsAccessSetTool,
   slack_lists_create: slackListsCreateTool,
   slack_lists_update: slackListsUpdateTool,
   slack_lists_items_list: slackListsItemsListTool,

apps/sim/tools/generated/tool-metadata.ts

@@ -54,6 +54,7 @@ describe('Slack personal-token scope policy', () => {
   })
 
   it.each([
+    'slack_lists_access_set',
     'slack_lists_create',
     'slack_lists_update',
     'slack_lists_items_list',

apps/sim/tools/generated/tool-outputs.ts

@@ -0,0 +1,81 @@
+import { readSlackResponse } from '@/tools/slack/api'
+import type { SlackListsAccessSetParams, SlackListsOkResponse } from '@/tools/slack_lists/types'
+import { OK_OUTPUT } from '@/tools/slack_lists/types'
+import { slackListsHeaders } from '@/tools/slack_lists/utils'
+import { parseSlackListsJson, slackListAccessSchema } from '@/tools/slack_lists/validation'
+import type { ToolConfig } from '@/tools/types'
+
+export const slackListsAccessSetTool: ToolConfig<SlackListsAccessSetParams, SlackListsOkResponse> =
+  {
+    id: 'slack_lists_access_set',
+    name: 'Slack Lists Share List',
+    description:
+      'Grant users or channels access to a Slack List. Provide exactly one of userIds or channelIds. Read allows viewing, write allows editing, and owner grants ownership to users only; only a current owner can grant ownership.',
+    version: '1.0.0',
+    oauth: {
+      required: true,
+      provider: 'slack',
+      credentialKind: 'service-account',
+      requiredScopes: ['lists:write'],
+    },
+    params: {
+      accessToken: {
+        type: 'string',
+        required: true,
+        visibility: 'hidden',
+        description: 'Resolved custom Slack bot token',
+      },
+      listId: {
+        type: 'string',
+        required: true,
+        visibility: 'user-or-llm',
+        description: 'Slack List ID, from the List URL or Create List output',
+      },
+      accessLevel: {
+        type: 'string',
+        required: true,
+        visibility: 'user-or-llm',
+        description:
+          'Access to grant: read, write, or owner. Ownership can only be granted to users.',
+      },
+      userIds: {
+        type: 'json',
+        required: false,
+        visibility: 'user-or-llm',
+        description:
+          'Nonempty JSON array of Slack user IDs, e.g. ["U0123456789"]. Omit channelIds.',
+      },
+      channelIds: {
+        type: 'json',
+        required: false,
+        visibility: 'user-or-llm',
+        description:
+          'Nonempty JSON array of Slack channel IDs, e.g. ["C0123456789"]. Omit userIds. Supports read or write access.',
+      },
+    },
+    request: {
+      url: 'https://slack.com/api/slackLists.access.set',
+      method: 'POST',
+      headers: slackListsHeaders,
+      body: (params) =>
+        slackListAccessSchema.parse({
+          list_id: params.listId,
+          access_level: params.accessLevel,
+          user_ids: parseSlackListsJson(
+            params.userIds,
+            slackListAccessSchema.shape.user_ids,
+            'userIds'
+          ),
+          channel_ids: parseSlackListsJson(
+            params.channelIds,
+            slackListAccessSchema.shape.channel_ids,
+            'channelIds'
+          ),
+        }),
+    },
+    transformResponse: async (response) => {
+      await readSlackResponse(response)
+      return { success: true, output: { ok: true } }
+    },
+    outputs: { ok: OK_OUTPUT },
+  }

apps/sim/tools/registry.ts

@@ -1,3 +1,4 @@
+export { slackListsAccessSetTool } from '@/tools/slack_lists/access_set'
 export { slackListsCreateTool } from '@/tools/slack_lists/create'
 export { slackListsItemsCreateTool } from '@/tools/slack_lists/items_create'
 export { slackListsItemsDeleteTool } from '@/tools/slack_lists/items_delete'