pi-idle 1.0.0

package/.github/workflows/test.yml

@@ -0,0 +1,18 @@
+name: Test
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - run: npm install
+      - run: npm test

package/.gitleaks.toml

@@ -0,0 +1,84 @@
+# Gitleaks configuration for pi-idle extension repository.
+# This is a Node.js / TypeScript project with no secrets expected.
+
+title = "pi-idle gitleaks config"
+
+# Extend the default ruleset. Rules are defined inline below.
+# We keep only the rules that are relevant for a small TS project
+# and add custom allowlists to avoid false positives.
+
+[allowlist]
+description = "Global allowlist – paths and patterns to skip"
+paths = [
+  # Standard ignores
+  ".git/",
+  "node_modules/",
+  "package-lock.json",
+  "pnpm-lock.yaml",
+  "bun.lock",
+  "bun.lockb",
+  # Test files may contain fake credentials
+  "test.ts",
+]
+# Regex patterns to ignore globally
+regexes = []
+
+# ── Specific rules ──────────────────────────────────────────────────
+
+[[rules]]
+id = "generic-api-key"
+description = "Generic API Key"
+regex = '''(?i)(?:key|token|secret|password|credential|auth|bearer|apikey|api[_-]?key)(?:'s)?\s*(?:=|:)\s*['"]([0-9a-zA-Z\-_.+/]{8,})['"]'''
+tags = ["key", "API", "generic"]
+
+[[rules]]
+id = "aws-access-key"
+description = "AWS Access Key ID"
+regex = '''(?:A3T[A-Z0-9]|AKIA|AGPA|AIDA|AROA|AIPA|ANPA|ANVA|ASIA)[A-Z0-9]{16}'''
+tags = ["key", "AWS"]
+
+[[rules]]
+id = "aws-secret-key"
+description = "AWS Secret Key"
+regex = '''(?i)aws[_-]?(?:secret|access)[_-]?key\s*(?:=|:)\s*['"]([A-Za-z0-9/\+=]{40})['"]'''
+tags = ["key", "AWS"]
+
+[[rules]]
+id = "github-token"
+description = "GitHub Personal Access Token"
+regex = '''(?:ghp|gho|ghu|ghs|ghr)[A-Za-z0-9_]{36}'''
+tags = ["key", "GitHub"]
+
+[[rules]]
+id = "github-fine-grained-token"
+description = "GitHub Fine-Grained Access Token"
+regex = '''github_pat_[A-Za-z0-9_]{82}'''
+tags = ["key", "GitHub"]
+
+[[rules]]
+id = "google-api-key"
+description = "Google API Key"
+regex = '''AIza[0-9A-Za-z\-_]{35}'''
+tags = ["key", "Google"]
+
+[[rules]]
+id = "slack-token"
+description = "Slack Token"
+regex = '''xox[baprs]-[0-9a-zA-Z\-]{10,72}'''
+tags = ["key", "Slack"]
+
+[[rules]]
+id = "private-key"
+description = "Private Key"
+regex = '''-----BEGIN\s?(RSA|DSA|EC|OPENSSH|SSH2|PGP|PRIVATE)\s?KEY[-----]'''
+tags = ["key", "private"]
+
+[[rules]]
+id = "npm-token"
+description = "npm Access Token"
+regex = '''npm_[A-Za-z0-9]{36}'''
+tags = ["key", "npm"]
+
+# ── Repository-specific allowlists ──────────────────────────────────
+
+# (Add path- or regex-based overrides here as needed.)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ZoRDoK
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PLAN.md

