pi-ui-extend 1.0.42 → 1.0.46

package/README.md

@@ -34,7 +34,7 @@ Pi provides the agent runtime, models, tools, skills, extensions, and persistent
 - **Keep projects organized.** Tabs are scoped to the working directory and survive restarts. Search, resume, fork, clone, jump through, import, export, share, or delete sessions without leaving the terminal.
 - **Stay in flow.** Run quick commands with `!`, open a raw interactive terminal with `!!`, paste images, follow file links, dictate in English or Russian, and improve a prompt before sending it.
 - **Know what the agent is doing.** The status area exposes model, thinking level, context, usage, workspace, todos, sub-agents, voice state, and prompt actions — with mouse targets where useful.
-- **Bring a serious toolkit.** Pix ships with `pi-tools-suite`: 18 integrated modules for indexed repository discovery, AST edits, LSP diagnostics, parallel agents, durable todos, context compression, web access, provider accounts, and more.
+- **Bring a serious toolkit.** Pix ships with `pi-tools-suite`: 21 integrated modules for indexed repository discovery, AST edits, LSP diagnostics, parallel agents, durable todos, context compression, web access, provider accounts, and more.
 - **Use the models you want.** Pix runs on Pi's provider ecosystem and supports model switching, scoped model lists, per-model thinking levels, usage views, autocomplete, and fallback-aware helper workflows.
 
 Pix is not a separate agent protocol or an RPC wrapper around Pi. It runs on the Pi SDK, so the runtime, session format, extensions, skills, prompts, and tools remain part of the same ecosystem.
@@ -97,6 +97,8 @@ On startup, Pix tries to link the bundled suite into the active Pi agent directo
 | Providers and quotas | `antigravity-auth`, `opencode-import`, `usage` | Antigravity OAuth/account failover, OpenCode credential import, and multi-provider usage views. |
 | Reusable workflows | `prompt-commands`, `resource-registry`, `session-name` | Prompt-command CRUD, private Git-backed skill/agent install/update/push/remote-remove/local-uninstall with reload-on-change, project-scoped `.pi/tasks.jsonc` + `.pi/plans/` + `.pi/TODO.md` sync, a Desktop Registry sidebar for status/actions/configuration, and session naming. |
 | Model compatibility | `coding-discipline`, `model-tools`, `codex-reasoning-fix` | Model-specific discipline and vision lookup, compatibility aliases, and a Codex reasoning payload workaround. |
+| Agent session context | `session-recovery` | Bounded session overview/search/section tools so agents can recover prior context. |
+| Payload hygiene | `context-gateway`, `truncation-metadata-normalizer`, `credential-firewall` | Observe-only result-chain gateway, opt-in truncation-metadata cleanup, and an opt-in secret firewall. |
 
 Every module can be disabled. Optional integrations only activate when their requirements are available — for example, repository tools require an index, web tools require local Ollama web search, and LSP servers must be configured and trusted.
 
@@ -136,8 +138,8 @@ Recommended:
 
 Optional:
 
-- the `vosk` optional dependency for local voice input
-- an audio recorder for dictation: SoX (`rec`/`sox`), `ffmpeg`, or `arecord` on Linux
+- a Deepgram API key in `dictation.apiKey` inside `~/.config/pi/pix.jsonc` for voice input; `DEEPGRAM_API_KEY` remains supported as a fallback
+- an audio recorder for terminal dictation: SoX (`rec`/`sox`), `ffmpeg`, or `arecord` on Linux
 - `tmux` and `rsvg-convert` only if you want to regenerate README screenshots
 - Ollama with web search enabled for the bundled `web_search` and `web_fetch` tools
 - language servers for the LSP module (see [LSP setup](external/pi-tools-suite/README.md#lsp-setup) for install commands and ready-to-paste configs for popular servers, including Svelte, Vue, Go, clangd, Lua, and bash)
@@ -210,7 +212,7 @@ Pix uses Pi's model and authentication stores. Environment-based API keys and cr
 | Model-backed helpers | No | Review `promptEnhancer`, `autocomplete`, and `sessionTitle` in `pix.jsonc` | Each configured helper model needs credentials for its own provider; it need not use the main session provider. |
 | Ollama/Tavily web access | No | Use local Ollama without a cloud key, set `OLLAMA_API_KEY`/`TAVILY_API_KEY`, or run `/web-credentials` | Stored keys live in `~/.config/pi/pi-tools-suite-credentials.json` with mode `0600`. |
 | Context7 documentation skill | No | Export `CONTEXT7_API_KEY` | The skill fails before making a network request when the variable is absent. |
-| Telegram terminal bell | No | Configure `terminalBell.telegram` or `PI_TERMINAL_BELL_TELEGRAM_BOT_TOKEN` plus `PI_TERMINAL_BELL_TELEGRAM_CHAT_ID` | Used only for the optional terminal notification integration. |
+| Telegram task connector | No | Configure `telegramConnector.botToken` + `telegramConnector.chatId`, or `PIX_TELEGRAM_BOT_TOKEN` + `PIX_TELEGRAM_CHAT_ID` | Completion/question notifications; reply to continue the exact live session, or use `/new <task>` for a fresh session. |
 
 `pix install` reports whether these sources appear configured, but never displays, copies, or overwrites token values.
 
@@ -267,6 +269,12 @@ Pix can provide inline, model-backed autocomplete with configurable debounce, ti
 - While it runs, submit editor text to its stdin; use `Ctrl-C` to interrupt.
 - `!!command` opens a raw interactive terminal for REPLs, TUIs, debuggers, and development servers. Exit it to return to Pix.
 
+### Git helpers
+
+- `/code-review` reviews staged, unstaged, and untracked Git changes with the configured review model and prints the findings locally in the TUI.
+- `/commit-message` generates a message from staged changes, shows the full message, and asks for confirmation before running `git commit`. If the staged diff changes before confirmation completes, Pix refuses the commit and asks you to regenerate the message.
+- These helpers use the existing `desktop.git.reviewModelRef` / `reviewFallbackModels` and `desktop.git.commitMessageModelRef` / `commitMessageFallbackModels` settings for compatibility. `/commit-message` never stages changes or bypasses Git hooks.
+
 ### Images, clipboard, and files
 
 - Paste an image from the clipboard with `Ctrl+V`/`Cmd+V` in supported terminals.
@@ -274,14 +282,25 @@ Pix can provide inline, model-backed autocomplete with configurable debounce, ti
 - `/copy` copies the last assistant message.
 - Pix integrates with the native clipboard on macOS and Windows and common Wayland/X11 helpers on Linux.
 
-### Local voice input
+### Voice input
+
+Put the Deepgram key in the user Pix config:
+
+```jsonc
+{
+  "dictation": {
+    "apiKey": "your-deepgram-api-key"
+  }
+}
+```
+
+The file is `~/.config/pi/pix.jsonc`. Keep the key in this user config rather than a project `.pi/pix.jsonc`; project config is intentionally not allowed to override the secret. `DEEPGRAM_API_KEY` remains supported as a compatibility fallback when `dictation.apiKey` is not set.
 
-Press `Ctrl+G` or click the microphone in the status area to start/stop dictation. Pix supports configurable local Vosk models and ships defaults for:
+Then press `Ctrl+G` or click the microphone in the terminal status area to start/stop dictation. Pix streams microphone audio to Deepgram Nova-3 and inserts finalized text into the editor so you can review it before sending. The default dictation languages are English and Russian and can be changed with the existing language control.
 
-- English: `vosk-model-small-en-us-0.15`
-- Russian: `vosk-model-small-ru-0.22`
+Pix Desktop exposes the same voice-input action directly in the message composer. The desktop client uses Nova-3 and respects `dictation.language` plus the selected language's `deepgramLanguage` value from the user Pix config. It requests a short-lived Deepgram token from the local Tauri backend; the permanent API key is read from the user Pix config (or the environment fallback) by Rust and is never exposed to the WebView. The Settings UI also exposes `Dictation · Api Key` as a sensitive field because it is generated from the Pix schema.
 
-The selected model is downloaded on first use. Recognition is local; the resulting text is inserted into the editor so you can review it before sending.
+Voice audio is sent to Deepgram while recording. Pix no longer downloads or installs local speech-recognition models.
 
 ### Workspace undo
 
@@ -312,6 +331,7 @@ Type `/` for the live, searchable list. Extensions can add more commands than th
 | Models | `/model`, `/default-model`, `/scoped-models`, `/thinking`, `/default-thinking`, `/autocomplete` |
 | Project context | `/no-context-files`, `/compact` |
 | Prompt workflow | `/enhance`, `/queue`, `/copy` |
+| Git | `/code-review`, `/commit-message` |
 | Sessions | `/new`, `/new_tab`, `/resume`, `/name`, `/session`, `/search`, `/history`, `/jump`, `/tree` |
 | Branching and files | `/fork`, `/clone`, `/delete`, `/export`, `/import`, `/share` |
 | Status | `/usage` |
@@ -361,6 +381,7 @@ Both support the published schema:
   "$schema": "https://unpkg.com/pi-ui-extend/schemas/pix.json",
   "defaultModel": {
     "modelRef": "openai-codex/gpt-5.6-sol",
+    "fallbackModels": [],
     "thinking": "medium"
   },
   "toolRenderer": {
@@ -371,9 +392,10 @@ Both support the published schema:
       "apply_patch": { "defaultExpanded": true }
     }
   },
-  "promptEnhancer": { "modelRef": "openai-codex/gpt-5.6-luna" },
+  "promptEnhancer": { "modelRef": "openai-codex/gpt-5.6-luna", "fallbackModels": [] },
   "autocomplete": {
     "modelRef": "zai/glm-5-turbo",
+    "fallbackModels": [],
     "debounceMs": 350,
     "timeoutMs": 3000
   },
@@ -387,6 +409,12 @@ Both support the published schema:
 }
 ```
 
+Singular model selectors resolve with an explicit ordered fallback array, even
+when it is empty. Existing configs that omit the array remain compatible and
+normalize to `[]`. Pix uses `fallbackModels` for object selectors; Desktop Git
+uses `reviewFallbackModels` and `commitMessageFallbackModels` beside the
+corresponding primary model refs.
+
 Configurable areas include:
 
 - default model and thinking level;
@@ -449,7 +477,7 @@ Install `wl-clipboard` on Wayland or `xclip`/`xsel` on X11, then run `pix instal
 
 ### Voice input is unavailable
 
-Ensure the optional `vosk` dependency installed successfully, the configured model URL is reachable for its first download, and an audio recorder is available: SoX (`rec`/`sox`), `ffmpeg`, or `arecord` on Linux. Voice support can be omitted without affecting the rest of Pix.
+Ensure `dictation.apiKey` is set in `~/.config/pi/pix.jsonc`, or set the compatibility fallback `DEEPGRAM_API_KEY` in the environment that launches Pix. Terminal voice input also needs an audio recorder: SoX (`rec`/`sox`), `ffmpeg`, or `arecord` on Linux. Pix Desktop additionally needs microphone permission from the operating system. Voice support can be omitted without affecting the rest of Pix.
 
 ### A provider login dialog is missing
 
@@ -508,7 +536,8 @@ npm run watch:all
 `watch:all` rebuilds only the affected project parts. It keeps the last working
 Desktop process alive while changes compile, then replaces it only after the
 entire queued build succeeds. A failed build is reported without replacing the
-running Desktop.
+running Desktop. Desktop web changes rebuild the Vite bundle first and then
+invalidate the native Tauri asset embedding before the replacement app starts.
 
 Regenerate the README screenshots without accounts or live model traffic:
 

package/dist/app/app.d.ts

@@ -68,9 +68,18 @@ export declare class PiUiExtendApp {
     private voicePartialText;
     private resumeSessions;
     private resumeLoading;
+    private draftModels;
+    private draftModelRef;
+    private draftThinkingLevel;
+    private draftModelOverrideRef;
     constructor(options: AppOptions);
     private createRuntime;
     private loadStartupConfig;
+    private refreshDraftModelCatalog;
+    private resetDraftModelSelection;
+    private selectDraftModel;
+    private draftModelState;
+    private draftModelStatus;
     private applyPixConfig;
     private updateOutputFilters;
     start(): Promise<void>;
@@ -78,6 +87,7 @@ export declare class PiUiExtendApp {
     private bindCurrentSession;
     private awaitCurrentSessionExtensions;
     private activateRuntime;
+    private deactivateRuntimeForDraft;
     private createExtensionEventBus;
     private subagentTypesForRuntime;
     private contextInventoryText;

package/dist/app/app.js

@@ -1,6 +1,6 @@
 import { THEMES } from "../theme.js";
 import { InputEditor } from "../input-editor.js";
-import { compileOutputFilterPatterns, defaultPixConfig, loadPixConfig, resolveToolRule, } from "../config.js";
+import { compileOutputFilterPatterns, defaultPixConfig, loadPixConfig, resolveDefaultModelRef, resolveToolRule, savePixThinkingLevelForModel, savePixVisibleModels, } from "../config.js";
 import { AppCommandController } from "./commands/command-controller.js";
 import { ConversationViewport } from "./rendering/conversation-viewport.js";
 import { renderRegisteredExtensionEntry } from "./rendering/extension-entry-renderer.js";
@@ -23,7 +23,8 @@ import { AppAutocompleteController } from "./input/autocomplete-controller.js";
 import { AppQueuedMessageController } from "./session/queued-message-controller.js";
 import { AppRequestHistory } from "./session/request-history.js";
 import { AppRenderController } from "./rendering/render-controller.js";
-import { createPixRuntime } from "./runtime.js";
+import { createPixDraftModelCatalog, createPixRuntime } from "./runtime.js";
+import { parseModelRef } from "./model/model-ref.js";
 import { ScreenStyler } from "./screen/screen-styler.js";
 import { AppScrollController } from "./screen/scroll-controller.js";
 import { searchResultScrollNeedles, searchResultTargetEntry } from "./session/session-search.js";
@@ -142,6 +143,10 @@ export class PiUiExtendApp {
     voicePartialText;
     resumeSessions = [];
     resumeLoading = false;
+    draftModels = [];
+    draftModelRef;
+    draftThinkingLevel = "off";
+    draftModelOverrideRef;
     constructor(options) {
         this.options = options;
         this.theme = THEMES[options.themeName];
@@ -170,6 +175,7 @@ export class PiUiExtendApp {
             theme: this.theme,
             blinkController: this.blinkController,
             runtimeSession: () => this.runtime?.session,
+            draftModelStatus: () => this.draftModelStatus(),
             render: () => this.scheduleRender(),
         });
         this.agentPauseController = new AgentPauseController({
@@ -186,7 +192,7 @@ export class PiUiExtendApp {
             maxProjectSessions: () => this.pixConfig.maxProjectSessions,
             blinkController: this.blinkController,
             runtime: () => this.runtime,
-            createRuntimeForNewSession: () => this.createRuntime(
+            createRuntimeForNewSession: (modelRef) => this.createRuntime(
             // Never reuse services across tabs. The SDK ties the extension
             // runtime (resourceLoader.getExtensions().runtime) to the
             // resourceLoader, and that runtime is shared by every session
@@ -197,12 +203,18 @@ export class PiUiExtendApp {
             // then throw "ctx is stale after session replacement or reload".
             // Fresh services per session = fresh extension runtime = no
             // cross-session invalidation.
-            newTabRuntimeOptions(this.options)),
+            {
+                ...newTabRuntimeOptions(this.options),
+                ...(modelRef ? { modelRef } : {}),
+            }),
             createRuntimeForSession: (sessionPath) => this.createRuntime({
                 ...this.options,
                 noSession: false,
                 sessionPath,
             }),
+            draftModelOverrideRef: () => this.draftModelOverrideRef,
+            resetDraftModelSelection: () => this.resetDraftModelSelection(),
+            deactivateRuntimeForDraft: () => this.deactivateRuntimeForDraft(),
             awaitCurrentSessionExtensions: (runtime) => this.awaitCurrentSessionExtensions(runtime),
             activateRuntime: (runtime, options) => this.activateRuntime(runtime, options),
             disposeRuntime: (runtime) => this.terminalController.disposeRuntime(runtime),
@@ -224,6 +236,12 @@ export class PiUiExtendApp {
             restoreAutoUserMessages: (messages) => this.queuedMessages.restoreAutoUserMessages(messages),
             captureDeferredUserMessages: () => this.queuedMessages.captureDeferredUserMessages(),
             restoreDeferredUserMessages: (messages) => this.queuedMessages.restoreDeferredUserMessages(messages),
+            openDraftSessionSelector: () => {
+                void this.commandController.runDraftSessionSelector();
+            },
+            closeDraftSessionSelector: () => {
+                this.popupMenus.closeDraftSessionSelectorForTabLifecycle();
+            },
             contextInventoryText: (runtime, heading) => this.contextInventoryText(runtime, heading),
             addEntry: (entry) => this.addEntry(entry),
             showToast: (message, kind) => this.showToast(message, kind),
@@ -262,9 +280,12 @@ export class PiUiExtendApp {
         }, this.pixConfig.dictation);
         this.menuItems = new AppMenuItemsController({
             runtime: () => this.runtime,
+            draftModelState: () => this.draftModelState(),
+            visibleModels: () => this.pixConfig.visibleModels,
             getBuiltinSlashCommands: () => this.slashCommands,
             getEntries: () => this.entries,
             getResumeSessions: () => this.resumeSessions,
+            getOpenSessionPaths: () => this.tabsController.openSessionPaths(),
         });
         const popupMenuRenderer = new PopupMenuRenderer({
             theme: this.theme,
@@ -279,6 +300,8 @@ export class PiUiExtendApp {
         this.popupMenus = new AppPopupMenuController({
             get entries() { return app.entries; },
             get session() { return app.runtime?.session; },
+            currentThinkingLevel: () => this.runtime?.session.thinkingLevel ?? this.draftModelState()?.thinkingLevel,
+            rememberedThinkingLevel: (modelRef) => this.pixConfig.thinkingByModel?.[modelRef],
             get resumeLoading() { return app.resumeLoading; },
             get resumeSessionCount() { return app.resumeSessions.length; },
             isRunning: () => this.running,
@@ -286,9 +309,9 @@ export class PiUiExtendApp {
             setInput: (value) => this.setInput(value),
             parseSlashInput: (text) => this.menuItems.parseSlashInput(text),
             getSlashCommandMenuItems: (query) => this.menuItems.getSlashCommandMenuItems(query),
-            getModelMenuItems: (query) => this.menuItems.getModelMenuItems(query),
+            getModelMenuItems: (query, includeHidden) => this.menuItems.getModelMenuItems(query, includeHidden),
             getThinkingMenuItems: (query) => this.menuItems.getThinkingMenuItems(query),
-            getResumeMenuItems: (query, limit) => this.menuItems.getResumeMenuItems(query, limit),
+            getResumeMenuItems: (query, limit, options) => this.menuItems.getResumeMenuItems(query, limit, options),
             getUserMessageMenuItems: () => this.menuItems.getUserMessageMenuItems(),
             getUserMessageJumpMenuItems: (query) => this.menuItems.getUserMessageJumpMenuItems(query),
             getQueueMessageMenuItems: () => this.menuItems.getQueueMessageMenuItems(),
@@ -302,6 +325,7 @@ export class PiUiExtendApp {
             theme: this.theme,
             screenStyler: this.screenStyler,
             get session() { return app.runtime?.session; },
+            draftModelStatus: () => this.draftModelStatus(),
             modelColors: this.pixConfig.modelColors,
             get sessionActivity() { return app.statusController.sessionActivity; },
             get statusDotBright() { return app.statusController.statusDotBright; },
@@ -377,6 +401,7 @@ export class PiUiExtendApp {
         });
         this.subagentsWidgetController = new AppSubagentsWidgetController({
             cwd: this.options.cwd,
+            hasActiveRuntime: () => this.runtime !== undefined,
             sessionFile: () => this.runtime?.session.sessionFile,
             isRunning: () => this.running,
             render: () => this.scheduleRender(),
@@ -513,6 +538,7 @@ export class PiUiExtendApp {
         this.commandController = new AppCommandController({
             options: this.options,
             runtime: () => this.runtime,
+            inputScopeKey: () => this.tabsController.activeInputTabId(),
             subagentTypes: (runtime) => this.subagentTypesForRuntime(runtime),
             requestHistory: () => this.requestHistory,
             getInput: () => this.input,
@@ -558,6 +584,7 @@ export class PiUiExtendApp {
             setDirectPopupMenuQuery: (query) => {
                 this.popupMenus.setDirectQuery(query);
             },
+            setResumeMenuMode: (mode) => this.popupMenus.setResumeMenuMode(mode),
             refreshUserMessageJumpMenuItems: () => this.menuItems.refreshUserMessageJumpMenuItems(),
             getResumeLoading: () => this.resumeLoading,
             getResumeSessions: () => this.resumeSessions,
@@ -576,6 +603,10 @@ export class PiUiExtendApp {
         });
         this.popupActions = new AppPopupActionController({
             runtime: () => this.runtime,
+            inputScopeKey: () => this.tabsController.activeInputTabId(),
+            isDraftTabActive: () => this.tabsController.isDraftTabActive(),
+            materializeDraftSession: () => this.tabsController.materializeActiveDraftTab(),
+            selectDraftModel: (model, thinkingLevel) => this.selectDraftModel(model, thinkingLevel),
             getBuiltinSlashCommands: () => this.slashCommands,
             isRunning: () => this.running,
             setInput: (value) => this.setInput(value),
@@ -583,9 +614,20 @@ export class PiUiExtendApp {
             setStatus: (status) => this.setStatus(status),
             setSessionStatus: (session) => this.setSessionStatus(session),
             showToast: (message, kind) => this.showToast(message, kind),
+            visibleModels: () => this.pixConfig.visibleModels,
+            saveVisibleModels: (modelRefs) => {
+                const saved = savePixVisibleModels(modelRefs);
+                this.pixConfig.visibleModels = [...saved];
+                return saved;
+            },
+            saveThinkingLevelForModel: (modelRef, thinkingLevel) => {
+                const saved = savePixThinkingLevelForModel(modelRef, thinkingLevel);
+                this.pixConfig.thinkingByModel = { ...saved };
+            },
             render: () => this.render(),
             awaitCurrentSessionExtensions: (runtime) => this.awaitCurrentSessionExtensions(runtime),
             afterSessionReplacement: (message) => this.afterSessionReplacement(message),
+            openSessionInActiveDraftTab: (sessionPath) => this.tabsController.openSessionInActiveDraftTab(sessionPath),
             scrollToConversationEntry: (entryId) => this.scrollController.scrollToConversationEntry(entryId),
             scrollToUserMessageJumpTarget: (target) => this.scrollToUserMessageJumpTarget(target),
         }, this.popupMenus, this.commandController, this.menuItems, this.queuedMessages, this.workspaceActions);
@@ -697,6 +739,8 @@ export class PiUiExtendApp {
         this.inputActions = new AppInputActionController({
             runtime: () => this.runtime,
             inputScopeKey: () => this.tabsController.activeInputTabId(),
+            isDraftTabActive: () => this.tabsController.isDraftTabActive(),
+            materializeDraftSession: () => this.tabsController.materializeActiveDraftTab(),
             isRunning: () => this.running,
             isSessionSwitching: () => this.tabsController.isSwitching(),
             inputEditor: () => this.inputEditor,
@@ -736,6 +780,7 @@ export class PiUiExtendApp {
             resetInputMenuDismissals: () => this.popupMenus.resetInputMenuDismissals(),
             render: () => this.render(),
             moveActivePopupMenuSelection: (delta) => this.popupMenus.moveActivePopupMenuSelection(delta),
+            moveActiveModelThinkingLevel: (delta) => this.popupMenus.moveActiveModelThinkingLevel(delta),
             navigateRequestHistory: (delta) => this.requestHistory.navigate(delta),
             scrollByLines: (delta) => this.scrollController.scrollByLines(delta),
             scrollByPage: (delta) => this.scrollController.scrollByPage(delta),
@@ -744,8 +789,8 @@ export class PiUiExtendApp {
             handleInterrupt: () => this.inputActions.handleInterrupt(),
             handleEscape: () => this.inputActions.handleEscape(),
             handleDirectPopupInput: (char) => this.popupMenus.handleDirectPopupInput(char),
+            toggleModelVisibilityMode: () => this.popupMenus.toggleModelVisibilityMode(),
             autocompleteModel: () => this.popupMenus.autocompleteModel(),
-            autocompleteThinking: () => this.popupMenus.autocompleteThinking(),
             acceptAutocompleteSuggestion: () => this.autocompleteController.acceptSuggestion(),
             autocompleteSlashCommand: () => this.popupMenus.autocompleteSlashCommand(),
             toggleVoiceRecording: () => {
@@ -780,7 +825,10 @@ export class PiUiExtendApp {
         });
         this.sessionLifecycle = new AppSessionLifecycleController({
             options: this.options,
-            createRuntime: () => this.createRuntime(this.options),
+            prepareStartupRuntime: () => this.tabsController.prepareStartupRuntime(),
+            createRuntime: (startup) => this.createRuntime(startup?.sessionPath
+                ? { ...this.options, noSession: false, sessionPath: startup.sessionPath }
+                : this.options),
             entries: this.entries,
             runtime: () => this.runtime,
             setRuntime: (runtime) => {
@@ -863,6 +911,59 @@ export class PiUiExtendApp {
     async loadStartupConfig() {
         await yieldToEventLoop();
         this.applyPixConfig(loadPixConfig(this.options.cwd));
+        await this.refreshDraftModelCatalog();
+    }
+    async refreshDraftModelCatalog() {
+        try {
+            this.draftModels = await createPixDraftModelCatalog({ cwd: this.options.cwd });
+        }
+        catch {
+            this.draftModels = [];
+        }
+        this.resetDraftModelSelection();
+    }
+    resetDraftModelSelection() {
+        this.draftModelOverrideRef = undefined;
+        const configuredRef = this.options.modelRef ?? resolveDefaultModelRef(this.pixConfig);
+        if (configuredRef) {
+            try {
+                const parsed = parseModelRef(configuredRef);
+                this.draftModelRef = `${parsed.provider}/${parsed.modelId}`;
+                this.draftThinkingLevel = parsed.thinkingLevel ?? "off";
+                return;
+            }
+            catch {
+                // Runtime creation will surface an invalid configured model. Keep the
+                // draft picker usable so the user can select a valid model first.
+            }
+        }
+        const first = this.draftModels[0];
+        this.draftModelRef = first ? `${first.provider}/${first.id}` : undefined;
+        this.draftThinkingLevel = "off";
+    }
+    selectDraftModel(model, thinkingLevel) {
+        if (!this.tabsController.isDraftTabActive())
+            return;
+        const ref = `${model.provider}/${model.id}`;
+        this.draftModelRef = ref;
+        this.draftThinkingLevel = thinkingLevel;
+        this.draftModelOverrideRef = `${ref}:${thinkingLevel}`;
+        this.setStatus("new conversation");
+    }
+    draftModelState() {
+        if (!this.tabsController.isDraftTabActive())
+            return undefined;
+        return {
+            models: this.draftModels,
+            ...(this.draftModelRef ? { modelRef: this.draftModelRef } : {}),
+            thinkingLevel: this.draftThinkingLevel,
+        };
+    }
+    draftModelStatus() {
+        const state = this.draftModelState();
+        if (!state?.modelRef)
+            return undefined;
+        return { modelLabel: state.modelRef, thinkingLabel: state.thinkingLevel };
     }
     applyPixConfig(config) {
         replaceRecord(this.pixConfig.toolRenderer, config.toolRenderer);
@@ -876,6 +977,14 @@ export class PiUiExtendApp {
             delete this.pixConfig.defaultModel;
         else
             this.pixConfig.defaultModel = { ...config.defaultModel };
+        if (config.visibleModels === undefined)
+            delete this.pixConfig.visibleModels;
+        else
+            this.pixConfig.visibleModels = [...config.visibleModels];
+        if (config.thinkingByModel === undefined)
+            delete this.pixConfig.thinkingByModel;
+        else
+            this.pixConfig.thinkingByModel = { ...config.thinkingByModel };
         this.pixConfig.ignoreContextFiles = config.ignoreContextFiles;
         this.pixConfig.maxProjectSessions = config.maxProjectSessions;
         this.updateOutputFilters();
@@ -946,6 +1055,20 @@ export class PiUiExtendApp {
         });
         await this.bindCurrentSession(options);
     }
+    deactivateRuntimeForDraft() {
+        const runtime = this.runtime;
+        if (!runtime)
+            return;
+        const scopeKey = this.activeExtensionUiScope();
+        // Clear the visible runtime before any UI cleanup. cancelCustomUi() can
+        // synchronously render; leaving the old runtime attached during that render
+        // lets tab synchronization incorrectly reactivate the previous real tab.
+        this.runtime = undefined;
+        this.extensionUiController.cancelCustomUi(scopeKey);
+        this.extensionUiController.clearWidgets(scopeKey, { cancelCustomUi: false });
+        void this.voiceController.stopRecording();
+        this.sessionLifecycle.unsubscribeSession();
+    }
     createExtensionEventBus() {
         return createIsolatedExtensionEventBus((channel, data) => {
             if (channel === TERMINAL_BELL_ATTENTION_EVENT)
@@ -1276,6 +1399,7 @@ export class PiUiExtendApp {
         if (contentVersion === this.lastInputEditorContentVersion)
             return;
         this.lastInputEditorContentVersion = contentVersion;
+        this.tabsController.noteActiveDraftInputChanged();
         this.scrollController.scrollToBottom();
     }
     conversationQuickScrollDirections() {

package/dist/app/cli/install.js

@@ -59,7 +59,7 @@ export function inspectPixOnboarding(homeDir = homedir(), env = process.env) {
         opencodeAntigravityExists: pixInstallDeps.existsSync(join(opencodeConfigDir, "antigravity-accounts.json")),
         webCredentialsConfigured: Boolean(env.OLLAMA_API_KEY?.trim() || env.TAVILY_API_KEY?.trim()) || jsonObjectHasEntries(webCredentialPath),
         context7Configured: Boolean(env.CONTEXT7_API_KEY?.trim()),
-        telegramConfigured: Boolean(env.PI_TERMINAL_BELL_TELEGRAM_BOT_TOKEN?.trim() && env.PI_TERMINAL_BELL_TELEGRAM_CHAT_ID?.trim()),
+        telegramConfigured: Boolean(env.PIX_TELEGRAM_BOT_TOKEN?.trim() && env.PIX_TELEGRAM_CHAT_ID?.trim()),
     };
 }
 export function ensurePixSetupFiles(homeDir = homedir()) {
@@ -106,7 +106,7 @@ export function formatPixInstallNextSteps(homeDir = homedir(), state = inspectPi
         "Optional integrations:",
         `  ${state.webCredentialsConfigured ? "✓ Web credentials detected." : "○ Web search: use local Ollama without a key, or run /web-credentials for Ollama Cloud/Tavily."}`,
         `  ${state.context7Configured ? "✓ Context7 API key detected." : "○ Context7 docs skill: export CONTEXT7_API_KEY."}`,
-        `  ${state.telegramConfigured ? "✓ Telegram terminal-bell credentials detected in the environment." : "○ Telegram bell: set terminalBell.telegram in Pix config or PI_TERMINAL_BELL_TELEGRAM_* env vars."}`,
+        `  ${state.telegramConfigured ? "✓ Telegram connector credentials detected in the environment." : "○ Telegram connector: set telegramConnector in tools config or PIX_TELEGRAM_BOT_TOKEN plus PIX_TELEGRAM_CHAT_ID."}`,
         "  ○ Model-backed helpers: review promptEnhancer, autocomplete, and sessionTitle model refs; each provider needs its own credentials.",
         "  ○ Voice: set dictation.language in Pix config. LSP: configure and trust servers under lsp.servers in tools config.",
         "",

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

@@ -4,14 +4,18 @@ export declare class AppCommandController {
     private readonly host;
     readonly slashCommands: readonly SlashCommand[];
     private readonly modelActions;
+    private readonly gitActions;
     private readonly sessionActions;
     private readonly navigationActions;
     constructor(host: CommandControllerHost);
     runResumeCommand(queryOrOptions?: string | {
         preserveStatus?: boolean;
         placement?: PopupMenuPlacement;
+        draft?: boolean;
     }): Promise<void>;
+    runDraftSessionSelector(): Promise<void>;
     runModelCommand(model: SessionModel): Promise<void>;
+    runModelThinkingCommand(model: SessionModel, level: ThinkingLevel): Promise<void>;
     runThinkingCommand(level: ThinkingLevel): Promise<void>;
     private registryActions;
 }

package/dist/app/commands/command-controller.js

@@ -1,3 +1,4 @@
+import { GitCommandActions } from "./command-git-actions.js";
 import { ModelCommandActions } from "./command-model-actions.js";
 import { NavigationCommandActions } from "./command-navigation-actions.js";
 import { createSlashCommands } from "./command-registry.js";
@@ -6,11 +7,13 @@ export class AppCommandController {
     host;
     slashCommands;
     modelActions;
+    gitActions;
     sessionActions;
     navigationActions;
     constructor(host) {
         this.host = host;
         this.modelActions = new ModelCommandActions(host);
+        this.gitActions = new GitCommandActions(host);
         this.sessionActions = new SessionCommandActions(host);
         this.navigationActions = new NavigationCommandActions(host);
         this.slashCommands = createSlashCommands(this.registryActions(), host);
@@ -18,9 +21,15 @@ export class AppCommandController {
     async runResumeCommand(queryOrOptions = "") {
         await this.navigationActions.runResumeCommand(queryOrOptions);
     }
+    async runDraftSessionSelector() {
+        await this.navigationActions.runResumeCommand({ preserveStatus: true, placement: "draft-surface", draft: true });
+    }
     async runModelCommand(model) {
         await this.modelActions.runModelCommand(model);
     }
+    async runModelThinkingCommand(model, level) {
+        await this.modelActions.runModelThinkingCommand(model, level);
+    }
     async runThinkingCommand(level) {
         await this.modelActions.runThinkingCommand(level);
     }
@@ -35,6 +44,8 @@ export class AppCommandController {
             runThinkingSlashCommand: (argumentsText) => this.modelActions.runThinkingSlashCommand(argumentsText),
             runDefaultThinkingSlashCommand: (argumentsText) => this.modelActions.runDefaultThinkingSlashCommand(argumentsText),
             runEnhanceCommand: () => this.host.enhancePrompt(),
+            runCodeReviewCommand: () => this.gitActions.runCodeReviewCommand(),
+            runCommitMessageCommand: () => this.gitActions.runCommitMessageCommand(),
             runExportCommand: (argumentsText) => this.sessionActions.runExportCommand(argumentsText),
             runImportCommand: (argumentsText) => this.sessionActions.runImportCommand(argumentsText),
             runShareCommand: () => this.sessionActions.runShareCommand(),

package/dist/app/commands/command-git-actions.d.ts

@@ -0,0 +1,25 @@
+import type { AgentSessionRuntime } from "@earendil-works/pi-coding-agent";
+import { type AsyncProcessResult, type RunProcessOptions } from "../process.js";
+import { type CommandControllerHost } from "./command-host.js";
+export type GitAssistantKind = "review" | "commit-message";
+type GitProcessRunner = (command: string, args?: readonly string[], options?: RunProcessOptions) => Promise<AsyncProcessResult>;
+type GitAssistantRunner = (runtime: AgentSessionRuntime, kind: GitAssistantKind, diff: string) => Promise<string>;
+export type GitCommandActionsDeps = {
+    runProcess?: GitProcessRunner;
+    generateGitAssistantText?: GitAssistantRunner;
+};
+export declare class GitCommandActions {
+    private readonly host;
+    private readonly runProcess;
+    private readonly generateGitAssistantText;
+    constructor(host: CommandControllerHost, deps?: GitCommandActionsDeps);
+    runCodeReviewCommand(): Promise<void>;
+    runCommitMessageCommand(): Promise<void>;
+    private gitRoot;
+    private trackedDiff;
+    private reviewInput;
+    private untrackedFiles;
+}
+export declare function generateGitAssistantText(runtime: AgentSessionRuntime, kind: GitAssistantKind, diff: string): Promise<string>;
+export declare function loadGitAssistantModelRefs(cwd: string, kind: GitAssistantKind, homeDir?: string): string[];
+export {};