Expand description
The supercode ontology (docs/ONTOLOGY.md): the one model under the
session spine and the orchestration. Lower layers never import upper
ones — this module depends on nothing above it except the session layer’s
crate::session::OrchestrationNouns wire block, which a Binding
projects onto.
- identity —
HarnessId, the one list every registry keys on - surface —
SurfaceKey,Trigger,Recurrence,CrossSurface,WorkspaceRef - binding —
Binding, the one conversation record, decoded once per source - fidelity —
Fidelity, one vocabulary for what a codec gave up - residue —
Residue, retained source fields (distinct from measured loss) - secret —
SecretRef/Vault: credentials are named, never held - codec —
ArtifactFidelity,OrchestrationCodec: the contract both halves obey
Re-exports§
pub use binding::hermes_cron_job_id;pub use binding::hermes_source_for_binding;pub use binding::hermes_trigger_for_source;pub use binding::parse_hermes_session_key;pub use binding::parse_openclaw_session_key;pub use binding::render_hermes_session_key;pub use binding::render_openclaw_session_key;pub use binding::Binding;pub use binding::EndReason;pub use binding::Handoff;pub use binding::HermesSessionRow;pub use binding::OrchestratorBindingRow;pub use binding::Worker;pub use codec::ArtifactFidelity;pub use codec::OrchestrationCodec;pub use fidelity::core_messages;pub use fidelity::measure_fidelity;pub use fidelity::messages_equal;pub use fidelity::messages_equal_multimodal;pub use fidelity::replay_eligible;pub use fidelity::replay_excluded;pub use fidelity::Fidelity;pub use fidelity::FidelityMetric;pub use fidelity::FidelityResidue;pub use identity::HarnessId;pub use residue::Residue;pub use secret::SecretRef;pub use secret::Vault;pub use surface::CrossSurface;pub use surface::Recurrence;pub use surface::SurfaceKey;pub use surface::Trigger;pub use surface::WorkspaceKind;pub use surface::WorkspaceRef;
Modules§
- binding
- The one conversation record (
docs/ONTOLOGY.md§2.2): a conversation reached on a surface, routed to a profile, run by a worker, with a lifecycle. A Hermessessionsrow, an OpenClaw session key and an orchestratorbindingsrow each decode to it ONCE, here; the discovery row’s nouns are its projection (Binding::nouns). - codec
- The codec contract both pieces obey (
docs/ONTOLOGY.md§2.5): every artifact a codec reads or writes names theFidelityit reached and, only atFidelity::Semantic, the loss it accepted. The session half is thecrate::Sessionloaders and writers; the orchestration half implementsOrchestrationCodec. - fidelity
- Behavioral translation-fidelity measurement.
- identity
- Harness identity: the one list every registry, ledger and codec keys on.
- residue
- Retained residue: source fields the model does not interpret, kept
verbatim and re-emitted on the diagonal. Distinct from the MEASURED loss of
an export-and-reload (
crate::FidelityResidue); this is what a codec keeps, that is what a measurement counts. - secret
- Secret references. A credential is named, never held: the model carries
WHERE a value lives (
docs/ORCHESTRATOR-IR.md§1 rule 3), and a vault resolves it at the moment of use. - surface
- The conversation-on-a-surface nouns (ORCH-3 / ORCH-6): where a
conversation is reached, why it exists, which job it belongs to, where it
moved. They are the vocabulary a
crate::ontology::Bindingis made of and the wire block every discovery row carries.