Skip to content

Local-first 🧠 memory for Hermes Agent that lives in your Obsidian vault and remembers project context. Nightly 😴 dream passes turn repeat corrections into confirmed preferences with measurable confidence. Adapters ship for Claude Code, Codex, and OpenClaw, with an MCP server for anything else.

TypeScript
3.7 KB
Raw Blame
/**
 * Adapter registry + autodetect — cross-table tests to confirm no
 * adapter mis-recognises a foreign format.
 */

import { describe, expect, test } from "bun:test";
import { readFileSync } from "node:fs";
import { resolve } from "node:path";

import {
  detectAdapter,
  getAdapter,
  isSessionAdapterId,
  SESSION_ADAPTERS,
  sessionAdapterFormatChoices,
} from "../../src/core/brain/sessions/registry.ts";

const FIXTURES = {
  claude: resolve("tests/fixtures/sessions/claude-minimal.jsonl"),
  codex: resolve("tests/fixtures/sessions/codex-minimal.jsonl"),
  hermes: resolve("tests/fixtures/sessions/hermes-minimal.jsonl"),
  opencode: resolve("tests/fixtures/sessions/opencode-minimal.jsonl"),
  grok: resolve("tests/fixtures/sessions/grok-minimal.jsonl"),
};

function firstLine(path: string): string {
  return readFileSync(path, "utf8").split("\n")[0]!;
}

describe("registry — single source of adapters", () => {
  test("exposes all five adapters", () => {
    const ids = SESSION_ADAPTERS.map((a) => a.id).toSorted();
    expect(ids).toEqual(["claude", "codex", "grok", "hermes", "opencode"]);
  });

  test("owns runtime validation and help choices", () => {
    expect(sessionAdapterFormatChoices()).toBe("auto|claude|codex|hermes|opencode|grok");
    expect(isSessionAdapterId("claude")).toBe(true);
    expect(isSessionAdapterId("codex")).toBe(true);
    expect(isSessionAdapterId("hermes")).toBe(true);
    expect(isSessionAdapterId("opencode")).toBe(true);
    expect(isSessionAdapterId("grok")).toBe(true);
    expect(isSessionAdapterId("copilot")).toBe(false);
  });

  test("no adapter carries an identity label of its own", () => {
    // Retracted in v1.49.0: `defaultAgent` duplicated `id` in all five
    // adapters and outranked the operator's `--agent`, so three runtimes
    // attributed imported memory to `claude` / `codex` / `hermes` - the
    // very strings `normalizeAgentArgument` rejects as placeholders.
    for (const adapter of SESSION_ADAPTERS) {
      expect(Object.hasOwn(adapter, "defaultAgent")).toBe(false);
    }
  });

  test("getAdapter returns each by id", () => {
    expect(getAdapter("claude").id).toBe("claude");
    expect(getAdapter("codex").id).toBe("codex");
    expect(getAdapter("hermes").id).toBe("hermes");
    expect(getAdapter("opencode").id).toBe("opencode");
    expect(getAdapter("grok").id).toBe("grok");
  });
});

describe("detectAdapter — autodetect across all three formats", () => {
  test("picks claude on the claude fixture", () => {
    expect(detectAdapter(firstLine(FIXTURES.claude))?.id).toBe("claude");
  });
  test("picks codex on the codex fixture", () => {
    expect(detectAdapter(firstLine(FIXTURES.codex))?.id).toBe("codex");
  });
  test("picks hermes on the hermes fixture", () => {
    expect(detectAdapter(firstLine(FIXTURES.hermes))?.id).toBe("hermes");
  });
  test("picks opencode on the opencode fixture", () => {
    expect(detectAdapter(firstLine(FIXTURES.opencode))?.id).toBe("opencode");
  });
  test("picks grok on the grok fixture", () => {
    expect(detectAdapter(firstLine(FIXTURES.grok))?.id).toBe("grok");
  });

  test("no adapter claims a foreign fixture (full cross-table)", () => {
    for (const [name, path] of Object.entries(FIXTURES)) {
      const detected = detectAdapter(firstLine(path));
      expect(detected?.id).toBe(name as never);
      for (const adapter of SESSION_ADAPTERS) {
        if (adapter.id !== name) {
          expect(adapter.detect(firstLine(path))).toBe(false);
        }
      }
    }
  });

  test("returns null on unknown JSON", () => {
    expect(detectAdapter(`{"foo":"bar"}`)).toBeNull();
  });

  test("returns null on non-JSON garbage", () => {
    expect(detectAdapter("not json at all")).toBeNull();
  });
});