@oh-my-pi/pi-coding-agent 17.1.5 → 17.1.6

package/src/task/index.ts

@@ -156,27 +156,31 @@ export function formatResultOutputFallback(result: Pick<SingleResult, "output" |
 	return result.requests > 0 ? `(no output) after ${result.requests} req` : "(no output)";
 }
 
-/**
- * Render the tool description from a cached agent list and current settings.
- */
-function renderDescription(
-	agents: AgentDefinition[],
-	isolationEnabled: boolean,
-	applyIsolatedChanges: boolean,
-	disabledAgents: string[],
-	batchEnabled: boolean,
-	asyncEnabled: boolean,
-	ircEnabled: boolean,
-	parentSpawns: string,
-): string {
-	const spawnPolicy = resolveSpawnPolicy(parentSpawns);
+interface TaskDescriptionOptions {
+	agents: AgentDefinition[];
+	isolationEnabled: boolean;
+	applyIsolatedChanges: boolean;
+	disabledAgents: string[];
+	batchEnabled: boolean;
+	effortEnabled: boolean;
+	asyncEnabled: boolean;
+	ircEnabled: boolean;
+	parentSpawns: string;
+}
+
+/** Render the tool description from a cached agent list and current settings. */
+function renderDescription(options: TaskDescriptionOptions): string {
+	const spawnPolicy = resolveSpawnPolicy(options.parentSpawns);
 	const spawningDisabled = !spawnPolicy.enabled;
-	let filteredAgents = disabledAgents.length > 0 ? agents.filter(a => !disabledAgents.includes(a.name)) : agents;
+	let filteredAgents =
+		options.disabledAgents.length > 0
+			? options.agents.filter(agent => !options.disabledAgents.includes(agent.name))
+			: options.agents;
 	if (spawningDisabled) {
 		filteredAgents = [];
 	} else if (spawnPolicy.allowedAgents !== null) {
 		const allowed = new Set(spawnPolicy.allowedAgents);
-		filteredAgents = filteredAgents.filter(a => allowed.has(a.name));
+		filteredAgents = filteredAgents.filter(agent => allowed.has(agent.name));
 	}
 	const renderedAgents = filteredAgents.map(agent => ({
 		name: agent.name,
@@ -188,12 +192,13 @@ function renderDescription(
 		agents: renderedAgents,
 		spawningDisabled,
 		defaultAgent: spawnPolicy.defaultAgent,
-		isolationEnabled,
-		applyIsolatedChanges,
-		batchEnabled,
-		asyncEnabled,
+		isolationEnabled: options.isolationEnabled,
+		applyIsolatedChanges: options.applyIsolatedChanges,
+		batchEnabled: options.batchEnabled,
+		effortEnabled: options.effortEnabled,
+		asyncEnabled: options.asyncEnabled,
 		hasBlockingAgents: renderedAgents.some(agent => agent.blocking),
-		ircEnabled,
+		ircEnabled: options.ircEnabled,
 	});
 }
 
@@ -581,28 +586,34 @@ export class TaskTool implements AgentTool<TaskToolSchemaInstance, TaskToolDetai
 		const planMode = this.session.getPlanModeState?.()?.enabled === true;
 		const isolationEnabled = !planMode && this.session.settings.get("task.isolation.mode") !== "none";
 		const defaultAgent = resolveSpawnPolicy(this.session.getSessionSpawns()).defaultAgent;
-		return getTaskSchema({ isolationEnabled, batchEnabled: this.#isBatchEnabled(), defaultAgent });
+		return getTaskSchema({
+			isolationEnabled,
+			batchEnabled: this.#isBatchEnabled(),
+			effortEnabled: this.session.settings.get("task.enableEffort"),
+			defaultAgent,
+		});
 	}
 
 	renderCall(args: unknown, options: Parameters<typeof renderTaskCall>[1], theme: Theme) {
 		return renderTaskCall(repairTaskParams(args as TaskParams), options, theme);
 	}
 
-	/** Dynamic description that reflects current disabled-agent settings */
+	/** Dynamic description that reflects current task settings. */
 	get description(): string {
 		const disabledAgents = this.session.settings.get("task.disabledAgents") as string[];
 		const planMode = this.session.getPlanModeState?.()?.enabled === true;
 		const isolationMode = this.session.settings.get("task.isolation.mode");
-		return renderDescription(
-			this.#discoveredAgents,
-			!planMode && isolationMode !== "none",
-			this.session.settings.get("task.isolation.apply"),
+		return renderDescription({
+			agents: this.#discoveredAgents,
+			isolationEnabled: !planMode && isolationMode !== "none",
+			applyIsolatedChanges: this.session.settings.get("task.isolation.apply"),
 			disabledAgents,
-			this.#isBatchEnabled(),
-			this.session.settings.get("async.enabled"),
-			isIrcEnabled(this.session.settings, this.session.taskDepth ?? 0),
-			this.session.getSessionSpawns() ?? "*",
-		);
+			batchEnabled: this.#isBatchEnabled(),
+			effortEnabled: this.session.settings.get("task.enableEffort"),
+			asyncEnabled: this.session.settings.get("async.enabled"),
+			ircEnabled: isIrcEnabled(this.session.settings, this.session.taskDepth ?? 0),
+			parentSpawns: this.session.getSessionSpawns() ?? "*",
+		});
 	}
 	private constructor(
 		private readonly session: ToolSession,

package/src/task/types.ts

@@ -115,7 +115,6 @@ export const taskItemSchema = type({
 	"name?": "string",
 	agent: "string = 'task'",
 	task: "string",
-	"effort?": effortRule,
 	"outputSchema?": outputSchemaInputSchema,
 	"schemaMode?": '"permissive" | "strict"',
 	"+": "delete",
@@ -124,7 +123,6 @@ const taskItemSchemaIsolated = type({
 	"name?": "string",
 	agent: "string = 'task'",
 	task: "string",
-	"effort?": effortRule,
 	"outputSchema?": outputSchemaInputSchema,
 	"schemaMode?": '"permissive" | "strict"',
 	"isolated?": "boolean",
@@ -153,7 +151,6 @@ export const taskSchema = type({
 	"name?": "string",
 	agent: "string = 'task'",
 	task: "string",
-	"effort?": effortRule,
 	"outputSchema?": outputSchemaInputSchema,
 	"schemaMode?": '"permissive" | "strict"',
 	"isolated?": "boolean",
@@ -163,7 +160,6 @@ const taskSchemaNoIsolation = type({
 	"name?": "string",
 	agent: "string = 'task'",
 	task: "string",
-	"effort?": effortRule,
 	"outputSchema?": outputSchemaInputSchema,
 	"schemaMode?": '"permissive" | "strict"',
 	"+": "delete",
@@ -200,15 +196,17 @@ function createTaskSchema(options: {
 	isolationEnabled: boolean;
 	batchEnabled: boolean;
 	defaultAgent: string;
+	effortEnabled: boolean;
 }): BaseType {
 	const agent = taskAgentSchemaRule(options.defaultAgent);
+	const effortField = options.effortEnabled ? { "effort?": effortRule } : {};
 	if (options.batchEnabled) {
 		if (options.isolationEnabled) {
 			const item = type.raw({
 				"name?": "string",
 				agent,
 				task: "string",
-				"effort?": effortRule,
+				...effortField,
 				"outputSchema?": outputSchemaInputSchema,
 				"schemaMode?": '"permissive" | "strict"',
 				"isolated?": "boolean",
@@ -224,7 +222,7 @@ function createTaskSchema(options: {
 			"name?": "string",
 			agent,
 			task: "string",
-			"effort?": effortRule,
+			...effortField,
 			"outputSchema?": outputSchemaInputSchema,
 			"schemaMode?": '"permissive" | "strict"',
 			"+": "delete",
@@ -240,7 +238,7 @@ function createTaskSchema(options: {
 			"name?": "string",
 			agent,
 			task: "string",
-			"effort?": effortRule,
+			...effortField,
 			"outputSchema?": outputSchemaInputSchema,
 			"schemaMode?": '"permissive" | "strict"',
 			"isolated?": "boolean",
@@ -251,33 +249,30 @@ function createTaskSchema(options: {
 		"name?": "string",
 		agent,
 		task: "string",
-		"effort?": effortRule,
+		...effortField,
 		"outputSchema?": outputSchemaInputSchema,
 		"schemaMode?": '"permissive" | "strict"',
 		"+": "delete",
 	});
 }
 
-export function getTaskSchema(options: { isolationEnabled: boolean; batchEnabled: boolean }): DynamicTaskSchema;
-export function getTaskSchema(options: {
-	isolationEnabled: boolean;
-	batchEnabled: boolean;
-	defaultAgent: string;
-}): TaskToolSchemaInstance;
+/** Build the task wire schema for the current settings and spawn policy. */
 export function getTaskSchema(options: {
 	isolationEnabled: boolean;
 	batchEnabled: boolean;
+	effortEnabled?: boolean;
 	defaultAgent?: string;
 }): TaskToolSchemaInstance {
 	const defaultAgent = options.defaultAgent ?? "task";
-	if (defaultAgent === "task") {
+	const effortEnabled = options.effortEnabled ?? false;
+	if (defaultAgent === "task" && !effortEnabled) {
 		if (options.batchEnabled) return options.isolationEnabled ? taskSchemaBatch : taskSchemaBatchNoIsolation;
 		return options.isolationEnabled ? taskSchema : taskSchemaNoIsolation;
 	}
-	const key = `${options.isolationEnabled ? "iso" : "flat"}:${options.batchEnabled ? "batch" : "single"}:${defaultAgent}`;
+	const key = `${options.isolationEnabled ? "iso" : "flat"}:${options.batchEnabled ? "batch" : "single"}:${effortEnabled ? "effort" : "default"}:${defaultAgent}`;
 	const cached = taskSchemaCache.get(key);
 	if (cached) return cached;
-	const schema = createTaskSchema({ ...options, defaultAgent });
+	const schema = createTaskSchema({ ...options, effortEnabled, defaultAgent });
 	taskSchemaCache.set(key, schema);
 	return schema;
 }

package/src/thinking.ts

@@ -271,19 +271,82 @@ export type TaskEffort = (typeof TASK_EFFORTS)[number];
  * at — high, xhigh, or max), `med` = the middle (lower of the two middles for
  * an even-sized range). Without a model, maps over the full canonical range.
  * Returns `undefined` when the model has no controllable effort surface, so
- * callers fall back to their default selector (e.g. `auto`).
+ * callers fall back to their default selector (e.g. `auto`). Throws when the
+ * configured ceiling is below the model's lowest supported effort.
  */
-export function resolveTaskEffortLevel(model: Model | undefined, effort: TaskEffort): Effort | undefined {
+export function resolveTaskEffortLevel(
+	model: Model | undefined,
+	effort: TaskEffort,
+	maxEffort?: Effort,
+): Effort | undefined {
 	const supported = model ? getSupportedEfforts(model) : THINKING_EFFORTS;
 	if (supported.length === 0) return undefined;
+	let resolved: Effort;
 	switch (effort) {
 		case "lo":
-			return supported[0];
+			resolved = supported[0];
+			break;
 		case "med":
-			return supported[(supported.length - 1) >> 1];
+			resolved = supported[(supported.length - 1) >> 1];
+			break;
 		case "hi":
-			return supported[supported.length - 1];
+			resolved = supported[supported.length - 1];
+			break;
+	}
+	if (maxEffort === undefined) return resolved;
+	const maxIndex = THINKING_EFFORTS.indexOf(maxEffort);
+	const ceiling = supported.findLast(candidate => THINKING_EFFORTS.indexOf(candidate) <= maxIndex);
+	if (ceiling === undefined) {
+		const modelName = model ? `${model.provider}/${model.id}` : "Selected model";
+		throw new RangeError(`${modelName} has no supported thinking effort at or below task.maxEffort=${maxEffort}`);
 	}
+	return THINKING_EFFORTS.indexOf(resolved) > THINKING_EFFORTS.indexOf(ceiling) ? ceiling : resolved;
+}
+
+/**
+ * Clamps a concrete thinking selector to a per-session effort ceiling (e.g. a
+ * task spawn's `task.maxEffort`-capped effort hint). `off`/`inherit`/
+ * `undefined` pass through, as do levels already at or below the ceiling.
+ * Levels above it snap to the highest model-supported effort at or below the
+ * ceiling. A model whose floor exceeds the ceiling has nothing valid to snap
+ * to; the requested level is returned unchanged and the caller is responsible
+ * for rejecting or skipping such models (see {@link modelSupportsEffortCeiling}).
+ */
+export function clampThinkingLevelToCeiling(
+	model: Model | undefined,
+	level: Effort | undefined,
+	ceiling: Effort | undefined,
+): Effort | undefined;
+export function clampThinkingLevelToCeiling(
+	model: Model | undefined,
+	level: ThinkingLevel | undefined,
+	ceiling: Effort | undefined,
+): ThinkingLevel | undefined;
+export function clampThinkingLevelToCeiling(
+	model: Model | undefined,
+	level: ThinkingLevel | undefined,
+	ceiling: Effort | undefined,
+): ThinkingLevel | undefined {
+	if (ceiling === undefined || level === undefined || level === ThinkingLevel.Off || level === ThinkingLevel.Inherit) {
+		return level;
+	}
+	const maxIndex = THINKING_EFFORTS.indexOf(ceiling);
+	if (THINKING_EFFORTS.indexOf(level) <= maxIndex) return level;
+	const supported = model ? getSupportedEfforts(model) : THINKING_EFFORTS;
+	return supported.findLast(candidate => THINKING_EFFORTS.indexOf(candidate) <= maxIndex) ?? level;
+}
+
+/**
+ * True when `model` can honor a thinking-effort ceiling: it either has no
+ * controllable effort surface (nothing to cap) or supports at least one effort
+ * at or below the ceiling. Retry-fallback candidate filtering uses this to
+ * skip models whose floor would force the session above the ceiling.
+ */
+export function modelSupportsEffortCeiling(model: Model, ceiling: Effort): boolean {
+	const supported = getSupportedEfforts(model);
+	if (supported.length === 0) return true;
+	const maxIndex = THINKING_EFFORTS.indexOf(ceiling);
+	return supported.some(candidate => THINKING_EFFORTS.indexOf(candidate) <= maxIndex);
 }
 
 /**

package/src/tools/read.ts

@@ -2250,12 +2250,12 @@ export class ReadTool implements AgentTool<typeof readSchema, ReadToolDetails> {
 			return executeReadUrl(this.session, { path: parsedUrlTarget.path, raw: urlRaw }, signal);
 		}
 
-		// Handle internal URLs (agent://, artifact://, memory://, skill://, rule://, local://, mcp://, omp://, issue://, pr://).
+		// Handle native OMP URLs and custom-scheme resources advertised by MCP servers.
 		// Use the internal-URL-aware splitter so malformed selectors are peeled
 		// off the URL and surfaced via parseSel rather than confusing handlers.
 		const internalRouter = InternalUrlRouter.instance();
 		let promotedSelector: string | undefined;
-		if (internalRouter.canHandle(readPath)) {
+		if (internalRouter.canResolve(readPath)) {
 			const internalTarget = splitInternalUrlSel(readPath);
 			const parsed = parseSel(internalTarget.sel);
 			if (internalTarget.sel !== undefined && parsed.kind === "none") {

package/src/utils/title-generator.ts

@@ -1,6 +1,7 @@
 /**
  * Generate session titles using a smol, fast model.
  */
+import { dlopen, FFIType, ptr } from "bun:ffi";
 import * as path from "node:path";
 
 import { type Api, type AssistantMessage, completeSimple, type Model } from "@oh-my-pi/pi-ai";
@@ -23,6 +24,59 @@ const TITLE_MARKER_INSTRUCTION = prompt.render(titleMarkerInstruction);
 const DEFAULT_TERMINAL_TITLE = "π";
 const TERMINAL_TITLE_CONTROL_CHARS = /[\u0000-\u001f\u007f-\u009f]/g;
 
+interface WindowsConsoleTitleApi {
+	set(title: string): boolean;
+	close(): void;
+}
+
+let windowsConsoleTitleApi: WindowsConsoleTitleApi | null | undefined;
+let lastTerminalTitle: string | undefined;
+
+function getWindowsConsoleTitleApi(): WindowsConsoleTitleApi | null {
+	if (process.platform !== "win32") return null;
+	if (windowsConsoleTitleApi !== undefined) return windowsConsoleTitleApi;
+	try {
+		const kernel32 = dlopen("kernel32.dll", {
+			SetConsoleTitleW: { args: [FFIType.ptr], returns: FFIType.bool },
+		});
+		windowsConsoleTitleApi = {
+			set(title) {
+				const wideTitle = Buffer.from(`${title}\0`, "utf16le");
+				return kernel32.symbols.SetConsoleTitleW(ptr(wideTitle));
+			},
+			close: () => kernel32.close(),
+		};
+	} catch {
+		windowsConsoleTitleApi = null;
+	}
+	return windowsConsoleTitleApi;
+}
+
+function setWindowsConsoleTitle(title: string): boolean {
+	const api = getWindowsConsoleTitleApi();
+	if (!api) return false;
+	try {
+		return api.set(title);
+	} catch {
+		try {
+			api.close();
+		} catch {
+			// Ignore cleanup failures after the native title path has already failed.
+		}
+		windowsConsoleTitleApi = null;
+		return false;
+	}
+}
+
+function disposeWindowsConsoleTitleApi(): void {
+	try {
+		windowsConsoleTitleApi?.close();
+	} catch {
+		// Terminal teardown must remain best-effort.
+	}
+	windowsConsoleTitleApi = undefined;
+}
+
 // Cover the "backend ignores `disableReasoning`" case unconditionally: the
 // static `model.reasoning` catalog flag can't distinguish a thinking model that
 // was declared with `reasoning: false` (e.g. Qwen3 served locally via llama.cpp,
@@ -379,11 +433,16 @@ export function formatSessionTerminalTitle(sessionName: string | undefined, cwd?
 }
 
 /**
- * Set the terminal title using OSC 0 (sets both tab and window title). Unsupported terminals ignore it.
+ * Set the terminal title through the native Win32 API or OSC 0.
+ *
+ * Repeating the same sanitized title is a no-op on every platform.
  */
 export function setTerminalTitle(title: string): void {
 	if (!process.stdout.isTTY || isTerminalHeadless()) return;
-	process.stdout.write(`\x1b]0;${sanitizeTerminalTitlePart(title) ?? DEFAULT_TERMINAL_TITLE}\x07`);
+	const next = sanitizeTerminalTitlePart(title) ?? DEFAULT_TERMINAL_TITLE;
+	if (next === lastTerminalTitle) return;
+	if (!setWindowsConsoleTitle(next)) process.stdout.write(`\x1b]0;${next}\x07`);
+	lastTerminalTitle = next;
 }
 
 export function setSessionTerminalTitle(sessionName: string | undefined, cwd?: string): void {
@@ -396,9 +455,9 @@ export function setSessionTerminalTitle(sessionName: string | undefined, cwd?: s
 
 /**
  * Set a terminal title from an extension's `setTitle()`. Unlike the session base
- * title, this owns the terminal verbatim: the run-state separator will not rewrite
- * it on the next spinner tick or state change. Cleared when the app next sets an
- * authoritative session title via {@link setSessionTerminalTitle}.
+ * title, this owns the terminal verbatim: periodic and run-state updates will not
+ * rewrite it. Cleared when the app next sets an authoritative session title via
+ * {@link setSessionTerminalTitle}.
  */
 export function setExtensionTerminalTitle(title: string): void {
 	terminalTitleRuntime.extensionOverride = title;
@@ -407,12 +466,9 @@ export function setExtensionTerminalTitle(title: string): void {
 
 export type TerminalTitleState = "idle" | "working" | "attention";
 
-/** Separator glyphs carrying the run state between the `π` brand and the session
- *  label — the brand itself stays bare (no prefix glyph). Spinner frames animate
- *  the separator while working; they are self-contained (not the theme's symbol
- *  set) to avoid a utils→modes import cycle; OSC titles render in tab/window bars
- *  that handle Unicode. */
-const TITLE_SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"] as const;
+/** Windows uses a static working separator instead of scheduling title animation. */
+const WINDOWS_TITLE_WORKING_SEPARATOR = ":";
+const TITLE_SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 const TITLE_SPINNER_INTERVAL_MS = 80;
 /** The user's turn: the title reads like a shell prompt awaiting input. */
 const TITLE_IDLE_SEPARATOR = ">";
@@ -425,7 +481,6 @@ const terminalTitleRuntime: {
 	frame: number;
 	enabled: boolean;
 	timer: NodeJS.Timeout | undefined;
-	lastEmitted: string | undefined;
 	/** A title an extension set via `setTitle()`. While set, it owns the terminal
 	 *  title verbatim: the run-state separator never rewrites it. Cleared when the
 	 *  app next establishes an authoritative session title (rename, new session,
@@ -437,19 +492,16 @@ const terminalTitleRuntime: {
 	frame: 0,
 	enabled: true,
 	timer: undefined,
-	lastEmitted: undefined,
 	extensionOverride: undefined,
 };
 
 /**
- * Compose the terminal title from the `π` brand, a state-carrying SEPARATOR, and
- * the session label. The brand never gains a prefix glyph — the separator slot
- * expresses the run state instead. Pure (no I/O) so the state→separator contract
- * is unit-testable:
- *   - `idle` (user's turn):  `π > label`  — reads like a prompt awaiting input;
- *   - `working`:             `π ⠋ label`  — spinner frames animate the separator;
- *   - `attention`:           `π ! label`  — agent blocked on the user;
- *   - disabled:              `π: label`   — the pre-state layout.
+ * Compose the terminal title from the `π` brand, a state-carrying separator, and
+ * the session label. Pure (no I/O) so the state→separator contract is testable:
+ *   - `idle` (user's turn):  `π > label`;
+ *   - `working`:             `π ⠋ label` (`π : label` on Windows);
+ *   - `attention`:           `π ! label`;
+ *   - disabled:              `π: label`.
  * Without a label the separator trails the brand (`π >`) so the state stays visible.
  */
 export function buildTerminalTitleWithState(
@@ -457,11 +509,14 @@ export function buildTerminalTitleWithState(
 	state: TerminalTitleState,
 	frame: number,
 	enabled: boolean,
+	platform: NodeJS.Platform = process.platform,
 ): string {
 	if (!enabled) return label ? `${DEFAULT_TERMINAL_TITLE}: ${label}` : DEFAULT_TERMINAL_TITLE;
 	const separator =
 		state === "working"
-			? TITLE_SPINNER_FRAMES[frame % TITLE_SPINNER_FRAMES.length]
+			? platform === "win32"
+				? WINDOWS_TITLE_WORKING_SEPARATOR
+				: TITLE_SPINNER_FRAMES[frame % TITLE_SPINNER_FRAMES.length]
 			: state === "attention"
 				? TITLE_ATTENTION_SEPARATOR
 				: TITLE_IDLE_SEPARATOR;
@@ -469,8 +524,8 @@ export function buildTerminalTitleWithState(
 }
 
 function emitTerminalTitle(): void {
-	// An extension override owns the terminal verbatim; the run-state separator and
-	// spinner ticks must not clobber it (still deduped via lastEmitted).
+	// An extension override owns the terminal verbatim; the terminal sink
+	// deduplicates repeated state updates.
 	const next =
 		terminalTitleRuntime.extensionOverride ??
 		buildTerminalTitleWithState(
@@ -479,20 +534,16 @@ function emitTerminalTitle(): void {
 			terminalTitleRuntime.frame,
 			terminalTitleRuntime.enabled,
 		);
-	if (next === terminalTitleRuntime.lastEmitted) return;
-	terminalTitleRuntime.lastEmitted = next;
 	setTerminalTitle(next);
 }
 
 function stopTerminalTitleSpinner(): void {
-	if (terminalTitleRuntime.timer) {
-		clearInterval(terminalTitleRuntime.timer);
-		terminalTitleRuntime.timer = undefined;
-	}
+	clearInterval(terminalTitleRuntime.timer);
+	terminalTitleRuntime.timer = undefined;
 }
 
 function startTerminalTitleSpinner(): void {
-	if (terminalTitleRuntime.timer || !process.stdout.isTTY) return;
+	if (process.platform === "win32" || terminalTitleRuntime.timer || !process.stdout.isTTY) return;
 	terminalTitleRuntime.timer = setInterval(() => {
 		terminalTitleRuntime.frame = (terminalTitleRuntime.frame + 1) % TITLE_SPINNER_FRAMES.length;
 		emitTerminalTitle();
@@ -503,8 +554,9 @@ function startTerminalTitleSpinner(): void {
 
 /**
  * Reflect the agent run state in the terminal title's separator: `working`
- * animates spinner frames in the separator slot, `idle` shows `>` (your turn),
- * `attention` shows `!` (agent blocked on you). Gated off by `tui.titleState`.
+ * animates outside Windows and stays `:` on Windows, `idle` shows `>` (your
+ * turn), and `attention` shows `!` (agent blocked on you). Gated off by
+ * `tui.titleState`.
  */
 export function setTerminalTitleState(state: TerminalTitleState): void {
 	terminalTitleRuntime.state = state;
@@ -521,9 +573,11 @@ export function setTerminalTitleStateEnabled(enabled: boolean): void {
 	emitTerminalTitle();
 }
 
-/** Stop the spinner timer; call on session/UI teardown. */
+/** Release terminal-title runtime resources. */
 export function disposeTerminalTitleState(): void {
 	stopTerminalTitleSpinner();
+	disposeWindowsConsoleTitleApi();
+	lastTerminalTitle = undefined;
 }
 
 /**

package/dist/types/advisor/__tests__/advisor.test.d.ts

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

package/dist/types/advisor/__tests__/config.test.d.ts

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

package/dist/types/advisor/__tests__/emission-guard.test.d.ts

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

package/dist/types/cli/__tests__/auth-gateway-catalog.test.d.ts

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

package/dist/types/cli/update-cli.test.d.ts

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

package/dist/types/config/__tests__/model-registry.test.d.ts

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

package/dist/types/eval/__tests__/agent-bridge.test.d.ts

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

package/dist/types/eval/__tests__/bridge-timeout.test.d.ts

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

package/dist/types/eval/__tests__/budget-bridge.test.d.ts

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

package/dist/types/eval/__tests__/completion-bridge.test.d.ts

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

package/dist/types/eval/__tests__/helpers-local-roots.test.d.ts

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

package/dist/types/eval/__tests__/idle-timeout.test.d.ts

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

package/dist/types/eval/__tests__/js-context-manager.test.d.ts

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

package/dist/types/eval/__tests__/julia-prelude.test.d.ts

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

package/dist/types/eval/__tests__/kernel-spawn.test.d.ts

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

package/dist/types/eval/__tests__/prelude-agent.test.d.ts

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

package/dist/types/eval/__tests__/process-entry-import.test.d.ts

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

package/dist/types/eval/py/__tests__/prelude.test.d.ts

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

package/dist/types/eval/py/__tests__/runner-shell-output.test.d.ts

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

package/dist/types/hindsight/client.test.d.ts

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

package/dist/types/internal-urls/__tests__/agent-protocol-nested.test.d.ts

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

package/dist/types/internal-urls/__tests__/ssh-protocol.test.d.ts

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

package/dist/types/launch/broker-list-order.test.d.ts

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

package/dist/types/launch/broker-output-snapshot.test.d.ts

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

package/dist/types/launch/protocol.test.d.ts

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

package/dist/types/launch/spawn-options.test.d.ts

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

package/dist/types/launch/terminal-output.test.d.ts

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

package/dist/types/live/protocol.test.d.ts

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

package/dist/types/mcp/config-writer.test.d.ts

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

package/dist/types/mcp/smithery-auth.test.d.ts

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

package/dist/types/mcp/smithery-registry.test.d.ts

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