Graphorin API reference v0.1.0
Graphorin API reference / @graphorin/sessions / agent-registry
agent-registry
AgentRegistry — the per-session-manager catalogue of every agent that has ever produced a message in a session. The registry exists to keep replay working long after the agent has been renamed or deleted: orphan agent_id references on stored messages can always be resolved via resolveOrPlaceholder(...).
The registry is in-memory + write-through to the configured SessionStoreExt. The package-level singleton instance is owned by the createSessionManager facade in ./facade.ts; consumers never construct an AgentRegistry directly.
Classes
| Class | Description |
|---|---|
| AgentRegistry | In-memory + write-through registry of agent metadata. |
Interfaces
| Interface | Description |
|---|---|
| RegisterAgentOptions | Optional options accepted by AgentRegistry.register. The registration is idempotent on id — re-registering the same id refreshes the display name + tags. |
| RetireAgentOptions | Optional options accepted by AgentRegistry.retire and AgentRegistry.delete. |
Type Aliases
| Type Alias | Description |
|---|---|
| AgentRegistryLookup | Result of AgentRegistry.resolveOrPlaceholder. Either the stored agent metadata, or a placeholder discriminated by kind: 'unknown' so callers can render "(deleted) Worker Agent". |
| DeleteAgentOptions | Same shape as RetireAgentOptions for delete(...). |