pi-ui-extend 0.1.38 → 0.1.39

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.39",
   "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",