hermes

​

hermes

​

Identity

• Names: com.nousresearch.hermes; short alias hermes.
• Native format: hermes-state-sqlite, state.db; state schemas, messages, usage, admissions, executions and receipts are separate native stores/tables.
• Session ID: sessions.id. Namespace is state_meta.value where key = store_instance_id; older stores need a persisted installation namespace. Paths never supply it.
• Context and messages: messages.active and native ID order define current replay; retain archived rows. _compressed_summary: 1 has unknown replacement extent. api_content is model content when present, with content kept as display. observed: 1 means addressed: false. The session creator’s user_id does not identify the author of every group message. platform_message_id identifies platform messages; channel mapping requires the recorded source/chat fields.
• Unassigned facts: delivery_obligations.session_key is lane ownership, not a session/message join. Mirror provenance is not persisted, so assistant text does not prove copiedFrom. Source cron/webhook markers can supply session triggers, not invented turn triggers.

​

Position basis

​

Destinations

​

hermes: native facts without a standard field

​

Links

• Lineage: parent_session_id plus a matching model_config._branched_from means fork; matching _delegate_from means spawning; matching _reset_from means reset continuation. A marker must equal the immediate parent because compression can copy older markers. Other parent pointers mean relatedUnknown. source: subagent establishes scope, not a parent. A child keeps its own native session ID. No root or copied-prefix claim is qualified.
• Entity keys and links: Integer messages.id, written as decimal text, is stable message identity. tool_call_uids[provider_id] gives a call occurrence ID; result tool_call_uid joins it. Without a UID, require a unique native provider-ID-to-occurrence mapping. message_uid alone cannot prove copies because a record carrying compaction content can reuse it while changing the content.

​

Usage

• Usage and state: Session/model totals are summaries, not per-call inference. Preserve all session_model_usage primary-key dimensions. Default zero cost is unknown unless cost_status establishes its meaning; only provider cost/generation APIs prove provider-reported cost. system_prompt_hash joins system_prompts.hash for instructions. worker_receipts.execution_id joins its execution. Serialize messages, immutable receipts, then mutable state snapshots.

​

Lane and unassigned facts

​

Losses

​

Evidence

​

Observations from 2026-10-27

{
  "name": "com.nousresearch.hermes",
  "aliases": [
    "hermes"
  ],
  "namespace": {
    "rule": "required"
  },
  "positions": [
    {
      "family": "transcript",
      "basis": "native-message-id",
      "boundary": "transaction"
    },
    {
      "family": "current-state",
      "basis": "snapshot",
      "boundary": "transaction"
    }
  ],
  "formats": [
    {
      "id": "hermes-state-sqlite",
      "evidence": [
        0,
        2
      ]
    }
  ],
  "evidence": [
    {
      "label": "source",
      "revision": "89a6e05de462768016b2ae0d684338e3cce3f3ee",
      "scope": "format-and-explicit-mappings"
    },
    {
      "label": "probe",
      "version": "commit:89a6e05de462768016b2ae0d684338e3cce3f3ee",
      "scope": "persistence-only"
    },
    {
      "label": "observed",
      "version": "0.0.0; source 198f6ad53c661e42ff2423ba42d6262078520e69",
      "date": "2026-10-27",
      "scope": "state.db messages under .hermes; Two headless edit/review runs.",
      "limitations": "The editable Hermes package reports 0.0.0, so these two headless edit/review runs are pinned to source commit 198f6ad53c661e42ff2423ba42d6262078520e69. Only the observed state.db messages are covered. Receipt and worker features were not newly exercised. Preserve relational rows in native.record or native.blob.",
      "validation": {
        "streams": 2,
        "records": 42,
        "errors": 0,
        "notices": 0,
        "gaps": 0,
        "unidentifiedSources": 0
      },
      "validator": "validator-v0.1.2",
      "converter": "ctx-asr-authentic-captures-4",
      "revision": "198f6ad53c661e42ff2423ba42d6262078520e69"
    }
  ],
  "destinations": {
    "modelUsage": {
      "schema": {},
      "evidence": [
        0
      ]
    },
    "origin": {
      "schema": {
        "type": "object"
      },
      "evidence": [
        0
      ]
    },
    "threadId": {
      "schema": {},
      "evidence": [
        0
      ]
    }
  },
  "mappings": [
    {
      "native": "complete native row or event",
      "destination": "native.record or native.blob",
      "scope": "state.db messages under .hermes",
      "evidence": [
        2
      ]
    }
  ]
}