pi-ui-extend 1.0.32 → 1.0.36

package/README.md

@@ -401,6 +401,27 @@ Configurable areas include:
 
 Use `/settings` to inspect the effective settings summary and `/reload` after changing resources. Some command-driven settings update the relevant config file directly.
 
+### Ignoring legacy context files
+
+If a legacy project already contains an `AGENTS.md` or `CLAUDE.md` that should not be loaded, the simplest project-local workaround for both Pi and Pix is an empty override file in the same directory:
+
+```bash
+touch AGENTS.override.md
+```
+
+Pi and Pix load `AGENTS.override.md` instead of `AGENTS.md`/`CLAUDE.md` from that directory. To keep this local without changing the repository:
+
+```bash
+echo AGENTS.override.md >> .git/info/exclude
+```
+
+To disable discovery of all context files, including files in parent directories:
+
+- start Pi with `pi --no-context-files` (or `pi -nc`);
+- in Pix, run `/no-context-files on`. Pix saves `"ignoreContextFiles": true` to `<workspace>/.pi/pix.jsonc`.
+
+Start a new session or restart Pix after changing this setting. Use `/no-context-files off` to enable context-file loading again.
+
 ## Updates
 
 ```bash

package/dist/app/app.js

@@ -533,7 +533,6 @@ export class PiUiExtendApp {
             getThinkingMenuItems: (query) => this.menuItems.getThinkingMenuItems(query),
             awaitCurrentSessionExtensions: (runtime) => this.awaitCurrentSessionExtensions(runtime),
             modelRef: (model) => this.menuItems.modelRef(model),
-            getFavoriteScopedModels: () => this.menuItems.getFavoriteScopedModels(),
             setSessionStatus: (session) => this.setSessionStatus(session),
             queueUserMessage: (text) => {
                 this.queuedMessages.deferUserMessage(this.queuedMessages.createSubmittedUserMessage(text, text, []));

package/dist/app/commands/command-host.d.ts

@@ -1,7 +1,7 @@
 import type { AgentSession, AgentSessionRuntime, SessionInfo } from "@earendil-works/pi-coding-agent";
 import type { SessionSearchResult } from "../session/session-search.js";
 import type { AppRequestHistory } from "../session/request-history.js";
-import type { ActivePopupMenu, AppOptions, Entry, ModelMenuValue, PixMenuItem, PixMenuOptions, PopupMenuPlacement, ScopedSessionModel, SessionModel, ThinkingMenuValue } from "../types.js";
+import type { ActivePopupMenu, AppOptions, Entry, ModelMenuValue, PixMenuItem, PixMenuOptions, PopupMenuPlacement, SessionModel, ThinkingMenuValue } from "../types.js";
 import type { ToastNotifier } from "../../ui.js";
 export type DirectPopupMenu = Exclude<ActivePopupMenu, "slash">;
 export type CommandControllerHost = {
@@ -27,7 +27,6 @@ export type CommandControllerHost = {
     getModelMenuItems(query: string): readonly PixMenuItem<ModelMenuValue>[];
     getThinkingMenuItems(query: string): readonly PixMenuItem<ThinkingMenuValue>[];
     modelRef(model: SessionModel): string;
-    getFavoriteScopedModels(): ScopedSessionModel[];
     setSessionStatus(session: AgentSession | undefined): void;
     queueUserMessage(text: string): void;
     resetSessionView(): void;

package/dist/app/commands/command-model-actions.js

@@ -18,7 +18,7 @@ export class ModelCommandActions {
         const enabledModels = settings.getEnabledModels();
         const scopedModelText = enabledModels && enabledModels.length > 0
             ? enabledModels.map((model) => `  - ${model}`).join("\n")
-            : "  - default favorites";
+            : "  - all available models (no scope)";
         const text = [
             "Settings summary",
             `cwd: ${runtime.cwd}`,
@@ -191,7 +191,7 @@ export class ModelCommandActions {
             else if (sessionModels.length > 0)
                 scopedModelLines = sessionModels;
             else
-                scopedModelLines = ["  - default favorites"];
+                scopedModelLines = ["  - all available models (no scope)"];
             this.host.addEntry({
                 id: createId("system"),
                 kind: "system",
@@ -200,7 +200,7 @@ export class ModelCommandActions {
                     ...scopedModelLines,
                     "",
                     "Usage: /scoped-models <provider/model[:thinking]> [...more]",
-                    "Use /scoped-models reset to restore the default favorites.",
+                    "Use /scoped-models reset to use all available models.",
                 ].join("\n"),
             });
             this.host.setSessionStatus(runtime.session);
@@ -208,8 +208,8 @@ export class ModelCommandActions {
         }
         if (["reset", "default", "clear"].includes(value.toLowerCase())) {
             runtime.services.settingsManager.setEnabledModels(undefined);
-            runtime.session.setScopedModels(this.host.getFavoriteScopedModels());
-            this.host.addEntry({ id: createId("system"), kind: "system", text: "Scoped models reset to default favorites." });
+            runtime.session.setScopedModels([]);
+            this.host.addEntry({ id: createId("system"), kind: "system", text: "Model scope reset to all available models." });
             this.host.setSessionStatus(runtime.session);
             return;
         }

package/dist/app/constants.d.ts

@@ -1,7 +1,6 @@
 import type { ResolvedToolRule } from "../config.js";
 export declare const THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
 export declare const THINKING_MENU_MAX_ROWS: number;
-export declare const PI_FAVORITE_MODEL_REFS: readonly ["amazon-bedrock/us.anthropic.claude-opus-4-6-v1", "anthropic/claude-opus-4-8", "openai/gpt-5.4", "azure-openai-responses/gpt-5.4", "openai-codex/gpt-5.6-sol", "deepseek/deepseek-v4-pro", "google/gemini-3.1-pro-preview", "google-vertex/gemini-3.1-pro-preview", "github-copilot/gpt-5.4", "openrouter/moonshotai/kimi-k2.6", "vercel-ai-gateway/zai/glm-5.2", "xai/grok-4.5", "groq/openai/gpt-oss-120b", "cerebras/gpt-oss-120b", "zai/glm-5.3", "mistral/devstral-medium-latest", "minimax/MiniMax-M2.7", "minimax-cn/MiniMax-M2.7", "moonshotai/kimi-k2.6", "moonshotai-cn/kimi-k2.6", "huggingface/moonshotai/Kimi-K2.6", "fireworks/accounts/fireworks/models/kimi-k2p6", "together/moonshotai/Kimi-K2.6", "opencode/kimi-k2.6", "opencode-go/kimi-k2.6", "kimi-coding/kimi-for-coding", "cloudflare-workers-ai/@cf/moonshotai/kimi-k2.6", "cloudflare-ai-gateway/workers-ai/@cf/moonshotai/kimi-k2.6", "xiaomi/mimo-v2.5-pro", "xiaomi-token-plan-cn/mimo-v2.5-pro", "xiaomi-token-plan-ams/mimo-v2.5-pro", "xiaomi-token-plan-sgp/mimo-v2.5-pro"];
 export declare const SLASH_COMMAND_MENU_MAX_ROWS = 6;
 export declare const RESUME_MENU_MAX_ROWS = 20;
 export declare const RESUME_MENU_INITIAL_SESSION_ROWS = 30;

package/dist/app/constants.js

@@ -1,40 +1,6 @@
 import { join } from "node:path";
 export const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
 export const THINKING_MENU_MAX_ROWS = THINKING_LEVELS.length + 1;
-export const PI_FAVORITE_MODEL_REFS = [
-    "amazon-bedrock/us.anthropic.claude-opus-4-6-v1",
-    "anthropic/claude-opus-4-8",
-    "openai/gpt-5.4",
-    "azure-openai-responses/gpt-5.4",
-    "openai-codex/gpt-5.6-sol",
-    "deepseek/deepseek-v4-pro",
-    "google/gemini-3.1-pro-preview",
-    "google-vertex/gemini-3.1-pro-preview",
-    "github-copilot/gpt-5.4",
-    "openrouter/moonshotai/kimi-k2.6",
-    "vercel-ai-gateway/zai/glm-5.2",
-    "xai/grok-4.5",
-    "groq/openai/gpt-oss-120b",
-    "cerebras/gpt-oss-120b",
-    "zai/glm-5.3",
-    "mistral/devstral-medium-latest",
-    "minimax/MiniMax-M2.7",
-    "minimax-cn/MiniMax-M2.7",
-    "moonshotai/kimi-k2.6",
-    "moonshotai-cn/kimi-k2.6",
-    "huggingface/moonshotai/Kimi-K2.6",
-    "fireworks/accounts/fireworks/models/kimi-k2p6",
-    "together/moonshotai/Kimi-K2.6",
-    "opencode/kimi-k2.6",
-    "opencode-go/kimi-k2.6",
-    "kimi-coding/kimi-for-coding",
-    "cloudflare-workers-ai/@cf/moonshotai/kimi-k2.6",
-    "cloudflare-ai-gateway/workers-ai/@cf/moonshotai/kimi-k2.6",
-    "xiaomi/mimo-v2.5-pro",
-    "xiaomi-token-plan-cn/mimo-v2.5-pro",
-    "xiaomi-token-plan-ams/mimo-v2.5-pro",
-    "xiaomi-token-plan-sgp/mimo-v2.5-pro",
-];
 export const SLASH_COMMAND_MENU_MAX_ROWS = 6;
 export const RESUME_MENU_MAX_ROWS = 20;
 export const RESUME_MENU_INITIAL_SESSION_ROWS = 30;

package/dist/app/popup/menu-items-controller.d.ts

@@ -1,6 +1,6 @@
 import type { AgentSessionRuntime, SessionInfo } from "@earendil-works/pi-coding-agent";
 import type { PopupMenuItem } from "../../ui.js";
-import type { Entry, ModelMenuValue, QueueMessageMenuValue, ResumeMenuValue, ScopedSessionModel, SessionModel, SlashCommand, ThinkingMenuValue, UserMessageJumpMenuValue, UserMessageMenuValue } from "../types.js";
+import type { Entry, ModelMenuValue, QueueMessageMenuValue, ResumeMenuValue, SessionModel, SlashCommand, ThinkingMenuValue, UserMessageJumpMenuValue, UserMessageMenuValue } from "../types.js";
 export type AppMenuItemsControllerHost = {
     runtime(): AgentSessionRuntime | undefined;
     getBuiltinSlashCommands(): readonly SlashCommand[];
@@ -18,7 +18,6 @@ export declare class AppMenuItemsController {
     getSlashCommandMatches(query: string, limit?: number): import("../../fuzzy.js").FuzzyMatch<SlashCommand>[];
     getSlashCommandMenuItems(query: string): PopupMenuItem<SlashCommand>[];
     modelRef(model: SessionModel): string;
-    getFavoriteScopedModels(): ScopedSessionModel[];
     getModelMenuItems(query: string): PopupMenuItem<ModelMenuValue>[];
     getThinkingMenuItems(query: string): PopupMenuItem<ThinkingMenuValue>[];
     getUserMessageMenuItems(): PopupMenuItem<UserMessageMenuValue>[];
@@ -30,7 +29,6 @@ export declare class AppMenuItemsController {
     private getResumeMenuItemsLoader;
     private getAllSlashCommands;
     private isCurrentModel;
-    private resolveScopedModelRefs;
     private getModelMenuModels;
     private thinkingLevelDescription;
 }

package/dist/app/popup/menu-items-controller.js

@@ -1,8 +1,7 @@
 import { resolve } from "node:path";
 import { fuzzySearch } from "../../fuzzy.js";
-import { PI_FAVORITE_MODEL_REFS, THINKING_LEVELS } from "../constants.js";
+import { THINKING_LEVELS } from "../constants.js";
 import { APP_ICONS } from "../icons.js";
-import { parseScopedModelRef } from "../model/model-ref.js";
 import { buildUserMessageJumpItems, createSessionInfoMenuItemsLoader, filterUserMessageJumpItems } from "./popup-menu-controller.js";
 import { getResourceSlashCommands, getSlashCommandMatches, parseSlashInput } from "../commands/slash-commands.js";
 import { isRecord } from "../guards.js";
@@ -38,11 +37,6 @@ export class AppMenuItemsController {
     modelRef(model) {
         return `${model.provider}/${model.id}`;
     }
-    getFavoriteScopedModels() {
-        const configuredRefs = this.host.runtime()?.services.settingsManager.getEnabledModels();
-        const refs = configuredRefs && configuredRefs.length > 0 ? configuredRefs : PI_FAVORITE_MODEL_REFS;
-        return this.resolveScopedModelRefs(refs);
-    }
     getModelMenuItems(query) {
         const models = [...this.getModelMenuModels()].sort((left, right) => {
             const leftCurrent = this.isCurrentModel(left);
@@ -172,33 +166,17 @@ export class AppMenuItemsController {
         const current = this.host.runtime()?.session.model;
         return current?.provider === model.provider && current.id === model.id;
     }
-    resolveScopedModelRefs(modelRefs) {
-        const modelRuntime = this.host.runtime()?.services.modelRuntime;
-        if (!modelRuntime)
-            return [];
-        const scopedModels = [];
-        for (const modelRef of modelRefs) {
-            const parsed = parseScopedModelRef(modelRef);
-            if (!parsed)
-                continue;
-            const model = modelRuntime.getModel(parsed.provider, parsed.modelId);
-            if (!model)
-                continue;
-            scopedModels.push({
-                model,
-                ...(parsed.thinkingLevel === undefined ? {} : { thinkingLevel: parsed.thinkingLevel }),
-            });
-        }
-        return scopedModels;
-    }
     getModelMenuModels() {
-        const session = this.host.runtime()?.session;
-        const scopedModels = session?.scopedModels.length ? session.scopedModels : this.getFavoriteScopedModels();
-        if (!scopedModels.length)
+        const runtime = this.host.runtime();
+        if (!runtime)
             return [];
-        const modelRuntime = this.host.runtime()?.services.modelRuntime;
-        return scopedModels.map((scoped) => {
-            const refreshed = modelRuntime?.getModel(scoped.model.provider, scoped.model.id);
+        const { session } = runtime;
+        const modelRuntime = runtime.services.modelRuntime;
+        if (!session.scopedModels.length) {
+            return [...modelRuntime.getAvailableSnapshot()];
+        }
+        return session.scopedModels.map((scoped) => {
+            const refreshed = modelRuntime.getModel(scoped.model.provider, scoped.model.id);
             return (refreshed ?? scoped.model);
         });
     }

package/dist/app/rendering/popup-menu-renderer.js

@@ -101,7 +101,7 @@ export class PopupMenuRenderer {
         const visibleItems = menu.visibleItems();
         if (!this.hasPopupActionItems(menu.items)) {
             lines.push({
-                text: this.host.session ? "  No matching favorite models" : "  Model menu unavailable",
+                text: this.host.session ? "  No matching available models" : "  Model menu unavailable",
                 variant: "muted",
             });
         }

package/dist/app/runtime.js

@@ -5,7 +5,6 @@ import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, getAgentDir, SessionManager, } from "@earendil-works/pi-coding-agent";
 import { loadPixConfig, resolveDefaultModelRef } from "../config.js";
-import { PI_FAVORITE_MODEL_REFS } from "./constants.js";
 import { isThinkingLevel, parseModelRef, parseScopedModelRef } from "./model/model-ref.js";
 import { openLazySessionManager } from "./session/lazy-session-manager.js";
 const BUNDLED_QUESTION_EXTENSION_NAME = "question";
@@ -267,8 +266,7 @@ export async function createPixRuntime(options, runtimeOptions = {}) {
             throw new Error(`Model not found: ${parsedModel.provider}/${parsedModel.modelId}`);
         }
         const enabledModelRefs = services.settingsManager.getEnabledModels();
-        const favoriteModelRefs = enabledModelRefs && enabledModelRefs.length > 0 ? enabledModelRefs : PI_FAVORITE_MODEL_REFS;
-        const scopedModels = favoriteModelRefs.flatMap((modelRef) => {
+        const scopedModels = (enabledModelRefs ?? []).flatMap((modelRef) => {
             const scoped = parseScopedModelRef(modelRef);
             if (!scoped)
                 return [];

package/dist/app/screen/file-link-opener.js

@@ -2,6 +2,11 @@ import { existsSync } from "node:fs";
 import { spawn } from "node:child_process";
 import { isAbsolute, posix, win32 } from "node:path";
 import { fileURLToPath } from "node:url";
+const MEDIA_EXTENSIONS = new Set([
+    ".3g2", ".3gp", ".aac", ".aiff", ".alac", ".apng", ".avi", ".avif", ".bmp", ".flac", ".gif", ".heic", ".heif",
+    ".ico", ".jpeg", ".jpg", ".m4a", ".m4v", ".mkv", ".mov", ".mp3", ".mp4", ".mpeg", ".mpg", ".oga", ".ogg",
+    ".ogv", ".opus", ".png", ".svg", ".tif", ".tiff", ".wav", ".webm", ".webp", ".wma", ".wmv",
+]);
 let deps = { existsSync, env: process.env, platform: process.platform, spawn };
 export function setFileLinkOpenerTestDeps(overrides) {
     const previous = deps;
@@ -16,9 +21,11 @@ export function openFileLink(link) {
     const filePath = link.filePath ?? filePathFromUrl(link.url);
     if (!filePath)
         return false;
-    const editorLaunch = preferredEditorLaunch(filePath, link.line, link.column);
-    if (editorLaunch && trySpawnCandidates(editorLaunch.candidates, editorLaunch.args))
-        return true;
+    if (isZedTerminal(deps.env) && !isMediaFile(filePath)) {
+        const openedInZed = trySpawnCandidates(zedCommandCandidates(), [zedTarget(filePath, link.line, link.column)]);
+        if (openedInZed)
+            return true;
+    }
     return openPathWithSystemViewer(filePath);
 }
 function isWebUrl(url) {
@@ -39,45 +46,12 @@ function zedTarget(filePath, line, column) {
         return filePath;
     return column === undefined ? `${filePath}:${line}` : `${filePath}:${line}:${column}`;
 }
-function gotoTarget(filePath, line, column) {
-    if (line === undefined)
-        return filePath;
-    return column === undefined ? `${filePath}:${line}` : `${filePath}:${line}:${column}`;
-}
-function preferredEditorLaunch(filePath, line, column) {
-    switch (detectEditor(deps.env)) {
-        case "cursor":
-            return { args: ["--goto", gotoTarget(filePath, line, column)], candidates: commandCandidates(deps.env.CURSOR_CLI, "cursor") };
-        case "jetbrains":
-            return {
-                args: jetbrainsTargetArgs(filePath, line),
-                candidates: commandCandidates(deps.env.JETBRAINS_IDE_CLI, "idea", "idea64", "webstorm", "webstorm64", "pycharm", "pycharm64", "goland", "goland64", "clion", "clion64", "phpstorm", "phpstorm64", "rubymine", "rubymine64", "rider", "rider64"),
-            };
-        case "vscode":
-            return { args: ["--goto", gotoTarget(filePath, line, column)], candidates: commandCandidates(deps.env.VSCODE_CLI, "code", "code-insiders") };
-        case "windsurf":
-            return { args: ["--goto", gotoTarget(filePath, line, column)], candidates: commandCandidates(deps.env.WINDSURF_CLI, "windsurf") };
-        case "zed":
-            return { args: [zedTarget(filePath, line, column)], candidates: zedCommandCandidates() };
-        default:
-            return undefined;
-    }
+function isZedTerminal(env) {
+    return env.TERM_PROGRAM?.trim().toLowerCase() === "zed" || Boolean(env.ZED_CLI);
 }
-function detectEditor(env) {
-    const termProgram = env.TERM_PROGRAM?.trim().toLowerCase();
-    const terminalEmulator = env.TERMINAL_EMULATOR?.trim().toLowerCase();
-    const terminalProvider = env.TERMINAL_PROVIDER?.trim().toLowerCase();
-    if (termProgram === "cursor" || env.CURSOR_TRACE_ID || env.CURSOR_TRACE)
-        return "cursor";
-    if (termProgram === "windsurf")
-        return "windsurf";
-    if (termProgram === "zed" || env.ZED_CLI)
-        return "zed";
-    if (termProgram === "vscode" || env.VSCODE_IPC_HOOK_CLI || env.VSCODE_GIT_IPC_HANDLE)
-        return "vscode";
-    if (terminalEmulator?.includes("jetbrains") || terminalProvider === "jetbrains")
-        return "jetbrains";
-    return undefined;
+function isMediaFile(filePath) {
+    const pathApi = deps.platform === "win32" ? win32 : posix;
+    return MEDIA_EXTENSIONS.has(pathApi.extname(filePath).toLowerCase());
 }
 function zedCommandCandidates() {
     const candidates = [deps.env.ZED_CLI, "zed", "zeditor"];
@@ -85,14 +59,6 @@ function zedCommandCandidates() {
         candidates.push("/opt/homebrew/bin/zed", "/usr/local/bin/zed");
     return candidates.filter((candidate) => Boolean(candidate));
 }
-function commandCandidates(primary, ...rest) {
-    return [primary, ...rest].filter((candidate) => Boolean(candidate));
-}
-function jetbrainsTargetArgs(filePath, line) {
-    if (line === undefined)
-        return [filePath];
-    return ["--line", `${line}`, filePath];
-}
 function trySpawnCandidates(candidates, args) {
     for (const command of candidates) {
         if (!canRunCommand(command))

package/external/pi-tools-suite/README.md

@@ -4,13 +4,14 @@ Local all-in-one Pi extension package.
 
 This package keeps shared Pi tools as ordinary source folders under `src/` and registers them through one entrypoint.
 
-- `src/coding-discipline` — injects a deduplicated silent-mode and quality-discipline block at the very top of the main-session per-turn system prompt for GLM main-session models only (`isGlmModel`) immediately before the LLM request; non-GLM models are left untouched; disabled for async sub-agents
+- `src/coding-discipline` — injects a deduplicated silent-mode and quality-discipline block at the very top of the main-session per-turn system prompt for GLM main-session models only (`isGlmModel`) immediately before the LLM request; text-only GLM models get the `lookup` bridge while vision-capable `zai/glm-5.3-flash` inspects images directly; non-GLM models are left untouched; disabled for async sub-agents
 - `src/credential-firewall` — opt-in secret firewall for high-confidence outbound/session credential redaction; disabled by default
 - `src/ast-grep` — `ast_grep` / `ast_apply`
 - `src/async-subagents` — `subagents` tool and sub-agent slash commands, including oh-my-openagent-style `/ultrawork` (`/ulw`) and `/hyperplan` orchestration prompts, plus config-defined sub-agent model/thinking/args presets selected via `/subagent-preset` from `asyncSubagents` in `~/.config/pi/pi-tools-suite.jsonc`; includes the `frontend` profile for Gemini-friendly UI/UX and visual frontend work and the `oracle` profile for cross-provider second opinions; enforces a 30-minute per-agent execution timeout, project-wide `maxConcurrent` queueing, optional retry/backoff, and `result.json` structured metadata/chaining fields next to raw `result.md`; stores project-local run files and a registry under `.pi/subagents/` so result/status collection can recover after compaction or reload while the main session remains alive
 - `src/lsp` — shared LSP diagnostics hook/library that enriches mutating tool results with diagnostics and shuts down language servers on session shutdown
 - `src/comment-checker` — AI-slop comment guard that listens to the `tool_result` event for `write` / `edit` / `apply_patch` mutations, extracts net-new code comment lines, classifies them (filler phrasing, restating code, decorative separators, generic paraphrasing, or — under aggressive strictness — any non-valuable comment), and appends a short nudge to the tool result so the agent removes unnecessary comments on its next turn; TODO/FIXME, license headers, docstrings, pragmas, linter directives, shebangs, and decorators are never flagged; language-agnostic across `//` / `/* */` / `#` / `--` / `<!-- -->` / triple-quote comment styles; per-session deduplication (at most one nudge per 30 s) prevents fix/remark loops; configured via the `commentChecker` section (`enabled`, `strictness`: `conservative` | `balanced` | `aggressive`, default `balanced`) or `PI_COMMENT_CHECKER_ENABLED` / `PI_COMMENT_CHECKER_STRICTNESS`
 - `src/session-name` — `session_name` tool for reading or setting the current session title directly from tool calls, without relying on slash-command parsing
