open-standards/wai/registry/capabilities.schema.json
Transaction Science 2e7158ff12 wai: HTTP delivery text, the jwp-receipts and SPEC pointers, and the wire identifiers
W3-1. The extension http-delivery.md binds envelopes to HTTP: the proposed media
type, the codecs union and floor, content-addressed objects, the WHP1 head proof,
verified component range fetch with one pick on every path, receipt, key, grant,
set and playlist sidecars, cache rules, priorities and deadlines, HLS/DASH
adjacency, and the capability probe.

Written against main rather than the design's tree: refinements are staged
delivery's (enhancement companions, refinement components, layer objects whose
layer is refines.layer), a `+cap` may be a companion or a refinement, and a
range-fetched refinement component meets staged-delivery §10 through its exploded
envelope (http-delivery §8.3, jwp-receipts §3 step 4). SPEC §7.1's component
id/sha256 text and digest step were already on main, so W3-1a lands nothing.

jwp-receipts: §1 transport pointer, §3 step 4 head-proof cid, new §4.4 and §4.5,
§7.9 locations. moq-streaming-format §6, SPEC §2, §7.1 and the
wai.video.manifest row. The registry gains WIRE_IDENTIFIERS (the request W3 made
to the registry stream, which had not landed), exported as wire_identifiers and
checked against the sections it names. The section-ref check already runs on
every extension (wai-section-refs.yml).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-05 07:15:44 -04:00

233 lines
5.6 KiB
JSON

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://git.transaction.science/Transaction-Science/open-standards/src/branch/main/wai/registry/capabilities.schema.json",
"title": "WAI capability registry",
"description": "Every string SPEC §5 registers, generated by `wai registry export` from the reference implementation's registry (wai-rs/src/codecs/registry.rs). REGISTRY.md states the policy.",
"type": "object",
"additionalProperties": false,
"required": [
"schema",
"capabilities",
"identifiers",
"unregistered_labels",
"wire_identifiers"
],
"properties": {
"schema": {
"type": "string"
},
"capabilities": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"capability",
"kind",
"status",
"media",
"role",
"tier",
"licence",
"replicate",
"sets",
"spec_section",
"edition",
"registered"
],
"properties": {
"capability": {
"type": "string",
"pattern": "^wai(\\.[a-z0-9_]+)+$"
},
"kind": {
"enum": [
"payload",
"companion",
"refinement",
"derivation",
"record"
]
},
"status": {
"enum": [
"registered",
"candidate"
]
},
"media": {
"enum": [
"image",
"audio",
"video",
"text",
"volumetric",
"haptic",
"metadata",
"interactive",
"binary",
null
]
},
"role": {
"enum": [
"standalone",
"companion",
"enhancement",
"refinement",
null
]
},
"tier": {
"enum": [
"lossless",
"lossy",
"perceptual",
null
]
},
"licence": {
"enum": [
"royalty-free",
"patent-pool",
"proprietary",
"non-commercial",
null
]
},
"replicate": {
"enum": [
"standard-defined",
"standard-tolerance",
"standard-unclassified",
"neural-int-exact",
"neural-entropy-exact",
"generative-exact",
"neural-float",
"behavioral",
null
]
},
"sets": {
"type": "array",
"uniqueItems": true,
"items": {
"enum": [
"floor",
"recommended"
]
}
},
"spec_section": {
"type": "string"
},
"edition": {
"type": [
"string",
"null"
],
"description": "The edition the registration names; null means the edition of the named standard current on the date in `registered` (SPEC §8)."
},
"registered": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"description": "The date of the first commit of this repository that registers the string; the specification entered the repository on 2026-06-12."
}
}
}
},
"identifiers": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"identifier",
"spec_section",
"meaning"
],
"properties": {
"identifier": {
"type": "string",
"pattern": "^wai(\\.[a-z0-9_]+)+$"
},
"spec_section": {
"type": "string"
},
"meaning": {
"type": "string"
}
}
}
},
"unregistered_labels": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"label",
"reason"
],
"properties": {
"label": {
"type": "string",
"pattern": "^wai(\\.[a-z0-9_]+)+$"
},
"reason": {
"type": "string"
}
}
}
},
"wire_identifiers": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"kind",
"document",
"section",
"status"
],
"properties": {
"name": {
"type": "string"
},
"kind": {
"enum": [
"media-type",
"codecs-prefix",
"fourcc",
"magic",
"data-id",
"scheme",
"path",
"well-known",
"playlist-tag",
"playlist-attribute",
"document-kind",
"catalog"
]
},
"document": {
"type": "string"
},
"section": {
"type": "string",
"pattern": "^(§[0-9]+(\\.[0-9]+)*|Appendix [A-Z])$"
},
"status": {
"enum": [
"defined",
"provisional",
"proposed"
]
}
}
}
}
}
}