Skip to content

Graphorin API reference v0.1.0


Graphorin API reference / @graphorin/memory / errors

errors

Typed error classes raised by @graphorin/memory. Every memory subsystem throws one of these instead of plain Error so consumers can pattern-match on kind and name without parsing the message.

Classes

ClassDescription
EmbedderMigrationAbortedErrorRaised by migrateEmbedder(...) when the runner is interrupted via AbortSignal. The surrounding for-await loop receives this error so the operator can resume from the persisted cursor on the next invocation.
EmbedderMigrationLockedErrorRaised by the embedder migration runner when the operator attempts a silent embedder swap under the lock-on-first policy.
EmbedderMigrationStateErrorRaised by the migration runner when the persisted migration_state row references embedders that are no longer registered (e.g. the operator removed the underlying tables manually).
EmbedderRegistrationErrorRaised when a memory write would reference an embedder that is not registered in the storage layer's embedding_meta registry.
GraphorinMemoryErrorBase class for every error raised by @graphorin/memory. Carries a stable lowercase kind discriminator and an optional hint surfaced to operators (CLI command / docs link to fix the issue).
MemoryToolDeniedErrorRaised when a memory tool is invoked outside the per-tool ACL or the memory-modification guard tier rejects the call.
WorkingBlockOverflowErrorRaised by WorkingMemory when a write would exceed the declared charLimit and the overflow policy is 'reject'.
WorkingBlockReplaceMismatchErrorRaised by WorkingMemory.replace(...) when the supplied unique substring is not present (or appears more than once) in the block value.