@semiont/backend 0.5.1 → 0.5.3

package/dist/openapi.json

@@ -3310,7 +3310,7 @@
       },
       "EntityTypeAddedPayload": {
         "type": "object",
-        "description": "Payload for mark:entity-type-added domain event",
+        "description": "Payload for frame:entity-type-added domain event (system-level, no resourceId — fan-out is global)",
         "properties": {
           "entityType": {
             "type": "string"
@@ -3320,6 +3320,18 @@
           "entityType"
         ]
       },
+      "TagSchemaAddedPayload": {
+        "type": "object",
+        "description": "Payload for frame:tag-schema-added domain event (system-level, no resourceId — fan-out is global to the KB).",
+        "properties": {
+          "schema": {
+            "$ref": "#/components/schemas/TagSchema"
+          }
+        },
+        "required": [
+          "schema"
+        ]
+      },
       "EntityTagChangedPayload": {
         "type": "object",
         "description": "Payload for mark:entity-tag-added and mark:entity-tag-removed domain events",
@@ -3730,6 +3742,20 @@
           "entityReferences"
         ]
       },
+      "GetTagSchemasResponse": {
+        "type": "object",
+        "properties": {
+          "tagSchemas": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TagSchema"
+            }
+          }
+        },
+        "required": [
+          "tagSchemas"
+        ]
+      },
       "GoogleAuthRequest": {
         "type": "object",
         "properties": {
@@ -5494,6 +5520,34 @@
           "path"
         ]
       },
+      "BrowseTagSchemasRequest": {
+        "type": "object",
+        "description": "Request to browse registered tag schemas",
+        "properties": {
+          "correlationId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "correlationId"
+        ]
+      },
+      "BrowseTagSchemasResult": {
+        "type": "object",
+        "description": "Result of browsing tag schemas",
+        "properties": {
+          "correlationId": {
+            "type": "string"
+          },
+          "response": {
+            "$ref": "#/components/schemas/GetTagSchemasResponse"
+          }
+        },
+        "required": [
+          "correlationId",
+          "response"
+        ]
+      },
       "FragmentSelector": {
         "type": "object",
         "description": "W3C Web Annotation FragmentSelector for media fragment identifiers (RFC 3778 for PDFs)",
@@ -6338,9 +6392,9 @@
           "byCategory"
         ]
       },
-      "MarkAddEntityTypeCommand": {
+      "FrameAddEntityTypeCommand": {
         "type": "object",
-        "description": "Bus command to add a new entity type tag.",
+        "description": "Bus command to add a new entity type to the KB's vocabulary. Carried on the `frame:add-entity-type` channel — Frame is the schema-layer flow that owns vocabulary writes.",
         "properties": {
           "tag": {
             "type": "string"
@@ -6354,6 +6408,22 @@
           "tag"
         ]
       },
+      "FrameAddTagSchemaCommand": {
+        "type": "object",
+        "description": "Bus command to register a tag schema with the KB's runtime registry. Carried on the `frame:add-tag-schema` channel — Frame is the schema-layer flow that owns vocabulary writes. Most-recent registration of a given `schema.id` wins; the projection reflects the latest content. Identical re-registrations are silent; differing content overwrites and logs a warning.",
+        "properties": {
+          "schema": {
+            "$ref": "#/components/schemas/TagSchema"
+          },
+          "_userId": {
+            "type": "string",
+            "description": "Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this."
+          }
+        },
+        "required": [
+          "schema"
+        ]
+      },
       "MarkArchiveCommand": {
         "type": "object",
         "description": "Bus command to archive a resource and optionally remove its file.",
@@ -6890,6 +6960,61 @@
           "value"
         ]
       },
+      "TagCategory": {
+        "type": "object",
+        "description": "A single category within a tag schema (e.g. 'Issue' in IRAC, 'distinguished' in legal-citation-treatment). Each category carries methodology-bound semantics: a name, a description, and examples used in the LLM prompt.",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "examples": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "name",
+          "description",
+          "examples"
+        ]
+      },
+      "TagSchema": {
+        "type": "object",
+        "description": "A structural-analysis schema (e.g. legal-irac, scientific-imrad, argument-toulmin). Defines a methodology framework as an id, name, description, domain hint, and an ordered list of categories. KBs and their skills register schemas with the runtime registry via `frame.addTagSchema(...)` at session start.",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "domain": {
+            "type": "string",
+            "description": "Free-form domain hint (e.g. 'legal', 'scientific', 'general'). Used in the LLM prompt to tune the model's analysis voice. KB authors choose."
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TagCategory"
+            }
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "description",
+          "domain",
+          "tags"
+        ]
+      },
       "YieldCloneCreateCommand": {
         "type": "object",
         "description": "Bus command to create a cloned resource from a clone token.",
@@ -7102,57 +7227,6 @@
           "toUri"
         ]
       },
-      "YieldRequestCommand": {
-        "type": "object",
-        "description": "Bus command to request yield (generation) of a new resource from an annotation.",
-        "properties": {
-          "correlationId": {
-            "type": "string",
-            "description": "Client-supplied id used to match this command to its result event(s) on the events-stream. Generated by the route handler if absent."
-          },
-          "annotationId": {
-            "type": "string"
-          },
-          "resourceId": {
-            "type": "string"
-          },
-          "options": {
-            "type": "object",
-            "properties": {
-              "title": {
-                "type": "string"
-              },
-              "prompt": {
-                "type": "string"
-              },
-              "language": {
-                "type": "string"
-              },
-              "temperature": {
-                "type": "number"
-              },
-              "maxTokens": {
-                "type": "integer"
-              },
-              "context": {
-                "$ref": "#/components/schemas/GatheredContext"
-              },
-              "storageUri": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "title",
-              "storageUri"
-            ]
-          }
-        },
-        "required": [
-          "annotationId",
-          "resourceId",
-          "options"
-        ]
-      },
       "YieldUpdateCommand": {
         "type": "object",
         "description": "Bus command to update a yielded resource's storage content.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semiont/backend",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "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.5.1",
-    "@semiont/event-sourcing": "^0.5.1",
-    "@semiont/jobs": "^0.5.1",
-    "@semiont/make-meaning": "^0.5.1",
+    "@semiont/core": "^0.5.3",
+    "@semiont/event-sourcing": "^0.5.3",
+    "@semiont/jobs": "^0.5.3",
+    "@semiont/make-meaning": "^0.5.3",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "argon2": "^0.44.0",