@morlay/session-rdb 0.1.9 → 0.1.10-alpha.2

package/dist/{log-C0q5svm7.d.mts → backend-BKtJ5sO5.d.mts}

@@ -1,212 +1,86 @@
-import { Session, SessionEvent, SessionHeader, SessionId, SessionLogOffset } from "@deepseek-ai/dsh-session";
+import { Database } from "@morlay/rdbkit";
+import { SessionEvent, SessionHeader, SessionId, SessionLogOffset } from "@deepseek-ai/dsh-session";
 import { SessionAccess, SessionHandle, SessionHandleAppendOptions, SessionHandleFlushOptions, SessionHandleReadOptions, SessionHandleReadResult, SessionPersistence, SessionPersistenceCreateOptions, SessionPersistenceListOptions, SessionPersistenceOpenOptions, SessionPersistenceRevision, SessionPersistenceSnapshot, SessionPersistenceStatOptions, SessionStorageMetadata } from "@deepseek-ai/dsh-session-persistence";
-import { ScheduleTask } from "@deepseek-ai/dsh-schedule";
+import "@deepseek-ai/dsh-schedule";
 import { CheckpointIdentity } from "@deepseek-ai/dsh-session-projection-cache";
 import { ProjectionCheckpoint } from "@deepseek-ai/dsh-session-projection";
-import { WorkspaceDomainState, WorkspaceRecord } from "@deepseek-ai/dsh-workspace";
+import "@deepseek-ai/dsh-workspace";
 import { Context } from "@deepseek-ai/cordis";
 import { Volatile } from "@deepseek-ai/cosmokit";
 import z from "@deepseek-ai/schemastery";
-import { BranchAnchorMode, BranchBoundary, ForkFromOptions, SessionBranch, SessionBranchProvider } from "@morlay/session-branch";
-//#region src/storage-takeover/types.d.ts
+interface EventUsageRow {
+  fEventId: string;
+  fCreatedAt: number;
+  fDay: string;
+  fProvider: string | null;
+  fModel: string | null;
+  fReferenced: number;
+  fSubagent: number;
+  fInputTokens: number;
+  fOutputTokens: number;
+  fCacheReadTokens: number;
+  fReasoningTokens: number;
+  fTotalTokens: number;
+}
+declare function usageRowOf(event: {
+  fEventId: string;
+  fCreatedAt: number;
+  fType: string;
+  fData: string;
+}, subagent: boolean): EventUsageRow | undefined;
+interface DomainRecord {
+  table: string;
+  key: string;
+  value: unknown;
+}
+interface WorkspaceIndexEntry {
+  id: string;
+  title: string;
+  sessionIds: string[];
+}
 interface StoredProjcacheEntry {
   sessionId: SessionId;
   identity: CheckpointIdentity;
   rows: ProjectionCheckpoint;
+  /** 会话标题（随快照一起加载 / 写路径刷新；`cachedSnapshot` 缺标题时用它补，不回库直读）。 */
+  title?: {
+    title: string;
+    seq: number;
+  };
 }
 interface StorageRepository {
   readUnitVersion(name: string): Promise<number | undefined>;
   insertUnitVersion(name: string, version: number): Promise<void>;
-  listWorkspaces(): Promise<Array<{
-    id: string;
-    record: WorkspaceRecord;
-  }>>;
-  putWorkspace(id: string, record: WorkspaceRecord): Promise<void>;
-  deleteWorkspace(id: string): Promise<void>;
-  readWorkspaceState(): Promise<WorkspaceDomainState | null>;
-  writeWorkspaceState(state: WorkspaceDomainState): Promise<void>;
-  listScheduleTasks(): Promise<Array<{
-    id: string;
-    task: ScheduleTask;
-  }>>;
-  putScheduleTask(id: string, task: ScheduleTask): Promise<void>;
-  deleteScheduleTask(id: string): Promise<void>;
+  listDomainRecords(domain: string): Promise<DomainRecord[]>;
+  readDomainGlobal(domain: string): Promise<unknown>;
+  putDomainRecord(domain: string, table: string, key: string, value: unknown): Promise<void>;
+  deleteDomainRecord(domain: string, table: string, key: string): Promise<void>;
+  deleteDomainRecords(domain: string, table: string, keys: readonly string[]): Promise<void>;
+  writeDomainGlobal(domain: string, value: unknown): Promise<void>;
+  listWorkspaceIndex(): Promise<WorkspaceIndexEntry[]>;
   loadProjcache(): Promise<StoredProjcacheEntry[]>;
-  readProjcacheDirect?(sessionId: string): StoredProjcacheEntry | undefined;
-  readSessionTitleDirect?(sessionId: string): {
+  /** 会话标题（投影缓存的镜像刷新与 `cachedSnapshot` 补标题用）。 */
+  readSessionTitle(sessionId: string): Promise<{
     title: string;
     seq: number;
-  } | undefined;
+  } | undefined>;
   putProjcache(sessionId: string, rows: ProjectionCheckpoint): Promise<void>;
+  /** 增量写回：只 upsert `changed` 里的行、删掉 `removedKeys`，其余行原样不动。 */
+  patchProjcache(sessionId: string, changed: ProjectionCheckpoint, removedKeys: readonly string[]): Promise<void>;
   pruneStaleProjcache(): Promise<number>;
 }
