Host protocol
A TCC host durably stores continuation state and coordinates effects, events, timers, and child activation on behalf of the engine.
TCC Engine ↓host_protocol_version: 1 ↓your host ├── persistence ├── effects ├── events ├── timers └── schedulingHost protocol version 1 is required. Trigora Cloud rejects requests with a missing or unrecognized version, and the reference hosts implement the same version.
The conformance suite verifies these rules:
- A write becomes durable only when the store commits and returns
persist_confirmed; an earlierackdoes not confirm durability. - Resume reconstructs state from a snapshot and semantic deltas. The host runs the stored artifact, while any artifact supplied by the caller serves only as a consistency check. A different hash produces an artifact mismatch.
invokeuses a stable child id and activates the child only after the parent and child records are durable, preventing duplicate child Executions.- A crash before commit leaves no child. A crash after commit and before activation resumes the same child row.
The engine fixtures and conformance runner in tcc-engine define the protocol behavior. The Trigora HTTP API is a separate interface for Programs and Executions: implementing /v1/executions does not implement the TCC host protocol, and implementing the host protocol does not provide the Trigora HTTP API.