feat: Stabilize Session Config Options (#411)

* feat: Stabilize Session Config Options

* Finialize docs

* update

Author: benbrandt

Cargo.toml

@@ -16,7 +16,6 @@ include = ["/src/**/*.rs", "/README.md", "/LICENSE", "/Cargo.toml"]
 [features]
 unstable = [
     "unstable_cancel_request",
-    "unstable_session_config_options",
     "unstable_session_fork",
     "unstable_session_info_update",
     "unstable_session_list",
@@ -25,7 +24,6 @@ unstable = [
     "unstable_session_usage",
 ]
 unstable_cancel_request = []
-unstable_session_config_options = []
 unstable_session_fork = []
 unstable_session_info_update = []
 unstable_session_list = []

docs/docs.json

@@ -72,6 +72,7 @@
               "protocol/terminals",
               "protocol/agent-plan",
               "protocol/session-modes",
+              "protocol/session-config-options",
               "protocol/slash-commands",
               "protocol/extensibility",
               "protocol/transports",
@@ -81,7 +82,6 @@
                 "hidden": true,
                 "pages": [
                   "protocol/draft/cancellation",
-                  "protocol/draft/session-config-options",
                   "protocol/draft/schema"
                 ]
               }
@@ -123,8 +123,14 @@
               "rfds/session-delete"
             ]
           },
-          { "group": "Preview", "pages": ["rfds/session-config-options"] },
-          { "group": "Completed", "pages": ["rfds/introduce-rfd-process"] }
+          { "group": "Preview", "pages": [] },
+          {
+            "group": "Completed",
+            "pages": [
+              "rfds/introduce-rfd-process",
+              "rfds/session-config-options"
+            ]
+          }
         ]
       },
       {

docs/protocol/draft/schema.mdx

@@ -267,12 +267,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/exte
 
 </ResponseField>
 <ResponseField name="configOptions" type={<><span><a href="#sessionconfigoption">SessionConfigOption[]</a></span><span> | null</span></>} >
-  **UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
-Initial session configuration options if supported by the Agent.
-
+  Initial session configuration options if supported by the Agent.
 </ResponseField>
 <ResponseField name="models" type={<><span><a href="#sessionmodelstate">SessionModelState</a></span><span> | null</span></>} >
   **UNSTABLE**
@@ -424,12 +419,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/exte
 
 </ResponseField>
 <ResponseField name="configOptions" type={<><span><a href="#sessionconfigoption">SessionConfigOption[]</a></span><span> | null</span></>} >
-  **UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
-Initial session configuration options if supported by the Agent.
-
+  Initial session configuration options if supported by the Agent.
 </ResponseField>
 <ResponseField name="models" type={<><span><a href="#sessionmodelstate">SessionModelState</a></span><span> | null</span></>} >
   **UNSTABLE**
@@ -507,12 +497,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/exte
 
 </ResponseField>
 <ResponseField name="configOptions" type={<><span><a href="#sessionconfigoption">SessionConfigOption[]</a></span><span> | null</span></>} >
-  **UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
-Initial session configuration options if supported by the Agent.
-
+  Initial session configuration options if supported by the Agent.
 </ResponseField>
 <ResponseField name="models" type={<><span><a href="#sessionmodelstate">SessionModelState</a></span><span> | null</span></>} >
   **UNSTABLE**
@@ -691,12 +676,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/exte
 
 </ResponseField>
 <ResponseField name="configOptions" type={<><span><a href="#sessionconfigoption">SessionConfigOption[]</a></span><span> | null</span></>} >
-  **UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
-Initial session configuration options if supported by the Agent.
-
+  Initial session configuration options if supported by the Agent.
 </ResponseField>
 <ResponseField name="models" type={<><span><a href="#sessionmodelstate">SessionModelState</a></span><span> | null</span></>} >
   **UNSTABLE**
@@ -716,18 +696,10 @@ See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/sess
 <a id="session-set_config_option"></a>
 ### <span class="font-mono">session/set_config_option</span>
 
-**UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
 Sets the current value for a session configuration option.
 
 #### <span class="font-mono">SetSessionConfigOptionRequest</span>
 
-**UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
 Request parameters for setting a session configuration option.
 
 **Type:** Object
@@ -754,10 +726,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/exte
 
 #### <span class="font-mono">SetSessionConfigOptionResponse</span>
 
-**UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
 Response to `session/set_config_option` method.
 
 **Type:** Object
@@ -1737,10 +1705,6 @@ Determines which file operations the agent can request.
 
 ## <span class="font-mono">ConfigOptionUpdate</span>
 
-**UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
 Session configuration options have been updated.
 
 **Type:** Object
@@ -3007,30 +2971,18 @@ Whether the agent supports `session/resume`.
 
 ## <span class="font-mono">SessionConfigGroupId</span>
 
-**UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
 Unique identifier for a session configuration option value group.
 
 **Type:** `string`
 
 ## <span class="font-mono">SessionConfigId</span>
 
-**UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
 Unique identifier for a session configuration option.
 
 **Type:** `string`
 
 ## <span class="font-mono">SessionConfigOption</span>
 
-**UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
 A session configuration option selector and its current state.
 
 **Type:** Union
@@ -3061,10 +3013,6 @@ Single-value selector (dropdown).
 
 ## <span class="font-mono">SessionConfigOptionCategory</span>
 
-**UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
 Semantic category for a session configuration option.
 
 This is intended to help Clients distinguish broadly common selectors (e.g. model selector vs
@@ -3095,10 +3043,6 @@ Category names that do not begin with `_` are reserved for the ACP spec.
 
 ## <span class="font-mono">SessionConfigSelect</span>
 
-**UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
 A single-value selector (dropdown) session configuration option payload.
 
 **Type:** Object
@@ -3122,10 +3066,6 @@ A single-value selector (dropdown) session configuration option payload.
 
 ## <span class="font-mono">SessionConfigSelectGroup</span>
 
-**UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
 A group of possible values for a session configuration option.
 
 **Type:** Object
@@ -3152,10 +3092,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/exte
 
 ## <span class="font-mono">SessionConfigSelectOption</span>
 
-**UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
 A possible value for a session configuration option.
 
 **Type:** Object
@@ -3182,10 +3118,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/exte
 
 ## <span class="font-mono">SessionConfigSelectOptions</span>
 
-**UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
 Possible values for a session configuration option.
 
 **Type:** Union
@@ -3200,10 +3132,6 @@ Possible values for a session configuration option.
 
 ## <span class="font-mono">SessionConfigValueId</span>
 
-**UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
 Unique identifier for a session configuration option value.
 
 **Type:** `string`
@@ -3664,10 +3592,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/exte
 </ResponseField>
 
 <ResponseField name="config_option_update" type="object">
-**UNSTABLE**
-
-This capability is not part of the spec yet, and may be removed or changed at any point.
-
 Session configuration options have been updated.
 
 <Expandable title="Properties">