+- `src/session-recovery` — branch- and compaction-aware `session_overview`, `session_read_section`, `session_search`, and `session_recovery_context` tools for bounded recovery from Pi's raw append-only session history
 - `src/repo-discovery` — `/idx-init`, `/idx-update`, and indexed-only `repo_architecture` / `repo_structure` / `repo_ast` / `repo_search` / `repo_explain` / `repo_deps`; tools register only when the launch project has `.indexer-cli`
 - `src/antigravity-auth` — `antigravity` custom provider with Google Antigravity OAuth login, startup account list, auth.json-only runtime account loading, `/antigravity-add-account` OAuth append into rotation, `/antigravity-account` status display, account rotation/failover, Antigravity plus Gemini CLI model registration, and streaming through the Cloud Code Assist unified gateway
 - `src/opencode-import` — `/opencode-import` for bounded migration of supported OpenCode OpenAI/Codex, GitHub Copilot, Z.ai, and Antigravity credentials into Pi; existing entries are preserved unless `--force` is passed
@@ -24,7 +25,19 @@ This package keeps shared Pi tools as ordinary source folders under `src/` and r
 
 `index.ts` is intentionally only a thin auto-discovery shim that re-exports `src/index.ts`. There is no `pi.extensions` manifest here, so local Pi auto-discovery loads the suite once via `~/.pi/agent/extensions/pi-tools-suite/index.ts` and does not double-register tools.
 
