The persistence seam is now create/open/stat/list returning per-session SessionHandles (read/append/flush/close); every log read and write flows through the owning handle. The seam package exports only the service and handle contracts, consumer-visible errors, and pure durable-data validation helpers; each backend owns its complete storage runtime, and the shared contract suites pin equivalent observable behavior. The backend routes published sessions' live events by id into the active write handle; agent-loop only acquires, seeds, and closes the handle. Resume appends interruptedTurnClosers through its write handle; session-query owns the revision-keyed cold cache. Legacy-only surfaces are removed in the same swap: locate/readRaw/supportsRawArtifacts, the legacy event-shape read migration, zstd torn-frame salvage, DSH_SESSION_JSONL, and hook transcript_path population; a torn final zstd frame is discarded whole; the session-list cold blank probe returns on stat metadata (eventCount derived from the last physical row, sizeBytes). The WebUI ZIP export serializes the logical log from a read handle, so both backends export identically. Refs #3245
58 lines
2.3 KiB
TypeScript
58 lines
2.3 KiB
TypeScript
/** Public configuration and typed failures for the combined session-query service. */
|
|
|
|
import { HarnessError } from '@deepseek-ai/dsh-llm'
|
|
|
|
/** Default maximum `before`/`after` raw-event window. */
|
|
export const SESSION_QUERY_READ_WINDOW_MAX = 50
|
|
|
|
/** Default maximum number of concurrent persisted-log reads in one batch read. */
|
|
export const SESSION_QUERY_DEFAULT_PERSISTED_INSPECT_CONCURRENCY = 4
|
|
|
|
/** Default maximum number of cold prepared-Session observations retained for reuse. */
|
|
export const SESSION_QUERY_DEFAULT_PREPARED_SESSION_CACHE_SIZE = 5
|
|
|
|
/** Backend-independent configuration inherited by every session-query implementation. */
|
|
export interface Config {
|
|
/** Maximum accepted raw read context on either side. Defaults to 50. */
|
|
readWindowMax?: number
|
|
/** Maximum concurrent persisted-log reads in one batch read. Defaults to 4. */
|
|
persistedReadConcurrency?: number
|
|
/**
|
|
* Maximum cold prepared-Session observations retained for reuse, keyed by
|
|
* durable revision. Entries pinned by active observation leases do not count
|
|
* against this bound until released. Defaults to 5.
|
|
*/
|
|
preparedSessionCacheSize?: number
|
|
}
|
|
|
|
/** Stable machine-routable failure taxonomy for session reads, traces, and search. */
|
|
export type SessionQueryErrorCode =
|
|
| 'SESSION_QUERY_ABORTED'
|
|
| 'SESSION_QUERY_CORRUPT_SESSION'
|
|
| 'SESSION_QUERY_EVENT_NOT_FOUND'
|
|
| 'SESSION_QUERY_INDEX_FAILED'
|
|
| 'SESSION_QUERY_INVALID_CONFIG'
|
|
| 'SESSION_QUERY_INVALID_CURSOR'
|
|
| 'SESSION_QUERY_INVALID_FILTER'
|
|
| 'SESSION_QUERY_INVALID_LIMIT'
|
|
| 'SESSION_QUERY_INVALID_QUERY'
|
|
| 'SESSION_QUERY_INVALID_LINEAGE'
|
|
| 'SESSION_QUERY_INVALID_SURFACE'
|
|
| 'SESSION_QUERY_INVALID_WINDOW'
|
|
| 'SESSION_QUERY_PERSISTENCE_FAILED'
|
|
| 'SESSION_QUERY_SEARCH_DISABLED'
|
|
| 'SESSION_QUERY_SESSION_NOT_FOUND'
|
|
| 'SESSION_QUERY_STALE_CURSOR'
|
|
| 'SESSION_QUERY_SOURCE_CONFLICT'
|
|
|
|
/** Typed session-query failure whose `code` is one closed taxonomy member. */
|
|
export class SessionQueryError extends HarnessError {
|
|
declare readonly code: SessionQueryErrorCode
|
|
|
|
// The base stores the value; this signature narrows its open string code.
|
|
// oxlint-disable-next-line typescript/no-useless-constructor
|
|
constructor(message: string, code: SessionQueryErrorCode, options?: ErrorOptions) {
|
|
super(message, code, options)
|
|
}
|
|
}
|