Startsida Utforska Hjälp
Registrera dig Logga in
haiany
/
deepseek-harness
spegling av https://github.com/deepseek-ai/deepseek-harness.git
1
0
Fork 0
Filer Ärenden 0 Wiki
Träd: 7993f41da3
Grenar Taggar
deepseek-harnes...
/
packages
/
session-query
/
session-query
Tianyi Cui a50e8bc1f3 Merge remote-tracking branch 'origin/master' into codex/model-experience-readmes-20260712 2 månader sedan
..
src ad32c57e72 refactor(session-query): narrow phase one to exact reads 2 månader sedan
tests 00bfc03d20 Merge remote-tracking branch 'origin/master' into session-query 2 månader sedan
README.md a50e8bc1f3 Merge remote-tracking branch 'origin/master' into codex/model-experience-readmes-20260712 2 månader sedan
package.json ad32c57e72 refactor(session-query): narrow phase one to exact reads 2 månader sedan
tsconfig.json aa1dc0e2c7 feat(session-query): checkpoint build round 1 3 månader sedan

README.md

@deepseek-ai/dsh-session-query

Exact session-history retrieval through ctx.sessionQuery. The service presents live ctx.sessions and an optional, dynamically mounted ctx.sessionPersistence as one logical corpus. Matching ids produce one record: live events win, while live and persisted report both source availabilities. Conflicting immutable headers fail with SESSION_QUERY_SOURCE_CONFLICT.

Reads

  • listSessions() reads current persistence metadata, merges live records with live precedence, and returns cloned records in deterministic newest-first order.
  • listEvents(sessionId) loads the live-preferred raw log and classifies each event as current, shadowed, or log-only with the shared dsh-session surface fold.
  • readEvent(request) returns a cloned header, the full target event, and a bounded raw-seq window. before and after default to zero and may not exceed readWindowMax.

Persistence is optional and may mount or unmount dynamically. A cross-corpus list fails with SESSION_QUERY_PERSISTENCE_FAILED while mounted persistence is unreadable. A read targeting a known live session does not consult persistence, so durable backend health cannot make current in-memory history unreadable. Persisted exact reads list before loading, and reject a metadata mismatch rather than combining inconsistent observations.

SessionQueryError.code is a closed union: SESSION_QUERY_EVENT_NOT_FOUND, SESSION_QUERY_INVALID_CONFIG, SESSION_QUERY_INVALID_SURFACE, SESSION_QUERY_INVALID_WINDOW, SESSION_QUERY_PERSISTENCE_FAILED, SESSION_QUERY_SESSION_NOT_FOUND, and SESSION_QUERY_SOURCE_CONFLICT.

Configuration

Key Default Contract
readWindowMax 50 Maximum before or after raw-event count.

Model Experience

None, as this trusted query service returns cloned session records only to its callers and registers no model-facing prompt, schema, tool, or message.

Known Limitations and Deferred Work

  • No caller authorization — this is trusted context-wide infrastructure; a future model tool or UI must constrain which sessions its caller may inspect.
  • Exact retrieval only — filters, lineage/provenance traversal, extraction, search-provider protocol, index synchronization, and a model-facing tool are absent. Full-text search belongs beside its first implementation; the proposed SQLite package and its single transaction/reconciliation owner are described in the phase-two RFC.