@vanillagreen/pi-qol 2.2.1 → 2.3.2

package/extensions/qol/session-search/cache.ts

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync, realpathSync } from "node:fs";
+import { realpathSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
 import { SessionManager, type ExtensionContext } from "@earendil-works/pi-coding-agent";
@@ -8,8 +8,12 @@ import {
 	DEFAULT_SESSION_SEARCH_SHORTCUT,
 	SESSION_SEARCH_PENDING_SYMBOL,
 	SESSION_SEARCH_STATUS_KEY,
+	SESSION_SEARCH_TEXT_MAX_CHARS,
+	SESSION_SEARCH_TEXT_MAX_CHARS_PER_SESSION,
+	SESSION_SEARCH_USER_MESSAGES_MAX_SESSIONS,
 } from "../constants.js";
-import { expandHome, piSettingsPaths, settingBoolean, settingNumber, settingString, settingStringAllowEmpty } from "../settings.js";
+import { expandHome, piSettingsPaths, readSettingsFiles } from "../package-config.js";
+import { settingBoolean, settingNumber, settingString, settingStringAllowEmpty } from "../settings.js";
 import { forEachSessionJsonlLine } from "./jsonl.js";
 import type {
 	QolSessionPaletteAction,
@@ -23,12 +27,33 @@ import type {
 let qolSessionSearchCache: QolSessionSearchSession[] = [];
 let qolSessionSearchLoadedAt = 0;
 let qolSessionSearchLoading: Promise<QolSessionSearchSession[]> | undefined;
+let qolSessionSearchReleaseTimer: ReturnType<typeof setTimeout> | undefined;
+/** Parsed user prompts per session path, oldest insertion first; at most
+ *  SESSION_SEARCH_USER_MESSAGES_MAX_SESSIONS entries. */
 const qolSessionUserMessagesCache = new Map<string, QolSessionUserMessage[]>();
-export const qolSessionSearchPendingActions = new Map<string, QolSessionPaletteAction>();
+/** The resume or fork action the editor's `/search:resume-pending <id>` line
+ *  names. Queuing another replaces it, since the editor holds one line. */
+let qolSessionSearchPendingAction: { id: string; action: QolSessionPaletteAction } | undefined;
 let qolSessionSearchPendingActionCounter = 0;
 
-export function nextSessionSearchPendingActionId(): string {
-	return `ss-${Date.now().toString(36)}-${(++qolSessionSearchPendingActionCounter).toString(36)}`;
+/** Hold `action` as the one pending action and return the id that claims it. */
+export function queueSessionSearchPendingAction(action: QolSessionPaletteAction): string {
+	const id = `ss-${Date.now().toString(36)}-${(++qolSessionSearchPendingActionCounter).toString(36)}`;
+	qolSessionSearchPendingAction = { id, action };
+	return id;
+}
+
+/** Remove and return the pending action when `id` names it. */
+export function takeSessionSearchPendingAction(id: string): QolSessionPaletteAction | undefined {
+	if (qolSessionSearchPendingAction?.id !== id) return undefined;
+	const { action } = qolSessionSearchPendingAction;
+	qolSessionSearchPendingAction = undefined;
+	return action;
+}
+
+/** Drop the pending action. Runs on session shutdown. */
+export function clearSessionSearchPendingAction(): void {
+	qolSessionSearchPendingAction = undefined;
 }
 
 export function getPendingSessionSearchMessage(): QolSessionSearchPendingMessage | undefined {
@@ -82,16 +107,10 @@ function configuredSessionDir(cwd: string): string | undefined {
 	const envDir = process.env.PI_CODING_AGENT_SESSION_DIR?.trim();
 	if (envDir) return resolveSettingsRelativePath(envDir, join(resolve(cwd), ".pi", "settings.json"));
 	let configured: string | undefined;
-	for (const settingsPath of piSettingsPaths(cwd)) {
-		if (!existsSync(settingsPath)) continue;
-		try {
-			const parsed = JSON.parse(readFileSync(settingsPath, "utf8"));
-			if (typeof parsed?.sessionDir === "string" && parsed.sessionDir.trim()) {
-				configured = resolveSettingsRelativePath(parsed.sessionDir, settingsPath);
-			}
-		} catch {
-			// Ignore malformed optional settings.
-		}
+	for (const file of readSettingsFiles(piSettingsPaths(cwd))) {
+		if (file.kind !== "parsed") continue;
+		const sessionDir = file.settings.sessionDir;
+		if (typeof sessionDir === "string" && sessionDir.trim()) configured = resolveSettingsRelativePath(sessionDir, file.path);
 	}
 	return configured;
 }
@@ -113,16 +132,40 @@ export function defaultSessionSearchScope(cwd?: string): QolSessionSearchScope {
 	return settingString("sessionSearch.defaultScope", "current", cwd).toLowerCase() === "all" ? "all" : "current";
 }
 
+/** Cap the message text the index keeps: each session's text at the per-session
+ *  limit, and the sum at the index limit, filled newest session first. */
+export function capSessionSearchText(sessions: QolSessionSearchSession[]): QolSessionSearchSession[] {
+	let budget = SESSION_SEARCH_TEXT_MAX_CHARS;
+	const newestFirst = [...sessions].sort((a, b) => b.modified.getTime() - a.modified.getTime());
+	for (const session of newestFirst) {
+		const kept = session.allMessagesText.slice(0, Math.min(SESSION_SEARCH_TEXT_MAX_CHARS_PER_SESSION, budget));
+		budget -= kept.length;
+		session.allMessagesText = kept;
+	}
+	return sessions;
+}
+
 async function loadQolSessionSearchSessions(ctx: ExtensionContext, onProgress?: (loaded: number, total: number) => void): Promise<QolSessionSearchSession[]> {
 	const customSessionDir = configuredSessionDir(ctx.cwd);
 	const infos = customSessionDir
 		? await SessionManager.list(ctx.cwd, customSessionDir, onProgress)
 		: await SessionManager.listAll(onProgress);
-	return infos.map(sessionInfoToSearchSession).filter((session): session is QolSessionSearchSession => session !== undefined);
+	return capSessionSearchText(infos.map(sessionInfoToSearchSession).filter((session): session is QolSessionSearchSession => session !== undefined));
+}
+
+/** Drop the loaded index and the parsed prompts. Runs when the index outlives
+ *  its TTL and on session shutdown; the next search loads the index again. */
+export function releaseQolSessionSearchCache(): void {
+	if (qolSessionSearchReleaseTimer) clearTimeout(qolSessionSearchReleaseTimer);
+	qolSessionSearchReleaseTimer = undefined;
+	qolSessionSearchCache = [];
+	qolSessionSearchLoadedAt = 0;
+	qolSessionUserMessagesCache.clear();
 }
 
 export async function refreshQolSessionSearchCache(ctx: ExtensionContext, options?: { force?: boolean; quiet?: boolean }): Promise<QolSessionSearchSession[]> {
 	const ttlMs = Math.max(0, settingNumber("sessionSearch.cacheTtlSeconds", DEFAULT_SESSION_SEARCH_CACHE_TTL_SECONDS, ctx.cwd) * 1000);
+	// A TTL of 0 keeps the index until session shutdown.
 	const fresh = qolSessionSearchCache.length > 0 && (ttlMs === 0 || Date.now() - qolSessionSearchLoadedAt < ttlMs);
 	if (!options?.force && fresh) return qolSessionSearchCache;
 	if (qolSessionSearchLoading) return qolSessionSearchLoading;
@@ -131,9 +174,13 @@ export async function refreshQolSessionSearchCache(ctx: ExtensionContext, option
 	qolSessionSearchLoading = loadQolSessionSearchSessions(ctx, (loaded, total) => {
 		if (!options?.quiet && ctx.hasUI) ctx.ui.setStatus(SESSION_SEARCH_STATUS_KEY, `Loading sessions ${loaded}/${total}`);
 	}).then((sessions) => {
+		releaseQolSessionSearchCache();
 		qolSessionSearchCache = sessions;
 		qolSessionSearchLoadedAt = Date.now();
-		qolSessionUserMessagesCache.clear();
+		if (ttlMs > 0) {
+			qolSessionSearchReleaseTimer = setTimeout(releaseQolSessionSearchCache, ttlMs);
+			qolSessionSearchReleaseTimer.unref?.();
+		}
 		return sessions;
 	}).finally(() => {
 		qolSessionSearchLoading = undefined;
@@ -187,6 +234,10 @@ export function sessionUserMessages(sessionPath: string): QolSessionUserMessage[
 		// Ignore unreadable sessions; callers fall back to SessionInfo.firstMessage.
 	}
 	qolSessionUserMessagesCache.set(sessionPath, messages);
+	for (const oldest of qolSessionUserMessagesCache.keys()) {
+		if (qolSessionUserMessagesCache.size <= SESSION_SEARCH_USER_MESSAGES_MAX_SESSIONS) break;
+		qolSessionUserMessagesCache.delete(oldest);
+	}
 	return messages;
 }
 

package/extensions/qol/session-search/component.ts

@@ -29,6 +29,7 @@ import type {
 	QolSessionMessagesState,
 	QolSessionPaletteAction,
 	QolSessionSearchHit,
+	QolSessionSearchLoad,
 	QolSessionSearchResult,
 	QolSessionSearchScope,
 	QolSessionSearchSession,
@@ -108,7 +109,8 @@ export class QolSessionSearchComponent {
 	private readonly done: (action: QolSessionPaletteAction) => void;
 	private readonly tui: { requestRender(): void; terminal?: { rows?: number } };
 	private readonly theme: Theme;
-	private readonly sessions: QolSessionSearchSession[];
+	/** The index, while it loads, once loaded, or the load's failure. */
+	private sessions: QolSessionSearchLoad;
 	private readonly cwd: string;
 	private readonly currentModel: QolModelInfo | undefined;
 	private screen: "search" | "messages" | "actions" | "confirmContext" | "confirmFork" | "confirmModel" = "search";
@@ -125,7 +127,7 @@ export class QolSessionSearchComponent {
 		done: (action: QolSessionPaletteAction) => void,
 		tui: { requestRender(): void; terminal?: { rows?: number } },
 		theme: Theme,
-		sessions: QolSessionSearchSession[],
+		sessions: QolSessionSearchLoad,
 		cwd: string,
 		initialQuery = "",
 		currentModel: QolModelInfo | undefined = undefined,
@@ -151,6 +153,13 @@ export class QolSessionSearchComponent {
 
 	invalidate(): void {}
 
+	/** Show the index once its load settles; the overlay opens before that. */
+	setSessions(sessions: QolSessionSearchLoad): void {
+		this.sessions = sessions;
+		this.updateResults(false);
+		this.tui.requestRender();
+	}
+
 	private maxOverlayRows(): number {
 		const terminalRows = Number(this.tui.terminal?.rows ?? process.stdout.rows ?? 30);
 		const safeRows = Number.isFinite(terminalRows) && terminalRows > 0 ? terminalRows : 30;
@@ -213,8 +222,9 @@ export class QolSessionSearchComponent {
 	}
 
 	private sessionsForScope(scope = this.searchState.scope): QolSessionSearchSession[] {
-		if (scope === "all") return this.sessions;
-		return this.sessions.filter((session) => sameSessionSearchProject(session.cwd, this.cwd));
+		if (this.sessions.status !== "ready") return [];
+		if (scope === "all") return this.sessions.sessions;
+		return this.sessions.sessions.filter((session) => sameSessionSearchProject(session.cwd, this.cwd));
 	}
 
 	private updateResults(resetSelection = true): void {
@@ -614,7 +624,11 @@ export class QolSessionSearchComponent {
 		if (!compact) lines.push(row(dim(`tokens · re:<pattern> regex · "phrase" exact`)));
 		lines.push(divider());
 
-		if (state.results.length === 0) {
+		if (this.sessions.status === "loading") {
+			lines.push(row(muted("Loading sessions…")));
+		} else if (this.sessions.status === "failed") {
+			lines.push(row(muted(`Could not load sessions: ${this.sessions.error.split("\n")[0]}`)));
+		} else if (state.results.length === 0) {
 			lines.push(row(muted(state.query.trim() ? "No prompts match your search" : "No prompts found")));
 		} else {
 			lines.push(...this.renderSearchHitPane(inner, row, dim, muted, accent));

package/extensions/qol/session-search/index.ts

@@ -5,9 +5,8 @@ import { settingNumber } from "../settings.js";
 import { stringifyError } from "../util.js";
 import {
 	getPendingSessionSearchMessage,
-	nextSessionSearchPendingActionId,
 	pinSessionModel,
-	qolSessionSearchPendingActions,
+	queueSessionSearchPendingAction,
 	refreshQolSessionSearchCache,
 	sessionDisplayName,
 	setPendingSessionSearchMessage,
@@ -17,12 +16,14 @@ import {
 	buildSessionSearchContextMessageWithLoader,
 	injectSessionSearchContext,
 } from "./context.js";
-import type { QolSessionPaletteAction, QolSessionSearchResult } from "./types.js";
+import type { QolSessionPaletteAction, QolSessionSearchLoad, QolSessionSearchResult } from "./types.js";
 
 export {
-	qolSessionSearchPendingActions,
+	clearSessionSearchPendingAction,
 	refreshQolSessionSearchCache,
+	releaseQolSessionSearchCache,
 	sessionSearchShortcut,
+	takeSessionSearchPendingAction,
 } from "./cache.js";
 export { renderSessionSearchContextMessage } from "./context.js";
 
@@ -31,8 +32,7 @@ function asCommandContext(ctx: ExtensionContext): (ExtensionContext & Partial<Ex
 }
 
 function queueSessionSearchCommandAction(ctx: ExtensionContext, action: QolSessionPaletteAction): void {
-	const id = nextSessionSearchPendingActionId();
-	qolSessionSearchPendingActions.set(id, action);
+	const id = queueSessionSearchPendingAction(action);
 	ctx.ui.setEditorText(`/search:resume-pending ${id}`);
 	ctx.ui.notify(`${sessionDisplayName(action.result!)} — press enter to ${action.type === "fork" ? "fork" : "resume"}`, "info");
 }
@@ -121,13 +121,21 @@ export async function openQolSessionSearch(pi: ExtensionAPI, ctx: ExtensionConte
 		ctx.ui.notify("Session search requires interactive UI", "warning");
 		return;
 	}
-	const sessions = await refreshQolSessionSearchCache(ctx);
+	// The overlay opens at once and fills in when the index is loaded: a
+	// released index takes a full read of every session file to load again.
+	const loading: Promise<QolSessionSearchLoad> = refreshQolSessionSearchCache(ctx).then(
+		(sessions) => ({ status: "ready", sessions }),
+		(error) => ({ status: "failed", error: stringifyError(error) }),
+	);
 	const releaseModalLock = acquirekendexModalLock();
 	let action: QolSessionPaletteAction | undefined;
 	try {
 		const currentModel = ctx.model ? { provider: ctx.model.provider, id: ctx.model.id } : undefined;
-		action = await ctx.ui.custom<QolSessionPaletteAction>((tui, theme, _keybindings, done) =>
-			new QolSessionSearchComponent(done, tui, theme, sessions, ctx.cwd, initialQuery, currentModel), {
+		action = await ctx.ui.custom<QolSessionPaletteAction>((tui, theme, _keybindings, done) => {
+			const component = new QolSessionSearchComponent(done, tui, theme, { status: "loading" }, ctx.cwd, initialQuery, currentModel);
+			void loading.then((load) => component.setSessions(load));
+			return component;
+		}, {
 			overlay: true,
 			overlayOptions: {
 				anchor: "center",

package/extensions/qol/session-search/types.ts

@@ -13,6 +13,13 @@ export interface QolSessionSearchSession {
 	path: string;
 }
 
+/** The session-search index as the overlay sees it: still loading, loaded,
+ *  or failed with the load's error. */
+export type QolSessionSearchLoad =
+	| { status: "loading" }
+	| { status: "ready"; sessions: QolSessionSearchSession[] }
+	| { status: "failed"; error: string };
+
 export interface QolSessionSearchResult extends QolSessionSearchSession {
 	rank: number;
 	snippets: string[];

package/extensions/qol/settings.ts

@@ -1,113 +1,18 @@
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
 import { CONFIG_ID } from "./constants.js";
+import { piSettingsPaths, readPackageConfig, readSettingsFiles } from "./package-config.js";
 
 export type kendexConfig = Record<string, unknown>;
 
-export function expandHome(input: string): string {
-	if (input === "~") return homedir();
-	if (input.startsWith("~/")) return join(homedir(), input.slice(2));
-	return input;
-}
-
-export function projectSettingsPath(cwd: string): string {
-	let current = resolve(cwd);
-	while (true) {
-		const candidate = join(current, ".pi", "settings.json");
-		if (existsSync(candidate)) return candidate;
-		if (existsSync(join(current, ".pi")) || existsSync(join(current, ".git")) || existsSync(join(current, ".kendex-lock.json"))) return candidate;
-		const parent = dirname(current);
-		if (parent === current) return join(resolve(cwd), ".pi", "settings.json");
-		current = parent;
-	}
-}
-
-const PROJECT_TRUST_SYMBOL = Symbol.for("kendex.pi.project-trust");
-
-interface ProjectTrustRegistry {
-	projectSettings?: Map<string, boolean>;
-}
-
-function projectTrustRegistry(): ProjectTrustRegistry {
-	const host = globalThis as unknown as Record<PropertyKey, ProjectTrustRegistry | undefined>;
-	const existing = host[PROJECT_TRUST_SYMBOL];
-	if (existing) return existing;
-	const created: ProjectTrustRegistry = {};
-	host[PROJECT_TRUST_SYMBOL] = created;
-	return created;
-}
-
-export function recordProjectTrust(ctx: { cwd?: string; isProjectTrusted?: () => boolean }): void {
-	if (!ctx.cwd) return;
-	let trusted = true;
-	try {
-		trusted = ctx.isProjectTrusted?.() === true;
-	} catch {
-		trusted = false;
-	}
-	const registry = projectTrustRegistry();
-	if (!registry.projectSettings) registry.projectSettings = new Map();
-	registry.projectSettings.set(projectSettingsPath(ctx.cwd), trusted);
-}
-
-function projectSettingsTrusted(settingsPath: string): boolean {
-	return projectTrustRegistry().projectSettings?.get(settingsPath) === true;
-}
-
-/** Root-anchored as `crates/core/src/harness/pi.rs::pi_root_is_absolute_for`
- * means it, which `isAbsolute` is not: it calls a driveless `\root` absolute
- * where the renderer does not, putting the two on different roots. Hoisted, so
- * a circular import cannot reach it inside a temporal dead zone. */
-function rootAnchored(path: string, windows: boolean): boolean { return windows ? /^(?:[A-Za-z]:[\\/]|[\\/]{2}[^\\/]+[\\/][^\\/]+)/.test(path) : path.startsWith("/"); }
-
-export function piSettingsPaths(cwd = process.cwd()): string[] {
-	const override = expandHome(process.env.PI_CODING_AGENT_DIR?.trim() || "");
-	const userDir = resolve(rootAnchored(override, process.platform === "win32") ? override : expandHome("~/.pi/agent"));
-	const user = join(userDir, "settings.json");
-	const project = projectSettingsPath(cwd);
-	return projectSettingsTrusted(project) ? [user, project] : [user];
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-
-/** Each settings file `piSettingsPaths` names that exists and parses, later
- * files overriding earlier ones. A malformed file is skipped, as Pi's own
- * settings load treats one as empty. */
-function readPiSettingsFiles(cwd?: string): Record<string, any>[] {
-	const files: Record<string, any>[] = [];
-	for (const settingsPath of piSettingsPaths(cwd)) {
-		if (!existsSync(settingsPath)) continue;
-		try {
-			const parsed = JSON.parse(readFileSync(settingsPath, "utf8"));
-			if (isRecord(parsed)) files.push(parsed);
-		} catch {
-			// Ignore a malformed settings file.
-		}
-	}
-	return files;
-}
-
-export function readPackageConfig(packageId: string, cwd?: string): Record<string, unknown> {
-	const merged: Record<string, unknown> = {};
-	for (const settings of readPiSettingsFiles(cwd)) {
-		const config = settings.kendex?.extensionManager?.config?.[packageId];
-		if (isRecord(config)) Object.assign(merged, config);
-	}
-	return merged;
-}
-
 /** Pi core's `compaction.enabled` over the files QOL reads its own config
  * from, resolved as Pi's `SettingsManager.getCompactionEnabled` resolves it:
  * the last file that sets the key decides, a key no file sets is Pi's default,
  * true, and any falsy value turns compaction off. */
 export function piCompactionEnabled(cwd?: string): boolean {
 	let enabled: unknown;
-	for (const settings of readPiSettingsFiles(cwd)) {
-		const compaction = settings.compaction;
-		if (isRecord(compaction) && compaction.enabled !== undefined) enabled = compaction.enabled;
+	for (const file of readSettingsFiles(piSettingsPaths(cwd))) {
+		if (file.kind !== "parsed") continue;
+		const compaction = file.settings.compaction as { enabled?: unknown } | null | undefined;
+		if (compaction && typeof compaction === "object" && !Array.isArray(compaction) && compaction.enabled !== undefined) enabled = compaction.enabled;
 	}
 	return Boolean(enabled ?? true);
 }

package/extensions/qol.ts

@@ -1,4 +1,6 @@
 import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { join } from "node:path";
+import { pruneLanes } from "../scripts/lane-retention.js";
 import { truncateToWidth, type TUI } from "@earendil-works/pi-tui";
 import { criticalInfo, lastAssistantTextFromAgentEnd, needsDirection, taskStats } from "./qol/agent-end.js";
 import { getQuestionService, readCavemanBridge, type QuestionOpenedEventLike } from "./qol/bridges.js";
@@ -16,6 +18,7 @@ import {
 	DEFAULT_IDLE_COMPACTION_SECONDS,
 	DEFAULT_INPUT_BOTTOM_PADDING_LINES,
 	INSTALL_SYMBOL,
+	QOL_BUDGET_HANDOFF_FOLDER,
 	QOL_NOTIFICATION_SERVICE_SYMBOL,
 	QUESTION_OPENED_EVENT,
 	SESSION_MANAGER_STATUS_KEY,
@@ -23,6 +26,7 @@ import {
 	SESSION_SEARCH_STATUS_KEY,
 	SESSION_TITLE_SYNC_INTERVAL_MS,
 	STATUS_KEY,
+	THINKING_TIMER_MAX_DURATIONS,
 	THINKING_TIMER_STORE_SYMBOL,
 	TMUX_SESSION_TITLE_BORDER_FORMAT,
 } from "./qol/constants.js";
@@ -39,6 +43,7 @@ import { imageContentForPath, resolveSubmittedImagePaths } from "./qol/images.js
 import {
 	clearTmuxWindowMark,
 	notifyQuestionOpened,
+	resetQolNotificationCooldowns,
 	sendQolNotification,
 	type QolNotificationService,
 } from "./qol/notifications.js";
@@ -61,15 +66,18 @@ import {
 } from "./qol/session-rename.js";
 import { createScheduleController, getScheduleArgumentCompletions } from "./qol/schedule.js";
 import {
+	clearSessionSearchPendingAction,
 	consumePendingSessionSearchContext,
 	openQolSessionSearch,
-	qolSessionSearchPendingActions,
 	refreshQolSessionSearchCache,
+	releaseQolSessionSearchCache,
 	renderSessionSearchContextMessage,
 	runSessionSearchResumeOrFork,
 	sessionSearchShortcut,
+	takeSessionSearchPendingAction,
 } from "./qol/session-search/index.js";
-import { recordProjectTrust, settingBoolean, settingNumber, settingString } from "./qol/settings.js";
+import { installSettingsCacheRefresh, piUserDir, recordProjectTrust } from "./qol/package-config.js";
+import { settingBoolean, settingNumber, settingString } from "./qol/settings.js";
 import { statusMessage } from "./qol/status-message.js";
 import {
 	formatTmuxSessionTitle,
@@ -248,11 +256,24 @@ export default function qol(pi: ExtensionAPI): void {
 		const duration = Math.max(0, endTimeMs - start);
 		thinkingTimerStore.starts.delete(key);
 		thinkingTimerStore.durations.set(key, duration);
+		for (const oldest of thinkingTimerStore.durations.keys()) {
+			if (thinkingTimerStore.durations.size <= THINKING_TIMER_MAX_DURATIONS) break;
+			thinkingTimerStore.durations.delete(oldest);
+		}
 		const label = thinkingTimerStore.labels.get(key);
 		if (label) label.setText(thinkingTimerLabel(thinkingTimerStore.theme, duration, thinkingTimerStore.cwd));
 		if (thinkingTimerStore.starts.size === 0) stopThinkingTimerTicker();
 	};
 
+	// A label is held only to tick it while its block runs. A finished block's
+	// label already shows its final time, and a redraw of that message labels
+	// it again from `durations`.
+	const releaseFinishedThinkingLabels = () => {
+		for (const key of thinkingTimerStore.labels.keys()) {
+			if (!thinkingTimerStore.starts.has(key)) thinkingTimerStore.labels.delete(key);
+		}
+	};
+
 	const clearIdleCompactionTimer = () => {
 		if (idleCompactionTimer) clearTimeout(idleCompactionTimer);
 		idleCompactionTimer = undefined;
@@ -586,8 +607,13 @@ export default function qol(pi: ExtensionAPI): void {
 		rateLimitAutoResumeController.noteExternalRateLimitEvent(payload, currentCtx);
 	});
 
+	installSettingsCacheRefresh(pi);
 	pi.on("session_start", (event, ctx) => {
 		recordProjectTrust(ctx);
+		const pruned = pruneLanes(join(piUserDir(), "kendex", "sessions"), QOL_BUDGET_HANDOFF_FOLDER.split("/"));
+		for (const failure of pruned.failed) {
+			console.warn(`handoff-prune-error: ${failure.path}\n${failure.error}`);
+		}
 		currentCtx = ctx;
 		subscribeCavemanBridge();
 		latestSystemPromptOptions = undefined;
@@ -648,7 +674,8 @@ export default function qol(pi: ExtensionAPI): void {
 		}
 		startQuestionSubscription(ctx);
 		void attemptAutoRename(ctx);
-		if (settingBoolean("sessionSearch.enabled", true, ctx.cwd)) {
+		// A headless session has no search overlay to open, so it loads no index.
+		if (ctx.hasUI && settingBoolean("sessionSearch.enabled", true, ctx.cwd)) {
 			if (sessionSearchWarmupTimer) clearTimeout(sessionSearchWarmupTimer);
 			sessionSearchWarmupTimer = setTimeout(() => {
 				sessionSearchWarmupTimer = undefined;
@@ -673,8 +700,11 @@ export default function qol(pi: ExtensionAPI): void {
 		clearQuestionSubscribeTimer();
 		if (sessionSearchWarmupTimer) clearTimeout(sessionSearchWarmupTimer);
 		sessionSearchWarmupTimer = undefined;
+		releaseQolSessionSearchCache();
+		clearSessionSearchPendingAction();
 		resetThinkingTimer(undefined);
 		clearTmuxWindowMark(pi);
+		resetQolNotificationCooldowns();
 		questionUnsubscribe?.();
 		questionUnsubscribe = undefined;
 		currentCtx = undefined;
@@ -744,6 +774,7 @@ export default function qol(pi: ExtensionAPI): void {
 		}
 	});
 	pi.on("agent_end", (event, ctx) => {
+		releaseFinishedThinkingLabels();
 		if (ctx.hasUI) {
 			void refreshStatusline(ctx);
 			requestRender();
@@ -903,13 +934,11 @@ export default function qol(pi: ExtensionAPI): void {
 		pi.registerCommand("search:resume-pending", {
 			description: "Run a pending session-search resume or fork action",
 			handler: async (args, ctx) => {
-				const id = args.trim();
-				const action = qolSessionSearchPendingActions.get(id);
+				const action = takeSessionSearchPendingAction(args.trim());
 				if (!action) {
 					ctx.ui.notify("No pending session-search resume/fork action found.", "warning");
 					return;
 				}
-				qolSessionSearchPendingActions.delete(id);
 				if (!(await runSessionSearchResumeOrFork(pi, ctx, action))) ctx.ui.notify("Session resume/fork is unavailable in this context.", "error");
 			},
 		});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanillagreen/pi-qol",
-  "version": "2.2.1",
+  "version": "2.3.2",
   "description": "Pi quality-of-life extension: compact statusline/π prompt, reliable multiline input, styled pasted-image chips, session naming/search/context import, scheduled prompts, handoff, permission prompts, notifications, custom compaction, and a collapsed-thinking timer.",
   "license": "MIT",
   "keywords": [
@@ -504,9 +504,9 @@
         {
           "key": "sessionSearch.cacheTtlSeconds",
           "label": "Session cache TTL",
-          "description": "Seconds before the in-memory session list is refreshed. Default 0 keeps the cache until you explicitly run /search refresh.",
+          "description": "Seconds a loaded session index is kept in memory before it is released; the next search opens at once and reloads it. 0 keeps the index until the session ends.",
           "type": "number",
-          "default": 0,
+          "default": 300,
           "category": "Session Search",
           "apply": "live"
         },
@@ -988,6 +988,7 @@
   },
   "files": [
     "extensions/",
+    "scripts/",
     "assets/",
     "README.md",
     "package.json"