Errors

Error hierarchy

All SDK errors extend AgentOrcError and expose a stable code string. Raw SQLite errors are never surfaced.

• InitializationError
• ConfigurationError
• ValidationError
• DatabaseError
• EmbeddingError
• CompressionError
• MemoryNotFoundError

Error codes

try {
  await ctx.history({ id: "missing" });
} catch (error) {
  if (error instanceof MemoryNotFoundError) {
    console.log(error.code); // MEMORY_NOT_FOUND
  }
}