@morlay/session-rdb 0.1.10-alpha.0 → 0.1.10-alpha.3

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

@@ -1,51 +1,79 @@
-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";
+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>;
-  deleteWorkspaces(ids: readonly 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>;
-  deleteScheduleTasks(ids: readonly 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>;
 }
 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";
 declare class WriteGuard {
   private readonly headSeqs;
@@ -53,160 +81,6 @@ declare class WriteGuard {
   has(id: SessionId): boolean;
   assertNoConcurrentWriter(id: SessionId, storedHead: number): void;
 }
-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;
-};
-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;
-}
-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;
-  };
-}
-/**
- * 会话**当前内存 log** 的快照（复制一份）。用于"需要完整序列"的操作（首次落库的 seed、rewind / fork 的历史），
- * 不走已弃用的同步历史读 `snapshotEvents()`——那三个读口上游已声明「新调用禁止」，而这里要的是当前内存里
- * 那份完整日志，不是按需分页的历史。
- * @param session - 会话。
- * @returns 事件副本（调用方可以自由遍历）。
- */
-declare function liveEventsOf(session: Session): readonly SessionEvent[];
-/** @returns 截断后日志里最后一个 `turn/start` 的 turn 号（没有则 0）。 */
-declare function truncateLiveSession(session: Session, newLength: number): number;
-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>;
-}
-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;
-  preparedSessionCacheSize?: number | undefined;
-} | {
-  type: "postgres";
-  connectionString: string;
-  schema?: string | undefined;
-  projectionCache?: ProjectionCacheOptions | undefined;
-  preparedSessionCacheSize?: number | 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,6 +248,18 @@ 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>;
@@ -306,14 +271,6 @@ declare class SessionPersistenceRdb extends SessionPersistence {
    */
   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<{
@@ -326,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>;
@@ -343,16 +304,11 @@ 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;
 }
 type UsageRangeKey = "all" | "day" | "week" | "7d" | "30d" | "90d";
 declare function resolveUsageSince(range: UsageRangeKey, now: number): number | undefined;
@@ -454,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<{
@@ -495,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[]>;
@@ -513,81 +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>;
 }
-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;
-export { SessionDeletionErrorCode as $, SessionRow as A, tWorkspaceState as At, UsageTotals as B, usageRowOf as C, tSessionCounts as Ct, SessionCountBucket as D, tSessions as Dt, EventRow as E, tSessionUsage as Et, UsageAggregate as F, SESSION_GC_PATH as Ft, emptyTotals as G, addActivityTotals as H, UsageBucket as I, SESSION_IMPORT_PATH as It, resolveUsageSince as J, localDayKey as K, UsageRangeKey as L, SESSION_ROWS_PATH as Lt, COUNTED_EVENT_TYPES as M, WriteGuard as Mt, SessionUsageReport as N, SESSION_DELETE_PATH as Nt, SessionListRowsPage as O, tStorageUnits as Ot, UsageActivityTotals as P, SESSION_EXPORT_PATH as Pt, SessionDeletionError as Q, UsageSessionRow as R, SESSION_USAGE_PATH as Rt, toJsonlArtifact as S, tSchemaMeta as St, BackendTx as T, tSessionProjcacheRows as Tt, addTokenTotals as U, addActivityCount as V, addTotals as W, ProjectionCacheOptions as X, Config as Y, ResolvedConfig as Z, sealOwnEvents as _, eventKind as _t, normalizeToCurrentShape as a, locateTurnEnd as at, syncMeteringRanges as b, tPersistenceState as bt, renameLegacyPtcEvents as c, SessionRowsValue as ct, repairReadView as d, EventKind as dt, SessionPersistenceRdb as et, repairRequestHeaders as f, EventRole as ft, scanRows as g, eventDimensions as gt, rowToMeta as h, SESSION_PERSISTENCE_SQLITE_APPLICATION_ID as ht, needsShapeAdoption as i, liveEventsOf as it, SessionUsageBucket as j, tWorkspaces as jt, SessionListRowsQuery as k, tWorkspaceSessions as kt, repairAssistantSettlement as l, DEFAULT_BUSY_TIMEOUT_MS as lt, rowToEvent as m, SCHEMA_VERSION as mt, OWN_EVENT_TYPES as n, SessionBranchRdb as nt, orphanInboxSpliceSeqs as o, truncateLiveSession as ot, repairSurfaceOps as p, JournalMode as pt, registerSessionUsage as q, findSurfaceRepairs as r, SessionBranchRdbProvider as rt, recomputeReplaceProvenance as s, SessionRowsItem as st, EventUsageRow as t, SessionPersistenceRdbInternals as tt, repairOrphanInboxSplices as u, EVENT_ENCODING as ut, sessionConflictRow as v, tEventUsage as vt, Backend as w, tSessionEvents as wt, titleOfEventData as x, tScheduleTasks as xt, sessionInsertRow as y, tEvents as yt, UsageTokenTotals as z, StorageRepository as zt };
+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 };