Seat definition format: states replace records, operator-channel's asks first (ADR 0608 §1, ADR 0634 §6; issue 1966)

Claude-Session: https://claude.ai/code/session_01JG73KJNrH5EgFXMKKYSrig

format/seat-definition.schema.json

@@ -130,27 +130,11 @@
       },
       "description": "the holder's own events listed beside the seat, keeping the holder's subjects (ADR 0620 \u00a72)"
     },
-    "records": {
+    "states": {
       "type": "array",
+      "description": "the layouts of the state the holder keeps on the bus for the seat (ADR 0608 \u00a71, ADR 0634 \u00a76); a whole definition's. No holder module is named: each reader takes the holder from its own manifest's reads",
       "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": [
-          "name"
-        ],
-        "properties": {
-          "name": {
-            "type": "string",
-            "pattern": "^[a-z][a-z0-9-]*$"
-          },
-          "key": {
-            "type": "string"
-          },
-          "value": {
-            "type": "object",
-            "description": "a JSON Schema"
-          }
-        }
+        "$ref": "#/$defs/state"
       }
     },
     "provisions": {
@@ -377,7 +361,7 @@
           },
           "of": {
             "type": "string",
-            "pattern": "^(verb:[a-z][a-z0-9-]*\\.(input|answer)|accept:[a-z][a-z0-9-]*|event:[a-z][a-z0-9-]*|holder-event:[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)*)$"
+            "pattern": "^(verb:[a-z][a-z0-9-]*\\.(input|answer)|accept:[a-z][a-z0-9-]*|event:[a-z][a-z0-9-]*|state:[a-z][a-z0-9-]*/.+|holder-event:[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)*)$"
           },
           "subject": {
             "type": "string"
@@ -410,6 +394,81 @@
           "uniqueItems": true
         }
       }
+    },
+    "state": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "template",
+        "key-forms"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "template": {
+          "enum": [
+            "state",
+            "events",
+            "work-queue",
+            "log",
+            "objects",
+            "ledger"
+          ],
+          "description": "ADR 0595 \u00a72"
+        },
+        "writer": {
+          "enum": [
+            "holder",
+            "caller"
+          ],
+          "description": "holder when not given; caller when the seat's callers write their own keys"
+        },
+        "key-forms": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/keyForm"
+          }
+        },
+        "history": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "past values a key keeps; the state template only"
+        },
+        "max-age-days": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "days a message is kept; the events, work-queue and log templates only"
+        },
+        "description": {
+          "type": "string"
+        }
+      }
+    },
+    "keyForm": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "key",
+        "value"
+      ],
+      "properties": {
+        "key": {
+          "type": "string",
+          "minLength": 1,
+          "description": "a pattern of named parts between angle brackets, the rest literal: <asker>.<id>"
+        },
+        "value": {
+          "type": "object",
+          "description": "a JSON Schema"
+        },
+        "description": {
+          "type": "string"
+        }
+      }
     }
   }
 }