From the Inside Claude Code: The Claude Code Ecosystem architecture map

Session Store is shared by three groups of code, so a change to it reaches all of them

risk · high · inferred

Session Store holds the SessionStore protocol, the in-memory store and the option validation. Seven parts of the SDK depend on it: both clients and the package exports (public API and internal client), the session mutations, resume, listing and reading modules, and the transcript mirror batcher that appends entries. A change to the protocol or its validation lands in all three groups at once.

Impact: Changing a store method or the validation rules forces coordinated edits across the public API, session management and the one-shot query path.

Recommendation (medium effort): Treat the SessionStore protocol as a stable contract: add methods only with defaults, and keep validate_session_store_options and _store_implements as the single place that checks what a store supports.

The trail

  1. ClaudeSDKClient
  2. Session Store
  3. Internal Client
  4. Package Exports
  5. Session Mutations
  6. Session Resume
Open on the map

More from this board

© 2026 Syntaxia App Platform Ltd.

Syntaxia App Platform Ltd. Registered in England and Wales, company no. 15272701 Registered office: 3rd Floor, 86–90 Paul Street, London EC2A 4NE, United Kingdom contact@provenmap.com