@oh-my-pi/pi-coding-agent 15.13.0 → 15.13.1

package/src/prompts/bench.md

@@ -1,7 +1,12 @@
-Write a continuous, plain-prose technical explanation of how a relational database executes a SQL query: lexing and parsing, semantic analysis, logical plan construction, cost-based optimization, physical operator selection, and row-by-row execution through the iterator model.
+You are given a relational schema and a multi-way analytical query, and you must work out from first principles the execution plan a cost-based optimizer should choose. This is a hard estimation problem with a large search space, so think it all the way through before you settle on anything and reason your way to each number instead of answering from intuition. Do not recite how query optimization works in general — actually do the analysis for this query, deriving every estimate.
+
+Schema and statistics: orders(id, customer_id, status, total) holds 50,000,000 rows with 5 distinct status values; customers(id, country, segment) holds 4,000,000 rows across 200 countries; line_items(order_id, product_id, qty) holds 300,000,000 rows; products(id, category, price) holds 80,000 rows across 600 categories. The query reports total revenue per product category for shipped orders placed by customers in one given country.
+
+Reason step by step and keep going: estimate the selectivity and output cardinality of each predicate and each join, then enumerate every join order over the four tables and derive the cost of each under both nested-loop and hash-join operators, weigh index access against full scans for each table, decide where the aggregation belongs and whether a partial pre-aggregation or a semi-join reduction earns its keep, and account for a memory limit that forces a hash build side to spill to disk. Compute the number behind every decision before you commit to it; when you finish one candidate plan, move on to the next and derive its cost too, and choose a winner only after you have costed the whole field. Never assert a choice you have not justified with an estimate.
 
 Form:
-- Plain paragraphs only: no headings, no lists, no code fences, no preamble.
-- Do not wrap up early or summarize; keep writing until you are cut off.
+- Plain paragraphs only: no headings, no lists, no code fences, no tables, no preamble.
+- Derive each estimate explicitly; state no conclusion you have not computed.
+- Do not wrap up early or summarize; keep reasoning until you are cut off.
 
-Output only the explanation.
+Output only the analysis.

package/src/sdk.ts

@@ -404,7 +404,7 @@ export interface CreateAgentSessionOptions {
 	scopedModels?: Array<{ model: Model; thinkingLevel?: ThinkingLevel }>;
 
 	/** System prompt blocks. Array replaces default, function receives default blocks and returns final blocks. */
-	systemPrompt?: string[] | ((defaultPrompt: string[]) => string[]);
+	systemPrompt?: string | string[] | ((defaultPrompt: string[]) => string | string[]);
 	/** Optional provider-facing session identifier for prompt caches and sticky auth selection.
 	 * Keeps persisted session files isolated while reusing provider-side caches. */
 	providerSessionId?: string;
@@ -2176,11 +2176,12 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
 			if (options.systemPrompt === undefined) {
 				return defaultPrompt;
 			}
-			if (Array.isArray(options.systemPrompt)) {
-				return { systemPrompt: options.systemPrompt };
-			}
+			const customPrompt =
+				typeof options.systemPrompt === "function"
+					? options.systemPrompt(defaultPrompt.systemPrompt)
+					: options.systemPrompt;
 			return {
-				systemPrompt: options.systemPrompt(defaultPrompt.systemPrompt),
+				systemPrompt: typeof customPrompt === "string" ? [customPrompt] : customPrompt,
 			};
 		};
 

package/src/session/agent-session.ts

