Skip to content

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

Draft
zimeg wants to merge 7 commits into
mainfrom
clack/agents-sessions-method-examples
Draft

feat(methods): add agents.sessions method examples#201
zimeg wants to merge 7 commits into
mainfrom
clack/agents-sessions-method-examples

Conversation

@zimeg

@zimeg zimeg commented Aug 20, 2026

Copy link
Copy Markdown
Member

Adds agents.sessions.setStatus and agents.sessions.rename method examples with a minimal assistant:write manifest and the standard .slack CLI hooks.

Experimental: calls typed methods that ship on the unmerged SDK method branch; draft until those land in a release.

(Replaces the prior PR whose branch was rebuilt to base on main; the code-channels examples PR now stacks on top of this one.)

zimeg and others added 6 commits August 19, 2026 23:05
Add examples for agents.sessions.setStatus and agents.sessions.rename with a
minimal assistant:write manifest and the standard .slack CLI hooks.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Match the family-first header convention (### agents, like ### chat) and
tighten the agents.sessions.* method descriptions.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
agents.sessions.setStatus and agents.sessions.rename require the chat:write
bot scope per the method reference, not assistant:write.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Move the agents.sessions method examples from a flat agents_sessions/ dir to
nested agents/sessions/ (path mirrors the agents.sessions.* method family),
updating the README implementation links.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Add the recommended agent_view event subscriptions (agent_session_stopped,
app_home_opened, message.im), the assistant:write scope, and im:history so
message.im events deliver; enable socket mode. Clears the manifest
recommendations and the agent_session_stopped subscription warning.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
@zimeg zimeg added the enhancement New feature or request label Aug 20, 2026
@zimeg zimeg self-assigned this Aug 20, 2026
zimeg added a commit to slack-samples/bolt-js-examples that referenced this pull request Aug 20, 2026
Mirror the Python examples (slack-samples/bolt-python-examples#201) for
the two agents.sessions methods, nested under agents/sessions/ to match:

- agents.sessions.rename    Rename an agent session.
- agents.sessions.setStatus Set an agent session's lifecycle status,
                            creating the session if needed.

Adds the two example scripts, a per-family manifest (agent view + the
agent session bot events) with its .slack CLI config, and an "agents"
section in the methods README.

Requires client.agents.sessions.{rename,setStatus} in @slack/web-api
(adds via slackapi/node-slack-sdk#2703); the package stays on the
released ^8.0.0 range until that ships, so the typecheck can't resolve
the methods until then.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
zimeg added a commit to slack-samples/bolt-js-examples that referenced this pull request Aug 20, 2026
Mirror the Python examples (slack-samples/bolt-python-examples#201) for
the two agents.sessions methods, nested under agents/sessions/ to match:

- agents.sessions.rename    Rename an agent session.
- agents.sessions.setStatus Set an agent session's lifecycle status,
                            creating the session if needed.

Adds the two example scripts, a per-family manifest (agent view + the
agent session bot events) with its .slack CLI config, and an "agents"
section in the methods README.

Requires client.agents.sessions.{rename,setStatus} in @slack/web-api
(adds via slackapi/node-slack-sdk#2703); the package stays on the
released ^8.0.0 range until that ships, so the typecheck can't resolve
the methods until then.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
zimeg added a commit to slack-samples/bolt-js-examples that referenced this pull request Aug 20, 2026
Mirror the Python examples (slack-samples/bolt-python-examples#201) for
the two agents.sessions methods, nested under agents/sessions/ to match:

- agents.sessions.rename    Rename an agent session.
- agents.sessions.setStatus Set an agent session's lifecycle status,
                            creating the session if needed.

Adds the two example scripts, a per-family manifest (agent view + the
agent session bot events) with its .slack CLI config, and an "agents"
section in the methods README.

Requires client.agents.sessions.{rename,setStatus} in @slack/web-api
(adds via slackapi/node-slack-sdk#2703); the package stays on the
released ^8.0.0 range until that ships, so the typecheck can't resolve
the methods until then.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
zimeg added a commit to slack-samples/bolt-js-examples that referenced this pull request Aug 20, 2026
Mirror the Python examples (slack-samples/bolt-python-examples#201) for
the two agents.sessions methods, nested under agents/sessions/ to match:

- agents.sessions.rename    Rename an agent session.
- agents.sessions.setStatus Set an agent session's lifecycle status,
                            creating the session if needed.

Adds the two example scripts, a per-family manifest (agent view + the
agent session bot events) with its .slack CLI config, and an "agents"
section in the methods README.

Requires client.agents.sessions.{rename,setStatus} in @slack/web-api
(adds via slackapi/node-slack-sdk#2703); the package stays on the
released ^8.0.0 range until that ships, so the typecheck can't resolve
the methods until then.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
`agent_view` only accepts `agent_description`, `suggested_prompts`, and
`actions` (additionalProperties: false), so `enabled: true` fails
manifest validation. Replace it with a minimal `agent_description`.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant