pi-ui-extend 1.0.41 → 1.0.45

package/dist/schemas/pi-tools-suite-schema.js

@@ -26,19 +26,23 @@ const ToolRendererConfig = Type.Object({
 // ---------------------------------------------------------------------------
 // Terminal bell
 // ---------------------------------------------------------------------------
-const TerminalBellTelegramConfig = Type.Object({
-    botToken: Type.Optional(Type.String({ description: "Telegram bot token (from @BotFather) used to send completion/error/question notifications." })),
-    chatId: Type.Optional(Type.String({ description: "Telegram chat id that receives the notifications. Message @userinfobot to look yours up." })),
-}, { description: "Forward terminal-bell notifications to a Telegram chat. Independent of the bundled desktop sound gate." });
 const TerminalBellConfig = Type.Object({
     sound: Type.Optional(Type.Boolean({ description: "Play terminal bell sound on completion/error." })),
-    telegram: Type.Optional(TerminalBellTelegramConfig),
 }, { description: "Terminal bell configuration." });
+const TelegramConnectorConfig = Type.Object({
+    enabled: Type.Optional(Type.Boolean({ description: "Enable the Telegram task connector. Defaults to enabled when botToken and chatId are present." })),
+    botToken: Type.Optional(Type.String({ description: "Telegram Bot API token from @BotFather." })),
+    chatId: Type.Optional(Type.Union([
+        Type.String(),
+        Type.Integer(),
+    ], { description: "Private Telegram chat id allowed to control Pix." })),
+}, { description: "Receive completion/question notifications and send follow-up or new-session tasks from Telegram." });
 // ---------------------------------------------------------------------------
 // DCP (Dynamic Context Pruning)
 // ---------------------------------------------------------------------------
 const DcpManualModeConfig = Type.Object({
     enabled: Type.Optional(Type.Boolean({ description: "Enable manual DCP mode." })),
+    automaticStrategies: Type.Optional(Type.Never({ description: "Removed legacy key. Manual mode now has only the explicit enabled flag." })),
 }, { description: "Manual mode configuration." });
 const DcpAutoCandidatesConfig = Type.Object({
     enabled: Type.Optional(Type.Boolean({ description: "Enable auto candidate selection for compression." })),
@@ -56,16 +60,17 @@ const DcpMessageModeConfig = Type.Object({
     maxSuggestions: Type.Optional(Type.Number({ description: "Maximum compression suggestions.", minimum: 0 })),
 }, { description: "Message-mode compression configuration." });
 const DcpAutoCompressConfig = Type.Object({
-    enabled: Type.Optional(Type.Boolean({ description: "Allow bounded automatic summary creation after pressure/opportunity gates." })),
+    enabled: Type.Optional(Type.Boolean({ description: "Allow autonomous compression after pressure/opportunity gates. Explicit compress calls can still use summarizerModel when summary is omitted." })),
     patience: Type.Optional(Type.Number({ description: "Completed actionable opportunities allowed before automatic compression.", minimum: 0 })),
-    summarizerModel: Type.Optional(Type.Array(Type.String(), { description: "Ordered summarizer model refs; empty uses the deterministic extractive summary." })),
-    timeoutMs: Type.Optional(Type.Number({ description: "Per-summarizer deadline in milliseconds.", minimum: 1 })),
+    summarizerModel: Type.Optional(Type.Array(Type.String(), { description: "Ordered model refs used by auto-compress and explicit compress when summary is omitted; empty uses the deterministic extractive summary." })),
+    summarizerFallbackModels: Type.Optional(Type.Array(Type.String(), { description: "Ordered fallback model refs tried after summarizerModel." })),
+    timeoutMs: Type.Optional(Type.Number({ description: "Per-summarizer deadline in milliseconds for automatic and explicit generated summaries.", minimum: 1 })),
 }, { description: "Bounded automatic compression fallback." });
 const DcpCompressConfig = Type.Object({
     maxContextPercent: Type.Optional(Type.Union([Type.Number(), Type.String()], { description: "Maximum context percent (0–1 or '80%') before compression triggers." })),
     minContextPercent: Type.Optional(Type.Union([Type.Number(), Type.String()], { description: "Target context percent after compression." })),
-    modelMaxContextPercent: Type.Optional(Type.Record(Type.String(), Type.Number(), { description: "Per-model max context percent overrides." })),
-    modelMinContextPercent: Type.Optional(Type.Record(Type.String(), Type.Number(), { description: "Per-model min context percent overrides." })),
+    modelMaxContextPercent: Type.Optional(Type.Record(Type.String(), Type.Union([Type.Number(), Type.String()]), { description: "Per-model max context overrides using the same fraction/token/percent formats." })),
+    modelMinContextPercent: Type.Optional(Type.Record(Type.String(), Type.Union([Type.Number(), Type.String()]), { description: "Per-model min context overrides using the same fraction/token/percent formats." })),
     maxContextLimit: Type.Optional(Type.Union([Type.Number(), Type.String()], { description: "Absolute max context tokens or '200k'." })),
     minContextLimit: Type.Optional(Type.Union([Type.Number(), Type.String()], { description: "Absolute min context tokens." })),
     modelMaxContextLimits: Type.Optional(Type.Record(Type.String(), Type.Union([Type.Number(), Type.String()]), { description: "Per-model max context limit overrides." })),
@@ -93,7 +98,23 @@ const DcpEmergencyCurrentTurnPruningConfig = Type.Object({
 }, { description: "Single bounded emergency cleanup strategy." });
 const DcpStrategiesConfig = Type.Object({
     emergencyCurrentTurnPruning: Type.Optional(DcpEmergencyCurrentTurnPruningConfig),
+    deduplication: Type.Optional(Type.Never({ description: "Removed legacy key; no automatic replacement policy maps to it." })),
+    purgeErrors: Type.Optional(Type.Never({ description: "Removed legacy key; no automatic replacement policy maps to it." })),
+    autoToolPruning: Type.Optional(Type.Never({ description: "Removed legacy key. Use explicit /dcp sweep or DCP compression/emergency policies instead." })),
 }, { description: "Bounded DCP emergency strategy." });
+const DcpConfigOverride = Type.Object({
+    enabled: Type.Optional(Type.Boolean()),
+    debug: Type.Optional(Type.Boolean()),
+    debugLog: Type.Optional(Type.Object({
+        maxBytes: Type.Optional(Type.Number({ minimum: 1024 })),
+        maxBackups: Type.Optional(Type.Number({ minimum: 1 })),
+    })),
+    manualMode: Type.Optional(DcpManualModeConfig),
+    compress: Type.Optional(DcpCompressConfig),
+    strategies: Type.Optional(DcpStrategiesConfig),
+    protectedFilePatterns: Type.Optional(Type.Array(Type.String())),
+    pruneNotification: Type.Optional(Type.Never({ description: "Removed legacy key; pruning notifications are no longer configurable." })),
+}, { description: "Partial DCP override applied to a matching provider/model or bare-model key. Keys support * and ? wildcards." });
 const DcpConfig = Type.Object({
     enabled: Type.Optional(Type.Boolean({ description: "Enable DCP (Dynamic Context Pruning)." })),
     debug: Type.Optional(Type.Boolean({ description: "Enable DCP debug logging." })),
@@ -105,73 +126,10 @@ const DcpConfig = Type.Object({
     compress: Type.Optional(DcpCompressConfig),
     strategies: Type.Optional(DcpStrategiesConfig),
     protectedFilePatterns: Type.Optional(Type.Array(Type.String(), { description: "File path glob patterns whose content is protected from pruning." })),
+    modelOverrides: Type.Optional(Type.Record(Type.String(), DcpConfigOverride, { description: "Per-model partial DCP overrides. Exact keys take precedence over matching wildcards." })),
+    pruneNotification: Type.Optional(Type.Never({ description: "Removed legacy key; pruning notifications are no longer configurable." })),
 }, { description: "DCP (Dynamic Context Pruning) configuration." });
 // ---------------------------------------------------------------------------
-// Async subagents
-// ---------------------------------------------------------------------------
-const RetryConfig = Type.Object({
-    maxRetries: Type.Optional(Type.Number({ description: "Maximum retry attempts.", minimum: 0 })),
-    backoffMs: Type.Optional(Type.Number({ description: "Base delay in ms before first retry.", minimum: 0 })),
-    retryableExitCodes: Type.Optional(Type.Array(Type.Number(), { description: "Exit codes eligible for retry. Empty array disables retry." })),
-}, { description: "Retry configuration for sub-agents." });
-const SubagentRoutingConfig = Type.Object({
-    enabled: Type.Optional(Type.Boolean({ description: "Enable fallback LLM selection for omitted subagentType values. Explicit valid types bypass the router; when disabled, every spawn task must specify a valid type." })),
-    model: Type.Optional(Type.String({ description: "Router model in provider/model form." })),
-    fallbackModels: Type.Optional(Type.Array(Type.String(), { uniqueItems: true, description: "Ordered router model fallbacks tried when the primary routing model is unavailable or fails. The current parent model is always tried last." })),
-    maxTaskChars: Type.Optional(Type.Number({ description: "Max task/scope characters sent to router.", minimum: 100 })),
-    maxTokens: Type.Optional(Type.Number({ description: "Max router response tokens.", minimum: 8 })),
-    maxRetries: Type.Optional(Type.Number({ description: "Router request retries.", minimum: 0 })),
-    timeoutMs: Type.Optional(Type.Number({ description: "Router request timeout in ms.", minimum: 1000 })),
-    debug: Type.Optional(Type.Boolean({ description: "Show routing debug warnings." })),
-}, { description: "Fallback role routing for omitted types. Unknown explicit types or failed/incomplete routing reject the entire batch before any agents launch." });
-const SubagentVisionConfig = Type.Object({
-    blindModelPatterns: Type.Optional(Type.Array(Type.String(), { description: "Glob-like model refs treated as unable to inspect images." })),
-}, { description: "Vision capability overrides." });
-const SubagentPresetTypeOverride = Type.Object({
-    model: Type.Optional(Type.String({ description: "Model override for this type within the preset." })),
-    fallbackModels: Type.Optional(Type.Array(Type.String(), { description: "Per-role fallback models." })),
-    thinking: Type.Optional(Type.String({ description: "Thinking level override." })),
-    extraArgs: Type.Optional(Type.Array(Type.String(), { description: "Extra CLI arguments." })),
-    timeoutMs: Type.Optional(Type.Number({ description: "Per-agent wall-clock timeout in ms.", minimum: 1 })),
-}, { description: "Per-type override within a preset." });
-const SubagentPreset = Type.Object({
-    description: Type.Optional(Type.String({ description: "Preset description." })),
-    models: Type.Optional(Type.Array(Type.String({ pattern: "^[^\\s/*]+/[^\\s*]+$" }), { uniqueItems: true, description: "Available model pool. Filter the agent's ordered models by membership; pool order is ignored. Empty intersection rejects spawn. Oracle also respects this pool." })),
-    model: Type.Optional(Type.String({ description: "Legacy default model. Ignored when models is set.", deprecated: true })),
-    fallbackModels: Type.Optional(Type.Array(Type.String(), { description: "Legacy fallback list. Ignored when models is set.", deprecated: true })),
-    thinking: Type.Optional(Type.String({ description: "Default thinking level." })),
-    extraArgs: Type.Optional(Type.Array(Type.String(), { description: "Extra CLI arguments." })),
-    timeoutMs: Type.Optional(Type.Number({ description: "Per-agent wall-clock timeout in ms.", minimum: 1 })),
-    types: Type.Optional(Type.Record(Type.String(), SubagentPresetTypeOverride, { description: "Per-type overrides." })),
-}, { description: "Named available-model pool. Legacy model/types overrides remain supported; prefer models for new presets." });
-const SubagentTypeConfig = Type.Object({
-    description: Type.Optional(Type.String({ description: "Role description for routing." })),
-    icon: Type.Optional(Type.String({ description: "Agent icon name rendered by UIs (pix TUI icon themes and Pix Desktop lucide icons): agent, search, code, flask, globe, sparkles, brain, wrench, terminal, bug, book, eye, zap, rocket. Unknown names render as the neutral agent icon." })),
-    models: Type.Optional(Type.Array(Type.String({ pattern: "^[^\\s/*]+/[^\\s*]+$" }), { uniqueItems: true, description: "Ordered model candidates. First usable member of the preset pool runs; only remaining compatible members can be used on quota failure. Replaces legacy model/fallbackModels/modelByParent selection." })),
-    model: Type.Optional(Type.String({ description: "Legacy primary model; use models for new profiles.", deprecated: true })),
-    fallbackModels: Type.Optional(Type.Array(Type.String(), { description: "Legacy candidates after model; use models for a complete ranked list.", deprecated: true })),
-    thinking: Type.Optional(Type.String({ description: "Thinking level." })),
-    tools: Type.Optional(Type.Array(Type.String(), { description: "Enabled tools for this type." })),
-    isolatedSkills: Type.Optional(Type.Array(Type.String(), { description: "Explicit skill files loaded after disabling normal skill discovery for this type." })),
-    extraArgs: Type.Optional(Type.Array(Type.String(), { description: "Extra CLI arguments." })),
-    promptAppend: Type.Optional(Type.String({ description: "Extra prompt text appended after generated prompt." })),
-    promptOverride: Type.Optional(Type.String({ description: "Full prompt replacement." })),
-    retry: Type.Optional(RetryConfig),
-    maxResultBytes: Type.Optional(Type.Number({ description: "Max bytes in result summary.", minimum: 0 })),
-    timeoutMs: Type.Optional(Type.Number({ description: "Per-agent wall-clock timeout in ms.", minimum: 1 })),
-}, { description: "Configuration for a sub-agent type/role." });
-const AsyncSubagentsConfig = Type.Object({
-    defaultType: Type.Optional(Type.String({ description: "Preferred role for genuinely ambiguous router tasks and legacy resolver default. Not used as a spawn fallback for missing/invalid routes." })),
-    routing: Type.Optional(SubagentRoutingConfig),
-    vision: Type.Optional(SubagentVisionConfig),
-    presets: Type.Optional(Type.Record(Type.String(), SubagentPreset, { description: "Named spawn presets." })),
-    types: Type.Optional(Type.Record(Type.String(), SubagentTypeConfig, { description: "Sub-agent type definitions." })),
-    maxConcurrent: Type.Optional(Type.Number({ description: "Max concurrent agents per spawn batch (0 = unlimited).", minimum: 0 })),
-    retry: Type.Optional(RetryConfig),
-    maxResultBytes: Type.Optional(Type.Number({ description: "Global max bytes in result summary.", minimum: 0 })),
-    timeoutMs: Type.Optional(Type.Number({ description: "Global per-agent wall-clock timeout in ms.", minimum: 1 })),
-}, { description: "Async sub-agent configuration." });
-// ---------------------------------------------------------------------------
 // Prompt commands
 // ---------------------------------------------------------------------------
 const PromptCommand = Type.Object({
@@ -185,20 +143,29 @@ const SecretFirewallConfig = Type.Object({
     sessionHygiene: Type.Optional(Type.Boolean({ description: "Redact detected secret material from tool results and completed messages before it remains in session history." })),
     notify: Type.Optional(Type.Boolean({ description: "Show a warning when one or more secrets are redacted. Secret values are never included in notifications." })),
 }, { description: "Settings for the opt-in credential-firewall module." });
+const CommentCheckerConfig = Type.Object({
+    enabled: Type.Optional(Type.Boolean({ description: "Enable or disable comment-checker without disabling the whole module." })),
+    strictness: Type.Optional(Type.Union([Type.Literal("conservative"), Type.Literal("balanced"), Type.Literal("aggressive")], { description: "Comment classification strictness. Defaults to balanced." })),
+}, { description: "Settings for the comment-checker module." });
 const ContextGatewayBudgetsConfig = Type.Object({
-    maxInlineBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Initial inline byte budget used by Context Gateway policy experiments. Default 8192." })),
-    maxResultBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Experimental delivered-result byte budget. P01 observe measures the available tool-result content boundary; later shaping must account for the final provider-visible serialization. Default 8192." })),
-    maxExactReadBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Future exact-read byte budget. Default 32768." })),
-    maxSearchBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Future search-delivery byte budget. Default 8192." })),
-    maxSearchMatches: Type.Optional(Type.Integer({ minimum: 1, maximum: 1000, description: "Future search match budget. Default 12." })),
-}, { description: "Context Gateway delivery budgets. In P01 only maxResultBytes is used for passive observe accounting." });
+    maxInlineBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Maximum inline size for a proven compact representation. Default 8192." })),
+    maxResultBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Budget for shell/other result classes. Selective enforce currently compacts only recognised complete simple test/build output. Default 8192." })),
+    maxExactReadBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Read-class observation budget. Reads remain passthrough because snapshot-safe recovery is not available. Default 32768." })),
+    maxSearchBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Repo-search/AST/structure observation budget. Gateway does not post-hoc truncate producer output. Default 8192." })),
+    maxSearchMatches: Type.Optional(Type.Integer({ minimum: 1, maximum: 1000, description: "Reserved search-match policy budget. Default 12." })),
+}, { description: "Context Gateway class-specific observation and selective-enforcement budgets." });
 const ContextGatewayConfig = Type.Object({
-    mode: Type.Optional(Type.Union([Type.Literal("off"), Type.Literal("observe"), Type.Literal("enforce")], { description: "Context Gateway mode. P01 implements off/observe; enforce is parsed but explicitly refused until later integration gates." })),
+    mode: Type.Optional(Type.Union([Type.Literal("off"), Type.Literal("observe"), Type.Literal("enforce")], { description: "Context Gateway mode. observe is passive; enforce only compacts proven complete simple test/build output and otherwise passes results through." })),
     budgets: Type.Optional(ContextGatewayBudgetsConfig),
 }, { description: "Context Gateway configuration. Default mode is off." });
 const RepoDiscoveryConfig = Type.Object({
     profile: Type.Optional(Type.Union([Type.Literal("baseline"), Type.Literal("native-compact")], { description: "repo_* runtime profile. baseline preserves historical argv/defaults; native-compact enables bounded native flags, cursors, validation, and an explicit per-call full override." })),
 }, { description: "Repository discovery runtime policy. Default profile is baseline." });
+const ResourceRegistryConfig = Type.Object({
+    remote: Type.Optional(Type.String({ description: "Git remote URL for the private registry. The repository contains reusable top-level skills/ and agents/ plus project-scoped state under projects/." })),
+    branch: Type.Optional(Type.String({ description: "Registry branch used for install/update/push/pull. Defaults to main." })),
+    projectKey: Type.Optional(Type.String({ description: "Optional explicit key for this project's projects/<key>/tasks.jsonc, plans/, and TODO.md state. Normally derived from the current Git origin." })),
+}, { description: "Private Git-backed registry for reusable skills/agents and project-scoped tasks/plans state." });
 // ---------------------------------------------------------------------------
 // LSP
 // ---------------------------------------------------------------------------
@@ -246,15 +213,19 @@ export const PiToolsSuiteConfigSchema = Type.Object({
         Type.Null(),
     ]), { description: "Force per-todo thinking for matching provider/model or bare-model keys. Keys support * and ? wildcards; null removes an inherited override." })),
     lookupModel: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Vision-capable provider/model used by GLM's lookup tool; unset or null disables lookup." })),
+    lookupFallbackModels: Type.Optional(Type.Array(Type.String(), { description: "Ordered lookup model fallbacks tried after lookupModel." })),
     terminalBell: Type.Optional(TerminalBellConfig),
+    telegramConnector: Type.Optional(TelegramConnectorConfig),
+    commentChecker: Type.Optional(CommentCheckerConfig),
     dcp: Type.Optional(DcpConfig),
-    asyncSubagents: Type.Optional(AsyncSubagentsConfig),
     toolRenderer: Type.Optional(ToolRendererConfig),
     promptCommands: Type.Optional(PromptCommandsConfig),
     secretFirewall: Type.Optional(SecretFirewallConfig),
     contextGateway: Type.Optional(ContextGatewayConfig),
     repoDiscovery: Type.Optional(RepoDiscoveryConfig),
+    resourceRegistry: Type.Optional(ResourceRegistryConfig),
     lsp: Type.Optional(LspConfig),
+    asyncSubagents: Type.Optional(Type.Never({ description: "Removed legacy key. Configure sub-agents in .pi/agents/*.md and model pools in .pi/agents/presets.jsonc." })),
 }, {
     $id: "https://unpkg.com/pi-ui-extend/schemas/pi-tools-suite.json",
     $schema: "https://json-schema.org/draft-07/schema#",

package/dist/schemas/pix-schema.d.ts

@@ -12,8 +12,11 @@ export declare const PixConfigSchema: Type.TObject<{
     maxProjectSessions: Type.TOptional<Type.TNumber>;
     defaultModel: Type.TOptional<Type.TObject<{
         modelRef: Type.TOptional<Type.TString>;
+        fallbackModels: Type.TOptional<Type.TArray<Type.TString>>;
         thinking: Type.TOptional<Type.TUnion<Type.TLiteral<string>[]>>;
     }>>;
+    visibleModels: Type.TOptional<Type.TArray<Type.TString>>;
+    thinkingByModel: Type.TOptional<Type.TRecord<"^.*$", Type.TUnion<[Type.TLiteral<"off">, Type.TLiteral<"minimal">, Type.TLiteral<"low">, Type.TLiteral<"medium">, Type.TLiteral<"high">, Type.TLiteral<"xhigh">, Type.TLiteral<"max">]>>>;
     toolRenderer: Type.TOptional<Type.TObject<{
         default: Type.TOptional<Type.TObject<{
             previewLines: Type.TOptional<Type.TNumber>;
@@ -37,9 +40,11 @@ export declare const PixConfigSchema: Type.TObject<{
     }>>;
     promptEnhancer: Type.TOptional<Type.TObject<{
         modelRef: Type.TOptional<Type.TString>;
+        fallbackModels: Type.TOptional<Type.TArray<Type.TString>>;
     }>>;
     autocomplete: Type.TOptional<Type.TObject<{
         modelRef: Type.TOptional<Type.TString>;
+        fallbackModels: Type.TOptional<Type.TArray<Type.TString>>;
         debounceMs: Type.TOptional<Type.TNumber>;
         timeoutMs: Type.TOptional<Type.TNumber>;
         maxTokens: Type.TOptional<Type.TNumber>;
@@ -57,12 +62,24 @@ export declare const PixConfigSchema: Type.TObject<{
         name: Type.TOptional<Type.TString>;
     }>>;
     dictation: Type.TOptional<Type.TObject<{
+        apiKey: Type.TOptional<Type.TString>;
         language: Type.TOptional<Type.TString>;
+        model: Type.TOptional<Type.TString>;
         languages: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
-            dirName: Type.TString;
-            url: Type.TString;
             label: Type.TString;
+            deepgramLanguage: Type.TOptional<Type.TString>;
+            dirName: Type.TOptional<Type.TString>;
+            url: Type.TOptional<Type.TString>;
         }>>>;
     }>>;
+    desktop: Type.TOptional<Type.TObject<{
+        externalEditor: Type.TOptional<Type.TString>;
+        git: Type.TOptional<Type.TObject<{
+            reviewModelRef: Type.TOptional<Type.TString>;
+            reviewFallbackModels: Type.TOptional<Type.TArray<Type.TString>>;
+            commitMessageModelRef: Type.TOptional<Type.TString>;
+            commitMessageFallbackModels: Type.TOptional<Type.TArray<Type.TString>>;
+        }>>;
+    }>>;
 }>;
 export type PixConfigSchemaType = Static<typeof PixConfigSchema>;

package/dist/schemas/pix-schema.js

@@ -33,10 +33,12 @@ const OutputFiltersConfig = Type.Object({
 }, { description: "Output filter patterns." });
 const DefaultModelConfig = Type.Object({
     modelRef: Type.Optional(Type.String({ description: "Provider/model identifier, e.g. 'openai-codex/gpt-5.4'." })),
+    fallbackModels: Type.Optional(Type.Array(Type.String({ description: "Fallback provider/model identifier." }), { description: "Ordered default-model fallbacks tried after modelRef." })),
     thinking: Type.Optional(DefaultThinkingSelection),
 }, { description: "Default model selection for new sessions." });
 const PromptEnhancerConfig = Type.Object({
     modelRef: Type.Optional(Type.String({ description: "Model used for prompt enhancement." })),
+    fallbackModels: Type.Optional(Type.Array(Type.String({ description: "Fallback provider/model identifier." }), { description: "Ordered prompt-enhancer fallbacks tried after modelRef." })),
 }, { description: "Prompt enhancer configuration." });
 const SessionTitleConfig = Type.Object({
     modelRef: Type.Optional(Type.String({ description: "Model used to generate compact session titles." })),
@@ -44,6 +46,7 @@ const SessionTitleConfig = Type.Object({
 }, { description: "Automatic session title generation configuration." });
 const AutocompleteConfig = Type.Object({
     modelRef: Type.Optional(Type.String({ description: "Model for inline autocomplete. Empty string disables LLM autocomplete." })),
+    fallbackModels: Type.Optional(Type.Array(Type.String({ description: "Fallback provider/model identifier." }), { description: "Ordered autocomplete fallbacks tried after modelRef." })),
     debounceMs: Type.Optional(Type.Number({ description: "Delay after typing before requesting completion.", minimum: 100, maximum: 2000 })),
     timeoutMs: Type.Optional(Type.Number({ description: "Hard timeout for completion request.", minimum: 250, maximum: 10000 })),
     maxTokens: Type.Optional(Type.Number({ description: "Maximum output tokens.", minimum: 8, maximum: 256 })),
@@ -61,14 +64,36 @@ const IconThemeConfig = Type.Object({
     name: Type.Optional(Type.String({ description: "Icon theme name, e.g. 'nerdFont' or 'fallback'." })),
 }, { description: "Icon theme configuration." });
 const DictationLanguageModelConfig = Type.Object({
-    dirName: Type.String({ description: "Vosk model directory name." }),
-    url: Type.String({ description: "Download URL for the Vosk model zip." }),
     label: Type.String({ description: "Human-readable language label." }),
-}, { description: "Vosk voice dictation model definition." });
+    deepgramLanguage: Type.Optional(Type.String({ description: "Deepgram language code. Defaults to the language map key." })),
+    dirName: Type.Optional(Type.String({ description: "Deprecated legacy Vosk model directory name; ignored by Deepgram dictation." })),
+    url: Type.Optional(Type.String({ description: "Deprecated legacy Vosk model URL; ignored by Deepgram dictation." })),
+}, { description: "Deepgram voice dictation language definition." });
 const DictationConfig = Type.Object({
+    apiKey: Type.Optional(Type.String({ description: "Deepgram API key used by terminal and desktop voice input. Store it in the user config (~/.config/pi/pix.jsonc); project-level .pi/pix.jsonc does not override this secret." })),
     language: Type.Optional(Type.String({ description: "Selected language code, e.g. 'en' or 'ru'." })),
-    languages: Type.Optional(Type.Record(Type.String(), DictationLanguageModelConfig, { description: "Available language models keyed by language code." })),
-}, { description: "Voice dictation (Vosk) configuration." });
+    model: Type.Optional(Type.String({ description: "Deepgram speech-to-text model. Defaults to 'nova-3'." })),
+    languages: Type.Optional(Type.Record(Type.String(), DictationLanguageModelConfig, { description: "Available dictation languages keyed by local language code." })),
+}, { description: "Voice dictation (Deepgram) configuration. Uses dictation.apiKey from the user pix config, with DEEPGRAM_API_KEY as a compatibility fallback." });
+const DesktopConfig = Type.Object({
+    externalEditor: Type.Optional(Type.String({
+        description: "External editor used by Pix Desktop project explorer. Known aliases include zed, code/vscode, cursor, subl/sublime, idea/intellij, and webstorm; an executable path/name is also accepted.",
+    })),
+    git: Type.Optional(Type.Object({
+        reviewModelRef: Type.Optional(Type.String({
+            description: "Model reference used by Pix Desktop and TUI for LLM review of Git diffs, optionally with a :thinking suffix.",
+        })),
+        reviewFallbackModels: Type.Optional(Type.Array(Type.String(), {
+            description: "Ordered fallback model references used for Git diff review.",
+        })),
+        commitMessageModelRef: Type.Optional(Type.String({
+            description: "Model reference used by Pix Desktop and TUI to generate Git commit messages, optionally with a :thinking suffix.",
+        })),
+        commitMessageFallbackModels: Type.Optional(Type.Array(Type.String(), {
+            description: "Ordered fallback model references used for Git commit-message generation.",
+        })),
+    }, { description: "Pix Git/Source Control LLM preferences shared by Desktop and TUI." })),
+}, { description: "Pix Desktop preferences; the nested git model settings are also consumed by TUI Git helpers for compatibility." });
 // ---------------------------------------------------------------------------
 // Top-level schema
 // ---------------------------------------------------------------------------
@@ -77,6 +102,22 @@ export const PixConfigSchema = Type.Object({
     ignoreContextFiles: Type.Optional(Type.Boolean({ description: "Disable AGENTS.md / CLAUDE.md discovery for sessions started in this project, equivalent to pi --no-context-files." })),
     maxProjectSessions: Type.Optional(Type.Number({ description: "Maximum number of pi session JSONL files to retain per project. Set to 0 to disable automatic session deletion.", minimum: 0 })),
     defaultModel: Type.Optional(DefaultModelConfig),
+    visibleModels: Type.Optional(Type.Array(Type.String({
+        description: "Provider/model identifier shown in Pix model pickers.",
+    }), {
+        description: "User-level whitelist shared by Pix TUI and Desktop model pickers. Omit to show every available model.",
+    })),
+    thinkingByModel: Type.Optional(Type.Record(Type.String(), Type.Union([
+        Type.Literal("off"),
+        Type.Literal("minimal"),
+        Type.Literal("low"),
+        Type.Literal("medium"),
+        Type.Literal("high"),
+        Type.Literal("xhigh"),
+        Type.Literal("max"),
+    ]), {
+        description: "User-level last-applied thinking level per provider/model, shared by Pix TUI and Desktop model pickers.",
+    })),
     toolRenderer: Type.Optional(ToolRendererConfig),
     outputFilters: Type.Optional(OutputFiltersConfig),
     promptEnhancer: Type.Optional(PromptEnhancerConfig),
@@ -85,6 +126,7 @@ export const PixConfigSchema = Type.Object({
     modelColors: Type.Optional(ModelColorsConfig),
     iconTheme: Type.Optional(IconThemeConfig),
     dictation: Type.Optional(DictationConfig),
+    desktop: Type.Optional(DesktopConfig),
 }, {
     $id: "https://unpkg.com/pi-ui-extend/schemas/pix.json",
     $schema: "https://json-schema.org/draft-07/schema#",

package/dist/schemas/tasks-schema.d.ts

@@ -0,0 +1,18 @@
+/** JSON Schema for project-scoped Desktop tasks stored in <cwd>/.pi/tasks.jsonc. */
+import { Static, Type } from "typebox";
+export declare const ProjectTasksSchema: Type.TObject<{
+    $schema: Type.TOptional<Type.TString>;
+    version: Type.TLiteral<1>;
+    tasks: Type.TArray<Type.TObject<{
+        id: Type.TString;
+        title: Type.TString;
+        description: Type.TOptional<Type.TString>;
+        type: Type.TUnion<[Type.TLiteral<"bug">, Type.TLiteral<"feature">, Type.TLiteral<"improvement">]>;
+        status: Type.TUnion<[Type.TLiteral<"backlog">, Type.TLiteral<"todo">, Type.TLiteral<"in-progress">, Type.TLiteral<"done">]>;
+        priority: Type.TUnion<[Type.TLiteral<"low">, Type.TLiteral<"medium">, Type.TLiteral<"high">, Type.TLiteral<"urgent">]>;
+        sessionId: Type.TOptional<Type.TString>;
+        createdAt: Type.TString;
+        updatedAt: Type.TString;
+    }>>;
+}>;
+export type ProjectTasksSchemaType = Static<typeof ProjectTasksSchema>;

package/dist/schemas/tasks-schema.js

@@ -0,0 +1,41 @@
+/** JSON Schema for project-scoped Desktop tasks stored in <cwd>/.pi/tasks.jsonc. */
+import { Type } from "typebox";
+const TaskType = Type.Union([
+    Type.Literal("bug"),
+    Type.Literal("feature"),
+    Type.Literal("improvement"),
+]);
+const TaskStatus = Type.Union([
+    Type.Literal("backlog"),
+    Type.Literal("todo"),
+    Type.Literal("in-progress"),
+    Type.Literal("done"),
+]);
+const TaskPriority = Type.Union([
+    Type.Literal("low"),
+    Type.Literal("medium"),
+    Type.Literal("high"),
+    Type.Literal("urgent"),
+]);
+const ProjectTask = Type.Object({
+    id: Type.String({ minLength: 1, maxLength: 128, description: "Stable unique task id." }),
+    title: Type.String({ maxLength: 200, description: "Short task title. May be empty when the task has description content." }),
+    description: Type.Optional(Type.String({ maxLength: 10_000, description: "Optional detailed task description." })),
+    type: TaskType,
+    status: TaskStatus,
+    priority: TaskPriority,
+    sessionId: Type.Optional(Type.String({ minLength: 1, maxLength: 512, description: "Optional Pi session associated with this task." })),
+    createdAt: Type.String({ format: "date-time", description: "RFC 3339 creation timestamp." }),
+    updatedAt: Type.String({ format: "date-time", description: "RFC 3339 last-update timestamp." }),
+}, { additionalProperties: false });
+export const ProjectTasksSchema = Type.Object({
+    $schema: Type.Optional(Type.String({ description: "JSON Schema URL used by editors for validation and autocomplete." })),
+    version: Type.Literal(1, { description: "Task document format version." }),
+    tasks: Type.Array(ProjectTask, { maxItems: 10_000, description: "Project tasks. Task ids must be unique." }),
+}, {
+    $id: "https://unpkg.com/pi-ui-extend/schemas/tasks.json",
+    $schema: "https://json-schema.org/draft-07/schema#",
+    title: "Pix Project Tasks",
+    description: "Project-scoped task document stored in <cwd>/.pi/tasks.jsonc.",
+    additionalProperties: false,
+});

package/docs/concurrency.md

@@ -1,9 +1,15 @@
 # Spec: Application concurrency and lifecycle safety
 
+<!-- markdownlint-disable MD013 -->
+
 ## Type
 
 Change
 
+## Lifecycle
+
+Active implemented contract.
+
 ## Goal
 
 Keep tab, session, editor, extension UI, persistence, and shutdown work bound to
@@ -67,7 +73,9 @@ the state that started it, without blocking normal terminal interaction.
 ## Risks / unknowns
 
 - SDK session hydration and append APIs are synchronous; eliminating those stalls may require an upstream SDK API or worker/process boundary.
-- Voice model inference may require a dedicated worker to become fully non-blocking.
+- Deepgram voice finalization must stay bounded, and shutdown must use the
+  immediate voice-dispose path rather than spend the global cleanup deadline
+  waiting for speech-to-text final results.
 
 ## Evidence
 

package/docs/desktop-mvp.md

@@ -4,6 +4,13 @@
 
 Change
 
+## Lifecycle
+
+Historical baseline. This document records the first Desktop vertical slice and
+still contains useful process-host/ACP transport contracts, but it is no longer
+the current feature-scope inventory. Later implemented Desktop behavior is
+specified by the `specs/desktop-*.md` family.
+
 ## Goal
 
 Provide a lightweight desktop client for Pix using Tauri 2 and Svelte 5 +
@@ -21,7 +28,11 @@ updates, cancel a running turn, and answer extension elicitations.
   elicitations.
 - Development commands and a documented local setup path.
 
-## Non-goals
+## MVP-era non-goals
+
+The items below were intentionally out of scope for the first slice. Several
+were implemented later and are governed by newer feature specs; they are not
+current product non-goals.
 
 - Feature parity with `PiUiExtendApp`.
 - Voice input, an embedded terminal, custom widgets, image attachments,
@@ -33,8 +44,10 @@ updates, cancel a running turn, and answer extension elicitations.
 
 ## Behavior
 
-1. Tauri starts one isolated `pix-acp` child and exposes only start, line-send,
-   and stop commands to the webview. Arbitrary shell execution is not exposed.
+1. Tauri starts one isolated `pix-acp` child for the ACP protocol. The host's
+   command surface has since grown beyond start/line-send/stop (e.g. package and
+   shell terminals via portable-pty); those additions are governed by the later
+   `specs/desktop-*.md` family, not by this historical baseline.
 2. The client initializes ACP with form-elicitation support before creating or
    loading a session.
 3. Selecting a workspace lists its persisted sessions. The user can create a
@@ -64,10 +77,13 @@ updates, cancel a running turn, and answer extension elicitations.
     object and the generation must still own the child
   - `acp_stop(generation)`; stale generations cannot stop a replacement child
 - Rust → webview events:
-  - `acp://stdout` with `{ generation, line }` for one complete stdout line
-  - `acp://stderr` with `{ generation, line }` for one diagnostic line
+  - `acp://stdout` with `{ windowLabel, generation, lines: string[] }` batches
+    of complete stdout lines (stdout stays protocol-only)
+  - `acp://stderr` with `{ windowLabel, generation, lines: string[] }` batches
+    of diagnostic lines
   - `acp://exit` with the generation and child exit status
-- Rust starts `node ../../acp/dist/main.js` by default. `PIX_ACP_NODE_BINARY`
+- Rust starts Node with the generated `<repo>/acp/dist/main.js` entry by
+  default. `PIX_ACP_NODE_BINARY`
   and `PIX_ACP_ENTRY` may override executable and entry path for development.
 - Webview ↔ adapter payloads follow `@agentclientprotocol/sdk` 1.4.0 types.