Update docs for 2.2 release (#766)

- Update protocol specs
- Update protocol docs
- Update API specs

specs/websocket/asyncapi.yaml

@@ -2,7 +2,7 @@ asyncapi: 3.0.0
 
 info:
   title: TrustGraph WebSocket API
-  version: "2.1"
+  version: "2.2"
   description: |
     WebSocket API for TrustGraph - providing multiplexed, asynchronous access to all services.
 
@@ -31,7 +31,7 @@ info:
     **Flow-Hosted Services** (require `flow` parameter):
     - agent, text-completion, prompt, document-rag, graph-rag
     - embeddings, graph-embeddings, document-embeddings
-    - triples, rows, nlp-query, structured-query, structured-diag, row-embeddings
+    - triples, rows, nlp-query, structured-query, sparql-query, structured-diag, row-embeddings
     - text-load, document-load, mcp-tool
 
     ## Schema Reuse

specs/websocket/components/messages/ServiceRequest.yaml

@@ -34,6 +34,7 @@ payload:
     - $ref: './requests/RowEmbeddingsRequest.yaml'
     - $ref: './requests/TextLoadRequest.yaml'
     - $ref: './requests/DocumentLoadRequest.yaml'
+    - $ref: './requests/SparqlQueryRequest.yaml'
 
 examples:
   - name: Config service request

specs/websocket/components/messages/requests/SparqlQueryRequest.yaml

@@ -0,0 +1,46 @@
+type: object
+description: WebSocket request for sparql-query service (flow-hosted service)
+required:
+  - id
+  - service
+  - flow
+  - request
+properties:
+  id:
+    type: string
+    description: Unique request identifier
+  service:
+    type: string
+    const: sparql-query
+    description: Service identifier for sparql-query service
+  flow:
+    type: string
+    description: Flow ID
+  request:
+    type: object
+    required:
+      - query
+    properties:
+      query:
+        type: string
+        description: SPARQL 1.1 query string
+      user:
+        type: string
+        default: trustgraph
+        description: User/keyspace identifier
+      collection:
+        type: string
+        default: default
+        description: Collection identifier
+      limit:
+        type: integer
+        default: 10000
+        description: Safety limit on number of results
+examples:
+  - id: req-1
+    service: sparql-query
+    flow: my-flow
+    request:
+      query: "SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 10"
+      user: trustgraph
+      collection: default