@morlay/session-rdb 0.0.21-alpha.4 → 0.0.21-alpha.6

package/dist/{src-Bn0038Sp.mjs → src-B9X8BKyh.mjs}

@@ -1,6 +1,6 @@
-import { A as WriteGuard, O as postgresTableDefs, a as addActivityCount, c as emptyTotals, d as DEFAULT_BUSY_TIMEOUT_MS, f as EVENT_ENCODING, h as eventDimensions, i as COUNTED_EVENT_TYPES, k as toPostgresSchema, l as localDayKey, o as addTokenTotals, r as createStorageRepository, s as addTotals, t as SqliteBackend, u as registerSessionUsage } from "./sqlite-C3LHLzYW.mjs";
-import { _ as toJsonlArtifact, d as rowToMeta, f as scanRows, g as titleOfEventData, m as sessionInsertRow, p as sessionConflictRow, s as repairReadView, v as usageRowOf } from "./log-C-rbdFwK.mjs";
-import { c as isLegacyVersion, o as adoptLegacyRows, s as convertLegacyRows, t as SessionBranchRdb } from "./branch-Dlmbkfjj.mjs";
+import { A as WriteGuard, O as postgresTableDefs, a as addActivityCount, c as emptyTotals, d as DEFAULT_BUSY_TIMEOUT_MS, f as EVENT_ENCODING, h as eventDimensions, i as COUNTED_EVENT_TYPES, k as toPostgresSchema, l as localDayKey, o as addTokenTotals, r as createStorageRepository, s as addTotals, t as SqliteBackend, u as registerSessionUsage } from "./sqlite-zcXVyMxr.mjs";
+import { _ as sessionInsertRow, b as toJsonlArtifact, g as sessionConflictRow, h as scanRows, m as rowToMeta, r as hasLegacyShape, u as repairReadView, x as usageRowOf, y as titleOfEventData } from "./log-qCNkDjh5.mjs";
+import { c as isLegacyVersion, o as adoptLegacyRows, s as convertLegacyRows, t as SessionBranchRdb } from "./branch-BjUR6wfe.mjs";
 import { registerSessionImport } from "./import.mjs";
 import z from "@deepseek-ai/schemastery";
 import { randomUUID } from "node:crypto";
@@ -173,7 +173,7 @@ var PostgresBackend = class PostgresBackend {
 			insertEvents: (events) => this.insertEvents(tx, events),
 			insertBridges: (rows) => this.insertBridges(tx, rows),
 			updateHead: (id, headEventId, headSequence) => this.updateHead(tx, id, headEventId, headSequence),
-			bumpRevision: (id) => this.bumpRevision(tx, id),
+			bumpRevision: (id, lastEventAt) => this.bumpRevision(tx, id, lastEventAt),
 			refreshTitle: (id) => this.refreshTitle(tx, id),
 			deleteBridgeTail: (id, fromSequence) => this.deleteBridgeTail(tx, id, fromSequence),
 			getPrevBridge: (id, sequence) => this.getPrevBridge(tx, id, sequence),
@@ -226,8 +226,12 @@ var PostgresBackend = class PostgresBackend {
 			fHeadSequence: headSequence
 		}).where(eq(this.tables["t_sessions"].fSessionId, id)).execute();
 	}
