@selesai/code 0.10.2 → 0.12.0

package/dist/core/messages.js

@@ -4,15 +4,15 @@
  * Extends the base AgentMessage type with coding-agent specific message types,
  * and provides a transformer to convert them to LLM-compatible messages.
  */
-export const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:
-
-<summary>
+export const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:
+
+<summary>
 `;
-export const COMPACTION_SUMMARY_SUFFIX = `
+export const COMPACTION_SUMMARY_SUFFIX = `
 </summary>`;
-export const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:
-
-<summary>
+export const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:
+
+<summary>
 `;
 export const BRANCH_SUMMARY_SUFFIX = `</summary>`;
 /**

package/dist/core/session-manager.js

@@ -279,11 +279,11 @@ export function loadEntriesFromFile(filePath) {
     if (!existsSync(resolvedFilePath))
         return [];
     const entries = [];
+    let pending = "";
     const fd = openSync(resolvedFilePath, "r");
     try {
         const decoder = new StringDecoder("utf8");
         const buffer = Buffer.allocUnsafe(SESSION_READ_BUFFER_SIZE);
-        let pending = "";
         while (true) {
             const bytesRead = readSync(fd, buffer, 0, buffer.length, null);
             if (bytesRead === 0)
@@ -308,13 +308,15 @@ export function loadEntriesFromFile(filePath) {
     finally {
         closeSync(fd);
     }
-    // Validate session header
+    // Validate session header before repairing the file.
     if (entries.length === 0)
         return entries;
     const header = entries[0];
     if (header.type !== "session" || typeof header.id !== "string") {
         return [];
     }
+    if (pending)
+        appendFileSync(resolvedFilePath, "\n");
     return entries;
 }
 /**

package/dist/core/settings-manager.d.ts

@@ -1,6 +1,6 @@
 import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
 import type { Transport } from "@earendil-works/pi-ai";
-import type { ScrollViewScrollbar, TuiMode as RendererTuiMode } from "@earendil-works/pi-tui";
+import type { ScrollViewScrollbar, TerminalCapabilities, TuiMode as RendererTuiMode } from "@earendil-works/pi-tui";
 export interface CompactionSettings {
     enabled?: boolean;
     reserveTokens?: number;
@@ -28,6 +28,9 @@ export interface TerminalSettings {
     imageWidthCells?: number;
     clearOnShrink?: boolean;
     showTerminalProgress?: boolean;
+    hyperlinks?: boolean | "auto";
+    images?: "kitty" | "iterm2" | "auto" | false;
+    trueColor?: boolean | "auto";
 }
 export interface ImageSettings {
     autoResize?: boolean;
@@ -104,6 +107,7 @@ export interface Settings {
     defaultTools?: string[];
     fullscreenExitOutput?: FullscreenExitOutput;
     fullscreenScrollbar?: ScrollViewScrollbar;
+    fullscreenCopyOnSelect?: boolean;
     images?: ImageSettings;
     enabledModels?: string[];
     doubleEscapeAction?: "fork" | "tree" | "none";
@@ -285,6 +289,7 @@ export declare class SettingsManager {
     setThemePaths(paths: string[]): void;
     setProjectThemePaths(paths: string[]): void;
     getThinkingBudgets(): ThinkingBudgetsSettings | undefined;
+    getTerminalCapabilityOverrides(): Partial<TerminalCapabilities>;
     getShowImages(): boolean;
     setShowImages(show: boolean): void;
     getImageWidthCells(): number;
@@ -299,6 +304,8 @@ export declare class SettingsManager {
     setFullscreenScrollbar(mode: ScrollViewScrollbar): void;
     getFullscreenExitOutput(): FullscreenExitOutput;
     setFullscreenExitOutput(output: FullscreenExitOutput): void;
+    getFullscreenCopyOnSelect(): boolean;
+    setFullscreenCopyOnSelect(enabled: boolean): void;
     getImageAutoResize(): boolean;
     setImageAutoResize(enabled: boolean): void;
     getBlockImages(): boolean;

package/dist/core/settings-manager.js

@@ -786,6 +786,15 @@ export class SettingsManager {
     getThinkingBudgets() {
         return this.settings.thinkingBudgets;
     }
+    getTerminalCapabilityOverrides() {
+        const terminal = this.settings.terminal;
+        const images = terminal?.images;
+        return {
+            ...(images === "kitty" || images === "iterm2" ? { images } : images === false ? { images: null } : {}),
+            ...(typeof terminal?.trueColor === "boolean" ? { trueColor: terminal.trueColor } : {}),
+            ...(typeof terminal?.hyperlinks === "boolean" ? { hyperlinks: terminal.hyperlinks } : {}),
+        };
+    }
     getShowImages() {
         return this.settings.terminal?.showImages ?? true;
     }
@@ -864,6 +873,14 @@ export class SettingsManager {
         this.markModified("fullscreenExitOutput");
         this.save();
     }
+    getFullscreenCopyOnSelect() {
+        return this.settings.fullscreenCopyOnSelect ?? true;
+    }
+    setFullscreenCopyOnSelect(enabled) {
+        this.globalSettings.fullscreenCopyOnSelect = enabled;
+        this.markModified("fullscreenCopyOnSelect");
+        this.save();
+    }
     getImageAutoResize() {
         return this.settings.images?.autoResize ?? true;
     }

package/dist/defaults/models.json

@@ -24,7 +24,10 @@
             "high": "high",
             "xhigh": null,
             "max": "max"
-          }
+          },
+          "compat": {
+            "requiresReasoningContentOnAssistantMessages": true
+            }
         },
         {
           "id": "celestial-max",
@@ -40,7 +43,10 @@
             "high": "high",
             "xhigh": null,
             "max": "max"
-          }
+          },
+          "compat": {
+            "requiresReasoningContentOnAssistantMessages": true
+            }
         },
         {
           "id": "celestial-ultra",
@@ -56,7 +62,10 @@
             "high": "high",
             "xhigh": null,
             "max": "max"
-          }
+          },
+          "compat": {
+            "requiresReasoningContentOnAssistantMessages": true
+            }
         },
         {
           "id": "deepseek-v4-flash",
@@ -72,7 +81,10 @@
             "high": "high",
             "xhigh": null,
             "max": "max"
-          }
+          },
+          "compat": {
+            "requiresReasoningContentOnAssistantMessages": true
+            }
         },
         {
           "id": "deepseek-v4-flash-vision-exp",
@@ -88,7 +100,10 @@
             "high": "high",
             "xhigh": null,
             "max": "max"
-          }
+          },
+          "compat": {
+            "requiresReasoningContentOnAssistantMessages": true
+            }
         },
         {
           "id": "deepseek-v4-pro",
@@ -104,7 +119,10 @@
             "high": "high",
             "xhigh": null,
             "max": "max"
-          }
+          },
+          "compat": {
+            "requiresReasoningContentOnAssistantMessages": true
+            }
         },
         {
           "id": "gpt-5.6-luna",
@@ -200,7 +218,10 @@
           "reasoning": false,
           "input": ["text", "image"],
           "contextWindow": 256000,
-          "maxTokens": 64000
+          "maxTokens": 64000,
+          "compat": {
+            "thinkingFormat": "qwen"
+          }
         },
         {
           "id": "gemini-3.7-flash",
@@ -219,7 +240,8 @@
           "maxTokens": 8192,
           "compat": {
             "supportsDeveloperRole": false,
-            "supportsReasoningEffort": false
+            "supportsReasoningEffort": false,
+            "thinkingFormat": "qwen"
           }
         },
         {
@@ -231,7 +253,8 @@
           "maxTokens": 8192,
           "compat": {
             "supportsDeveloperRole": false,
-            "supportsReasoningEffort": false
+            "supportsReasoningEffort": false,
+            "thinkingFormat": "qwen"
           }
         }
       ]

package/dist/defaults/settings.json

@@ -23,9 +23,6 @@
     "imageCaptionModel": "tokenin/qwen3.8-27b",
     "imageCaptionContextTokens": 16384
   },
-  "packages": [
-    "git:github.com/MasuRii/pi-tool-display"
-  ],
   "quietStartup": true,
   "retry": {
     "enabled": true,

package/dist/extensions/auto-session-name.test.ts

@@ -0,0 +1,157 @@
+import { describe, expect, it, vi } from "vitest";
+import type { ExtensionAPI, ExtensionContext, SessionEntry } from "@selesai/code";
+import autoSessionNameExtension, {
+	MAX_MESSAGE_CHARS,
+	MAX_NAME_WORDS,
+	MAX_PREVIOUS_MESSAGES,
+	NAMING_MAX_TOKENS,
+	NAMING_SYSTEM_PROMPT,
+	previousUserMessages,
+} from "./auto-session-name.ts";
+
+vi.mock("@earendil-works/pi-ai/compat", async (importOriginal) => {
+	const actual = await importOriginal<typeof import("@earendil-works/pi-ai/compat")>();
+	return {
+		...actual,
+		complete: vi.fn(),
+	};
+});
+
+import { complete } from "@earendil-works/pi-ai/compat";
+const completeMock = vi.mocked(complete);
+
+type Handler = (event: unknown, ctx: ExtensionContext) => void | Promise<void>;
+
+function userEntry(text: string, id: string): SessionEntry {
+	return {
+		id,
+		type: "message",
+		message: { role: "user", content: [{ type: "text", text }], timestamp: 100 },
+		parentId: "root",
+		timestamp: "2025-01-01T00:00:00.000Z",
+	} as unknown as SessionEntry;
+}
+
+function createHarness(branch: SessionEntry[] = []) {
+	const handlers = new Map<string, Handler>();
+	const setSessionName = vi.fn();
+	const pi = {
+		on: vi.fn((event: string, handler: Handler) => handlers.set(event, handler)),
+		setSessionName,
+	} as unknown as ExtensionAPI;
+	const model = { provider: "openai", id: "gpt-5", name: "GPT-5" };
+	const ctx = {
+		model,
+		modelRegistry: {
+			getApiKeyAndHeaders: vi.fn().mockResolvedValue({ ok: true, apiKey: "key", headers: {} }),
+		},
+		sessionManager: { getBranch: () => branch },
+	} as unknown as ExtensionContext;
+
+	autoSessionNameExtension(pi);
+	return { handlers, setSessionName, ctx };
+}
+
+function textResponse(text: string) {
+	return {
+		content: [{ type: "text", text }],
+		stopReason: "stop",
+		usage: { input: 0, output: 0 },
+	} as never;
+}
+
+describe("auto-session-name", () => {
+	beforeEach(() => {
+		vi.clearAllMocks();
+	});
+
+	it("registers an input handler", () => {
+		const { handlers } = createHarness();
+		expect(handlers.has("input")).toBe(true);
+	});
+
+	it("names the session from the user prompt with a small system prompt and 10-token cap", async () => {
+		const { handlers, setSessionName, ctx } = createHarness();
+		completeMock.mockResolvedValue(textResponse("Refactor auth"));
+
+		await handlers.get("input")!({ type: "input", text: "refactor the auth module", source: "interactive" }, ctx);
+		await vi.waitFor(() => expect(setSessionName).toHaveBeenCalledWith("Refactor auth"));
+
+		expect(completeMock).toHaveBeenCalledTimes(1);
+		const [model, context, options] = completeMock.mock.calls[0];
+		expect(model).toBe(ctx.model);
+		expect(context.systemPrompt).toBe(NAMING_SYSTEM_PROMPT);
+		expect(context.messages).toHaveLength(1);
+		expect(context.messages[0].role).toBe("user");
+		expect(context.messages[0].content).toBe("refactor the auth module");
+		expect(options?.maxTokens).toBe(NAMING_MAX_TOKENS);
+		expect(options?.samplingParams).toEqual({ reasoning_effort: "none" });
+		expect(setSessionName).toHaveBeenCalledWith("Refactor auth");
+	});
+
+	it("caps the name at 5 words even if the model returns more", async () => {
+		const { handlers, setSessionName, ctx } = createHarness();
+		completeMock.mockResolvedValue(textResponse("one two three four five six seven"));
+
+		await handlers.get("input")!({ type: "input", text: "hello", source: "interactive" }, ctx);
+		await vi.waitFor(() => expect(setSessionName).toHaveBeenCalledWith("one two three four five"));
+
+		expect(setSessionName.mock.calls[0][0].split(/\s+/)).toHaveLength(MAX_NAME_WORDS);
+	});
+
+	it("includes previous user messages (newest first) for context", async () => {
+		const branch = [userEntry("first message", "u1"), userEntry("second message", "u2")];
+		const { handlers, ctx } = createHarness(branch);
+		completeMock.mockResolvedValue(textResponse("Auth refactor"));
+
+		await handlers.get("input")!({ type: "input", text: "now fix the tests", source: "interactive" }, ctx);
+
+		const [, context] = completeMock.mock.calls[0];
+		expect(context.messages[0].content).toBe("second message\nfirst message\nnow fix the tests");
+	});
+
+	it("truncates long previous messages and caps the count", () => {
+		const long = "x".repeat(MAX_MESSAGE_CHARS + 50);
+		const branch = Array.from({ length: MAX_PREVIOUS_MESSAGES + 5 }, (_, i) =>
+			userEntry(i === MAX_PREVIOUS_MESSAGES + 4 ? long : `msg ${i}`, `u${i}`),
+		);
+		const texts = previousUserMessages({ getBranch: () => branch });
+
+		expect(texts).toHaveLength(MAX_PREVIOUS_MESSAGES);
+		expect(texts[0]).toBe(`${"x".repeat(MAX_MESSAGE_CHARS)}…`);
+		expect(texts[1]).toBe("msg 23");
+	});
+
+	it("skips extension-sourced input, commands, and empty text", async () => {
+		const { handlers, setSessionName, ctx } = createHarness();
+
+		await handlers.get("input")!({ type: "input", text: "hi", source: "extension" }, ctx);
+		await handlers.get("input")!({ type: "input", text: "/name foo", source: "interactive" }, ctx);
+		await handlers.get("input")!({ type: "input", text: "   ", source: "interactive" }, ctx);
+
+		expect(completeMock).not.toHaveBeenCalled();
+		expect(setSessionName).not.toHaveBeenCalled();
+	});
+
+	it("does not set a name when the model returns no text", async () => {
+		const { handlers, setSessionName, ctx } = createHarness();
+		completeMock.mockResolvedValue({ content: [], stopReason: "stop" } as never);
+
+		await handlers.get("input")!({ type: "input", text: "hello", source: "interactive" }, ctx);
+
+		expect(setSessionName).not.toHaveBeenCalled();
+	});
+
+	it("swallows auth and completion errors without breaking the message flow", async () => {
+		const { handlers, setSessionName, ctx } = createHarness();
+		ctx.modelRegistry.getApiKeyAndHeaders = vi.fn().mockResolvedValue({ ok: false, error: "no key" });
+		await handlers.get("input")!({ type: "input", text: "hello", source: "interactive" }, ctx);
+		expect(setSessionName).not.toHaveBeenCalled();
+
+		ctx.modelRegistry.getApiKeyAndHeaders = vi.fn().mockResolvedValue({ ok: true, apiKey: "key" });
+		completeMock.mockRejectedValue(new Error("boom"));
+		await handlers.get("input")!({ type: "input", text: "hello", source: "interactive" }, ctx);
+		await vi.waitFor(() => expect(completeMock).toHaveBeenCalled());
+		expect(setSessionName).not.toHaveBeenCalled();
+	});
+});

package/dist/extensions/auto-session-name.ts

@@ -0,0 +1,96 @@
+/**
+ * auto-session-name
+ *
+ * Names the session on every user message using the currently selected model.
+ * Sends only user messages (current prompt plus previous user messages,
+ * truncated) for context, capped at 10 output tokens (1-5 word name).
+ * Thinking is never enabled. Equivalent to running /name automatically.
+ */
+
+import { complete } from "@earendil-works/pi-ai/compat";
+import type { ExtensionAPI, SessionEntry } from "@selesai/code";
+
+export const NAMING_SYSTEM_PROMPT =
+	"Reply with only a short session name (1-5 words) for this conversation based on the user's messages. No punctuation, no quotes, no explanation.";
+
+export const NAMING_MAX_TOKENS = 10;
+/** Hard cap on the name itself: at most 5 words (≈5 tokens). */
+export const MAX_NAME_WORDS = 5;
+/** How many previous user messages to include, newest first. */
+export const MAX_PREVIOUS_MESSAGES = 20;
+/** Per-message character cap when truncating. */
+export const MAX_MESSAGE_CHARS = 200;
+
+function truncate(text: string): string {
+	return text.length > MAX_MESSAGE_CHARS ? `${text.slice(0, MAX_MESSAGE_CHARS)}…` : text;
+}
+
+/** Collect previous user message texts from the session branch, newest first, truncated. */
+export function previousUserMessages(sessionManager: { getBranch(): SessionEntry[] }): string[] {
+	const branch = sessionManager.getBranch();
+	const texts: string[] = [];
+	for (let i = branch.length - 1; i >= 0 && texts.length < MAX_PREVIOUS_MESSAGES; i--) {
+		const entry = branch[i];
+		if (entry.type !== "message" || entry.message.role !== "user") continue;
+		const content = entry.message.content;
+		const text = typeof content === "string" ? content : content
+			.filter((c): c is { type: "text"; text: string } => c.type === "text")
+			.map((c) => c.text)
+			.join("\n");
+		if (text.trim()) texts.push(truncate(text.trim()));
+	}
+	return texts;
+}
+
+export default function autoSessionNameExtension(pi: ExtensionAPI): void {
+	// Guards run synchronously; the naming call itself is fire-and-forget so it
+	// never blocks the user's message from being sent.
+	let namingSeq = 0;
+	pi.on("input", (event, ctx) => {
+		// Only real user messages; skip extension-sourced messages and commands.
+		if (event.source === "extension") return;
+		const text = event.text.trim();
+		if (!text || text.startsWith("/")) return;
+		if (!ctx.model) return;
+
+		const seq = ++namingSeq;
+		void (async () => {
+			try {
+				const auth = await ctx.modelRegistry.getApiKeyAndHeaders(ctx.model);
+				if (!auth.ok || !auth.apiKey) return;
+
+				const previous = previousUserMessages(ctx.sessionManager);
+				const conversation = [...previous, text].join("\n");
+
+				const response = await complete(
+					ctx.model,
+					{
+						systemPrompt: NAMING_SYSTEM_PROMPT,
+						messages: [{ role: "user", content: conversation, timestamp: Date.now() }],
+					},
+					{
+						apiKey: auth.apiKey,
+						headers: auth.headers,
+						maxTokens: NAMING_MAX_TOKENS,
+						cacheRetention: "none",
+						// The tokenin gateway ignores `thinking: {type:"disabled"}` and burns the
+						// whole budget on reasoning; `reasoning_effort: "none"` is what disables it.
+						samplingParams: { reasoning_effort: "none" },
+					},
+				);
+				const name = response.content
+					.filter((c): c is { type: "text"; text: string } => c.type === "text")
+					.map((c) => c.text)
+					.join("")
+					.trim()
+					.split(/\s+/)
+					.slice(0, MAX_NAME_WORDS)
+					.join(" ");
+				// Only the latest request may set the name; slower older responses lose.
+				if (name && seq === namingSeq) pi.setSessionName(name);
+			} catch {
+				// Best-effort naming; never break the user's message flow.
+			}
+		})();
+	});
+}

package/dist/extensions/context-compaction-reminder.test.ts

@@ -1,82 +1,82 @@
-import { describe, expect, it, vi } from "vitest";
-import type { ExtensionAPI, ExtensionContext } from "@selesai/code";
-import contextCompactionReminderExtension, {
-	CONTEXT_COMPACTION_REMINDER_MESSAGE,
-} from "./context-compaction-reminder.ts";
-
-type Handler = (event: unknown, ctx: ExtensionContext) => void | Promise<void>;
-
-function createHarness(tokens: number | null | undefined = undefined) {
-	const handlers = new Map<string, Handler>();
-	const notify = vi.fn();
-	const pi = {
-		on: vi.fn((event: string, handler: Handler) => handlers.set(event, handler)),
-	} as unknown as ExtensionAPI;
-	const ctx = {
-		getContextUsage: () =>
-			tokens === undefined ? undefined : { tokens, contextWindow: 200_000, percent: tokens === null ? null : tokens / 2_000 },
-		ui: { notify },
-	} as unknown as ExtensionContext;
-
-	contextCompactionReminderExtension(pi);
-
-	return {
-		notify,
-		setTokens: (value: number | null | undefined) => {
-			tokens = value;
-		},
-		settle: () => handlers.get("agent_settled")!({ type: "agent_settled" }, ctx),
-		compact: () => handlers.get("session_compact")!({ type: "session_compact" }, ctx),
-	};
-}
-
-describe("context-compaction-reminder", () => {
-	it("warns once when known context reaches 128k", async () => {
-		const { notify, setTokens, settle } = createHarness(127_999);
-
-		await settle();
-		setTokens(128_000);
-		await settle();
-		setTokens(130_000);
-		await settle();
-
-		expect(notify).toHaveBeenCalledTimes(1);
-		expect(notify).toHaveBeenCalledWith(CONTEXT_COMPACTION_REMINDER_MESSAGE, "warning");
-	});
-
-	it("does not reset the reminder for unavailable or post-compaction usage", async () => {
-		const { notify, setTokens, settle } = createHarness(128_000);
-
-		await settle();
-		setTokens(undefined);
-		await settle();
-		setTokens(null);
-		await settle();
-		setTokens(130_000);
-		await settle();
-
-		expect(notify).toHaveBeenCalledTimes(1);
-	});
-
-	it("allows another warning after successful compaction", async () => {
-		const { notify, settle, compact } = createHarness(128_000);
-
-		await settle();
-		await compact();
-		await settle();
-
-		expect(notify).toHaveBeenCalledTimes(2);
-	});
-
-	it("allows another warning after known usage drops below 128k", async () => {
-		const { notify, setTokens, settle } = createHarness(128_000);
-
-		await settle();
-		setTokens(127_999);
-		await settle();
-		setTokens(128_000);
-		await settle();
-
-		expect(notify).toHaveBeenCalledTimes(2);
-	});
-});
+import { describe, expect, it, vi } from "vitest";
+import type { ExtensionAPI, ExtensionContext } from "@selesai/code";
+import contextCompactionReminderExtension, {
+	CONTEXT_COMPACTION_REMINDER_MESSAGE,
+} from "./context-compaction-reminder.ts";
+
+type Handler = (event: unknown, ctx: ExtensionContext) => void | Promise<void>;
+
+function createHarness(tokens: number | null | undefined = undefined) {
+	const handlers = new Map<string, Handler>();
+	const notify = vi.fn();
+	const pi = {
+		on: vi.fn((event: string, handler: Handler) => handlers.set(event, handler)),
+	} as unknown as ExtensionAPI;
+	const ctx = {
+		getContextUsage: () =>
+			tokens === undefined ? undefined : { tokens, contextWindow: 200_000, percent: tokens === null ? null : tokens / 2_000 },
+		ui: { notify },
+	} as unknown as ExtensionContext;
+
+	contextCompactionReminderExtension(pi);
+
+	return {
+		notify,
+		setTokens: (value: number | null | undefined) => {
+			tokens = value;
+		},
+		settle: () => handlers.get("agent_settled")!({ type: "agent_settled" }, ctx),
+		compact: () => handlers.get("session_compact")!({ type: "session_compact" }, ctx),
+	};
+}
+
+describe("context-compaction-reminder", () => {
+	it("warns once when known context reaches 128k", async () => {
+		const { notify, setTokens, settle } = createHarness(127_999);
+
+		await settle();
+		setTokens(128_000);
+		await settle();
+		setTokens(130_000);
+		await settle();
+
+		expect(notify).toHaveBeenCalledTimes(1);
+		expect(notify).toHaveBeenCalledWith(CONTEXT_COMPACTION_REMINDER_MESSAGE, "warning");
+	});
+
+	it("does not reset the reminder for unavailable or post-compaction usage", async () => {
+		const { notify, setTokens, settle } = createHarness(128_000);
+
+		await settle();
+		setTokens(undefined);
+		await settle();
+		setTokens(null);
+		await settle();
+		setTokens(130_000);
+		await settle();
+
+		expect(notify).toHaveBeenCalledTimes(1);
+	});
+
+	it("allows another warning after successful compaction", async () => {
+		const { notify, settle, compact } = createHarness(128_000);
+
+		await settle();
+		await compact();
+		await settle();
+
+		expect(notify).toHaveBeenCalledTimes(2);
+	});
+
+	it("allows another warning after known usage drops below 128k", async () => {
+		const { notify, setTokens, settle } = createHarness(128_000);
+
+		await settle();
+		setTokens(127_999);
+		await settle();
+		setTokens(128_000);
+		await settle();
+
+		expect(notify).toHaveBeenCalledTimes(2);
+	});
+});