# wire

> the exact bytes that cross the wire — codes, sequences, and registry values, for humans and agents

## Agent contract

- Canonical id == permalink path: `{family}[/{namespace}]/{slug}` (e.g. `terminal-osc/133`).
- Get JSON: send `Accept: application/json` on a bare path, OR append `.json`.
- Sub-facts are `#fragments` (e.g. `terminal-osc/133#D`); the parent JSON already holds them.
- Under-specified guesses 301-redirect to the canonical id.
- Enumerate per-family manifests below and fetch entries by constructed id; don't scrape HTML.
- Root manifest: /index.json

## Families

- [cbor-tag](/cbor-tag/index.json) — CBOR tags (260)
- [dns-rrtype](/dns-rrtype/index.json) — DNS resource-record types (97)
- [encoding](/encoding/index.json) — encodings (base64, punycode …) (13)
- [http-header](/http-header/index.json) — HTTP header fields (142)
- [http-method](/http-method/index.json) — HTTP request methods (41)
- [http-status](/http-status/index.json) — HTTP status codes (64)
- [identifier](/identifier/index.json) — unique identifier formats (12)
- [link-relation](/link-relation/index.json) — link relation types (133)
- [magic](/magic/index.json) — file magic numbers / signatures (24)
- [media-type](/media-type/index.json) — IANA media types (2294)
- [port](/port/index.json) — well-known service ports (686)
- [terminal-csi](/terminal-csi/index.json) — CSI control sequences (16)
- [terminal-dec-private-mode](/terminal-dec-private-mode/index.json) — DEC private modes (CSI ? Pm h/l) (15)
- [terminal-osc](/terminal-osc/index.json) — OSC operating-system commands (17)
- [tls-param](/tls-param/index.json) — TLS parameters (cipher suites …) (35)
- [uri-scheme](/uri-scheme/index.json) — URI schemes (99)
- [well-known-uri](/well-known-uri/index.json) — well-known URIs (99)
- [wire-format](/wire-format/index.json) — binary wire formats & TLV (12)