-Registration order is preserved in `src/index.ts`: coding-discipline, ast-grep, async-subagents, lsp, comment-checker, session-name, repo-discovery command/tool gate, antigravity-auth provider, OpenCode import, todo, model-tools, usage, web-search, dcp, prompt-commands, skill-installer, credential-firewall, then codex-reasoning-fix. Tool metadata and active model-specific tool sets have two modes: standard and repo-aware. When `.indexer-cli` enables `repo_*`, those tools stay active ahead of overlapping lower-level aliases so the indexed discovery surface has priority.
+Registration order is preserved in `src/index.ts`: coding-discipline, ast-grep, async-subagents, lsp, comment-checker, session-name, session-recovery, repo-discovery command/tool gate, antigravity-auth provider, OpenCode import, todo, model-tools, usage, web-search, dcp, prompt-commands, skill-installer, credential-firewall, then codex-reasoning-fix. Tool metadata and active model-specific tool sets have two modes: standard and repo-aware. When `.indexer-cli` enables `repo_*`, those tools stay active ahead of overlapping lower-level aliases so the indexed discovery surface has priority.
+
+## Session recovery
+
+When context compaction obscures the task, start with `session_overview`, inspect a
+relevant ID with `session_read_section`, and use `session_search` once a concrete
+phrase, path, symbol, tool, or error is known. `session_recovery_context` is the
+compact convenience view for original/latest user instructions, file evidence,
+recent errors, pending calls, and the last meaningful action. All four tools read
+through Pi's active `SessionManager`; they do not accept arbitrary session paths.
+They default to the active branch, while `scope: "all"` includes abandoned branches.
+See [`docs/session-recovery.md`](docs/session-recovery.md) for the full contract and
+limits.
 
 ## Disabling modules
 
