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
/**
* How far the caller of this process had to reach to get here.
*
* A vault page may reserve itself against remote reads (see
* {@link REMOTE_DENY_VISIBILITY_TOKEN} in `./visibility.ts`). Deciding
* whether a given read is such a read needs one fact, and the only party
* that holds it is the TRANSPORT: stdio and the CLI run inside a process
* the caller already started on this host, while an HTTP request arrives
* from wherever it arrives from.
*
* So the value is MINTED by each transport constructor and never parsed
* out of a request. A caller-supplied trust claim is not a trust claim -
* the rule `src/mcp/owner-scope-refusal.ts` states once for owner
* identity, applied here to reach - which is why a reach-shaped member in
* a tool's arguments is refused by name rather than read.
*
* What each member actually proves, stated plainly rather than
* overclaimed:
*
* - `local` - the caller already holds filesystem-equivalent access to
* this vault (stdio and the CLI run as a child of the caller), or the
* request originated on this host (a loopback HTTP bind). It does NOT
* prove operator intent: a remote host can spawn a stdio subprocess.
* The alternative - no bypass at all - would take an operator's own
* private notes away from their own CLI, so the bypass exists and its
* limit is written down here.
* - `remote` - nothing beyond "a request arrived". This is the default
* for every non-loopback bind, and the reach a page reserving itself
* against remote reads is reserved against.
*
* Naming: `disclosure` was the design's word for this, and it is already
* taken in this tree - `SearchOptions.disclosure` is the progressive
* result-DEPTH mode (`full` | `cards`). Two fields called `disclosure` on
* one options bag, meaning different things, is the "one rule, two
* spellings" defect this suite exists to remove, so the transport fact is
* named for what it measures instead.
*/
/** The closed vocabulary. See the module docblock for what each proves. */
export const TRANSPORT_REACH = Object.freeze({
/** Filesystem-equivalent access, or a request from this host. */
local: "local",
/** A request arrived, and nothing further is established. */
remote: "remote",
} as const);
/** Closed union over {@link TRANSPORT_REACH}. */
export type TransportReach = (typeof TRANSPORT_REACH)[keyof typeof TRANSPORT_REACH];
/** Membership list, widest-access-first. */
export const TRANSPORT_REACHES: ReadonlyArray<TransportReach> = Object.freeze([
TRANSPORT_REACH.local,
TRANSPORT_REACH.remote,
]);
/**
* Narrow a reach read back off a stored envelope or a test fixture.
*
* Deliberately NOT used to accept one from a request - see the module
* docblock for why a reach arriving from a caller is refused instead.
*/
export function isTransportReach(value: unknown): value is TransportReach {
return typeof value === "string" && (TRANSPORT_REACHES as ReadonlyArray<string>).includes(value);
}
/**
* The reach to answer at when nobody minted one.
*
* An unestablished reach is not the absence of a boundary, so an absent
* value resolves to {@link TRANSPORT_REACH.remote}, the narrowest. Named
* here once because the alternative is what it was: the same `?? remote`
* spelled at every options bag and every context reader, which is one
* rule with six spellings and five places to forget to change it.
*
* Callers that hold a `ServerContext` reach it through `contextReach`
* (`src/mcp/tool-contract.ts`), which is this function under the name
* that seam already uses.
*/
export function resolvedTransportReach(reach: TransportReach | undefined): TransportReach {
return reach ?? TRANSPORT_REACH.remote;
}
/**
* The reach an INTERNAL maintenance lane walks the vault at.
*
* `local`, and not because a lane proved anything about a caller - it has
* no caller. A heal pass, a link-graph repair, a portability export, a
* freshness sweep or a schema report reads the vault to reason about the
* vault, and its output is a repair or a diagnostic rather than a page
* handed to anyone. A lane that stopped seeing reserved pages would
* report a smaller vault than the one it is fixing, and would then break
* the links into the pages it could not see.
*
* Named here once so the claim every lane makes is the same claim, and so
* a reader can find all of them by finding this constant.
*/
export const MAINTENANCE_LANE_REACH: TransportReach = TRANSPORT_REACH.local;