feat(methods): add agents.sessions method examples (#201)

Author: zimeg

methods/README.md

@@ -16,6 +16,11 @@ $ slack run chat_post_message.py  # Make the request
 
 ## What's on call
 
+### agents
+
+- **[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).
+
 ### blocks
 
 - **[blocks.validate](https://docs.slack.dev/reference/methods/blocks.validate)**: Validates blocks, messages, and views Block Kit JSON payloads. [Implementation](./src/blocks/blocks_validate.py).

methods/src/agents/__init__.py

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

methods/src/agents/sessions/.slack/.gitignore

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

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

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

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

@@ -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.sessions.rename method
+response = client.agents_sessions_rename(
+    channel_id="C123ABC",
+    thread_ts="1717171717.123456",
+    title="Bora Bora trip prep",
+)
+
+# Inspect the response
+print(response)

methods/src/agents/sessions/__init__.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.sessions.setStatus method
+response = client.agents_sessions_setStatus(
+    channel_id="C123ABC",
+    thread_ts="1717171717.123456",
+    status="processing",
+    title="Scuba diving research",
+)
+
+# Inspect the response
+print(response)

methods/src/agents/sessions/agents_sessions_rename.py

@@ -0,0 +1,28 @@
+{
+  "display_information": {
+    "name": "Slack API Methods",
+    "description": "Example implementations to call \"agents.sessions\" methods"
+  },
+  "features": {
+    "bot_user": {
+      "display_name": "Slack API Methods",
+      "always_online": true
+    },
+    "agent_view": {
+      "agent_description": "Example implementations to call \"agents.sessions\" methods"
+    }
+  },
+  "oauth_config": {
+    "scopes": {
+      "bot": ["assistant:write", "chat:write", "im:history"]
+    }
+  },
+  "settings": {
+    "event_subscriptions": {
+      "bot_events": ["agent_session_stopped", "app_home_opened", "message.im"]
+    },
+    "org_deploy_enabled": true,
+    "socket_mode_enabled": true,
+    "token_rotation_enabled": false
+  }
+}