@cydm/pie 2.6.12 → 2.7.0

package/dist/cli.js

@@ -1,13 +1,29 @@
 #!/usr/bin/env node
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
+  VERSION,
   cleanupBashOutputArtifacts,
   createBashTool,
   createCliHostCapabilities,
   createCliWebResearchHealthStore,
   formatSize,
+  getAgentDir,
+  getBuiltinDir,
+  getConfigDir,
+  getCustomThemesDir,
+  getLogsDir,
+  getPackageDir,
+  getProjectSettingsPath,
+  getRuntimeLogPath,
+  getSessionsDir,
+  getSettingsPath,
+  getThemesDir,
+  migrateConfigFromAgentDir,
   truncateHeadTail
-} from "./chunks/chunk-AAEBH6KX.js";
+} from "./chunks/chunk-IPNAFMOJ.js";
+import {
+  resolveCliProjectRoot
+} from "./chunks/chunk-WLFOBECN.js";
 import {
   AGENTS_CONTEXT_FILE_NAME,
   AgentSessionController,
@@ -30,6 +46,7 @@ import {
   createFileObservationState,
   createPolicyEnforcedTools,
   createReadFileUnderstandingHandler,
+  createSearchContextTool,
   createSessionManager,
   createSharedFileSystemTools,
   createSharedWebSearchTool,
@@ -51,6 +68,7 @@ import {
   interactionAttentionResolution,
   isCompactSummaryMessage,
   isExtensionEnabled,
+  isToolAllowedInPlanMode,
   maybeAdvanceTodoExecutionState,
   modalityForReadFileUnderstandingKind,
   pauseExecutionState,
@@ -58,13 +76,12 @@ import {
   requestInteraction,
   resolveExtensionIdentity,
   restoreExecutionState,
-  selectToolsForRuntimePolicy,
   setEnablementInMap,
   setExtensionEnabledInSettings,
   shouldPreserveExecutionStateForUserText,
   supersedeExecutionState
-} from "./chunks/chunk-PPEWRUMQ.js";
-import "./chunks/chunk-HHNOENEH.js";
+} from "./chunks/chunk-6RBSTII7.js";
+import "./chunks/chunk-TWILEFLD.js";
 import {
   Deref,
   EMPTY_ASSISTANT_CONTENT_ERROR,
@@ -87,26 +104,9 @@ import {
   requiredCapabilityForToolPurpose,
   setLogger,
   sortToolModelCandidatesByCapability,
+  streamSimple,
   type_exports
-} from "./chunks/chunk-7B4IIBVS.js";
-import {
-  VERSION,
-  getAgentDir,
-  getBuiltinDir,
-  getConfigDir,
-  getCustomThemesDir,
-  getLogsDir,
-  getPackageDir,
-  getProjectSettingsPath,
-  getRuntimeLogPath,
-  getSessionsDir,
-  getSettingsPath,
-  getThemesDir,
-  migrateConfigFromAgentDir
-} from "./chunks/chunk-5353DEEC.js";
-import {
-  resolveCliProjectRoot
-} from "./chunks/chunk-WLFOBECN.js";
+} from "./chunks/chunk-R5I2QLF2.js";
 import {
   IsArray,
   IsBigInt,
@@ -51971,6 +51971,7 @@ var MODEL_OVERRIDE_KEYS = [
   "cost",
   "contextWindow",
   "maxTokens",
+  "transport",
   "headers",
   "compat",
   "cacheCapability",
@@ -51988,9 +51989,11 @@ function validateExtensionProviderConfig(provider, config) {
     throw new Error(`registerProvider("${provider}"): baseUrl must be an absolute URL`);
   }
   assertHeadersShape(config.headers, `registerProvider("${provider}")`);
+  validateTransport(config.transport, `registerProvider("${provider}")`);
   for (const model of config.models ?? []) {
     if (!model || typeof model.id !== "string" || !model.id.trim() || /\s/.test(model.id)) throw new Error(`registerProvider("${provider}"): invalid model id`);
     assertHeadersShape(model.headers, `registerProvider("${provider}") model "${model.id}"`);
+    validateTransport(model.transport, `Model "${model.id}"`);
     validateCompat(model.compat, `registerProvider("${provider}") model "${model.id}" compat`);
     validateCacheCapability(model.cacheCapability, `registerProvider("${provider}") model "${model.id}" cacheCapability`);
     validateWebSearchCapability(model.webSearch, `registerProvider("${provider}") model "${model.id}" webSearch`);
@@ -51998,7 +52001,7 @@ function validateExtensionProviderConfig(provider, config) {
   }
 }
 var REMOTE_CATALOG_CACHE_VERSION = 4;
-var SUPPORTED_REMOTE_APIS = /* @__PURE__ */ new Set(["openai-completions", "anthropic-messages"]);
+var SUPPORTED_REMOTE_APIS = /* @__PURE__ */ new Set(["openai-completions", "anthropic-messages", "openai-responses"]);
 var MAX_REMOTE_CATALOG_BYTES = 2 * 1024 * 1024;
 var OAUTH_RESTORE_LEEWAY_MS = 6e4;
 var OAUTH_REFRESH_TIMEOUT_MS = 3e4;
@@ -52495,11 +52498,17 @@ function validateFileCapabilities(value, label) {
     }
   }
 }
+function validateTransport(value, label) {
+  if (value !== void 0 && value !== "sse" && value !== "websocket" && value !== "auto") throw new Error(`${label}.transport is invalid`);
+}
 function validateCompat(value, label) {
   if (value === void 0) return;
   if (!isPlainRecord(value)) throw new Error(`${label} is invalid`);
   assertOnlyKeys(value, [
     "forcedReasoningEffort",
+    "store",
+    "supportsEncryptedReasoning",
+    "responsesContinuation",
     "supportsStore",
     "supportsDeveloperRole",
     "supportsReasoningEffort",
@@ -52517,6 +52526,9 @@ function validateCompat(value, label) {
     throw new Error(`${label}.forcedReasoningEffort must be "none"`);
   }
   for (const field of [
+    "store",
+    "supportsEncryptedReasoning",
+    "responsesContinuation",
     "supportsStore",
     "supportsDeveloperRole",
     "supportsReasoningEffort",
@@ -52537,12 +52549,14 @@ function validateRemoteModel(profileId, model) {
   if (!isPlainRecord(model) || typeof model.id !== "string" || !model.id.trim() || model.id !== model.id.trim() || /\s/.test(model.id)) throw new Error(`Remote profile "${profileId}" contains an invalid model id`);
   assertOnlyKeys(model, [
     "id",
+    "api",
     "name",
     "reasoning",
     "input",
     "cost",
     "contextWindow",
     "maxTokens",
+    "transport",
     "compat",
     "cacheCapability",
     "webSearch",
@@ -52556,6 +52570,7 @@ function validateRemoteModel(profileId, model) {
   for (const field of ["name", "displayName", "filePlatform", "attachmentPlatform", "apiKeyEnv"]) {
     assertOptionalString(model[field], `Remote profile "${profileId}" model "${model.id}" ${field}`);
   }
+  if (model.api !== void 0 && !SUPPORTED_REMOTE_APIS.has(model.api)) throw new Error(`Model "${model.id}" has unsupported api ${model.api}`);
   assertOptionalBoolean(model.reasoning, `Remote profile "${profileId}" model "${model.id}" reasoning`);
   if (!Array.isArray(model.input) || model.input.length === 0 || model.input.some((item) => !["text", "image", "audio", "video"].includes(item))) {
     throw new Error(`Remote profile "${profileId}" model "${model.id}" has invalid input capabilities`);
@@ -52569,6 +52584,7 @@ function validateRemoteModel(profileId, model) {
     throw new Error(`Remote profile "${profileId}" model "${model.id}" has invalid token limits`);
   }
   if (new Set(model.input).size !== model.input.length) throw new Error(`Remote profile "${profileId}" model "${model.id}" has duplicate input capabilities`);
+  validateTransport(model.transport, `Model "${model.id}"`);
   validateCompat(model.compat, `Remote profile "${profileId}" model "${model.id}" compat`);
   validateCacheCapability(model.cacheCapability, `Remote profile "${profileId}" model "${model.id}" cacheCapability`);
   validateWebSearchCapability(model.webSearch, `Remote profile "${profileId}" model "${model.id}" webSearch`);
@@ -52604,6 +52620,7 @@ function sanitizeRemotePayload(decoded, remote, catalogUrl, allowLocallyInjected
     if (!provider || provider !== provider.trim() || /\s/.test(provider) || !isPlainRecord(source)) throw new Error("catalog contains an invalid profile");
     assertOnlyKeys(source, [
       "baseUrl",
+      "endpoints",
       "api",
       "apiKey",
       "apiKeyEnv",
@@ -52611,6 +52628,7 @@ function sanitizeRemotePayload(decoded, remote, catalogUrl, allowLocallyInjected
       "displayName",
       "filePlatform",
       "attachmentPlatform",
+      "transport",
       "compat",
       "cacheCapability",
       "webSearch",
@@ -52626,8 +52644,13 @@ function sanitizeRemotePayload(decoded, remote, catalogUrl, allowLocallyInjected
       assertOptionalString(source[field], `Remote profile "${provider}" ${field}`);
     }
     validateRemoteEndpoint(source.baseUrl, catalogUrl, `Remote profile "${provider}"`);
+    validateProfileEndpoints(source, `Remote profile "${provider}"`);
+    for (const [api, endpoint] of Object.entries(source.endpoints ?? {})) {
+      validateRemoteEndpoint(endpoint, catalogUrl, `Remote profile "${provider}" endpoints.${api}`);
+    }
     if (!Array.isArray(source.models) || source.models.length === 0) throw new Error(`Remote profile "${provider}" has no models`);
     assertRemoteHeadersSafe(source.headers, `Remote profile "${provider}"`);
+    validateTransport(source.transport, `Remote profile "${provider}"`);
     validateCompat(source.compat, `Remote profile "${provider}" compat`);
     validateCacheCapability(source.cacheCapability, `Remote profile "${provider}" cacheCapability`);
     validateWebSearchCapability(source.webSearch, `Remote profile "${provider}" webSearch`);
@@ -52644,7 +52667,9 @@ function sanitizeRemotePayload(decoded, remote, catalogUrl, allowLocallyInjected
     }
     const sanitized = {
       baseUrl: source.baseUrl,
+      ...source.endpoints === void 0 ? {} : { endpoints: { ...source.endpoints } },
       api: source.api,
+      transport: source.transport,
       apiKeyEnv: remote.apiKeyEnv,
       ...source.headers === void 0 ? {} : { headers: { ...source.headers } },
       ...source.displayName === void 0 ? {} : { displayName: source.displayName },
@@ -52656,6 +52681,7 @@ function sanitizeRemotePayload(decoded, remote, catalogUrl, allowLocallyInjected
       ...source.fileCapabilities === void 0 ? {} : { fileCapabilities: { ...source.fileCapabilities } },
       models: source.models.map((model) => ({
         id: model.id,
+        ...model.api === void 0 ? {} : { api: model.api },
         ...model.name === void 0 ? {} : { name: model.name },
         ...model.reasoning === void 0 ? {} : { reasoning: model.reasoning },
         input: [...model.input],
@@ -52667,6 +52693,7 @@ function sanitizeRemotePayload(decoded, remote, catalogUrl, allowLocallyInjected
         },
         contextWindow: model.contextWindow,
         maxTokens: model.maxTokens,
+        ...model.transport === void 0 ? {} : { transport: model.transport },
         ...model.compat === void 0 ? {} : { compat: { ...model.compat } },
         ...model.cacheCapability === void 0 ? {} : { cacheCapability: { ...model.cacheCapability } },
         ...model.webSearch === void 0 ? {} : { webSearch: { ...model.webSearch } },
@@ -52739,16 +52766,41 @@ function validateModelOverrides(value) {
         if (typeof headerValue !== "string") throw new Error(`models.json modelOverrides["${key}"].headers.${headerName} must be a string`);
       }
     }
+    validateTransport(override.transport, `Model override "${key}"`);
     validateCompat(override.compat, `models.json modelOverrides["${key}"].compat`);
     validateCacheCapability(override.cacheCapability, `models.json modelOverrides["${key}"].cacheCapability`);
     validateWebSearchCapability(override.webSearch, `models.json modelOverrides["${key}"].webSearch`);
     validateFileCapabilities(override.fileCapabilities, `models.json modelOverrides["${key}"].fileCapabilities`);
   }
 }
+function validateProfileEndpoints(profile, label) {
+  if (profile.endpoints === void 0) return;
+  if (!isPlainRecord(profile.endpoints)) throw new Error(`${label} endpoints must be an object`);
+  for (const [api, value] of Object.entries(profile.endpoints)) {
+    if (!SUPPORTED_REMOTE_APIS.has(api)) throw new Error(`${label} endpoints has unsupported api ${api}`);
+    try {
+      if (typeof value !== "string") throw new Error("invalid URL");
+      const endpoint = new URL(value);
+      if (endpoint.protocol !== "http:" && endpoint.protocol !== "https:") throw new Error("unsupported protocol");
+    } catch {
+      throw new Error(`${label} endpoints.${api} must be an absolute HTTP(S) URL`);
+    }
+  }
+}
+function resolveProfileRoute(profile, model) {
+  const api = model.api ?? profile.api;
+  if (!SUPPORTED_REMOTE_APIS.has(api)) throw new Error(`Model "${model.id}" has unsupported api ${api}`);
+  const endpoint = profile.endpoints?.[api];
+  if (model.api !== void 0 && endpoint === void 0 && api !== profile.api) {
+    throw new Error(`Model "${model.id}" api ${api} requires profile endpoints.${api} (otherwise api must equal profile api)`);
+  }
+  return { api, baseUrl: endpoint ?? profile.baseUrl };
+}
 function validateProfileConfig(profileId, profileConfig) {
   if (!isPlainRecord(profileConfig)) throw new Error(`Profile "${profileId}" must be an object.`);
   assertOnlyKeys(profileConfig, [
     "baseUrl",
+    "endpoints",
     "api",
     "apiKey",
     "apiKeyEnv",
@@ -52756,6 +52808,7 @@ function validateProfileConfig(profileId, profileConfig) {
     "displayName",
     "filePlatform",
     "attachmentPlatform",
+    "transport",
     "compat",
     "cacheCapability",
     "webSearch",
@@ -52787,7 +52840,9 @@ function validateProfileConfig(profileId, profileConfig) {
   } catch {
     throw new Error(`Profile "${profileId}" baseUrl must be an absolute HTTP(S) URL`);
   }
+  validateProfileEndpoints(profileConfig, `Profile "${profileId}"`);
   assertHeadersShape(profileConfig.headers, `Profile "${profileId}"`);
+  validateTransport(profileConfig.transport, `Profile "${profileId}"`);
   validateCompat(profileConfig.compat, `Profile "${profileId}" compat`);
   validateCacheCapability(profileConfig.cacheCapability, `Profile "${profileId}" cacheCapability`);
   validateWebSearchCapability(profileConfig.webSearch, `Profile "${profileId}" webSearch`);
@@ -52797,12 +52852,14 @@ function validateProfileConfig(profileId, profileConfig) {
     if (!isPlainRecord(modelConfig)) throw new Error(`Profile "${profileId}" model #${index} must be an object.`);
     assertOnlyKeys(modelConfig, [
       "id",
+      "api",
       "name",
       "reasoning",
       "input",
       "cost",
       "contextWindow",
       "maxTokens",
+      "transport",
       "compat",
       "cacheCapability",
       "webSearch",
@@ -52826,6 +52883,7 @@ function validateProfileConfig(profileId, profileConfig) {
       );
     }
     validateRemoteModel(profileId, modelConfig);
+    resolveProfileRoute(profileConfig, modelConfig);
     assertHeadersShape(modelConfig.headers, `Profile "${profileId}" model "${modelConfig.id}"`);
     assertOptionalEnvName(modelConfig.apiKeyEnv, `Profile "${profileId}" model "${modelConfig.id}" apiKeyEnv`);
     if (seenModelIds.has(modelConfig.id)) throw new Error(`Profile "${profileId}" contains duplicate model "${modelConfig.id}".`);
@@ -52916,12 +52974,13 @@ var ModelRegistry = class {
           );
         }
         const existing = this.models.get(provider);
-        if (existing && (providerConfig.baseUrl || providerConfig.api || providerConfig.headers)) {
+        if (existing && (providerConfig.baseUrl || providerConfig.api || providerConfig.headers || providerConfig.transport)) {
           for (const model of existing.values()) {
             this.upsert({
               ...model,
               baseUrl: providerConfig.baseUrl || model.baseUrl,
               api: providerConfig.api || model.api,
+              transport: providerConfig.transport ?? model.transport,
               apiKeyEnv: providerConfig.apiKeyEnv || model.apiKeyEnv,
               displayName: providerConfig.displayName || model.displayName || provider,
               filePlatform: providerConfig.filePlatform || model.filePlatform,
@@ -52938,9 +52997,8 @@ var ModelRegistry = class {
           this.upsert({
             id: customModel.id,
             name: customModel.name || baseModel?.name || customModel.id,
-            api: providerConfig.api || baseModel?.api || "openai-completions",
+            ...resolveProfileRoute(providerConfig, customModel),
             provider,
-            baseUrl: providerConfig.baseUrl || baseModel?.baseUrl || "",
             reasoning: customModel.reasoning ?? baseModel?.reasoning ?? false,
             input: customModel.input || baseModel?.input || ["text"],
             cost: customModel.cost || baseModel?.cost || { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
@@ -52951,6 +53009,7 @@ var ModelRegistry = class {
             filePlatform: customModel.filePlatform || providerConfig.filePlatform || baseModel?.filePlatform,
             attachmentPlatform: customModel.attachmentPlatform || providerConfig.attachmentPlatform || baseModel?.attachmentPlatform,
             headers: providerConfig.headers ? { ...baseModel?.headers, ...providerConfig.headers, ...customModel.headers } : customModel.headers || baseModel?.headers,
+            transport: customModel.transport ?? providerConfig.transport ?? baseModel?.transport,
             compat: customModel.compat || providerConfig.compat || baseModel?.compat,
             cacheCapability: customModel.cacheCapability || providerConfig.cacheCapability || baseModel?.cacheCapability,
             webSearch: customModel.webSearch || providerConfig.webSearch || baseModel?.webSearch,
@@ -53003,6 +53062,7 @@ var ModelRegistry = class {
       if (override.maxTokens !== void 0) patched.maxTokens = override.maxTokens;
       if (override.cost !== void 0) patched.cost = { ...existing.cost, ...override.cost };
       if (override.headers !== void 0) patched.headers = { ...existing.headers, ...override.headers };
+      if (override.transport !== void 0) patched.transport = override.transport;
       if (override.compat !== void 0) patched.compat = deepMergePlainRecords(existing.compat, override.compat);
       if (override.cacheCapability !== void 0) patched.cacheCapability = { ...existing.cacheCapability, ...override.cacheCapability };
       if (override.webSearch !== void 0) patched.webSearch = { ...existing.webSearch, ...override.webSearch };
@@ -53024,9 +53084,8 @@ var ModelRegistry = class {
       this.upsert({
         id: customModel.id,
         name: customModel.name || customModel.id,
-        api: providerConfig.api || "openai-completions",
+        ...resolveProfileRoute(providerConfig, customModel),
         provider,
-        baseUrl: providerConfig.baseUrl || "",
         reasoning: customModel.reasoning ?? false,
         input: customModel.input || ["text"],
         cost: customModel.cost || { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
@@ -53037,6 +53096,7 @@ var ModelRegistry = class {
         filePlatform: customModel.filePlatform || providerConfig.filePlatform,
         attachmentPlatform: customModel.attachmentPlatform || providerConfig.attachmentPlatform,
         headers: { ...providerConfig.headers, ...customModel.headers },
+        transport: customModel.transport ?? providerConfig.transport,
         compat: customModel.compat || providerConfig.compat,
         cacheCapability: customModel.cacheCapability || providerConfig.cacheCapability,
         webSearch: customModel.webSearch || providerConfig.webSearch,
@@ -53476,12 +53536,13 @@ var ModelRegistry = class {
       this.authStorage.setProviderEnvVar(provider, config.apiKeyEnv);
     }
     const existing = this.models.get(provider);
-    if (existing && (config.baseUrl || config.api || config.headers)) {
+    if (existing && (config.baseUrl || config.api || config.headers || config.transport)) {
       for (const model of existing.values()) {
         this.upsert({
           ...model,
           baseUrl: config.baseUrl || model.baseUrl,
           api: config.api || model.api,
+          transport: config.transport ?? model.transport,
           headers: config.headers ? { ...model.headers, ...config.headers } : model.headers
         });
       }
@@ -53502,6 +53563,7 @@ var ModelRegistry = class {
         apiKeyEnv: config.apiKeyEnv || baseModel?.apiKeyEnv,
         displayName: customModel.displayName || baseModel?.displayName || provider,
         headers: config.headers ? { ...baseModel?.headers, ...config.headers, ...customModel.headers } : customModel.headers || baseModel?.headers,
+        transport: customModel.transport ?? config.transport ?? baseModel?.transport,
         compat: customModel.compat || baseModel?.compat,
         cacheCapability: customModel.cacheCapability || baseModel?.cacheCapability,
         webSearch: customModel.webSearch || baseModel?.webSearch,
@@ -54053,7 +54115,7 @@ function checkComputerUse() {
       id: "computer_use_helper",
       label: "computer-use helper",
       status: "warn",
-      message: `computer-use helper app is not installed yet; it installs on first tool use to ${appPath}. Afterwards grant Accessibility and Screen Recording to pie-computer-use.app in System Settings \u2192 Privacy & Security.`,
+      message: `computer-use helper app is not installed yet; it installs on first computer-use-axi use to ${appPath}. Afterwards grant Accessibility and Screen Recording to pie-computer-use.app in System Settings \u2192 Privacy & Security.`,
       details: { appPath }
     };
   }
@@ -54341,7 +54403,7 @@ var MODE_RULES = {
     "~/.pie is allowlisted for Pie configuration and session support.",
     "Shell commands run from the workspace and return structured output, timeout, and truncation details.",
     "web_research is read-only, uses provider-native web/search/fetch capabilities, and does not grant bash/curl web scraping permission.",
-    "computer-use observe tools only read the screen; act_ui synthesizes real desktop input and requires a first-use confirmation each session.",
+    "Desktop control runs through the computer-use-axi skill CLI via bash: observation commands only read the screen, while act synthesizes real desktop input and goes through normal shell permission prompts.",
     "Protected paths from extensions can block reads/writes even when tools are present."
   ],
   plan: [
@@ -54351,7 +54413,7 @@ var MODE_RULES = {
   yolo: [
     "/settings/yolo relaxes filesystem sandbox directory restrictions.",
     "It does not make destructive shell commands safe; use it only in trusted workspaces.",
-    "It also bypasses the computer-use act_ui first-use confirmation."
+    "It also auto-approves shell commands, including computer-use-axi desktop input."
   ],
   subagents: [
     "Subagents inherit the parent tool set, then runtime policy removes write and high-risk tools.",
@@ -56502,7 +56564,10 @@ function createExtensionContext(extension, cwd, uiContext, abortFn, isIdleFn, ha
     },
     get yoloMode() {
       return actions?.yoloMode ?? false;
-    }
+    },
+    // Only expose setYoloMode when the host can actually toggle it — plan-mode
+    // gates the option on typeof ctx.setYoloMode === "function".
+    ...actions?.setYoloMode ? { setYoloMode: (enabled) => actions.setYoloMode(enabled) } : {}
   };
   return context;
 }
@@ -60395,8 +60460,8 @@ var Editor = class {
     this.historyIndex = -1;
     this.lastAction = null;
     this.pushUndoSnapshot();
-    const cleanText2 = pastedText.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
-    const tabExpandedText = cleanText2.replace(/\t/g, "    ");
+    const cleanText = pastedText.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+    const tabExpandedText = cleanText.replace(/\t/g, "    ");
     let filteredText = tabExpandedText.split("").filter((char) => char === "\n" || char.charCodeAt(0) >= 32).join("");
     if (/^[/~.]/.test(filteredText)) {
       const currentLine = this.state.lines[this.state.cursorLine] || "";
@@ -61480,9 +61545,9 @@ var Input = class {
   handlePaste(pastedText) {
     this.lastAction = null;
     this.pushUndo();
-    const cleanText2 = pastedText.replace(/\r\n/g, "").replace(/\r/g, "").replace(/\n/g, "");
-    this.value = this.value.slice(0, this.cursor) + cleanText2 + this.value.slice(this.cursor);
-    this.cursor += cleanText2.length;
+    const cleanText = pastedText.replace(/\r\n/g, "").replace(/\r/g, "").replace(/\n/g, "");
+    this.value = this.value.slice(0, this.cursor) + cleanText + this.value.slice(this.cursor);
+    this.cursor += cleanText.length;
   }
   invalidate() {
   }
@@ -64255,7 +64320,10 @@ var ExtensionRunner = class {
       },
       get yoloMode() {
         return runner.actions.yoloMode ?? false;
-      }
+      },
+      // Only expose setYoloMode when the host can actually toggle it — plan-mode
+      // gates the option on typeof ctx.setYoloMode === "function".
+      ...runner.actions.setYoloMode ? { setYoloMode: (enabled) => runner.actions.setYoloMode(enabled) } : {}
     };
     return createLoggedProxy(context, `ExtensionContext#${contextId}`);
   }
@@ -70219,20 +70287,52 @@ function getLastContextSignals(hostKey) {
 }
 function computeContextSignals(hostKey, systemPrompt, tools, messages) {
   const prefixHash = computePromptPrefixHash(systemPrompt, tools);
+  const systemHash = computePromptPrefixHash(systemPrompt, []);
+  const toolsHash = computePromptPrefixHash("", tools);
   const previous = signalMemories.get(hostKey);
   const prefixHashChanged = previous !== void 0 && previous.hash !== prefixHash;
   if (previous?.hash !== prefixHash) {
-    signalMemories.set(hostKey, { hash: prefixHash });
+    signalMemories.set(hostKey, { hash: prefixHash, systemHash, toolsHash });
   }
   const signals = {
     prefixHash,
     prefixHashChanged,
+    ...prefixHashChanged && previous ? { previousPrefixHash: previous.hash } : {},
+    systemPromptChanged: prefixHashChanged && previous !== void 0 && previous.systemHash !== systemHash,
+    toolsChanged: prefixHashChanged && previous !== void 0 && previous.toolsHash !== toolsHash,
     cacheHitRate: calculateCumulativeCacheHitRate(messages)
   };
   lastSignals.set(hostKey, signals);
   return signals;
 }
 
+// src/runtime/cache-invalidation-trace.ts
+function noteCacheInvalidationInChat(host, signals) {
+  if (!signals || !signals.prefixHashChanged) return;
+  const parts = [];
+  if (signals.systemPromptChanged && signals.toolsChanged) parts.push("system prompt + tools rebuilt");
+  else if (signals.toolsChanged) parts.push("tools rebuilt");
+  else if (signals.systemPromptChanged) parts.push("system prompt rebuilt");
+  else parts.push("prefix rebuilt");
+  const from = signals.previousPrefixHash ?? "?";
+  const line = `\u26A1 Prompt cache invalidated: \u2301${from} \u2192 \u2301${signals.prefixHash} (${parts.join(", ")})`;
+  if (host.chatContainer && host.ui) {
+    host.chatContainer.addChild(new Spacer(1));
+    host.chatContainer.addChild(new Text(theme.fg("warning", line), 1, 0));
+    host.ui.requestRender();
+  }
+  host.sessionTrace?.noteRuntimeEvent("cache_prefix_invalidated", {
+    from,
+    to: signals.prefixHash,
+    systemPromptChanged: signals.systemPromptChanged,
+    toolsChanged: signals.toolsChanged
+  });
+}
+function applyContextSignalsWithTrace(host) {
+  applyContextSignalsToFooter(host);
+  noteCacheInvalidationInChat(host, getLastContextSignals(host));
+}
+
 // src/commands/interactive-session-commands.ts
 import * as os6 from "os";
 
@@ -71171,6 +71271,9 @@ var TreeSelectorComponent = class {
   pageNext() {
     if (this.goToNextPage()) {
       this.statusMessage = null;
+    } else if (this.filteredRows.length > 0) {
+      this.selectedIndex = Math.max(0, this.filteredRows.length - 1);
+      this.statusMessage = "latest page - at newest entry";
     } else {
       this.statusMessage = this.pageSummaries.length === 0 ? "no entries" : "latest page";
     }
@@ -71178,10 +71281,58 @@ var TreeSelectorComponent = class {
   pagePrev() {
     if (this.goToPreviousPage()) {
       this.statusMessage = null;
+    } else if (this.filteredRows.length > 0) {
+      this.selectedIndex = 0;
+      this.statusMessage = "oldest page - at first entry";
     } else {
       this.statusMessage = this.pageSummaries.length === 0 ? "no entries" : "oldest page";
     }
   }
+  /** Jump to the oldest page (seqs start at 1; afterSeq 0 = from the start). */
+  jumpToFirstPage() {
+    if (this.pageSummaries.length > 0 && !this.hasPrev) {
+      this.selectedIndex = 0;
+      this.statusMessage = "oldest page - at first entry";
+      return;
+    }
+    if (this.fetchWindow(0, null)) {
+      this.selectedIndex = 0;
+      this.statusMessage = null;
+    }
+  }
+  /** Jump to the newest page. Seqs are 1..total (append-only journal), so the last window starts at total - pageSize. */
+  jumpToLastPage() {
+    if (this.pageSummaries.length > 0 && !this.hasNext) {
+      this.selectedIndex = Math.max(0, this.filteredRows.length - 1);
+      this.statusMessage = "latest page - at newest entry";
+      return;
+    }
+    let anchor = Math.max(0, this.totalEntries - this.pageSizeValue);
+    for (let attempt = 0; attempt < 4; attempt++) {
+      if (this.fetchWindow(anchor, null)) {
+        if (this.hasNext) {
+          anchor = this.pageSummaries[this.pageSummaries.length - 1].seq;
+          continue;
+        }
+        this.selectedIndex = Math.max(0, this.filteredRows.length - 1);
+        this.statusMessage = null;
+        return;
+      }
+      if (anchor === 0 || !this.hasNext) break;
+      anchor = Math.max(0, anchor - this.pageSizeValue);
+    }
+  }
+  /** Move the cursor one viewport within the resident page; ←/→ change pages. */
+  screenScroll(delta) {
+    if (this.filteredRows.length === 0) return;
+    const next = Math.max(0, Math.min(this.selectedIndex + delta, this.filteredRows.length - 1));
+    if (next === this.selectedIndex) {
+      this.statusMessage = delta > 0 ? "end of page - \u2192 for next page" : "start of page - \u2190 for previous page";
+      return;
+    }
+    this.selectedIndex = next;
+    this.statusMessage = null;
+  }
   /**
    * Bounded "next match": step to the next in-page match, otherwise scan
    * forward at most SEARCH_SCAN_PAGE_LIMIT pages per press. Never scans
@@ -71235,7 +71386,7 @@ var TreeSelectorComponent = class {
     lines.push(createLine("  Conversation Tree", width, false));
     lines.push(
       createLine(
-        "  \u2191\u2193:move  \u2190\u2192:page  e:collapse  tab:next match  F:fork  Enter:navigate  Esc:cancel",
+        "  \u2191\u2193:move  \u2190\u2192:page  PgUp/PgDn:screen  Home/End:jump  e:collapse  tab:match  F:fork  Enter:go  Esc:cancel",
         width,
         false
       )
@@ -71304,10 +71455,18 @@ var TreeSelectorComponent = class {
       this.moveUp();
     } else if (kb.matches(keyData, "selectDown")) {
       this.moveDown();
-    } else if (kb.matches(keyData, "cursorRight") || kb.matches(keyData, "selectPageDown")) {
+    } else if (kb.matches(keyData, "cursorRight")) {
       this.pageNext();
-    } else if (kb.matches(keyData, "cursorLeft") || kb.matches(keyData, "selectPageUp")) {
+    } else if (kb.matches(keyData, "cursorLeft")) {
       this.pagePrev();
+    } else if (kb.matches(keyData, "selectPageDown")) {
+      this.screenScroll(this.maxVisibleLines);
+    } else if (kb.matches(keyData, "selectPageUp")) {
+      this.screenScroll(-this.maxVisibleLines);
+    } else if (kb.matches(keyData, "cursorLineStart")) {
+      this.jumpToFirstPage();
+    } else if (kb.matches(keyData, "cursorLineEnd")) {
+      this.jumpToLastPage();
     } else if (keyData === "e" || keyData === "E") {
       this.toggleCollapse();
     } else if (kb.matches(keyData, "selectConfirm")) {
@@ -72826,7 +72985,7 @@ async function loadSession(host, sessionId) {
       contextPercent,
       contextWindow
     });
-    applyContextSignalsToFooter(host);
+    applyContextSignalsWithTrace(host);
     host.ui.requestRender();
     setTimeout(() => host.ui.requestRender(), 100);
   } catch (error) {
@@ -73864,7 +74023,7 @@ function bindInteractiveRuntimeEvents(host) {
           contextPercent,
           contextWindow
         });
-        applyContextSignalsToFooter(host);
+        applyContextSignalsWithTrace(host);
         host.safeRequestRender();
         host.sessionManager.save().catch((err) => {
           console.error("[Session] Auto-save failed:", err);
@@ -74913,9 +75072,9 @@ function collectKnownToolNames(host) {
 function describeToggleEffect(host, name, enabled) {
   const loaded = collectKnownToolNames(host).active.includes(name);
   if (enabled) {
-    return loaded ? `Tool "${name}" enabled (active now).` : `Tool "${name}" enabled in ~/.pie/settings.json (loads on next start \u2014 it was not loaded this session).`;
+    return loaded ? `Tool "${name}" enabled (saved to ~/.pie/settings.json; active now).` : `Tool "${name}" enabled in ~/.pie/settings.json (loads on next start \u2014 it was not loaded this session).`;
   }
-  return loaded ? `Tool "${name}" disabled (removed from this session).` : `Tool "${name}" disabled in ~/.pie/settings.json.`;
+  return loaded ? `Tool "${name}" disabled (saved to ~/.pie/settings.json; removed from this and future sessions).` : `Tool "${name}" disabled in ~/.pie/settings.json.`;
 }
 function showToolsManager(host) {
   host.showSelector((done) => {
@@ -75020,7 +75179,7 @@ function handleToolsCommand(host, args) {
       host.chatContainer.addChild(new Text(theme.fg("dim", "  No tools available."), 1, 0));
     }
     for (const name of active) {
-      const state = host.options.settingsManager.isToolEnabled(name) ? "enabled" : "disabled (removed from this session)";
+      const state = host.options.settingsManager.isToolEnabled(name) ? "enabled" : "disabled (saved to ~/.pie/settings.json; removed this session)";
       host.chatContainer.addChild(new Text(theme.fg("dim", `  \u2022 ${name}: ${state}`), 1, 0));
     }
     for (const name of disabled) {
@@ -76398,7 +76557,7 @@ async function handleClearCommand(host) {
     contextPercent: contextWindow > 0 && contextUsage.tokens !== null ? contextUsage.tokens / contextWindow * 100 : 0,
     contextWindow
   });
-  applyContextSignalsToFooter(host);
+  applyContextSignalsWithTrace(host);
   host.updateTerminalTitle();
   host.chatContainer.clear();
   host.streamingComponent = void 0;
@@ -76487,7 +76646,10 @@ function createExtensionContextForCommands(host) {
         console.error(`[Extension] Tools restricted to: ${tools.join(", ")}`);
       }
     },
-    getActiveTools: () => host.agent.state.tools.map((tool) => tool.name),
+    getActiveTools: () => {
+      const tools = host.agent.state.tools;
+      return (host.planModeEnabled ? tools.filter((tool) => isToolAllowedInPlanMode(tool)) : tools).map((tool) => tool.name);
+    },
     sendUserMessage: (content) => {
       if (host.editor.onSubmit) {
         void host.editor.onSubmit(content);
@@ -76784,6 +76946,7 @@ async function handleCompactCommand(host) {
     const compactedMessages = host.sessionManager.getMessages();
     host.replaceAgentMessagesAndMarkSynced(compactedMessages);
     host.resetFileObservationState();
+    host.resetRuntimeModeBlocks?.();
     host.streamingComponent = void 0;
     host.pendingTools.clear();
     host.chatContainer.clear();
@@ -76808,7 +76971,7 @@ async function handleCompactCommand(host) {
       contextPercent,
       contextWindow
     });
-    applyContextSignalsToFooter(host);
+    applyContextSignalsWithTrace(host);
     await host.sessionManager.save();
     host.safeRequestRender();
   } catch (error) {
@@ -78927,8 +79090,12 @@ function queueMessage(host, text, mode, options = {}) {
   }
   const clearEditor = options.clearEditor ?? true;
   host.sessionTrace.notePendingUserText(text);
+  const runtimeBlock = host.runtimeModeBlockForNextMessage?.();
+  const content = runtimeBlock ? `${runtimeBlock}
+
+${text}` : text;
   void host.agentSessionController.prompt(
-    { role: "user", content: text, timestamp: Date.now() },
+    { role: "user", content, timestamp: Date.now() },
     {
       source: "interactive",
       streamingBehavior: mode,
@@ -80501,6 +80668,7 @@ function createInteractiveAgentSessionController(host) {
           return;
         }
         host.resetFileObservationState();
+        host.resetRuntimeModeBlocks?.();
         if (!event.result?.aborted) {
           host.streamingComponent = void 0;
           host.pendingTools.clear();
@@ -80523,7 +80691,7 @@ function createInteractiveAgentSessionController(host) {
           contextPercent,
           contextWindow
         });
-        applyContextSignalsToFooter(host);
+        applyContextSignalsWithTrace(host);
         host.safeRequestRender();
         if (!event.result?.aborted) {
           if (autoCompactBeforeStats !== null) {
@@ -80552,94 +80720,80 @@ function createInteractiveAgentSessionController(host) {
 }
 
 // src/runtime/runtime-mode-context.ts
-var RUNTIME_MODE_CONTEXT_MARKER = "<runtime-mode-context>";
-var RUNTIME_MODE_CONTEXT_END_MARKER = "</runtime-mode-context>";
-var STALE_SYSTEM_REMINDER_RE = /<system-reminder>\s*# Plan Mode[\s\S]*?<\/system-reminder>\s*/gi;
-var STALE_RUNTIME_CONTEXT_RE = /<runtime-mode-context>[\s\S]*?<\/runtime-mode-context>\s*/gi;
-function isRecord3(value) {
-  return !!value && typeof value === "object" && !Array.isArray(value);
+function isAgentMessage(value) {
+  return !!value && typeof value === "object" && "role" in value;
 }
-function cleanText(text) {
-  let stripped = 0;
-  const withoutRuntime = text.replace(STALE_RUNTIME_CONTEXT_RE, () => {
-    stripped++;
-    return "";
-  });
-  const withoutPlanReminder = withoutRuntime.replace(STALE_SYSTEM_REMINDER_RE, () => {
-    stripped++;
-    return "";
-  });
-  return { text: withoutPlanReminder, stripped };
-}
-function stripUserMessage(message) {
-  if (!isRecord3(message) || message.role !== "user") {
-    return { message, stripped: 0 };
+function prependRuntimeModeBlockToPrompt(input, block) {
+  if (!block) return input;
+  if (typeof input === "string") {
+    return input.trim() ? `${block}
+
+${input}` : block;
   }
-  const content = message.content;
-  if (typeof content === "string") {
-    const cleaned = cleanText(content);
-    if (cleaned.stripped === 0) return { message, stripped: 0 };
-    return {
-      message: {
-        ...message,
-        content: cleaned.text
-      },
-      stripped: cleaned.stripped
-    };
+  if (Array.isArray(input)) {
+    if (input.length > 0 && isAgentMessage(input[0])) {
+      return prependBlockToMessages(input, block);
+    }
+    return [{ type: "text", text: block }, ...input];
   }
-  if (!Array.isArray(content)) {
-    return { message, stripped: 0 };
-  }
-  let stripped = 0;
-  const nextContent = content.map((block) => {
-    if (!isRecord3(block) || block.type !== "text" || typeof block.text !== "string") {
-      return block;
-    }
-    const cleaned = cleanText(block.text);
-    stripped += cleaned.stripped;
-    return { ...block, text: cleaned.text };
-  }).filter((block) => !(isRecord3(block) && block.type === "text" && String(block.text ?? "").length === 0));
-  if (stripped === 0) return { message, stripped: 0 };
-  return {
-    message: {
-      ...message,
-      content: nextContent
-    },
-    stripped
-  };
+  if (isAgentMessage(input)) {
+    return prependBlockToMessages([input], block)[0];
+  }
+  return [{ type: "text", text: block }, ...input];
 }
-function stripRuntimeModeContext(messages) {
-  let stripped = 0;
-  const nextMessages = [];
-  for (const message of messages) {
-    const result = stripUserMessage(message);
-    stripped += result.stripped;
-    if (isRecord3(result.message) && result.message.role === "user") {
-      const content = result.message.content;
-      if (typeof content === "string" && content.trim().length === 0) {
-        continue;
-      }
-      if (Array.isArray(content) && content.length === 0) {
-        continue;
-      }
+function prependBlockToMessages(messages, block) {
+  const next = [...messages];
+  let target = -1;
+  for (let index = next.length - 1; index >= 0; index--) {
+    if (next[index]?.role === "user") {
+      target = index;
+      break;
     }
-    nextMessages.push(result.message);
   }
-  return { messages: nextMessages, stripped };
+  if (target < 0) {
+    next.push({ role: "user", content: block, timestamp: Date.now() });
+    return next;
+  }
+  const message = next[target];
+  if (typeof message.content === "string") {
+    next[target] = { ...message, content: `${block}
+
+${message.content}` };
+  } else if (Array.isArray(message.content)) {
+    next[target] = { ...message, content: [{ type: "text", text: block }, ...message.content] };
+  } else {
+    next.splice(target, 0, { role: "user", content: block, timestamp: Date.now() });
+  }
+  return next;
 }
+var RUNTIME_MODE_CONTEXT_MARKER = "<runtime-mode-context>";
+var RUNTIME_MODE_CONTEXT_END_MARKER = "</runtime-mode-context>";
 function buildRuntimeModeContext(state) {
   const lines = [
     RUNTIME_MODE_CONTEXT_MARKER,
-    "Current runtime mode:",
-    `- Plan mode: ${state.planMode === "planning" ? "active (workspace read-only; plan_scratch permits session-local temporary drafts)" : "off"}.`,
+    "Current runtime mode:"
+  ];
+  if (state.planMode === "planning") {
+    lines.push(
+      "- Plan mode: active (workspace read-only; plan_scratch permits session-local temporary drafts; submit the finished plan by calling plan_submit with the ordered steps for user approval)."
+    );
+    if (state.planDisabledToolNames.length > 0) {
+      lines.push(
+        `- Disabled this turn by plan mode (calls are denied): ${state.planDisabledToolNames.join(", ")}. Do not call them while planning.`
+      );
+    }
+  } else {
+    lines.push("- Plan mode: off.");
+  }
+  lines.push(
     `- YOLO mode: ${state.yoloMode ? "on (filesystem sandbox directory restrictions are disabled)" : "off (workspace/protected-path restrictions apply)"}.`,
     `- Filesystem scope: ${state.filesystemScope === "all" ? "all local paths may be passed directly to file tools when permitted" : "workspace paths and configured safe roots only"}.`
-  ];
+  );
   if (state.pendingTransition) {
     const transitionText = {
       entered_yolo: "YOLO mode was just enabled for this turn.",
       exited_yolo: "YOLO mode was just disabled; do not assume previous absolute-path access still applies.",
-      entered_plan: "Plan mode was just enabled; analyze and plan without changing the workspace. Use plan_scratch for temporary drafts.",
+      entered_plan: "Plan mode was just enabled; analyze and plan without changing the workspace. Use plan_scratch for temporary drafts, then submit the finished plan by calling plan_submit with the ordered steps for user approval.",
       exited_plan: "Plan mode was just disabled; execution tools may be used when the task requires them."
     };
     lines.push(`- Transition: ${transitionText[state.pendingTransition]}`);
@@ -80653,46 +80807,108 @@ function buildRuntimeModeContext(state) {
   lines.push(RUNTIME_MODE_CONTEXT_END_MARKER);
   return lines.join("\n");
 }
-function findLatestUserIndex(messages) {
-  for (let index = messages.length - 1; index >= 0; index--) {
-    const message = messages[index];
-    if (isRecord3(message) && message.role === "user") {
-      return index;
-    }
-  }
-  return -1;
+function runtimeModeBlockKey(state) {
+  return JSON.stringify({
+    planMode: state.planMode,
+    yoloMode: state.yoloMode,
+    filesystemScope: state.filesystemScope,
+    currentDate: state.currentDate ?? null,
+    activeToolNames: state.activeToolNames,
+    planDisabledToolNames: state.planDisabledToolNames
+  });
 }
-function injectRuntimeModeContext(messages, state) {
-  const contextMessage = {
-    role: "user",
-    content: buildRuntimeModeContext(state),
-    timestamp: Date.now()
-  };
-  const latestUserIndex = findLatestUserIndex(messages);
-  if (latestUserIndex < 0) {
-    return [...messages, contextMessage];
-  }
-  return [
-    ...messages.slice(0, latestUserIndex),
-    contextMessage,
-    ...messages.slice(latestUserIndex)
-  ];
+function shouldInjectRuntimeModeBlock(lastKey, state) {
+  if (lastKey === null) return true;
+  return runtimeModeBlockKey(state) !== lastKey;
 }
-function createRuntimeModeTransformContext(options) {
-  return async (messages) => {
-    const stripped = stripRuntimeModeContext(messages);
-    if (stripped.stripped > 0) {
-      options.onStripped?.(stripped.stripped);
-    }
-    const state = options.getState();
-    const nextMessages = injectRuntimeModeContext(stripped.messages, state);
-    options.onInjected?.(state);
-    if (state.pendingTransition) {
-      options.consumeTransition?.();
-    }
-    return nextMessages;
+function runtimeModeTraceData(state) {
+  return {
+    yoloMode: state.yoloMode,
+    planMode: state.planMode,
+    filesystemScope: state.filesystemScope,
+    pendingTransition: state.pendingTransition,
+    currentDate: state.currentDate,
+    timeZone: state.timeZone,
+    activeToolCount: state.activeToolNames.length,
+    planDisabledToolCount: state.planDisabledToolNames.length
   };
 }
+function currentDateInZone(timeZone) {
+  const parts = new Intl.DateTimeFormat("en-US", {
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    timeZone
+  }).formatToParts(/* @__PURE__ */ new Date());
+  const part = (type) => parts.find((p) => p.type === type)?.value ?? "00";
+  return `${part("year")}-${part("month")}-${part("day")}`;
+}
+var RUNTIME_MODE_BLOCK_PATTERN = /^[\t ]*<runtime-mode-context>[\s\S]*?<\/runtime-mode-context>[\t ]*(?:\r?\n){0,2}/;
+function refreshRuntimeModeBlockOnLastUserMessage(messages, block) {
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const message = messages[i];
+    if (message?.role !== "user") continue;
+    const content = typeof message.content === "string" ? message.content : "";
+    const stripped = content.replace(RUNTIME_MODE_BLOCK_PATTERN, "");
+    const refreshed = stripped === content && content.includes("<runtime-mode-context>") ? content : `${block}
+
+${stripped}`;
+    if (refreshed === content) return messages;
+    const next = [...messages];
+    next[i] = { ...message, content: refreshed };
+    return next;
+  }
+  return messages;
+}
+var RuntimeModeBlockInjector = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  lastKey = null;
+  pendingRetryRefresh = false;
+  reset() {
+    this.lastKey = null;
+    this.pendingRetryRefresh = true;
+  }
+  /** Block to prepend to the next user message, or null when unchanged. */
+  nextBlock() {
+    const block = this.freshBlock();
+    this.pendingRetryRefresh = false;
+    return block;
+  }
+  /**
+   * Latest block for a request that reuses existing history (overflow retry
+   * after compaction, manual compaction continue): the last user message may
+   * carry a stale or evicted block, so the request-level transform refreshes
+   * it. Consumed once per reset; null when nothing is pending.
+   */
+  consumeRetryRefreshBlock() {
+    if (!this.pendingRetryRefresh) return null;
+    this.pendingRetryRefresh = false;
+    const state = this.options.getState();
+    return buildRuntimeModeContext(state);
+  }
+  freshBlock() {
+    const state = this.options.getState();
+    if (!shouldInjectRuntimeModeBlock(this.lastKey, state)) return null;
+    this.lastKey = runtimeModeBlockKey(state);
+    if (state.pendingTransition) this.options.consumeTransition();
+    this.options.noteTrace(state);
+    return buildRuntimeModeContext(state);
+  }
+};
+
+// src/runtime/cache-retention.ts
+function createCacheRetentionStreamFn(configured) {
+  const base = configured ?? ((model, context, options) => streamSimple(model, context, options));
+  return (model, context, options) => base(model, context, {
+    ...options,
+    // Default only: explicit none/short requests (tests, debug commands) win.
+    // Note: cost estimates still price cache writes at the short-TTL rate.
+    cacheRetention: model.api === "anthropic-messages" && options?.cacheRetention === void 0 ? "long" : options?.cacheRetention
+  });
+}
 
 // src/runtime/guard-advisory-context.ts
 var GUARD_ADVISORY_MARKER = "<runtime-guard-advisory>";
@@ -80706,12 +80922,19 @@ function isMarkerOnlyUserMessage(message) {
 function stripGuardAdvisories(messages) {
   return messages.filter((message) => !isMarkerOnlyUserMessage(message));
 }
-function findLatestUserIndex2(messages) {
+function findLatestUserIndex(messages) {
   for (let index = messages.length - 1; index >= 0; index -= 1) {
     if (messages[index].role === "user") return index;
   }
   return -1;
 }
+function applyRuntimeRequestTransform(messages, options) {
+  const advisory = options.takeAdvisory();
+  let next = advisory ? injectGuardAdvisory(messages, advisory) : stripGuardAdvisories(messages);
+  const retryBlock = options.takeRetryBlock();
+  if (retryBlock) next = refreshRuntimeModeBlockOnLastUserMessage(next, retryBlock);
+  return next;
+}
 function injectGuardAdvisory(messages, guidance) {
   const advisoryMessage = {
     role: "user",
@@ -80720,7 +80943,7 @@ ${guidance}
 ${GUARD_ADVISORY_END_MARKER}`,
     timestamp: Date.now()
   };
-  const latestUserIndex = findLatestUserIndex2(messages);
+  const latestUserIndex = findLatestUserIndex(messages);
   if (latestUserIndex < 0) {
     return [...messages, advisoryMessage];
   }
@@ -80731,11 +80954,6 @@ ${GUARD_ADVISORY_END_MARKER}`,
   ];
 }
 
-// src/runtime/tool-policy.ts
-function selectToolsForRuntimeMode(tools, mode) {
-  return selectToolsForRuntimePolicy(tools, mode);
-}
-
 // src/runtime/terminal-bell.ts
 var BEL = "\x07";
 var DEFAULT_MIN_INTERVAL_MS = 500;
@@ -80933,7 +81151,7 @@ function createInteractiveExtensionUIContext(host) {
     }
   };
   return {
-    notify: (message, type = "info") => showExtensionNotification(host, message, type),
+    notify: (message, type = "info", opts) => showExtensionNotification(host, message, type, opts),
     select: (title, options, opts) => interact(() => showExtensionSelector2(host, title, options, opts)),
     confirm: async (title, message, opts) => await interact(() => showExtensionConfirm(host, title, message, opts)) === true,
     input: (title, placeholder, opts) => interact(() => showExtensionInput(host, title, placeholder, opts)),
@@ -81081,10 +81299,14 @@ function installInteractiveInteractionHandler(host) {
     }
   });
 }
-function showExtensionNotification(host, message, type = "info") {
+function showExtensionNotification(host, message, type = "info", opts) {
   const prefix = type === "error" ? "Error: " : type === "warning" ? "Warning: " : "";
   host.chatContainer.addChild(new Spacer(1));
-  host.chatContainer.addChild(new Text(theme.fg(type === "error" ? "error" : type === "warning" ? "warning" : "dim", `${prefix}${message}`), 1, 0));
+  if (opts?.markdown) {
+    host.chatContainer.addChild(new Markdown(`${prefix}${message}`, 1, 0, getMarkdownTheme()));
+  } else {
+    host.chatContainer.addChild(new Text(theme.fg(type === "error" ? "error" : type === "warning" ? "warning" : "dim", `${prefix}${message}`), 1, 0));
+  }
   host.ui.requestRender();
 }
 function showExtensionSelector2(host, title, options, opts) {
@@ -81455,7 +81677,10 @@ async function loadInteractiveExtensions(host) {
         console.error(`[Extension] Tools set to: ${toolNames.join(", ")}`);
       }
     },
-    getActiveTools: () => host.agent.state.tools.map((t) => t.name),
+    getActiveTools: () => {
+      const tools = host.agent.state.tools;
+      return (host.planModeEnabled ? tools.filter((tool) => isToolAllowedInPlanMode(tool)) : tools).map((tool) => tool.name);
+    },
     sendUserMessage: (content) => {
       if (host.editor.onSubmit) {
         void host.editor.onSubmit(content);
@@ -81545,7 +81770,8 @@ async function loadInteractiveExtensions(host) {
     reload: () => host.reloadRuntime(),
     get yoloMode() {
       return host.yoloMode;
-    }
+    },
+    setYoloMode: host.setYoloMode ? (enabled) => host.setYoloMode?.(enabled) : void 0
   };
   const contextActions = {
     isIdle: () => !host.isProcessing,
@@ -81576,7 +81802,15 @@ async function loadInteractiveExtensions(host) {
       console.error(`[Extension] Failed to load ${path34}: ${error}`);
     }
   }
-  const extensionTools = filterEnabledTools(convertExtensionTools(extensions), host.options.settingsManager);
+  const policyContext = () => ({
+    mode: host.planModeEnabled ? "plan" : "normal",
+    yoloMode: host.yoloMode,
+    confirmationPolicy: "allow"
+  });
+  const extensionTools = filterEnabledTools(
+    createPolicyEnforcedTools(convertExtensionTools(extensions), { getContext: policyContext }),
+    host.options.settingsManager
+  );
   const activeTools = [...host.agent.state.tools, ...extensionTools];
   host.agent.state.tools = wrapToolsWithExtensions(activeTools, host.extensionRunner);
   const availableTools = [
@@ -81653,6 +81887,12 @@ var InteractiveMode = class {
   pendingYoloModeTransition = null;
   executionReminder = null;
   pendingRuntimeGuardAdvisory = null;
+  /** Freezes runtime mode blocks into user messages (cache-stable history). */
+  runtimeModeBlocks = new RuntimeModeBlockInjector({
+    getState: () => this.getRuntimeModeState(),
+    consumeTransition: () => this.consumeRuntimeModeTransition(),
+    noteTrace: (state) => this.sessionTrace.noteRuntimeEvent("runtime_context_injected", runtimeModeTraceData(state))
+  });
   fileManager;
   mentionHandler;
   mentionPickerComponent;
@@ -81815,6 +82055,11 @@ var InteractiveMode = class {
   get controllerSetupHost() {
     return this;
   }
+  getPolicyContext = () => ({
+    mode: this.planModeEnabled ? "plan" : "normal",
+    yoloMode: this.yoloMode,
+    confirmationPolicy: "allow"
+  });
   rebuildSkillAwareTools(sourceTools) {
     const preservedTools = sourceTools.filter(
       (tool) => !CLI_FILESYSTEM_TOOL_NAMES.includes(tool.name) && tool.name !== "bash"
@@ -81840,19 +82085,14 @@ var InteractiveMode = class {
     });
     const normalFsTools = createCliFileSystemTools(this.options.cwd, fileSystemToolOptions([this.options.configDir]));
     const currentFsTools = this.yoloMode ? createCliFileSystemTools(this.options.cwd, fileSystemToolOptions(["/"])) : normalFsTools;
-    const getPolicyContext = () => ({
-      mode: this.planModeEnabled ? "plan" : "normal",
-      yoloMode: this.yoloMode,
-      confirmationPolicy: "allow"
-    });
     return {
       currentTools: createPolicyEnforcedTools(
         [...currentFsTools, bashTool, ...preservedTools],
-        { getContext: getPolicyContext }
+        { getContext: this.getPolicyContext }
       ),
       originalTools: createPolicyEnforcedTools(
         [...normalFsTools, bashTool, ...preservedTools],
-        { getContext: getPolicyContext }
+        { getContext: this.getPolicyContext }
       )
     };
   }
@@ -81860,26 +82100,27 @@ var InteractiveMode = class {
     this.options.fileObservationState.clear();
   }
   getRuntimeModeState() {
-    const pendingTransition = this.getPendingRuntimeModeTransition();
     const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone || "local";
-    const dateParts = new Intl.DateTimeFormat("en-US", {
-      year: "numeric",
-      month: "2-digit",
-      day: "2-digit",
-      timeZone
-    }).formatToParts(/* @__PURE__ */ new Date());
-    const datePart = (type) => dateParts.find((part) => part.type === type)?.value ?? "00";
-    const currentDate = `${datePart("year")}-${datePart("month")}-${datePart("day")}`;
+    const activeTools = this.agent?.state?.tools ?? [];
     return {
       yoloMode: this.yoloMode,
       planMode: this.planModeEnabled ? "planning" : "off",
       filesystemScope: this.yoloMode ? "all" : "workspace",
-      ...pendingTransition ? { pendingTransition } : {},
-      currentDate,
+      ...this.getPendingRuntimeModeTransition() ? { pendingTransition: this.getPendingRuntimeModeTransition() } : {},
+      currentDate: currentDateInZone(timeZone),
       timeZone,
-      activeToolNames: this.agent?.state?.tools?.map((tool) => tool.name) ?? []
+      activeToolNames: activeTools.map((tool) => tool.name),
+      planDisabledToolNames: this.planModeEnabled ? activeTools.filter((tool) => !isToolAllowedInPlanMode(tool)).map((tool) => tool.name) : []
     };
   }
+  /** Public reset for compaction flows (compaction may drop the latest block). */
+  resetRuntimeModeBlocks() {
+    this.runtimeModeBlocks.reset();
+  }
+  /** Runtime mode block for the next user message; frozen into it (append-only history, cache-stable prefixes). */
+  runtimeModeBlockForNextMessage() {
+    return this.runtimeModeBlocks.nextBlock();
+  }
   getPendingRuntimeModeTransition() {
     if (this.pendingYoloModeTransition === "enter") return "entered_yolo";
     if (this.pendingYoloModeTransition === "exit") return "exited_yolo";
@@ -81898,10 +82139,7 @@ var InteractiveMode = class {
     const currentTools = this.extensionRunner ? wrapToolsWithExtensions(rebuilt.currentTools, this.extensionRunner) : rebuilt.currentTools;
     const originalTools = this.extensionRunner ? wrapToolsWithExtensions(rebuilt.originalTools, this.extensionRunner) : rebuilt.originalTools;
     const activeTools = filterEnabledTools(
-      selectToolsForRuntimeMode(
-        currentTools,
-        this.planModeEnabled ? "plan" : "normal"
-      ),
+      currentTools,
       this.options.settingsManager
     );
     this.agent.setTools(activeTools);
@@ -81934,7 +82172,8 @@ var InteractiveMode = class {
     this.safeRequestRender();
   }
   promptAgent(input) {
-    return this.agentSessionController.prompt(input, { source: "interactive" });
+    const prompt = prependRuntimeModeBlockToPrompt(input, this.runtimeModeBlockForNextMessage());
+    return this.agentSessionController.prompt(prompt, { source: "interactive" });
   }
   continueAgent() {
     return this.agentSessionController.continue();
@@ -81964,6 +82203,7 @@ var InteractiveMode = class {
       this.persistExecutionState();
     }
     this.executionReminder = this.executionState.getReminder();
+    this.resetRuntimeModeBlocks();
     await this.refreshTodoWidget();
     await this.emitExtensionEvent({
       type: "session:changed",
@@ -81974,7 +82214,7 @@ var InteractiveMode = class {
   async init() {
     const activeSession = this.sessionManager.getActiveSession();
     this.thinkingLevel = resolveInitialThinkingLevel({ session: activeSession, settingsManager: this.options.settingsManager });
-    const { Agent } = await import("./chunks/src-OWQI5M6W.js");
+    const { Agent } = await import("./chunks/src-E7NCXMU5.js");
     this.agent = new Agent({
       initialState: {
         systemPrompt: this.buildSystemPrompt(),
@@ -81984,28 +82224,15 @@ var InteractiveMode = class {
       },
       apiKey: this.options.apiKey,
       sessionId: activeSession?.id,
-      streamFn: this.options.streamFn,
-      transformContext: async (messages) => {
-        const runtimeModeTransform = createRuntimeModeTransformContext({
-          getState: () => this.getRuntimeModeState(),
-          consumeTransition: () => this.consumeRuntimeModeTransition(),
-          onInjected: (state) => this.sessionTrace.noteRuntimeEvent("runtime_context_injected", {
-            yoloMode: state.yoloMode,
-            planMode: state.planMode,
-            filesystemScope: state.filesystemScope,
-            pendingTransition: state.pendingTransition,
-            currentDate: state.currentDate,
-            timeZone: state.timeZone,
-            activeToolCount: state.activeToolNames.length
-          }),
-          onStripped: (count) => this.sessionTrace.noteRuntimeEvent("stale_runtime_context_stripped", { count })
-        });
-        let transformed = await runtimeModeTransform(messages);
-        const advisory = this.pendingRuntimeGuardAdvisory;
-        this.pendingRuntimeGuardAdvisory = null;
-        transformed = advisory ? injectGuardAdvisory(transformed, advisory) : stripGuardAdvisories(transformed);
-        return transformed;
-      }
+      streamFn: createCacheRetentionStreamFn(this.options.streamFn),
+      transformContext: async (messages) => applyRuntimeRequestTransform(messages, {
+        takeAdvisory: () => {
+          const advisory = this.pendingRuntimeGuardAdvisory;
+          this.pendingRuntimeGuardAdvisory = null;
+          return advisory;
+        },
+        takeRetryBlock: () => this.runtimeModeBlocks.consumeRetryRefreshBlock()
+      })
     });
     this.agentSessionController = createInteractiveAgentSessionController(this.controllerSetupHost);
     this.updateTerminalTitle();
@@ -82189,6 +82416,9 @@ var InteractiveMode = class {
   async handleYoloCommand(args) {
     return handleYoloCommand(this, args);
   }
+  setYoloMode(enabled) {
+    void this.handleYoloCommand(enabled ? "on" : "off");
+  }
   /**
    * Toggle calm mode and rebuild the chat so already-rendered rows follow
    * the new mode. Delivery, tool execution, and session storage are
@@ -82560,6 +82790,7 @@ async function composeCliRuntime(params) {
     getPolicyContext: () => ({ mode: "normal", confirmationPolicy: "allow" })
   };
   const rawTools = [
+    createSearchContextTool(() => sessionManager),
     ...createCliFileSystemTools(cwd, fileSystemToolOptions),
     ...cliHostCapabilities.tools
   ];
@@ -82805,7 +83036,7 @@ async function runPrintMode(params) {
 `);
     console.log("Assistant: ");
   }
-  const { Agent: AgentClass } = await import("./chunks/src-OWQI5M6W.js");
+  const { Agent: AgentClass } = await import("./chunks/src-E7NCXMU5.js");
   let agent;
   const printModeExtensions = await loadPrintModeExtensions({
     cwd: runtime.cwd,
@@ -83045,7 +83276,7 @@ function toJsonValue(value, depth = 0, cap = MAX_EVENT_STRING_LENGTH) {
   }
   return result;
 }
-function isRecord4(value) {
+function isRecord3(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
 function truncateForEvent(text, cap) {
@@ -83071,7 +83302,7 @@ function parseInput(line) {
   } catch {
     return null;
   }
-  if (!isRecord4(parsed) || typeof parsed.type !== "string") return null;
+  if (!isRecord3(parsed) || typeof parsed.type !== "string") return null;
   if (parsed.type === "shutdown") {
     return { type: "shutdown", reason: typeof parsed.reason === "string" ? parsed.reason : void 0 };
   }
@@ -83122,7 +83353,7 @@ function parseInput(line) {
       prompt: parsed.prompt,
       streamingBehavior,
       cwd: typeof parsed.cwd === "string" ? parsed.cwd : void 0,
-      metadata: isRecord4(parsed.metadata) ? parsed.metadata : void 0
+      metadata: isRecord3(parsed.metadata) ? parsed.metadata : void 0
     };
   }
   return null;
@@ -83162,15 +83393,15 @@ function readProgressText(value) {
 function extractJsonEventsToolProgressText(partialResult) {
   const plainText = readProgressText(partialResult).trim();
   if (plainText) return plainText;
-  if (!isRecord4(partialResult)) return "";
+  if (!isRecord3(partialResult)) return "";
   const content = partialResult.content;
   if (Array.isArray(content)) {
-    return content.map((block) => isRecord4(block) && block.type === "text" ? readProgressText(block.text) : "").filter(Boolean).join("\n").trim();
+    return content.map((block) => isRecord3(block) && block.type === "text" ? readProgressText(block.text) : "").filter(Boolean).join("\n").trim();
   }
   const directText = readProgressText(partialResult.text) || readProgressText(partialResult.message);
   if (directText) return directText.trim();
   const details = partialResult.details;
-  if (isRecord4(details)) {
+  if (isRecord3(details)) {
     return (readProgressText(details.text) || readProgressText(details.message)).trim();
   }
   return "";
@@ -83666,7 +83897,7 @@ async function runJsonEventsMode(params) {
         return;
       }
       const parent = agent;
-      const { Agent: AgentClass } = await import("./chunks/src-OWQI5M6W.js");
+      const { Agent: AgentClass } = await import("./chunks/src-E7NCXMU5.js");
       const sideAgent = new AgentClass({
         initialState: {
           systemPrompt: parent.state.systemPrompt,
@@ -84010,7 +84241,7 @@ async function runJsonEventsMode(params) {
     if (runtime.initialModel.unconfigured || controller) {
       return;
     }
-    const { Agent: AgentClass } = await import("./chunks/src-OWQI5M6W.js");
+    const { Agent: AgentClass } = await import("./chunks/src-E7NCXMU5.js");
     const jsonModeExtensions = await loadJsonModeExtensions({ runtime, getAgent: () => agent });
     extensionRunner = jsonModeExtensions.runner;
     const tools = [...runtime.tools, ...jsonModeExtensions.extensionTools];
@@ -84604,7 +84835,7 @@ async function runWithJsonEventsConsoleIsolation(fn) {
 }
 async function createCliTestStreamFnFromEnv() {
   if (!process.env.PIE_TEST_MOCK_STREAM_SEQUENCE) return void 0;
-  return (await import("./chunks/test-stream-Y7WXELAJ.js")).createTestStreamFnFromSequenceEnv();
+  return (await import("./chunks/test-stream-BWBJTFNI.js")).createTestStreamFnFromSequenceEnv();
 }
 function resolveJsonEventsDetailFlag() {
   for (let index = 0; index < process.argv.length; index += 1) {