Skip to content

feat: add agents.sessions.setStatus and agents.sessions.rename - #1633

Draft
zimeg wants to merge 1 commit into
apifrom
clack/agents-sessions-methods
Draft

feat: add agents.sessions.setStatus and agents.sessions.rename#1633
zimeg wants to merge 1 commit into
apifrom
clack/agents-sessions-methods

Conversation

@zimeg

@zimeg zimeg commented Aug 20, 2026

Copy link
Copy Markdown
Member

Adds the agents.sessions.* Web API methods — the agent-sessions successors to assistant.threads.setStatus / assistant.threads.setTitle.

Methods

  • agents.sessions.setStatuschannel_id (required), status (required), optional thread_ts, title, initiator_user_id, icon_emoji, icon_url, username
  • agents.sessions.renamechannel_id (required), title (required), optional thread_ts

Bot token scope: chat:write. Rate limit: Tier 3 (both).

What's included

  • Request classes: AgentsSessionsSetStatusRequest, AgentsSessionsRenameRequest
  • Response classes: AgentsSessionsSetStatusResponse, AgentsSessionsRenameResponse
  • Sync + async client method declarations and implementations
  • RequestFormBuilder form serialization
  • Rate-limit tier registration (MethodsRateLimits + rate_limit_tiers.json)
  • Response-sample dump (MethodsResponseDumpTest.agents_sessions()) for downstream type generation
  • Remote API tests (test_with_remote_apis/methods/agents_sessions_Test) — assume-gated on a bot token, so they skip cleanly without credentials

Mirrors the Python SDK implementation (slackapi/python-slack-sdk#1942). Draft/experimental.

@codecov

codecov Bot commented Aug 20, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 8.00000% with 23 lines in your changes missing coverage. Please review.
✅ Project coverage is 73.13%. Comparing base (d1a5fb2) to head (3918e12).
⚠️ Report is 1 commits behind head on api.
✅ All tests successful. No failed tests found.

Files with missing lines Patch % Lines
...java/com/slack/api/methods/RequestFormBuilder.java 0.00% 15 Missing ⚠️
...slack/api/methods/impl/AsyncMethodsClientImpl.java 0.00% 4 Missing ⚠️
.../com/slack/api/methods/impl/MethodsClientImpl.java 0.00% 4 Missing ⚠️
Additional details and impacted files
@@             Coverage Diff              @@
##                api    #1633      +/-   ##
============================================
+ Coverage     70.80%   73.13%   +2.33%     
- Complexity      235     4523    +4288     
============================================
  Files            44      478     +434     
  Lines           548    14339   +13791     
  Branches         47     1491    +1444     
============================================
+ Hits            388    10487   +10099     
- Misses          137     2962    +2825     
- Partials         23      890     +867     
Flag Coverage Δ
jdk-14 73.13% <8.00%> (+2.33%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

@zimeg
zimeg force-pushed the clack/agents-sessions-methods branch 7 times, most recently from 082dff4 to 3ee8e00 Compare August 20, 2026 13:22
@zimeg
zimeg force-pushed the clack/agents-sessions-methods branch from 3ee8e00 to 580e947 Compare August 20, 2026 16:24
zimeg added a commit to slackapi/node-slack-sdk that referenced this pull request Aug 20, 2026
Mirror the Python SDK (slackapi/python-slack-sdk#1942) for the two
agents.sessions methods:

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

Adds the client.agents.sessions.{rename,setStatus} bindings, the request
argument types, and the response types.

The response types are generated from the java-slack-sdk API sample logs
via scripts/generate-web-api-types.sh; the samples land in
slackapi/java-slack-sdk#1633, so the generator must be re-run against
java-slack-sdk main once that ships to pick up the final response shape.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
@zimeg
zimeg force-pushed the clack/agents-sessions-methods branch from 580e947 to 4cff141 Compare August 20, 2026 16:31
Add the agents.sessions.* Web API methods (successors to
assistant.threads.setStatus/setTitle): request/response classes, sync + async
client methods, form builder, Tier3 rate-limit metadata, a response-sample
dump, and remote API tests. Arguments follow the method reference; scope
chat:write.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
@zimeg
zimeg force-pushed the clack/agents-sessions-methods branch from 4cff141 to 3918e12 Compare August 20, 2026 16:33
@zimeg zimeg added enhancement M-T: A feature request for new functionality semver:minor labels Aug 20, 2026
@zimeg zimeg self-assigned this Aug 20, 2026
zimeg added a commit to slack-samples/bolt-java-examples that referenced this pull request Aug 20, 2026
Mirror the Python examples (slackapi/bolt-python-examples) 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 classes, a per-family manifest (agent_view + the
agent bot events), and an "agents" section in the methods README.

Requires the agents.sessions methods in slack-api-client (adds via
slackapi/java-slack-sdk#1633); the example pom stays pinned to the
released SDK until that ships.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
zimeg added a commit to slack-samples/bolt-java-examples that referenced this pull request Aug 20, 2026
Mirror the Python examples (slackapi/bolt-python-examples) 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 classes, a per-family manifest (agent_view + the
agent bot events), and an "agents" section in the methods README.

Requires the agents.sessions methods in slack-api-client (adds via
slackapi/java-slack-sdk#1633); the example pom stays pinned to the
released SDK until that ships.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
zimeg added a commit to slack-samples/bolt-java-examples that referenced this pull request Aug 20, 2026
Mirror the Python examples (slackapi/bolt-python-examples) 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 classes, a per-family manifest (agent_view + the
agent bot events), and an "agents" section in the methods README.

Requires the agents.sessions methods in slack-api-client (adds via
slackapi/java-slack-sdk#1633); the example pom stays pinned to the
released SDK until that ships.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
zimeg added a commit to slack-samples/bolt-java-examples that referenced this pull request Aug 20, 2026
Mirror the Python examples (slackapi/bolt-python-examples) 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 classes, a per-family manifest (agent_view + the
agent bot events), and an "agents" section in the methods README.

Requires the agents.sessions methods in slack-api-client (adds via
slackapi/java-slack-sdk#1633); the example pom stays pinned to the
released SDK until that ships.

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 M-T: A feature request for new functionality semver:minor

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant