pi-ui-extend 0.1.38 → 0.1.41

package/external/pi-tools-suite/src/dcp/index.ts

@@ -51,6 +51,7 @@ import {
 import { summarizeDcpState, writeDcpDebugLog } from "./debug-log.js"
 import type { DcpNudgeType } from "./pruner-types.js"
 import { registerCompressTool } from "./compress-tool.js"
+import { decideAutoCompress, createAutoCompressionBlock } from "./auto-compress.js"
 import { DCP_STATS_MESSAGE_TYPE, registerCommands } from "./commands.js"
 import { normalizeDcpContextUsage } from "./ui.js"
 import { safeGetContextUsage } from "../context-usage.js"
@@ -417,6 +418,21 @@ export default async function dcpModule(pi: ExtensionAPI): Promise<void> {
 				return finishContext("unknown-context-percent", prunedMessages, { clearedAnchors })
 			}
 
+			// Record the observed context window on EVERY context event (before
+			// any early return) so a mid-session model/window downgrade is
+			// detectable even when earlier passes were below threshold. We
+			// snapshot the previous value first so the downgrade check below
+			// compares against the window the prior pass actually saw.
+			const currentContextWindow = usage.contextWindow
+			const previousContextWindow = state.lastContextWindow
+			if (
+				typeof currentContextWindow === "number" &&
+				Number.isFinite(currentContextWindow) &&
+				currentContextWindow > 0
+			) {
+				state.lastContextWindow = currentContextWindow
+			}
+
 			const ctxModel = (ctx as any).model
 			const provider = ctxModel?.provider ?? ctxModel?.providerId ?? ctxModel?.providerID
 			const model = ctxModel?.id ?? ctxModel?.model ?? ctxModel?.modelId ?? ctxModel?.modelID
@@ -448,13 +464,30 @@ export default async function dcpModule(pi: ExtensionAPI): Promise<void> {
 				if (msg.role === "toolResult") toolCallsSinceLastUser++
 			}
 
-			const nudgeType = getNudgeType(
-				contextPercent,
-				state,
-				effectiveConfig,
-				toolCallsSinceLastUser,
-				thresholds,
-			)
+			// Switch-aware pre-emptive nudge: detect a mid-session context-window
+			// downgrade (e.g. model switch from a 1M window to a 275K window).
+			// Inherited tokens that were cheap on the larger window can suddenly
+			// sit above minContextPercent on the smaller one. When that happens,
+			// force a strong nudge on this pass so the model is told to compress
+			// before the smaller window fills, instead of waiting for cadence.
+			const windowDowngraded =
+				typeof previousContextWindow === "number" &&
+				Number.isFinite(previousContextWindow) &&
+				previousContextWindow > 0 &&
+				typeof currentContextWindow === "number" &&
+				Number.isFinite(currentContextWindow) &&
+				currentContextWindow < previousContextWindow * 0.9 &&
+				contextPercent > thresholds.minContextPercent
+
+			const nudgeType = windowDowngraded
+				? "context-strong"
+				: getNudgeType(
+					contextPercent,
+					state,
+					effectiveConfig,
+					toolCallsSinceLastUser,
+					thresholds,
+				)
 
 			const manualEmergencyOnly =
 				state.manualMode &&
@@ -483,6 +516,78 @@ export default async function dcpModule(pi: ExtensionAPI): Promise<void> {
 				}, ctx)
 			}
 
+			// Track consecutive ignored context-strong nudges for the
+			// auto-compress fallback. A strong nudge is "ignored" if it fires
+			// again on a later context event without a successful compress in
+			// between. Reset on non-strong nudges and when pressure drops below
+			// the emergency threshold (handled by the below-threshold early
+			// return above, which clears anchors; counter is also reset on any
+			// successful compress in the compress tool).
+			if (nudgeType === "context-strong" || nudgeType === "context-soft") {
+				state.consecutiveIgnoredStrongNudges += 1
+			} else if (nudgeType === null) {
+				state.consecutiveIgnoredStrongNudges = 0
+			}
+
+			// Auto-compress fallback: if the model has ignored enough strong
+			// nudges while above the emergency threshold, DCP creates a
+			// compression block itself instead of nudging again.
+			if (!manualEmergencyOnly) {
+				const autoDecision = decideAutoCompress(
+					state,
+					effectiveConfig,
+					contextPercent,
+					thresholds.maxContextPercent,
+					candidate,
+				)
+				if (autoDecision.shouldFire && candidate) {
+					try {
+						const autoResult = await createAutoCompressionBlock({
+							candidate,
+							topic: "Auto-compressed slice",
+							state,
+							config: effectiveConfig,
+							messages: prunedMessages,
+							modelRegistry: (ctx as any).modelRegistry,
+							signal: (ctx as any).signal,
+						})
+						// Re-apply pruning so the new block takes effect on this
+						// same context pass instead of the next one.
+						prunedMessages = applyPruning(prunedMessages, state, effectiveConfig)
+						const clearedAnchors = clearDcpNudgeAnchors(state)
+						state.consecutiveIgnoredStrongNudges = 0
+						await saveDcpState(ctx, state)
+						writeDcpDebugLog(effectiveConfig, "compress.auto", {
+							trigger: autoDecision.reason,
+							blockId: `b${autoResult.blockId}`,
+							summaryMode: autoResult.summaryMode,
+							summarizerModelRef: autoResult.summarizerModelRef,
+							summarizerAttempts: autoResult.summarizerAttempts,
+							summaryTokens: autoResult.summaryTokens,
+							removedTokenEstimate: autoResult.removedTokenEstimate,
+							candidate,
+							clearedAnchors,
+							state: summarizeDcpState(state),
+						}, ctx)
+						return finishContext("compress.auto", prunedMessages, {
+							candidate,
+							messageCandidates,
+							contextPercent,
+							thresholds,
+							clearedAnchors,
+						})
+					} catch (error) {
+						writeDcpDebugLog(effectiveConfig, "compress.auto_failed", {
+							trigger: autoDecision.reason,
+							error: error instanceof Error ? error.message : String(error),
+							candidate,
+							state: summarizeDcpState(state),
+						}, ctx)
+						// Fall through to normal nudge emission on failure.
+					}
+				}
+			}
+
 			if (nudgeType && !manualEmergencyOnly) {
 				const nudgeText = appendConcreteNudgeGuidance(
 					baseNudgeText(nudgeType),

package/external/pi-tools-suite/src/dcp/prompts.ts

@@ -30,6 +30,8 @@ Use \`compress\` as context-pressure housekeeping, not as a reflex after every s
 
 A closed slice is any finished implementation, verification, config edit, answered exploration, dead-end debugging branch, or test/log inspection. Passing logs are summary-only: preserve command, pass/fail, key failures if any, and whether follow-up is needed; never keep a full passing log in live context. Treat large shell/read/repo/web outputs as disposable evidence once their facts are extracted.
 
+Completed todo/task/subtask milestones are strong boundary signals, not automatic triggers. When context pressure makes compression useful, prefer the range covering a just-finished todo item if it is closed and non-trivial; do not compress merely because a todo was completed while context remains low.
+
 Before compressing while work is unfinished, ensure one \`todo in_progress\` captures the active objective and next step.
 
 When a \`<dcp-system-reminder>\` appears, treat it as a context-pressure signal. Follow critical/high-context reminders promptly. For routine reminders, compress only if a genuinely closed, useful-to-summarize slice exists; otherwise continue the next atomic step and re-check later.
@@ -183,6 +185,7 @@ You MUST use the \`compress\` tool now. Do not continue normal exploration until
 
 If you are in the middle of a critical atomic operation, finish that atomic step first, then compress immediately.
 If any closed slice exists (finished implementation, verification, config/doc edit, answered exploration, dead end, or test/log inspection), compress it before replying or starting another task. Passing logs should become command + pass/fail + follow-up status only.
+Recently completed todo/task/subtask items are preferred boundaries when they form a high-yield closed slice.
 
 RANGE STRATEGY (MANDATORY)
 Prioritize one large, closed, high-yield compression range first.
@@ -210,6 +213,7 @@ ACTION REQUIRED: Context usage is high.
 Before doing more exploration, look for a high-yield closed range that no longer needs to stay raw. Compress it now if one is safe and useful.
 
 This is context-pressure guidance, not a request to compress tiny or still-needed slices. If completed research, implementation, verification, config/doc edit, CI-log inspection, or dead-end debugging is large enough to reduce signal, call the \`compress\` tool before continuing normal work.
+Recently completed todo/task/subtask items are preferred candidates when they form a non-trivial closed slice; do not compress merely because a tiny todo was completed.
 High-priority stale shell/read/repo/web outputs should be compressed once no exact raw text is needed. Passing logs should not remain raw after they are understood.
 
 RANGE SELECTION
@@ -230,6 +234,8 @@ CONTEXT CHECK: Evaluate whether compression would materially improve the live co
 
 If a range is cleanly closed, non-trivial, and unlikely to be needed verbatim again, use the \`compress\` tool. If direction has shifted, consider whether earlier ranges are now less relevant.
 
+If a todo/task/subtask was just completed, treat that completed work as a preferred compression boundary when it is large enough and no longer needed raw; completion alone is not a reason to compress while context is still low.
+
 Do not compress just because a small slice closed while context is still low. Prefer compression before another large batch of searches, reads, CI log fetches, or tests when a high-yield stale slice exists.
 High-priority stale shell/read/repo/web outputs and understood passing logs should be compressed once no exact raw text is needed.
 
@@ -247,6 +253,8 @@ CONTEXT CHECK: You've been iterating for a while after the last user message.
 
 Pause before the next large non-atomic tool batch. If there is a closed portion that is unlikely to be referenced immediately and is worth summarizing (for example, finished research before implementation, completed config edit, completed CI-log triage, a verified fix, or a dead-end investigation), use the \`compress\` tool on it.
 
+If a todo/task/subtask was just completed, prefer that completed work as the compression boundary when it is non-trivial and safe to summarize; do not compress merely because the todo status changed.
+
 Avoid accumulating large tool outputs while a high-yield completed slice remains raw. If only small or still-needed ranges are closed, continue the next atomic step and re-check later.
 
 Prefer multiple short, closed ranges over one large range when several independent slices are ready.

package/external/pi-tools-suite/src/dcp/state.ts

@@ -218,6 +218,24 @@ export interface DcpState {
   nextNudgeAnchorId: number
   /** Diagnostic/telemetry snapshot for the latest emitted reminder. */
   lastNudge?: DcpLastNudge
+  /**
+   * The context window observed on the previous `context` event, used to
+   * detect a mid-session model/window downgrade (e.g. switch from a 1M model
+   * to a 275K model). When the window shrinks and inherited tokens already
+   * exceed `minContextPercent`, the context handler forces a pre-emptive
+   * strong nudge so the model is told to compress before the window fills.
+   * `undefined` until the first context event records a window.
+   */
+  lastContextWindow?: number
+  /**
+   * How many consecutive `context-strong` nudges have been emitted without a
+   * subsequent successful `compress` (model- or DCP-initiated). When this
+   * reaches `compress.autoCompress.patience` while context is above the
+   * emergency threshold, the auto-compress fallback creates a block without
+   * waiting for the model. Reset to 0 on any successful compression, when
+   * pressure drops below the emergency threshold, or on a window change.
+   */
+  consecutiveIgnoredStrongNudges: number
 }
 
 // ---------------------------------------------------------------------------
@@ -247,6 +265,8 @@ export function createState(): DcpState {
     nudgeAnchors: [],
     nextNudgeAnchorId: 1,
     lastNudge: undefined,
+    lastContextWindow: undefined,
+    consecutiveIgnoredStrongNudges: 0,
   }
 }
 
@@ -276,6 +296,8 @@ export function resetState(state: DcpState): void {
   state.nudgeAnchors = []
   state.nextNudgeAnchorId = 1
   state.lastNudge = undefined
+  state.lastContextWindow = undefined
+  state.consecutiveIgnoredStrongNudges = 0
 }
 
 /**
@@ -412,6 +434,17 @@ export interface SerializedDcpState {
   nudgeCounter?: number
   /** Persisted since v?.?. Diagnostic turn of the last emitted nudge. */
   lastNudgeTurn?: number
+  /**
+   * Persisted so a mid-session window downgrade (model switch to a smaller
+   * context window) is still detectable after a pi process restart / resume.
+   */
+  lastContextWindow?: number
+  /**
+   * Persisted so the auto-compress fallback's patience counter survives a pi
+   * process restart / resume, preventing a stuck "model ignores strong nudges"
+   * state from being silently cleared by a reload.
+   */
+  consecutiveIgnoredStrongNudges?: number
   /** Hash of the last persisted serialized state, used for dedup. */
   _stateHash?: string
 }
@@ -583,6 +616,8 @@ export function serializeState(state: DcpState): SerializedDcpState {
     currentTurn: state.currentTurn,
     nudgeCounter: state.nudgeCounter,
     lastNudgeTurn: state.lastNudgeTurn,
+    lastContextWindow: state.lastContextWindow,
+    consecutiveIgnoredStrongNudges: state.consecutiveIgnoredStrongNudges,
   }
 }
 
@@ -743,6 +778,12 @@ export function restoreState(state: DcpState, data: unknown): void {
   if (typeof saved.currentTurn === "number" && Number.isFinite(saved.currentTurn) && saved.currentTurn >= 0) {
     state.currentTurn = Math.floor(saved.currentTurn)
   }
+  if (typeof saved.lastContextWindow === "number" && Number.isFinite(saved.lastContextWindow) && saved.lastContextWindow > 0) {
+    state.lastContextWindow = saved.lastContextWindow
+  }
+  if (typeof saved.consecutiveIgnoredStrongNudges === "number" && Number.isFinite(saved.consecutiveIgnoredStrongNudges) && saved.consecutiveIgnoredStrongNudges >= 0) {
+    state.consecutiveIgnoredStrongNudges = Math.floor(saved.consecutiveIgnoredStrongNudges)
+  }
 }
 
 // ---------------------------------------------------------------------------

package/external/pi-tools-suite/src/default-pi-tools-suite-config.ts

@@ -8,7 +8,8 @@ export const DEFAULT_PI_TOOLS_SUITE_CONFIG_JSONC = String.raw`{
   // When true, todo items may carry a per-task thinking level and the todo
   // module will switch/restore Pi's thinking level as in-progress tasks change.
   "todoThinking": true,
-  // Vision-capable model used by GLM's lookup tool. Remove or set to null to disable lookup.
+  // Vision-capable model used by the coding-discipline lookup tool for blind-model
+  // screenshot/image questions. Remove or set to null to disable lookup.
   "lookupModel": "openai-codex/gpt-5.4-mini",
   "terminalBell": { "sound": true },
   // comment-checker: nudges the agent to remove AI-slop code comments it just
@@ -38,10 +39,10 @@ export const DEFAULT_PI_TOOLS_SUITE_CONFIG_JSONC = String.raw`{
     "debugLog": { "maxBytes": 5242880, "maxBackups": 3 },
     "manualMode": { "enabled": false, "automaticStrategies": true },
     "modelOverrides": {
-      "openai-codex/gpt-5.5": {
+      "openai-codex/gpt-5*": {
         "compress": {
-          "minContextPercent": "28%",
-          "maxContextPercent": "48%"
+          "minContextPercent": "26%",
+          "maxContextPercent": "46%"
         }
       },
       "openai-codex/gpt-5.4-mini": {
@@ -92,8 +93,15 @@ export const DEFAULT_PI_TOOLS_SUITE_CONFIG_JSONC = String.raw`{
       "maxContextPercent": "55%",
       "nudgeFrequency": 1,
       "iterationNudgeThreshold": 4,
+      "nudgeForce": "strong",
       "autoCandidates": { "minContextPercent": 0.2 },
-      "messageMode": { "minContextPercent": 0.2 }
+      "messageMode": { "minContextPercent": 0.2 },
+      "autoCompress": {
+        "enabled": false,
+        "patience": 2,
+        "summarizerModel": ["zai/glm-5.2", "zai/glm-4.5-air"],
+        "timeoutMs": 20000
+      }
     }
   },
   "asyncSubagents": {
@@ -101,7 +109,7 @@ export const DEFAULT_PI_TOOLS_SUITE_CONFIG_JSONC = String.raw`{
     "routing": { "enabled": true, "model": "zai/glm-4.5-air", "maxTaskChars": 1200, "maxTokens": 512, "maxRetries": 1, "timeoutMs": 12000, "debug": false },
     "presets": {
       "cheap": {
-        "description": "Use cheap GLM/Gemini Flash models for text/code roles; keep vision on the enabled GPT vision model.",
+        "description": "Use cheap GLM/Gemini Flash models for text/code roles.",
         "types": {
           "quick": { "model": "zai/glm-4.5-air", "thinking": "off" },
           "scan": { "model": "zai/glm-4.5-air", "thinking": "off" },
@@ -115,8 +123,7 @@ export const DEFAULT_PI_TOOLS_SUITE_CONFIG_JSONC = String.raw`{
           "tests": { "model": "zai/glm-5-turbo", "thinking": "medium" },
           "review": { "model": "zai/glm-5.2", "thinking": "high" },
           "implement": { "model": "zai/glm-5.2", "thinking": "high" },
-          "deep": { "model": "zai/glm-5.2", "thinking": "high" },
-          "vision": { "model": "openai-codex/gpt-5.4-mini", "thinking": "off" }
+          "deep": { "model": "zai/glm-5.2", "thinking": "high" }
         }
       },
       "gpt": {
@@ -166,8 +173,7 @@ export const DEFAULT_PI_TOOLS_SUITE_CONFIG_JSONC = String.raw`{
             "model": "openai-codex/gpt-5.5",
             "fallbackModels": ["zai/glm-5.2"],
             "thinking": "high"
-          },
-          "vision": { "model": "openai-codex/gpt-5.4-mini", "thinking": "off" }
+          }
         }
       },
       "deep": {
@@ -217,8 +223,7 @@ export const DEFAULT_PI_TOOLS_SUITE_CONFIG_JSONC = String.raw`{
             "model": "antigravity/antigravity-claude-opus-4-6-thinking",
             "fallbackModels": ["openai-codex/gpt-5.5", "zai/glm-5.2"],
             "thinking": "high"
-          },
-          "vision": { "model": "openai-codex/gpt-5.4-mini", "thinking": "off" }
+          }
         }
       }
     },
@@ -278,16 +283,19 @@ export const DEFAULT_PI_TOOLS_SUITE_CONFIG_JSONC = String.raw`{
         "fallbackModels": ["zai/glm-5.2"],
         "thinking": "high"
       },
-      "vision": {
-        "description": "Use only when task has imagePaths, screenshots, or asks to inspect visible UI/image content for a text-only parent.",
-        "model": "openai-codex/gpt-5.4-mini",
-        "thinking": "off",
-        "promptAppend": [
-          "You are a vision helper for a parent model that may not be able to see images.",
-          "Inspect any attached images and any image paths mentioned in the task/scope. Describe concrete visible details, UI state, text, layout, errors, and uncertainties.",
-          "If focus instructions are provided, prioritize them, but still mention other important visible findings.",
-          "Do not make code changes. Return a compact visual description that the parent agent can rely on."
-        ]
+      "oracle": {
+        "description": "Oracle: cross-provider flagship second opinion for hard or high-stakes uncertainty. Use sparingly to pressure-test architecture, plans, root-cause hypotheses, risk/security calls, or final recommendations when independent disagreement is valuable. Read-only; advise, do not edit.",
+        "model": "openai-codex/gpt-5.5",
+        "fallbackModels": ["zai/glm-5.2"],
+        "thinking": "xhigh",
+        "tools": ["read", "grep", "bash"],
+        "modelByParent": {
+          "zai/*": { "model": "openai-codex/gpt-5.5", "fallbackModels": ["zai/glm-5.2"] },
+          "openai-codex/*": { "model": "zai/glm-5.2", "fallbackModels": ["openai-codex/gpt-5.5"] },
+          "antigravity/*": { "model": "zai/glm-5.2", "fallbackModels": ["openai-codex/gpt-5.5"] },
+          "anthropic/*": { "model": "openai-codex/gpt-5.5", "fallbackModels": ["zai/glm-5.2"] }
+        },
+        "promptAppend": "You are an oracle: a flagship model from a different provider giving a second opinion to the parent agent. Give a concise, decisive recommendation with key tradeoffs and risks. Disagree when warranted; do not rubber-stamp. Do not edit unless explicitly asked."
       }
     }
   },

package/external/pi-tools-suite/src/index.ts

@@ -10,11 +10,12 @@ type ExtensionModule = {
 };
 
 const MODULES: Array<{ name: string; load: () => Promise<ExtensionModule> }> = [
-	{ name: "glm-coding-discipline", load: () => import("./glm-coding-discipline/index") },
+	{ name: "coding-discipline", load: () => import("./coding-discipline/index") },
 	{ name: "ast-grep", load: () => import("./ast-grep/index") },
 	{ name: "async-subagents", load: () => import("./async-subagents/index") },
 	{ name: "lsp", load: () => import("./lsp/index") },
 	{ name: "comment-checker", load: () => import("./comment-checker/index") },
+	{ name: "session-name", load: () => import("./session-name/index") },
 	{ name: "repo-discovery", load: () => import("./repo-discovery/index") },
 	{ name: "antigravity-auth", load: () => import("./antigravity-auth/index") },
 	{ name: "opencode-import", load: () => import("./opencode-import/index") },

package/external/pi-tools-suite/src/session-name/index.ts

@@ -0,0 +1,37 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+
+import { SESSION_NAME_TOOL_DESCRIPTION } from "../tool-descriptions.js";
+
+type SessionNameParams = {
+	name?: string;
+};
+
+function formatCurrentName(name: string | undefined): string {
+	return name ? `Current session name: ${name}` : "No session name is set.";
+}
+
+export default function sessionName(pi: ExtensionAPI): void {
+	pi.registerTool({
+		...SESSION_NAME_TOOL_DESCRIPTION,
+		parameters: Type.Object({
+			name: Type.Optional(Type.String({ description: "New session name to set. Omit to read the current session name." })),
+		}),
+		async execute(_toolCallId: string, params: SessionNameParams) {
+			const nextName = params.name?.trim();
+
+			if (!nextName) {
+				return {
+					content: [{ type: "text", text: formatCurrentName(pi.getSessionName()) }],
+					details: { changed: false, sessionName: pi.getSessionName() ?? null },
+				};
+			}
+
+			pi.setSessionName(nextName);
+			return {
+				content: [{ type: "text", text: `Session name set: ${nextName}` }],
+				details: { changed: true, sessionName: nextName },
+			};
+		},
+	});
+}

package/external/pi-tools-suite/src/tool-descriptions.ts

@@ -73,7 +73,7 @@ export function asyncSubagentToolDescriptions(options: ToolDescriptionSetOptions
 			description: [
 				"Manage isolated async sub-agents for large, parallel, context-heavy work.",
 				"Presets from async-subagents config and /subagent-preset choose role model/thinking/args; AGENTS_PRESET or /subagent-preset session <name> overrides the current session; /subagent-preset init creates a sample config.",
-				"Omit subagentType so the router chooses a configured role unless the user or task requires a role, vision, or deterministic override.",
+				"Omit subagentType so the router chooses a configured role unless the user or task requires a role or deterministic override.",
 				repoDiscovery
 					? "Use for broad independent tracks, review axes, or hypotheses even though repo_* tools are available."
 					: "Use first for broad codebase discovery split into tracks, review axes, or incident-triage hypotheses when repo_* tools are unavailable.",
@@ -82,7 +82,7 @@ export function asyncSubagentToolDescriptions(options: ToolDescriptionSetOptions
 			].join(" "),
 			promptSnippet:
 				"Use subagents action='spawn' for multiple independent agents, explicit delegate/parallelize/split work requests, or one large review/debug track that should stay out of the parent context. " +
-				"Usually omit subagentType so the router chooses; set it only for user-named roles, vision/image handling, deterministic tests, or another concrete override. Avoid trivial reads/edits and do not call status/wait immediately after spawn just for progress. " +
+				"Usually omit subagentType so the router chooses; set it only for user-named roles, deterministic tests, or another concrete override. Avoid trivial reads/edits and do not call status/wait immediately after spawn just for progress. " +
 				(repoDiscovery
 					? "For one semantic code-discovery question, use repo_search; for independent tracks/hypotheses/review axes, delegate even when repo_* tools exist. Read result only after completion when findings are needed."
 					: "For one focused code-discovery question, use direct read/grep. Without repo_* tools, spawn several focused scan/quick agents first for broad multi-track discovery, incident triage, release readiness, risk strategy, or parallel reviews. Read result only after completion when findings are needed."),
@@ -97,8 +97,9 @@ export function asyncSubagentToolDescriptions(options: ToolDescriptionSetOptions
 					: "For incident triage, release readiness, or risk/test strategy with separate hypotheses or review tracks and no repo_* tools, call action='spawn' as the first discovery step; direct read/grep can follow.",
 				"Do not use subagents for exact-string lookups, known-file edits, typo/text replacements, obvious one-file changes, or interactive user input; use the cheapest direct path.",
 				"Spawn multiple focused agents in one action='spawn' call for independent questions; for synthetic tests or bounded probes, pass timeoutSeconds slightly above expected runtime.",
-				"For spawn, leave subagentType unset so the router chooses from configured roles. Set it only for user-named roles, vision/image handling, deterministic tests, or another concrete override.",
-				"Use subagentType='vision' with imagePaths and optional focus when images/screenshots/diagrams need visual inspection.",
+				"For spawn, leave subagentType unset so the router chooses from configured roles. Set it only for user-named roles, deterministic tests, or another concrete override.",
+				"Use subagentType='oracle' sparingly for cross-provider second opinions on high-stakes uncertainty or final plan/risk checks.",
+				"For screenshot/image inspection by blind models, use lookup; subagents only receive imagePaths when a broader delegated track genuinely needs them.",
 				"If the user asks to start, run, launch, or test parallel sub-agents, call action='spawn' and then stop; completion/failure notifications will wake the parent so do not immediately call action='status' or action='wait' just to see whether agents finished.",
 				"Use status for non-blocking progress/recovery, wait only when requested or needed, and result only after completion; registry mappings can recover latest runDir/agentId after reload.",
 				"Result output is compact with artifact links; inspect raw artifacts only when full details are necessary.",
@@ -251,6 +252,17 @@ export const TODO_TOOL_DESCRIPTION: ToolDescription = {
 	],
 };
 
+export const SESSION_NAME_TOOL_DESCRIPTION: ToolDescription = {
+	name: "session_name",
+	label: "Session Name",
+	description: "Show or set the current session name so the agent can retitle the active session without relying on slash-command parsing.",
+	promptSnippet: "Use session_name to rename the current session directly when the task calls for updating the session title.",
+	promptGuidelines: [
+		"Pass a short, user-meaningful name when renaming the current session.",
+		"Call without a name only when you need to read the current session name.",
+	],
+};
+
 export const WEB_SEARCH_TOOL_DESCRIPTIONS = {
 	webSearch: {
 		name: "web_search",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-ui-extend",
-  "version": "0.1.38",
+  "version": "0.1.41",
   "private": false,
   "type": "module",
   "bin": {
@@ -64,9 +64,9 @@
     "prepublishOnly": "npm run check && npm run build:pix && npm run generate-schemas"
   },
   "dependencies": {
-    "@earendil-works/pi-ai": "^0.79.6",
-    "@earendil-works/pi-coding-agent": "^0.79.6",
-    "@earendil-works/pi-tui": "^0.79.6",
+    "@earendil-works/pi-ai": "0.79.7",
+    "@earendil-works/pi-coding-agent": "0.79.7",
+    "@earendil-works/pi-tui": "0.79.7",
     "@mariozechner/clipboard": "^0.3.9",
     "jsonc-parser": "3.3.1",
     "typebox": "1.1.38",