Skip to content

Commit f733ac6

Browse files
daniel-agenteedaniel-agentee
committed
Add session/setTitle method for client-driven session renaming
1 parent 9df89dc commit f733ac6

16 files changed

Lines changed: 1054 additions & 0 deletions

‎docs/protocol/v1/draft/schema.mdx‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1491,6 +1491,56 @@ See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/d
14911491

14921492
</ResponseField>
14931493

1494+
<a id="session-settitle"></a>
1495+
### <span class="font-mono">session/setTitle</span>
1496+
1497+
Sets the title for a session.
1498+
1499+
Empty titles are valid and request that the agent clear the session title.
1500+
1501+
This method can be called at any time during a session, whether the Agent is
1502+
idle or actively generating a response.
1503+
1504+
#### <span class="font-mono">SetSessionTitleRequest</span>
1505+
1506+
Request parameters for setting a session title.
1507+
1508+
**Type:** Object
1509+
1510+
**Properties:**
1511+
1512+
<ResponseField name="_meta" type={"object | null"} >
1513+
The _meta property is reserved by ACP to allow clients and agents to attach additional
1514+
metadata to their interactions. Implementations MUST NOT make assumptions about values at
1515+
these keys.
1516+
1517+
See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility)
1518+
1519+
</ResponseField>
1520+
<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
1521+
The ID of the session to set the title for.
1522+
</ResponseField>
1523+
<ResponseField name="title" type={"string"} required>
1524+
The new title for the session.
1525+
</ResponseField>
1526+
1527+
#### <span class="font-mono">SetSessionTitleResponse</span>
1528+
1529+
Response to `session/setTitle` method.
1530+
1531+
**Type:** Object
1532+
1533+
**Properties:**
1534+
1535+
<ResponseField name="_meta" type={"object | null"} >
1536+
The _meta property is reserved by ACP to allow clients and agents to attach additional
1537+
metadata to their interactions. Implementations MUST NOT make assumptions about values at
1538+
these keys.
1539+
1540+
See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility)
1541+
1542+
</ResponseField>
1543+
14941544
<a id="session-set_config_option"></a>
14951545
### <span class="font-mono">session/set_config_option</span>
14961546

@@ -6655,6 +6705,9 @@ Whether the agent supports `session/fork`.
66556705
<ResponseField name="resume" type={<><span><a href="#sessionresumecapabilities">SessionResumeCapabilities</a></span><span> | null</span></>} >
66566706
Whether the agent supports `session/resume`.
66576707
</ResponseField>
6708+
<ResponseField name="setTitle" type={<><span><a href="#sessionsettitlecapabilities">SessionSetTitleCapabilities</a></span><span> | null</span></>} >
6709+
Whether the agent supports `session/setTitle`.
6710+
</ResponseField>
66586711

66596712
## <span class="font-mono">SessionCloseCapabilities</span>
66606713

@@ -7112,6 +7165,25 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d
71127165

71137166
</ResponseField>
71147167

7168+
## <span class="font-mono">SessionSetTitleCapabilities</span>
7169+
7170+
Capabilities for the `session/setTitle` method.
7171+
7172+
By supplying `\{\}` it means that the agent supports setting session titles.
7173+
7174+
**Type:** Object
7175+
7176+
**Properties:**
7177+
7178+
<ResponseField name="_meta" type={"object | null"} >
7179+
The _meta property is reserved by ACP to allow clients and agents to attach additional
7180+
metadata to their interactions. Implementations MUST NOT make assumptions about values at
7181+
these keys.
7182+
7183+
See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility)
7184+
7185+
</ResponseField>
7186+
71157187
## <span class="font-mono">SessionUpdate</span>
71167188

71177189
Different types of updates that can be sent during session processing.

‎docs/protocol/v1/schema.mdx‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -719,6 +719,56 @@ See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/s
719719

720720
</ResponseField>
721721

722+
<a id="session-settitle"></a>
723+
### <span class="font-mono">session/setTitle</span>
724+
725+
Sets the title for a session.
726+
727+
Empty titles are valid and request that the agent clear the session title.
728+
729+
This method can be called at any time during a session, whether the Agent is
730+
idle or actively generating a response.
731+
732+
#### <span class="font-mono">SetSessionTitleRequest</span>
733+
734+
Request parameters for setting a session title.
735+
736+
**Type:** Object
737+
738+
**Properties:**
739+
740+
<ResponseField name="_meta" type={"object | null"} >
741+
The _meta property is reserved by ACP to allow clients and agents to attach additional
742+
metadata to their interactions. Implementations MUST NOT make assumptions about values at
743+
these keys.
744+
745+
See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility)
746+
747+
</ResponseField>
748+
<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
749+
The ID of the session to set the title for.
750+
</ResponseField>
751+
<ResponseField name="title" type={"string"} required>
752+
The new title for the session.
753+
</ResponseField>
754+
755+
#### <span class="font-mono">SetSessionTitleResponse</span>
756+
757+
Response to `session/setTitle` method.
758+
759+
**Type:** Object
760+
761+
**Properties:**
762+
763+
<ResponseField name="_meta" type={"object | null"} >
764+
The _meta property is reserved by ACP to allow clients and agents to attach additional
765+
metadata to their interactions. Implementations MUST NOT make assumptions about values at
766+
these keys.
767+
768+
See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility)
769+
770+
</ResponseField>
771+
722772
<a id="session-set_config_option"></a>
723773
### <span class="font-mono">session/set_config_option</span>
724774

