pi-ui-extend 1.0.39 → 1.0.41

package/dist/app/session/tabs-controller.js

@@ -1953,7 +1953,12 @@ export class AppTabsController {
             for (const session of sessions) {
                 if (keep.has(session.path))
                     continue;
-                await this.unlinkSessionAndDcpSidecar(session.path);
+                // Lifecycle state can change while retention is scanning. Re-check the
+                // current runtime/open tabs immediately before destructive work so a
+                // session that became live after the initial snapshot is not removed.
+                if (this.preservedSessionPaths().has(resolve(session.path)))
+                    continue;
+                await this.unlinkSessionFile(session.path);
             }
         }
         catch {
@@ -1964,31 +1969,17 @@ export class AppTabsController {
         }
     }
     /**
-     * Unlink a project session file and, best-effort, its DCP sidecar state.
-     * The sidecar path is derived from the session id in the first line of the
-     * `.jsonl` (mirrors the DCP module's `safeSessionFileName`), so retention
-     * never leaves orphan sidecars behind. Everything here is best-effort:
+     * Unlink a project session file. Everything here is best-effort:
      * session retention must never interrupt the terminal UI.
      */
-    async unlinkSessionAndDcpSidecar(sessionPath) {
-        let sidecarPath;
-        const header = await readSessionHeader(sessionPath);
-        if (header?.type === "session" && typeof header.id === "string" && header.id) {
-            sidecarPath = join(dirname(sessionPath), "dcp-state", header.id.replace(/[^a-zA-Z0-9._-]/g, "_") + ".json");
-        }
+    async unlinkSessionFile(sessionPath, unlinkFile = unlink) {
+        if (this.preservedSessionPaths().has(resolve(sessionPath)))
+            return;
         try {
-            await unlink(sessionPath);
+            await unlinkFile(sessionPath);
         }
         catch {
-            // Session retention must never interrupt the terminal UI.
-        }
-        if (sidecarPath) {
-            try {
-                await unlink(sidecarPath);
-            }
-            catch {
-                // Sidecar removal is best-effort; never interrupt the terminal UI.
-            }
+            return;
         }
     }
     preservedSessionPaths() {

package/dist/app/subagents/subagents-model.d.ts

@@ -11,7 +11,20 @@ export declare function isSubagentsLiveStateEvent(value: unknown): value is Suba
 export declare function isSubagentRegistryRun(runId: string, value: unknown): value is SubagentRegistryRun;
 export declare function isSubagentRegistryAgent(agentId: string, value: unknown): value is SubagentRegistryAgent;
 export declare function isSubagentRegistry(value: unknown): value is SubagentRegistry;
-export declare function subagentStatusIcon(status: SubagentStatus): string;
+/**
+ * Agent icon names accepted in sub-agent `icon:` frontmatter (both bundled
+ * agents and `.pi/agents/*.md`). Keys mirror APP_ICONS entries and the Pix
+ * Desktop lucide mapping (desktop/src/lib/agent-icons.ts); status is conveyed
+ * by color, not by the glyph.
+ */
+export declare const SUBAGENT_ICON_NAMES: readonly ["agent", "search", "code", "flask", "globe", "sparkles", "brain", "wrench", "terminal", "bug", "book", "eye", "zap", "rocket"];
+export type SubagentIconName = (typeof SUBAGENT_ICON_NAMES)[number];
+export declare function isSubagentIconName(value: string): value is SubagentIconName;
+/**
+ * Resolve the per-agent icon glyph from the task preview. Unknown or missing
+ * icon names fall back to the neutral agent glyph.
+ */
+export declare function subagentIcon(preview: SubagentTaskPreview | undefined): string;
 export declare function formatSubagentsPanelStats(agents: readonly SubagentAgentState[]): string;
 export declare function subagentModelThinkingLabel(preview: SubagentTaskPreview | undefined): string;
 export declare function activeSubagentStates(agents: readonly SubagentAgentState[]): SubagentAgentState[];

package/dist/app/subagents/subagents-model.js

@@ -60,6 +60,8 @@ export function isSubagentTaskPreview(value) {
         return false;
     if (value.thinkingLevel !== undefined && typeof value.thinkingLevel !== "string")
         return false;
+    if (value.icon !== undefined && typeof value.icon !== "string")
+        return false;
     return true;
 }
 export function isSubagentRunRenderDetails(value) {
@@ -148,21 +150,38 @@ export function isSubagentRegistry(value) {
     return Object.entries(value.runs).every(([runId, run]) => isSubagentRegistryRun(runId, run))
         && Object.entries(value.agents).every(([agentId, agent]) => isSubagentRegistryAgent(agentId, agent));
 }
-export function subagentStatusIcon(status) {
-    switch (status) {
-        case "planned":
-            return APP_ICONS.circleOutline;
-        case "running":
-            return APP_ICONS.timerSand;
-        case "retrying":
-            return APP_ICONS.refresh;
-        case "done":
-            return APP_ICONS.checkCircle;
-        case "failed":
-            return APP_ICONS.closeCircle;
-        case "stopped":
-            return APP_ICONS.stopCircle;
-    }
+/**
+ * Agent icon names accepted in sub-agent `icon:` frontmatter (both bundled
+ * agents and `.pi/agents/*.md`). Keys mirror APP_ICONS entries and the Pix
+ * Desktop lucide mapping (desktop/src/lib/agent-icons.ts); status is conveyed
+ * by color, not by the glyph.
+ */
+export const SUBAGENT_ICON_NAMES = [
+    "agent",
+    "search",
+    "code",
+    "flask",
+    "globe",
+    "sparkles",
+    "brain",
+    "wrench",
+    "terminal",
+    "bug",
+    "book",
+    "eye",
+    "zap",
+    "rocket",
+];
+export function isSubagentIconName(value) {
+    return SUBAGENT_ICON_NAMES.includes(value);
+}
+/**
+ * Resolve the per-agent icon glyph from the task preview. Unknown or missing
+ * icon names fall back to the neutral agent glyph.
+ */
+export function subagentIcon(preview) {
+    const name = preview?.icon?.trim();
+    return name && isSubagentIconName(name) ? APP_ICONS[name] : APP_ICONS.agent;
 }
 export function formatSubagentsPanelStats(agents) {
     const stats = [

package/dist/app/types.d.ts

@@ -159,6 +159,8 @@ export type SubagentTaskPreview = {
     model?: string;
     thinking?: string;
     thinkingLevel?: string;
+    /** Agent icon name from the subagentType profile; resolved via APP_ICONS. */
+    icon?: string;
 };
 export type SubagentRunRenderDetails = {
     runDir: string;

package/dist/bundled-extensions/session-title/config.js

@@ -4,7 +4,7 @@ import { dirname, join, parse, resolve } from "node:path";
 import { parse as parseJsonc } from "jsonc-parser";
 const DEFAULT_CONFIG = {
     enabled: true,
-    model: "zai/glm-4.5-air",
+    model: "zai/glm-5-turbo",
     fallbackModels: [],
     maxInputChars: 2000,
     maxTitleChars: 80,

package/dist/markdown-format.js

@@ -944,23 +944,41 @@ export function stripDcpControlMetadata(text) {
         return text;
     const lines = text.split("\n");
     const kept = [];
-    let inMessageIds = false;
+    let candidate;
+    let inFence;
     let touched = false;
     for (const line of lines) {
-        if (inMessageIds) {
-            touched = true;
-            if (/<\/dcp-message-ids>\s*$/i.test(line))
-                inMessageIds = false;
+        if (candidate) {
+            candidate.push(line);
+            if (/<\/dcp-message-ids>\s*$/i.test(line)) {
+                candidate = undefined;
+                touched = true;
+            }
             continue;
         }
-        if (/^\s*<dcp-message-ids>/i.test(line)) {
-            touched = true;
-            if (!/<\/dcp-message-ids>\s*$/i.test(line))
-                inMessageIds = true;
+        const quoteLine = /^\s{0,3}>/.test(line);
+        if (!quoteLine) {
+            const fence = markdownFence(line);
+            if (fence) {
+                if (!inFence)
+                    inFence = { marker: fence.marker, length: fence.length };
+                else if (fence.marker === inFence.marker && fence.length >= inFence.length)
+                    inFence = undefined;
+            }
+        }
+        if (!inFence && !quoteLine && /^\s*<dcp-message-ids>/i.test(line)) {
+            if (/<\/dcp-message-ids>\s*$/i.test(line)) {
+                touched = true;
+            }
+            else {
+                candidate = [line];
+            }
             continue;
         }
         kept.push(line);
     }
+    if (candidate)
+        kept.push(...candidate);
     return touched ? kept.join("\n").trimEnd() : text;
 }
 function isHiddenMarkdownMetadataLine(line) {

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

@@ -30,7 +30,6 @@ export declare const PiToolsSuiteConfigSchema: Type.TObject<{
         }>>;
         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]>>;
@@ -63,28 +62,26 @@ export declare const PiToolsSuiteConfigSchema: Type.TObject<{
                 highTokens: Type.TOptional<Type.TNumber>;
                 maxSuggestions: Type.TOptional<Type.TNumber>;
             }>>;
-        }>>;
-        strategies: Type.TOptional<Type.TObject<{
-            deduplication: Type.TOptional<Type.TObject<{
+            autoCompress: 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>>;
+                patience: Type.TOptional<Type.TNumber>;
+                summarizerModel: Type.TOptional<Type.TArray<Type.TString>>;
+                timeoutMs: Type.TOptional<Type.TNumber>;
             }>>;
-            autoToolPruning: Type.TOptional<Type.TObject<{
+        }>>;
+        strategies: Type.TOptional<Type.TObject<{
+            emergencyCurrentTurnPruning: 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>;
+                hardContextPercent: Type.TOptional<Type.TNumber>;
+                targetContextPercent: Type.TOptional<Type.TNumber>;
+                patience: Type.TOptional<Type.TNumber>;
+                keepRecentToolPairs: Type.TOptional<Type.TNumber>;
+                minOutputTokens: Type.TOptional<Type.TNumber>;
+                maxSuggestions: 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>;
@@ -103,6 +100,7 @@ export declare const PiToolsSuiteConfigSchema: Type.TObject<{
         }>>;
         presets: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
             description: Type.TOptional<Type.TString>;
+            models: Type.TOptional<Type.TArray<Type.TString>>;
             model: Type.TOptional<Type.TString>;
             fallbackModels: Type.TOptional<Type.TArray<Type.TString>>;
             thinking: Type.TOptional<Type.TString>;
@@ -118,6 +116,8 @@ export declare const PiToolsSuiteConfigSchema: Type.TObject<{
         }>>>;
         types: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
             description: Type.TOptional<Type.TString>;
+            icon: Type.TOptional<Type.TString>;
+            models: Type.TOptional<Type.TArray<Type.TString>>;
             model: Type.TOptional<Type.TString>;
             fallbackModels: Type.TOptional<Type.TArray<Type.TString>>;
             thinking: Type.TOptional<Type.TString>;
@@ -171,6 +171,19 @@ export declare const PiToolsSuiteConfigSchema: Type.TObject<{
         sessionHygiene: Type.TOptional<Type.TBoolean>;
         notify: Type.TOptional<Type.TBoolean>;
     }>>;
+    contextGateway: Type.TOptional<Type.TObject<{
+        mode: Type.TOptional<Type.TUnion<[Type.TLiteral<"off">, Type.TLiteral<"observe">, Type.TLiteral<"enforce">]>>;
+        budgets: Type.TOptional<Type.TObject<{
+            maxInlineBytes: Type.TOptional<Type.TInteger>;
+            maxResultBytes: Type.TOptional<Type.TInteger>;
+            maxExactReadBytes: Type.TOptional<Type.TInteger>;
+            maxSearchBytes: Type.TOptional<Type.TInteger>;
+            maxSearchMatches: Type.TOptional<Type.TInteger>;
+        }>>;
+    }>>;
+    repoDiscovery: Type.TOptional<Type.TObject<{
+        profile: Type.TOptional<Type.TUnion<[Type.TLiteral<"baseline">, Type.TLiteral<"native-compact">]>>;
+    }>>;
     lsp: Type.TOptional<Type.TObject<{
         servers: Type.TOptional<Type.TArray<Type.TObject<{
             id: Type.TString;

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

@@ -39,7 +39,6 @@ const TerminalBellConfig = Type.Object({
 // ---------------------------------------------------------------------------
 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." })),
@@ -56,6 +55,12 @@ const DcpMessageModeConfig = Type.Object({
     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 DcpAutoCompressConfig = Type.Object({
+    enabled: Type.Optional(Type.Boolean({ description: "Allow bounded automatic summary creation after pressure/opportunity gates." })),
+    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 })),
+}, { 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." })),
@@ -74,29 +79,21 @@ const DcpCompressConfig = Type.Object({
     protectUserMessages: Type.Optional(Type.Boolean({ description: "Protect user messages from pruning." })),
     autoCandidates: Type.Optional(DcpAutoCandidatesConfig),
     messageMode: Type.Optional(DcpMessageModeConfig),
+    autoCompress: Type.Optional(DcpAutoCompressConfig),
 }, { 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 DcpEmergencyCurrentTurnPruningConfig = Type.Object({
+    enabled: Type.Optional(Type.Boolean({ description: "Enable bounded same-turn emergency planning and last-resort output pruning." })),
+    hardContextPercent: Type.Optional(Type.Number({ description: "Context fraction that activates hard emergency pressure.", minimum: 0, maximum: 1 })),
+    targetContextPercent: Type.Optional(Type.Number({ description: "Context fraction the emergency path attempts to recover toward.", minimum: 0, maximum: 1 })),
+    patience: Type.Optional(Type.Number({ description: "Completed emergency opportunities allowed before last-resort pruning.", minimum: 0 })),
+    keepRecentToolPairs: Type.Optional(Type.Number({ description: "Newest complete tool-call/result pairs never selected by emergency cleanup.", minimum: 0 })),
+    minOutputTokens: Type.Optional(Type.Number({ description: "Minimum tool-result size eligible for emergency pruning.", minimum: 0 })),
+    maxSuggestions: Type.Optional(Type.Number({ description: "Maximum emergency message candidates shown in a reminder.", minimum: 0 })),
+    protectedTools: Type.Optional(Type.Array(Type.String(), { description: "Additional tools protected from emergency pruning and manual sweep." })),
+}, { description: "Single bounded emergency cleanup strategy." });
 const DcpStrategiesConfig = Type.Object({
-    deduplication: Type.Optional(DcpDeduplicationConfig),
-    purgeErrors: Type.Optional(DcpPurgeErrorsConfig),
-    autoToolPruning: Type.Optional(DcpAutoToolPruningConfig),
-}, { description: "DCP pruning strategies." });
+    emergencyCurrentTurnPruning: Type.Optional(DcpEmergencyCurrentTurnPruningConfig),
+}, { description: "Bounded DCP emergency strategy." });
 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." })),
@@ -108,7 +105,6 @@ 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." })),
-    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
@@ -119,7 +115,7 @@ const RetryConfig = Type.Object({
     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." })),
+    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 })),
@@ -127,7 +123,7 @@ const SubagentRoutingConfig = Type.Object({
     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: "LLM-based role routing configuration." });
+}, { 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." });
@@ -140,17 +136,20 @@ const SubagentPresetTypeOverride = Type.Object({
 }, { 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." })),
+    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 spawn preset." });
+}, { 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." })),
-    model: Type.Optional(Type.String({ description: "Model for this sub-agent type." })),
-    fallbackModels: Type.Optional(Type.Array(Type.String(), { description: "Ordered model fallbacks." })),
+    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." })),
@@ -162,7 +161,7 @@ const SubagentTypeConfig = Type.Object({
     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." })),
+    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." })),
@@ -186,6 +185,20 @@ 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 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." });
+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." })),
+    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." });
 // ---------------------------------------------------------------------------
 // LSP
 // ---------------------------------------------------------------------------
@@ -239,6 +252,8 @@ export const PiToolsSuiteConfigSchema = Type.Object({
     toolRenderer: Type.Optional(ToolRendererConfig),
     promptCommands: Type.Optional(PromptCommandsConfig),
     secretFirewall: Type.Optional(SecretFirewallConfig),
+    contextGateway: Type.Optional(ContextGatewayConfig),
+    repoDiscovery: Type.Optional(RepoDiscoveryConfig),
     lsp: Type.Optional(LspConfig),
 }, {
     $id: "https://unpkg.com/pi-ui-extend/schemas/pi-tools-suite.json",