Skip to content

Feat: Add session/list API for managing and discovering sessions#226

Merged
benbrandt merged 15 commits into
agentclientprotocol:mainfrom
ahmedhesham6:feat/list-sessions
Nov 24, 2025
Merged

Feat: Add session/list API for managing and discovering sessions#226
benbrandt merged 15 commits into
agentclientprotocol:mainfrom
ahmedhesham6:feat/list-sessions

Conversation

@ahmedhesham6
Copy link
Copy Markdown
Contributor

This commit introduces the session/list capability, allowing agents to list existing sessions with optional filtering and pagination. It includes the ListSessionsRequest and ListSessionsResponse structures, along with the necessary updates to the protocol documentation and JSON schema. This feature is marked as UNSTABLE and may change in future iterations.

@ahmedhesham6 ahmedhesham6 requested a review from a team November 6, 2025 00:40
Comment thread schema/schema.json Outdated
Comment thread schema/schema.json Outdated
Copy link
Copy Markdown
Contributor

@codefromthecrypt codefromthecrypt left a comment

Choose a reason for hiding this comment

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

forgive me if there are standards in general we are using which indicate serialize null on a non-required field. this is a bikeshed, just trying to understand if we are intentional on this or if it was just a practice and not too late to discuss it.

Comment thread schema/schema.json
This commit introduces the `session/list` capability, allowing agents to list existing sessions with optional filtering and pagination. It includes the `ListSessionsRequest` and `ListSessionsResponse` structures, along with the necessary updates to the protocol documentation and JSON schema. This feature is marked as **UNSTABLE** and may change in future iterations.
@benbrandt benbrandt requested a review from a team as a code owner November 20, 2025 11:26
benbrandt and others added 4 commits November 20, 2025 12:40
- Remove limit parameter from ListSessionsRequest
- Make createdAt and updatedAt optional in SessionInfo
- Update RFD documentation to reflect changes
- Regenerate schema files
@ignatov
Copy link
Copy Markdown
Contributor

ignatov commented Nov 24, 2025

Hey! Sorry for jumping in here. I was about to propose a feature like send_session_name_update_event or something similar. My intention is that the agent can update the session name UI multiple times during its work, and the UI should be updated accordingly.

I think such an addition naturally fits into that PR.
@ahmedhesham6, @benbrandt what do you think?

@ahmedhesham6
Copy link
Copy Markdown
Contributor Author

Hey @ignatov — I like the idea. I just don’t think it belongs in this PR.

Something like send_session_name_update_event feels like a client↔agent notification concern. We should either:

  • extend the session/update notification schema to carry session metadata (including name), or
  • introduce a new notification type specifically for session-name updates.

Either way, that’s a broader protocol/API change and should go through a separate RFD.

@benbrandt
Copy link
Copy Markdown
Member

Hi yes I agree:

  1. I think we do need this session update 100%
  2. I don't think it belongs in this RFD/PR

Mainly because I want these changes to be reviewable, and while this notification is connected, I think it can build on top of it.

One thing we may want to decide if people have strong opinions is if we should call this field "title" or "name" if we have strong opinions there, so that we can have one concept.

But I know there are some teams that definitely have opinions on titles and how they should be updated (should the client be able to rename it for example) so I think there will be enough to discuss in its own RFD for sure.

@ignatov
Copy link
Copy Markdown
Contributor

ignatov commented Nov 24, 2025

Okay, in that case SessionInfo should be aligned with the current session primitive. I think it should use the same structure that describes the current session and we use in sessions/list call.

@benbrandt
Copy link
Copy Markdown
Member

@ignatov I'm confused now... this is the PR that introduces Sessioninfo and is the first time we've had such a primitive. Which other one are you referring to?

@benbrandt
Copy link
Copy Markdown
Member

@ignatov I am going to go ahead and merge as-is. This RFD is still in draft stage, not preview yet, so we can still continue the discussion if you feel there is something missing here

Copy link
Copy Markdown
Member

@benbrandt benbrandt left a comment

Choose a reason for hiding this comment

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

Looks ready to start testing out to me!

@benbrandt benbrandt merged commit 5afa4cd into agentclientprotocol:main Nov 24, 2025
1 check passed
@ignatov
Copy link
Copy Markdown
Contributor

ignatov commented Nov 24, 2025

I am going to go ahead and merge as-is. This RFD is still in draft stage, not preview yet, so we can still continue the discussion if you feel there is something missing here

@benbrandt, sure

@codefromthecrypt
Copy link
Copy Markdown
Contributor

please tag the session name update PR or issue back here, as it is really important agreed!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants