@semiont/backend 0.5.2 → 0.5.3

package/dist/index.js

@@ -11988,6 +11988,18 @@ var openapi_default = {
           "entityType"
         ]
       },
+      TagSchemaAddedPayload: {
+        type: "object",
+        description: "Payload for frame:tag-schema-added domain event (system-level, no resourceId \u2014 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",
@@ -12398,6 +12410,20 @@ var openapi_default = {
           "entityReferences"
         ]
       },
+      GetTagSchemasResponse: {
+        type: "object",
+        properties: {
+          tagSchemas: {
+            type: "array",
+            items: {
+              $ref: "#/components/schemas/TagSchema"
+            }
+          }
+        },
+        required: [
+          "tagSchemas"
+        ]
+      },
       GoogleAuthRequest: {
         type: "object",
         properties: {
@@ -14162,6 +14188,34 @@ var openapi_default = {
           "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)",
@@ -15022,6 +15076,22 @@ var openapi_default = {
           "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 \u2014 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.",
@@ -15558,6 +15628,61 @@ var openapi_default = {
           "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.",
@@ -15770,57 +15895,6 @@ var openapi_default = {
           "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.",