Merge 2.0 to master (#651)

specs/api/components/schemas/embeddings-query/RowEmbeddingsQueryRequest.yaml

@@ -0,0 +1,39 @@
+type: object
+description: |
+  Row embeddings query request - find similar rows by vector similarity on indexed fields.
+  Enables semantic/fuzzy matching on structured data.
+required:
+  - vectors
+  - schema_name
+properties:
+  vectors:
+    type: array
+    description: Query embedding vector
+    items:
+      type: number
+    example: [0.023, -0.142, 0.089, 0.234, -0.067, 0.156]
+  schema_name:
+    type: string
+    description: Schema name to search within
+    example: customers
+  index_name:
+    type: string
+    description: Optional index name to filter search to specific index
+    example: full_name
+  limit:
+    type: integer
+    description: Maximum number of matches to return
+    default: 10
+    minimum: 1
+    maximum: 1000
+    example: 20
+  user:
+    type: string
+    description: User identifier
+    default: trustgraph
+    example: alice
+  collection:
+    type: string
+    description: Collection to search
+    default: default
+    example: sales

specs/api/components/schemas/embeddings-query/RowEmbeddingsQueryResponse.yaml

@@ -0,0 +1,53 @@
+type: object
+description: Row embeddings query response with matching row index information
+properties:
+  error:
+    type: object
+    description: Error information if query failed
+    properties:
+      type:
+        type: string
+        description: Error type identifier
+        example: row-embeddings-query-error
+      message:
+        type: string
+        description: Human-readable error message
+        example: Schema not found
+  matches:
+    type: array
+    description: List of matching row index entries with similarity scores
+    items:
+      type: object
+      properties:
+        index_name:
+          type: string
+          description: Name of the indexed field(s)
+          example: full_name
+        index_value:
+          type: array
+          description: Values of the indexed fields for this row
+          items:
+            type: string
+          example: ["John", "Smith"]
+        text:
+          type: string
+          description: The text that was embedded for this index entry
+          example: "John Smith"
+        score:
+          type: number
+          description: Similarity score (higher is more similar)
+          example: 0.89
+example:
+  matches:
+    - index_name: full_name
+      index_value: ["John", "Smith"]
+      text: "John Smith"
+      score: 0.95
+    - index_name: full_name
+      index_value: ["Jon", "Smythe"]
+      text: "Jon Smythe"
+      score: 0.82
+    - index_name: full_name
+      index_value: ["Jonathan", "Schmidt"]
+      text: "Jonathan Schmidt"
+      score: 0.76

specs/api/components/schemas/query/RowsQueryRequest.yaml

@@ -1,6 +1,6 @@
 type: object
 description: |
-  Objects query request - GraphQL query over knowledge graph.
+  Rows query request - GraphQL query over structured data.
 required:
   - query
 properties:

specs/api/components/schemas/query/RowsQueryResponse.yaml

@@ -1,5 +1,5 @@
 type: object
-description: Objects query response (GraphQL format)
+description: Rows query response (GraphQL format)
 properties:
   data:
     description: GraphQL response data (JSON object or null)