# 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 …) (6)
- [http-method](/http-method/index.json) — HTTP request methods (41)
- [http-status](/http-status/index.json) — HTTP status codes (64)
- [port](/port/index.json) — well-known service ports (686)
- [terminal-csi](/terminal-csi/index.json) — CSI control sequences (1)
- [terminal-dec-private-mode](/terminal-dec-private-mode/index.json) — DEC private modes (CSI ? Pm h/l) (5)
- [terminal-osc](/terminal-osc/index.json) — OSC operating-system commands (8)
- [tls-param](/tls-param/index.json) — TLS parameters (cipher suites …) (35)
- [uri-scheme](/uri-scheme/index.json) — URI schemes (99)