Module 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).

Structs

Binding

The conversation record.

Handoff

A conversation moved (or moving) to another surface — Hermes handoff_*.

HermesSessionRow

One Hermes sessions row, the columns a binding is made of. Empty strings are read as absent by the decoder.

OrchestratorBindingRow

One row of an orchestrator profile’s bindings table, as read.

Worker

The worker session a binding points at.

Enums

EndReason

Why a binding ended (docs/ORCHESTRATOR-IR.md §2.5).

Functions

hermes_cron_job_id

Hermes cron fire session ids are minted as cron_<job_id>_<YYYYMMDD_HHMMSS> (cron/scheduler.py); recover the job id.

hermes_source_for_binding

The Hermes sessions.source word for a binding (inverse of hermes_trigger_for_source): a channel conversation’s source is its platform; the rest are the words Hermes’s own doors mint.

hermes_trigger_for_source

Hermes sessions.source → trigger. Cron fires are tagged cron; the CLI, TUI and ACP adapter are human surfaces; api_server is the HTTP API; webhook is inbound; every other value is a messaging platform.

parse_hermes_session_key

Parse a Hermes gateway session key (agent:<profile|main>:<platform>:<chat_type>[:<chat_id>][:<thread_id>][:<participant>]). Returns the surface and the profile namespace (None for main).

parse_openclaw_session_key

Parse an OpenClaw gateway session key. Shapes (docs/channels/channel-routing.md, docs/automation/cron-jobs.md, docs/cli/acp.md upstream): agent:<id>:main, agent:<id>:<channel>:<group|channel>:<cid>[:thread|topic:<tid>], cron:<jobId>, hook:<name>:<id>, acp-bridge:<uuid>.

render_hermes_session_key

Render a surface as Hermes’s build_session_key form, which parse_hermes_session_key reads back unchanged.

render_openclaw_session_key

Render an OpenClaw gateway session key for a binding under an agent (inverse of parse_openclaw_session_key): a cron fire is cron:<jobId>, a conversation is the agent shape.