@@ -247,8 +260,8 @@ For an oh-my-openagent-style workflow, run `/ultrawork` or `/ulw` to ask the par
 
 ### Private browser QA and project auth
 
-The built-in `browser-qa` role runs on `openai-codex/gpt-5.6-luna`, with
-`antigravity/gemini-3-flash-preview` and then `zai/glm-5.3` as fallbacks. Its browser
+The built-in `browser-qa` role runs on `zai/glm-5.3-flash`, with
+`openai-codex/gpt-5.6-luna` as its fallback. Its browser
 workflow is an explicit private skill under `src/async-subagents/private-skills/`,
 outside normal Pi skill discovery. The role's first-class `isolatedSkills` setting launches the child with
 `--no-skills` plus one self-contained private workflow. It bundles the relevant
@@ -316,9 +329,17 @@ parent to ask the user for an update and rerun. See
 for complete profile shapes and `references/qa-flow.example.jsonc` beside it for
 the declarative, non-executable QA action/assertion format.
 
+Browser QA videos automatically visualize pointer interactions. Clicks and
+double-clicks show a transient cursor and pulse. Native drag/drop is replayed
+for 450 ms with a large orange cursor, progressively drawn high-contrast path,
+and green drop marker. The isolated, pointer-transparent layer is installed for
+the whole browser context, including same-origin frames, declared popups, and
+form-auth submission, and clears during the normal post-action stable interval
+so screenshots and assertions remain state-focused.
+
 Async-subagents also injects a lightweight oh-my-openagent-style system-prompt strategy by model: non-GPT parents get `parallel-first`, an orchestration-first hint that favors ultrawork/subagents for broad work, while GPT-like parents get `deep-work`, a direct deep-worker hint that uses subagents only when clearly useful. Explicit custom system prompts (`--system-prompt`, `SYSTEM.md`, custom templates) are respected and skip this injection by default. Disable it with `PI_AGENT_STRATEGY=off`; force a strategy with `PI_AGENT_STRATEGY=parallel-first` or `PI_AGENT_STRATEGY=deep-work`; set `PI_AGENT_STRATEGY_WITH_CUSTOM_PROMPT=1` to append it even when a custom prompt is present.
 
-For blind-model screenshot/image inspection, use the main-session `coding-discipline` lookup tool. Async-subagents still supports `imagePaths` on tasks when a broader delegated track genuinely needs images, but it no longer ships a dedicated `vision` role. Dynamic provider capabilities can be missing or stale after switching models, so blind parent models can still be configured explicitly with case-insensitive `*` masks under `asyncSubagents.vision.blindModelPatterns` in `~/.config/pi/pi-tools-suite.jsonc`; this keeps guidance honest, not a sub-agent role.
+For blind-model screenshot/image inspection, use the main-session `coding-discipline` lookup tool; the bundled default uses vision-capable `zai/glm-5.3-flash`. Async-subagents still supports `imagePaths` on tasks when a broader delegated track genuinely needs images, but it no longer ships a dedicated `vision` role. Dynamic provider capabilities can be missing or stale after switching models, so blind parent models can still be configured explicitly with case-insensitive `*` masks under `asyncSubagents.vision.blindModelPatterns` in `~/.config/pi/pi-tools-suite.jsonc`; do not include `zai/glm-5.3-flash` because it accepts image input. This keeps guidance honest, not a sub-agent role.
 
 When a task omits `subagentType`, async-subagents asks a lightweight router model to choose one configured type for each task from the task text/scope and the `types.<name>.description` metadata. Explicit task `subagentType` still wins. Keep type descriptions short, literal, and distinct because they are inserted into the router prompt for a small model. Router settings live under `asyncSubagents.routing` (`enabled`, `model`, `maxTaskChars`, `maxTokens`, `maxRetries`, `timeoutMs`, `debug`); the default router model is `zai/glm-4.5-air`. If the router is disabled, unavailable, aborted, or returns invalid JSON, omitted types fall back to `defaultType`.
 
