Expand description
Versioned, language-neutral service over persisted harness sessions.
The service is transport-agnostic: HarnessSessionService::handle accepts
one JSON-RPC value and HarnessSessionService::poll produces subscription
notifications. The CLI exposes those primitives as NDJSON over stdio.
Structs§
- Gateway
Health - ORCH-17:
gatewayon aharness.v1.harnesses.listrow. - Harness
Session Service - Stateful persisted-session service. Each instance owns its follow subscriptions; discovery and loading remain read-only.
Enums§
- Gateway
State - Receipt-backed evidence that a harness has a RUNNING instance right now,
distinct from being merely installed (UNI-7). Detection is passive and
default-on: a gateway liveness connect for daemon harnesses, a fresh
SQLite WAL stamp for store-writer harnesses (precedent: the opencode
follower’s -wal/-shm freshness). Control stays behind per-connection
grants — this reports observations only.
ORCH-17: the gateway-health noun on an inventory row. Derived from the
UNI-7 running-instance probe (Hermes:
state.db-walfreshness; OpenClaw: a TCP connect to the gateway endpoint resolved from its OWN config) plus the executable version — never by starting anything.
Constants§
- HARNESS_
SERVICE_ METHODS - Every JSON-RPC method the harness service dispatches (
harness.v1.capabilitiesreports it; ORCH-4 registry tiers must cite entries of it). - HARNESS_
SERVICE_ VERSION - Protocol namespace implemented by this service.
- RUNTIME_
EVENT_ METHOD - Notification method emitted for live runtime events.
- SESSION_
ACTIVITY_ EVENT_ METHOD - Notification method emitted for normalized session-activity transitions.
- SESSION_
EVENT_ METHOD - Notification method emitted for followed-session changes.
- SESSION_
INDEX_ EVENT_ METHOD - Notification method emitted for revisioned session-list changes.