@openclaw/codex 2026.9.5 → 2026.9.6

package/dist/.setup/{session-catalog-index-B141u15s.mjs → session-catalog-index-B9_VQIUz.mjs}

@@ -1,38 +1,87 @@
-import { C as codexCatalogThreadName, D as normalizeLimit, M as readControlCursor, T as filterCatalogPageByTitle, V as CODEX_CATALOG_MAX_ROWS, c as getCodexCatalogSource, g as CatalogParamsError, r as projectCodexCatalogNativeThread, u as setCodexCatalogSource, v as MAX_CWD_LENGTH, w as codexCatalogThreadStatus, x as boundedCatalogString } from "./session-catalog-native-projection-ChV3cCtm.mjs";
-import { i as retainCodexCatalogRow, n as codexCatalogRowRecency, r as compareCodexCatalogRows, t as CodexCatalogOrdering } from "./session-catalog-index-order-Cc5BzlQr.mjs";
-import { n as CodexCatalogPersistence, r as codexCatalogMetadataPage } from "./session-catalog-index-state-BAuDztHN.mjs";
-import { a as withCodexCatalogListRequest, s as CodexCatalogAvailability } from "./session-catalog-fUdWDx-U.mjs";
-import { i as subscribeCodexCatalogEvents } from "./session-catalog-events-jMcYfQyd.mjs";
-import { CodexCatalogProjectionCapacityError, CodexCatalogProjections, i as scanCodexCatalogRollouts, mergeCodexCatalogRolloutRow, n as isCodexCatalogRolloutPathCovered, projectCodexCatalogThread, r as readCodexCatalogRollout, t as codexCatalogRolloutLogicalPath } from "./session-catalog-projection-C1Bj9Jl-.mjs";
+import { C as boundedCatalogString, D as filterCatalogPageByTitle, E as codexCatalogThreadStatus, P as readControlCursor, T as codexCatalogThreadName, U as CODEX_CATALOG_MAX_ROWS, b as MAX_CWD_LENGTH, f as setCodexCatalogSource, k as normalizeLimit, l as getCodexCatalogSource, r as projectCodexCatalogNativeThread, v as CatalogParamsError } from "./session-catalog-native-projection-DowriLid.mjs";
+import { i as subscribeCodexCatalogEvents } from "./session-catalog-events-Bj6j94E_.mjs";
+import { i as retainCodexCatalogRow, n as codexCatalogRowRecency, r as compareCodexCatalogRows, t as CodexCatalogOrdering } from "./session-catalog-index-order-hcdz07yN.mjs";
+import { n as CodexCatalogPersistence, r as codexCatalogMetadataPage } from "./session-catalog-index-state-Dgh8ORJm.mjs";
+import { a as withCodexCatalogListRequest, s as CodexCatalogAvailability } from "./session-catalog-Pno1xGcl.mjs";
+import { a as reportCodexCatalogSpawnFailure, n as findCodexAppServerSpawnError } from "./spawn-error-CL3n6MAa.mjs";
+import { CodexCatalogProjectionCapacityError, CodexCatalogProjections, a as resolveCodexCatalogRolloutFingerprint, i as readCodexCatalogRollout, mergeCodexCatalogRolloutRow, n as indexCodexCatalogRowsByRollout, o as scanCodexCatalogRollouts, projectCodexCatalogThread, r as isCodexCatalogRolloutPathCovered, t as codexCatalogRolloutLogicalPath } from "./session-catalog-projection-zK_PUsiE.mjs";
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { createHash } from "node:crypto";
 import { isDeepStrictEqual } from "node:util";
 import { embeddedAgentLog } from "openclaw/plugin-sdk/agent-harness-registration";
 import { setImmediate as setImmediate$1 } from "node:timers/promises";
-import { toErrorObject } from "openclaw/plugin-sdk/error-runtime";
+import { coerceErrorMessage, toErrorObject } from "openclaw/plugin-sdk/error-runtime";
 import { sanitizeTerminalText } from "openclaw/plugin-sdk/text-chunking";
 //#region extensions/codex/src/session-catalog-currency.ts
