@capybara-hq/plugin-slack 0.1.0-rc.4 → 0.1.0-rc.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.capybara-plugin/plugin.json +13 -56
- package/README.md +54 -76
- package/dist/index.mjs +334 -5
- package/guides/slack-app.md +243 -0
- package/guides/slack-app.zh.md +237 -0
- package/guides/slack-connector.md +113 -0
- package/guides/slack-connector.zh.md +107 -0
- package/package.json +1 -1
- package/app-manifest.connector.yaml +0 -52
- package/guides/app-manifest.socket.yaml.tmpl +0 -65
- package/guides/app-manifest.webhook.yaml.tmpl +0 -70
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@capybara-hq/plugin-slack",
|
|
3
|
-
"version": "0.1.0-rc.
|
|
3
|
+
"version": "0.1.0-rc.6",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"description": "Slack (channel@1 bot over Socket Mode with Block Kit cards, identity-source@1 Sign in with Slack, directory@1)",
|
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
# Slack app manifest for the Slack connector of the Capybara Slack plugin (connectors/slack.json).
|
|
2
|
-
# A separate internal app "Capybara connector": user scopes only, MCP on, no bot, no Socket Mode.
|
|
3
|
-
# Paste it at https://api.slack.com/apps -> Create New App -> From a manifest, in the company
|
|
4
|
-
# workspace, after replacing the redirect URL with <http.publicUrl>/api/v1/oauth/callback.
|
|
5
|
-
# Leave Manage Distribution off (internal app) and do not enable PKCE (see README.md).
|
|
6
|
-
# Reference: https://docs.slack.dev/reference/app-manifest and
|
|
7
|
-
# https://docs.slack.dev/ai/slack-mcp-server/ (checked 2026-11-08).
|
|
8
|
-
display_information:
|
|
9
|
-
name: Capybara connector
|
|
10
|
-
description: Lets Capybara agents use Slack as you, with your permission.
|
|
11
|
-
background_color: "#3d2f24"
|
|
12
|
-
oauth_config:
|
|
13
|
-
redirect_urls:
|
|
14
|
-
- https://capybara.example.com/api/v1/oauth/callback
|
|
15
|
-
scopes:
|
|
16
|
-
# The user scopes Slack's MCP server supports; the connector template asks for exactly these.
|
|
17
|
-
user:
|
|
18
|
-
- search:read.public
|
|
19
|
-
- search:read.private
|
|
20
|
-
- search:read.mpim
|
|
21
|
-
- search:read.im
|
|
22
|
-
- search:read.files
|
|
23
|
-
- search:read.users
|
|
24
|
-
- channels:history
|
|
25
|
-
- groups:history
|
|
26
|
-
- mpim:history
|
|
27
|
-
- im:history
|
|
28
|
-
- channels:read
|
|
29
|
-
- groups:read
|
|
30
|
-
- mpim:read
|
|
31
|
-
- im:read
|
|
32
|
-
- channels:write
|
|
33
|
-
- groups:write
|
|
34
|
-
- mpim:write
|
|
35
|
-
- im:write
|
|
36
|
-
- chat:write
|
|
37
|
-
- canvases:read
|
|
38
|
-
- canvases:write
|
|
39
|
-
- lists:read
|
|
40
|
-
- lists:write
|
|
41
|
-
- files:read
|
|
42
|
-
- files:write
|
|
43
|
-
- reactions:read
|
|
44
|
-
- reactions:write
|
|
45
|
-
- emoji:read
|
|
46
|
-
- users:read
|
|
47
|
-
- users:read.email
|
|
48
|
-
settings:
|
|
49
|
-
is_mcp_enabled: true
|
|
50
|
-
org_deploy_enabled: false # true for an Enterprise Grid org-wide install
|
|
51
|
-
socket_mode_enabled: false
|
|
52
|
-
token_rotation_enabled: false
|
|
@@ -1,65 +0,0 @@
|
|
|
1
|
-
# Slack app manifest for the Capybara Slack plugin (@capybara-hq/plugin-slack), Socket Mode (long connection).
|
|
2
|
-
# Capybara renders this file for a channel connection (setup guide "slack-app"); paste it at
|
|
3
|
-
# https://api.slack.com/apps -> Create New App -> From a manifest.
|
|
4
|
-
# Reference: https://docs.slack.dev/reference/app-manifest (checked 2026-11-09).
|
|
5
|
-
# Socket Mode needs no public request URL; the app-level token (xapp-, scope connections:write)
|
|
6
|
-
# is created separately under Basic Information -> App-Level Tokens.
|
|
7
|
-
display_information:
|
|
8
|
-
# Slack caps app names at 35 characters; shorten it in the app settings if it is longer.
|
|
9
|
-
name: "{{connectionName}}"
|
|
10
|
-
description: Chat with your organization's Capybara agents.
|
|
11
|
-
background_color: "#3d2f24"
|
|
12
|
-
features:
|
|
13
|
-
app_home:
|
|
14
|
-
home_tab_enabled: false
|
|
15
|
-
messages_tab_enabled: true
|
|
16
|
-
messages_tab_read_only_enabled: false
|
|
17
|
-
bot_user:
|
|
18
|
-
# Fixed: the bot user's name has the same 35-character cap, and a connection name may be longer.
|
|
19
|
-
display_name: capybara
|
|
20
|
-
always_online: true
|
|
21
|
-
# Slack rejects a message starting with an unregistered "/name", so the kernel's commands are
|
|
22
|
-
# registered here. The plugin turns each into the text the kernel parses: /new -> "/new",
|
|
23
|
-
# /env x -> "/env x", /capybara foo bar -> "/foo bar" (skill invocation).
|
|
24
|
-
slash_commands:
|
|
25
|
-
- command: /new
|
|
26
|
-
description: Start a new conversation (direct message)
|
|
27
|
-
should_escape: false
|
|
28
|
-
- command: /env
|
|
29
|
-
description: List or set your default environment (direct message)
|
|
30
|
-
usage_hint: "[name]"
|
|
31
|
-
should_escape: false
|
|
32
|
-
- command: /capybara
|
|
33
|
-
description: Run a skill
|
|
34
|
-
usage_hint: "<skill> [args]"
|
|
35
|
-
should_escape: false
|
|
36
|
-
oauth_config:
|
|
37
|
-
# Sign in with Slack (identity-source@1): <http.publicUrl>/api/v1/auth/sso/slack/callback. The
|
|
38
|
-
# sign-in flow requests openid / email / profile itself; they are not app scopes.
|
|
39
|
-
redirect_urls:
|
|
40
|
-
- "{{signInCallbackUrl}}"
|
|
41
|
-
scopes:
|
|
42
|
-
bot:
|
|
43
|
-
- chat:write # post and update replies and cards
|
|
44
|
-
- commands # slash commands /new, /env, /capybara
|
|
45
|
-
- im:write # conversations.open: tell the bot's own DM from other DMs a slash command runs in
|
|
46
|
-
- im:history # message.im: direct messages to the bot
|
|
47
|
-
- app_mentions:read # app_mention: @capybara in channels
|
|
48
|
-
- channels:history # message.channels: thread replies in public channels
|
|
49
|
-
- groups:history # message.groups: thread replies in private channels
|
|
50
|
-
- users:read # users.info (name, avatar, time zone, locale); team_join / user_change; users.list
|
|
51
|
-
- users:read.email # directory@1: email addresses in users.list (the bot itself does not use it)
|
|
52
|
-
settings:
|
|
53
|
-
event_subscriptions:
|
|
54
|
-
bot_events:
|
|
55
|
-
- message.im
|
|
56
|
-
- app_mention
|
|
57
|
-
- message.channels
|
|
58
|
-
- message.groups
|
|
59
|
-
- team_join
|
|
60
|
-
- user_change
|
|
61
|
-
interactivity:
|
|
62
|
-
is_enabled: true
|
|
63
|
-
socket_mode_enabled: true
|
|
64
|
-
org_deploy_enabled: false
|
|
65
|
-
token_rotation_enabled: false
|
|
@@ -1,70 +0,0 @@
|
|
|
1
|
-
# Slack app manifest for the Capybara Slack plugin (@capybara-hq/plugin-slack), webhook inbound mode.
|
|
2
|
-
# Capybara renders this file for a channel connection (setup guide "slack-app"); paste it at
|
|
3
|
-
# https://api.slack.com/apps -> Create New App -> From a manifest.
|
|
4
|
-
# Reference: https://docs.slack.dev/reference/app-manifest (checked 2026-11-09).
|
|
5
|
-
# Webhook mode: Slack posts events, card clicks and slash commands to the connection's webhook
|
|
6
|
-
# URL and verifies it when you save; requests are signed with the app's Signing Secret.
|
|
7
|
-
display_information:
|
|
8
|
-
# Slack caps app names at 35 characters; shorten it in the app settings if it is longer.
|
|
9
|
-
name: "{{connectionName}}"
|
|
10
|
-
description: Chat with your organization's Capybara agents.
|
|
11
|
-
background_color: "#3d2f24"
|
|
12
|
-
features:
|
|
13
|
-
app_home:
|
|
14
|
-
home_tab_enabled: false
|
|
15
|
-
messages_tab_enabled: true
|
|
16
|
-
messages_tab_read_only_enabled: false
|
|
17
|
-
bot_user:
|
|
18
|
-
# Fixed: the bot user's name has the same 35-character cap, and a connection name may be longer.
|
|
19
|
-
display_name: capybara
|
|
20
|
-
always_online: true
|
|
21
|
-
# Slack rejects a message starting with an unregistered "/name", so the kernel's commands are
|
|
22
|
-
# registered here. The plugin turns each into the text the kernel parses: /new -> "/new",
|
|
23
|
-
# /env x -> "/env x", /capybara foo bar -> "/foo bar" (skill invocation).
|
|
24
|
-
slash_commands:
|
|
25
|
-
- command: /new
|
|
26
|
-
url: "{{webhookUrl}}"
|
|
27
|
-
description: Start a new conversation (direct message)
|
|
28
|
-
should_escape: false
|
|
29
|
-
- command: /env
|
|
30
|
-
url: "{{webhookUrl}}"
|
|
31
|
-
description: List or set your default environment (direct message)
|
|
32
|
-
usage_hint: "[name]"
|
|
33
|
-
should_escape: false
|
|
34
|
-
- command: /capybara
|
|
35
|
-
url: "{{webhookUrl}}"
|
|
36
|
-
description: Run a skill
|
|
37
|
-
usage_hint: "<skill> [args]"
|
|
38
|
-
should_escape: false
|
|
39
|
-
oauth_config:
|
|
40
|
-
# Sign in with Slack (identity-source@1): <http.publicUrl>/api/v1/auth/sso/slack/callback. The
|
|
41
|
-
# sign-in flow requests openid / email / profile itself; they are not app scopes.
|
|
42
|
-
redirect_urls:
|
|
43
|
-
- "{{signInCallbackUrl}}"
|
|
44
|
-
scopes:
|
|
45
|
-
bot:
|
|
46
|
-
- chat:write # post and update replies and cards
|
|
47
|
-
- commands # slash commands /new, /env, /capybara
|
|
48
|
-
- im:write # conversations.open: tell the bot's own DM from other DMs a slash command runs in
|
|
49
|
-
- im:history # message.im: direct messages to the bot
|
|
50
|
-
- app_mentions:read # app_mention: @capybara in channels
|
|
51
|
-
- channels:history # message.channels: thread replies in public channels
|
|
52
|
-
- groups:history # message.groups: thread replies in private channels
|
|
53
|
-
- users:read # users.info (name, avatar, time zone, locale); team_join / user_change; users.list
|
|
54
|
-
- users:read.email # directory@1: email addresses in users.list (the bot itself does not use it)
|
|
55
|
-
settings:
|
|
56
|
-
event_subscriptions:
|
|
57
|
-
request_url: "{{webhookUrl}}"
|
|
58
|
-
bot_events:
|
|
59
|
-
- message.im
|
|
60
|
-
- app_mention
|
|
61
|
-
- message.channels
|
|
62
|
-
- message.groups
|
|
63
|
-
- team_join
|
|
64
|
-
- user_change
|
|
65
|
-
interactivity:
|
|
66
|
-
is_enabled: true
|
|
67
|
-
request_url: "{{webhookUrl}}"
|
|
68
|
-
socket_mode_enabled: false
|
|
69
|
-
org_deploy_enabled: false
|
|
70
|
-
token_rotation_enabled: false
|