Tianyi Cui
e58cc13de4
SessionPersistence.readRaw previously used undefined for two unrelated states: a supported backend could not find the requested session, or the backend had no per-session artifact concept at all. The export endpoint consequently reported an existing SQLite-backed session as HTTP 404, which falsely diagnosed storage capability as session absence. Make raw-artifact support an explicit backend capability. Unsupported backends now fail their inherited readRaw path loudly and the host answers 501 before reading, while undefined retains the single meaning of an absent artifact on a supporting backend. First-party backends, test providers, generated API catalogs, bilingual persistence docs, and export error contracts now state that distinction; focused tests cover both the 501 and the inherited rejection.
session-query/ — session retrieval capability family
English | 中文
This family provides authorized retrieval over live and durable session logs, independently of compaction.
| Package | Role | ctx key |
|---|---|---|
session-query/ |
Defines trusted reads, relationship queries, and search operations | ctx.sessionQuery |
session-query-sqlite/ |
Implements session queries with SQLite full-text search | ctx.sessionQuery |
tool-session-query/ |
Exposes workspace-authorized session queries to the model | registers on ctx.tools |
The subsystem reference — logical records, bounded reads, traces, filters, result pages — is docs/subsystems/session-query.md.