Skip to content

Commit 3d664a0

Browse files
zimegClaudeclaude
committed
refactor(methods): rename codeChannels examples to agents.conversations.*
Decision (2026-09-23): ship agents.conversations.* only — no legacy codeChannels.* method names. Renames methods/src/code_channels/ -> methods/src/agents/conversations/, updates each example's method call (client.agents_conversations_*), aligns args to the SDK #1943 signatures (getCanvas/setCanvasContent take channel, not channel_id), drops the rename example (agents.sessions.rename, covered by #201), and updates the manifest description + methods/README. The features.code_channels manifest feature and code_channels:manage scope are unchanged — only method names moved. Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com> Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 4f8922c commit 3d664a0

16 files changed

Lines changed: 30 additions & 52 deletions

‎methods/README.md‎

Lines changed: 9 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -18,22 +18,18 @@ $ slack run chat_post_message.py # Make the request
1818

1919
### agents
2020

21+
- **[agents.conversations.archive](https://docs.slack.dev/reference/methods/agents.conversations.archive)**: Archives a code channel, optionally recording a summary message on the channel. [Implementation](./src/agents/conversations/agents_conversations_archive.py).
22+
- **[agents.conversations.create](https://docs.slack.dev/reference/methods/agents.conversations.create)**: Creates a dedicated code channel for an agent session. [Implementation](./src/agents/conversations/agents_conversations_create.py).
23+
- **[agents.conversations.getCanvas](https://docs.slack.dev/reference/methods/agents.conversations.getCanvas)**: Fetches a canvas attached to a code channel — full content plus comment threads — in a single round-trip. [Implementation](./src/agents/conversations/agents_conversations_get_canvas.py).
24+
- **[agents.conversations.listViews](https://docs.slack.dev/reference/methods/agents.conversations.listViews)**: Lists the view tabs attached to a code channel. [Implementation](./src/agents/conversations/agents_conversations_list_views.py).
25+
- **[agents.conversations.removeView](https://docs.slack.dev/reference/methods/agents.conversations.removeView)**: Removes a view from a code channel. [Implementation](./src/agents/conversations/agents_conversations_remove_view.py).
26+
- **[agents.conversations.setCanvasContent](https://docs.slack.dev/reference/methods/agents.conversations.setCanvasContent)**: Replaces the full markdown content of a canvas attached to a code channel, preserving the comment threads on the sections your agent didn't change. [Implementation](./src/agents/conversations/agents_conversations_set_canvas_content.py).
27+
- **[agents.conversations.setCommands](https://docs.slack.dev/reference/methods/agents.conversations.setCommands)**: Registers the set of slash commands your agent offers in a code channel. [Implementation](./src/agents/conversations/agents_conversations_set_commands.py).
28+
- **[agents.conversations.setProperties](https://docs.slack.dev/reference/methods/agents.conversations.setProperties)**: Sets properties on a code channel: context bar items and external resource details. [Implementation](./src/agents/conversations/agents_conversations_set_properties.py).
29+
- **[agents.conversations.setView](https://docs.slack.dev/reference/methods/agents.conversations.setView)**: Creates or updates a view in a code channel. Views can render HTML, diffs, Block Kit, or canvases as tabs alongside the conversation. [Implementation](./src/agents/conversations/agents_conversations_set_view.py).
2130
- **[agents.sessions.rename](https://docs.slack.dev/reference/methods/agents.sessions.rename)**: Rename an agent session. [Implementation](./src/agents/sessions/agents_sessions_rename.py).
2231
- **[agents.sessions.setStatus](https://docs.slack.dev/reference/methods/agents.sessions.setStatus)**: Set an agent session's lifecycle status, creating the session if needed. [Implementation](./src/agents/sessions/agents_sessions_set_status.py).
2332

2433
### chat
2534

2635
- **[chat.postMessage](https://docs.slack.dev/reference/methods/chat.postmessage)**: Sends a message to a channel. [Implementation](./src/chat/chat_post_message.py).
27-
28-
### codeChannels
29-
30-
- **[codeChannels.archive](https://docs.slack.dev/reference/methods/codeChannels.archive)**: Archives a code channel, optionally recording a summary message on the channel. [Implementation](./src/code_channels/code_channels_archive.py).
31-
- **[codeChannels.create](https://docs.slack.dev/reference/methods/codeChannels.create)**: Creates a dedicated code channel for an agent session. [Implementation](./src/code_channels/code_channels_create.py).
32-
- **[codeChannels.getCanvas](https://docs.slack.dev/reference/methods/codeChannels.getCanvas)**: Fetches a canvas attached to a code channel — full content plus comment threads — in a single round-trip. [Implementation](./src/code_channels/code_channels_get_canvas.py).
33-
- **[codeChannels.listViews](https://docs.slack.dev/reference/methods/codeChannels.listViews)**: Lists the view tabs attached to a code channel. [Implementation](./src/code_channels/code_channels_list_views.py).
34-
- **[codeChannels.removeView](https://docs.slack.dev/reference/methods/codeChannels.removeView)**: Removes a view from a code channel. [Implementation](./src/code_channels/code_channels_remove_view.py).
35-
- **[codeChannels.rename](https://docs.slack.dev/reference/methods/codeChannels.rename)**: Renames a code channel. [Implementation](./src/code_channels/code_channels_rename.py).
36-
- **[codeChannels.setCanvasContent](https://docs.slack.dev/reference/methods/codeChannels.setCanvasContent)**: Replaces the full markdown content of a canvas attached to a code channel, preserving the comment threads on the sections your agent didn't change. [Implementation](./src/code_channels/code_channels_set_canvas_content.py).
37-
- **[codeChannels.setCommands](https://docs.slack.dev/reference/methods/codeChannels.setCommands)**: Registers the set of slash commands your agent offers in a code channel. [Implementation](./src/code_channels/code_channels_set_commands.py).
38-
- **[codeChannels.setProperties](https://docs.slack.dev/reference/methods/codeChannels.setProperties)**: Sets properties on a code channel: context bar items and external resource details. [Implementation](./src/code_channels/code_channels_set_properties.py).
39-
- **[codeChannels.setView](https://docs.slack.dev/reference/methods/codeChannels.setView)**: Creates or updates a view in a code channel. Views can render HTML, diffs, Block Kit, or canvases as tabs alongside the conversation. [Implementation](./src/code_channels/code_channels_set_view.py).
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

methods/src/code_channels/code_channels_archive.py renamed to methods/src/agents/conversations/agents_conversations_archive.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@
88
# Initialize
99
client = WebClient(token=token)
1010

11-
# Call the codeChannels.archive method
12-
response = client.codeChannels_archive(
11+
# Call the agents.conversations.archive method
12+
response = client.agents_conversations_archive(
1313
channel_id="C123ABC456",
1414
summary_message_ts="1717171717.123456",
1515
)

methods/src/code_channels/code_channels_create.py renamed to methods/src/agents/conversations/agents_conversations_create.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@
88
# Initialize
99
client = WebClient(token=token)
1010

11-
# Call the codeChannels.create method
12-
response = client.codeChannels_create(
11+
# Call the agents.conversations.create method
12+
response = client.agents_conversations_create(
1313
name="Fix flaky login test",
1414
origin_channel_id="C123ABC456",
1515
origin_message_ts="1717171717.123456",

methods/src/code_channels/code_channels_get_canvas.py renamed to methods/src/agents/conversations/agents_conversations_get_canvas.py

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@
88
# Initialize
99
client = WebClient(token=token)
1010

11-
# Call the codeChannels.getCanvas method
12-
response = client.codeChannels_getCanvas(
13-
channel_id="C123ABC456",
11+
# Call the agents.conversations.getCanvas method
12+
response = client.agents_conversations_getCanvas(
13+
channel="C123ABC456",
1414
canvas_id="F123ABC456",
1515
)
1616

methods/src/code_channels/code_channels_list_views.py renamed to methods/src/agents/conversations/agents_conversations_list_views.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@
88
# Initialize
99
client = WebClient(token=token)
1010

11-
# Call the codeChannels.listViews method
12-
response = client.codeChannels_listViews(
11+
# Call the agents.conversations.listViews method
12+
response = client.agents_conversations_listViews(
1313
channel_id="C123ABC456",
1414
)
1515

methods/src/code_channels/code_channels_remove_view.py renamed to methods/src/agents/conversations/agents_conversations_remove_view.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@
88
# Initialize
99
client = WebClient(token=token)
1010

11-
# Call the codeChannels.removeView method
12-
response = client.codeChannels_removeView(
11+
# Call the agents.conversations.removeView method
12+
response = client.agents_conversations_removeView(
1313
channel_id="C123ABC456",
1414
view_id="V123ABC456",
1515
)

0 commit comments

Comments
 (0)