@semiont/backend 0.4.7 → 0.4.11

package/dist/openapi.json

@@ -507,6 +507,52 @@
         }
       }
     },
+    "/api/tokens/media": {
+      "post": {
+        "summary": "Generate Media Token",
+        "description": "Generate a short-lived, resource-scoped media token for use as a ?token= query parameter on binary resource URLs (images, PDFs). Requires session authentication.",
+        "tags": [
+          "Authentication"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/MediaTokenRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Media token generated",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/MediaTokenResponse"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/users/me": {
       "get": {
         "summary": "Get Current User",
@@ -1695,6 +1741,65 @@
         }
       }
     },
+    "/resources/{id}/match-search-stream": {
+      "post": {
+        "summary": "Match Search (SSE Stream)",
+        "description": "Search for binding candidates for a reference annotation via Server-Sent Events. Delegates to the Matcher actor on the backend EventBus.",
+        "tags": [
+          "Resources",
+          "Annotations",
+          "Real-time",
+          "AI"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string"
+            },
+            "required": true,
+            "name": "id",
+            "in": "path",
+            "description": "Resource ID"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/MatchSearchStreamRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "SSE stream opened successfully",
+            "content": {
+              "text/event-stream": {
+                "schema": {
+                  "$ref": "#/components/schemas/EventStreamResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "referenceId and context are required"
+          },
+          "401": {
+            "description": "Authentication required"
+          },
+          "404": {
+            "description": "Resource not found"
+          }
+        }
+      }
+    },
     "/resources/{resourceId}/annotations/{annotationId}/gather-annotation-stream": {
       "post": {
         "summary": "Gather Annotation LLM Context (SSE Stream)",
@@ -4129,6 +4234,10 @@
       "GatherResourceStreamRequest": {
         "type": "object",
         "properties": {
+          "correlationId": {
+            "type": "string",
+            "description": "Client-generated correlation ID to thread the response back to the originating request"
+          },
           "depth": {
             "type": "integer",
             "minimum": 1,
@@ -4154,6 +4263,10 @@
       "GatherAnnotationStreamRequest": {
         "type": "object",
         "properties": {
+          "correlationId": {
+            "type": "string",
+            "description": "Client-generated correlation ID to thread the response back to the originating request"
+          },
           "contextWindow": {
             "type": "integer",
             "minimum": 100,
@@ -5979,6 +6092,9 @@
           "isAdmin": {
             "type": "boolean"
           },
+          "isModerator": {
+            "type": "boolean"
+          },
           "isActive": {
             "type": "boolean"
           },
@@ -6006,6 +6122,7 @@
           "domain",
           "provider",
           "isAdmin",
+          "isModerator",
           "isActive",
           "termsAcceptedAt",
           "lastLogin",
@@ -6077,6 +6194,30 @@
         ],
         "description": "W3C Web Annotation body purpose vocabulary - https://www.w3.org/TR/annotation-vocab/#motivation"
       },
+      "MediaTokenRequest": {
+        "type": "object",
+        "properties": {
+          "resourceId": {
+            "type": "string",
+            "description": "The resource ID to generate a media token for"
+          }
+        },
+        "required": [
+          "resourceId"
+        ]
+      },
+      "MediaTokenResponse": {
+        "type": "object",
+        "properties": {
+          "token": {
+            "type": "string",
+            "description": "Short-lived media token for use as ?token= query parameter on resource URLs"
+          }
+        },
+        "required": [
+          "token"
+        ]
+      },
       "GatheredContext": {
         "type": "object",
         "description": "Context gathered for an annotation. Includes source document excerpts, metadata, and graph-derived context. Used by both Find (bind) and Generate (yield) flows.",
@@ -6220,6 +6361,37 @@
           "annotation",
           "sourceResource"
         ]
+      },
+      "MatchSearchStreamRequest": {
+        "type": "object",
+        "properties": {
+          "correlationId": {
+            "type": "string",
+            "description": "Client-generated correlation ID to thread the response back to the originating request"
+          },
+          "referenceId": {
+            "type": "string",
+            "description": "Annotation ID of the reference to search candidates for"
+          },
+          "context": {
+            "$ref": "#/components/schemas/GatheredContext",
+            "description": "Gathered context for the reference annotation"
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 20,
+            "description": "Maximum number of candidate results to return (default: 10)"
+          },
+          "useSemanticScoring": {
+            "type": "boolean",
+            "description": "Enable semantic similarity scoring in addition to keyword matching (default: true)"
+          }
+        },
+        "required": [
+          "referenceId",
+          "context"
+        ]
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semiont/backend",
-  "version": "0.4.7",
+  "version": "0.4.11",
   "type": "module",
   "description": "Semiont backend server - pre-built for npm consumption",
   "main": "dist/index.js",
@@ -20,10 +20,10 @@
     "@hono/swagger-ui": "^0.6.1",
     "@prisma/adapter-pg": "^7.5.0",
     "@prisma/client": "^7.5.0",
-    "@semiont/core": "^0.4.7",
-    "@semiont/event-sourcing": "^0.4.7",
-    "@semiont/jobs": "^0.4.7",
-    "@semiont/make-meaning": "^0.4.7",
+    "@semiont/core": "^0.4.11",
+    "@semiont/event-sourcing": "^0.4.11",
+    "@semiont/jobs": "^0.4.11",
+    "@semiont/make-meaning": "^0.4.11",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "argon2": "^0.44.0",