Graphorin API reference v0.7.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
| Class | Description |
|---|---|
| EmbedderMigrationAbortedError | Raised by migrateEmbedder(...) when the runner is interrupted via AbortSignal. The surrounding for-await loop receives this error so the operator can re-run the migration. MST-12: there is no persisted cursor today, so a re-run restarts from the beginning. |
| EmbedderMigrationLockedError | Raised by the embedder migration runner when the operator attempts a silent embedder swap under the lock-on-first policy. |
| EmbedderMigrationStateError | Raised by the migration runner when the migration references embedders that are no longer registered (e.g. the operator removed the underlying tables manually). |
| EmbedderRegistrationError | Raised when a memory write would reference an embedder that is not registered in the storage layer's embedding_meta registry. |
| GraphorinMemoryError | Base 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). |
| MemoryToolDeniedError | Raised when a memory tool is invoked outside the per-tool ACL or the memory-modification guard tier rejects the call. |
| ProcedureInductionNotConfiguredError | Raised when ProceduralMemory.induce (P2-2) is called but no workflow inducer was configured. Induction abstracts concrete values into variables, which needs a provider - so the capability is opt-in and the default (offline) procedural tier never silently no-ops a requested induction. |
| QuarantinePromotionRefusedError | Raised by SemanticMemory.validate (P1-4 / MRET-3) when a caller tries to promote a fact whose quarantine was triggered by the offline injection heuristics. Such a fact is a memory-poisoning candidate: the agent's own fact_validate tool must never be able to admit it into action-driving recall, so promotion is refused unless an operator passes the explicit force flag through the programmatic API. |
| WorkingBlockOverflowError | Raised by WorkingMemory when a write would exceed the declared charLimit and the overflow policy is 'reject'. |
| WorkingBlockReadOnlyError | Thrown when any mutation targets a block defined with readOnly: true (MRET-14). Previously this guard threw WorkingBlockReplaceMismatchError(label, 0) - semantically "your unique substring matched 0 times", which misled callers that retry replace operations on mismatch. |
| WorkingBlockReplaceMismatchError | Raised by WorkingMemory.replace(...) when the supplied unique substring is not present (or appears more than once) in the block value. |