Structs§
- Python
Actor Context - Authenticated actor and scopes captured when dispatch begins.
- Python
Invocation Request - Complete at-most-once invocation envelope.
- Python
Runner Error - Redacted error envelope safe to cross the private runner protocol.
- Python
Runner Hello - Worker-initiated handshake sent before any host request.
- Python
Runner Protocol Version - A separately negotiated runner protocol version.
- Python
Runtime Identity - Python implementation details supplied by the worker, never inferred by the host.
- Python
Trace Context - Trace context propagated with one invocation.
Enums§
- Python
Invocation State - Stable invocation lifecycle used to decide whether retry is safe.
- Python
Protocol Error - Python
Request State - Host-side lifecycle for one at-most-once invocation.
- Python
Runner Error Code - Stable public error identifiers for Python setup and execution.
- Python
Runner Error Phase - Stable stage at which a runner error occurred.
- Python
Runner Feature - Optional protocol behavior advertised during the worker handshake.
- Python
Runner Host Call - Brokered calls a worker may request from the host.
- Python
Runner Host Message - Host-to-worker messages on the persistent control channel.
- Python
Runner Host Request - Requests sent by the Soma host over the dedicated runner control channel.
- Python
Runner Reply - Worker replies to host requests.
- Python
Runner Worker Message - Worker-to-host messages on the persistent control channel.
- Python
Worker Health - Worker lifecycle visible to the supervisor.
Constants§
- PYTHON_
RUNNER_ MAX_ FRAME_ BYTES - Maximum JSON payload accepted by the length-prefixed control channel.
- PYTHON_
RUNNER_ PROTOCOL_ MAJOR - Current major version of the persistent Python runner protocol.
- PYTHON_
RUNNER_ PROTOCOL_ MINOR - Current minor version of the persistent Python runner protocol.
Functions§
- decode_
runner_ frame - Decode exactly one complete control frame.
- encode_
runner_ frame - Encode one control message as a four-byte big-endian length plus UTF-8 JSON.
- negotiate_
runner_ features - Return the deterministic feature intersection in host preference order.