Tianyi Cui
914bd34ea7
The attachment-policy fixtures introduced three assertions to unknown and changed two previously recorded assertions. The new repository gate rejects those escape hatches even though the earlier branch CI passed. Give the user, tool-result, and inbox fixtures their required V4 message metadata and declared identifier types. Declare the fixture's plugin content tag through ContentBlockMap, and check the flat tool-result fixture directly as its concrete SessionEvent type. Keep intentional malformed inbox entries and opaque extension fields in the existing negative cases. Remove all five unknown bridges without adding allowances. Delete the two baseline entries retired by the rewritten existing fixtures; the other three assertions were never part of the accepted baseline. Attachment runtime code and the tests' access-denial and complete-log assertions remain unchanged. Validation: the Host TypeScript aggregate and all 52 archive tests pass. verify-no-unknown-casts reports no new or stale entries, with 1575 existing assertions remaining; the baseline adds zero allowances and retires two.
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 and search.
- 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.
Dev Note
None.