CORE · ARCHITECTURE
Terminal state has one source of truth.
The server interprets control sequences once and clients replicate validated semantic state. Disconnect recovery, multi-device display, and history paging therefore share the same facts.
State pipeline
PTY bytes→TerminalEngine→State v2→Replica→Renderer
Core objects
- Workspace
- A persistent server resource container for Terminals.
- Terminal
- Owns the PTY, process, and authoritative terminal engine.
- Attachment
- A device subscription with role, state, and fencing identity.
- Worker
- A long-lived unprivileged process isolated by Unix UID in Managed mode.
Responsibilities
| Layer | Responsibility |
|---|---|
| Server | PTY, VT interpretation, semantic cells, history, leases, and admission |
| Apple client | Replica, native rendering, local tab layout, and device viewport |
| Transport | TLS 1.3, authentication, capability negotiation, and independent streams |
Transport
One QUIC connection carries control requests, Terminal Attachments, and Files/1. Independent streams keep file transfers and slow requests from causing transport-level head-of-line blocking for terminal traffic.