@@ -0,0 +1,89 @@
+# Plan: Idle Indicator Extension for Pi
+
+## Context
+
+Создать расширение для Pi agent harness (`pi-idle.ts`), которое ставит зелёную текстовую галочку слева от текущего заголовка терминала, когда сессия завершена и ожидает ввод пользователя. Когда пользователь начинает работать (отправляет промпт), галочка заменяется на текстовый квадратный спиннер. Когда агент заканчивает ответ — снова зелёная галочка.
+
+## Approach
+
+Одним файлом TypeScript-расширения `pi-idle.ts`, которое:
+
+- Подписывается на события `session_start`, `input` и `agent_end`
+- Использует `ctx.ui.setTitle()` для обновления заголовка терминала
+- **Не заменяет** заголовок целиком, а ставит индикатор **слева** от текущего текста заголовка
+- На `session_start` / `agent_end` → ставит зелёную галочку `✓` слева от заголовка
+- На `input` → заменяет галочку на минималистичный текстовый спиннер из одного символа (например `▌ ▋ ▊ ▉ ▊ ▋` — вращающийся квадрат) с цветом, отражающим процент использованного контекста
+- После `agent_end` → снова зелёная галочка
+
+В репозитории:
+- Расширение в корне (`pi-idle.ts`)
+- Конфиг `.gitleaks.toml` для gitleaks (инструмент уже установлен в системе)
+- Интеграционный тест на vitest
+
+## Files to Create
+
+| File | Purpose |
+|------|---------|
+| `pi-idle.ts` | Расширение Pi — единственный файл расширения |
+| `.gitleaks.toml` | Конфигурация Gitleaks для репозитория |
+| `vitest.config.ts` | Конфигурация vitest |
+| `test.ts` | Интеграционный тест |
+| `package.json` | Для зависимостей vitest |
+
+## Reuse
+
+- Паттерн из `examples/extensions/titlebar-spinner.ts` — использует `ctx.ui.setTitle()` для изменения заголовка терминала
+- Паттерн анимированного спиннера из `examples/extensions/titlebar-spinner.ts` — использует `ctx.ui.setTitle()` и `setInterval`
+- `theme.fg("success", "✓")` из `status-line.ts` для зелёной галочки (ANSI-цвет в заголовке терминала)
+- Типы: `ExtensionAPI`, `ExtensionContext` из `@earendil-works/pi-coding-agent` (доступны автоматически, без установки)
+- События: `session_start`, `input` (event.source === "interactive"), `agent_end`
+
+## Steps
+
+- [ ] Step 1: Создать `pi-idle.ts` — само расширение
+  - Экспортирует `default function (pi: ExtensionAPI)`
+  - Функция формирования заголовка: читает базовый заголовок (через `process.title` или формирует как `π - {cwd}`), **префиксит** индикатор слева, а не заменяет заголовок
+  - Зелёная галочка: `theme.fg("success", "✓")`
+  - Квадратный спиннер: минималистичный набор из одного символа, вращающегося по кадрам: `▘ ▝ ▗ ▖` или `▌ ▋ ▊ ▉ ▊ ▋` (через `setInterval`, как в titlebar-spinner.ts)
+  - Цвет спиннера зависит от `ctx.getContextUsage()?.percent`:
+    - `< 20%` → `theme.fg("success", ...)` (зелёный)
+    - `20-39%` → `theme.fg("success", ...)` (зелёно-жёлтый — используется зелёный, т.к. отдельного цвета нет)
+    - `40-49%` → `theme.fg("warning", ...)` (жёлтый)
+    - `50-59%` → `theme.fg("warning", ...)` (оранжевый — используется warning)
+    - `≥ 60%` → `theme.fg("error", ...)` (красный)
+    - `≥ 90%` → добавляется `(!)` справа от спиннера
+  - На `session_start` → `ctx.ui.setTitle(theme.fg("success", "✓") + " " + baseTitle)`
+  - На `input` (source === "interactive") → запустить квадратный спиннер
+  - На `agent_end` → остановить спиннер, показать зелёную галочку
+  - На `session_shutdown` → остановить спиннер, очистить
+
+- [ ] Step 2: Создать `.gitleaks.toml`
+  - Базовая конфигурация, разрешающая стандартные паттерны для Node/TS проектов
+  - Исключения для тестовых данных, если нужны
+
+- [ ] Step 3: Создать `package.json`
+  - `type: "module"`
+  - `devDependencies`: только `vitest`
+  - Никаких зависимостей от `@earendil-works/pi-coding-agent` или `typebox` — они доступны автоматически через рантайм pi
+
+- [ ] Step 4: Создать `vitest.config.ts`
+  - Базовая конфигурация для vitest
+
+- [ ] Step 5: Создать `test.ts`
+  - Интеграционный тест на vitest, который:
+    - Спавнит `pi -e ./pi-idle.ts -p "test"` и проверяет exit code 0
+    - Импортирует расширение и тестирует напрямую с mock `ExtensionAPI`
+    - Проверяет, что `setTitle` вызывается с зелёной галочкой на `agent_end` и со спиннером на `input`
+
+- [ ] Step 6: Проверить gitleaks
+  - `gitleaks detect --source . --verbose`
+
+## Verification
+
+1. Запуск через `pi -e ./pi-idle.ts`
+2. Визуальная проверка:
+   - При старте pi в заголовке терминала видно `✓ π - project-name` (галочка зелёного цвета)
+   - После отправки промпта галочка заменяется на анимированный квадратный спиннер
+   - После завершения ответа агента снова зелёная галочка
+3. `npx vitest run` — тесты проходят
+4. `gitleaks detect --source .` — без утечек

package/README.md

@@ -0,0 +1,40 @@
+# pi-idle
+
+A [pi](https://github.com/earendil-works/pi-coding-agent) extension that puts a **✓ checkmark** in your terminal title when the agent is idle, and a **◰◳◲◱ spinner** while it's working — so you can tell at a glance whether pi is done or still thinking.
+
+## Title format
+
+| State | Title |
+|---|---|
+| Idle (≤ 50 % context) | `✓ π - session - project` |
+| Idle (> 50 % context) | `✓ [63%] π - session - project` |
+| Idle (≥ 90 % context) | `✓ ![95%]! π - session - project` |
+| Working | `◰ π - session - project` |
+| Shutdown | `π - session - project` |
+
+- The context-usage percentage is shown **only** beside the checkmark — never during the spinner. It's captured once when the agent finishes, not updated live.
+- `≤ 50 %` → percentage hidden; `> 50 %` → `[N%]`; `≥ 90 %` → `![N%]!` (high-usage warning).
+- ANSI colours don't work inside terminal-title OSC sequences, so everything is plain text.
+
+## Install
+
+```sh
+# One-off run
+pi -e ./pi-idle.ts
+
+# Auto-discovery: drop into your extensions directory
+cp pi-idle.ts ~/.pi/agent/extensions/pi-idle.ts
+```
+
+## Test
+
+```sh
+npm test        # single run
+npm run test:watch  # watch mode
+```
+
+CI runs on every push / PR to `master` via GitHub Actions.
+
+## License
+
+[MIT](LICENSE)

package/package.json

@@ -0,0 +1,15 @@
+{
+	"name": "pi-idle",
+	"version": "1.0.0",
+	"description": "Pi extension: shows ✓ in terminal title when idle, spinner (◰◳◲◱) while working, with context-usage percentage beside the checkmark",
+	"keywords": ["idle", "done", "spinner", "pi-extension"],
+	"type": "module",
+	"license": "MIT",
+	"scripts": {
+		"test": "vitest run",
+		"test:watch": "vitest"
+	},
+	"devDependencies": {
+		"vitest": "^3.2.4"
+	}
+}

package/pi-idle.ts

@@ -0,0 +1,112 @@
+/**
+ * Pi Idle Extension
+ *
+ * Shows a green checkmark (✓) in the **terminal title** when pi is idle
+ * (session finished, waiting for user input). When the user submits
+ * a prompt, the checkmark becomes a "square clock" spinner (◰◳◲◱).
+ *
+ * Context-usage percentage appears beside the checkmark (idle state) in the title:
+ *   ≤ 50%  → not shown
+ *   > 50%  → [N%]   (e.g. ✓ [63%] π - project)
+ *   ≥ 90%  → ![N%]!  (e.g. ✓ ![95%]! π - project)
+ * The percentage is captured once when the checkmark is shown; the spinner never displays it.
+ *
+ * ANSI colours are not supported inside terminal-title OSC sequences,
+ * so no colour is attempted there.
+ *
+ * Usage:
+ *   pi -e ./pi-idle.ts
+ *   # Or place in ~/.pi/agent/extensions/pi-idle.ts for auto-discovery
+ */
+
+import path from "node:path";
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+
+// ── Spinner frames ──────────────────────────────────────────────
+
+/** "Square clock" — each frame fills a different quadrant of a square. */
+const SPINNER_FRAMES = ["◰", "◳", "◲", "◱"];
+
+// ── Base title (mirrors pi's default format) ────────────────────
+
+function getBaseTitle(pi: ExtensionAPI): string {
+	const cwd = path.basename(process.cwd());
+	const session = pi.getSessionName();
+	return session ? `π - ${session} - ${cwd}` : `π - ${cwd}`;
+}
+
+// ── Context helpers ─────────────────────────────────────────────
+
+/**
+ * Build a context indicator for the title.
+ *   ≤ 50%  → ""           (hidden)
+ *   > 50%  → "[N%]"
+ *   ≥ 90%  → "![N%]!"
+ */
+function getContextIndicator(ctx: ExtensionContext): string {
+	const usage = ctx.getContextUsage();
+	const percent = usage?.percent ?? null;
+	if (percent === null || percent <= 50) return "";
+	const pct = Math.round(percent);
+	if (percent >= 90) return `![${pct}%]!`;
+	return `[${pct}%]`;
+}
+
+// ── Extension entry point ───────────────────────────────────────
+
+export default function (pi: ExtensionAPI) {
+	let timer: ReturnType<typeof setInterval> | null = null;
+	let frameIndex = 0;
+
+	// ── Internal helpers ───────────────────────────────────────
+
+	function stopSpinner() {
+		if (timer) {
+			clearInterval(timer);
+			timer = null;
+		}
+		frameIndex = 0;
+	}
+
+	/** Write the idle title (plain text — colours don't work in OSC titles). */
+	function showDone(ctx: ExtensionContext) {
+		stopSpinner();
+		const baseTitle = getBaseTitle(pi);
+		const indicator = getContextIndicator(ctx);
+		const spacer = indicator ? " " : "";
+		ctx.ui.setTitle(`✓${spacer}${indicator} ${baseTitle}`);
+	}
+
+	/** Start the spinner in the title. No context percentage — it only appears with the checkmark. */
+	function startSpinner(ctx: ExtensionContext) {
+		stopSpinner();
+
+		timer = setInterval(() => {
+			const frame = SPINNER_FRAMES[frameIndex % SPINNER_FRAMES.length];
+			const baseTitle = getBaseTitle(pi);
+			ctx.ui.setTitle(`${frame} ${baseTitle}`);
+			frameIndex++;
+		}, 120);
+	}
+
+	// ── Lifecycle hooks ────────────────────────────────────────
+
+	pi.on("session_start", async (_event, ctx) => {
+		showDone(ctx);
+	});
+
+	pi.on("input", async (event, ctx) => {
+		if (event.source === "interactive") {
+			startSpinner(ctx);
+		}
+	});
+
+	pi.on("agent_end", async (_event, ctx) => {
+		showDone(ctx);
+	});
+
+	pi.on("session_shutdown", async (_event, ctx) => {
+		stopSpinner();
+		ctx.ui.setTitle(getBaseTitle(pi));
+	})
+}

package/test.ts

@@ -0,0 +1,208 @@
+/**
+ * Integration tests for pi-idle.ts extension.
+ *
+ * Tests:
+ * 1.  Module loads and exports a default function
+ * 2.  All 4 lifecycle handlers are registered
+ * 3.  `session_start` → plain checkmark in title
+ * 4.  `input` (interactive) → spinner starts in title
+ * 5.  `input` (non-interactive) → no spinner
+ * 6.  `agent_end` → checkmark restored, spinner stopped
+ * 7.  `session_shutdown` → plain base title
+ * 8.  Context ≤50% → no indicator in title
+ * 9.  Context >50% → [N%] in title
+ * 10. Context ≥90% → ![N%]! in title
+ * 11. Context null → no indicator
+ */
+
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+
+// ── Helpers ──────────────────────────────────────────────────────
+
+function createMockPi(): ExtensionAPI & { _handlers: Map<string, Function> } {
+	const handlers = new Map<string, Function>();
+	return {
+		on: vi.fn((event: string, handler: Function) => {
+			handlers.set(event, handler);
+		}) as unknown as ExtensionAPI["on"],
+		getSessionName: vi.fn(() => null) as unknown as ExtensionAPI["getSessionName"],
+		_handlers: handlers,
+	} as unknown as ExtensionAPI & { _handlers: Map<string, Function> };
+}
+
+function createMockCtx(overrides?: Partial<ExtensionContext>): ExtensionContext {
+	const theme = {
+		fg: vi.fn((_color: string, text: string) => `«${_color}:${text}»`),
+	};
+	return {
+		ui: {
+			theme,
+			setTitle: vi.fn(),
+			setStatus: vi.fn(),
+		} as unknown as ExtensionContext["ui"],
+		getContextUsage: vi.fn(() => ({ percent: 25, tokens: 25000, contextWindow: 100000 })),
+		hasUI: true,
+		...overrides,
+	} as ExtensionContext;
+}
+
+// ── Module-level tests ───────────────────────────────────────────
+
+describe("pi-idle.ts module", () => {
+	it("loads without errors", async () => {
+		const mod = await import("./pi-idle.ts");
+		expect(typeof mod.default).toBe("function");
+	});
+
+	it("registers all four lifecycle handlers", async () => {
+		const mockPi = createMockPi();
+		const mod = await import("./pi-idle.ts");
+		mod.default(mockPi as unknown as ExtensionAPI);
+		expect(mockPi.on).toHaveBeenCalled();
+		const events = new Set(
+			(mockPi.on as ReturnType<typeof vi.fn>).mock.calls.map((c: string[]) => c[0]),
+		);
+		expect(events.has("session_start")).toBe(true);
+		expect(events.has("input")).toBe(true);
+		expect(events.has("agent_end")).toBe(true);
+		expect(events.has("session_shutdown")).toBe(true);
+	});
+});
+
+// ── Handler behaviour ────────────────────────────────────────────
+
+describe("extension handlers", () => {
+	let mockPi: ReturnType<typeof createMockPi>;
+
+	beforeEach(async () => {
+		mockPi = createMockPi();
+		const mod = await import("./pi-idle.ts");
+		mod.default(mockPi as unknown as ExtensionAPI);
+	});
+
+	it("session_start: ≤50% context → no indicator in title", async () => {
+		const ctx = createMockCtx(); // 25% ≤ 50%
+		const handler = mockPi._handlers.get("session_start")!;
+		await handler({ reason: "startup" }, ctx);
+
+		expect(ctx.ui.setTitle).toHaveBeenCalledWith("✓ π - pi-idle");
+		expect(ctx.ui.setStatus).not.toHaveBeenCalled();
+	});
+
+	it("input (interactive) starts spinner in title", async () => {
+		const ctx = createMockCtx(); // 25% ≤ 50% → no indicator
+		const handler = mockPi._handlers.get("input")!;
+		await handler({ source: "interactive", text: "hello" }, ctx);
+
+		await new Promise((r) => setTimeout(r, 150));
+
+		expect(ctx.ui.setTitle).toHaveBeenCalled();
+		const firstCall = (ctx.ui.setTitle as ReturnType<typeof vi.fn>).mock.calls[0][0] as string;
+		// Just spinner + base title, no indicator (25% ≤ 50%)
+		expect(firstCall).toMatch(/^[◰◳◲◱] π - pi-idle$/);
+		expect(ctx.ui.setStatus).not.toHaveBeenCalled();
+	});
+
+	it("input (non-interactive) does NOT start spinner", async () => {
+		const ctx = createMockCtx();
+		const handler = mockPi._handlers.get("input")!;
+		await handler({ source: "extension", text: "internal" }, ctx);
+
+		await new Promise((r) => setTimeout(r, 150));
+		expect(ctx.ui.setTitle).not.toHaveBeenCalled();
+		expect(ctx.ui.setStatus).not.toHaveBeenCalled();
+	});
+
+	it("agent_end restores checkmark in title", async () => {
+		const ctx = createMockCtx(); // 25% ≤ 50%
+		const handler = mockPi._handlers.get("agent_end")!;
+		await handler({ messages: [] }, ctx);
+
+		expect(ctx.ui.setTitle).toHaveBeenCalledWith("✓ π - pi-idle");
+	});
+
+	it("session_shutdown sets plain base title", async () => {
+		const ctx = createMockCtx();
+		const handler = mockPi._handlers.get("session_shutdown")!;
+		await handler({ reason: "quit" }, ctx);
+
+		expect(ctx.ui.setTitle).toHaveBeenCalledWith("π - pi-idle");
+		expect(ctx.ui.setStatus).not.toHaveBeenCalled();
+	});
+});
+
+// ── Context indicator ────────────────────────────────────────────
+
+describe("context indicator", () => {
+	it("≤50%: no indicator in title", async () => {
+		const ctx = createMockCtx({
+			getContextUsage: () => ({ percent: 50, tokens: 50000, contextWindow: 100000 }),
+		});
+		const mockPi = createMockPi();
+		const mod = await import("./pi-idle.ts");
+		mod.default(mockPi as unknown as ExtensionAPI);
+
+		const handler = mockPi._handlers.get("session_start")!;
+		await handler({ reason: "startup" }, ctx);
+		expect(ctx.ui.setTitle).toHaveBeenCalledWith("✓ π - pi-idle");
+	});
+
+	it(">50% and <90%: shows [N%] in title", async () => {
+		const ctx = createMockCtx({
+			getContextUsage: () => ({ percent: 63.7, tokens: 63700, contextWindow: 100000 }),
+		});
+		const mockPi = createMockPi();
+		const mod = await import("./pi-idle.ts");
+		mod.default(mockPi as unknown as ExtensionAPI);
+
+		const handler = mockPi._handlers.get("session_start")!;
+		await handler({ reason: "startup" }, ctx);
+		expect(ctx.ui.setTitle).toHaveBeenCalledWith("✓ [64%] π - pi-idle");
+	});
+
+	it("≥90%: shows ![N%]! in title", async () => {
+		const ctx = createMockCtx({
+			getContextUsage: () => ({ percent: 95, tokens: 95000, contextWindow: 100000 }),
+		});
+		const mockPi = createMockPi();
+		const mod = await import("./pi-idle.ts");
+		mod.default(mockPi as unknown as ExtensionAPI);
+
+		const handler = mockPi._handlers.get("session_start")!;
+		await handler({ reason: "startup" }, ctx);
+		expect(ctx.ui.setTitle).toHaveBeenCalledWith("✓ ![95%]! π - pi-idle");
+	});
+
+	it("context null: no indicator in title", async () => {
+		const ctx = createMockCtx({
+			getContextUsage: () => null,
+		});
+		const mockPi = createMockPi();
+		const mod = await import("./pi-idle.ts");
+		mod.default(mockPi as unknown as ExtensionAPI);
+
+		const handler = mockPi._handlers.get("session_start")!;
+		await handler({ reason: "startup" }, ctx);
+		expect(ctx.ui.setTitle).toHaveBeenCalledWith("✓ π - pi-idle");
+	});
+
+	it("spinner never includes context indicator, even at ≥90%", async () => {
+		const ctx = createMockCtx({
+			getContextUsage: () => ({ percent: 91, tokens: 91000, contextWindow: 100000 }),
+		});
+		const mockPi = createMockPi();
+		const mod = await import("./pi-idle.ts");
+		mod.default(mockPi as unknown as ExtensionAPI);
+
+		const handler = mockPi._handlers.get("input")!;
+		await handler({ source: "interactive", text: "test" }, ctx);
+		await new Promise((r) => setTimeout(r, 150));
+
+		const titleCalls = (ctx.ui.setTitle as ReturnType<typeof vi.fn>).mock.calls;
+		const allPlain = titleCalls.every((c: unknown[]) =>
+			/^[◰◳◲◱] π - pi-idle$/.test(c[0] as string),
+		);
+		expect(allPlain).toBe(true);
+	});
+});

package/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+	test: {
+		include: ["test.ts"],
+		testTimeout: 30_000,
+	},
+});