+const SAFETY_INTERVAL_MS = 9e5;
 /** One periodic reconciliation cycle per home, without a recursive watcher inventory. */
 var CodexCatalogCurrency = class {
 	constructor(options) {
 		this.options = options;
 		this.closed = false;
+		this.nativeDirty = false;
+		this.nextNativeAt = 0;
+		this.nextFilesAt = 0;
+	}
+	hasActiveWork() {
+		return this.hydration !== void 0 || this.initial !== void 0 || this.running !== void 0;
+	}
+	assertRunnable() {
+		if (this.terminalFailure) throw this.terminalFailure;
+	}
+	stopForTerminalFailure(error) {
+		const failure = findCodexAppServerSpawnError(error);
+		if (!failure) return false;
+		if (!this.closed) {
+			this.terminalFailure = failure;
+			this.close();
+			reportCodexCatalogSpawnFailure(failure);
+		}
+		return true;
+	}
+	scheduleHydration(run) {
+		if (this.closed || this.hydration) return;
+		this.hydration = setImmediate(() => {
+			this.hydration = void 0;
+			(this.options.runBackground ? this.options.runBackground(run) : run()).catch((error) => this.options.report(error));
+		});
+		this.hydration.unref();
+	}
+	cancelHydration() {
+		clearImmediate(this.hydration);
+		this.hydration = void 0;
+	}
+	requestNativeRefresh() {
+		this.nativeDirty = true;
 	}
 	start() {
 		if (this.closed || this.timer) return;
+		this.nextNativeAt = Date.now() + SAFETY_INTERVAL_MS;
+		this.nextFilesAt = this.nextNativeAt;
 		this.timer = setInterval(() => {
 			if (this.running) return;
+			const startedAt = Date.now();
+			const full = startedAt >= this.nextNativeAt;
+			const filesDue = this.options.local && startedAt >= this.nextFilesAt;
+			if (!full && !filesDue && !this.nativeDirty) return;
+			const nativeDue = full || this.nativeDirty;
+			this.nativeDirty = false;
+			if (full) this.nextNativeAt = startedAt + SAFETY_INTERVAL_MS;
+			if (filesDue) this.nextFilesAt = startedAt + SAFETY_INTERVAL_MS;
 			const run = async () => {
-				await this.options.reconcileFiles();
-				await this.options.reconcileNative();
+				if (filesDue) await this.options.reconcileFiles();
+				if (nativeDue) await this.options.reconcileNative(full);
 			};
-			this.running = (this.options.runBackground ? this.options.runBackground(run) : run()).catch((error) => this.options.report(error)).finally(() => {
+			this.running = (this.options.runBackground ? this.options.runBackground(run) : run()).catch((error) => {
+				this.options.report(new Error(`Codex catalog reconciliation failed; waiting for new activity or the next safety cycle: ${coerceErrorMessage(error)}`, { cause: error }));
+			}).finally(() => {
 				this.running = void 0;
 			});
 		}, 3e4);
 		this.timer.unref();
 		if (this.options.local) {
 			this.initial = setTimeout(() => {
+				this.initial = void 0;
 				this.options.reconcileFiles().catch((error) => this.options.report(error));
 			}, 0);
 			this.initial.unref();
@@ -40,8 +89,12 @@ var CodexCatalogCurrency = class {
 	}
 	close() {
 		this.closed = true;
+		this.cancelHydration();
 		clearInterval(this.timer);
+		this.timer = void 0;
 		clearTimeout(this.initial);
+		this.initial = void 0;
+		return this.running;
 	}
 };
 //#endregion
@@ -118,6 +171,9 @@ var CodexCatalogIndexEvents = class {
 		this.pending = /* @__PURE__ */ new Map();
 		this.upserting = /* @__PURE__ */ new Set();
 	}
+	hasActiveWork() {
+		return this.pending.size > 0 || this.upserting.size > 0;
+	}
 	handle(event, readThread, source) {
 		if (this.closed || !isRecord(event.params)) return;
 		const params = event.params;
@@ -161,7 +217,7 @@ var CodexCatalogIndexEvents = class {
 		}
 		if (event.method === "turn/started" || event.method === "turn/completed" || event.method === "thread/unarchived" || event.method === "thread/reverted") {
 			if (event.method !== "thread/unarchived" && this.owner.get(id)?.archived) return;
-			this.enqueueRefresh(id, readThread, event.method === "turn/started" ? this.owner.reserveTurnStartOrder() : void 0);
+			this.enqueueRefresh(id, readThread, source, event.method === "turn/started" ? this.owner.reserveTurnStartOrder() : void 0);
 		}
 	}
 	hasCapacity() {
@@ -169,10 +225,12 @@ var CodexCatalogIndexEvents = class {
 		this.owner.report(/* @__PURE__ */ new Error("Codex catalog event queue reached its resident row limit"));
 		return false;
 	}
-	enqueueRefresh(id, readThread, sourceOrder) {
+	enqueueRefresh(id, readThread, source, sourceOrder) {
+		this.owner.requestNativeRefresh();
 		const existing = this.pending.get(id);
 		if (existing) {
 			existing.readThread = readThread;
+			existing.source = source;
 			existing.dirty = true;
 			existing.sourceOrder = sourceOrder ?? existing.sourceOrder;
 			return;
@@ -180,6 +238,7 @@ var CodexCatalogIndexEvents = class {
 		if (!this.hasCapacity()) return;
 		const pending = {
 			readThread,
+			source,
 			dirty: true,
 			sourceOrder,
 			promise: Promise.resolve()
@@ -190,12 +249,17 @@ var CodexCatalogIndexEvents = class {
 				while (!this.closed && pending.dirty) {
 					pending.dirty = false;
 					const observedSourceOrder = pending.sourceOrder;
+					const observedSource = pending.source;
 					try {
+						if (observedSource.closed) throw new Error("Codex catalog observation source closed before its metadata read");
 						const published = await this.owner.refresh(id, pending.readThread, observedSourceOrder);
 						if (published && pending.sourceOrder === observedSourceOrder) pending.sourceOrder = void 0;
 						else if (!published && pending.sourceOrder !== void 0) pending.dirty = true;
 					} catch (error) {
-						this.owner.report(error);
+						if (observedSource.closed) {
+							if (pending.source === observedSource) pending.dirty = false;
+							this.owner.report(new Error("Codex catalog observation interrupted by client closure; metadata refresh deferred to the current catalog owner", { cause: error }));
+						} else this.owner.report(error);
 					}
 				}
 			} finally {
@@ -288,6 +352,9 @@ var CodexCatalogObservations = class {
 		this.mutations = /* @__PURE__ */ new Map();
 		this.observations = /* @__PURE__ */ new Map();
 	}
+	hasActiveWork() {
+		return this.observations.size > 0;
+	}
 	mark(threadId) {
 		this.revision++;
 		if (this.observations.size) {
@@ -331,9 +398,9 @@ function prepareCodexCatalogQuery(params, prepared) {
 		const { complete, frontier } = availability;
 		if (!complete && !frontier) return;
 		if (!complete && frontier && anchor?.backwards && compareCodexCatalogRows(frontier, anchor) < 0) return;
-		const candidates = ordered.filter((row) => {
+		const candidates = complete && !cwd && !search ? ordered : ordered.filter((row) => {
 			const session = row.page.sessions[0];
-			return !row.archived && session && (complete || !frontier || compareCodexCatalogRows(row, frontier) <= 0) && (!cwd || (liveSettings.get(row.threadId)?.cwd ?? session.cwd) === cwd) && (!search || (session.name ?? session.fallbackName)?.toLocaleLowerCase().includes(search));
+			return session && (complete || !frontier || compareCodexCatalogRows(row, frontier) <= 0) && (!cwd || (liveSettings.get(row.threadId)?.cwd ?? session.cwd) === cwd) && (!search || (session.name ?? session.fallbackName)?.toLocaleLowerCase().includes(search));
 		});
 		const selected = anchor?.backwards ? candidates.filter((row) => row.threadId !== anchor.threadId) : candidates;
 		let start = 0;
@@ -376,6 +443,36 @@ function prepareCodexCatalogQuery(params, prepared) {
 }
 //#endregion
 //#region extensions/codex/src/session-catalog-native-page.ts
+/** Background walks share bounded native pages; the index decides when a prefix is current. */
+async function* readCodexCatalogHydrationPages(read, useStateDbOnly) {
+	let cursor;
+	let offset = 0;
+	const cursors = /* @__PURE__ */ new Set();
+	do {
+		const page = await read({
+			archived: false,
+			modelProviders: [],
+			sortKey: "recency_at",
+			sortDirection: "desc",
+			limit: 64,
+			...useStateDbOnly ? { useStateDbOnly } : {},
+			...cursor ? { cursor } : {}
+		}, Math.max(0, CODEX_CATALOG_MAX_ROWS - offset));
+		cursor = readControlCursor(page.nextCursor, "hydration response");
+		if (cursor && cursors.has(cursor)) throw new Error("Codex catalog repeated a hydration cursor");
+		if (cursor) {
+			cursors.add(cursor);
+			if (cursors.size > 2e4) cursors.delete(cursors.values().next().value);
+		}
+		yield {
+			...page,
+			nextCursor: cursor,
+			offset
+		};
+		offset += page.rows.length;
+		await setImmediate$1();
+	} while (cursor);
+}
 /** The resident limit bounds storage, never authoritative discovery. */
 var CodexCatalogNativePages = class {
 	constructor(settings, status) {
@@ -634,7 +731,7 @@ var CodexCatalogIndex = class {
 		this.currency = new CodexCatalogCurrency({
 			local: Boolean(options.localSessionsRoot),
 			reconcileFiles: () => this.reconcile(),
-			reconcileNative: () => this.reconcileNative(),
+			reconcileNative: (full) => this.reconcileNative(full),
 			runBackground: options.runBackground,
 			report: (error) => this.report(error)
 		});
@@ -647,18 +744,24 @@ var CodexCatalogIndex = class {
 			},
 			updateSettings: (id, settings, source) => this.liveSettings.update(id, settings, source),
 			rename: (id, name) => {
+				this.currency.requestNativeRefresh();
 				this.names.update(id, name);
 				const row = this.rows.get(id);
 				if (row && !this.closed) this.put(row);
 			},
 			upsert: (thread) => this.upsertThread(thread),
 			reserveTurnStartOrder: () => this.ordering.reserveEvent(),
+			requestNativeRefresh: () => this.currency.requestNativeRefresh(),
 			refresh: (id, readThread, sourceOrder) => this.refreshThread(id, readThread, sourceOrder),
 			archive: (id) => this.archive(id),
-			remove: (id) => this.remove(id),
+			remove: (id) => {
+				this.currency.requestNativeRefresh();
+				this.remove(id);
+			},
 			report: (error) => this.report(error)
 		});
 		this.unsubscribe = subscribeCodexCatalogEvents(options.homeId, (event, readThread, source) => this.events.handle(event, readThread, source), {
+			onEphemeralThread: (id) => this.remove(id),
 			onClose: (source) => {
 				this.liveStatus.invalidate(source);
 				this.liveSettings.invalidate(source);
@@ -687,7 +790,7 @@ var CodexCatalogIndex = class {
 		}
 	}
 	report(error) {
-		if (!this.closed) embeddedAgentLog.warn("Codex resident catalog background update failed", { error });
+		if (!this.closed && !this.currency.stopForTerminalFailure(error)) embeddedAgentLog.warn("Codex resident catalog background update failed", { error });
 	}
 	withName(row) {
 		const known = this.names.get(row.threadId);
@@ -729,8 +832,8 @@ var CodexCatalogIndex = class {
 	}
 	async initialize() {
 		this.assertCurrent();
-		clearImmediate(this.background);
-		this.background = void 0;
+		this.currency.assertRunnable();
+		this.currency.cancelHydration();
 		if (this.initialized && !this.needsNativeRefresh) return;
 		if (!this.initializing) {
 			this.availability.begin();
@@ -743,7 +846,7 @@ var CodexCatalogIndex = class {
 				if (!this.initialized) {
 					let observedRevision;
 					do
-						observedRevision = await this.observations.observe((isCurrent) => this.hydrate(isCurrent, this.availability.complete));
+						observedRevision = await this.hydrate(this.availability.complete);
 					while (observedRevision !== this.sourceRevision);
 					this.needsNativeRefresh = false;
 				}
@@ -758,6 +861,7 @@ var CodexCatalogIndex = class {
 			})().catch((error) => {
 				this.failure = { error };
 				this.availability.fail(error);
+				this.currency.stopForTerminalFailure(error);
 				throw error;
 			}).finally(() => {
 				this.initializing = void 0;
@@ -800,13 +904,8 @@ var CodexCatalogIndex = class {
 		await this.restoring;
 	}
 	scheduleHydration() {
-		if (this.initialized && !this.needsNativeRefresh || this.initializing || this.background || this.closed) return;
-		this.background = setImmediate(() => {
-			this.background = void 0;
-			const run = () => this.initialize();
-			(this.options.runBackground ? this.options.runBackground(run) : run()).catch((error) => this.report(error));
-		});
-		this.background.unref();
+		if (this.initialized && !this.needsNativeRefresh || this.initializing || this.closed) return;
+		this.currency.scheduleHydration(() => this.initialize());
 	}
 	captureFields() {
 		return {
@@ -823,79 +922,71 @@ var CodexCatalogIndex = class {
 			if (current && current.page.sessions[0]?.name !== session.name) this.put(current);
 		}
 	}
-	reconcileNative() {
+	reconcileNative(full = true) {
 		if (!this.options.localSessionsRoot && this.initializing && !this.initialized) return this.initializing;
-		if (!this.reconcilingNative) {
-			const refresh = this.observations.observe(async (isCurrent) => {
-				await this.hydrate(isCurrent, true);
-			});
-			this.reconcilingNative = refresh.finally(() => {
-				this.reconcilingNative = void 0;
-			});
-		}
+		if (!this.reconcilingNative) this.reconcilingNative = this.hydrate(true, !full).then(() => void 0).finally(() => {
+			this.reconcilingNative = void 0;
+		});
 		return this.reconcilingNative;
 	}
-	async hydrate(isCurrent, useStateDbOnly = false) {
+	hydrate(useStateDbOnly = false, incremental = false) {
+		const run = () => this.observations.observe((isCurrent) => this.hydratePages(isCurrent, useStateDbOnly, incremental));
+		return this.options.runNativeWalk?.(run) ?? run();
+	}
+	async hydratePages(isCurrent, useStateDbOnly, incremental) {
 		this.assertCurrent();
 		const files = this.options.localSessionsRoot && !useStateDbOnly ? (await scanCodexCatalogRollouts(this.options.localSessionsRoot, /* @__PURE__ */ new Set())).files : /* @__PURE__ */ new Map();
-		let cursor;
-		let observedRevision = this.sourceRevision;
-		let firstPage = true;
-		let sourceOrder = 0;
+		let observedRevision;
 		let frontier;
 		const batchOrder = this.ordering.captureBatch(this.availability.complete);
-		const remaining = new Map(this.rows);
-		const cursors = /* @__PURE__ */ new Set();
-		do {
+		const remaining = incremental ? void 0 : new Map(this.rows);
+		const pages = readCodexCatalogHydrationPages(async (params, remainingRows) => {
 			this.assertCurrent();
 			const fieldRevision = this.captureFields();
-			const page = await this.options.readNative({
-				archived: false,
-				modelProviders: [],
-				sortKey: "recency_at",
-				sortDirection: "desc",
-				limit: 64,
-				...useStateDbOnly ? { useStateDbOnly } : {},
-				...cursor ? { cursor } : {}
-			}, Math.max(0, CODEX_CATALOG_MAX_ROWS - sourceOrder));
+			return {
+				...await this.options.readNative(params, remainingRows),
+				fieldRevision,
+				sourceRevision: this.sourceRevision
+			};
+		}, useStateDbOnly);
+		for await (const page of pages) {
 			this.assertCurrent();
-			if (firstPage) {
-				observedRevision = this.sourceRevision;
-				firstPage = false;
+			observedRevision ??= page.sourceRevision;
+			let sourceOrder = page.offset;
+			let changed = false;
+			for (const id of page.excludedThreadIds ?? []) if (isCurrent(id)) {
+				changed ||= this.rows.has(id);
+				this.remove(id);
 			}
-			for (const id of page.excludedThreadIds ?? []) if (isCurrent(id)) this.remove(id);
 			for (const row of page.rows) {
 				const position = sourceOrder++;
 				if (position >= 2e4) continue;
-				remaining.delete(row.threadId);
-				this.observeFields(row, fieldRevision);
-				if (!isCurrent(row.threadId)) continue;
-				const logicalPath = row.rolloutPath && codexCatalogRolloutLogicalPath(row.rolloutPath);
+				remaining?.delete(row.threadId);
 				const previous = this.rows.get(row.threadId);
-				const fingerprint = logicalPath ? files.get(logicalPath) ?? files.get(`${logicalPath}.zst`) ?? (useStateDbOnly && previous?.rolloutPath && codexCatalogRolloutLogicalPath(previous.rolloutPath) === logicalPath ? previous.fingerprint : void 0) : void 0;
+				this.observeFields(row, page.fieldRevision);
+				if (!isCurrent(row.threadId)) {
+					changed = true;
+					continue;
+				}
+				const fingerprint = resolveCodexCatalogRolloutFingerprint(row.rolloutPath, useStateDbOnly ? previous : void 0, files);
 				this.observations.mark(row.threadId);
 				this.put({
 					...row,
 					sourceOrder: batchOrder(row, previous, position),
 					...fingerprint ? { fingerprint } : {}
 				});
+				changed ||= this.rows.get(row.threadId) !== previous;
 				frontier = this.rows.get(row.threadId) ?? frontier;
 			}
-			cursor = readControlCursor(page.nextCursor, "hydration response");
-			if (cursor && cursors.has(cursor)) throw new Error("Codex catalog repeated a hydration cursor");
-			if (cursor) {
-				cursors.add(cursor);
-				if (cursors.size > 2e4) cursors.delete(cursors.values().next().value);
-				this.availability.publish(frontier);
-			}
-			await setImmediate$1();
-		} while (cursor);
-		if (!useStateDbOnly || !this.options.localSessionsRoot) {
+			if (incremental && (!changed && page.rows.length > 0 || sourceOrder >= 2e4)) break;
+			if (page.nextCursor) this.availability.publish(frontier);
+		}
+		if (remaining && (!useStateDbOnly || !this.options.localSessionsRoot)) {
 			for (const [id, row] of remaining) if (isCurrent(id) && this.rows.get(id) === row) this.remove(id);
 		}
 		this.availability.publish(frontier, true);
 		await this.persistence.finishHydration(this.overflow);
-		return observedRevision;
+		return observedRevision ?? this.sourceRevision;
 	}
 	reconcile() {
 		if (!this.reconciling) this.reconciling = this.observations.observe((isCurrent) => this.reconcileFiles(isCurrent)).finally(() => {
@@ -907,7 +998,7 @@ var CodexCatalogIndex = class {
 		const root = this.options.localSessionsRoot;
 		if (!root || !this.initialized || this.closed) return;
 		this.assertCurrent();
-		const byPath = new Map([...this.rows.values()].flatMap((row) => row.rolloutPath ? [[codexCatalogRolloutLogicalPath(row.rolloutPath), row]] : []));
+		const byPath = indexCodexCatalogRowsByRollout(this.rows.values());
 		const { files, present } = await scanCodexCatalogRollouts(root, new Set(byPath.keys()));
 		this.assertCurrent();
 		const observed = new Map(files);
@@ -915,6 +1006,7 @@ var CodexCatalogIndex = class {
 			const previous = byPath.get(codexCatalogRolloutLogicalPath(file));
 			const known = this.observedFiles.get(file) ?? previous?.fingerprint;
 			if (known?.mtimeMs === fingerprint.mtimeMs && known.size === fingerprint.size) continue;
+			this.currency.requestNativeRefresh();
 			observed.delete(file);
 			if (known) observed.set(file, known);
 			let thread;
@@ -951,7 +1043,10 @@ var CodexCatalogIndex = class {
 			this.put(mergeCodexCatalogRolloutRow(row, existing, fingerprint));
 			await setImmediate$1();
 		}
-		for (const row of byPath.values()) if (row.rolloutPath && isCodexCatalogRolloutPathCovered(root, row.rolloutPath) && !present.has(codexCatalogRolloutLogicalPath(row.rolloutPath)) && this.rows.get(row.threadId) === row) this.remove(row.threadId);
+		for (const row of byPath.values()) if (row.rolloutPath && isCodexCatalogRolloutPathCovered(root, row.rolloutPath) && !present.has(codexCatalogRolloutLogicalPath(row.rolloutPath)) && this.rows.get(row.threadId) === row) {
+			this.currency.requestNativeRefresh();
+			this.remove(row.threadId);
+		}
 		this.observedFiles = observed;
 	}
 	upsertThread(thread) {
@@ -962,6 +1057,7 @@ var CodexCatalogIndex = class {
 			return Promise.resolve();
 		}
 		try {
+			this.currency.requestNativeRefresh();
 			return this.upsertPreparedThread(projectCodexCatalogNativeThread(thread, sanitizeTerminalText));
 		} catch (error) {
 			return Promise.reject(toErrorObject(error, "Codex catalog projection failed"));
@@ -996,7 +1092,7 @@ var CodexCatalogIndex = class {
 		if (projected.excludedThreadIds?.includes(thread.id)) this.remove(thread.id);
 		if (row) {
 			const previous = this.rows.get(thread.id);
-			const fingerprint = previous?.rolloutPath && row.rolloutPath && codexCatalogRolloutLogicalPath(previous.rolloutPath) === codexCatalogRolloutLogicalPath(row.rolloutPath) ? previous.fingerprint : void 0;
+			const fingerprint = resolveCodexCatalogRolloutFingerprint(row.rolloutPath, previous);
 			this.observations.mark(thread.id);
 			this.put({
 				...row,
@@ -1008,6 +1104,7 @@ var CodexCatalogIndex = class {
 	}
 	archive(threadId) {
 		if (this.closed) return;
+		this.currency.requestNativeRefresh();
 		this.observations.mark(threadId);
 		this.liveStatus.delete(threadId);
 		this.liveSettings.delete(threadId);
@@ -1022,6 +1119,9 @@ var CodexCatalogIndex = class {
 	get(threadId) {
 		return this.rows.get(threadId);
 	}
+	hasActiveWork() {
+		return Boolean(this.initializing || !this.restored && this.restoring || this.reconciling || this.reconcilingNative || this.currency.hasActiveWork() || this.observations.hasActiveWork() || this.events.hasActiveWork() || this.persistence.hasActiveWork());
+	}
 	async list(params, deadline = performance.now() + (this.options.requestTimeoutMs ?? 6e4)) {
 		return await withCodexCatalogListRequest(async (request) => {
 			const expiresAt = request.constrainDeadline(deadline);
@@ -1048,7 +1148,6 @@ var CodexCatalogIndex = class {
 		this.liveSettings.invalidate();
 		this.unsubscribe();
 		this.currency.close();
-		clearImmediate(this.background);
 		return this.persistence.retire();
 	}
 	async close() {
@@ -1058,6 +1157,7 @@ var CodexCatalogIndex = class {
 			this.restoring,
 			this.reconciling,
 			this.reconcilingNative,
+			this.currency.close(),
 			writes,
 			this.events.close()
 		]);

package/dist/.setup/{session-catalog-index-order-Cc5BzlQr.mjs → session-catalog-index-order-hcdz07yN.mjs}

@@ -1,4 +1,4 @@
-import { V as CODEX_CATALOG_MAX_ROWS } from "./session-catalog-native-projection-ChV3cCtm.mjs";
+import { U as CODEX_CATALOG_MAX_ROWS } from "./session-catalog-native-projection-DowriLid.mjs";
 //#region extensions/codex/src/session-catalog-index-order.ts
 function codexCatalogRowRecency(row) {
 	return row.recencyAt ?? row.updatedAt ?? 0;
@@ -21,7 +21,7 @@ var CodexCatalogOrdering = class {
 		this.nextEventOrder = -1;
 	}
 	read(rows) {
-		return this.ordered ??= [...rows.values()].toSorted(compareCodexCatalogRows);
+		return this.ordered ??= [...rows.values()].filter((row) => !row.archived && row.page.sessions.length > 0).toSorted(compareCodexCatalogRows);
 	}
 	invalidate() {
 		this.ordered = void 0;

package/dist/.setup/{session-catalog-index-state-BAuDztHN.mjs → session-catalog-index-state-Dgh8ORJm.mjs}

@@ -1,5 +1,5 @@
-import { H as detachCodexCatalogString, O as parseCatalogPage } from "./session-catalog-native-projection-ChV3cCtm.mjs";
-import { i as retainCodexCatalogRow } from "./session-catalog-index-order-Cc5BzlQr.mjs";
+import { A as parseCatalogPage, W as detachCodexCatalogString } from "./session-catalog-native-projection-DowriLid.mjs";
+import { i as retainCodexCatalogRow } from "./session-catalog-index-order-hcdz07yN.mjs";
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { createHash } from "node:crypto";
 import { setImmediate } from "node:timers/promises";
@@ -109,6 +109,9 @@ var CodexCatalogPersistence = class {
 		this.failed = false;
 		this.retired = false;
 	}
+	hasActiveWork() {
+		return this.writing !== void 0 || this.pending.size > 0;
+	}
 	async readSnapshot() {
 		await this.drain();
 		return await readCodexCatalogSnapshot(this.state);

package/dist/.setup/{session-catalog-native-projection-ChV3cCtm.mjs → session-catalog-native-projection-DowriLid.mjs}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.mjs";
-import { n as defineCodexBuildState } from "./build-state-Xx9ybZqa.mjs";
-import { m as isJsonObject } from "./config-security-BRQ2mgW9.mjs";
+import { n as defineCodexBuildState } from "./build-state-C7EnDVgr.mjs";
+import { i as isJsonObject } from "./protocol-CANUwXJ3.mjs";
 import { asFiniteNumber, isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 //#region extensions/codex/src/app-server/protocol-session-source.ts
@@ -254,9 +254,12 @@ function parseCatalogSession(value, options = {}) {
 function parseCatalogPage(value, options = {}) {
 	if (!isRecord(value) || !Array.isArray(value.sessions) || value.sessions.length > 100) throw new Error("Codex session catalog returned an invalid page");
 	const nextCursor = parseOptionalCatalogString(value.nextCursor, "next cursor", MAX_CURSOR_LENGTH);
+	const sourceHomeId = parseOptionalCatalogString(value.sourceHomeId, "source home id", 256);
 	const backwardsCursor = parseOptionalCatalogString(value.backwardsCursor, "backwards cursor", MAX_CURSOR_LENGTH);
 	return {
 		sessions: value.sessions.map((session) => parseCatalogSession(session, options)),
+		...sourceHomeId ? { sourceHomeId } : {},
+		...typeof value.canContinueCodex === "boolean" ? { canContinueCodex: value.canContinueCodex } : {},
 		...nextCursor ? { nextCursor } : {},
 		...backwardsCursor ? { backwardsCursor } : {}
 	};
@@ -320,6 +323,7 @@ const getSources = defineCodexBuildState("openclaw.codexCatalogSources", () => (
 	clients: /* @__PURE__ */ new WeakMap(),
 	values: /* @__PURE__ */ new WeakMap()
 }));
+const getEphemeralObservers = defineCodexBuildState("openclaw.codexCatalogEphemeralObservers", () => /* @__PURE__ */ new WeakMap());
 /** A passive lifetime fact; the token never retains its client or a lease. */
 function codexCatalogSourceForClient(client) {
 	const { clients } = getSources();
@@ -333,8 +337,14 @@ function codexCatalogSourceForClient(client) {
 function closeCodexCatalogClientSource(client) {
 	const { clients } = getSources();
 	const source = clients.get(client);
-	if (source) source.closed = true;
-	else clients.set(client, { closed: true });
+	if (source) {
+		source.closed = true;
+		getEphemeralObservers().delete(source);
+	} else clients.set(client, { closed: true });
+}
+/** The catalog observer is bound once per physical source and released on closure. */
+function observeCodexCatalogEphemeralThreads(source, observer) {
+	getEphemeralObservers().set(source, observer);
 }
 function getCodexCatalogSource(value) {
 	return value !== null && typeof value === "object" ? getSources().values.get(value) : void 0;
@@ -356,6 +366,7 @@ function recordCodexCatalogResponseSource(method, result, source) {
 	} else if ((method === "thread/read" || method === "thread/start" || method === "thread/fork" || method === "thread/resume") && "thread" in result && result.thread !== null && typeof result.thread === "object") {
 		setCodexCatalogSource(result, source);
 		setCodexCatalogSource(result.thread, source);
+		if ("ephemeral" in result.thread && result.thread.ephemeral === true && "id" in result.thread && typeof result.thread.id === "string") getEphemeralObservers().get(source)?.(result.thread.id);
 	}
 }
 //#endregion
@@ -363,7 +374,8 @@ function recordCodexCatalogResponseSource(method, result, source) {
 var session_catalog_native_projection_exports = /* @__PURE__ */ __exportAll({
 	CODEX_CATALOG_NATIVE_PAGE_LIMIT: () => 64,
 	projectCodexCatalogNativeResponse: () => projectCodexCatalogNativeResponse,
-	projectCodexCatalogNativeThread: () => projectCodexCatalogNativeThread
+	projectCodexCatalogNativeThread: () => projectCodexCatalogNativeThread,
+	reuseCodexCatalogPreview: () => reuseCodexCatalogPreview
 });
 const CODEX_CATALOG_NATIVE_PAGE_LIMIT = 64;
 const STRING_FIELDS = [
@@ -421,14 +433,9 @@ function projectCodexCatalogNativeThread(thread, sanitize, cachedPreview) {
 		const value = thread[field];
 		if (value === null || typeof value === "number" && Number.isFinite(value)) row[field] = value;
 	}
-	const preview = cachedPreview?.({
-		id,
-		path: typeof row.path === "string" ? row.path : null,
-		updatedAt: typeof row.updatedAt === "number" ? row.updatedAt : null,
-		recencyAt: typeof row.recencyAt === "number" ? row.recencyAt : null
-	});
 	const rawPreview = thread.preview;
-	if (preview !== void 0 && preview.length <= 500 && !(typeof rawPreview === "string" && Boolean(rawPreview) !== Boolean(preview))) row.preview = preview;
+	const preview = reuseCodexCatalogPreview(row, typeof rawPreview === "string" ? Boolean(rawPreview) : void 0, cachedPreview);
+	if (preview !== void 0) row.preview = preview;
 	else if (typeof rawPreview === "string") row.preview = rawPreview ? truncateCodexCatalogPreview(selectCodexCatalogPreviewInput(rawPreview), sanitize) : "";
 	else if (rawPreview === null) row.preview = null;
 	const source = typeof thread.source === "string" ? detachCodexCatalogString(thread.source.slice(0, 500)) : void 0;
@@ -468,5 +475,15 @@ function projectCodexCatalogNativeResponse(response, sanitize, cachedPreview, re
 	}
 	return page;
 }
+/** Reuse resident text without transferring a cache or an unbounded native preview. */
+function reuseCodexCatalogPreview(thread, rawPreviewNonempty, cachedPreview) {
+	const preview = cachedPreview?.({
+		id: thread.id,
+		path: typeof thread.path === "string" ? thread.path : null,
+		updatedAt: typeof thread.updatedAt === "number" ? thread.updatedAt : null,
+		recencyAt: typeof thread.recencyAt === "number" ? thread.recencyAt : null
+	});
+	return preview !== void 0 && preview.length <= 500 && (rawPreviewNonempty === void 0 || rawPreviewNonempty === Boolean(preview)) ? preview : void 0;
+}
 //#endregion
-export { parseTranscriptPage as A, unwrapNodeInvokePayload as B, codexCatalogThreadName as C, normalizeLimit as D, isInteractiveThreadSource as E, requireBoundThread as F, detachCodexCatalogString as H, requireOnlyKeys as I, selectCodexCatalogPreviewInput as L, readControlCursor as M, readGatewayParams as N, parseCatalogPage as O, readPageParams as P, toCatalogSession as R, catalogError as S, filterCatalogPageByTitle as T, session_catalog_limits_exports as U, CODEX_CATALOG_MAX_ROWS as V, CODEX_INTERACTIVE_THREAD_SOURCE_KINDS as W, MAX_CURSOR_LENGTH as _, closeCodexCatalogClientSource as a, NODE_INVOKE_TIMEOUT_MS as b, getCodexCatalogSource as c, CODEX_APP_SERVER_THREADS_CAPABILITY as d, CODEX_APP_SERVER_THREADS_LIST_COMMAND as f, CatalogParamsError as g, CODEX_LOCAL_SESSION_HOST_ID as h, session_catalog_native_projection_exports as i, readBoundedOptionalString as j, parseJsonParams as k, recordCodexCatalogResponseSource as l, CODEX_CATALOG_TRANSCRIPT_READ_COMMAND as m, projectCodexCatalogNativeResponse as n, codexCatalogSourceForClient as o, CODEX_APP_SERVER_THREAD_TURNS_LIST_COMMAND as p, projectCodexCatalogNativeThread as r, copyCodexCatalogSource as s, CODEX_CATALOG_NATIVE_PAGE_LIMIT as t, setCodexCatalogSource as u, MAX_CWD_LENGTH as v, codexCatalogThreadStatus as w, boundedCatalogString as x, MAX_TRANSCRIPT_PAGE_BYTES as y, truncateCodexCatalogPreview as z };
+export { parseCatalogPage as A, toCatalogSession as B, boundedCatalogString as C, filterCatalogPageByTitle as D, codexCatalogThreadStatus as E, readGatewayParams as F, session_catalog_limits_exports as G, unwrapNodeInvokePayload as H, readPageParams as I, CODEX_INTERACTIVE_THREAD_SOURCE_KINDS as K, requireBoundThread as L, parseTranscriptPage as M, readBoundedOptionalString as N, isInteractiveThreadSource as O, readControlCursor as P, requireOnlyKeys as R, NODE_INVOKE_TIMEOUT_MS as S, codexCatalogThreadName as T, CODEX_CATALOG_MAX_ROWS as U, truncateCodexCatalogPreview as V, detachCodexCatalogString as W, CODEX_LOCAL_SESSION_HOST_ID as _, session_catalog_native_projection_exports as a, MAX_CWD_LENGTH as b, copyCodexCatalogSource as c, recordCodexCatalogResponseSource as d, setCodexCatalogSource as f, CODEX_CATALOG_TRANSCRIPT_READ_COMMAND as g, CODEX_APP_SERVER_THREAD_TURNS_LIST_COMMAND as h, reuseCodexCatalogPreview as i, parseJsonParams as j, normalizeLimit as k, getCodexCatalogSource as l, CODEX_APP_SERVER_THREADS_LIST_COMMAND as m, projectCodexCatalogNativeResponse as n, closeCodexCatalogClientSource as o, CODEX_APP_SERVER_THREADS_CAPABILITY as p, projectCodexCatalogNativeThread as r, codexCatalogSourceForClient as s, CODEX_CATALOG_NATIVE_PAGE_LIMIT as t, observeCodexCatalogEphemeralThreads as u, CatalogParamsError as v, catalogError as w, MAX_TRANSCRIPT_PAGE_BYTES as x, MAX_CURSOR_LENGTH as y, selectCodexCatalogPreviewInput as z };