-//#endregion
-//#region src/routes.d.ts
 declare const SESSION_ROWS_PATH = "/api/morlay/v1/session/rows";
 declare const SESSION_EXPORT_PATH = "/api/morlay/v1/session/export";
 declare const SESSION_IMPORT_PATH = "/api/morlay/v1/session/import";
 declare const SESSION_DELETE_PATH = "/api/morlay/v1/session/delete";
-declare const SESSION_GC_PATH = "/api/morlay/v1/session/gc";
+declare const SESSION_ORGANIZE_PATH = "/api/morlay/v1/session/organize";
 declare const SESSION_USAGE_PATH = "/api/morlay/v1/session/usage";
-//#endregion
-//#region src/write-guard.d.ts
 declare class WriteGuard {
   private readonly headSeqs;
   confirmHead(id: SessionId, head: number): void;
   has(id: SessionId): boolean;
   assertNoConcurrentWriter(id: SessionId, storedHead: number): void;
 }
-//#endregion
-//#region src/schema.d.ts
-declare const SCHEMA_VERSION = 3;
-declare const SESSION_PERSISTENCE_SQLITE_APPLICATION_ID = 1146308688;
-declare const EVENT_ENCODING = "json";
-declare const tPersistenceState: any;
-declare const tSchemaMeta: any;
-declare const tSessions: any;
-declare const tEvents: any;
-declare const tSessionEvents: any;
-declare const tStorageUnits: any;
-declare const tWorkspaces: any;
-declare const tWorkspaceSessions: any;
-declare const tWorkspaceState: any;
-declare const tScheduleTasks: any;
-declare const tSessionProjcacheRows: any;
-declare const tEventUsage: any;
-declare const tSessionUsage: any;
-declare const tSessionCounts: any;
-type JournalMode = "wal" | "delete" | "truncate" | "persist";
-declare const DEFAULT_BUSY_TIMEOUT_MS = 5000;
-type EventKind = "message" | "thinking" | "turn" | "tool" | "request" | "config" | "audit" | "lifecycle" | "inbox" | "compaction" | "llm" | "subagent" | "team" | "workflow" | "goal" | "schedule" | "todo" | "web";
-type EventRole = "user" | "assistant" | "tool";
-declare function eventKind(event: {
-  type: string;
-  data?: unknown;
-}): EventKind | "";
-declare function eventDimensions(event: SessionEvent): {
-  kind: string;
-  role: string;
-  name: string;
-  actionId: string;
-};
-//#endregion
-//#region src/rows.d.ts
-interface SessionRowsItem {
-  sessionId: string;
-  title: string | null;
-  origin: string | null;
-  cwd: string | null;
-  createdAt: number;
-  updatedAt: number;
-  archived: boolean;
-  workspace: string | null;
-}
-interface SessionRowsValue {
-  items: SessionRowsItem[];
-  total: number;
-  page: number;
-  pageSize: number;
-}
-//#endregion
-//#region src/branch.d.ts
-declare function locateTurnEnd(events: readonly SessionEvent[], atSeq?: number, mode?: BranchAnchorMode): number;
-interface LiveSessionHooks {
-  getSession(id: SessionId): Session | undefined;
-  getAgent(id: SessionId): LiveAgentLike | undefined;
-  flush(session: Session): Promise<boolean>;
-  warn?(message: string): void;
-  resetProjections?(session: Session): void;
-  resetTokenMeter?(session: Session): void;
-  refreshProjectionCache?(session: ProjectionCacheSession): Promise<void>;
-}
-interface ProjectionCacheSession {
-  readonly id: SessionId;
-  readonly header: SessionHeader;
-  readonly inheritedEventCount: SessionLogOffset;
-  readonly headSeq?: number;
-  snapshotEvents(): readonly SessionEvent[];
-}
-interface LiveAgentLike {
-  session: Session;
-  requestHeaderLogged?: boolean;
-  inbox?: {
-    clear(): void;
-  };
-}
-declare function truncateLiveSession(session: Session, newLength: number): void;
-declare class SessionBranchRdbProvider implements SessionBranchProvider {
-  private readonly persistence;
-  private readonly live;
-  readonly name = "session-rdb";
-  constructor(persistence: SessionPersistenceRdb, live?: LiveSessionHooks);
-  readBranchPrefix(id: SessionId, atSeq?: number, mode?: BranchAnchorMode, signal?: AbortSignal): Promise<BranchBoundary>;
-  readRawEvents(id: SessionId, signal?: AbortSignal): Promise<{
-    meta: SessionHeader;
-    events: readonly SessionEvent[];
-  }>;
-  forkFrom(sourceId: SessionId, options?: ForkFromOptions, signal?: AbortSignal): Promise<SessionId>;
-  rewind(id: SessionId, toBoundary: number, signal?: AbortSignal): Promise<SessionPersistenceSnapshot>;
-  private rewindKeepLength;
-  private refreshProjectionCache;
-}
-declare class SessionBranchRdb extends SessionBranch {
-  static inject: string[];
-  private readonly warned;
-  constructor(ctx: import("@deepseek-ai/cordis").Context);
-  resetLiveDerivedState(session: Session): void;
-  private warnOnce;
-  private resetProjectionCells;
-  private resetTokenMeterFold;
-  private readonly provider;
-  readBranchPrefix(id: SessionId, atSeq?: number, mode?: BranchAnchorMode, signal?: AbortSignal): Promise<BranchBoundary>;
-  readRawEvents(id: SessionId, signal?: AbortSignal): Promise<{
-    meta: SessionHeader;
-    events: readonly SessionEvent[];
-  }>;
-  forkFrom(sourceId: SessionId, options?: ForkFromOptions, signal?: AbortSignal): Promise<SessionId>;
-  rewind(id: SessionId, toBoundary: number, signal?: AbortSignal): Promise<SessionPersistenceSnapshot>;
-}
-//#endregion
-//#region src/index.d.ts
-interface SessionPersistenceRdbInternals {
-  readonly backend: Backend;
-  readonly writeGuard: WriteGuard;
-  create(meta: SessionHeader, inheritedEventCount?: number): Promise<SessionHandle>;
-  append(id: SessionId, events: readonly SessionEvent[]): Promise<void>;
-  load(id: SessionId): Promise<import("@deepseek-ai/dsh-session-persistence").SessionInspection>;
-  inspect(id: SessionId, signal?: AbortSignal): Promise<import("@deepseek-ai/dsh-session-persistence").SessionInspection>;
-  readFrom(id: SessionId, fromSeq: number, signal?: AbortSignal): Promise<{
-    meta: SessionHeader;
-    inheritedEventCount: number;
-    events: readonly SessionEvent[];
-  }>;
-  listSnapshots(signal?: AbortSignal): Promise<SessionPersistenceSnapshot[]>;
-  readStoredRevision(id: SessionId, signal?: AbortSignal): Promise<import("@deepseek-ai/dsh-session-persistence").SessionPersistenceRevision | undefined>;
-  registerReuseEventIds(childId: SessionId, map: ReadonlyMap<number, string>): void;
-  dropReuseEventIds(childId: SessionId): void;
-}
-interface ProjectionCacheOptions {
-  writeEveryEvents?: number;
-  writeIntervalMs?: number;
-}
-type Config = {
-  type: "sqlite";
-  path: string;
-  journalMode?: JournalMode | undefined;
-  busyTimeout?: number | undefined;
-  projectionCache?: ProjectionCacheOptions | undefined;
-} | {
-  type: "postgres";
-  connectionString: string;
-  schema?: string | undefined;
-  projectionCache?: ProjectionCacheOptions | undefined;
-};
-type ResolvedConfig = Volatile<Config>;
-type SessionDeletionErrorCode = "SESSION_NOT_FOUND" | "SESSION_NOT_ARCHIVED" | "SESSION_LIVE";
-declare class SessionDeletionError extends Error {
-  readonly code: SessionDeletionErrorCode;
-  constructor(message: string, code: SessionDeletionErrorCode);
-}
 interface PendingSession {
   readonly header: SessionHeader;
   readonly revision: SessionPersistenceRevision;
@@ -274,20 +148,99 @@ declare class RdbSessionHandle implements SessionHandle {
   private assertOpen;
   static readonly LIVE_WRITE_BATCH_MAX_DELAY_MS = 200;
 }
+/** 库结构版本（写入 SQLite 的 `user_version`，不匹配即拒绝打开）。 */
+declare const SCHEMA_VERSION = 3;
+/** SQLite 文件头的 application id（`0x44534850` = "DSHP"），防止误开别的库。 */
+declare const SESSION_PERSISTENCE_SQLITE_APPLICATION_ID = 1146308688;
+/** 事件 `f_data` 的编码（目前只有 JSON）。 */
+declare const EVENT_ENCODING = "json";
+type JournalMode = "wal" | "delete" | "truncate" | "persist";
+/** SQLite 的默认 busy timeout（毫秒）。 */
+declare const DEFAULT_BUSY_TIMEOUT_MS = 5000;
+/** 一份读出来的日志（分支只看这些字段）。 */
+interface BranchLog {
+  meta: SessionHeader;
+  inheritedEventCount: number;
+  events: SessionEvent[];
+  tornFrom?: number;
+  incarnation: string;
+  revision: number;
+  storedCount: number;
+  migrated: boolean;
+}
+/**
+ * 分支能力需要的持久化面（端口）。
+ *
+ * 为什么不是整个 `SessionPersistenceRdb`：分支只需要「读日志前缀、写截断、认领复用映射」这几件事，
+ * 端口里的每个动词都有真实调用方（不是把服务的方法表转抄一遍）。rewind 走直连快路径，
+ * 所以这里保留了行级的 `eventRows` / `sessionRow` / `transaction`，而不是只给一个 `readLog`。
+ */
+interface BranchPort {
+  readonly ready: Promise<void>;
+  readLog(id: SessionId, options?: {
+    fromSeq?: number;
+  }, signal?: AbortSignal): Promise<BranchLog | undefined>;
+  create(meta: SessionHeader, options?: {
+    inheritedEventCount?: SessionLogOffset;
+  }): Promise<SessionHandle>;
+  eventRows(id: SessionId, fromSequence?: number): Promise<EventRow[]>;
+  eventTypesBefore(id: SessionId, beforeSequence: number, limit: number): Promise<Array<Pick<EventRow, "fSequence" | "fType">>>;
+  sessionRow(id: SessionId): Promise<SessionRow | undefined>;
+  eventTypeAt(id: SessionId, sequence: number): Promise<string | undefined>;
+  transaction<T>(fn: (tx: BackendTx) => Promise<T>): Promise<T>;
+  /** head 回退与 revision bump 是同一次行写，确认位点后写路径才允许继续 append。 */
+  confirmHead(id: SessionId, sequence: number): void;
+  readStoredRevision(id: SessionId): Promise<SessionPersistenceRevision | undefined>;
+  /** fork 复用父会话的事件行：子会话落写时按 seq 取回父行 id。 */
+  registerReuseEventIds(childId: SessionId, map: ReadonlyMap<number, string>): void;
+  dropReuseEventIds(childId: SessionId): void;
+  /** rewind 截断后把活跃写句柄的游标与 seed 长度挪到新水位。 */
+  resetWriterAfterRewind(id: SessionId, cursor: number, inheritedEventCount?: number): void;
+}
+/**
+ * 会话删除的失败语义（叶子模块）。
+ *
+ * 放成叶子是为了断开 `session-store ↔ deletion` 的运行时环：HTTP 路由只依赖这个错误类型，不再值引入整个服务。
+现在 `deletion.ts` 对它只剩 `import type`，运行时环为 0。
+ */
+type SessionDeletionErrorCode = "SESSION_NOT_FOUND" | "SESSION_NOT_ARCHIVED" | "SESSION_LIVE";
+declare class SessionDeletionError extends Error {
+  readonly code: SessionDeletionErrorCode;
+  constructor(message: string, code: SessionDeletionErrorCode);
+}
+type Config = {
+  type: "sqlite";
+  path: string;
+  journalMode?: JournalMode | undefined;
+  busyTimeout?: number | undefined;
+  preparedSessionCacheSize?: number | undefined;
+} | {
+  type: "postgres";
+  connectionString: string;
+  schema?: string | undefined;
+  preparedSessionCacheSize?: number | undefined;
+};
+type ResolvedConfig = Volatile<Config>;
 declare class SessionPersistenceRdb extends SessionPersistence {
   static inject: string[];
   static Config: z<Config, ResolvedConfig>;
   readonly name = "session-rdb";
   readonly tracker: RdbBackendTracker;
-  private readonly backend;
+  /** 打开后的后端；未打开时访问会 fail loud（装配内部、分支端口与测试共用）。 */
+  backend: Backend;
   private storeIdentity;
-  private readonly ready;
-  private readonly writeGuard;
+  /** 后端打开完成（分支端口与 live 路由都先等它）。 */
+  readonly ready: Promise<void>;
+  /** 写者位点守卫（分支的 rewind 与写路径共用）。 */
+  readonly writeGuard: WriteGuard;
+  private readonly live;
+  private readonly readPath;
+  private readonly writePath;
   private readonly reuseEventIds;
-  private readonly liveBuffers;
-  private readonly liveReady;
   readonly config: Config;
-  constructor(ctx: Context, config: ResolvedConfig, injectedBackend?: Backend);
+  constructor(ctx: Context, config: ResolvedConfig);
+  /** 打开完成后的 backend（所有 DB 操作的门）。 */
+  private database;
   private init;
   create(header: SessionHeader, options?: SessionPersistenceCreateOptions): Promise<SessionHandle>;
   open(id: SessionId, access: SessionAccess, options?: SessionPersistenceOpenOptions): Promise<SessionHandle>;
@@ -295,19 +248,29 @@ declare class SessionPersistenceRdb extends SessionPersistence {
   stat(id: SessionId, options?: SessionPersistenceStatOptions): Promise<SessionPersistenceSnapshot | undefined>;
   list(options?: SessionPersistenceListOptions): Promise<readonly SessionPersistenceSnapshot[]>;
   deleteSession(id: SessionId, signal?: AbortSignal): Promise<void>;
+  /**
+   * 整理数据：回收孤儿会话与孤儿事件行，然后**整表重算**三张派生统计表，最后 VACUUM。
+   *
+   * 顺序有依赖：先清孤儿（被删会话独占的事件行才刚成为孤儿），再按事件表重算统计，
+   * 否则统计会把刚删掉的引用算回去。
+   * @returns 三项计数（孤儿会话 / 孤儿事件行 / 重建涉及的会话数）。
+   */
+  organize(): Promise<{
+    orphanSessions: number;
+    orphanEvents: number;
+    rebuiltSessions: number;
+  }>;
   collectOrphans(): Promise<number>;
   collectOrphanSessions(): Promise<number>;
   usageReport(sinceMs?: number): Promise<UsageAggregate>;
   vacuum(): Promise<void>;
+  /**
+   * 已归档的会话 id（`t_sessions.f_archived_at` 非空）。`session/list` 默认过滤掉它们。
+   * 读的是持久化里的归档标记，不依赖 `workspaceRegistry` 服务的就绪时机。
+   * @returns 归档过的 Session id 集。
+   */
+  archivedSessionIds(): Promise<ReadonlySet<string>>;
   private unarchiveBeforeDeletion;
-  readRaw(id: SessionId, signal?: AbortSignal): Promise<{
-    meta: SessionHeader;
-    inheritedEventCount: number;
-    filename: string;
-    content: string;
-  } | undefined>;
-  materializeEmpty(meta: SessionHeader, inheritedEventCount: SessionLogOffset): Promise<void>;
-  appendBatch(meta: SessionHeader, inheritedEventCount: SessionLogOffset, events: readonly SessionEvent[], tornTruncateTo?: number): Promise<boolean>;
   readLog(id: SessionId, options?: {
     fromSeq?: number;
   }, signal?: AbortSignal): Promise<{
@@ -320,15 +283,19 @@ declare class SessionPersistenceRdb extends SessionPersistence {
     storedCount: number;
     migrated: boolean;
   } | undefined>;
-  private recordSessionStats;
-  rebuildSessionStats(id: SessionId): Promise<void>;
-  private refreshEventUsageFlags;
-  private dropSessionStats;
-  private rewriteMigratedLog;
-  listSnapshots(signal?: AbortSignal): Promise<Array<SessionPersistenceSnapshot & {
+  readRaw(id: SessionId, signal?: AbortSignal): Promise<{
+    meta: SessionHeader;
     inheritedEventCount: number;
-  }>>;
+    filename: string;
+    content: string;
+  } | undefined>;
+  listSnapshots(signal?: AbortSignal): Promise<(SessionPersistenceSnapshot & {
+    inheritedEventCount: number;
+  })[]>;
   readStoredRevision(id: SessionId, signal?: AbortSignal): Promise<SessionPersistenceRevision | undefined>;
+  materializeEmpty(meta: SessionHeader, inheritedEventCount: SessionLogOffset): Promise<void>;
+  appendBatch(meta: SessionHeader, inheritedEventCount: SessionLogOffset, events: readonly SessionEvent[], tornTruncateTo?: number): Promise<boolean>;
+  close(): Promise<void>;
   createAndAppend(header: SessionHeader, events: readonly SessionEvent[], inheritedEventCount?: number): Promise<void>;
   load(id: SessionId, signal?: AbortSignal): Promise<import("@deepseek-ai/dsh-session-persistence").SessionInspection>;
   append(id: SessionId, events: readonly SessionEvent[]): Promise<void>;
@@ -337,19 +304,12 @@ declare class SessionPersistenceRdb extends SessionPersistence {
     inheritedEventCount: number;
     events: readonly SessionEvent[];
   }>;
-  close(): Promise<void>;
   registerReuseEventIds(childId: SessionId, map: ReadonlyMap<number, string>): void;
   dropReuseEventIds(childId: SessionId): void;
-  internals(): SessionPersistenceRdbInternals;
+  /** 分支能力的端口（见 `branch/port.ts`）：每个动词都有真实调用方，不是服务方法表的转抄。 */
+  branchPort(): BranchPort;
   private rowRevision;
-  private readonly liveFailures;
-  private readonly liveDropWarned;
-  private watchLiveReady;
-  private installLiveRouting;
-  private ensureLiveHandle;
 }
-//#endregion
-//#region src/usage.d.ts
 type UsageRangeKey = "all" | "day" | "week" | "7d" | "30d" | "90d";
 declare function resolveUsageSince(range: UsageRangeKey, now: number): number | undefined;
 interface UsageTokenTotals {
@@ -394,8 +354,6 @@ declare function addTokenTotals(target: UsageTokenTotals, row: UsageTokenTotals)
 declare function addActivityTotals(target: UsageActivityTotals, row: UsageActivityTotals): UsageActivityTotals;
 declare function addTotals(target: UsageTotals, row: UsageTotals): UsageTotals;
 declare function registerSessionUsage(ctx: Context, persistence: SessionPersistenceRdb): void;
-//#endregion
-//#region src/backend.d.ts
 interface SessionRow {
   fSessionId: string;
   fHeadEventId: string;
@@ -452,6 +410,8 @@ interface BackendTx {
     fSurfaceOp: string | null;
   }>): Promise<void>;
   updateHead(id: SessionId, headEventId: string, headSequence: number): Promise<void>;
+  /** 推进 head 并 bump revision：同一行一次 UPDATE（分两次写是纯写放大）。 */
+  updateHeadAndRevision(id: SessionId, headEventId: string, headSequence: number, lastEventAt?: number): Promise<void>;
   bumpRevision(id: SessionId, lastEventAt?: number): Promise<void>;
   deleteBridgeTail(id: SessionId, fromSequence: number): Promise<readonly string[]>;
   getPrevBridge(id: SessionId, sequence: number): Promise<{
@@ -493,16 +453,28 @@ interface SessionUsageBucket extends UsageTokenTotals {
   provider: string | null;
   model: string | null;
 }
+/** 会话读的共享实现：写路径之外的所有查询都在这里（两方言共用一套投影查询）。 */
+interface ReadModel {
+  getSession(id: string): Promise<SessionRow | undefined>;
+  getEventRows(id: string, fromSequence?: number): Promise<EventRow[]>;
+  getEventTypeAt(id: string, sequence: number): Promise<string | undefined>;
+  getEventTypesBefore(id: string, beforeSequence: number, limit: number): Promise<Array<Pick<EventRow, "fSequence" | "fType">>>;
+  listSessions(): Promise<SessionRow[]>;
+  /** 最新一条 `session/title` 事件（`refreshTitle` 用）。 */
+  latestTitleEvent(id: string): Promise<{
+    fSequence: number;
+    fData: string;
+  } | undefined>;
+  /** 父会话已不在表里的 subagent 会话。 */
+  listOrphanSubagentSessions(): Promise<string[]>;
+}
 interface Backend {
   readonly kind: "sqlite" | "postgres";
   readonly storeIdentity: string;
   readonly storage: StorageRepository;
+  /** 读面：会话行与事件行的查询（不再是 Backend 自己的 6 个转发方法）。 */
+  readonly reads: ReadModel;
   open(): Promise<void>;
-  getSession(id: SessionId): Promise<SessionRow | undefined>;
-  getEventRows(id: SessionId, fromSequence?: number): Promise<EventRow[]>;
-  getEventTypeAt(id: SessionId, sequence: number): Promise<string | undefined>;
-  getEventTypesBefore(id: SessionId, beforeSequence: number, limit: number): Promise<Array<Pick<EventRow, "fSequence" | "fType">>>;
-  listSessions(): Promise<SessionRow[]>;
   transaction<T>(fn: (tx: BackendTx) => Promise<T>): Promise<T>;
   collectOrphans(): Promise<number>;
   listOrphanSubagentSessions(): Promise<SessionId[]>;
@@ -511,84 +483,10 @@ interface Backend {
   incrementSessionUsage(id: SessionId, buckets: readonly SessionUsageBucket[]): Promise<void>;
   incrementSessionCounts(id: SessionId, buckets: readonly SessionCountBucket[]): Promise<void>;
   rebuildSessionStats(id: SessionId): Promise<void>;
+  rebuildAllStats(): Promise<number>;
   refreshEventUsageFlags(eventIds: readonly string[]): Promise<void>;
   deleteSessionStats(id: SessionId): Promise<void>;
   vacuum(): Promise<void>;
   close(): Promise<void>;
 }
-//#endregion
-//#region src/log.d.ts
-declare function rowToMeta(row: SessionRow): SessionHeader;
-declare function sessionInsertRow(storage: SessionStorageMetadata, incarnation: string): {
-  fSessionId: string;
-  fHeadEventId: string;
-  fHeadSequence: number;
-  fVersion: number;
-  fCreatedAt: number;
-  fCwd: string | null;
-  fParentSession: string | null;
-  fSeedLength: number | null;
-  fOrigin: string | null;
-  fDelegationDepth: number | null;
-  fAgentPreset: string | null;
-  fIncarnation: string;
-  fRevision: number;
-};
-declare function sessionConflictRow(storage: SessionStorageMetadata): {
-  fVersion: number;
-  fCreatedAt: number;
-  fCwd: string | null;
-  fParentSession: string | null;
-  fSeedLength: number | null;
-  fOrigin: string | null;
-  fDelegationDepth: number | null;
-  fAgentPreset: string | null;
-};
-declare function rowToEvent(row: EventRow): SessionEvent;
-declare function recomputeReplaceProvenance(events: SessionEvent[]): void;
-declare function findSurfaceRepairs(events: readonly SessionEvent[]): {
-  degradeToAppend: Set<number>;
-  addAppendMarker: Set<number>;
-  clearSurfaceOp: Set<number>;
-  clampEnd: Map<number, number>;
-};
-declare function repairSurfaceOps(events: SessionEvent[]): void;
-declare function repairAssistantSettlement(events: SessionEvent[]): void;
-declare function repairRequestHeaders(events: SessionEvent[]): void;
-declare function syncMeteringRanges(events: SessionEvent[]): void;
-declare function renameLegacyPtcEvents(events: SessionEvent[]): void;
-declare function normalizeToCurrentShape(events: SessionEvent[]): void;
-declare function sealOwnEvents(events: readonly SessionEvent[]): void;
-declare const OWN_EVENT_TYPES: ReadonlySet<string>;
-declare function needsShapeAdoption(events: readonly SessionEvent[]): boolean;
-declare function repairReadView(events: SessionEvent[]): void;
-declare function orphanInboxSpliceSeqs(events: readonly SessionEvent[]): Set<number>;
-declare function repairOrphanInboxSplices(events: SessionEvent[]): void;
-declare function scanRows(rows: readonly EventRow[], base?: number): {
-  preserved: SessionEvent[];
-  tornFrom?: number;
-};
-declare function toJsonlArtifact(meta: SessionHeader, inheritedEventCount: number, events: readonly SessionEvent[]): string;
-declare function titleOfEventData(data: string): string | undefined;
-interface EventUsageRow {
-  fEventId: string;
-  fCreatedAt: number;
-  fDay: string;
-  fProvider: string | null;
-  fModel: string | null;
-  fReferenced: number;
-  fSubagent: number;
-  fInputTokens: number;
-  fOutputTokens: number;
-  fCacheReadTokens: number;
-  fReasoningTokens: number;
-  fTotalTokens: number;
-}
-declare function usageRowOf(event: {
-  fEventId: string;
-  fCreatedAt: number;
-  fType: string;
-  fData: string;
-}, subagent: boolean): EventUsageRow | undefined;
-//#endregion
-export { SessionDeletionErrorCode as $, SessionRow as A, tWorkspaces as At, UsageTotals as B, usageRowOf as C, tSessionEvents as Ct, SessionCountBucket as D, tStorageUnits as Dt, EventRow as E, tSessions as Et, UsageAggregate as F, SESSION_IMPORT_PATH as Ft, emptyTotals as G, addActivityTotals as H, UsageBucket as I, SESSION_ROWS_PATH as It, resolveUsageSince as J, localDayKey as K, UsageRangeKey as L, SESSION_USAGE_PATH as Lt, COUNTED_EVENT_TYPES as M, SESSION_DELETE_PATH as Mt, SessionUsageReport as N, SESSION_EXPORT_PATH as Nt, SessionListRowsPage as O, tWorkspaceSessions as Ot, UsageActivityTotals as P, SESSION_GC_PATH as Pt, SessionDeletionError as Q, UsageSessionRow as R, StorageRepository as Rt, toJsonlArtifact as S, tSessionCounts as St, BackendTx as T, tSessionUsage as Tt, addTokenTotals as U, addActivityCount as V, addTotals as W, ProjectionCacheOptions as X, Config as Y, ResolvedConfig as Z, sealOwnEvents as _, tEventUsage as _t, normalizeToCurrentShape as a, truncateLiveSession as at, syncMeteringRanges as b, tScheduleTasks as bt, renameLegacyPtcEvents as c, DEFAULT_BUSY_TIMEOUT_MS as ct, repairReadView as d, EventRole as dt, SessionPersistenceRdb as et, repairRequestHeaders as f, JournalMode as ft, scanRows as g, eventKind as gt, rowToMeta as h, eventDimensions as ht, needsShapeAdoption as i, locateTurnEnd as it, SessionUsageBucket as j, WriteGuard as jt, SessionListRowsQuery as k, tWorkspaceState as kt, repairAssistantSettlement as l, EVENT_ENCODING as lt, rowToEvent as m, SESSION_PERSISTENCE_SQLITE_APPLICATION_ID as mt, OWN_EVENT_TYPES as n, SessionBranchRdb as nt, orphanInboxSpliceSeqs as o, SessionRowsItem as ot, repairSurfaceOps as p, SCHEMA_VERSION as pt, registerSessionUsage as q, findSurfaceRepairs as r, SessionBranchRdbProvider as rt, recomputeReplaceProvenance as s, SessionRowsValue as st, EventUsageRow as t, SessionPersistenceRdbInternals as tt, repairOrphanInboxSplices as u, EventKind as ut, sessionConflictRow as v, tEvents as vt, Backend as w, tSessionProjcacheRows as wt, titleOfEventData as x, tSchemaMeta as xt, sessionInsertRow as y, tPersistenceState as yt, UsageTokenTotals as z };
+export { SessionDeletionError as A, SESSION_EXPORT_PATH as B, emptyTotals as C, Config as D, resolveUsageSince as E, JournalMode as F, StorageRepository as G, SESSION_ORGANIZE_PATH as H, SCHEMA_VERSION as I, EventUsageRow as K, SESSION_PERSISTENCE_SQLITE_APPLICATION_ID as L, BranchPort as M, DEFAULT_BUSY_TIMEOUT_MS as N, ResolvedConfig as O, EVENT_ENCODING as P, WriteGuard as R, addTotals as S, registerSessionUsage as T, SESSION_ROWS_PATH as U, SESSION_IMPORT_PATH as V, SESSION_USAGE_PATH as W, UsageTokenTotals as _, SessionCountBucket as a, addActivityTotals as b, SessionRow as c, SessionUsageReport as d, UsageActivityTotals as f, UsageSessionRow as g, UsageRangeKey as h, ReadModel as i, SessionDeletionErrorCode as j, SessionPersistenceRdb as k, SessionUsageBucket as l, UsageBucket as m, BackendTx as n, SessionListRowsPage as o, UsageAggregate as p, usageRowOf as q, EventRow as r, SessionListRowsQuery as s, Backend as t, COUNTED_EVENT_TYPES as u, UsageTotals as v, localDayKey as w, addTokenTotals as x, addActivityCount as y, SESSION_DELETE_PATH as z };