pr comments

Author: connor4312

docs/specification/draft/server/tools.mdx

@@ -240,7 +240,7 @@ or data, behind a URI that can be subscribed to or fetched again by the client l
 
 #### Structured Content
 
-**Structured** content is returned as a JSON object in the `structuredContent` field of a result. 
+**Structured** content is returned as a JSON object in the `structuredContent` field of a result.
 
 For backwards compatibility, a tool that returns structured content SHOULD also return functionally equivalent unstructured content.
 (For example, serialized JSON can be returned in a `TextContent` block.)

docs/specification/draft/server/utilities/completion.mdx

@@ -76,6 +76,49 @@ what is being completed through a reference type:
 }
 ```
 
+For prompts or URI templates with multiple arguments, clients should resolve them in the order they are presented by the server, and include each previous completion in the `context.arguments` object to provide context for subsequent requests.
+
+**Request:**
+
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "completion/complete",
+  "params": {
+    "ref": {
+      "type": "ref/prompt",
+      "name": "code_review"
+    },
+    "argument": {
+      "name": "framework",
+      "value": "fla"
+    },
+    "context": {
+      "arguments": {
+        "language": "python"
+      }
+    }
+  }
+}
+```
+
+**Response:**
+
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "result": {
+    "completion": {
+      "values": ["flask"],
+      "total": 1,
+      "hasMore": false
+    }
+  }
+}
+```
+
 ### Reference Types
 
 The protocol supports two types of completion references:
@@ -117,6 +160,8 @@ sequenceDiagram
 - `argument`: Object containing:
   - `name`: Argument name
   - `value`: Current value
+- `context`: Object containing:
+  - `arguments`: A mapping of already-resolved argument names to their values.
 
 ### CompleteResult
 

schema/draft/schema.json

@@ -333,6 +333,19 @@
                             ],
                             "type": "object"
                         },
+                        "context": {
+                            "description": "Additional, optional context for completions",
+                            "properties": {
+                                "arguments": {
+                                    "additionalProperties": {
+                                        "type": "string"
+                                    },
+                                    "description": "Previously-resolved variables in a URI template or prompt.",
+                                    "type": "object"
+                                }
+                            },
+                            "type": "object"
+                        },
                         "ref": {
                             "anyOf": [
                                 {
@@ -342,13 +355,6 @@
                                     "$ref": "#/definitions/ResourceReference"
                                 }
                             ]
-                        },
-                        "resolved": {
-                            "additionalProperties": {
-                                "type": "string"
-                            },
-                            "description": "Previously-resolved variables in a URI template or prompt.",
-                            "type": "object"
                         }
                     },
                     "required": [

schema/draft/schema.ts

@@ -1133,9 +1133,14 @@ export interface CompleteRequest extends Request {
     };
 
     /**
-     * Previously-resolved variables in a URI template or prompt.
+     * Additional, optional context for completions
      */
-    resolved?: { [key: string]: string };
+    context?: {
+       /**
+        * Previously-resolved variables in a URI template or prompt.
+        */
+        arguments?: { [key: string]: string };
+     };
   };
 }