@@ -965,6 +965,13 @@ export class AgentSession {
 	#activeRetryFallback: ActiveRetryFallbackState | undefined = undefined;
 	// Todo completion reminder state
 	#todoReminderCount = 0;
+	/**
+	 * Set true after a todo reminder is appended; cleared when the agent makes any tool-level
+	 * progress (toolResult) or a new user prompt arrives. Suppresses follow-up reminders within
+	 * the same agent self-continuation chain so a text-only acknowledgement ("paused at your
+	 * instruction") does not drive 1/3 → 2/3 → 3/3 without user input.
+	 */
+	#todoReminderAwaitingProgress = false;
 	#todoPhases: TodoPhase[] = [];
 	#toolChoiceQueue = new ToolChoiceQueue();
 
@@ -1828,6 +1835,10 @@ export class AgentSession {
 					isError?: boolean;
 					content?: Array<TextContent | ImageContent>;
 				};
+				// A tool actually ran. Clear the post-reminder suppression: the agent did
+				// productive work in response to the prior nudge, so the next text-only stop
+				// is allowed to escalate to the next reminder if todos remain incomplete.
+				this.#todoReminderAwaitingProgress = false;
 				// Invalidate streaming edit cache when edit tool completes to prevent stale data
 				if (toolName === "edit" && details?.path) {
 					this.#invalidateFileCacheForPath(details.path);
@@ -4750,6 +4761,7 @@ export class AgentSession {
 
 			// Reset todo reminder count on new user prompt
 			this.#todoReminderCount = 0;
+			this.#todoReminderAwaitingProgress = false;
 			this.#emptyStopRetryCount = 0;
 
 			await this.#maybeRestoreRetryFallbackPrimary();
@@ -5545,6 +5557,7 @@ export class AgentSession {
 		);
 
 		this.#todoReminderCount = 0;
+		this.#todoReminderAwaitingProgress = false;
 		this.#planReferenceSent = false;
 		this.#planReferencePath = "local://PLAN.md";
 		this.#reconnectToAgent();
@@ -6680,6 +6693,7 @@ export class AgentSession {
 			this.#pendingNextTurnMessages = [];
 			this.#scheduledHiddenNextTurnGeneration = undefined;
 			this.#todoReminderCount = 0;
+			this.#todoReminderAwaitingProgress = false;
 
 			// Inject the handoff document as a custom message
 			const handoffContent = createHandoffContext(handoffText);
@@ -7219,10 +7233,22 @@ export class AgentSession {
 			return;
 		}
 
+		// Suppress within a self-continuation chain: if the agent's last turn was driven by a
+		// prior reminder (and the agent took no tool-level action since), do not re-ping.
+		// The agent has already acknowledged; further escalation just wastes context and
+		// pressures the agent into busy-work or destructive ops (issue #2590).
+		if (this.#todoReminderAwaitingProgress) {
+			logger.debug("Todo completion: prior reminder still awaiting agent action; staying silent", {
+				attempt: this.#todoReminderCount,
+			});
+			return;
+		}
+
 		const remindersEnabled = this.settings.get("todo.reminders");
 		const todosEnabled = this.settings.get("todo.enabled");
 		if (!remindersEnabled || !todosEnabled) {
 			this.#todoReminderCount = 0;
+			this.#todoReminderAwaitingProgress = false;
 			return;
 		}
 
@@ -7235,6 +7261,7 @@ export class AgentSession {
 		const phases = this.getTodoPhases();
 		if (phases.length === 0) {
 			this.#todoReminderCount = 0;
+			this.#todoReminderAwaitingProgress = false;
 			return;
 		}
 
@@ -7252,6 +7279,7 @@ export class AgentSession {
 		const incomplete = incompleteByPhase.flatMap(phase => phase.tasks);
 		if (incomplete.length === 0) {
 			this.#todoReminderCount = 0;
+			this.#todoReminderAwaitingProgress = false;
 			return;
 		}
 
@@ -7280,6 +7308,7 @@ export class AgentSession {
 			maxAttempts: remindersMax,
 		});
 
+		this.#todoReminderAwaitingProgress = true;
 		// Inject reminder and continue the conversation
 		this.agent.appendMessage({
 			role: "developer",
@@ -8466,7 +8495,7 @@ export class AgentSession {
 		// src/http/h2_client/dispatch.zig)
 		return (
 			isUnexpectedSocketCloseMessage(errorMessage) ||
-			/overloaded|provider.?returned.?error|rate.?limit|too many requests|429|500|502|503|504|service.?unavailable|server.?error|internal.?error|retry your request|network.?error|connection.?error|connection.?refused|other side closed|fetch failed|upstream.?connect|upstream.?request.?failed|reset before headers|socket hang up|timed? out|timeout|terminated|retry delay|stream stall|no error details in response|HTTP2(?:StreamReset|RefusedStream|EnhanceYourCalm)/i.test(
+			/overloaded|provider.?returned.?error|rate.?limit|too many requests|429|500|502|503|504|service.?unavailable|server.?error|internal.?error|retry your request|network.?error|connection.?error|connection.?refused|other side closed|fetch failed|upstream.?connect|upstream.?request.?failed|reset before headers|socket hang up|timed? out|timeout|terminated|retry delay|stream stall|no error details in response|HTTP2(?:StreamReset|RefusedStream|EnhanceYourCalm)|malformed.?function.?call/i.test(
 				errorMessage,
 			)
 		);

package/src/session/messages.ts

@@ -34,6 +34,15 @@ import { formatOutputNotice } from "../tools/output-meta";
 
 export const SKILL_PROMPT_MESSAGE_TYPE = "skill-prompt";
 export const LSP_LATE_DIAGNOSTIC_MESSAGE_TYPE = "lsp-late-diagnostic";
+export const BACKGROUND_TAN_DISPATCH_MESSAGE_TYPE = "background-tan-dispatch";
+
+/** Details persisted on a `/tan` background-dispatch breadcrumb. */
+export interface BackgroundTanDispatchDetails {
+	jobId: string;
+	work: string;
+	/** Forked clone session file, named `<agentId>.jsonl`; the Agent Hub reads its transcript. */
+	sessionFile: string;
+}
 
 export interface SkillPromptDetails {
 	name: string;

package/src/session/session-manager.ts

@@ -1483,13 +1483,18 @@ export class SessionManager {
 	/**
 	 * Fork a session into the current project directory: copy history from another
 	 * session file while creating a fresh session file in this sessionDir.
+	 *
+	 * `options.sessionFile` pins the new session's file path (default: an
+	 * auto-named `<timestamp>_<id>.jsonl` in `sessionDir`). Callers that register
+	 * the fork as a named agent (e.g. `/tan`) pass `<agentId>.jsonl` so the
+	 * persisted-subagent scan keys the agent by the same id the live ref uses.
 	 */
 	static async forkFrom(
 		sourcePath: string,
 		cwd: string,
 		sessionDir?: string,
 		storage: SessionStorage = new FileSessionStorage(),
-		options?: { suppressBreadcrumb?: boolean },
+		options?: { suppressBreadcrumb?: boolean; sessionFile?: string },
 	): Promise<SessionManager> {
 		const dir = sessionDir ?? SessionManager.getDefaultSessionDir(cwd, undefined, storage);
 		const manager = new SessionManager(cwd, dir, true, storage);
@@ -1501,7 +1506,7 @@ export class SessionManager {
 
 		const sourceHeader = sourceEntries.find(entry => entry.type === "session") as SessionHeader | undefined;
 		const history = sourceEntries.filter(entry => entry.type !== "session") as SessionEntry[];
-		manager.#resetToNewSession({ parentSession: sourceHeader?.id });
+		manager.#resetToNewSession({ parentSession: sourceHeader?.id }, options?.sessionFile);
 		manager.#header.title = sourceHeader?.title;
 		manager.#header.titleSource = sourceHeader?.titleSource;
 		manager.#sessionName = manager.#header.title;

package/src/tiny/text.ts

@@ -161,5 +161,9 @@ export function normalizeGeneratedTitle(value: string | null | undefined): strin
 		.replace(/[.!?]$/, "")
 		.trim();
 	if (!title || title.toLowerCase() === NO_TITLE_SENTINEL) return null;
-	return title;
+	return titleCase(title);
+}
+
+function titleCase(value: string): string {
+	return value.replace(/\b\p{Ll}/gu, c => c.toUpperCase());
 }

package/src/tools/ast-grep.ts

@@ -6,7 +6,7 @@ import type { Component } from "@oh-my-pi/pi-tui";
 import { Text } from "@oh-my-pi/pi-tui";
 import { prompt, untilAborted } from "@oh-my-pi/pi-utils";
 import { z } from "zod/v4";
-import { recordFileSnapshot } from "../edit/file-snapshot-store";
+import { recordFileSnapshot, recordSeenLinesFromBody } from "../edit/file-snapshot-store";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import type { Theme } from "../modes/theme/theme";
 import astGrepDescription from "../prompts/tools/ast-grep.md" with { type: "text" };
@@ -270,6 +270,10 @@ export class AstGrepTool implements AgentTool<typeof astGrepSchema, AstGrepToolD
 					}
 					fileMatchCounts.set(relativePath, (fileMatchCounts.get(relativePath) ?? 0) + 1);
 				}
+				if (hashContext?.tag) {
+					const absoluteFilePath = path.resolve(this.session.cwd, relativePath);
+					recordSeenLinesFromBody(this.session, absoluteFilePath, hashContext.tag, modelOut.join("\n"));
+				}
 				return { model: modelOut, display: displayOut };
 			};
 

package/src/tools/builtin-names.ts

@@ -0,0 +1,35 @@
+export const BUILTIN_TOOL_NAMES = [
+	"read",
+	"bash",
+	"edit",
+	"ast_grep",
+	"ast_edit",
+	"render_mermaid",
+	"ask",
+	"debug",
+	"eval",
+	"ssh",
+	"github",
+	"find",
+	"search",
+	"lsp",
+	"inspect_image",
+	"browser",
+	"checkpoint",
+	"rewind",
+	"task",
+	"job",
+	"irc",
+	"todo",
+	"web_search",
+	"search_tool_bm25",
+	"write",
+	"memory_edit",
+	"retain",
+	"recall",
+	"reflect",
+	"learn",
+	"manage_skill",
+] as const;
+
+export type BuiltinToolName = (typeof BUILTIN_TOOL_NAMES)[number];

package/src/tools/index.ts

@@ -37,6 +37,7 @@ import { AstEditTool } from "./ast-edit";
 import { AstGrepTool } from "./ast-grep";
 import { BashTool } from "./bash";
 import { BrowserTool } from "./browser";
+import type { BuiltinToolName } from "./builtin-names";
 import { type CheckpointState, CheckpointTool, RewindTool } from "./checkpoint";
 import { DebugTool } from "./debug";
 import { EvalTool } from "./eval";
@@ -413,7 +414,7 @@ export function filterInitialToolsForDiscoveryAll(
  * Public callable factory map. External callers may invoke `BUILTIN_TOOLS.read(session)` or
  * `BUILTIN_TOOLS[name](session)` to construct a tool directly.
  */
-export const BUILTIN_TOOLS: Record<string, ToolFactory> = {
+export const BUILTIN_TOOLS: Record<BuiltinToolName, ToolFactory> = {
 	read: s => new ReadTool(s),
 	bash: s => new BashTool(s),
 	edit: s => new EditTool(s),
@@ -455,7 +456,7 @@ export const HIDDEN_TOOLS: Record<string, ToolFactory> = {
 	goal: s => new GoalTool(s),
 };
 
-export type ToolName = keyof typeof BUILTIN_TOOLS;
+export type ToolName = BuiltinToolName;
 
 /**
  * Create tools from BUILTIN_TOOLS registry.

package/src/tools/read.ts

@@ -14,6 +14,7 @@ import {
 	canonicalSnapshotKey,
 	getFileSnapshotStore,
 	recordFileSnapshot,
+	recordSeenLinesFromBody,
 	SNAPSHOT_MAX_BYTES,
 } from "../edit/file-snapshot-store";
 import { normalizeToLF } from "../edit/normalize";
@@ -1356,6 +1357,7 @@ export class ReadTool implements AgentTool<typeof readSchema, ReadToolDetails> {
 		if (shouldAddHashLines && outputText) {
 			const tag = await recordFileSnapshot(this.session, absolutePath);
 			if (tag) {
+				recordSeenLinesFromBody(this.session, absolutePath, tag, outputText);
 				outputText = `${formatHashlineHeader(formatPathRelativeToCwd(absolutePath, this.session.cwd), tag)}\n${outputText}`;
 			}
 		}
@@ -2059,6 +2061,9 @@ export class ReadTool implements AgentTool<typeof readSchema, ReadToolDetails> {
 						: undefined;
 					const bodyText = footer ? `${renderedSummary.text}\n\n${footer}` : renderedSummary.text;
 					const modelText = prependHashlineHeader(bodyText, summaryHashContext);
+					if (summaryHashContext?.tag) {
+						recordSeenLinesFromBody(this.session, absolutePath, summaryHashContext.tag, renderedSummary.text);
+					}
 					details = {
 						displayContent: { text: renderedSummary.displayText, startLine: 1 },
 						summary: {
@@ -2354,6 +2359,10 @@ export class ReadTool implements AgentTool<typeof readSchema, ReadToolDetails> {
 						sourcePath = absolutePath;
 					}
 
+					if (hashContext?.tag) {
+						recordSeenLinesFromBody(this.session, absolutePath, hashContext.tag, outputText);
+					}
+
 					if (capturedDisplayContent) {
 						details.displayContent = capturedDisplayContent;
 					}

package/src/tools/search.ts

@@ -8,7 +8,7 @@ import type { Component } from "@oh-my-pi/pi-tui";
 import { Text } from "@oh-my-pi/pi-tui";
 import { prompt, untilAborted } from "@oh-my-pi/pi-utils";
 import { z } from "zod/v4";
-import { recordFileSnapshot } from "../edit/file-snapshot-store";
+import { recordFileSnapshot, recordSeenLinesFromBody } from "../edit/file-snapshot-store";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import type { LocalProtocolOptions } from "../internal-urls/local-protocol";
 import { InternalUrlRouter } from "../internal-urls/router";
@@ -1197,6 +1197,10 @@ export class SearchTool implements AgentTool<typeof searchSchema, SearchToolDeta
 						}
 						fileMatchCounts.set(relativePath, (fileMatchCounts.get(relativePath) ?? 0) + 1);
 					}
+					if (hashContext?.tag) {
+						const absoluteFilePath = path.resolve(this.session.cwd, relativePath);
+						recordSeenLinesFromBody(this.session, absoluteFilePath, hashContext.tag, modelOut.join("\n"));
+					}
 					return { model: modelOut, display: displayOut };
 				};
 				const useGroupedOutput = isDirectory || isMultiScope;

package/src/tts/tts-worker.ts

@@ -76,8 +76,13 @@ interface TransformersEnv {
 		cacheDir?: string;
 		allowLocalModels?: boolean;
 		logLevel?: unknown;
+		backends?: {
+			onnx?: {
+				logLevel?: unknown;
+			};
+		};
 	};
-	LogLevel: {
+	LogLevel?: {
 		ERROR: unknown;
 	};
 }
@@ -146,7 +151,8 @@ function toKokoroDevice(device: TinyModelDevice): KokoroDevice {
 function configureTransformers(transformers: TransformersEnv): void {
 	transformers.env.cacheDir = getTinyModelsCacheDir();
 	transformers.env.allowLocalModels = false;
-	transformers.env.logLevel = transformers.LogLevel.ERROR;
+	transformers.env.logLevel = transformers.LogLevel?.ERROR ?? "error";
+	if (transformers.env.backends?.onnx) transformers.env.backends.onnx.logLevel = "error";
 }
 
 /**
@@ -182,9 +188,11 @@ async function loadKokoroRuntime(
 		installRuntimeModuleResolver({ runtimeNodeModules: nodeModules, stubs: { sharp: sharpStub } });
 		const kokoroEntry = resolveRuntimeModule(nodeModules, KOKORO_PACKAGE);
 		if (!kokoroEntry) throw new Error(`Unable to resolve ${KOKORO_PACKAGE} in runtime at ${nodeModules}`);
-		const entryRequire = createRequire(kokoroEntry);
-		configureTransformers(entryRequire(TRANSFORMERS_PACKAGE) as TransformersEnv);
-		return entryRequire(kokoroEntry) as KokoroRuntime;
+		const transformersEntry = resolveRuntimeModule(nodeModules, TRANSFORMERS_PACKAGE);
+		if (!transformersEntry) throw new Error(`Unable to resolve ${TRANSFORMERS_PACKAGE} in runtime at ${nodeModules}`);
+		const runtimeRequire = createRequire(kokoroEntry);
+		configureTransformers(runtimeRequire(transformersEntry) as TransformersEnv);
+		return runtimeRequire(kokoroEntry) as KokoroRuntime;
 	})().catch(error => {
 		kokoroRuntime = null;
 		throw error;

package/src/utils/external-editor.ts

@@ -7,9 +7,22 @@ import * as os from "node:os";
 import * as path from "node:path";
 import { $env, Snowflake } from "@oh-my-pi/pi-utils";
 
-/** Returns the user's preferred editor command, or undefined if not configured. */
+/**
+ * Returns the user's preferred editor command, or a platform default.
+ *
+ * Resolution order:
+ *   1. `$VISUAL`
+ *   2. `$EDITOR`
+ *   3. `notepad` on Windows (always present in `%SystemRoot%\System32`)
+ *
+ * POSIX returns `undefined` when neither variable is set so the caller can
+ * surface a warning that nudges the user to configure one.
+ */
 export function getEditorCommand(): string | undefined {
-	return $env.VISUAL || $env.EDITOR || undefined;
+	const configured = $env.VISUAL?.trim() || $env.EDITOR?.trim();
+	if (configured) return configured;
+	if (process.platform === "win32") return "notepad";
+	return undefined;
 }
 
 export interface OpenInEditorOptions {

package/src/utils/title-generator.ts

@@ -73,7 +73,7 @@ function getTitleModel(registry: ModelRegistry, settings: Settings, currentModel
 	const availableModels = registry.getAvailable();
 	if (availableModels.length === 0) return undefined;
 
-	const titleModel = resolveRoleSelection(["commit", "smol"], settings, availableModels, registry)?.model;
+	const titleModel = resolveRoleSelection(["title", "commit", "smol"], settings, availableModels, registry)?.model;
 	if (titleModel) return titleModel;
 
 	if (currentModel) return currentModel;

package/src/workspace-tree.ts

@@ -75,6 +75,9 @@ export async function buildDirectoryTree(cwd: string, options: BuildDirectoryTre
 		rootLimit,
 		lineCap: options.lineCap === undefined ? null : options.lineCap,
 		nativeTruncated,
+		// Tool output (read tool directory listing), not a cached prefix —
+		// the human-friendly relative "ago" is appropriate here.
+		ageMode: "relative",
 	});
 }
 
@@ -99,6 +102,10 @@ export async function buildWorkspaceTree(cwd: string, options: BuildWorkspaceTre
 			rootLimit: WORKSPACE_DEFAULTS.perDirLimit,
 			lineCap: WORKSPACE_DEFAULTS.lineCap,
 			nativeTruncated: result.truncated,
+			// This tree is embedded in the cached system prompt. Render absolute
+			// mtimes so the block is byte-identical across sessions and does not
+			// bust the prompt cache (a relative "Nm ago" drifts every build).
+			ageMode: "absolute",
 		});
 		return { ...tree, agentsMdFiles: result.agentsMdFiles };
 	} catch {
@@ -132,6 +139,13 @@ interface AssembleOptions {
 	rootLimit: number | null;
 	lineCap: number | null;
 	nativeTruncated: boolean;
+	/**
+	 * How per-entry modification times are rendered.
+	 * - "relative": render-time "Nm ago" (fine for tool output).
+	 * - "absolute": deterministic UTC timestamp (prompt-cache-stable; used for
+	 *   the system-prompt workspace tree). See {@link makeAgeFormatter}.
+	 */
+	ageMode: "relative" | "absolute";
 }
 
 function assembleTree(rootPath: string, entries: readonly GlobMatch[], opts: AssembleOptions): DirectoryTree {
@@ -187,7 +201,7 @@ function assembleTree(rootPath: string, entries: readonly GlobMatch[], opts: Ass
 	}
 
 	const rawLines: RenderedLine[] = [];
-	renderNode(root, Date.now(), rawLines);
+	renderNode(root, makeAgeFormatter(opts.ageMode), rawLines);
 	const { lines, elidedCount } = applyLineCap(rawLines, opts.lineCap);
 
 	return {
@@ -202,7 +216,33 @@ function byRecency(a: Node, b: Node): number {
 	return b.mtimeMs - a.mtimeMs || a.name.localeCompare(b.name);
 }
 
-function renderNode(node: Node, nowMs: number, out: RenderedLine[]): void {
+/**
+ * Build the per-node age formatter for a single render pass.
+ *
+ * - "relative": a render-time "Nm ago" string (computed once from `Date.now()`).
+ *   Used for tool output that is not part of any cached prefix.
+ * - "absolute": a deterministic UTC `YYYY-MM-DD HH:MM` derived purely from the
+ *   file's mtime. Used for the system-prompt workspace tree so the rendered
+ *   block stays byte-identical across sessions. A relative age is recomputed on
+ *   every build, so two sessions seconds apart differ ("9m ago" → "10m ago");
+ *   because KV cache is contextual, that early change invalidates the cache for
+ *   everything after the tree — including the multi-thousand-token tool block —
+ *   forcing a full prompt re-prefill on every new session. An absolute mtime
+ *   only changes when the file itself changes, which is the correct trigger.
+ */
+function makeAgeFormatter(mode: "relative" | "absolute"): (mtimeMs: number) => string {
+	if (mode === "absolute") return formatMtimeStable;
+	const nowMs = Date.now();
+	return (mtimeMs: number) => formatAge(Math.max(0, Math.floor((nowMs - mtimeMs) / 1000)));
+}
+
+/** Deterministic, render-time-independent timestamp: UTC `YYYY-MM-DD HH:MM`. */
+function formatMtimeStable(mtimeMs: number): string {
+	if (!mtimeMs) return "";
+	return new Date(mtimeMs).toISOString().slice(0, 16).replace("T", " ");
+}
+
+function renderNode(node: Node, formatNodeAge: (mtimeMs: number) => string, out: RenderedLine[]): void {
 	if (node.depth === 0) {
 		out.push({ label: node.name, depth: 0, isRoot: true });
 	} else {
@@ -213,26 +253,26 @@ function renderNode(node: Node, nowMs: number, out: RenderedLine[]): void {
 			depth: node.depth,
 			isRoot: false,
 			size: node.isDir ? undefined : formatBytes(node.size),
-			age: formatAge(Math.max(0, Math.floor((nowMs - node.mtimeMs) / 1000))),
+			age: formatNodeAge(node.mtimeMs),
 		});
 	}
 
 	if (node.droppedCount === 0) {
-		for (const child of node.children) renderNode(child, nowMs, out);
+		for (const child of node.children) renderNode(child, formatNodeAge, out);
 		return;
 	}
 
 	// Layout: recent children, then "… N more" marker, then the oldest child.
 	const recent = node.children.slice(0, -1);
 	const oldest = node.children.at(-1);
-	for (const child of recent) renderNode(child, nowMs, out);
+	for (const child of recent) renderNode(child, formatNodeAge, out);
 	const childDepth = node.depth + 1;
 	out.push({
 		label: `${"  ".repeat(childDepth)}- … ${node.droppedCount} more`,
 		depth: childDepth,
 		isRoot: false,
 	});
-	if (oldest) renderNode(oldest, nowMs, out);
+	if (oldest) renderNode(oldest, formatNodeAge, out);
 }
 
 /**

package/dist/types/utils/tools-manager.test.d.ts

@@ -1 +0,0 @@
-export {};

package/src/utils/tools-manager.test.ts

@@ -1,25 +0,0 @@
-import { describe, expect, it } from "bun:test";
-import { ffmpegAssetName } from "./tools-manager";
-
-describe("ffmpegAssetName", () => {
-	it("maps supported platform/arch pairs to direct-binary asset names", () => {
-		expect(ffmpegAssetName("b6.1.1", "darwin", "arm64")).toBe("ffmpeg-darwin-arm64");
-		expect(ffmpegAssetName("b6.1.1", "darwin", "x64")).toBe("ffmpeg-darwin-x64");
-		expect(ffmpegAssetName("b6.1.1", "linux", "arm64")).toBe("ffmpeg-linux-arm64");
-		expect(ffmpegAssetName("b6.1.1", "linux", "x64")).toBe("ffmpeg-linux-x64");
-		expect(ffmpegAssetName("b6.1.1", "win32", "x64")).toBe("ffmpeg-win32-x64");
-	});
-
-	it("returns null for win32 on arm64 (no static asset published)", () => {
-		expect(ffmpegAssetName("b6.1.1", "win32", "arm64")).toBeNull();
-	});
-
-	it("returns null for unsupported arch", () => {
-		expect(ffmpegAssetName("b6.1.1", "darwin", "ia32")).toBeNull();
-		expect(ffmpegAssetName("b6.1.1", "linux", "ppc64")).toBeNull();
-	});
-
-	it("returns null for unsupported platform", () => {
-		expect(ffmpegAssetName("b6.1.1", "freebsd", "x64")).toBeNull();
-	});
-});