@@ -2953,6 +3003,9 @@ Supplying `\{\}` means the agent supports deleting sessions from `session/list`.
29533003
<ResponseField name="resume" type={<><span><a href="#sessionresumecapabilities">SessionResumeCapabilities</a></span><span> | null</span></>} >
29543004
Whether the agent supports `session/resume`.
29553005
</ResponseField>
3006+
<ResponseField name="setTitle" type={<><span><a href="#sessionsettitlecapabilities">SessionSetTitleCapabilities</a></span><span> | null</span></>} >
3007+
Whether the agent supports `session/setTitle`.
3008+
</ResponseField>
29563009

29573010
## <span class="font-mono">SessionCloseCapabilities</span>
29583011

@@ -3323,6 +3376,25 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e
33233376

33243377
</ResponseField>
33253378

3379+
## <span class="font-mono">SessionSetTitleCapabilities</span>
3380+
3381+
Capabilities for the `session/setTitle` method.
3382+
3383+
By supplying `\{\}` it means that the agent supports setting session titles.
3384+
3385+
**Type:** Object
3386+
3387+
**Properties:**
3388+
3389+
<ResponseField name="_meta" type={"object | null"} >
3390+
The _meta property is reserved by ACP to allow clients and agents to attach additional
3391+
metadata to their interactions. Implementations MUST NOT make assumptions about values at
3392+
these keys.
3393+
3394+
See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility)
3395+
3396+
</ResponseField>
3397+
33263398
## <span class="font-mono">SessionUpdate</span>
33273399

33283400
Different types of updates that can be sent during session processing.

‎docs/protocol/v2/draft/schema.mdx‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1469,6 +1469,56 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/d
14691469
Initial session configuration options if supported by the Agent.
14701470
</ResponseField>
14711471

1472+
<a id="session-settitle"></a>
1473+
### <span class="font-mono">session/setTitle</span>
1474+
1475+
Sets the title for a session.
1476+
1477+
Empty titles are valid and request that the agent clear the session title.
1478+
1479+
This method can be called at any time during a session, whether the Agent is
1480+
idle or actively generating a response.
1481+
1482+
#### <span class="font-mono">SetSessionTitleRequest</span>
1483+
1484+
Request parameters for setting a session title.
1485+
1486+
**Type:** Object
1487+
1488+
**Properties:**
1489+
1490+
<ResponseField name="_meta" type={"object | null"} >
1491+
The _meta property is reserved by ACP to allow clients and agents to attach additional
1492+
metadata to their interactions. Implementations MUST NOT make assumptions about values at
1493+
these keys.
1494+
1495+
See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/draft/extensibility)
1496+
1497+
</ResponseField>
1498+
<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
1499+
The ID of the session to set the title for.
1500+
</ResponseField>
1501+
<ResponseField name="title" type={"string"} required>
1502+
The new title for the session.
1503+
</ResponseField>
1504+
1505+
#### <span class="font-mono">SetSessionTitleResponse</span>
1506+
1507+
Response to `session/setTitle` method.
1508+
1509+
**Type:** Object
1510+
1511+
**Properties:**
1512+
1513+
<ResponseField name="_meta" type={"object | null"} >
1514+
The _meta property is reserved by ACP to allow clients and agents to attach additional
1515+
metadata to their interactions. Implementations MUST NOT make assumptions about values at
1516+
these keys.
1517+
1518+
See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/draft/extensibility)
1519+
1520+
</ResponseField>
1521+
14721522
<a id="session-set_config_option"></a>
14731523
### <span class="font-mono">session/set_config_option</span>
14741524

@@ -6405,6 +6455,9 @@ required by `session/prompt`.
64056455
<ResponseField name="resume" type={<><span><a href="#sessionresumecapabilities">SessionResumeCapabilities</a></span><span> | null</span></>} >
64066456
Whether the agent supports `session/resume`.
64076457
</ResponseField>
6458+
<ResponseField name="setTitle" type={<><span><a href="#sessionsettitlecapabilities">SessionSetTitleCapabilities</a></span><span> | null</span></>} >
6459+
Whether the agent supports `session/setTitle`.
6460+
</ResponseField>
64086461

64096462
## <span class="font-mono">SessionCloseCapabilities</span>
64106463

@@ -6857,6 +6910,25 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/d
68576910