-	async bumpRevision(exec, id) {
-		await exec.update(this.tables["t_sessions"]).set({ fRevision: sql`${this.tables["t_sessions"].fRevision} + 1` }).where(eq(this.tables["t_sessions"].fSessionId, id)).execute();
+	async bumpRevision(exec, id, lastEventAt) {
+		const sessions = this.tables["t_sessions"];
+		await exec.update(sessions).set({
+			fRevision: sql`${sessions.fRevision} + 1`,
+			...lastEventAt === void 0 ? {} : { fLastEventAt: sql`GREATEST(COALESCE(${sessions.fLastEventAt}, 0), ${lastEventAt})` }
+		}).where(eq(sessions.fSessionId, id)).execute();
 	}
 	async refreshTitle(exec, id) {
 		const bridges = this.tables["t_session_events"];
@@ -313,6 +317,55 @@ var PostgresBackend = class PostgresBackend {
     `);
 	}
 	/** 用量聚合：与 SQLite 侧同形，读 `t_event_usage`，数值列回来是字符串。 */
+	async listSessionRows(query = {}) {
+		const needle = query.query?.trim().toLowerCase() ?? "";
+		const like = `%${needle}%`;
+		const includeSubagents = query.includeSubagents === true;
+		const limit = query.limit ?? 20;
+		const offset = query.offset ?? 0;
+		const tSessions = this.tables["t_sessions"];
+		const tWorkspaces = this.tables["t_workspaces"];
+		const tWorkspaceSessions = this.tables["t_workspace_sessions"];
+		const workspaceTitle = sql`(SELECT w.f_title FROM ${tWorkspaceSessions} b
+                                     JOIN ${tWorkspaces} w ON w.f_workspace_id = b.f_workspace_id
+                                    WHERE b.f_session_id = s.f_session_id
+                                    ORDER BY b.f_position LIMIT 1)`;
+		const where = sql`WHERE (${needle} = ''
+                          OR lower(COALESCE(s.f_title, '')) LIKE ${like}
+                          OR lower(COALESCE(${workspaceTitle}, '')) LIKE ${like})
+                        AND (${includeSubagents} OR s.f_origin IS DISTINCT FROM 'subagent')`;
+		const rows = await this.db.execute(sql`
+      SELECT s.f_session_id AS session_id,
+             s.f_title AS title,
+             s.f_origin AS origin,
+             s.f_cwd AS cwd,
+             s.f_created_at AS created_at,
+             (s.f_archived_at IS NOT NULL) AS archived,
+             COALESCE(s.f_last_event_at, s.f_created_at) AS updated_at,
+             ${workspaceTitle} AS workspace
+        FROM ${tSessions} s
+        ${where}
+       ORDER BY updated_at DESC, s.f_session_id
+       LIMIT ${limit} OFFSET ${offset}
+    `);
+		const counted = await this.db.execute(sql`
+      SELECT count(*) AS n FROM ${tSessions} s ${where}
+    `);
+		return {
+			items: rows.rows.map((row) => ({
+				sessionId: typeof row["session_id"] === "string" ? row["session_id"] : String(row["session_id"]),
+				title: typeof row["title"] === "string" ? row["title"] : null,
+				origin: typeof row["origin"] === "string" ? row["origin"] : null,
+				cwd: typeof row["cwd"] === "string" ? row["cwd"] : null,
+				createdAt: numeric(row["created_at"]),
+				updatedAt: numeric(row["updated_at"]),
+				archived: row["archived"] === true,
+				subagent: row["origin"] === "subagent",
+				workspace: typeof row["workspace"] === "string" ? row["workspace"] : null
+			})),
+			total: numeric(counted.rows[0]?.["n"] ?? 0)
+		};
+	}
 	async usageReport(sinceMs) {
 		const usageSince = sinceMs === void 0 ? sql`` : sql` AND u.f_created_at >= ${sinceMs}`;
 		const daySince = sinceMs === void 0 ? sql`` : sql` AND c.f_day >= ${localDayKey(sinceMs)}`;
@@ -404,7 +457,7 @@ var PostgresBackend = class PostgresBackend {
 				...tokenTotalsOf(row)
 			})),
 			sessions: tokenSessions.rows.map((row) => ({
-				sessionId: String(row["session_id"]),
+				sessionId: typeof row["session_id"] === "string" ? row["session_id"] : String(row["session_id"]),
 				title: text(row["title"]),
 				subagent: row["subagent"] === true,
 				archived: row["archived"] === true,
@@ -693,11 +746,96 @@ function registerSessionGc(ctx, persistence) {
 	});
 }
 //#endregion
+//#region src/rows.ts
+/**
+* 管理面的会话列表：**我们自己的**一条路由（完整语料，含归档），与官方 `session/list` 分开。
+*
+* 官方那条（`session/list` → `ctx.sessionQuery.listSessions`）按部署策略默认排除已归档——那是给上游
+* UI 用的。归档集的管理动作要有完整列表，所以这里单独给一条：标题直接从会话列取，最后活动时间用
+* 该会话最后一个事件的时间。
+*/
+const SESSION_ROWS_PATH = "/api/session.rows";
+/** 一页的条数上限：超过就按上限截断（这个接口给页面用，不是导出通道）。 */
+const MAX_PAGE_SIZE = 200;
+const DEFAULT_PAGE_SIZE = 20;
+function registerSessionRows(ctx, backend) {
+	ctx.inject(["webServer", "connection"], (webCtx) => {
+		const webServer = webCtx.webServer;
+		const connection = webCtx.get("connection");
+		return webCtx.effect(() => webServer.register({
+			kind: "exact",
+			path: SESSION_ROWS_PATH,
+			handler: async (req, res) => {
+				const rejection = connection.requestRejection(req);
+				if (rejection !== void 0) {
+					res.writeHead(rejection);
+					res.end(rejection === 401 ? "unauthorized" : "forbidden");
+					return;
+				}
+				if (req.method !== "POST") {
+					res.writeHead(405, { "content-type": "application/json" });
+					res.end(JSON.stringify({ error: "method not allowed" }));
+					return;
+				}
+				const chunks = [];
+				for await (const chunk of req) chunks.push(chunk);
+				const raw = Buffer.concat(chunks).toString("utf8");
+				let envelope = {};
+				if (raw !== "") try {
+					envelope = JSON.parse(raw);
+				} catch {
+					res.writeHead(400, { "content-type": "application/json" });
+					res.end(JSON.stringify({ error: "request body is not JSON" }));
+					return;
+				}
+				const page = Number.isSafeInteger(envelope.page) && (envelope.page ?? 0) > 0 ? envelope.page : 1;
+				const requested = envelope.pageSize;
+				const pageSize = Number.isSafeInteger(requested) && (requested ?? 0) > 0 ? Math.min(requested, MAX_PAGE_SIZE) : DEFAULT_PAGE_SIZE;
+				try {
+					const { items, total } = await backend.listSessionRows({
+						...envelope.query === void 0 ? {} : { query: envelope.query },
+						...envelope.includeSubagents === void 0 ? {} : { includeSubagents: envelope.includeSubagents },
+						limit: pageSize,
+						offset: (page - 1) * pageSize
+					});
+					res.writeHead(200, { "content-type": "application/json" });
+					res.end(JSON.stringify({
+						items,
+						total,
+						page,
+						pageSize
+					}));
+				} catch (error) {
+					res.writeHead(500, { "content-type": "application/json" });
+					res.end(JSON.stringify({ error: error instanceof Error ? error.message : "session rows failed" }));
+				}
+			}
+		}), "session-rdb: session rows route");
+	});
+}
+//#endregion
 //#region src/session-query.ts
 var SessionQueryRdb = class extends SessionQueryEngine {
 	constructor(ctx, config = {}) {
 		super(ctx, config);
 	}
+	/**
+	* 官方列表（`session/list`）**默认不含已归档**：归档是「收起来」的会话，列表与搜索都不该把它混进
+	* 日常集合（上游 client 再用 workspace registry 的归档集做「只看归档」的派生）。
+	*
+	* 完整语料（含归档）走我们自己的管理面路由 `SESSION_ROWS_PATH`——两条路分开，不在一处混。
+	*/
+	async listSessions(signal) {
+		const records = await super.listSessions(signal);
+		const archived = this.archivedSessionIds();
+		if (archived.size === 0) return records;
+		return records.filter((record) => !archived.has(String(record.header.id)));
+	}
+	/** 归档集合来自 workspace registry；服务未就绪时保守返回空集（宁可多给，不可漏掉可见会话）。 */
+	archivedSessionIds() {
+		const registry = this.ctx.get("workspaceRegistry");
+		return new Set(registry?.archivedSessionIds ?? []);
+	}
 	async searchSessions() {
 		throw searchDisabled();
 	}
@@ -743,11 +881,19 @@ var SessionProjectionCacheRdb = class extends Service {
 		if (record === void 0) return void 0;
 		return identityMatches(record.identity, expected) ? record : void 0;
 	}
-	cachedSnapshot(meta, inheritedEventCount, keys) {
-		const record = this.recordFor(meta.id, identityOf(meta, inheritedEventCount));
+	/**
+	* header-only 读（会话列表这类）：上游 0.1.7 起只给 header 与 keys——它要求的是**生命周期**身份，
+	* 不再要求调用方提供 inherited cut（那个 cut 只有写路径与 hydration 用得上）。
+	*/
+	cachedSnapshot(meta, keys) {
+		const record = this.recordForLifecycle(meta);
 		const snapshot = record === void 0 ? void 0 : this.viewRecord(record, keys);
 		return this.withDirectTitle(meta.id, keys, snapshot);
 	}
+	recordForLifecycle(meta) {
+		const record = this.lookup(meta.id);
+		return record === void 0 || !identityMatches(record.identity, lifecycleIdentityOf(meta)) ? void 0 : record;
+	}
 	withDirectTitle(id, keys, snapshot) {
 		if (keys !== void 0 && !keys.includes(PREDECESSOR_TITLE_KEY)) return snapshot;
 		if (snapshot?.values[PREDECESSOR_TITLE_KEY] !== void 0) return snapshot;
@@ -762,15 +908,10 @@ var SessionProjectionCacheRdb = class extends Service {
 			values
 		};
 	}
-	cachedPredecessorTitle(meta, inheritedEventCount) {
-		const expected = identityOf(meta, inheritedEventCount);
+	cachedPredecessorTitle(meta) {
 		const record = this.lookup(meta.id);
-		if (record === void 0 || !predecessorIdentityMatches(record.identity, expected)) return;
-		const title = this.viewRecord(record, [PREDECESSOR_TITLE_KEY]);
-		return title === void 0 ? void 0 : {
-			...title,
-			asOfSeq: -1
-		};
+		if (record === void 0 || !predecessorIdentityMatches(record.identity, lifecycleIdentityOf(meta))) return;
+		return this.viewRecord(record, [PREDECESSOR_TITLE_KEY]);
 	}
 	viewRecord(record, keys) {
 		const values = this.ctx.sessionProjections.viewCheckpoint(record.rows, keys);
@@ -886,6 +1027,15 @@ function detachJson(rows) {
 	if (text === void 0) throw new TypeError("projection checkpoint is not losslessly JSON-serializable");
 	return JSON.parse(text);
 }
+/** header 能证明的生命周期身份（不含 inherited cut）：header-only 读只比对它。 */
+function lifecycleIdentityOf(header) {
+	return {
+		formatVersion: header.version,
+		createdAt: header.createdAt,
+		...header.cwd === void 0 ? {} : { cwd: header.cwd },
+		isSeeded: header.isSeeded
+	};
+}
 function identityOf(header, inheritedEventCount) {
 	const cut = SessionLogOffset(inheritedEventCount);
 	if (!header.isSeeded && cut !== 0) throw new Error("unseeded projection-cache identity inherited event count must be 0");
@@ -904,7 +1054,7 @@ function predecessorIdentityMatches(stored, expected) {
 	return (stored.formatVersion === void 0 || stored.formatVersion < expected.formatVersion) && lifecycleIdentityMatches(stored, expected);
 }
 function lifecycleIdentityMatches(stored, expected) {
-	return stored.createdAt === expected.createdAt && stored.cwd === expected.cwd && (stored.isSeeded ?? false) === expected.isSeeded && (stored.inheritedEventCount ?? 0) === expected.inheritedEventCount;
+	return stored.createdAt === expected.createdAt && stored.cwd === expected.cwd && (stored.isSeeded ?? false) === expected.isSeeded;
 }
 //#endregion
 //#region src/storage-takeover/storage-backend.ts
@@ -1018,11 +1168,12 @@ function workspaceRecordOf(value) {
 }
 function workspaceStateOf(value) {
 	const state = value;
-	if (typeof state !== "object" || state === null || typeof state.initialized !== "boolean" || !Array.isArray(state.workspaceIds) || !Array.isArray(state.archivedSessionIds)) throw new TypeError("workspace registry state does not match the stored shape");
+	if (typeof state !== "object" || state === null || typeof state.initialized !== "boolean" || !Array.isArray(state.workspaceIds) || !Array.isArray(state.archivedSessionIds) || !Array.isArray(state.pinnedSessionIds)) throw new TypeError("workspace registry state does not match the stored shape");
 	return {
 		initialized: state.initialized,
 		workspaceIds: state.workspaceIds.map((id) => id),
 		archivedSessionIds: state.archivedSessionIds.map((id) => id),
+		pinnedSessionIds: state.pinnedSessionIds.map((id) => id),
 		...state.pendingMutation === void 0 ? {} : { pendingMutation: state.pendingMutation }
 	};
 }
@@ -1048,6 +1199,16 @@ function installStorageTakeover(ctx, options) {
 }
 //#endregion
 //#region src/index.ts
+/** 一批事件里的最大时间：写路径据此推进会话行的「最后活动时间」。 */
+function maxEventTime(events) {
+	let max;
+	for (const event of events) {
+		const time = event.time;
+		if (typeof time !== "number") continue;
+		if (max === void 0 || time > max) max = time;
+	}
+	return max;
+}
 const DEFAULT_PROJECTION_WRITE_EVERY_EVENTS = 200;
 const DEFAULT_PROJECTION_WRITE_INTERVAL_MS = 5e3;
 var SessionDeletionError = class extends Error {
@@ -1306,9 +1467,9 @@ var RdbSessionHandle = class RdbSessionHandle {
 	}
 	static LIVE_WRITE_BATCH_MAX_DELAY_MS = 200;
 };
-var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersistence {
+var SessionPersistenceRdb = class extends SessionPersistence {
 	config;
-	static inject = ["sessions", "settings"];
+	static inject = ["sessions"];
 	static Config = z.union([z.object({
 		type: z.const("sqlite"),
 		path: z.string().required(),
@@ -1338,7 +1499,6 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 			writeIntervalMs: DEFAULT_PROJECTION_WRITE_INTERVAL_MS
 		})
 	})]);
-	static settingsNs = "session-rdb";
 	name = "session-rdb";
 	tracker = new RdbBackendTracker(this.name);
 	backend;
@@ -1349,19 +1509,9 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 	liveBuffers = /* @__PURE__ */ new Map();
 	liveReady = /* @__PURE__ */ new Map();
 	constructor(ctx, config, injectedBackend) {
-		let resolved = config;
-		const settings = ctx.reflect.get("settings");
-		if (settings !== void 0) {
-			const scope = settings.register(SessionPersistenceRdb.settingsNs, SessionPersistenceRdb.Config, { base: config });
-			resolved = scope.get();
-			scope.watch(() => {
-				ctx.logger.warn("session-rdb: settings changed; restart to apply the new configuration");
-			});
-		}
 		super(ctx);
 		this.config = config;
-		this.config = resolved;
-		this.backend = injectedBackend ?? createBackend(resolved);
+		this.backend = injectedBackend ?? createBackend(config);
 		this.ready = this.init();
 		this.installLiveRouting(ctx);
 		new SessionBranchRdb(this.ctx);
@@ -1371,6 +1521,7 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 		registerSessionExport(this.ctx, this);
 		registerSessionGc(this.ctx, this);
 		registerSessionUsage(this.ctx, this);
+		registerSessionRows(this.ctx, this.backend);
 		installStorageTakeover(this.ctx, {
 			repository: this.backend.storage,
 			ready: this.ready,
@@ -1578,7 +1729,6 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 		if (events.length === 0) return false;
 		validateStoredEvents(meta, [...events]);
 		const reuse = this.reuseEventIds.get(meta.id);
-		if (reuse !== void 0) this.reuseEventIds.delete(meta.id);
 		let confirmedHead = -1;
 		await this.backend.transaction(async (tx) => {
 			if (tornTruncateTo !== void 0) {
@@ -1598,9 +1748,10 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 				nextSeq: head.fHeadSequence + 1
 			}, reuse);
 			await tx.updateHead(meta.id, headEventId, headSequence);
-			await tx.bumpRevision(meta.id);
+			await tx.bumpRevision(meta.id, maxEventTime(events));
 			confirmedHead = headSequence;
 		});
+		if (reuse !== void 0) this.reuseEventIds.delete(meta.id);
 		this.writeGuard.confirmHead(meta.id, confirmedHead);
 		this.tracker.materialized(meta.id);
 		await this.recordEventCounts(meta.id, events);
@@ -1641,6 +1792,19 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 			};
 		}
 		const { preserved, tornFrom } = scanRows(eventRows, options.fromSeq ?? 0);
+		if (hasLegacyShape(preserved)) {
+			const adopted = adoptLegacyRows(row, eventRows);
+			return {
+				meta: adopted.meta,
+				inheritedEventCount: adopted.inheritedEventCount,
+				events: adopted.events,
+				incarnation: row.fIncarnation,
+				revision: row.fRevision,
+				storedCount: eventRows.length,
+				migrated: false,
+				...adopted.tornFrom !== void 0 ? { tornFrom: adopted.tornFrom } : {}
+			};
+		}
 		return {
 			meta,
 			inheritedEventCount: row.fSeedLength ?? 0,
@@ -1683,6 +1847,9 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 	}
 	async rewriteMigratedLog(id, log) {
 		await this.backend.transaction(async (tx) => {
+			const head = await tx.getHead(id);
+			if (!this.writeGuard.has(id)) this.writeGuard.confirmHead(id, head.fHeadSequence);
+			this.writeGuard.assertNoConcurrentWriter(id, head.fHeadSequence);
 			await tx.deleteBridgeTail(id, 0);
 			await tx.upsertSession({
 				meta: log.meta,
@@ -1693,7 +1860,7 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 				nextSeq: 0
 			});
 			await tx.updateHead(id, headEventId, headSequence);
-			await tx.bumpRevision(id);
+			await tx.bumpRevision(id, maxEventTime(log.events));
 		});
 	}
 	async listSnapshots(signal) {
@@ -1784,6 +1951,10 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 	registerReuseEventIds(childId, map) {
 		this.reuseEventIds.set(childId, new Map(map));
 	}
+	/** 丢弃一个还没被消费的复用映射（fork 失败时）：留着会让同一个 childId 之后的落写复用父会话的事件行。 */
+	dropReuseEventIds(childId) {
+		this.reuseEventIds.delete(childId);
+	}
 	internals() {
 		return {
 			backend: this.backend,
@@ -1795,7 +1966,8 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 			readFrom: (id, fromSeq, signal) => this.readFrom(id, fromSeq, signal),
 			listSnapshots: (signal) => this.listSnapshots(signal),
 			readStoredRevision: (id, signal) => this.readStoredRevision(id, signal),
-			registerReuseEventIds: (childId, map) => this.registerReuseEventIds(childId, map)
+			registerReuseEventIds: (childId, map) => this.registerReuseEventIds(childId, map),
+			dropReuseEventIds: (childId) => this.dropReuseEventIds(childId)
 		};
 	}
 	rowRevision(row) {
@@ -2005,4 +2177,4 @@ async function appendEventTail(tx, meta, events, anchor, reuse) {
 	};
 }
 //#endregion
-export { registerSessionDeletion as i, SessionPersistenceRdb as n, SESSION_DELETE_PATH as r, SessionDeletionError as t };
+export { registerSessionDeletion as a, SESSION_DELETE_PATH as i, SessionPersistenceRdb as n, SESSION_ROWS_PATH as r, SessionDeletionError as t };

package/dist/storage.d.mts

@@ -1,4 +1,4 @@
-import { A as tSessionEvents, C as SESSION_PERSISTENCE_SQLITE_APPLICATION_ID, D as tEvents, E as tEventUsage, F as tWorkspaceState, I as tWorkspaces, L as WriteGuard, M as tSessions, N as tStorageUnits, O as tPersistenceState, P as tWorkspaceSessions, R as StorageRepository, S as SCHEMA_VERSION, T as eventKind, _ as DEFAULT_BUSY_TIMEOUT_MS, a as SessionRow, b as EventRole, i as EventRow, j as tSessionProjcacheRows, k as tSchemaMeta, n as BackendTx, o as UsageAggregate, r as EventCountBucket, t as Backend, v as EVENT_ENCODING, w as eventDimensions, x as JournalMode, y as EventKind } from "./backend-a0xDrUFG.mjs";
+import { A as eventKind, B as tWorkspaceState, C as EVENT_ENCODING, D as SCHEMA_VERSION, E as JournalMode, F as tSessionEvents, H as WriteGuard, I as tSessionProjcacheRows, L as tSessions, M as tEvents, N as tPersistenceState, O as SESSION_PERSISTENCE_SQLITE_APPLICATION_ID, P as tSchemaMeta, R as tStorageUnits, S as DEFAULT_BUSY_TIMEOUT_MS, T as EventRole, U as StorageRepository, V as tWorkspaces, a as SessionListRowsPage, c as UsageAggregate, i as EventRow, j as tEventUsage, k as eventDimensions, n as BackendTx, o as SessionListRowsQuery, r as EventCountBucket, s as SessionRow, t as Backend, w as EventKind, z as tWorkspaceSessions } from "./backend-E0bmTXpz.mjs";
 import { SessionId } from "@deepseek-ai/dsh-session";
 import { DatabaseSync } from "node:sqlite";
 //#region src/sqlite.d.ts
@@ -52,6 +52,7 @@ declare class SqliteBackend implements Backend {
    * 沿 `t_events` 的事件类型数——两者限定在**有 token 用量的会话**里，时间范围各自按自己的
    * `f_created_at`（同一时刻写入，口径一致）。
    */
+  listSessionRows(query?: SessionListRowsQuery): Promise<SessionListRowsPage>;
   usageReport(sinceMs?: number): Promise<UsageAggregate>;
   /** 活动计数旁路累加：派生表 `t_event_counts`，不在写事务里（失败可丢，表可销毁重建）。 */
   incrementEventCounts(id: SessionId, buckets: readonly EventCountBucket[]): Promise<void>;

package/dist/storage.mjs

@@ -1,2 +1,2 @@
-import { A as WriteGuard, C as tSessions, D as tWorkspaces, E as tWorkspaceState, S as tSessionProjcacheRows, T as tWorkspaceSessions, _ as tEventUsage, b as tSchemaMeta, d as DEFAULT_BUSY_TIMEOUT_MS, f as EVENT_ENCODING, g as eventKind, h as eventDimensions, m as SESSION_PERSISTENCE_SQLITE_APPLICATION_ID, n as openDatabase, p as SCHEMA_VERSION, t as SqliteBackend, v as tEvents, w as tStorageUnits, x as tSessionEvents, y as tPersistenceState } from "./sqlite-C3LHLzYW.mjs";
+import { A as WriteGuard, C as tSessions, D as tWorkspaces, E as tWorkspaceState, S as tSessionProjcacheRows, T as tWorkspaceSessions, _ as tEventUsage, b as tSchemaMeta, d as DEFAULT_BUSY_TIMEOUT_MS, f as EVENT_ENCODING, g as eventKind, h as eventDimensions, m as SESSION_PERSISTENCE_SQLITE_APPLICATION_ID, n as openDatabase, p as SCHEMA_VERSION, t as SqliteBackend, v as tEvents, w as tStorageUnits, x as tSessionEvents, y as tPersistenceState } from "./sqlite-zcXVyMxr.mjs";
 export { DEFAULT_BUSY_TIMEOUT_MS, EVENT_ENCODING, SCHEMA_VERSION, SESSION_PERSISTENCE_SQLITE_APPLICATION_ID, SqliteBackend, WriteGuard, eventDimensions, eventKind, openDatabase, tEventUsage, tEvents, tPersistenceState, tSchemaMeta, tSessionEvents, tSessionProjcacheRows, tSessions, tStorageUnits, tWorkspaceSessions, tWorkspaceState, tWorkspaces };

package/dist/testing.d.mts

@@ -1,16 +1,7 @@
-import { g as truncateLiveSession } from "./backend-a0xDrUFG.mjs";
+import { v as truncateLiveSession } from "./backend-E0bmTXpz.mjs";
 import { SessionPersistence } from "@deepseek-ai/dsh-session-persistence";
 import { Session, SessionEvent, SessionHeader, SessionId } from "@deepseek-ai/dsh-session";
 import { Context, Fiber } from "@deepseek-ai/cordis";
-import { SettingsNamespace, SettingsProvider } from "@deepseek-ai/dsh-settings";
-//#region src/testing/helpers.d.ts
-declare class EmptySettings extends SettingsProvider {
-  constructor(ctx: Context);
-  get writable(): boolean;
-  protected load(): Promise<Record<string, unknown>>;
-  protected persist(_ns: SettingsNamespace, _section: Record<string, unknown>): Promise<void>;
-}
-//#endregion
 //#region src/testing/contract.d.ts
 interface ContractBackendInstance {
   persistence: SessionPersistence;
@@ -33,4 +24,4 @@ interface CoordinatorFixture {
 }
 declare function runCoordinatorContract(name: string, makeFixture: () => Promise<CoordinatorFixture>): void;
 //#endregion
-export { type ContractBackend, type CoordinatorFixture, EmptySettings, appendLog, meta, oneTurnLog, runCoordinatorContract, runPersistenceContract, truncateLiveSession };
+export { type ContractBackend, type CoordinatorFixture, appendLog, meta, oneTurnLog, runCoordinatorContract, runPersistenceContract, truncateLiveSession };

package/dist/testing.mjs

@@ -1,28 +1,11 @@
-import { a as truncateLiveSession } from "./branch-Dlmbkfjj.mjs";
+import { a as truncateLiveSession } from "./branch-BjUR6wfe.mjs";
 import { SessionAlreadyExistsError, SessionAlreadyOwnedError, SessionFormatUnsupportedError, SessionHandleClosedError, SessionPersistenceNotFoundError, SessionReadOnlyError } from "@deepseek-ai/dsh-session-persistence";
 import SessionStore, { SESSION_FORMAT_VERSION, SessionId, SessionLogOffset, SessionSeq } from "@deepseek-ai/dsh-session";
 import { Context } from "@deepseek-ai/cordis";
-import { SettingsProvider } from "@deepseek-ai/dsh-settings";
 import { MessageId, createUserMessage, freezeMessage } from "@deepseek-ai/dsh-llm";
 //#region \0rolldown/runtime.js
 var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 //#endregion
-//#region src/testing/helpers.ts
-var EmptySettings = class extends SettingsProvider {
-	constructor(ctx) {
-		super(ctx);
-	}
-	get writable() {
-		return true;
-	}
-	async load() {
-		return {};
-	}
-	persist(_ns, _section) {
-		return Promise.resolve();
-	}
-};
-//#endregion
 //#region ../../../node_modules/.pnpm/vitest@5.0.1_@opentelemetry+api@1.9.1_@types+node@26.6.2_happy-dom@20.14.5_jsdom@30.1.0_35ad368e4c4a4b8f279ac875fcf2bfae/node_modules/vitest/dist/chunks/tinyrainbow.Ht9iggcq.js
 var b$1 = {
 	reset: [0, 0],
@@ -15623,4 +15606,4 @@ function runCoordinatorContract(name, makeFixture) {
 	});
 }
 //#endregion
-export { EmptySettings, appendLog, meta, oneTurnLog, runCoordinatorContract, runPersistenceContract, truncateLiveSession };
+export { appendLog, meta, oneTurnLog, runCoordinatorContract, runPersistenceContract, truncateLiveSession };

package/drizzle/postgres/20260921075900_v3_agent_preset/migration.sql

@@ -0,0 +1 @@
+ALTER TABLE "t_sessions" ADD COLUMN "f_agent_preset" text;

package/drizzle/postgres/20260922090001_v3_pinned_seq/migration.sql

@@ -0,0 +1,2 @@
+-- 见 SQLite 侧同名迁移的说明：钉住的会话集合用会话行的序号列表达。
+ALTER TABLE "t_sessions" ADD COLUMN "f_pinned_seq" integer;

package/drizzle/postgres/20260922093001_v3_last_event_at/migration.sql

@@ -0,0 +1,10 @@
+-- 见 SQLite 侧同名迁移的说明：最后活动时间物化到会话行，写路径维护，这里一次性回填。
+ALTER TABLE "t_sessions" ADD COLUMN "f_last_event_at" bigint;
+--> statement-breakpoint
+UPDATE "t_sessions" s
+   SET "f_last_event_at" = (
+         SELECT MAX(e.f_created_at)
+           FROM "t_session_events" se
+           JOIN "t_events" e ON e.f_event_id = se.f_event_id
+          WHERE se.f_session_id = s.f_session_id
+       );

package/drizzle/sqlite/20260921075855_v3_agent_preset/migration.sql

@@ -0,0 +1,7 @@
+-- 只加一列：`agentPreset` 是会话 header 的创建事实，会话投影 `agentPreset` 的 `init` 只读 header
+-- （缺了就被算成 null 并缓存下来），所以列式 header 必须存它。
+--
+-- 生成器另外还想重建 `t_event_usage`（实体的 tokens 列没有 default，而既有迁移建的表带 DEFAULT 0）。
+-- 那次重建与本次改动无关，且会在几十万行的库上重写整表，所以不在这里应用；实体的 default 差异
+-- 留待单独处理。
+ALTER TABLE `t_sessions` ADD `f_agent_preset` text;