pi-ui-extend 0.1.9 → 0.1.13

package/dist/schemas/pi-tools-suite-schema.d.ts

@@ -0,0 +1,177 @@
+/**
+ * TypeBox JSON Schema definitions for pi-tools-suite.jsonc (~/.config/pi/pi-tools-suite.jsonc).
+ *
+ * All fields are optional because the runtime applies generous defaults.
+ * The generated JSON Schema includes `"additionalProperties": true`.
+ */
+import { Type, Static } from "typebox";
+export declare const PiToolsSuiteConfigSchema: Type.TObject<{
+    $schema: Type.TOptional<Type.TString>;
+    enabled: Type.TOptional<Type.TBoolean>;
+    disabledModules: Type.TOptional<Type.TArray<Type.TString>>;
+    terminalBell: Type.TOptional<Type.TObject<{
+        sound: Type.TOptional<Type.TBoolean>;
+    }>>;
+    dcp: Type.TOptional<Type.TObject<{
+        enabled: Type.TOptional<Type.TBoolean>;
+        debug: Type.TOptional<Type.TBoolean>;
+        manualMode: Type.TOptional<Type.TObject<{
+            enabled: Type.TOptional<Type.TBoolean>;
+            automaticStrategies: Type.TOptional<Type.TBoolean>;
+        }>>;
+        compress: Type.TOptional<Type.TObject<{
+            maxContextPercent: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TString]>>;
+            minContextPercent: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TString]>>;
+            modelMaxContextPercent: Type.TOptional<Type.TRecord<"^.*$", Type.TNumber>>;
+            modelMinContextPercent: Type.TOptional<Type.TRecord<"^.*$", Type.TNumber>>;
+            maxContextLimit: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TString]>>;
+            minContextLimit: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TString]>>;
+            modelMaxContextLimits: Type.TOptional<Type.TRecord<"^.*$", Type.TUnion<[Type.TNumber, Type.TString]>>>;
+            modelMinContextLimits: Type.TOptional<Type.TRecord<"^.*$", Type.TUnion<[Type.TNumber, Type.TString]>>>;
+            summaryBuffer: Type.TOptional<Type.TBoolean>;
+            nudgeFrequency: Type.TOptional<Type.TNumber>;
+            iterationNudgeThreshold: Type.TOptional<Type.TNumber>;
+            nudgeForce: Type.TOptional<Type.TUnion<[Type.TLiteral<"strong">, Type.TLiteral<"soft">]>>;
+            protectedTools: Type.TOptional<Type.TArray<Type.TString>>;
+            protectTags: Type.TOptional<Type.TBoolean>;
+            protectUserMessages: Type.TOptional<Type.TBoolean>;
+            autoCandidates: Type.TOptional<Type.TObject<{
+                enabled: Type.TOptional<Type.TBoolean>;
+                minContextPercent: Type.TOptional<Type.TNumber>;
+                keepRecentTurns: Type.TOptional<Type.TNumber>;
+                minMessages: Type.TOptional<Type.TNumber>;
+                minTokens: Type.TOptional<Type.TNumber>;
+            }>>;
+            messageMode: Type.TOptional<Type.TObject<{
+                enabled: Type.TOptional<Type.TBoolean>;
+                minContextPercent: Type.TOptional<Type.TNumber>;
+                keepRecentTurns: Type.TOptional<Type.TNumber>;
+                mediumTokens: Type.TOptional<Type.TNumber>;
+                highTokens: Type.TOptional<Type.TNumber>;
+                maxSuggestions: Type.TOptional<Type.TNumber>;
+            }>>;
+        }>>;
+        strategies: Type.TOptional<Type.TObject<{
+            deduplication: Type.TOptional<Type.TObject<{
+                enabled: Type.TOptional<Type.TBoolean>;
+                protectedTools: Type.TOptional<Type.TArray<Type.TString>>;
+            }>>;
+            purgeErrors: Type.TOptional<Type.TObject<{
+                enabled: Type.TOptional<Type.TBoolean>;
+                turns: Type.TOptional<Type.TNumber>;
+                protectedTools: Type.TOptional<Type.TArray<Type.TString>>;
+            }>>;
+            autoToolPruning: Type.TOptional<Type.TObject<{
+                enabled: Type.TOptional<Type.TBoolean>;
+                maxOutputTokens: Type.TOptional<Type.TNumber>;
+                keepRecentTurns: Type.TOptional<Type.TNumber>;
+                readLikeTools: Type.TOptional<Type.TArray<Type.TString>>;
+                readLikeTurns: Type.TOptional<Type.TNumber>;
+                protectedTools: Type.TOptional<Type.TArray<Type.TString>>;
+            }>>;
+        }>>;
+        protectedFilePatterns: Type.TOptional<Type.TArray<Type.TString>>;
+        pruneNotification: Type.TOptional<Type.TUnion<[Type.TLiteral<"off">, Type.TLiteral<"minimal">, Type.TLiteral<"detailed">]>>;
+    }>>;
+    asyncSubagents: Type.TOptional<Type.TObject<{
+        defaultType: Type.TOptional<Type.TString>;
+        routing: Type.TOptional<Type.TObject<{
+            enabled: Type.TOptional<Type.TBoolean>;
+            model: Type.TOptional<Type.TString>;
+            maxTaskChars: Type.TOptional<Type.TNumber>;
+            maxTokens: Type.TOptional<Type.TNumber>;
+            maxRetries: Type.TOptional<Type.TNumber>;
+            temperature: Type.TOptional<Type.TNumber>;
+            timeoutMs: Type.TOptional<Type.TNumber>;
+            debug: Type.TOptional<Type.TBoolean>;
+        }>>;
+        vision: Type.TOptional<Type.TObject<{
+            blindModelPatterns: Type.TOptional<Type.TArray<Type.TString>>;
+        }>>;
+        presets: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
+            description: Type.TOptional<Type.TString>;
+            model: Type.TOptional<Type.TString>;
+            fallbackModels: Type.TOptional<Type.TArray<Type.TString>>;
+            thinking: Type.TOptional<Type.TString>;
+            extraArgs: Type.TOptional<Type.TArray<Type.TString>>;
+            timeoutMs: Type.TOptional<Type.TNumber>;
+            types: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
+                model: Type.TOptional<Type.TString>;
+                fallbackModels: Type.TOptional<Type.TArray<Type.TString>>;
+                thinking: Type.TOptional<Type.TString>;
+                extraArgs: Type.TOptional<Type.TArray<Type.TString>>;
+                timeoutMs: Type.TOptional<Type.TNumber>;
+            }>>>;
+        }>>>;
+        types: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
+            description: Type.TOptional<Type.TString>;
+            model: Type.TOptional<Type.TString>;
+            fallbackModels: Type.TOptional<Type.TArray<Type.TString>>;
+            thinking: Type.TOptional<Type.TString>;
+            tools: Type.TOptional<Type.TArray<Type.TString>>;
+            extraArgs: Type.TOptional<Type.TArray<Type.TString>>;
+            promptAppend: Type.TOptional<Type.TString>;
+            promptOverride: Type.TOptional<Type.TString>;
+            retry: Type.TOptional<Type.TObject<{
+                maxRetries: Type.TOptional<Type.TNumber>;
+                backoffMs: Type.TOptional<Type.TNumber>;
+                retryableExitCodes: Type.TOptional<Type.TArray<Type.TNumber>>;
+            }>>;
+            maxResultBytes: Type.TOptional<Type.TNumber>;
+            timeoutMs: Type.TOptional<Type.TNumber>;
+        }>>>;
+        maxConcurrent: Type.TOptional<Type.TNumber>;
+        retry: Type.TOptional<Type.TObject<{
+            maxRetries: Type.TOptional<Type.TNumber>;
+            backoffMs: Type.TOptional<Type.TNumber>;
+            retryableExitCodes: Type.TOptional<Type.TArray<Type.TNumber>>;
+        }>>;
+        maxResultBytes: Type.TOptional<Type.TNumber>;
+        timeoutMs: Type.TOptional<Type.TNumber>;
+    }>>;
+    toolRenderer: Type.TOptional<Type.TObject<{
+        default: Type.TOptional<Type.TObject<{
+            previewLines: Type.TOptional<Type.TNumber>;
+            direction: Type.TOptional<Type.TUnion<[Type.TLiteral<"head">, Type.TLiteral<"tail">]>>;
+            color: Type.TOptional<Type.TString>;
+            defaultExpanded: Type.TOptional<Type.TBoolean>;
+            compactHidden: Type.TOptional<Type.TBoolean>;
+            hidden: Type.TOptional<Type.TBoolean>;
+        }>>;
+        tools: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
+            previewLines: Type.TOptional<Type.TNumber>;
+            direction: Type.TOptional<Type.TUnion<[Type.TLiteral<"head">, Type.TLiteral<"tail">]>>;
+            color: Type.TOptional<Type.TString>;
+            defaultExpanded: Type.TOptional<Type.TBoolean>;
+            compactHidden: Type.TOptional<Type.TBoolean>;
+            hidden: Type.TOptional<Type.TBoolean>;
+        }>>>;
+    }>>;
+    promptCommands: Type.TOptional<Type.TObject<{
+        commands: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
+            description: Type.TOptional<Type.TString>;
+            prompt: Type.TString;
+        }>>>;
+    }>>;
+    lsp: Type.TOptional<Type.TObject<{
+        servers: Type.TOptional<Type.TArray<Type.TObject<{
+            id: Type.TString;
+            enabled: Type.TOptional<Type.TBoolean>;
+            include: Type.TOptional<Type.TArray<Type.TString>>;
+            exclude: Type.TOptional<Type.TArray<Type.TString>>;
+            rootMarkers: Type.TOptional<Type.TArray<Type.TString>>;
+            maxFileSizeBytes: Type.TOptional<Type.TNumber>;
+            bin: Type.TString;
+            args: Type.TOptional<Type.TArray<Type.TString>>;
+            cwd: Type.TOptional<Type.TString>;
+            env: Type.TOptional<Type.TRecord<"^.*$", Type.TString>>;
+            config: Type.TOptional<Type.TString>;
+            languageIdByExtension: Type.TOptional<Type.TRecord<"^.*$", Type.TString>>;
+            startupTimeoutMs: Type.TOptional<Type.TNumber>;
+            diagnosticsWaitMs: Type.TOptional<Type.TNumber>;
+            initializationOptions: Type.TOptional<Type.TUnknown>;
+            settings: Type.TOptional<Type.TUnknown>;
+        }>>>;
+    }>>;
+}>;
+export type PiToolsSuiteConfigSchemaType = Static<typeof PiToolsSuiteConfigSchema>;

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

@@ -0,0 +1,218 @@
+/**
+ * TypeBox JSON Schema definitions for pi-tools-suite.jsonc (~/.config/pi/pi-tools-suite.jsonc).
+ *
+ * All fields are optional because the runtime applies generous defaults.
+ * The generated JSON Schema includes `"additionalProperties": true`.
+ */
+import { Type } from "typebox";
+// ---------------------------------------------------------------------------
+// Shared primitives
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Tool renderer (same shape as pix)
+// ---------------------------------------------------------------------------
+const ToolRendererRule = Type.Object({
+    previewLines: Type.Optional(Type.Number({ minimum: 0, description: "Lines to show in the tool preview." })),
+    direction: Type.Optional(Type.Union([Type.Literal("head"), Type.Literal("tail")], { description: "Preview direction." })),
+    color: Type.Optional(Type.String({ description: "Theme color name or hex color." })),
+    defaultExpanded: Type.Optional(Type.Boolean({ description: "Expand tool output by default." })),
+    compactHidden: Type.Optional(Type.Boolean({ description: "Compact hidden placeholder." })),
+    hidden: Type.Optional(Type.Boolean({ description: "Hide tool output completely." })),
+}, { description: "Per-tool rendering rule." });
+const ToolRendererConfig = Type.Object({
+    default: Type.Optional(ToolRendererRule),
+    tools: Type.Optional(Type.Record(Type.String(), ToolRendererRule, { description: "Tool-specific rendering rules keyed by tool name or glob pattern, e.g. 'bash' or 'repo_*'." })),
+}, { description: "Per-tool rendering configuration." });
+// ---------------------------------------------------------------------------
+// Terminal bell
+// ---------------------------------------------------------------------------
+const TerminalBellConfig = Type.Object({
+    sound: Type.Optional(Type.Boolean({ description: "Play terminal bell sound on completion/error." })),
+}, { description: "Terminal bell configuration." });
+// ---------------------------------------------------------------------------
+// DCP (Dynamic Context Pruning)
+// ---------------------------------------------------------------------------
+const DcpManualModeConfig = Type.Object({
+    enabled: Type.Optional(Type.Boolean({ description: "Enable manual DCP mode." })),
+    automaticStrategies: Type.Optional(Type.Boolean({ description: "Run dedup/purge even in manual mode." })),
+}, { description: "Manual mode configuration." });
+const DcpAutoCandidatesConfig = Type.Object({
+    enabled: Type.Optional(Type.Boolean({ description: "Enable auto candidate selection for compression." })),
+    minContextPercent: Type.Optional(Type.Number({ description: "Minimum context usage to trigger auto-candidates.", minimum: 0, maximum: 1 })),
+    keepRecentTurns: Type.Optional(Type.Number({ description: "Number of recent turns to keep.", minimum: 0 })),
+    minMessages: Type.Optional(Type.Number({ description: "Minimum messages before auto-candidate selection.", minimum: 0 })),
+    minTokens: Type.Optional(Type.Number({ description: "Minimum tokens for auto-candidate selection.", minimum: 0 })),
+}, { description: "Auto-candidate selection for compression." });
+const DcpMessageModeConfig = Type.Object({
+    enabled: Type.Optional(Type.Boolean({ description: "Enable message-mode compression suggestions." })),
+    minContextPercent: Type.Optional(Type.Number({ description: "Minimum context usage to trigger message mode.", minimum: 0, maximum: 1 })),
+    keepRecentTurns: Type.Optional(Type.Number({ description: "Recent turns to keep.", minimum: 0 })),
+    mediumTokens: Type.Optional(Type.Number({ description: "Token threshold for medium-quality summary.", minimum: 0 })),
+    highTokens: Type.Optional(Type.Number({ description: "Token threshold for high-quality summary.", minimum: 0 })),
+    maxSuggestions: Type.Optional(Type.Number({ description: "Maximum compression suggestions.", minimum: 0 })),
+}, { description: "Message-mode compression configuration." });
+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." })),
+    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." })),
+    modelMinContextLimits: Type.Optional(Type.Record(Type.String(), Type.Union([Type.Number(), Type.String()]), { description: "Per-model min context limit overrides." })),
+    summaryBuffer: Type.Optional(Type.Boolean({ description: "Buffer summary output." })),
+    nudgeFrequency: Type.Optional(Type.Number({ description: "Inject nudge every N context events.", minimum: 1 })),
+    iterationNudgeThreshold: Type.Optional(Type.Number({ description: "Nudge after N tool calls since last user message.", minimum: 1 })),
+    nudgeForce: Type.Optional(Type.Union([Type.Literal("strong"), Type.Literal("soft")], { description: "Nudge intensity." })),
+    protectedTools: Type.Optional(Type.Array(Type.String(), { description: "Tool outputs protected from pruning." })),
+    protectTags: Type.Optional(Type.Boolean({ description: "Protect XML-like tags from pruning." })),
+    protectUserMessages: Type.Optional(Type.Boolean({ description: "Protect user messages from pruning." })),
+    autoCandidates: Type.Optional(DcpAutoCandidatesConfig),
+    messageMode: Type.Optional(DcpMessageModeConfig),
+}, { description: "Compression trigger and behavior configuration." });
+const DcpDeduplicationConfig = Type.Object({
+    enabled: Type.Optional(Type.Boolean({ description: "Enable duplicate content deduplication." })),
+    protectedTools: Type.Optional(Type.Array(Type.String(), { description: "Tool outputs protected from dedup." })),
+}, { description: "Deduplication strategy configuration." });
+const DcpPurgeErrorsConfig = Type.Object({
+    enabled: Type.Optional(Type.Boolean({ description: "Enable error input purging." })),
+    turns: Type.Optional(Type.Number({ description: "Prune error inputs after N user turns.", minimum: 1 })),
+    protectedTools: Type.Optional(Type.Array(Type.String(), { description: "Tool outputs protected from error purge." })),
+}, { description: "Error purging strategy configuration." });
+const DcpAutoToolPruningConfig = Type.Object({
+    enabled: Type.Optional(Type.Boolean({ description: "Enable automatic tool output pruning." })),
+    maxOutputTokens: Type.Optional(Type.Number({ description: "Maximum output tokens before truncation.", minimum: 0 })),
+    keepRecentTurns: Type.Optional(Type.Number({ description: "Recent turns to keep.", minimum: 0 })),
+    readLikeTools: Type.Optional(Type.Array(Type.String(), { description: "Tools treated as read-like (aggressively pruned)." })),
+    readLikeTurns: Type.Optional(Type.Number({ description: "Turns threshold for read-like tool pruning.", minimum: 0 })),
+    protectedTools: Type.Optional(Type.Array(Type.String(), { description: "Tool outputs protected from auto-pruning." })),
+}, { description: "Auto tool pruning strategy configuration." });
+const DcpStrategiesConfig = Type.Object({
+    deduplication: Type.Optional(DcpDeduplicationConfig),
+    purgeErrors: Type.Optional(DcpPurgeErrorsConfig),
+    autoToolPruning: Type.Optional(DcpAutoToolPruningConfig),
+}, { description: "DCP pruning strategies." });
+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." })),
+    manualMode: Type.Optional(DcpManualModeConfig),
+    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." })),
+    pruneNotification: Type.Optional(Type.Union([Type.Literal("off"), Type.Literal("minimal"), Type.Literal("detailed")], { description: "Notification level when pruning occurs." })),
+}, { 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 LLM-based automatic role routing." })),
+    model: Type.Optional(Type.String({ description: "Router model in provider/model form." })),
+    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 })),
+    temperature: Type.Optional(Type.Number({ description: "Router sampling temperature.", minimum: 0, maximum: 2 })),
+    timeoutMs: Type.Optional(Type.Number({ description: "Router request timeout in ms.", minimum: 1000 })),
+    debug: Type.Optional(Type.Boolean({ description: "Show routing debug warnings." })),
+}, { description: "LLM-based role routing configuration." });
+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." })),
+    model: Type.Optional(Type.String({ description: "Default model for this preset." })),
+    fallbackModels: Type.Optional(Type.Array(Type.String(), { description: "Global fallback models for this preset." })),
+    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 spawn preset." });
+const SubagentTypeConfig = Type.Object({
+    description: Type.Optional(Type.String({ description: "Role description for routing." })),
+    model: Type.Optional(Type.String({ description: "Model for this sub-agent type." })),
+    fallbackModels: Type.Optional(Type.Array(Type.String(), { description: "Ordered model fallbacks." })),
+    thinking: Type.Optional(Type.String({ description: "Thinking level." })),
+    tools: Type.Optional(Type.Array(Type.String(), { description: "Enabled tools 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: "Default sub-agent type when not specified." })),
+    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({
+    description: Type.Optional(Type.String({ description: "Short description shown in command menu." })),
+    prompt: Type.String({ description: "The prompt text to send. Supports {cwd} template variable." }),
+}, { description: "A saved slash command." });
+const PromptCommandsConfig = Type.Object({
+    commands: Type.Optional(Type.Record(Type.String(), PromptCommand, { description: "Command definitions keyed by slash command name." })),
+}, { description: "User-defined slash commands." });
+// ---------------------------------------------------------------------------
+// LSP
+// ---------------------------------------------------------------------------
+const LspServerConfig = Type.Object({
+    id: Type.String({ description: "Unique server identifier." }),
+    enabled: Type.Optional(Type.Boolean({ description: "Enable/disable this server." })),
+    include: Type.Optional(Type.Array(Type.String(), { description: "File glob patterns to include." })),
+    exclude: Type.Optional(Type.Array(Type.String(), { description: "File glob patterns to exclude." })),
+    rootMarkers: Type.Optional(Type.Array(Type.String(), { description: "Files that indicate a project root (e.g. ['package.json', '.git'])." })),
+    maxFileSizeBytes: Type.Optional(Type.Number({ description: "Max file size to send to the server.", minimum: 0 })),
+    bin: Type.String({ description: "Path to the language server binary." }),
+    args: Type.Optional(Type.Array(Type.String(), { description: "Command-line arguments." })),
+    cwd: Type.Optional(Type.String({ description: "Working directory for the server process." })),
+    env: Type.Optional(Type.Record(Type.String(), Type.String(), { description: "Environment variables." })),
+    config: Type.Optional(Type.String({ description: "Path to server configuration file." })),
+    languageIdByExtension: Type.Optional(Type.Record(Type.String(), Type.String(), { description: "File extension → language ID mapping, e.g. {'.ts': 'typescript'}." })),
+    startupTimeoutMs: Type.Optional(Type.Number({ description: "Server startup timeout in ms.", minimum: 1000 })),
+    diagnosticsWaitMs: Type.Optional(Type.Number({ description: "Wait time for diagnostics after file change.", minimum: 0 })),
+    initializationOptions: Type.Optional(Type.Unknown({ description: "LSP initialization options passed to the server." })),
+    settings: Type.Optional(Type.Unknown({ description: "LSP workspace/settings passed to the server." })),
+}, { description: "LSP server configuration." });
+const LspConfig = Type.Object({
+    servers: Type.Optional(Type.Array(LspServerConfig, { description: "LSP server definitions." })),
+}, { description: "Language Server Protocol configuration." });
+// ---------------------------------------------------------------------------
+// Top-level schema
+// ---------------------------------------------------------------------------
+export const PiToolsSuiteConfigSchema = Type.Object({
+    $schema: Type.Optional(Type.String({ description: "JSON Schema URL used by editors for validation and autocomplete." })),
+    enabled: Type.Optional(Type.Boolean({ description: "Enable or disable the entire pi-tools-suite extension." })),
+    disabledModules: Type.Optional(Type.Array(Type.String(), { description: "List of disabled module names (e.g. ['lsp', 'prompt-commands'])." })),
+    terminalBell: Type.Optional(TerminalBellConfig),
+    dcp: Type.Optional(DcpConfig),
+    asyncSubagents: Type.Optional(AsyncSubagentsConfig),
+    toolRenderer: Type.Optional(ToolRendererConfig),
+    promptCommands: Type.Optional(PromptCommandsConfig),
+    lsp: Type.Optional(LspConfig),
+}, {
+    $id: "https://unpkg.com/pi-ui-extend/schemas/pi-tools-suite.json",
+    $schema: "https://json-schema.org/draft-07/schema#",
+    title: "Pi Tools Suite Configuration",
+    description: "Configuration for the pi-tools-suite extension (~/.config/pi/pi-tools-suite.jsonc).",
+    additionalProperties: true,
+});

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

@@ -0,0 +1,65 @@
+/**
+ * TypeBox JSON Schema definitions for pix.jsonc (~/.config/pi/pix.jsonc).
+ *
+ * These schemas describe the _user-facing_ config shape — all fields are optional
+ * because the runtime applies generous defaults.  The generated JSON Schema files
+ * include `"additionalProperties": true` so that future fields are not rejected.
+ */
+import { Type, Static } from "typebox";
+export declare const PixConfigSchema: Type.TObject<{
+    $schema: Type.TOptional<Type.TString>;
+    defaultModel: Type.TOptional<Type.TObject<{
+        modelRef: Type.TOptional<Type.TString>;
+        thinking: Type.TOptional<Type.TUnion<Type.TLiteral<string>[]>>;
+    }>>;
+    toolRenderer: Type.TOptional<Type.TObject<{
+        default: Type.TOptional<Type.TObject<{
+            previewLines: Type.TOptional<Type.TNumber>;
+            direction: Type.TOptional<Type.TUnion<[Type.TLiteral<"head">, Type.TLiteral<"tail">]>>;
+            color: Type.TOptional<Type.TString>;
+            defaultExpanded: Type.TOptional<Type.TBoolean>;
+            compactHidden: Type.TOptional<Type.TBoolean>;
+            hidden: Type.TOptional<Type.TBoolean>;
+        }>>;
+        tools: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
+            previewLines: Type.TOptional<Type.TNumber>;
+            direction: Type.TOptional<Type.TUnion<[Type.TLiteral<"head">, Type.TLiteral<"tail">]>>;
+            color: Type.TOptional<Type.TString>;
+            defaultExpanded: Type.TOptional<Type.TBoolean>;
+            compactHidden: Type.TOptional<Type.TBoolean>;
+            hidden: Type.TOptional<Type.TBoolean>;
+        }>>>;
+    }>>;
+    outputFilters: Type.TOptional<Type.TObject<{
+        patterns: Type.TOptional<Type.TArray<Type.TString>>;
+    }>>;
+    promptEnhancer: Type.TOptional<Type.TObject<{
+        modelRef: Type.TOptional<Type.TString>;
+    }>>;
+    autocomplete: Type.TOptional<Type.TObject<{
+        modelRef: Type.TOptional<Type.TString>;
+        debounceMs: Type.TOptional<Type.TNumber>;
+        timeoutMs: Type.TOptional<Type.TNumber>;
+        maxTokens: Type.TOptional<Type.TNumber>;
+        maxPromptTokens: Type.TOptional<Type.TNumber>;
+        includeRecentMessages: Type.TOptional<Type.TNumber>;
+    }>>;
+    sessionTitle: Type.TOptional<Type.TObject<{
+        modelRef: Type.TOptional<Type.TString>;
+    }>>;
+    modelColors: Type.TOptional<Type.TUnion<[Type.TRecord<"^.*$", Type.TString>, Type.TObject<{
+        rules: Type.TOptional<Type.TRecord<"^.*$", Type.TString>>;
+    }>]>>;
+    iconTheme: Type.TOptional<Type.TObject<{
+        name: Type.TOptional<Type.TString>;
+    }>>;
+    dictation: Type.TOptional<Type.TObject<{
+        language: Type.TOptional<Type.TString>;
+        languages: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
+            dirName: Type.TString;
+            url: Type.TString;
+            label: Type.TString;
+        }>>>;
+    }>>;
+}>;
+export type PixConfigSchemaType = Static<typeof PixConfigSchema>;

package/dist/schemas/pix-schema.js

@@ -0,0 +1,91 @@
+/**
+ * TypeBox JSON Schema definitions for pix.jsonc (~/.config/pi/pix.jsonc).
+ *
+ * These schemas describe the _user-facing_ config shape — all fields are optional
+ * because the runtime applies generous defaults.  The generated JSON Schema files
+ * include `"additionalProperties": true` so that future fields are not rejected.
+ */
+import { Type } from "typebox";
+// ---------------------------------------------------------------------------
+// Shared primitives
+// ---------------------------------------------------------------------------
+const ThinkingLevel = Type.Union(["off", "minimal", "low", "medium", "high", "xhigh"].map((v) => Type.Literal(v)), { description: "Model thinking budget level." });
+// ---------------------------------------------------------------------------
+// Tool renderer
+// ---------------------------------------------------------------------------
+const ToolRendererRule = Type.Object({
+    previewLines: Type.Optional(Type.Number({ description: "Lines to show in the tool preview.", minimum: 0 })),
+    direction: Type.Optional(Type.Union([Type.Literal("head"), Type.Literal("tail")], { description: "Show preview from head or tail of output." })),
+    color: Type.Optional(Type.String({ description: "Theme color name (e.g. 'warning', 'success', 'muted') or hex color." })),
+    defaultExpanded: Type.Optional(Type.Boolean({ description: "Whether the tool output is expanded by default." })),
+    compactHidden: Type.Optional(Type.Boolean({ description: "Hide tool output but keep a compact one-line placeholder." })),
+    hidden: Type.Optional(Type.Boolean({ description: "Completely hide the tool output." })),
+}, { description: "Rendering rule for a specific tool or glob pattern." });
+const ToolRendererConfig = Type.Object({
+    default: Type.Optional(ToolRendererRule),
+    tools: Type.Optional(Type.Record(Type.String(), ToolRendererRule, { description: "Tool-specific rendering rules keyed by tool name or glob pattern, e.g. 'bash' or 'repo_*'." })),
+}, { description: "Per-tool rendering configuration. Keys in 'tools' support glob patterns like 'repo_*'." });
+// ---------------------------------------------------------------------------
+// Other sections
+// ---------------------------------------------------------------------------
+const OutputFiltersConfig = Type.Object({
+    patterns: Type.Optional(Type.Array(Type.String(), { description: "Glob or /regex/ patterns to strip from tool output." })),
+}, { description: "Output filter patterns." });
+const DefaultModelConfig = Type.Object({
+    modelRef: Type.Optional(Type.String({ description: "Provider/model identifier, e.g. 'openai-codex/gpt-5.4'." })),
+    thinking: Type.Optional(ThinkingLevel),
+}, { description: "Default model selection for new sessions." });
+const PromptEnhancerConfig = Type.Object({
+    modelRef: Type.Optional(Type.String({ description: "Model used for prompt enhancement." })),
+}, { description: "Prompt enhancer configuration." });
+const SessionTitleConfig = Type.Object({
+    modelRef: Type.Optional(Type.String({ description: "Model used to generate compact session titles." })),
+}, { 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." })),
+    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 })),
+    maxPromptTokens: Type.Optional(Type.Number({ description: "Maximum input prompt tokens.", minimum: 256, maximum: 16000 })),
+    includeRecentMessages: Type.Optional(Type.Number({ description: "Recent messages to include as context.", minimum: 0, maximum: 20 })),
+}, { description: "Inline autocomplete configuration." });
+const ModelColorRulesConfig = Type.Record(Type.String(), Type.String({ description: "Theme color name for matching model references, e.g. 'success', 'warning', or 'modelOpenAI'." }), { description: "Model reference glob pattern → theme color name mapping, e.g. 'zai/*': 'success'." });
+const ModelColorsConfig = Type.Union([
+    ModelColorRulesConfig,
+    Type.Object({
+        rules: Type.Optional(ModelColorRulesConfig),
+    }, { description: "Alternative nested form for model color rules." }),
+], { description: "Model color rules. Keys are glob patterns matching model refs; values are pix theme color names." });
+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." });
+const DictationConfig = Type.Object({
+    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." });
+// ---------------------------------------------------------------------------
+// Top-level schema
+// ---------------------------------------------------------------------------
+export const PixConfigSchema = Type.Object({
+    $schema: Type.Optional(Type.String({ description: "JSON Schema URL used by editors for validation and autocomplete." })),
+    defaultModel: Type.Optional(DefaultModelConfig),
+    toolRenderer: Type.Optional(ToolRendererConfig),
+    outputFilters: Type.Optional(OutputFiltersConfig),
+    promptEnhancer: Type.Optional(PromptEnhancerConfig),
+    autocomplete: Type.Optional(AutocompleteConfig),
+    sessionTitle: Type.Optional(SessionTitleConfig),
+    modelColors: Type.Optional(ModelColorsConfig),
+    iconTheme: Type.Optional(IconThemeConfig),
+    dictation: Type.Optional(DictationConfig),
+}, {
+    $id: "https://unpkg.com/pi-ui-extend/schemas/pix.json",
+    $schema: "https://json-schema.org/draft-07/schema#",
+    title: "Pix Configuration",
+    description: "Configuration for the pix terminal renderer (~/.config/pi/pix.jsonc).",
+    additionalProperties: true,
+});