68586911
</ResponseField>
68596912

6913+
## <span class="font-mono">SessionSetTitleCapabilities</span>
6914+
6915+
Capabilities for the `session/setTitle` method.
6916+
6917+
By supplying `\{\}` it means that the agent supports setting session titles.
6918+
6919+
**Type:** Object
6920+
6921+
**Properties:**
6922+
6923+
<ResponseField name="_meta" type={"object | null"} >
6924+
The _meta property is reserved by ACP to allow clients and agents to attach additional
6925+
metadata to their interactions. Implementations MUST NOT make assumptions about values at
6926+
these keys.
6927+
6928+
See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/draft/extensibility)
6929+
6930+
</ResponseField>
6931+
68606932
## <span class="font-mono">SessionUpdate</span>
68616933

68626934
Different types of updates that can be sent during session processing.

‎docs/protocol/v2/schema.mdx‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -703,6 +703,56 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/e
703703
Initial session configuration options if supported by the Agent.
704704
</ResponseField>
705705

706+
<a id="session-settitle"></a>
707+
### <span class="font-mono">session/setTitle</span>
708+
709+
Sets the title for a session.
710+
711+
Empty titles are valid and request that the agent clear the session title.
712+
713+
This method can be called at any time during a session, whether the Agent is
714+
idle or actively generating a response.
715+
716+
#### <span class="font-mono">SetSessionTitleRequest</span>
717+
718+
Request parameters for setting a session title.
719+
720+
**Type:** Object
721+
722+
**Properties:**
723+
724+
<ResponseField name="_meta" type={"object | null"} >
725+
The _meta property is reserved by ACP to allow clients and agents to attach additional
726+
metadata to their interactions. Implementations MUST NOT make assumptions about values at
727+
these keys.
728+
729+
See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)
730+
731+
</ResponseField>
732+
<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
733+
The ID of the session to set the title for.
734+
</ResponseField>
735+
<ResponseField name="title" type={"string"} required>
736+
The new title for the session.
737+
</ResponseField>
738+
739+
#### <span class="font-mono">SetSessionTitleResponse</span>
740+
741+
Response to `session/setTitle` method.
742+
743+
**Type:** Object
744+
745+
**Properties:**
746+
747+
<ResponseField name="_meta" type={"object | null"} >
748+
The _meta property is reserved by ACP to allow clients and agents to attach additional
749+
metadata to their interactions. Implementations MUST NOT make assumptions about values at
750+
these keys.
751+
752+
See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)
753+
754+
</ResponseField>
755+
706756
<a id="session-set_config_option"></a>
707757
### <span class="font-mono">session/set_config_option</span>
708758

@@ -2759,6 +2809,9 @@ required by `session/prompt`.
27592809
<ResponseField name="resume" type={<><span><a href="#sessionresumecapabilities">SessionResumeCapabilities</a></span><span> | null</span></>} >
27602810
Whether the agent supports `session/resume`.
27612811
</ResponseField>
2812+
<ResponseField name="setTitle" type={<><span><a href="#sessionsettitlecapabilities">SessionSetTitleCapabilities</a></span><span> | null</span></>} >
2813+
Whether the agent supports `session/setTitle`.
2814+
</ResponseField>
27622815

27632816
## <span class="font-mono">SessionCloseCapabilities</span>
27642817

@@ -3153,6 +3206,25 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/e
31533206

31543207
</ResponseField>
31553208

3209+
## <span class="font-mono">SessionSetTitleCapabilities</span>
3210+
3211+
Capabilities for the `session/setTitle` method.
3212+
3213+
By supplying `\{\}` it means that the agent supports setting session titles.
3214+
3215+
**Type:** Object
3216+
3217+
**Properties:**
3218+
3219+
<ResponseField name="_meta" type={"object | null"} >
3220+
The _meta property is reserved by ACP to allow clients and agents to attach additional
3221+
metadata to their interactions. Implementations MUST NOT make assumptions about values at
3222+
these keys.
3223+
3224+
See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)
3225+
3226+
</ResponseField>
3227+
31563228
## <span class="font-mono">SessionUpdate</span>
31573229

31583230
Different types of updates that can be sent during session processing.

‎schema/v1/meta.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@
66
"session_new": "session/new",
77
"session_load": "session/load",
88
"session_set_mode": "session/set_mode",
9+
"session_set_title": "session/setTitle",
910
"session_set_config_option": "session/set_config_option",
1011
"session_prompt": "session/prompt",
1112
"session_cancel": "session/cancel",

‎schema/v1/meta.unstable.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@
99
"session_new": "session/new",
1010
"session_load": "session/load",
1111
"session_set_mode": "session/set_mode",
12+
"session_set_title": "session/setTitle",
1213
"session_set_config_option": "session/set_config_option",
1314
"session_prompt": "session/prompt",
1415
"session_cancel": "session/cancel",

0 commit comments

Comments
 (0)