Tianyi Cui
c97df989ff
`session[.vN].jsonl` was assembled independently by the JSONL provider (twice), the session-log export archive, and the recorded-session fixture helpers. `dsh-session-format` now owns `sessionFormatLogFilename` and `parseSessionFormatLogFilename`; the three consumers append only their compression suffix, and the migration note names the owner. `snapshotSessionFormatJson` re-implemented the lossless JSON walk that `dsh-util-values` already publishes as `snapshotJsonValue` + `deepFreeze`, and the frozen v0 relationship validator carried a third structural JSON comparison next to `deepEqualJson`. Both now delegate; the format package reports one `is not lossless JSON` diagnostic per labelled subject instead of ten member-specific ones, and enumerable accessors whose values survive a JSON round trip are accepted like `JSON.stringify` accepts them.
description, kind
| description | kind |
|---|---|
| Package map for the session retrieval capability family: searching, tracing, and reading live and durable session history, plus the Web session-log export. | package-group |
session-query/ — session retrieval capability family
English | 中文
Summary
The session-query/ group provides retrieval over live and durable session history, independent of compaction: programmatic callers query one unified service for exact logs, filtered lists, relationship traces, and full-text search; a SQLite backend powers the search; the model gets five workspace-authorized tools; and the Web UI gets an /export command that downloads a session ZIP. Search results agree with the conversation history the model sees. This page maps the group; each package README owns its per-package contract.
Table of Contents
Packages
Each package README describes what you can do with its part of the family.
| Package | Role | ctx key |
|---|---|---|
session-query/ |
Unified session-history query service: exact reads, relationship traces, and filters | ctx.sessionQuery |
session-query-sqlite/ |
Full-text search across session history backed by a SQLite FTS5 index | registers on ctx.sessionQuery |
session-log-export/ |
Web /export command and browser download of a session ZIP |
ctx.sessionLogDownload (browser) |
tool-session-query/ |
Model-facing tools to search, trace, and read session history | registers on ctx.tools |
Related documentation
Start with the subsystem reference for the shared query vocabulary, then the design records behind tracing, search, and the model-facing tools.
- Session Query subsystem reference — logical records, filters, search pages, lineage, bounded reads, and event relationships.
- Session query relationship tracing — trace semantics and the validation boundary.
- SQLite FTS5 session search — search semantics, reconciliation, and the tokenizer decision.
- Model-facing session query tools — workspace authority and the cursor-free result design.
Dev Note
None.