@synap-core/workspace-templates 0.12.0 → 0.24.0

package/capabilities/slack.capability.json

@@ -0,0 +1,369 @@
+{
+  "apiVersion": "synap/v1",
+  "kind": "capability",
+  "meta": {
+    "slug": "slack",
+    "name": "Slack — Channels, People & Messages",
+    "description": "Slack workspace operations through one Nango OAuth connection (Slack Web API): list channels and users, read a channel's message history, inspect a channel/user/workspace, and post a message as the connected user. List verbs default their limit. Connect your Slack account to use it.",
+    "tags": [
+      "capability"
+    ],
+    "isPublic": true,
+    "syncByDefault": true
+  },
+  "spec": {
+    "key": "slack",
+    "name": "Slack — Channels, People & Messages",
+    "description": "Slack workspace operations through ONE Nango OAuth connection (Slack Web API). List the workspace's channels and members, read a channel's message history, inspect a channel / member / workspace, and POST a message as the connected user. PRECONDITION: the 'slack' integration must be declared + configured on the pod's Nango with providerConfigKey 'slack' and the bot/user token scopes channels:read, groups:read, channels:history, users:read and chat:write (add users:read.email to return member emails; add im:read, mpim:read and im:history to LIST and READ direct messages; add im:write to POST a direct message; slack_team_info additionally needs team:read), and the acting user must connect their Slack account via Connectors; the dispatcher resolves the most-recent slack connection automatically. Paths are RELATIVE to the Nango slack integration's base URL (slack.com/api) — no baseUrlOverride, so no provider-proxy-host allowlist entry is needed; Nango injects the bearer token. Reads (list/get) are GETs with query parameters and auto-run; the one write (slack_send_message) is a POST with a JSON body and routes through the capability-execution gate (which may auto-run or propose depending on the actor). NOTE: the Slack Web API answers application errors with HTTP 200 and {ok:false,error}, so every shaped result carries ok/error — a null/empty list with ok:false is a real failure (e.g. missing_scope, channel_not_found), NOT an empty workspace. Response-field shaping is best-effort and confirmed against the live API at first run.",
+    "params": [],
+    "vault": [],
+    "tools": [
+      {
+        "name": "slack",
+        "kind": "provider",
+        "description": "Slack Web API access through Nango. credentialRef nango://slack resolves the user's Slack connection (Connection-Id + Provider-Config-Key) and proxies to the integration's base URL (slack.com/api); Nango injects the bearer token.",
+        "credentialRef": "nango://slack",
+        "executor": "is-agent",
+        "config": {
+          "providerConfigKey": "slack"
+        }
+      }
+    ],
+    "skills": [
+      {
+        "name": "slack_list_channels",
+        "intent": "list_records",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Lists the workspace's channels (public + private by default; archived excluded). Args: { types?: string (default 'public_channel,private_channel'; add 'mpim'/'im' only with im:read/mpim:read), limit?: number (default 50, max 200), cursor?: string (from a prior nextCursor) }.",
+        "requires": [
+          "slack"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "types": "string?",
+          "limit": "number?",
+          "cursor": "string?"
+        },
+        "providerSpec": {
+          "tool": "slack",
+          "method": "GET",
+          "pathTemplate": "/conversations.list",
+          "query": {
+            "types": "{{types}}",
+            "exclude_archived": "true",
+            "limit": "{{limit}}",
+            "cursor": "{{cursor}}"
+          },
+          "paramMapping": {
+            "types": {
+              "default": "public_channel,private_channel"
+            },
+            "limit": {
+              "default": 50,
+              "clampMin": 1,
+              "clampMax": 200
+            }
+          },
+          "responseShape": {
+            "collectionPath": "channels",
+            "collectionAs": "channels",
+            "item": {
+              "id": "id",
+              "name": "name",
+              "isPrivate": "is_private",
+              "isArchived": "is_archived",
+              "isMember": "is_member",
+              "numMembers": "num_members",
+              "topic": "topic.value",
+              "purpose": "purpose.value",
+              "created": "created"
+            },
+            "scalar": {
+              "ok": "ok",
+              "error": "error",
+              "count": "@count",
+              "nextCursor": "response_metadata.next_cursor"
+            }
+          }
+        }
+      },
+      {
+        "name": "slack_get_channel",
+        "intent": "fetch_record",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Gets one channel's details (name, topic, purpose, member count, privacy/archive flags) by id. Args: { channel: string }.",
+        "requires": [
+          "slack"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "channel": "string"
+        },
+        "providerSpec": {
+          "tool": "slack",
+          "method": "GET",
+          "pathTemplate": "/conversations.info",
+          "query": {
+            "channel": "{{channel}}",
+            "include_num_members": "true"
+          },
+          "paramMapping": {
+            "channel": {
+              "required": true
+            }
+          },
+          "responseShape": {
+            "scalar": {
+              "ok": "ok",
+              "error": "error",
+              "id": "channel.id",
+              "name": "channel.name",
+              "isPrivate": "channel.is_private",
+              "isArchived": "channel.is_archived",
+              "isMember": "channel.is_member",
+              "numMembers": "channel.num_members",
+              "topic": "channel.topic.value",
+              "purpose": "channel.purpose.value",
+              "created": "channel.created"
+            }
+          }
+        }
+      },
+      {
+        "name": "slack_list_users",
+        "intent": "list_records",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Lists the workspace's members (id, handle, real name, display name, avatar, bot/deleted flags). Email is returned only with the users:read.email scope. Args: { limit?: number (default 50, max 200), cursor?: string (from a prior nextCursor) }.",
+        "requires": [
+          "slack"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "limit": "number?",
+          "cursor": "string?"
+        },
+        "providerSpec": {
+          "tool": "slack",
+          "method": "GET",
+          "pathTemplate": "/users.list",
+          "query": {
+            "limit": "{{limit}}",
+            "cursor": "{{cursor}}"
+          },
+          "paramMapping": {
+            "limit": {
+              "default": 50,
+              "clampMin": 1,
+              "clampMax": 200
+            }
+          },
+          "responseShape": {
+            "collectionPath": "members",
+            "collectionAs": "users",
+            "item": {
+              "id": "id",
+              "name": "name",
+              "realName": "real_name",
+              "displayName": "profile.display_name",
+              "email": "profile.email",
+              "avatar": "profile.image_72",
+              "tz": "tz",
+              "isBot": "is_bot",
+              "deleted": "deleted"
+            },
+            "scalar": {
+              "ok": "ok",
+              "error": "error",
+              "count": "@count",
+              "nextCursor": "response_metadata.next_cursor"
+            }
+          }
+        }
+      },
+      {
+        "name": "slack_get_user",
+        "intent": "fetch_record",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Gets one member's profile by id (handle, real name, display name, avatar, timezone, bot flag). Email is returned only with the users:read.email scope. Args: { user: string }.",
+        "requires": [
+          "slack"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "user": "string"
+        },
+        "providerSpec": {
+          "tool": "slack",
+          "method": "GET",
+          "pathTemplate": "/users.info",
+          "query": {
+            "user": "{{user}}"
+          },
+          "paramMapping": {
+            "user": {
+              "required": true
+            }
+          },
+          "responseShape": {
+            "scalar": {
+              "ok": "ok",
+              "error": "error",
+              "id": "user.id",
+              "name": "user.name",
+              "realName": "user.real_name",
+              "displayName": "user.profile.display_name",
+              "email": "user.profile.email",
+              "avatar": "user.profile.image_72",
+              "tz": "user.tz",
+              "isBot": "user.is_bot"
+            }
+          }
+        }
+      },
+      {
+        "name": "slack_list_messages",
+        "intent": "list_records",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Reads a channel's message history, newest first. Args: { channel: string, limit?: number (default 50, max 200), oldest?: string (Unix ts lower bound), latest?: string (Unix ts upper bound), cursor?: string (from a prior nextCursor) }.",
+        "requires": [
+          "slack"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "channel": "string",
+          "limit": "number?",
+          "oldest": "string?",
+          "latest": "string?",
+          "cursor": "string?"
+        },
+        "providerSpec": {
+          "tool": "slack",
+          "method": "GET",
+          "pathTemplate": "/conversations.history",
+          "query": {
+            "channel": "{{channel}}",
+            "limit": "{{limit}}",
+            "oldest": "{{oldest}}",
+            "latest": "{{latest}}",
+            "cursor": "{{cursor}}"
+          },
+          "paramMapping": {
+            "channel": {
+              "required": true
+            },
+            "limit": {
+              "default": 50,
+              "clampMin": 1,
+              "clampMax": 200
+            }
+          },
+          "responseShape": {
+            "collectionPath": "messages",
+            "collectionAs": "messages",
+            "item": {
+              "ts": "ts",
+              "user": "user",
+              "text": "text",
+              "type": "type",
+              "threadTs": "thread_ts",
+              "replyCount": "reply_count"
+            },
+            "scalar": {
+              "ok": "ok",
+              "error": "error",
+              "channel": "{{channel}}",
+              "count": "@count",
+              "hasMore": "has_more",
+              "nextCursor": "response_metadata.next_cursor"
+            }
+          }
+        }
+      },
+      {
+        "name": "slack_team_info",
+        "intent": "fetch_record",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Gets the connected workspace's identity (id, name, domain). Requires the team:read scope. Args: {}.",
+        "requires": [
+          "slack"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {},
+        "providerSpec": {
+          "tool": "slack",
+          "method": "GET",
+          "pathTemplate": "/team.info",
+          "responseShape": {
+            "scalar": {
+              "ok": "ok",
+              "error": "error",
+              "id": "team.id",
+              "name": "team.name",
+              "domain": "team.domain"
+            }
+          }
+        }
+      },
+      {
+        "name": "slack_send_message",
+        "intent": "send_message",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Posts a message to a channel (or a DM) as the connected user. Side-effecting write — routes through the capability-execution gate (may auto-run or propose). Args: { channel: string (channel id, or a member id for a DM), text: string }.",
+        "requires": [
+          "slack"
+        ],
+        "executionMode": "async",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "channel": "string",
+          "text": "string"
+        },
+        "providerSpec": {
+          "tool": "slack",
+          "method": "POST",
+          "pathTemplate": "/chat.postMessage",
+          "body": {
+            "channel": "{{channel}}",
+            "text": "{{text}}"
+          },
+          "paramMapping": {
+            "channel": {
+              "required": true
+            },
+            "text": {
+              "required": true
+            }
+          },
+          "responseShape": {
+            "scalar": {
+              "ok": "ok",
+              "error": "error",
+              "channel": "channel",
+              "ts": "ts",
+              "text": "message.text"
+            }
+          }
+        }
+      }
+    ],
+    "provides": [
+      "fetch_record",
+      "list_records",
+      "send_message"
+    ]
+  },
+  "dependencies": []
+}