Graphorin API reference v0.1.0

---

Graphorin API reference / @graphorin/sessions / agent-registry / AgentRegistry

Class: AgentRegistry

Defined in: packages/sessions/src/agent-registry.ts:64

In-memory + write-through registry of agent metadata.

Stable

Constructors

Constructor

new AgentRegistry(args): AgentRegistry;

Defined in: packages/sessions/src/agent-registry.ts:69

Parameters

Parameter	Type
args	{ now?: () => number; store: SessionStoreExt; }
args.now?	() => number
args.store	SessionStoreExt

Returns

AgentRegistry

Methods

delete()

delete(id, opts?): Promise<void>;

Defined in: packages/sessions/src/agent-registry.ts:127

Hard-delete an agent. Subsequent resolveOrPlaceholder(id) returns { kind: 'unknown', id } so replay can substitute a placeholder.

Parameters

Parameter	Type
id	string
opts	RetireAgentOptions

Returns

Promise<void>

---

get()

get(id): Promise<
  | AgentRegistryEntry
| null>;

Defined in: packages/sessions/src/agent-registry.ts:140

Best-effort lookup. Returns null when the agent is unknown.

Parameters

Parameter	Type
id	string

Returns

Promise< | AgentRegistryEntry | null>

---

hydrate()

hydrate(): Promise<void>;

Defined in: packages/sessions/src/agent-registry.ts:79

Hydrate the in-memory cache from the store. Useful when a process boots after a restart and wants the agent catalogue ready before any Session.list({...}) call.

Returns

Promise&lt;void&gt;

---

list()

list(): Promise<readonly AgentRegistryEntry[]>;

Defined in: packages/sessions/src/agent-registry.ts:151

List every known agent (active + retired).

Returns

Promise&lt;readonly AgentRegistryEntry[]&gt;

---

register()

register(id, opts): Promise<AgentRegistryEntry>;

Defined in: packages/sessions/src/agent-registry.ts:89

Idempotent registration. Re-registering the same id refreshes the display name + tags but preserves the original registeredAt.

Parameters

Parameter	Type
id	string
opts	RegisterAgentOptions

Returns

Promise&lt;AgentRegistryEntry&gt;

---

resolveOrPlaceholder()

resolveOrPlaceholder(id): Promise<AgentRegistryLookup>;

Defined in: packages/sessions/src/agent-registry.ts:160

Replay-safe lookup. Returns { kind: 'agent', agent } when the id is known (active or retired), or { kind: 'unknown', id } when the agent has been hard-deleted.

Parameters

Parameter	Type
id	string

Returns

Promise&lt;AgentRegistryLookup&gt;

---

retire()

retire(id, opts?): Promise<void>;

Defined in: packages/sessions/src/agent-registry.ts:110

Soft-retire an agent. Subsequent resolveOrPlaceholder(id) still returns the metadata (with retiredAt set) so replay shows "(retired) Worker Agent". Pass { assertExists: true } to throw on an unknown id.

Parameters

Parameter	Type
id	string
opts	RetireAgentOptions

Returns

Promise&lt;void&gt;

---

snapshot()

snapshot(): readonly AgentRegistryEntry[];

Defined in: packages/sessions/src/agent-registry.ts:170

Snapshot of the in-memory cache. Used by JSONL export to embed kind: 'agent' records without an extra round-trip to the store.

Returns

readonly AgentRegistryEntry[]