Skip to main content

Module ontology

Module ontology 

Source
Expand description

The supercode ontology (docs/ONTOLOGY.md): the one model under the session spine and the orchestration world. 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.

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::WorldCodec;
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 Hermes sessions row, an OpenClaw session key and an orchestrator bindings row 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 the Fidelity it reached and, only at Fidelity::Semantic, the loss it accepted. The session half is the crate::Session loaders and writers; the world half implements WorldCodec.
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::Binding is made of and the wire block every discovery row carries.