Skip to content

Run the Hermes Agent adapter against a real state.db #157

Description

@Chirag6722

The Hermes Agent adapter (src/adapters/hermes.ts) is derived from Hermes's source and validated against a synthetic fixture built to it (fixtures/hermes/ (generate/ builds state.db, the live copy and the golden)). It has not been run against a real Hermes Agent session — the adapter header says so. If you use Hermes Agent, this is the most useful thing you can do for the adapter, and it needs no code unless the real log disagrees.

Steps

  1. npm install -g agitsh.
  2. agit import ~/.hermes/state.db --thread — the log lives at ~/.hermes/state.db (SQLite; agit reads it without node:sqlite).
  3. On what it imported: agit ls, agit show <id>, agit verify <id>, agit replay <id> --timeline.

Report

  • Hermes Agent version.
  • The import's summary line: events written, and the skipped counters by name — every record the adapter could not map is counted by its native type, never guessed at. An unmapped type that carries something a reader would want is the finding.
  • Whether what you see matches what Hermes Agent did: message order, tool calls paired with their results, write_file verified only when Hermes's own bytes_written matches the content, patch replace diffs applied, cost aggregated per model, totals held until the end under a live share.
  • agit verify result, and whether a second agit import of the same file says "already imported" (byte-identical re-import).

Paste sanitized snippets (keys and shapes, not content) — a session log holds whatever the agent saw — and never attach a raw one. If the real log contradicts the adapter, the adapter is what gets fixed, not the fixture (CONTRIBUTING.md); tests go in test/hermes-adapter.test.ts (and test/live-db.test.ts for the live share).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    adapterSupport for another agent runtime's session logsgood first issueGood for newcomershelp wantedExtra attention is needed

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions