@semiont/gateway 0.5.30 → 0.5.31

package/dist/openapi.json

@@ -1688,10 +1688,13 @@
             "description": "Web Annotation creator — the entity that initiated the annotation. For human-driven work this is a Person; for autonomous-agent work this is a Software peer."
           },
           "created": {
-            "type": "string"
+            "type": "string",
+            "format": "date-time",
+            "description": "When the annotation was MADE — the authoring moment, carried from the event that created it. Not when a projection happened to write it: a store that rebuilds from the log must preserve this value, never restamp it."
           },
           "modified": {
-            "type": "string"
+            "type": "string",
+            "format": "date-time"
           },
           "generator": {
             "oneOf": [
@@ -1729,7 +1732,8 @@
           "type",
           "id",
           "motivation",
-          "target"
+          "target",
+          "created"
         ]
       },
       "AnnotationAddedPayload": {
@@ -2767,18 +2771,13 @@
       },
       "BrowseAnchoredTextResult": {
         "type": "object",
-        "description": "A resource's stored extraction outcome — the coordinate map with its provenance, or a named decline — or null when none has been derived. Null is the common case and not an error: a native text layer is read in the browser, and a media type with no extractor never produces one.",
+        "description": "A resource's coordinate map, a stored decline, or a named reason there is none (SMELTER-OWNS-OCR P1). Never null: absence used to be a bare null covering four different facts — barrier expired, settled-skipped, no content identity, fold disposed — two of which a caller should retry and two of which it should not.",
         "properties": {
           "correlationId": {
             "type": "string"
           },
           "response": {
-            "nullable": true,
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/ExtractionOutcome"
-              }
-            ]
+            "$ref": "#/components/schemas/AnchoredTextAnswer"
           }
         },
         "required": [
@@ -2786,20 +2785,46 @@
           "response"
         ]
       },
-      "BrowseAnchoredTextByChecksumRequest": {
+      "AnchoredTextAnswer": {
+        "description": "What a reader gets when it asks for a resource's coordinate map: the map, a stored decline, or a named absence.\n\nDistinct from `ExtractionOutcome` on purpose. That type is what the STORE holds and what an extractor RETURNS — neither of which can ever be 'not yet'. This is the read answer, which can, so widening ExtractionOutcome itself would have put an impossible state into the store's own type.\n\nFlat, one discriminant: every member carries `kind`, rather than nesting an outcome inside a status envelope and giving the wire two `kind` fields at different depths.",
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/ExtractedText"
+          },
+          {
+            "$ref": "#/components/schemas/ExtractionDeclined"
+          },
+          {
+            "$ref": "#/components/schemas/AnchoredTextAbsent"
+          }
+        ],
+        "discriminator": {
+          "propertyName": "kind",
+          "mapping": {
+            "extracted": "#/components/schemas/ExtractedText",
+            "declined": "#/components/schemas/ExtractionDeclined",
+            "not-yet": "#/components/schemas/AnchoredTextAbsent",
+            "no-map": "#/components/schemas/AnchoredTextAbsent",
+            "unknown": "#/components/schemas/AnchoredTextAbsent"
+          }
+        }
+      },
+      "AnchoredTextAbsent": {
         "type": "object",
-        "description": "Request the stored extraction outcome for a content identity the caller already holds — the detection workers' read-through cache consult (ANCHORED-TEXT-TO-SMELTER P2). A hit — success or decline — is served whole and the caller skips extraction; null is a miss and the caller extracts locally. Read-only: the Smelter is the sole writer and never answers over this channel.",
+        "description": "There is no coordinate map to serve, and WHY — the distinction a bare null could not carry (SMELTER-OWNS-OCR P1).\n\nOne member covers all three absences because none carries a payload; `kind` alone is the fact. Retryability is legible from the name, deliberately: a caller must not need a lookup table to decide whether to come back.",
         "properties": {
-          "correlationId": {
-            "type": "string"
-          },
-          "checksum": {
-            "type": "string"
+          "kind": {
+            "type": "string",
+            "enum": [
+              "not-yet",
+              "no-map",
+              "unknown"
+            ],
+            "description": "Discriminant, sharing the `kind` field with the ExtractedText/ExtractionDeclined members so the whole answer is one flat union (D6).\n\n`not-yet` — the Smelter has not settled this content generation: the settle barrier expired, the progress fold was disposed, or it settled indexed and the artifact is missing (the reconcile planner's third drift class, which heals). RETRY.\n\n`no-map` — the Smelter settled this resource as skipped: its media type derives no geometry, so a map will never exist. TERMINAL.\n\n`unknown` — no content identity to look up: the resource is not in the view store, or its primary representation carries no checksum. TERMINAL."
           }
         },
         "required": [
-          "correlationId",
-          "checksum"
+          "kind"
         ]
       },
       "BrowseResourceRequest": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semiont/gateway",
-  "version": "0.5.30",
+  "version": "0.5.31",
   "type": "module",
   "description": "Semiont gateway server - pre-built for npm consumption",
   "main": "dist/index.js",
@@ -30,9 +30,9 @@
     "@hono/swagger-ui": "^0.6.1",
     "@prisma/adapter-pg": "^7.10.0",
     "@prisma/client": "^7.10.0",
-    "@semiont/core": "0.5.30",
-    "@semiont/make-meaning": "0.5.30",
-    "@semiont/observability": "0.5.30",
+    "@semiont/core": "0.5.31",
+    "@semiont/make-meaning": "0.5.31",
+    "@semiont/observability": "0.5.31",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
     "argon2": "^0.45.1",
@@ -40,6 +40,6 @@
     "jsonwebtoken": "^9.0.2",
     "prisma": "^7.10.0",
     "winston": "^3.19.0",
-    "zod": "^4.4.3"
+    "zod": "^4.5.4"
   }
 }