Skip to content

v0.3.0 — Typed Exceptions, Retries, Intelligence API

Choose a tag to compare

@shubhamdev0 shubhamdev0 released this 04 Mar 21:30
· 30 commits to main since this release

What's New

Typed Exception Hierarchy

  • MemgraphAuthError (401/403) — bad API key or token
  • MemgraphConnectionError — cannot reach server
  • MemgraphRateLimitError (429) — with retry_after field
  • MemgraphValidationError (4xx) — bad request data
  • MemgraphAPIError (5xx) — server errors

Automatic Retries

  • Exponential backoff on rate limits, server errors, and connection errors
  • Configurable max_retries (default: 3)
  • Auth and validation errors are NOT retried

Memory Intelligence Methods

  • health() — memory health metrics
  • contradictions() — contradiction report
  • evaluate(query, user_id) — retrieval scoring breakdown
  • mcis() — Memgraph Cognitive Integrity Score (0-100)
  • benchmark(scenario) — run benchmark scenarios

CLI Improvements

  • Non-interactive init mode for CI/CD (reads from env vars)

New Integration Examples

  • CrewAI integration
  • LlamaIndex integration
  • Updated LangChain and MCP server examples

Full Changelog: v0.2.0...v0.3.0