feat(unstable): Create dedicated elicitation module

And also make sure enums have newtype pattern

Author: benbrandt

docs/protocol/draft/schema.mdx

@@ -2609,6 +2609,22 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/exte
   The file path being modified.
 </ResponseField>
 
+## <span class="font-mono">ElicitationAcceptAction</span>
+
+**UNSTABLE**
+
+This capability is not part of the spec yet, and may be removed or changed at any point.
+
+The user accepted the elicitation and provided content.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="content" type={"object"}>
+  The user-provided content, if any.
+</ResponseField>
+
 ## <span class="font-mono">ElicitationAction</span>
 
 **UNSTABLE**
@@ -2706,12 +2722,24 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/exte
 
 </ResponseField>
 
-## <span class="font-mono">ElicitationId</span>
+## <span class="font-mono">ElicitationFormMode</span>
 
 **UNSTABLE**
 
 This capability is not part of the spec yet, and may be removed or changed at any point.
 
+Form-based elicitation mode where the client renders a form from the provided schema.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="requestedSchema" type={"object"} required>
+  A JSON Schema describing the form fields to present to the user.
+</ResponseField>
+
+## <span class="font-mono">ElicitationId</span>
+
 Unique identifier for an elicitation.
 
 **Type:** `string`
@@ -2737,6 +2765,29 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/exte
 
 </ResponseField>
 
+## <span class="font-mono">ElicitationUrlMode</span>
+
+**UNSTABLE**
+
+This capability is not part of the spec yet, and may be removed or changed at any point.
+
+URL-based elicitation mode where the client directs the user to a URL.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField
+  name="elicitationId"
+  type={<a href="#elicitationid">ElicitationId</a>}
+  required
+>
+  The unique identifier for this elicitation.
+</ResponseField>
+<ResponseField name="url" type={"string"} required>
+  The URL to direct the user to.
+</ResponseField>
+
 ## <span class="font-mono">EmbeddedResource</span>
 
 The contents of a resource, embedded into a prompt or tool call result.

schema/schema.unstable.json

@@ -1458,21 +1458,32 @@
       "required": ["path", "newText"],
       "type": "object"
     },
+    "ElicitationAcceptAction": {
+      "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nThe user accepted the elicitation and provided content.",
+      "properties": {
+        "content": {
+          "description": "The user-provided content, if any."
+        }
+      },
+      "type": "object"
+    },
     "ElicitationAction": {
       "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nThe user's action in response to an elicitation.",
       "discriminator": {
         "propertyName": "action"
       },
       "oneOf": [
         {
+          "allOf": [
+            {
+              "$ref": "#/$defs/ElicitationAcceptAction"
+            }
+          ],
           "description": "The user accepted and provided content.",
           "properties": {
             "action": {
               "const": "accept",
               "type": "string"
-            },
-            "content": {
-              "description": "The user-provided content, if any."
             }
           },
           "required": ["action"],
@@ -1568,8 +1579,18 @@
       },
       "type": "object"
     },
+    "ElicitationFormMode": {
+      "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nForm-based elicitation mode where the client renders a form from the provided schema.",
+      "properties": {
+        "requestedSchema": {
+          "description": "A JSON Schema describing the form fields to present to the user."
+        }
+      },
+      "required": ["requestedSchema"],
+      "type": "object"
+    },
     "ElicitationId": {
-      "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nUnique identifier for an elicitation.",
+      "description": "Unique identifier for an elicitation.",
       "type": "string"
     },
     "ElicitationRequest": {
@@ -1579,40 +1600,35 @@
       },
       "oneOf": [
         {
+          "allOf": [
+            {
+              "$ref": "#/$defs/ElicitationFormMode"
+            }
+          ],
           "description": "Form-based elicitation where the client renders a form from the provided schema.",
           "properties": {
             "mode": {
               "const": "form",
               "type": "string"
-            },
-            "requestedSchema": {
-              "description": "A JSON Schema describing the form fields to present to the user."
             }
           },
-          "required": ["mode", "requestedSchema"],
+          "required": ["mode"],
           "type": "object"
         },
         {
+          "allOf": [
+            {
+              "$ref": "#/$defs/ElicitationUrlMode"
+            }
+          ],
           "description": "URL-based elicitation where the client directs the user to a URL.",
           "properties": {
-            "elicitationId": {
-              "allOf": [
-                {
-                  "$ref": "#/$defs/ElicitationId"
-                }
-              ],
-              "description": "The unique identifier for this elicitation."
-            },
             "mode": {
               "const": "url",
               "type": "string"
-            },
-            "url": {
-              "description": "The URL to direct the user to.",
-              "type": "string"
             }
           },
-          "required": ["mode", "elicitationId", "url"],
+          "required": ["mode"],
           "type": "object"
         }
       ],
@@ -1673,6 +1689,25 @@
       },
       "type": "object"
     },
+    "ElicitationUrlMode": {
+      "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nURL-based elicitation mode where the client directs the user to a URL.",
+      "properties": {
+        "elicitationId": {
+          "allOf": [
+            {
+              "$ref": "#/$defs/ElicitationId"
+            }
+          ],
+          "description": "The unique identifier for this elicitation."
+        },
+        "url": {
+          "description": "The URL to direct the user to.",
+          "type": "string"
+        }
+      },
+      "required": ["elicitationId", "url"],
+      "type": "object"
+    },
     "EmbeddedResource": {
       "description": "The contents of a resource, embedded into a prompt or tool call result.",
       "properties": {