feat(methods): add agents.conversations method examples (#194)

Author: zimeg

methods/README.md

@@ -18,6 +18,15 @@ $ slack run chat_post_message.py  # Make the request
 
 ### agents
 
+- **[agents.conversations.archive](https://docs.slack.dev/reference/methods/agents.conversations.archive)**: Archive a code channel. [Implementation](./src/agents/conversations/agents_conversations_archive.py).
+- **[agents.conversations.create](https://docs.slack.dev/reference/methods/agents.conversations.create)**: Create a dedicated code channel for an agent session. [Implementation](./src/agents/conversations/agents_conversations_create.py).
+- **[agents.conversations.getCanvas](https://docs.slack.dev/reference/methods/agents.conversations.getCanvas)**: Fetch a canvas attached to a code channel. [Implementation](./src/agents/conversations/agents_conversations_get_canvas.py).
+- **[agents.conversations.listViews](https://docs.slack.dev/reference/methods/agents.conversations.listViews)**: List the views currently attached to a code channel. [Implementation](./src/agents/conversations/agents_conversations_list_views.py).
+- **[agents.conversations.removeView](https://docs.slack.dev/reference/methods/agents.conversations.removeView)**: Remove a view from a code channel. [Implementation](./src/agents/conversations/agents_conversations_remove_view.py).
+- **[agents.conversations.setCanvasContent](https://docs.slack.dev/reference/methods/agents.conversations.setCanvasContent)**: Replace the full markdown content of a plan canvas attached to a code channel. [Implementation](./src/agents/conversations/agents_conversations_set_canvas_content.py).
+- **[agents.conversations.setCommands](https://docs.slack.dev/reference/methods/agents.conversations.setCommands)**: Register the set of agent-defined slash commands for the calling agent in a code channel. [Implementation](./src/agents/conversations/agents_conversations_set_commands.py).
+- **[agents.conversations.setProperties](https://docs.slack.dev/reference/methods/agents.conversations.setProperties)**: Set properties on a code channel. [Implementation](./src/agents/conversations/agents_conversations_set_properties.py).
+- **[agents.conversations.setView](https://docs.slack.dev/reference/methods/agents.conversations.setView)**: Create or update a view in a code channel. [Implementation](./src/agents/conversations/agents_conversations_set_view.py).
 - **[agents.sessions.rename](https://docs.slack.dev/reference/methods/agents.sessions.rename)**: Rename an agent session. [Implementation](./src/agents/sessions/agents_sessions_rename.py).
 - **[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).
 

methods/src/agents/conversations/.slack/.gitignore

@@ -0,0 +1,2 @@
+apps.dev.json
+cache/

methods/src/agents/conversations/.slack/config.json

@@ -0,0 +1,6 @@
+{
+  "manifest": {
+    "source": "local"
+  },
+  "project_id": "00000000-0000-0000-0000-000000000000"
+}

methods/src/agents/conversations/.slack/hooks.json

@@ -0,0 +1,5 @@
+{
+  "hooks": {
+    "get-hooks": "python3 -m slack_cli_hooks.hooks.get_hooks"
+  }
+}

methods/src/agents/conversations/__init__.py

@@ -0,0 +1,18 @@
+import os
+
+from slack_sdk import WebClient
+
+# Read a token from an environment variable
+token = os.environ.get("SLACK_TOKEN")
+
+# Initialize
+client = WebClient(token=token)
+
+# Call the agents.conversations.archive method
+response = client.agents_conversations_archive(
+    channel_id="C9876543210",
+    summary_message_ts="1717182000.456789",
+)
+
+# Inspect the response
+print(response)

methods/src/agents/conversations/agents_conversations_archive.py

@@ -0,0 +1,20 @@
+import os
+
+from slack_sdk import WebClient
+
+# Read a token from an environment variable
+token = os.environ.get("SLACK_TOKEN")
+
+# Initialize
+client = WebClient(token=token)
+
+# Call the agents.conversations.create method
+response = client.agents_conversations_create(
+    name="Migrate billing cron to Temporal",
+    session_id="ses_8675309",
+    origin_channel_id="C0123456789",
+    origin_message_ts="1717171717.123456",
+)
+
+# Inspect the response
+print(response)

methods/src/agents/conversations/agents_conversations_create.py

@@ -0,0 +1,19 @@
+import os
+
+from slack_sdk import WebClient
+
+# Read a token from an environment variable
+token = os.environ.get("SLACK_TOKEN")
+
+# Initialize
+client = WebClient(token=token)
+
+# Call the agents.conversations.getCanvas method
+response = client.agents_conversations_getCanvas(
+    channel="C9876543210",
+    canvas_id="F1234567890",
+    include_resolved=False,
+)
+
+# Inspect the response
+print(response)

methods/src/agents/conversations/agents_conversations_get_canvas.py

@@ -0,0 +1,17 @@
+import os
+
+from slack_sdk import WebClient
+
+# Read a token from an environment variable
+token = os.environ.get("SLACK_TOKEN")
+
+# Initialize
+client = WebClient(token=token)
+
+# Call the agents.conversations.listViews method
+response = client.agents_conversations_listViews(
+    channel_id="C9876543210",
+)
+
+# Inspect the response
+print(response)

methods/src/agents/conversations/agents_conversations_list_views.py

@@ -0,0 +1,18 @@
+import os
+
+from slack_sdk import WebClient
+
+# Read a token from an environment variable
+token = os.environ.get("SLACK_TOKEN")
+
+# Initialize
+client = WebClient(token=token)
+
+# Call the agents.conversations.removeView method
+response = client.agents_conversations_removeView(
+    channel_id="C9876543210",
+    view_key="reports/coverage.html",
+)
+
+# Inspect the response
+print(response)