pi-openai-toolkit 0.23.1 → 0.24.0

package/src/compaction-projection.ts

@@ -1,35 +1,35 @@
-import type {
-	NativeCompactionDetails,
-	NativeCompactionInputProvenance,
-} from "./types";
-
-/** The configured Pi context-hook projector is unavailable or failed. */
-export const COMPACTION_PROJECTION_UNAVAILABLE = "no-supported-projection-seam" as const;
-/** The current session context could not be read before projection. */
-export const COMPACTION_SESSION_CONTEXT_UNAVAILABLE = "session-context-unavailable" as const;
-/** A projected recursive context did not contain the current compaction summary. */
-export const COMPACTION_PROJECTED_CONTEXT_UNAVAILABLE = "projected-compaction-context-unavailable" as const;
-/** The latest opaque checkpoint was created with no or a different input marker. */
-export const COMPACTION_CHECKPOINT_PROVENANCE_UNAVAILABLE = "unverified-compaction-checkpoint" as const;
-
-/** Persisted edits changed input already sealed inside an opaque checkpoint. */
-export const COMPACTION_CHECKPOINT_CONTEXT_EDITED = "checkpoint-context-edited" as const;
-
-export type UnprojectedCompactionReason =
-	| typeof COMPACTION_CHECKPOINT_CONTEXT_EDITED
-	| typeof COMPACTION_PROJECTION_UNAVAILABLE
-	| typeof COMPACTION_SESSION_CONTEXT_UNAVAILABLE
-	| typeof COMPACTION_CHECKPOINT_PROVENANCE_UNAVAILABLE
-	| typeof COMPACTION_PROJECTED_CONTEXT_UNAVAILABLE;
-
-/**
- * A Remote V2 checkpoint is safe for the current replay chain only when its
- * marker matches the configured input source. Structural persistence validation
- * intentionally remains more permissive for old session files.
- */
-export function hasVerifiedCompactionInputProvenance(
-	details: Pick<NativeCompactionDetails, "inputProvenance"> | undefined,
-	expected: NativeCompactionInputProvenance,
-): boolean {
-	return details?.inputProvenance === expected;
-}
+import type {
+	NativeCompactionDetails,
+	NativeCompactionInputProvenance,
+} from "./types";
+
+/** The configured Pi context-hook projector is unavailable or failed. */
+export const COMPACTION_PROJECTION_UNAVAILABLE = "no-supported-projection-seam" as const;
+/** The current session context could not be read before projection. */
+export const COMPACTION_SESSION_CONTEXT_UNAVAILABLE = "session-context-unavailable" as const;
+/** A projected recursive context did not contain the current compaction summary. */
+export const COMPACTION_PROJECTED_CONTEXT_UNAVAILABLE = "projected-compaction-context-unavailable" as const;
+/** The latest opaque checkpoint was created with no or a different input marker. */
+export const COMPACTION_CHECKPOINT_PROVENANCE_UNAVAILABLE = "unverified-compaction-checkpoint" as const;
+
+/** Persisted edits changed input already sealed inside an opaque checkpoint. */
+export const COMPACTION_CHECKPOINT_CONTEXT_EDITED = "checkpoint-context-edited" as const;
+
+export type UnprojectedCompactionReason =
+	| typeof COMPACTION_CHECKPOINT_CONTEXT_EDITED
+	| typeof COMPACTION_PROJECTION_UNAVAILABLE
+	| typeof COMPACTION_SESSION_CONTEXT_UNAVAILABLE
+	| typeof COMPACTION_CHECKPOINT_PROVENANCE_UNAVAILABLE
+	| typeof COMPACTION_PROJECTED_CONTEXT_UNAVAILABLE;
+
+/**
+ * A Remote V2 checkpoint is safe for the current replay chain only when its
+ * marker matches the configured input source. Structural persistence validation
+ * intentionally remains more permissive for old session files.
+ */
+export function hasVerifiedCompactionInputProvenance(
+	details: Pick<NativeCompactionDetails, "inputProvenance"> | undefined,
+	expected: NativeCompactionInputProvenance,
+): boolean {
+	return details?.inputProvenance === expected;
+}

package/src/config/legacy.ts

@@ -12,8 +12,6 @@ import {
 	THINKING_LEVELS,
 	TOOLKIT_ID,
 	type CompactionConfig,
-	type ContextManagementMode,
-	type LeaveManagedModePolicy,
 	type ImageGenerationConfig,
 	type RemoteV2ContextSource,
 	type LoadedToolkitConfig,
@@ -22,7 +20,7 @@ import {
 	type WebSearchConfig,
 	type WebSearchRoute,
 } from "../types";
-import { RETIRED_AUTO_MODE_MESSAGE } from "./policy";
+import { RETIRED_AUTO_MODE_MESSAGE, RETIRED_REMOTE_WINDOWS_CONFIG_MESSAGE, RETIRED_REMOTE_WINDOWS_MODE_MESSAGE } from "./policy";
 import { MAX_IMAGE_MODEL_ID_CHARS } from "../image-generation/types";
 
 export const CONFIG_DIR = path.join(os.homedir(), ".pi", "agent", "extensions", TOOLKIT_ID);
@@ -85,34 +83,6 @@ function toBoolean(value: unknown, fieldPath: string, warnings: string[]): boole
 	return undefined;
 }
 
-function toLeaveManagedMode(
-	value: unknown,
-	fieldPath: string,
-	warnings: string[],
-): LeaveManagedModePolicy | undefined {
-	if (value === undefined) return undefined;
-	if (typeof value === "string") {
-		const normalized = value.trim();
-		if (normalized === "warn" || normalized === "compact") return normalized;
-	}
-	warnings.push(`Ignoring ${fieldPath}: expected one of warn, compact.`);
-	return undefined;
-}
-
-function toContextManagementMode(
-	value: unknown,
-	fieldPath: string,
-	warnings: string[],
-): ContextManagementMode | undefined {
-	if (value === undefined) return undefined;
-	if (typeof value === "string") {
-		const normalized = value.trim();
-		if (normalized === "off" || normalized === "remote") return normalized;
-	}
-	warnings.push(`Ignoring ${fieldPath}: expected one of off, remote.`);
-	return undefined;
-}
-
 function toRemoteV2ContextSource(
 	value: unknown,
 	fieldPath: string,
@@ -146,21 +116,6 @@ function toThinkingLevel(value: unknown, fieldPath: string, warnings: string[]):
 	return undefined;
 }
 