@@ -337,10 +358,11 @@ Example shared async-subagents config section:
     },
     "presets": {
       "cheap": {
-        "description": "Use GLM for text/code roles.",
+        "description": "Use GLM by role, including GLM-5.3 Flash for multimodal work.",
         "types": {
           "quick": { "model": "zai/glm-5.3", "thinking": "off" },
-          "frontend": { "model": "antigravity/gemini-3-flash-preview", "fallbackModels": ["zai/glm-5.3"], "thinking": "medium" },
+          "frontend": { "model": "zai/glm-5.3-flash", "thinking": "medium" },
+          "browser-qa": { "model": "zai/glm-5.3-flash", "fallbackModels": ["openai-codex/gpt-5.6-luna"], "thinking": "low" },
           "review": { "model": "zai/glm-5.3", "thinking": "high" }
         }
       }

package/external/pi-tools-suite/docs/browser-qa-subagent.md

@@ -4,8 +4,8 @@
 
 Provide a cheap, fast `browser-qa` async-subagent that reproduces browser bugs
 and proves fixes with deterministic assertions plus screenshot, video, and trace
-evidence. The role uses `openai-codex/gpt-5.6-luna`, falling back to
-`antigravity/gemini-3-flash-preview` and then `zai/glm-5.3`.
+evidence. The role uses `zai/glm-5.3-flash`, falling back to
+`openai-codex/gpt-5.6-luna`.
 
 ## Private skill isolation
 
@@ -73,6 +73,20 @@ evidence. The role uses `openai-codex/gpt-5.6-luna`, falling back to
   screenshots, video finalization, and redacted result output. Before retaining
   a trace it removes network/non-image resource entries, redacts configured and
   runtime storage credentials, and verifies those values are absent.
+- After every navigation or visible interaction, the runner waits for DOM
+  readiness, completion of requests started by the action, and disappearance of
+  common visible busy/spinner/skeleton markers. It requires a 500 ms stable
+  interval before the next action so recordings remain readable; a page that
+  stays busy through the flow timeout fails closed instead of being tested as a
+  loading shell. App-specific readiness still requires an explicit declarative
+  wait/assertion in the authored flow.
+- Before any page is created, the runner installs a context-wide, isolated
+  interaction visualizer. Recorded clicks/double-clicks show a transient cursor
+  and pulse. Native drag/drop is replayed for 450 ms with a large orange cursor,
+  progressively drawn high-contrast path, and green drop marker. It also covers
+  same-origin frames, declared popups, and form-auth submission. The layer is
+  accessibility-hidden, pointer-transparent, never cancels application events,
+  and its bounded animations clear within the post-action stable interval.
 - Success and post-launch failure results include typed artifact groups. Every
   item has an absolute filesystem path and a `file:` URI; the sub-agent must
   present each item as a clickable Markdown link instead of reporting only the
@@ -112,7 +126,7 @@ evidence. The role uses `openai-codex/gpt-5.6-luna`, falling back to
 
 1. `browser-qa` resolves to the intended model/fallback and its self-contained
    private workflow, and its isolated child process can register the configured
-   Antigravity model.
+   model provider.
 2. Spawn args contain `--no-skills` and the mandatory private skill for this
    profile; ordinary profiles retain existing skill discovery behavior.
 3. Auth profile listing and all error output are redacted; model-authored input
@@ -123,12 +137,16 @@ evidence. The role uses `openai-codex/gpt-5.6-luna`, falling back to
    flows, and successful redacted evidence creation.
 5. Browser QA flows/evidence live only inside the owning sub-agent directory;
    deleting the run removes them while persistent auth config/state remains.
-6. Completed test runs report clickable screenshot, video, and trace links
+6. Runner tests prove that network activity and visible loading indicators are
+   awaited, persistent loading fails the flow, visible actions retain a stable
+   500 ms video interval, and context-wide click/drag video visualization is
+   installed with bounded click pacing.
+7. Completed test runs report clickable screenshot, video, and trace links
    whenever those artifacts exist.
-7. Timeout tests identify the last browser stage, launcher progress remains
+8. Timeout tests identify the last browser stage, launcher progress remains
    available when full RPC logging is disabled, and process-tree tests prove a
    descendant is terminated without signalling unrelated processes.
-8. Suite tests/typecheck, host checks, and suite sync pass.
+9. Suite tests/typecheck, host checks, and suite sync pass.
 
 ## Real-browser regression test
 

package/external/pi-tools-suite/docs/session-recovery.md

@@ -0,0 +1,84 @@
+# Session recovery tools
+
+Status: implemented MVP contract (semantic search is intentionally deferred).
+
+## Goal
+
+Let an agent recover the task, recent instructions, file activity, and useful raw
+session history after context compaction. Recovery reads the session already
+owned by Pi's `SessionManager`; it never opens an arbitrary session path.
+
+## Scope
+
+The `session-recovery` module registers four read-only, headless tools:
+
+- `session_overview` maps a session into stable, bounded sections.
+- `session_read_section` renders one section by ID.
+- `session_search` performs bounded lexical search over raw entries.
+- `session_recovery_context` summarizes deterministic recovery signals.
+
+Every tool defaults to the active root-to-leaf branch. `scope: "all"` includes
+abandoned branches through `SessionManager.getEntries()`. Both modes use raw
+append-only entries, not `buildContextEntries()`, so content hidden from the
+active model context by compaction remains discoverable.
+
+## Contracts
+
+### Sections
+
+A section starts at the first selected entry, a user message, a compaction, or a
+branch summary. Its stable ID is derived from the start entry ID. The overview
+reports bounded head and tail sections with entry ranges, counts, and compact
+role/tool/error/file statistics. Labels are previews, not inferred decisions.
+
+### Reading and search
+
+`session_read_section` requires a section ID produced for the same scope. It
+renders message roles and text, tool calls and arguments, tool results,
+compaction summaries, and branch summaries with per-entry and total output
+limits.
+
+`session_search` is case-insensitive by default and searches message text, tool
+arguments/results, custom-message content, and compaction or branch summaries.
+It returns entry and section IDs plus bounded snippets. Regex and semantic
+search are out of scope for the MVP.
+
+### Recovery context
+
+`session_recovery_context` reports only evidence that can be derived
+deterministically: the original and latest user messages, recent tool errors,
+unmatched tool calls, read and modified files, the last meaningful action, and
+compaction count. It calls errors `recentErrors`; it does not claim that they
+remain unresolved. It does not infer decisions. The currently executing
+recovery tool call is excluded from unmatched-call reporting.
+
+File activity comes from recognized tool calls and Pi-generated compaction or
+branch-summary details. Read and modified paths remain separate, and unknown
+tools are not guessed to be mutations.
+
+## Limits and edge cases
+
+- Results use small defaults and hard caps for result count, entry body size,
+  and total text size.
+- Empty or in-memory sessions return a normal explanatory result.
+- Unknown or partially shaped entries are ignored or rendered conservatively.
+- Concurrent sibling tool results might not yet be visible when recovery runs.
+- A section ID is stable while its start entry ID is stable, but scope changes
+  can change section membership.
+- Parent-session metadata is reported when Pi exposes it; parent files are not
+  traversed.
+
+## Verification
+
+Deterministic tests cover active versus all branches, raw pre-compaction search,
+stable section IDs, Unicode case-insensitive search, bounded output, empty
+sessions, current-call exclusion, recent errors, file carry-forward details,
+and conservative handling of unknown entries. Release verification runs the
+suite typecheck/tests/smoke gate, host `npm run check`, and then syncs the suite
+with `npm run sync:pi-tools-suite`.
+
+## Evidence
+
+Evidence is recorded by the implementation tests in
+`test/session-recovery.test.ts` and the verification commands reported with the
+change.