dsh-model-switch 0.4.18 → 0.4.20

package/lib/index.js

@@ -22,7 +22,10 @@ const Config = z.object({
 	searchModel: z.string().volatile(),
 	imageProvider: z.string().volatile(),
 	imageModel: z.string().volatile(),
-	compactOnSwitch: z.boolean().default(true).volatile()
+	compactOnSwitch: z.boolean().default(true).volatile(),
+	autoReviewProvider: z.string().volatile(),
+	autoReviewModel: z.string().volatile(),
+	planCompactThreshold: z.number().default(2e5).volatile()
 });
 function readConfig(config) {
 	const subagentProvider = config.subagentProvider.get();
@@ -32,6 +35,8 @@ function readConfig(config) {
 	const searchModel = config.searchModel.get();
 	const imageProvider = config.imageProvider.get();
 	const imageModel = config.imageModel.get();
+	const autoReviewProvider = config.autoReviewProvider.get();
+	const autoReviewModel = config.autoReviewModel.get();
 	return {
 		subagentMode: config.subagentMode.get(),
 		...subagentProvider === void 0 ? {} : { subagentProvider },
@@ -41,7 +46,10 @@ function readConfig(config) {
 		...searchModel === void 0 ? {} : { searchModel },
 		...imageProvider === void 0 ? {} : { imageProvider },
 		...imageModel === void 0 ? {} : { imageModel },
-		compactOnSwitch: config.compactOnSwitch.get()
+		compactOnSwitch: config.compactOnSwitch.get(),
+		...autoReviewProvider === void 0 || autoReviewProvider === "" ? {} : { autoReviewProvider },
+		...autoReviewModel === void 0 || autoReviewModel === "" ? {} : { autoReviewModel },
+		planCompactThreshold: config.planCompactThreshold.get()
 	};
 }
 //#endregion
@@ -339,8 +347,28 @@ async function handleFetchRpc(request, handler, operator) {
 		return statusResponse(500);
 	}
 }
+/** Validate one plan-compact payload; returns the request or an error string. */
+function planCompactRequest(payload) {
+	if (payload === null || typeof payload !== "object" || Array.isArray(payload)) return {
+		ok: false,
+		message: "Expected an object payload"
+	};
+	const { sessionId, provider, model } = payload;
+	if (typeof sessionId !== "string" || sessionId.length === 0 || typeof provider !== "string" || provider.length === 0 || typeof model !== "string" || model.length === 0) return {
+		ok: false,
+		message: "Expected sessionId, provider, and model strings"
+	};
+	return {
+		ok: true,
+		request: {
+			sessionId,
+			provider,
+			model
+		}
+	};
+}
 /** Bounded long-poll on the existing registry; each caller owns and disposes its subscription. */
-function capabilitiesRpc(registry, snapshot, lifetime) {
+function capabilitiesRpc(registry, snapshot, lifetime, planCompact) {
 	let revision = 0;
 	let previous;
 	const read = () => {
@@ -354,6 +382,39 @@ function capabilitiesRpc(registry, snapshot, lifetime) {
 		};
 	};
 	return async (endpoint, payload, signal) => {
+		if (endpoint === "plan-compact") {
+			if (planCompact === void 0) return {
+				ok: false,
+				error: {
+					details: {},
+					code: "unavailable",
+					message: "Plan compaction is not mounted on this Host"
+				}
+			};
+			const request = planCompactRequest(payload);
+			if (!request.ok) return {
+				ok: false,
+				error: {
+					details: {},
+					code: "invalid-request",
+					message: request.message
+				}
+			};
+			try {
+				return {
+					ok: true,
+					value: await planCompact(request.request, signal)
+				};
+			} catch (cause) {
+				return {
+					ok: true,
+					value: {
+						status: "error",
+						message: cause instanceof Error ? cause.message : String(cause)
+					}
+				};
+			}
+		}
 		if (endpoint !== "capabilities") return {
 			ok: false,
 			error: {
@@ -406,10 +467,10 @@ function capabilitiesRpc(registry, snapshot, lifetime) {
 		};
 	};
 }
-function installCapabilitiesRpc(ctx, registry, snapshot) {
+function installCapabilitiesRpc(ctx, registry, snapshot, planCompact) {
 	ctx.inject(["connection"], (scope) => scope.effect(() => {
 		const lifetime = new AbortController();
-		const handler = capabilitiesRpc(registry, snapshot, lifetime.signal);
+		const handler = capabilitiesRpc(registry, snapshot, lifetime.signal, planCompact);
 		const dispose = scope.connection.fetch.register({
 			path: "/api/plugin-rpc/model-switch",
 			methods: ["POST"],
@@ -864,6 +925,189 @@ async function compactWithPrevious(ctx, agent, previous, signal) {
 	}
 }
 //#endregion
+//#region lib/types/picker/plan-compact.js
+/**
+* Plan-exit compaction vocabulary shared by the card and the Host RPC.
+*
+* The card decides *when* to ask (only an approval that switches the execution
+* model); the Host owns measurement, threshold policy, and the compaction
+* itself. Failures are explicit: the Plan stays pending and can be retried,
+* while an empty history is a completed attempt that may proceed.
+*
+* @module dsh-model-switch/picker/plan-compact
+*/
+/** Whether the user's threshold arms the plan-exit mechanism at all. */
+function planCompactEnabled(threshold) {
+	return Number.isFinite(threshold) && threshold > 0;
+}
+/**
+* Decide whether a plan exit must compact before it switches models.
+* @param threshold — user-configured token threshold; 0 disables the mechanism.
+* @param estimate — measured next-request input tokens.
+* @returns `disabled` when off, `compact` only above the threshold, else `skip`.
+*/
+function planCompactDecision(threshold, estimate) {
+	if (!planCompactEnabled(threshold)) return "disabled";
+	if (!Number.isFinite(estimate) || estimate < 0) return "skip";
+	return estimate > threshold ? "compact" : "skip";
+}
+//#endregion
+//#region lib/types/plan-compact.js
+/**
+* Plan-exit compaction on the Host: measure, threshold, then summarize the
+* history with the switched-to model before the approval resumes the session.
+*
+* The approval answer lands inside a still-open `exit_plan_mode` tool call, so
+* the agent phase is `running` and the idle-only `compactNow` seam is off
+* limits. This module therefore uses `compactIfNeeded(agent, 'context-overflow')`
+* — the same turn-safe, threshold-free operation official overflow recovery
+* uses — under an isolated `compaction-basic` engine configured to summarize
+* with the route the human just chose. The user's threshold decides *whether*
+* to call it; the engine's overflow policy guarantees one useful balanced
+* reduction whenever a safe range exists.
+*
+* @module dsh-model-switch/plan-compact
+*/
+/**
+* Estimate the next request's input tokens under both envelopes.
+*
+* Takes the larger of the target-route heuristic price and the previous
+* envelope's anchored price — the same conservative stance the send-time
+* switch guard takes, so dense histories cannot under-trigger the threshold.
+*
+* @param meter — replay token meter.
+* @param session — session about to resume.
+* @param route — the switched-to provider/model.
+* @returns Estimated tokens, or undefined when no prior request exists to price.
+*/
+function estimatePlanExitTokens(meter, session, route) {
+	const previousHeader = session.requestHeader();
+	if (previousHeader === void 0) return void 0;
+	try {
+		const targetHeader = canonicalHeader({ config: {
+			provider: route.provider,
+			model: route.model
+		} });
+		return Math.max(meter.measure(session, targetHeader).totalTokens, meter.measure(session, previousHeader).totalTokens);
+	} catch {
+		return;
+	}
+}
+/**
+* Drive one compaction through an already-mounted isolated engine.
+* @param engine — engine whose overflow policy selects the range.
+* @param agent — live agent owning the session.
+* @param signal — cancellation scoped to this request.
+* @returns `empty` when no safe range exists, `compacted` after a summary, `error` on failure.
+*/
+async function planCompactWithEngine(engine, agent, signal) {
+	try {
+		const result = await engine.compactIfNeeded(agent, "context-overflow", signal);
+		return result === null || result === void 0 ? { status: "empty" } : { status: "compacted" };
+	} catch (cause) {
+		if (signal.aborted) return {
+			status: "error",
+			message: "compaction was cancelled"
+		};
+		return {
+			status: "error",
+			message: cause instanceof Error ? cause.message : String(cause)
+		};
+	}
+}
+/**
+* Mount an isolated compaction-basic engine pinned to the switched-to route
+* and run one overflow-policy reduction over the agent's session.
+* @param ctx — host context that owns token metering and session state.
+* @param agent — live agent about to resume the approved plan.
+* @param route — provider/model whose model must write the summary.
+* @param signal — cancellation scoped to this request.
+* @param loadEngine — dynamic import seam (tests inject the fake module).
+* @returns The compaction outcome for this request.
+*/
+async function runPlanCompaction(ctx, agent, route, signal, loadEngine) {
+	const load = loadEngine ?? (async () => import("@deepseek-ai/dsh-compaction-basic"));
+	let loaded;
+	try {
+		loaded = await load();
+	} catch (cause) {
+		return {
+			status: "error",
+			message: cause instanceof Error ? cause.message : String(cause)
+		};
+	}
+	const isolated = ctx.isolate("plan-compaction");
+	const fiber = isolated.plugin(loaded.default, {
+		auto: false,
+		summarizationProvider: route.provider,
+		summarizationModel: route.model,
+		compactionRetries: 0
+	});
+	try {
+		await fiber;
+		const engine = isolated.get("compaction", false);
+		if (engine === void 0 || typeof engine.compactIfNeeded !== "function") return {
+			status: "error",
+			message: "private compaction engine is unavailable"
+		};
+		return await planCompactWithEngine(engine, agent, signal);
+	} finally {
+		await fiber.dispose();
+	}
+}
+/**
+* Build the `plan-compact` RPC runner bound to this host's live settings.
+* @param ctx — host context resolving the live agent registry.
+* @param settings — live Model Switch settings (`planCompactThreshold`).
+* @param loadEngine — dynamic import seam (tests inject the fake module).
+* @returns The runner the connection RPC dispatches to.
+*/
+function planCompactRunner(ctx, settings, loadEngine) {
+	return async (request, signal) => {
+		const threshold = settings().planCompactThreshold;
+		if (!planCompactEnabled(threshold)) return {
+			status: "disabled",
+			threshold
+		};
+		const provider = request.provider.trim();
+		const model = request.model.trim();
+		if (provider === "" || model === "") return {
+			status: "error",
+			message: "the execution route is incomplete"
+		};
+		const route = {
+			provider,
+			model
+		};
+		const meter = ctx.get("tokenMeter", false);
+		const agent = ctx.get("agents", false)?.get(request.sessionId);
+		if (agent === void 0) return {
+			status: "error",
+			message: "the session has no live agent"
+		};
+		if (meter === void 0) return {
+			status: "error",
+			message: "token metering is unavailable"
+		};
+		const estimate = estimatePlanExitTokens(meter, agent.session, route);
+		const decision = planCompactDecision(threshold, estimate ?? NaN);
+		if (decision === "disabled") return {
+			status: "disabled",
+			threshold
+		};
+		if (decision === "skip") return {
+			status: "skipped",
+			threshold,
+			...estimate === void 0 ? {} : { estimate }
+		};
+		return {
+			...await runPlanCompaction(ctx, agent, route, signal, loadEngine),
+			threshold,
+			...estimate === void 0 ? {} : { estimate }
+		};
+	};
+}
+//#endregion
 //#region lib/types/host-runtime.js
 /** Host owner for Model Switch settings and the released Main-default adapter. */
 var ModelSwitchRuntime = class extends Service {
@@ -890,7 +1134,7 @@ var ModelSwitchRuntime = class extends Service {
 		installSwitchCompaction(ctx, () => this.source(), (provider) => this.adapters.get(provider)?.role);
 		installDeepSeekSearchAdapter(ctx);
 		installModelSwitchSearchProvider(ctx, this);
-		installCapabilitiesRpc(ctx, this.adapters, () => this.capabilities);
+		installCapabilitiesRpc(ctx, this.adapters, () => this.capabilities, planCompactRunner(ctx, () => this.source()));
 		const imageTool = installGenerateImageTool(ctx, this);
 		ctx.on("loader/volatile-update", () => {
 			imageTool.reconcile().catch((error) => {
@@ -1003,6 +1247,7 @@ function planReviewOf(questions) {
 		id: question.id,
 		question: question.question,
 		plan: question.detail,
+		...intent.callId === void 0 ? {} : { callId: intent.callId },
 		approve,
 		...decline === void 0 ? {} : { decline }
 	};

package/lib/types/auto-review.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Model Switch-owned Auto reviewer row.
+ *
+ * The official `@deepseek-ai/dsh-experimental-auto-review` gate hardwires its
+ * reviewer to the session's own request route (`header.config`). This row runs
+ * the official `apply` under a scoped child context whose `llm` service is
+ * shadowed by a wrapper that rewrites only `stream()`'s provider/model — and
+ * only while the profile has a complete reviewer route configured. With no
+ * route configured the wrapper passes options through by identity, so the
+ * reviewer follows the session model exactly.
+ *
+ * The official gate stays an opt-in capability: the row mounts it only when
+ * the profile actually started with the experimental-auto-review bundle.
+ * `cordis.patch.yml` disables the official row (one `registerAuto` per
+ * context), so this row is its replacement rather than a second registration.
+ *
+ * @module dsh-model-switch/auto-review
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { GenerateOptions, StreamChunk } from '@deepseek-ai/dsh-llm';
+/** Cordis plugin name used by loader diagnostics. */
+export declare const name = "model-switch-auto-review";
+/** The official gate's host services plus Model Switch's settings owner. */
+export declare const inject: string[];
+/** Pinned reviewer route; both identifiers are non-empty. */
+export interface AutoReviewRoute {
+    readonly provider: string;
+    readonly model: string;
+}
+/** Minimal public llm face the official gate uses (it calls exactly `stream`). */
+export interface ReviewLlm {
+    stream(options: GenerateOptions): AsyncIterable<StreamChunk>;
+}
+/**
+ * Resolve the pinned reviewer route from live settings.
+ * @param settings - Model Switch settings carrying the optional reviewer pair.
+ * @returns Both identifiers trimmed and non-empty, or undefined (follow session).
+ */
+export declare function autoReviewRouteOf(settings: {
+    readonly autoReviewProvider?: string;
+    readonly autoReviewModel?: string;
+} | undefined): AutoReviewRoute | undefined;
+/**
+ * Wrap the real llm service so only `stream()` route fields are rewritten.
+ *
+ * Non-`stream` members pass through bound to the real service (Proxy reads
+ * would otherwise hand methods the proxy as `this`). The route is re-read per
+ * call so a settings change applies to the very next review without a reload.
+ *
+ * @param real - the host's `ctx.llm`.
+ * @param route - live route resolver; undefined means "do not rewrite".
+ * @returns A structurally compatible llm face for the scoped context.
+ */
+export declare function reviewLlm(real: ReviewLlm, route: () => AutoReviewRoute | undefined): ReviewLlm;
+/**
+ * Build the scoped context the official gate runs under.
+ * @param ctx - host context whose modelSwitch settings pin the reviewer route.
+ * @returns A child context shadowing only the llm service.
+ */
+export declare function reviewScope(ctx: Context): Context;
+/**
+ * Mount the official gate under the reviewer-route scope.
+ *
+ * A profile that never enabled the optional bundle keeps no Auto preset and no
+ * reviewer; a deployment missing the official package reports the lost
+ * capability explicitly instead of guessing another path.
+ */
+export declare function apply(ctx: Context): Promise<void>;

package/lib/types/capabilities-rpc.d.ts

@@ -2,11 +2,12 @@ import type { Context } from '@deepseek-ai/cordis';
 import { type ConnectionRpcHandler } from '@deepseek-ai/dsh-client-connection';
 import type { ModelSwitchAdapterRegistry } from './adapter-registry.js';
 import type { RuntimeCapabilities } from './runtime-capabilities.js';
+import type { PlanCompactRunner } from './plan-compact.js';
 export declare const CAPABILITIES_RPC_METHOD = "plugin-rpc/model-switch";
 export interface CapabilitiesSnapshot {
     readonly revision: number;
     readonly capabilities: RuntimeCapabilities;
 }
 /** Bounded long-poll on the existing registry; each caller owns and disposes its subscription. */
-export declare function capabilitiesRpc(registry: ModelSwitchAdapterRegistry, snapshot: () => RuntimeCapabilities, lifetime: AbortSignal): ConnectionRpcHandler;
-export declare function installCapabilitiesRpc(ctx: Context, registry: ModelSwitchAdapterRegistry, snapshot: () => RuntimeCapabilities): void;
+export declare function capabilitiesRpc(registry: ModelSwitchAdapterRegistry, snapshot: () => RuntimeCapabilities, lifetime: AbortSignal, planCompact?: PlanCompactRunner): ConnectionRpcHandler;
+export declare function installCapabilitiesRpc(ctx: Context, registry: ModelSwitchAdapterRegistry, snapshot: () => RuntimeCapabilities, planCompact?: PlanCompactRunner): void;

package/lib/types/client/ModelSwitchSettings.d.ts

@@ -14,13 +14,15 @@ export interface ModelSwitchSettingsFace {
         subagentSettings: ConfigViewForm<SubagentSettingsView>;
         searchSettings: ConfigViewForm<CapabilityRouteView>;
         imageSettings: ConfigViewForm<CapabilityRouteView>;
+        autoReviewSettings: ConfigViewForm<CapabilityRouteView>;
         switchSettings: Pick<ConfigForm<ModelSwitchSettingsView>, 'getSnapshot' | 'subscribe'>;
     };
     capabilities: RuntimeCapabilities;
     saveMain: (next: MainSettingsView, expectedRevision: number) => Promise<number>;
     setSubagent: (field: 'mode' | 'provider' | 'model' | 'reasoningEffort', value: string | undefined) => Promise<void>;
-    setCapability: (route: 'search' | 'image', field: 'provider' | 'model', value: string | undefined) => Promise<void>;
+    setCapability: (route: 'search' | 'image' | 'autoReview', field: 'provider' | 'model', value: string | undefined) => Promise<void>;
     setCompactOnSwitch: (value: boolean) => Promise<void>;
+    setPlanCompactThreshold: (value: number) => Promise<void>;
     loadCatalog: () => Promise<readonly ModelProviderGroup[]>;
     /** Host capabilities long-poll; absent in legacy faces, which keep the static-capabilities path. */
     loadCapabilities?: (revision?: number, signal?: AbortSignal) => Promise<CapabilitiesSnapshot>;

package/lib/types/client/locales.d.ts

@@ -34,6 +34,13 @@ export declare const zh: {
     readonly requestFailed: "保存失败";
     readonly catalogFailed: "无法加载模型目录。";
     readonly conflict: "设置已在其他位置更改，请检查最新值后重试。";
+    readonly autoReview: "自动审查模型";
+    readonly autoReviewFollow: "跟随会话模型";
+    readonly autoReviewHelp: "为官方 auto-review（Auto 权限预设的逐调用审查）指定审查模型；需启用官方 auto-review 能力包。关闭时审查跟随当前会话模型。";
+    readonly autoReviewRouteHelp: "审查请求固定使用这里的 Provider/模型，与会话模型无关；保存后对下一次审查立即生效。";
+    readonly planCompactThreshold: "计划执行前压缩阈值";
+    readonly planCompactThresholdHelp: "切换模型执行计划时，若上下文估算超过该 Token 数，先用切换后的模型压缩一次历史再提交执行；未切换模型不触发。0 = 关闭。压缩会产生额外模型用量，摘要可能省略细节。";
+    readonly planCompactThresholdInvalid: "请输入不小于 0 的整数。";
     readonly 'reason.central-subagent-routing': "Alpha.4 没有全局子代理启动路由接口。";
     readonly 'reason.packaged-preset-roots': "Alpha.4 不支持插件提供额外 preset root。";
     readonly 'reason.tool-owner-suppression': "Alpha.4 没有工具所有者或来源抑制接口。";

package/lib/types/client/picker/PlanReviewCard.d.ts

@@ -2,6 +2,9 @@ import type { PendingQuestion } from '@deepseek-ai/dsh-client-ui-user-questions/
 import type { ConfigFormSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import type { MainSettingsView } from '../../client-contract.ts';
+import { type GoalRemote } from '../../picker/plan-goal.ts';
+import type { PlanCompactOutcome } from '../../picker/plan-compact.ts';
+import type { PlanPreviewBinding } from './plan-preview.ts';
 import { type PickerDirectoryFace } from './PickerDirectory.ts';
 import type { PickerInteractionOperations } from './popup-dismissal.ts';
 import { type RuntimeProviderLock } from '../runtime-lock.ts';
@@ -22,6 +25,12 @@ export interface PlanReviewFace extends PickerDirectoryFace {
     refreshProviderLock: () => void;
     subscribeMainDefaults: (listener: () => void) => () => void;
     getMainDefaultsSnapshot: () => ConfigFormSnapshot<MainSettingsView>;
+    /** Released goal remote; absent when this deployment mounts no goal service. */
+    goalRemote: () => GoalRemote | undefined;
+    /** Full-plan sidebar navigation (ui-plan's registered opener). */
+    planPreview: PlanPreviewBinding;
+    /** Host-backed pre-execution compaction; absent seams degrade to no compaction. */
+    planCompact?: (sessionId: string, provider: string, model: string) => Promise<PlanCompactOutcome>;
     /** Live catalog-group-id → card-key map from ProviderDirectory. */
     catalogRoutes?: () => Readonly<Record<string, string>>;
 }

package/lib/types/client/picker/locales.d.ts

@@ -34,6 +34,7 @@ export declare const zh: {
     'choice.unavailable': string;
     'plan.kicker': string;
     'plan.header': string;
+    'plan.openFull': string;
     'plan.execution': string;
     'plan.approve': string;
     'plan.keep': string;
@@ -44,8 +45,16 @@ export declare const zh: {
     'plan.feedbackPlaceholder': string;
     'plan.notRestored': string;
     'plan.dismissUnsupported': string;
+    'plan.goalRun': string;
+    'plan.goalFailed': string;
+    'plan.goalReplaced': string;
+    'plan.goalUnsupported': string;
     'plan.responseRejected': string;
     'plan.cancelRejected': string;
+    'plan.compacting': string;
+    'plan.compacted': string;
+    'plan.compactEmpty': string;
+    'plan.compactFailed': string;
     'markdown.copy': string;
     'markdown.copied': string;
     'markdown.footnotes': string;
@@ -86,6 +95,7 @@ export declare const en: {
     'choice.unavailable': string;
     'plan.kicker': string;
     'plan.header': string;
+    'plan.openFull': string;
     'plan.execution': string;
     'plan.approve': string;
     'plan.keep': string;
@@ -96,8 +106,16 @@ export declare const en: {
     'plan.feedbackPlaceholder': string;
     'plan.notRestored': string;
     'plan.dismissUnsupported': string;
+    'plan.goalRun': string;
+    'plan.goalFailed': string;
+    'plan.goalReplaced': string;
+    'plan.goalUnsupported': string;
     'plan.responseRejected': string;
     'plan.cancelRejected': string;
+    'plan.compacting': string;
+    'plan.compacted': string;
+    'plan.compactEmpty': string;
+    'plan.compactFailed': string;
     'markdown.copy': string;
     'markdown.copied': string;
     'markdown.footnotes': string;

package/lib/types/client/picker/plan-preview.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Restore the official full-plan sidebar preview under the takeover card.
+ *
+ * The takeover replaces the official QuestionComposer in the
+ * `conversation.composer` chain, and that composer is the only entry allowed
+ * to render `conversation.plan-review.actions` (the SlotRegistry enforces one
+ * declarer per child key, and `renderSlot` dispatch checks the *rendering*
+ * entry's own children table). This module therefore drives ui-plan's own
+ * registered opener — its inject face owns the `dsh-resource://plan-review`
+ * address, the logged-plan branch, and the sidebar-mounted gate — instead of
+ * re-deriving any of them here. If ui-plan is absent, every operation
+ * degrades to "unavailable" and the card keeps working.
+ */
+import type { StoredEntry } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { PlanReview } from '@deepseek-ai/dsh-client-ui-user-questions/client';
+/** Minimal registry face the binding reads (the public slot ledger snapshot). */
+export interface PlanPreviewSlots {
+    entries(key: string): readonly StoredEntry[];
+}
+/** Sideways navigation controls for the full plan document in the right sidebar. */
+export interface PlanPreviewBinding {
+    /** Whether ui-plan's opener entry is registered right now. */
+    available(): boolean;
+    /** Open the full plan immediately; returns false when unavailable. */
+    open(sessionId: SessionId, review: PlanReview, requestKey: string): boolean;
+    /** Open once as soon as a Session is on screen; idempotent per review identity. */
+    autoOpen(sessionId: SessionId, review: PlanReview, requestKey: string): () => void;
+}
+/**
+ * Stable identity of one review's sidebar preview.
+ * @param sessionId - session that owns the review.
+ * @param review - narrowed plan review.
+ * @param requestKey - pending-question request key.
+ * @returns `session:call:<callId>` for a logged plan, else `session:review:<requestKey>`.
+ */
+export declare function planPreviewIdentity(sessionId: SessionId, review: PlanReview, requestKey: string): string;
+/**
+ * Whether this process already opened the preview for one review identity.
+ * @param identity - value from {@link planPreviewIdentity}.
+ * @returns True once opened.
+ */
+export declare function wasPlanPreviewOpened(identity: string): boolean;
+/**
+ * Bind the preview navigation to one slot registry.
+ * @param slots - the live registry ledger.
+ * @returns an idempotent binding usable from the card's render and effects.
+ */
+export declare function createPlanPreviewBinding(slots: PlanPreviewSlots): PlanPreviewBinding;

package/lib/types/client-contract.d.ts

@@ -19,6 +19,10 @@ export interface ModelSwitchSettingsView {
     imageProvider?: string;
     imageModel?: string;
     compactOnSwitch?: boolean;
+    autoReviewProvider?: string;
+    autoReviewModel?: string;
+    /** Plan-exit compaction threshold in tokens; absent = the shipped default. */
+    planCompactThreshold?: number;
 }
 export interface SubagentSettingsView {
     mode: 'follow-main' | 'fixed';
@@ -46,6 +50,14 @@ export declare const IMAGE_SETTINGS_FIELDS: Readonly<{
     readonly provider: "imageProvider";
     readonly model: "imageModel";
 }>;
+/** Auto-preset reviewer route; both unset means the reviewer follows the session model. */
+export declare const AUTO_REVIEW_SETTINGS_FIELDS: Readonly<{
+    readonly provider: "autoReviewProvider";
+    readonly model: "autoReviewModel";
+}>;
 export declare function deriveSubagentSettings(settings: ModelSwitchSettingsView): SubagentSettingsView;
 export declare function deriveSearchSettings(settings: ModelSwitchSettingsView): CapabilityRouteView;
 export declare function deriveImageSettings(settings: ModelSwitchSettingsView): CapabilityRouteView;
+export declare function deriveAutoReviewSettings(settings: ModelSwitchSettingsView): CapabilityRouteView;
+/** Whether both reviewer fields form a complete route; an incomplete pair still follows the session model. */
+export declare function autoReviewRouteConfigured(route: CapabilityRouteView | undefined): boolean;

package/lib/types/host-runtime.d.ts

@@ -21,6 +21,9 @@ export declare class ModelSwitchRuntime extends Service {
         imageProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
         imageModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
         compactOnSwitch: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+        autoReviewProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        autoReviewModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        planCompactThreshold: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
     }>>, Schemastery.ObjectT<NoInfer<{
         subagentMode: import("@deepseek-ai/schemastery").default<"follow-main" | "fixed", "follow-main" | "fixed", "volatile-defined">;
         subagentProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
@@ -31,6 +34,9 @@ export declare class ModelSwitchRuntime extends Service {
         imageProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
         imageModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
         compactOnSwitch: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+        autoReviewProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        autoReviewModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        planCompactThreshold: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
     }>>, "plain">;
     get capabilities(): {
         searchProviderAdapters: {

package/lib/types/host-settings.d.ts

@@ -12,6 +12,12 @@ export interface ModelSwitchSettings {
     imageProvider?: string;
     imageModel?: string;
     compactOnSwitch: boolean;
+    /** Reviewer provider for the Auto preset; both fields unset = follow the session model. */
+    autoReviewProvider?: string;
+    /** Reviewer model for the Auto preset; set together with `autoReviewProvider`. */
+    autoReviewModel?: string;
+    /** Plan-exit compaction threshold in tokens; 0 disables the mechanism. */
+    planCompactThreshold: number;
 }
 /** Loader-owned references; every field is directly editable in the profile form. */
 export interface Config {
@@ -24,6 +30,9 @@ export interface Config {
     imageProvider: Volatile<string | undefined>;
     imageModel: Volatile<string | undefined>;
     compactOnSwitch: Volatile<boolean>;
+    autoReviewProvider: Volatile<string | undefined>;
+    autoReviewModel: Volatile<string | undefined>;
+    planCompactThreshold: Volatile<number>;
 }
 export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     subagentMode: z<"follow-main" | "fixed", "follow-main" | "fixed", "volatile-defined">;
@@ -35,6 +44,9 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     imageProvider: z<string, string, "volatile">;
     imageModel: z<string, string, "volatile">;
     compactOnSwitch: z<boolean, boolean, "volatile-defined">;
+    autoReviewProvider: z<string, string, "volatile">;
+    autoReviewModel: z<string, string, "volatile">;
+    planCompactThreshold: z<number, number, "volatile-defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
     subagentMode: z<"follow-main" | "fixed", "follow-main" | "fixed", "volatile-defined">;
     subagentProvider: z<string, string, "volatile">;
@@ -45,5 +57,8 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     imageProvider: z<string, string, "volatile">;
     imageModel: z<string, string, "volatile">;
     compactOnSwitch: z<boolean, boolean, "volatile-defined">;
+    autoReviewProvider: z<string, string, "volatile">;
+    autoReviewModel: z<string, string, "volatile">;
+    planCompactThreshold: z<number, number, "volatile-defined">;
 }>>, "plain">;
 export declare function readConfig(config: Config): ModelSwitchSettings;