-function toBoundedInteger(
-	value: unknown,
-	fieldPath: string,
-	warnings: string[],
-	min: number,
-	max: number,
-): number | undefined {
-	if (value === undefined) return undefined;
-	if (typeof value === "number" && Number.isInteger(value) && Number.isFinite(value) && value >= min && value <= max) {
-		return value;
-	}
-	warnings.push(`Ignoring ${fieldPath}: expected an integer between ${min} and ${max}.`);
-	return undefined;
-}
-
 function toSupportedApis(
 	value: unknown,
 	fieldPath: string,
@@ -309,12 +264,17 @@ function applyCompactionConfig(
 	warnUnknownFields(raw, COMPACTION_FIELDS, "compaction", warnings);
 
 	resolved.enabled = toBoolean(raw.enabled, "compaction.enabled", warnings) ?? resolved.enabled;
-	resolved.contextManagement =
-		toContextManagementMode(raw.contextManagement, "compaction.contextManagement", warnings) ??
-		resolved.contextManagement;
-	resolved.leaveManagedMode =
-		toLeaveManagedMode(raw.leaveManagedMode, "compaction.leaveManagedMode", warnings) ??
-		resolved.leaveManagedMode;
+	for (const key of ["leaveManagedMode", "contextReminderThresholdPercent"]) {
+		if (Object.hasOwn(raw, key)) warnings.push(`Ignoring compaction.${key}: ${RETIRED_REMOTE_WINDOWS_CONFIG_MESSAGE}`);
+	}
+	if (Object.hasOwn(raw, "contextManagement")) {
+		const mode = typeof raw.contextManagement === "string" ? raw.contextManagement.trim() : undefined;
+		warnings.push(mode === "remote"
+			? `Ignoring compaction.contextManagement: ${RETIRED_REMOTE_WINDOWS_MODE_MESSAGE}`
+			: mode === "off"
+				? `Ignoring compaction.contextManagement: ${RETIRED_REMOTE_WINDOWS_CONFIG_MESSAGE}`
+				: "Ignoring compaction.contextManagement: expected off; remote has been removed.");
+	}
 	resolved.allowCompactionContinuityBreak =
 		toBoolean(
 			raw.allowCompactionContinuityBreak,
@@ -323,16 +283,6 @@ function applyCompactionConfig(
 		) ?? resolved.allowCompactionContinuityBreak;
 	resolved.notifyOnLoad =
 		toBoolean(raw.notifyOnLoad, "compaction.notifyOnLoad", warnings) ?? resolved.notifyOnLoad;
-	const reminderPercent = toBoundedInteger(
-		raw.contextReminderThresholdPercent,
-		"compaction.contextReminderThresholdPercent",
-		warnings,
-		0,
-		100,
-	);
-	if (reminderPercent !== undefined) {
-		resolved.contextReminderThresholdPercent = reminderPercent;
-	}
 	resolved.debug = toBoolean(raw.debug, "compaction.debug", warnings) ?? resolved.debug;
 	resolved.logProviderPayloads =
 		toBoolean(raw.logProviderPayloads, "compaction.logProviderPayloads", warnings) ??

package/src/config/migration.ts

@@ -1,103 +1,115 @@
-import { resolveToolkitConfig } from "../config";
-import type { LoadedToolkitConfig } from "../types";
-import { RETIRED_AUTO_MODE_ISSUE, RETIRED_AUTO_MODE_MESSAGE, type ConfigOrigin } from "./policy";
-import { resolveV2Config } from "./v2";
-
-export type MigrationPreview = {
-	status: "ready" | "needs-review" | "already-v2" | "unavailable";
-	candidate?: Record<string, unknown>;
-	/** Controlled explanations, never arbitrary raw input values. */
-	reasons: string[];
-	/** Unknown names are masked; paths never expose unknown values. */
-	unmappedPaths: string[];
-	/** Candidate leaf -> origin in the unchanged legacy source (or built-in). */
-	origins?: Record<string, ConfigOrigin>;
-};
-
-function modelRef(key: string): { provider: string; id: string; api: string } {
-	const slash = key.indexOf("/");
-	return { provider: key.slice(0, slash), id: key.slice(slash + 1), api: "openai-responses" };
-}
-
-/** Read-only analysis: never edits a source file or claims a lossy candidate is equivalent. */
-export function previewToolkitMigration(loaded: LoadedToolkitConfig): MigrationPreview {
-	if (loaded.document?.format === "v2") {
-		const retired = resolveToolkitConfig(loaded).issues.filter((issue) => issue.code === RETIRED_AUTO_MODE_ISSUE);
-		return { status: "already-v2", reasons: ["The document already uses schemaVersion 2.",
-			...(retired.length ? [RETIRED_AUTO_MODE_MESSAGE] : [])], unmappedPaths: retired.map((issue) => issue.path) };
-	}
-	if (loaded.document?.format === "invalid" || loaded.document?.format === "missing") {
-		return { status: "unavailable", reasons: ["A readable legacy document is required; no candidate was produced."], unmappedPaths: [] };
-	}
-	const baseline = resolveToolkitConfig(loaded);
-	const legacy = baseline.config;
-	const { compatibility: _compatibility, diagnostics, ...defaults } = structuredClone(baseline.policy);
-	const models: Record<string, unknown> = Object.create(null);
-	const origins: Record<string, ConfigOrigin> = Object.create(null);
-	const unmappedPaths = new Set(baseline.issues.map((issue) => issue.path));
-	for (const [leaf, origin] of Object.entries(baseline.origins)) {
-		if (leaf.startsWith("compatibility.")) continue;
-		origins[leaf.startsWith("diagnostics.") ? leaf : `defaults.${leaf}`] = origin;
-	}
-	const keys = new Set([
-		...legacy.webSearch.models,
-		...Object.keys(legacy.webSearch.routes ?? {}),
-		...legacy.compaction.gatewayContextModels,
-	]);
-	for (const key of keys) {
-		const resolved = resolveToolkitConfig(loaded, modelRef(key));
-		const override: Record<string, unknown> = {};
-		if (resolved.policy.webSearch.route !== defaults.webSearch.route) override.webSearch = resolved.policy.webSearch;
-		if (resolved.policy.compatibility.transport !== "standard") override.compatibility = resolved.policy.compatibility;
-		if (Object.keys(override).length > 0) {
-			models[key] = override;
-			for (const [feature, fields] of Object.entries(override)) {
-				for (const field of Object.keys(fields as Record<string, unknown>)) {
-					const leaf = `${feature}.${field}`;
-					origins[`models[${JSON.stringify(key)}].${leaf}`] = resolved.origins[leaf];
-				}
-			}
-		}
-	}
-	const candidate = { schemaVersion: 2, defaults, models, diagnostics };
-	const reasons: string[] = [];
-	// Retired sections are never migrated; their presence is a controlled removal reason.
-	if (baseline.issues.some((issue) => issue.code === RETIRED_AUTO_MODE_ISSUE)) {
-		reasons.push(RETIRED_AUTO_MODE_MESSAGE + " No Auto Mode settings were migrated; review the removal before applying this candidate.");
-		unmappedPaths.add("autoMode");
-	}
-	if (loaded.warnings.length || baseline.issues.length) {
-		reasons.push("Legacy warnings, unknown fields or normalized invalid values require review. Their original contents remain in the untouched source file.");
-	}
-	if (legacy.webSearch.enabled && legacy.webSearch.defaultRoute === undefined &&
-		legacy.webSearch.models.some((key) => !Object.prototype.hasOwnProperty.call(legacy.webSearch.routes ?? {}, key))) {
-		reasons.push("Legacy hosted allowlists ignore unsupported APIs and malformed payloads; explicit v2 hosted routes fail closed. This candidate is not behavior-equivalent on those paths.");
-	}
-	if (!legacy.webSearch.enabled && (legacy.webSearch.models.length || Object.keys(legacy.webSearch.routes ?? {}).length || legacy.webSearch.defaultRoute)) {
-		reasons.push("Disabled legacy search contains dormant routes or a model list; simplified v2 policy does not retain that enable-later intent.");
-		if (legacy.webSearch.models.length) unmappedPaths.add("webSearch.models");
-		if (Object.keys(legacy.webSearch.routes ?? {}).length) unmappedPaths.add("webSearch.routes");
-		if (legacy.webSearch.defaultRoute) unmappedPaths.add("webSearch.defaultRoute");
-	}
-	if (legacy.webSearch.models.length && (legacy.webSearch.defaultRoute !== undefined ||
-		legacy.webSearch.models.some((key) => Object.hasOwn(legacy.webSearch.routes ?? {}, key)))) {
-		unmappedPaths.add("webSearch.models");
-	}
-	if (!legacy.compaction.enabled && legacy.compaction.contextManagement === "remote") {
-		reasons.push("Disabled legacy context management retains a dormant remote mode; the candidate selects Pi ownership.");
-		unmappedPaths.add("compaction.contextManagement");
-	}
-	// Gateway affinity was previously context-mode gated for compaction, and not used by image.
-	if (legacy.compaction.gatewayContextModels.length) {
-		reasons.push("Gateway compatibility is now shared across features; review synthetic compaction/image affinity before using this candidate.");
-	}
-	const candidateChecks = [resolveV2Config(candidate, undefined), ...[...keys].map((key) => resolveV2Config(candidate, key))];
-	if (candidateChecks.some((resolved) => resolved.issues.length)) reasons.push("The candidate has v2 validation issues; it cannot be applied as-is.");
-	return {
-		status: reasons.length ? "needs-review" : "ready",
-		candidate,
-		origins,
-		unmappedPaths: [...unmappedPaths],
-		reasons: reasons.length ? reasons : ["Recognized active policies map without a known semantic difference. Preview only; no source file was changed."],
-	};
-}
+import { resolveToolkitConfig } from "../config";
+import type { LoadedToolkitConfig } from "../types";
+import {
+	RETIRED_AUTO_MODE_ISSUE, RETIRED_AUTO_MODE_MESSAGE,
+	RETIRED_REMOTE_WINDOWS_ISSUE, RETIRED_REMOTE_WINDOWS_MODE_ISSUE,
+	RETIRED_REMOTE_WINDOWS_CONFIG_MESSAGE, RETIRED_REMOTE_WINDOWS_MODE_MESSAGE,
+	type ConfigOrigin,
+} from "./policy";
+import { resolveV2Config } from "./v2";
+
+export type MigrationPreview = {
+	status: "ready" | "needs-review" | "already-v2" | "unavailable";
+	candidate?: Record<string, unknown>;
+	/** Controlled explanations, never arbitrary raw input values. */
+	reasons: string[];
+	/** Unknown names are masked; paths never expose unknown values. */
+	unmappedPaths: string[];
+	/** Candidate leaf -> origin in the unchanged legacy source (or built-in). */
+	origins?: Record<string, ConfigOrigin>;
+};
+
+function modelRef(key: string): { provider: string; id: string; api: string } {
+	const slash = key.indexOf("/");
+	return { provider: key.slice(0, slash), id: key.slice(slash + 1), api: "openai-responses" };
+}
+
+/** Read-only analysis: never edits a source file or claims a lossy candidate is equivalent. */
+export function previewToolkitMigration(loaded: LoadedToolkitConfig): MigrationPreview {
+	if (loaded.document?.format === "v2") {
+		const retired = resolveToolkitConfig(loaded).issues.filter((issue) =>
+			[RETIRED_AUTO_MODE_ISSUE, RETIRED_REMOTE_WINDOWS_ISSUE, RETIRED_REMOTE_WINDOWS_MODE_ISSUE].some((code) => code === issue.code));
+		const removedMode = retired.some((issue) => issue.code === RETIRED_REMOTE_WINDOWS_MODE_ISSUE);
+		return { status: removedMode ? "needs-review" : "already-v2", reasons: ["The document already uses schemaVersion 2.",
+			...(retired.some((issue) => issue.code === RETIRED_AUTO_MODE_ISSUE) ? [RETIRED_AUTO_MODE_MESSAGE] : []),
+			...(retired.some((issue) => issue.code === RETIRED_REMOTE_WINDOWS_ISSUE) ? [RETIRED_REMOTE_WINDOWS_CONFIG_MESSAGE] : []),
+			...(removedMode ? [RETIRED_REMOTE_WINDOWS_MODE_MESSAGE] : [])], unmappedPaths: retired.map((issue) => issue.path) };
+	}
+	if (loaded.document?.format === "invalid" || loaded.document?.format === "missing") {
+		return { status: "unavailable", reasons: ["A readable legacy document is required; no candidate was produced."], unmappedPaths: [] };
+	}
+	const baseline = resolveToolkitConfig(loaded);
+	const legacy = baseline.config;
+	const { compatibility: _compatibility, diagnostics, ...defaults } = structuredClone(baseline.policy);
+	const models: Record<string, unknown> = Object.create(null);
+	const origins: Record<string, ConfigOrigin> = Object.create(null);
+	const unmappedPaths = new Set(baseline.issues.map((issue) => issue.path));
+	for (const [leaf, origin] of Object.entries(baseline.origins)) {
+		if (leaf.startsWith("compatibility.")) continue;
+		origins[leaf.startsWith("diagnostics.") ? leaf : `defaults.${leaf}`] = origin;
+	}
+	const keys = new Set([
+		...legacy.webSearch.models,
+		...Object.keys(legacy.webSearch.routes ?? {}),
+		...legacy.compaction.gatewayContextModels,
+	]);
+	for (const key of keys) {
+		const resolved = resolveToolkitConfig(loaded, modelRef(key));
+		const override: Record<string, unknown> = {};
+		if (resolved.policy.webSearch.route !== defaults.webSearch.route) override.webSearch = resolved.policy.webSearch;
+		if (resolved.policy.compatibility.transport !== "standard") override.compatibility = resolved.policy.compatibility;
+		if (Object.keys(override).length > 0) {
+			models[key] = override;
+			for (const [feature, fields] of Object.entries(override)) {
+				for (const field of Object.keys(fields as Record<string, unknown>)) {
+					const leaf = `${feature}.${field}`;
+					origins[`models[${JSON.stringify(key)}].${leaf}`] = resolved.origins[leaf];
+				}
+			}
+		}
+	}
+	const candidate = { schemaVersion: 2, defaults, models, diagnostics };
+	const reasons: string[] = [];
+	// Retired sections are never migrated; their presence is a controlled removal reason.
+	if (baseline.issues.some((issue) => issue.code === RETIRED_AUTO_MODE_ISSUE)) {
+		reasons.push(RETIRED_AUTO_MODE_MESSAGE + " No Auto Mode settings were migrated; review the removal before applying this candidate.");
+		unmappedPaths.add("autoMode");
+	}
+	if (loaded.warnings.length || baseline.issues.length) {
+		reasons.push("Legacy warnings, unknown fields or normalized invalid values require review. Their original contents remain in the untouched source file.");
+	}
+	if (legacy.webSearch.enabled && legacy.webSearch.defaultRoute === undefined &&
+		legacy.webSearch.models.some((key) => !Object.prototype.hasOwnProperty.call(legacy.webSearch.routes ?? {}, key))) {
+		reasons.push("Legacy hosted allowlists ignore unsupported APIs and malformed payloads; explicit v2 hosted routes fail closed. This candidate is not behavior-equivalent on those paths.");
+	}
+	if (!legacy.webSearch.enabled && (legacy.webSearch.models.length || Object.keys(legacy.webSearch.routes ?? {}).length || legacy.webSearch.defaultRoute)) {
+		reasons.push("Disabled legacy search contains dormant routes or a model list; simplified v2 policy does not retain that enable-later intent.");
+		if (legacy.webSearch.models.length) unmappedPaths.add("webSearch.models");
+		if (Object.keys(legacy.webSearch.routes ?? {}).length) unmappedPaths.add("webSearch.routes");
+		if (legacy.webSearch.defaultRoute) unmappedPaths.add("webSearch.defaultRoute");
+	}
+	if (legacy.webSearch.models.length && (legacy.webSearch.defaultRoute !== undefined ||
+		legacy.webSearch.models.some((key) => Object.hasOwn(legacy.webSearch.routes ?? {}, key)))) {
+		unmappedPaths.add("webSearch.models");
+	}
+	if (baseline.issues.some((issue) => issue.code === RETIRED_REMOTE_WINDOWS_MODE_ISSUE)) {
+		reasons.push(`${RETIRED_REMOTE_WINDOWS_MODE_MESSAGE} The preview uses Pi ownership only as a safe review placeholder; it is not behavior-equivalent. Choose a supported mode explicitly before any manual apply.`);
+		unmappedPaths.add("compaction.contextManagement");
+	}
+	if (baseline.issues.some((issue) => issue.code === RETIRED_REMOTE_WINDOWS_ISSUE)) {
+		reasons.push(`${RETIRED_REMOTE_WINDOWS_CONFIG_MESSAGE} No retired ancillary settings were migrated; review their removal.`);
+	}
+	// Gateway affinity is shared across retained compaction and image features.
+	if (legacy.compaction.gatewayContextModels.length) {
+		reasons.push("Gateway compatibility is now shared across features; review synthetic compaction/image affinity before using this candidate.");
+	}
+	const candidateChecks = [resolveV2Config(candidate, undefined), ...[...keys].map((key) => resolveV2Config(candidate, key))];
+	if (candidateChecks.some((resolved) => resolved.issues.length)) reasons.push("The candidate has v2 validation issues; it cannot be applied as-is.");
+	return {
+		status: reasons.length ? "needs-review" : "ready",
+		candidate,
+		origins,
+		unmappedPaths: [...unmappedPaths],
+		reasons: reasons.length ? reasons : ["Recognized active policies map without a known semantic difference. Preview only; no source file was changed."],
+	};
+}

package/src/config/notifications.ts

@@ -1,15 +1,21 @@
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import type { ResolvedToolkitConfig } from "../config";
-import { RETIRED_AUTO_MODE_ISSUE, RETIRED_AUTO_MODE_MESSAGE, type ConfigIssue } from "./policy";
+import {
+	RETIRED_AUTO_MODE_ISSUE, RETIRED_AUTO_MODE_MESSAGE,
+	RETIRED_REMOTE_WINDOWS_ISSUE, RETIRED_REMOTE_WINDOWS_MODE_ISSUE,
+	RETIRED_REMOTE_WINDOWS_CONFIG_MESSAGE, RETIRED_REMOTE_WINDOWS_MODE_MESSAGE,
+	type ConfigIssue,
+} from "./policy";
 import { redactValue } from "../debug";
 
 const lastNotice = new WeakMap<object, string>();
 
 /** Controlled human text for a known code; never built from user-supplied configuration values. */
 function issueExplanation(issue: ConfigIssue): string {
-	return issue.code === RETIRED_AUTO_MODE_ISSUE
-		? RETIRED_AUTO_MODE_MESSAGE
-		: issue.code;
+	if (issue.code === RETIRED_AUTO_MODE_ISSUE) return RETIRED_AUTO_MODE_MESSAGE;
+	if (issue.code === RETIRED_REMOTE_WINDOWS_ISSUE) return RETIRED_REMOTE_WINDOWS_CONFIG_MESSAGE;
+	if (issue.code === RETIRED_REMOTE_WINDOWS_MODE_ISSUE) return RETIRED_REMOTE_WINDOWS_MODE_MESSAGE;
+	return issue.code;
 }
 
 export function formatConfigIssues(issues: readonly ConfigIssue[], limit = 12): string {

package/src/config/policy.ts

@@ -1,7 +1,6 @@
 import {
 	DEFAULT_COMPACTION_CONFIG,
 	DEFAULT_IMAGE_GENERATION_MODEL,
-	type LeaveManagedModePolicy,
 	type NativeFallbackConfig,
 	type RemoteV2ContextSource,
 } from "../types";
@@ -18,7 +17,7 @@ export type DiagnosticsConfig = {
 	artifactRoot: string;
 };
 export type ContextPolicy = {
-	mode: "pi" | "remote-compaction" | "remote-windows";
+	mode: "pi" | "remote-compaction";
 	remoteCompaction: {
 		model: string | null;
 		inputSource: RemoteV2ContextSource;
@@ -26,10 +25,6 @@ export type ContextPolicy = {
 		apis: string[];
 	};
 	nativeFallback: Omit<NativeFallbackConfig, "model"> & { model: string | null };
-	remoteWindows: {
-		leaveManagedMode: LeaveManagedModePolicy;
-		reminderThresholdPercent: number;
-	};
 };
 export type EffectiveToolkitPolicy = {
 	context: ContextPolicy;
@@ -61,6 +56,14 @@ export const RETIRED_AUTO_MODE_ISSUE = "retired.autoMode" as const;
 /** Controlled explanation of the retirement; never contains user-supplied values. */
 export const RETIRED_AUTO_MODE_MESSAGE =
 	"Auto Mode has been removed; these settings are ignored and tool calls are no longer reviewed by it.";
+/** Opaque ancillary settings are warning-only; explicitly selected retired modes block context. */
+export const RETIRED_REMOTE_WINDOWS_ISSUE = "retired.remoteWindows" as const;
+export const RETIRED_REMOTE_WINDOWS_MODE_ISSUE = "retired.remoteWindows.mode" as const;
+export const RETIRED_REMOTE_WINDOWS_CONFIG_MESSAGE =
+	"Remote Windows has been removed; these settings are ignored. No window behavior or automatic migration is available.";
+export const RETIRED_REMOTE_WINDOWS_MODE_MESSAGE =
+	"Remote Windows has been removed. Context operations are blocked until you explicitly select pi or remote-compaction. No replacement mode was activated.";
+
 export type ResolvedToolkitPolicy = {
 	policy: EffectiveToolkitPolicy;
 	origins: Record<string, ConfigOrigin>;
@@ -91,10 +94,6 @@ export function createPolicyDefaults(): EffectiveToolkitPolicy {
 				apis: [...context.responsesApis],
 			},
 			nativeFallback: { ...context.nativeFallback, model: null },
-			remoteWindows: {
-				leaveManagedMode: context.leaveManagedMode,
-				reminderThresholdPercent: context.contextReminderThresholdPercent,
-			},
 		},
 		webSearch: { route: "unmanaged" },
 		imageGeneration: {

package/src/config/v2.ts

@@ -60,6 +60,8 @@ import {
 import {
 	CONFIG_FEATURES,
 	RETIRED_AUTO_MODE_ISSUE,
+	RETIRED_REMOTE_WINDOWS_ISSUE,
+	RETIRED_REMOTE_WINDOWS_MODE_ISSUE,
 	createPolicyDefaults,
 	type ConfigFeature,
 	type ConfigIssue,
@@ -100,9 +102,8 @@ export const V2_ISSUE = {
 	imageDefaultNotAllowed: "imageGeneration.defaultModel.notAllowed",
 } as const;
 
-const CONTEXT_MODES = ["pi", "remote-compaction", "remote-windows"] as const;
+const CONTEXT_MODES = ["pi", "remote-compaction"] as const;
 const INPUT_SOURCES = ["legacy", "pi-context-hook"] as const;
-const LEAVE_MANAGED_MODES = ["warn", "compact"] as const;
 const SEARCH_ROUTES = ["unmanaged", "local", "hosted", "standalone-alpha"] as const;
 const TRANSPORTS = ["standard", "codex-gateway"] as const;
 const DIAGNOSTIC_LEVELS = ["error", "warn", "info", "debug"] as const;
@@ -116,7 +117,6 @@ const MODEL_OVERRIDE_KEYS = new Set(["context", "webSearch", "autoMode", "compat
 const CONTEXT_KEYS = new Set(["mode", "remoteCompaction", "nativeFallback", "remoteWindows"]);
 const REMOTE_COMPACTION_KEYS = new Set(["model", "inputSource", "allowContinuityBreak", "apis"]);
 const NATIVE_FALLBACK_KEYS = new Set(["enabled", "model", "thinkingLevel"]);
-const REMOTE_WINDOWS_KEYS = new Set(["leaveManagedMode", "reminderThresholdPercent"]);
 const WEB_SEARCH_KEYS = new Set(["route"]);
 const IMAGE_GENERATION_KEYS = new Set(["enabled", "defaultModel", "allowedModels"]);
 const RESPONSES_WEBSOCKET_KEYS = new Set(["enabled"]);
@@ -165,8 +165,6 @@ const POLICY_LEAVES: readonly { leaf: string; feature: ConfigFeature }[] = [
 	{ leaf: "context.nativeFallback.enabled", feature: "context" },
 	{ leaf: "context.nativeFallback.model", feature: "context" },
 	{ leaf: "context.nativeFallback.thinkingLevel", feature: "context" },
-	{ leaf: "context.remoteWindows.leaveManagedMode", feature: "context" },
-	{ leaf: "context.remoteWindows.reminderThresholdPercent", feature: "context" },
 	{ leaf: "webSearch.route", feature: "webSearch" },
 	{ leaf: "imageGeneration.enabled", feature: "imageGeneration" },
 	{ leaf: "imageGeneration.defaultModel", feature: "imageGeneration" },
@@ -410,16 +408,6 @@ function readEnum<T extends string>(allowed: readonly T[], value: unknown): Read
 	return { ok: false, code: V2_ISSUE.expectedEnum };
 }
 
-function readInteger(value: unknown, min: number, max: number): ReadResult<number> {
-	if (typeof value !== "number") {
-		return { ok: false, code: typeCode(value, V2_ISSUE.expectedInteger) };
-	}
-	if (!Number.isInteger(value) || value < min || value > max) {
-		return { ok: false, code: V2_ISSUE.range };
-	}
-	return { ok: true, value };
-}
-
 function readThinkingLevel(value: unknown): ReadResult<ThinkingLevel> {
 	return readEnum(THINKING_LEVELS, value);
 }
@@ -548,7 +536,9 @@ function applyContextSettings(
 		{ key: "mode", leaf: "context.mode", feature: "context" },
 		scope,
 		state,
-		(value) => readEnum(CONTEXT_MODES, value),
+		(value) => typeof value === "string" && value.trim() === "remote-windows"
+			? { ok: false, code: RETIRED_REMOTE_WINDOWS_MODE_ISSUE }
+			: readEnum(CONTEXT_MODES, value),
 		(value) => {
 			state.policy.context.mode = value;
 		},
@@ -560,8 +550,12 @@ function applyContextSettings(
 	const nativeFallback = openGroup(raw, "nativeFallback", scope, state, "context");
 	if (nativeFallback) applyNativeFallbackSettings(nativeFallback.raw, nativeFallback.scope, state);
 
-	const remoteWindows = openGroup(raw, "remoteWindows", scope, state, "context");
-	if (remoteWindows) applyRemoteWindowsSettings(remoteWindows.raw, remoteWindows.scope, state);
+	// Retired ancillary data is opaque, even when malformed. Never validate
+	// children, create origins or invalidate otherwise valid context policy.
+	if (Object.hasOwn(raw, "remoteWindows")) state.issues.push(withModel(scope, {
+		severity: "warning", code: RETIRED_REMOTE_WINDOWS_ISSUE,
+		path: joinPath(scope.input, "remoteWindows"), feature: "context",
+	}));
 }
 
 function applyRemoteCompactionSettings(
@@ -692,39 +686,6 @@ function applyNativeFallbackSettings(
 	);
 }
 
-function applyRemoteWindowsSettings(
-	raw: Record<string, unknown>,
-	scope: Scope,
-	state: ResolutionState,
-): void {
-	reportUnknownKeys(raw, REMOTE_WINDOWS_KEYS, scope, state, "context");
-
-	applyField(
-		raw,
-		{ key: "leaveManagedMode", leaf: "context.remoteWindows.leaveManagedMode", feature: "context" },
-		scope,
-		state,
-		(value) => readEnum(LEAVE_MANAGED_MODES, value),
-		(value) => {
-			state.policy.context.remoteWindows.leaveManagedMode = value;
-		},
-	);
-	applyField(
-		raw,
-		{
-			key: "reminderThresholdPercent",
-			leaf: "context.remoteWindows.reminderThresholdPercent",
-			feature: "context",
-		},
-		scope,
-		state,
-		(value) => readInteger(value, 0, 100),
-		(value) => {
-			state.policy.context.remoteWindows.reminderThresholdPercent = value;
-		},
-	);
-}
-
 function applyWebSearchSettings(
 	raw: Record<string, unknown>,
 	scope: Scope,