Skip to content

feat(web-api): add agents.sessions.rename and agents.sessions.setStatus - #2703

Merged
zimeg merged 2 commits into
mainfrom
clack/agents-sessions-methods
Aug 22, 2026
Merged

feat(web-api): add agents.sessions.rename and agents.sessions.setStatus#2703
zimeg merged 2 commits into
mainfrom
clack/agents-sessions-methods

Conversation

@zimeg

@zimeg zimeg commented Aug 20, 2026

Copy link
Copy Markdown
Member

Mirrors the Python SDK (slackapi/python-slack-sdk#1942) for the two agents.sessions methods.

Documentation

What's here

  • client.agents.sessions.rename — Rename an agent session.
  • client.agents.sessions.setStatus — Set an agent session's lifecycle status, creating the session if needed.
  • Request argument types (src/types/request/agents.ts)
  • Response types (src/types/response/AgentsSessions{Rename,SetStatus}Response.ts)

Response types — regenerate after the Java SDK PR lands

The response types are produced by scripts/generate-web-api-types.sh, which runs quicktype over the API sample logs in java-slack-sdk (json-logs/samples/api/). Those samples are added in slackapi/java-slack-sdk#1633.

The two response files here were generated by running that exact quicktype pipeline against the #1633 samples, so they should match — but the generator clones java-slack-sdk main, so it must be re-run once #1633 is merged to make the response shape authoritative. That's the main reason this is draft.

Verified

  • tsc --noEmit — clean
  • biome check (full packages/ tree, via pre-commit) — no fixes

🤖 Generated with Claude Code

@changeset-bot

changeset-bot Bot commented Aug 20, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: c85faef

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
@slack/web-api Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@codecov

codecov Bot commented Aug 20, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.15%. Comparing base (bff3398) to head (c85faef).
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #2703      +/-   ##
==========================================
+ Coverage   89.14%   89.15%   +0.01%     
==========================================
  Files          65       65              
  Lines       10361    10383      +22     
  Branches      473      473              
==========================================
+ Hits         9236     9257      +21     
- Misses       1094     1095       +1     
  Partials       31       31              
Flag Coverage Δ
cli-hooks 89.15% <100.00%> (+0.01%) ⬆️
cli-test 89.15% <100.00%> (+0.01%) ⬆️
logger 89.15% <100.00%> (+0.01%) ⬆️
oauth 89.15% <100.00%> (+0.01%) ⬆️
socket-mode 89.15% <100.00%> (+0.01%) ⬆️
web-api 89.15% <100.00%> (+0.01%) ⬆️
webhook 89.15% <100.00%> (+0.01%) ⬆️

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

🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@zimeg
zimeg force-pushed the clack/agents-sessions-methods branch from 74a4330 to ee66240 Compare August 20, 2026 16:25
@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 zimeg added the pkg:web-api applies to `@slack/web-api` label 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>
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 added this to the web-api@next milestone Aug 22, 2026
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
@zimeg
zimeg force-pushed the clack/agents-sessions-methods branch from ee66240 to c85faef Compare August 22, 2026 00:06
@zimeg
zimeg marked this pull request as ready for review August 22, 2026 00:11
@zimeg
zimeg requested a review from a team as a code owner August 22, 2026 00:11

@zimeg zimeg left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👾 A small change to polished changelogs on release.

"@slack/web-api": minor
---

feat(web-api): add [`agents.sessions.rename`](https://docs.slack.dev/reference/methods/agents.sessions.rename) and [`agents.sessions.setStatus`](https://docs.slack.dev/reference/methods/agents.sessions.setStatus)

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
feat(web-api): add [`agents.sessions.rename`](https://docs.slack.dev/reference/methods/agents.sessions.rename) and [`agents.sessions.setStatus`](https://docs.slack.dev/reference/methods/agents.sessions.setStatus)
feat: add [`agents.sessions.rename`](https://docs.slack.dev/reference/methods/agents.sessions.rename) and [`agents.sessions.setStatus`](https://docs.slack.dev/reference/methods/agents.sessions.setStatus)

📚 note: Changesets are added to this package without needing redundencies.

@zimeg
zimeg merged commit 4322e14 into main Aug 22, 2026
12 checks passed
@zimeg
zimeg deleted the clack/agents-sessions-methods branch August 22, 2026 00:12
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 pkg:web-api applies to `@slack/web-api` semver:minor

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant