dsh-model-switch 0.4.19 → 0.4.21

package/lib/compaction.js

@@ -0,0 +1,205 @@
+//#region lib/types/compaction.js
+/** Official compaction row this module supersedes. */
+const OFFICIAL_COMPACTION_ROW = "compaction-basic";
+/** Official compaction package this module mounts in its place. */
+const OFFICIAL_COMPACTION_PACKAGE = "@deepseek-ai/dsh-compaction-basic";
+/** Cordis plugin identity; matches the cordis.patch.yml insert row id. */
+const name = "model-switch-compaction";
+/** The loader is awaited at row activation; settings and the official row are still read structurally so stock compaction survives a disabled Model Switch row. */
+const inject = ["loader"];
+/**
+* Resolve the configurable summarization route from live settings.
+* @param settings - Model Switch settings carrying the optional compaction pair.
+* @returns Both identifiers trimmed and non-empty, or undefined (official default).
+*/
+function compactionRouteOf(settings) {
+	const provider = settings?.compactProvider?.trim();
+	const model = settings?.compactModel?.trim();
+	if (provider === void 0 || provider === "" || model === void 0 || model === "") return void 0;
+	return {
+		provider,
+		model
+	};
+}
+/**
+* Merge the resolved route over the official row's own config.
+* @param forwarded - config the official compaction-basic row was configured with.
+* @param route - resolved summarization route; undefined keeps official behavior.
+* @returns A detached config safe to hand to a fresh engine construction.
+*/
+function composeCompactionConfig(forwarded, route) {
+	if (!route) return { ...forwarded };
+	return {
+		...forwarded,
+		summarizationProvider: route.provider,
+		summarizationModel: route.model
+	};
+}
+/**
+* Locate the official compaction row in the loader tree.
+* Disabled entries stay in the tree, so a name-matched disable still matches.
+* @param loader - the host loader, when one is reachable.
+* @returns The official entry, or undefined when this profile has no such row.
+*/
+function officialCompactionEntry(loader) {
+	if (!loader) return void 0;
+	for (const entry of loader.entries()) {
+		if (entry.id === OFFICIAL_COMPACTION_ROW) return entry;
+		if (entry.options?.name === OFFICIAL_COMPACTION_PACKAGE) return entry;
+	}
+}
+/**
+* Copy the official row's stored config, ignoring non-object payloads.
+* @param entry - the official compaction entry.
+* @returns A plain object spread; missing or invalid configs become `{}`.
+*/
+function forwardedConfig(entry) {
+	const raw = entry.options?.config;
+	if (raw && typeof raw === "object" && !Array.isArray(raw)) return raw;
+	return {};
+}
+/**
+* Read the live summarization route from the Model Switch host.
+*
+* The host is read structurally instead of injected so this row keeps mounting
+* the official engine (on official defaults) when the `model-switch` row is
+* disabled.
+* @param ctx - this row's context.
+* @returns The configured route, or undefined when unset or host-unavailable.
+*/
+function currentCompactionRoute(ctx) {
+	let settings;
+	try {
+		settings = ctx.get("modelSwitch", false)?.currentSettings();
+	} catch {
+		settings = void 0;
+	}
+	if (!settings) {
+		ctx.logger.info("model-switch: host settings unavailable; compaction uses the official summarization default");
+		return;
+	}
+	return compactionRouteOf(settings);
+}
+/**
+* Load and mount the official basic compaction engine under `config`.
+* @param ctx - this row's context; the engine mounts unisolated so `/compact` sees it.
+* @param config - composed engine config.
+* @param label - which config attempt failed, for the error message.
+* @returns The mounted fiber, or undefined with an explicit error log.
+*/
+async function mountEngine(ctx, config, label) {
+	let loaded;
+	try {
+		loaded = await import("@deepseek-ai/dsh-compaction-basic");
+	} catch (cause) {
+		ctx.logger.error("model-switch: failed to load the official compaction engine package");
+		ctx.logger.error(cause);
+		return;
+	}
+	let fiber;
+	try {
+		fiber = ctx.plugin(loaded.default, config);
+		await fiber;
+		return fiber;
+	} catch (cause) {
+		if (fiber) try {
+			await fiber.dispose();
+		} catch {}
+		ctx.logger.error(`model-switch: failed to mount the compaction engine with ${label}`);
+		ctx.logger.error(cause);
+		return;
+	}
+}
+/**
+* Dispose the live engine, keeping the ledger clean for the next mount.
+* @param ctx - this row's context.
+* @param state - the row's reconcile ledger.
+*/
+async function disposeEngine(ctx, state) {
+	const previous = state.engine;
+	state.engine = void 0;
+	if (!previous) return;
+	try {
+		await previous.dispose();
+	} catch (cause) {
+		ctx.logger.error("model-switch: failed to dispose the previous compaction engine");
+		ctx.logger.error(cause);
+	}
+}
+/**
+* Reconcile one compaction mount: remount only when the composed config changed.
+*
+* Failure ladder: configured config → official defaults (`{}`) → unmounted with
+* explicit errors, so the next settings event retries the whole ladder.
+* @param ctx - this row's context.
+* @param state - the row's reconcile ledger.
+*/
+async function runReconcile(ctx, state) {
+	const entry = officialCompactionEntry(ctx.get("loader", false));
+	if (!entry) {
+		if (!state.missingRow) {
+			state.missingRow = true;
+			ctx.logger.info("model-switch: no official compaction-basic row in this profile; the compaction engine stays unmounted");
+		}
+		return;
+	}
+	state.missingRow = false;
+	const config = composeCompactionConfig(forwardedConfig(entry), currentCompactionRoute(ctx));
+	const signature = JSON.stringify(config);
+	if (state.signature === signature && state.engine) return;
+	await disposeEngine(ctx, state);
+	state.signature = signature;
+	const fiber = await mountEngine(ctx, config, "the configured summarization route");
+	if (fiber) {
+		state.engine = fiber;
+		return;
+	}
+	ctx.logger.error("model-switch: retrying the compaction engine on the official defaults");
+	const fallback = await mountEngine(ctx, {}, "the official defaults");
+	if (fallback) {
+		state.engine = fallback;
+		return;
+	}
+	ctx.logger.error("model-switch: compaction engine is unmounted; /compact and automatic compaction are unavailable until settings change");
+}
+/**
+* Queue a reconcile behind the row's serialized chain, absorbing failures.
+* @param ctx - this row's context.
+* @param state - the row's reconcile ledger.
+* @returns The chain tail; never rejects.
+*/
+function scheduleReconcile(ctx, state) {
+	state.chain = state.chain.then(() => runReconcile(ctx, state)).catch((cause) => {
+		ctx.logger.error("model-switch: compaction engine reconcile failed");
+		ctx.logger.error(cause);
+	});
+	return state.chain;
+}
+/**
+* Mount the Model Switch compaction engine for this profile.
+*
+* Installs a sibling row that replaces the official compaction-basic engine
+* with the same package under the configurable summarization route. Host
+* settings and the loader are read structurally so a disabled `model-switch`
+* row leaves official compaction untouched. Reconciles run on
+* `model-switch/settings-update` (emitted by the host on volatile commits and
+* ordinary saves); the listener is global so instances of this row inside
+* agent-preset realms still hear the host row's emission. The initial
+* reconcile is awaited so `/compact` resolves the service as soon as this row
+* completes.
+* @param ctx - this row's context.
+*/
+async function apply(ctx) {
+	const state = {
+		chain: Promise.resolve(),
+		signature: null,
+		engine: void 0,
+		missingRow: false
+	};
+	ctx.on("model-switch/settings-update", () => {
+		scheduleReconcile(ctx, state);
+	}, { global: true });
+	await scheduleReconcile(ctx, state);
+}
+//#endregion
+export { apply, compactionRouteOf, composeCompactionConfig, forwardedConfig, inject, name, officialCompactionEntry };

package/lib/index.js

@@ -22,7 +22,11 @@ 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(),
+	compactProvider: z.string().volatile(),
+	compactModel: z.string().volatile()
 });
 function readConfig(config) {
 	const subagentProvider = config.subagentProvider.get();
@@ -32,6 +36,10 @@ 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();
+	const compactProvider = config.compactProvider.get();
+	const compactModel = config.compactModel.get();
 	return {
 		subagentMode: config.subagentMode.get(),
 		...subagentProvider === void 0 ? {} : { subagentProvider },
@@ -41,7 +49,11 @@ 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 },
+		...compactProvider === void 0 || compactProvider === "" ? {} : { compactProvider },
+		...compactModel === void 0 || compactModel === "" ? {} : { compactModel }
 	};
 }
 //#endregion
@@ -897,7 +909,9 @@ var ModelSwitchRuntime = class extends Service {
 				ctx.logger.error("Model Switch: failed to regenerate generate_image schema");
 				ctx.logger.error(error);
 			});
+			ctx.emit("model-switch/settings-update");
 		});
+		ctx.emit("model-switch/settings-update");
 	}
 	currentSettings() {
 		return { ...this.source() };
@@ -1003,6 +1017,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/client/ModelSwitchSettings.d.ts

@@ -14,12 +14,14 @@ export interface ModelSwitchSettingsFace {
         subagentSettings: ConfigViewForm<SubagentSettingsView>;
         searchSettings: ConfigViewForm<CapabilityRouteView>;
         imageSettings: ConfigViewForm<CapabilityRouteView>;
+        autoReviewSettings: ConfigViewForm<CapabilityRouteView>;
+        compactionSettings: 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' | 'compaction', field: 'provider' | 'model', value: string | undefined) => Promise<void>;
     setCompactOnSwitch: (value: boolean) => Promise<void>;
     loadCatalog: () => Promise<readonly ModelProviderGroup[]>;
     /** Host capabilities long-poll; absent in legacy faces, which keep the static-capabilities path. */

package/lib/types/client/derived-settings-scope.d.ts

@@ -1,4 +1,4 @@
-import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
-export type SettingsFieldMap<View> = Readonly<Partial<Record<keyof View & string, string>>>;
-/** Projection over one shared SettingsScope controller/store, with explicit view-to-owner field mapping. */
-export declare function deriveSettingsScope<Source, View>(source: SettingsScope<Source>, project: (value: Source) => View, fields?: SettingsFieldMap<View>): SettingsScope<View>;
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+export type SettingsFieldMap<View> = Readonly<Partial<Record<keyof View & string, string>>>;
+/** Projection over one shared SettingsScope controller/store, with explicit view-to-owner field mapping. */
+export declare function deriveSettingsScope<Source, View>(source: SettingsScope<Source>, project: (value: Source) => View, fields?: SettingsFieldMap<View>): SettingsScope<View>;

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

@@ -34,6 +34,14 @@ 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 compaction: "压缩模型";
+    readonly compactionFollow: "跟随会话模型";
+    readonly compactionHelp: "为官方压缩（/compact 与官方自动压缩）指定摘要模型；关闭（两个字段都留空）时使用官方默认，即当前会话的目标模型。";
+    readonly compactionRouteHelp: "摘要请求固定使用这里的 Provider/模型，与会话目标模型无关；保存后对下一次压缩立即生效。保存时若恰有压缩进行中，可能被打断并在下次重试。";
     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

@@ -3,6 +3,7 @@ import type { ConfigFormSnapshot } from '@deepseek-ai/dsh-client-ui-settings/cli
 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 { 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';
@@ -25,6 +26,8 @@ export interface PlanReviewFace extends PickerDirectoryFace {
     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;
     /** 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;
@@ -90,6 +91,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;

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/remote-settings-scope.d.ts

@@ -1,45 +1,45 @@
-import type { SettingsPathOpView } from '@deepseek-ai/dsh-api-remotes/client';
-import type { SettingsScope, SettingsScopeSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client';
-interface RemoteError {
-    code: string;
-    message: string;
-}
-interface RemoteResult<T> {
-    ok: boolean;
-    value?: T;
-    error?: RemoteError;
-}
-interface NamespaceView {
-    ns: string;
-    value: unknown;
-    base?: unknown;
-    user?: unknown;
-    revision: number;
-}
-interface DescribeValue {
-    writable: boolean;
-    namespaces: readonly NamespaceView[];
-}
-export interface RemoteSettingsFace {
-    describe(): Promise<RemoteResult<DescribeValue>>;
-    mutate(ns: string, ops: readonly unknown[], expectedRevision: number | undefined): Promise<RemoteResult<NamespaceView>>;
-}
-/** Host-backed settings scope used by this plugin on authenticated remote browsers. */
-export declare class RemoteSettingsScope<T> implements SettingsScope<T> {
-    private readonly api;
-    private readonly namespace;
-    private readonly decode;
-    private snapshot;
-    private readonly listeners;
-    constructor(api: RemoteSettingsFace, namespace: string, decode: (value: unknown) => T | undefined);
-    getSnapshot: () => SettingsScopeSnapshot<T>;
-    subscribe: (listener: () => void) => (() => void);
-    reload(): Promise<void>;
-    set(field: string, value: unknown): Promise<void>;
-    unset(field: string): Promise<void>;
-    mutate(ops: readonly SettingsPathOpView[], expectedRevision?: number): Promise<void>;
-    private write;
-    private accept;
-    private publish;
-}
-export {};
+import type { SettingsPathOpView } from '@deepseek-ai/dsh-api-remotes/client';
+import type { SettingsScope, SettingsScopeSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client';
+interface RemoteError {
+    code: string;
+    message: string;
+}
+interface RemoteResult<T> {
+    ok: boolean;
+    value?: T;
+    error?: RemoteError;
+}
+interface NamespaceView {
+    ns: string;
+    value: unknown;
+    base?: unknown;
+    user?: unknown;
+    revision: number;
+}
+interface DescribeValue {
+    writable: boolean;
+    namespaces: readonly NamespaceView[];
+}
+export interface RemoteSettingsFace {
+    describe(): Promise<RemoteResult<DescribeValue>>;
+    mutate(ns: string, ops: readonly unknown[], expectedRevision: number | undefined): Promise<RemoteResult<NamespaceView>>;
+}
+/** Host-backed settings scope used by this plugin on authenticated remote browsers. */
+export declare class RemoteSettingsScope<T> implements SettingsScope<T> {
+    private readonly api;
+    private readonly namespace;
+    private readonly decode;
+    private snapshot;
+    private readonly listeners;
+    constructor(api: RemoteSettingsFace, namespace: string, decode: (value: unknown) => T | undefined);
+    getSnapshot: () => SettingsScopeSnapshot<T>;
+    subscribe: (listener: () => void) => (() => void);
+    reload(): Promise<void>;
+    set(field: string, value: unknown): Promise<void>;
+    unset(field: string): Promise<void>;
+    mutate(ops: readonly SettingsPathOpView[], expectedRevision?: number): Promise<void>;
+    private write;
+    private accept;
+    private publish;
+}
+export {};

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

@@ -19,6 +19,10 @@ export interface ModelSwitchSettingsView {
     imageProvider?: string;
     imageModel?: string;
     compactOnSwitch?: boolean;
+    autoReviewProvider?: string;
+    autoReviewModel?: string;
+    compactProvider?: string;
+    compactModel?: string;
 }
 export interface SubagentSettingsView {
     mode: 'follow-main' | 'fixed';
@@ -46,6 +50,20 @@ 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";
+}>;
+/** Compaction summarization route for `/compact` and automatic compaction; both unset means the official default (the conversation target). */
+export declare const COMPACTION_SETTINGS_FIELDS: Readonly<{
+    readonly provider: "compactProvider";
+    readonly model: "compactModel";
+}>;
 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;
+export declare function deriveCompactionSettings(settings: ModelSwitchSettingsView): CapabilityRouteView;
+/** Whether both fields of a model route form a complete pair; an incomplete pair stays off. */
+export declare function routePairConfigured(route: CapabilityRouteView | undefined): boolean;

package/lib/types/compaction.d.ts

@@ -0,0 +1,56 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { Entry, Loader } from '@deepseek-ai/cordis-plugin-loader';
+import type { BasicCompactionConfig } from '@deepseek-ai/dsh-compaction-basic';
+/** Cordis plugin identity; matches the cordis.patch.yml insert row id. */
+export declare const name = "model-switch-compaction";
+/** The loader is awaited at row activation; settings and the official row are still read structurally so stock compaction survives a disabled Model Switch row. */
+export declare const inject: string[];
+/** Both identifiers trimmed and non-empty; undefined means "official default". */
+export interface CompactionRoute {
+    readonly provider: string;
+    readonly model: string;
+}
+/**
+ * Resolve the configurable summarization route from live settings.
+ * @param settings - Model Switch settings carrying the optional compaction pair.
+ * @returns Both identifiers trimmed and non-empty, or undefined (official default).
+ */
+export declare function compactionRouteOf(settings: {
+    readonly compactProvider?: string;
+    readonly compactModel?: string;
+} | undefined): CompactionRoute | undefined;
+/**
+ * Merge the resolved route over the official row's own config.
+ * @param forwarded - config the official compaction-basic row was configured with.
+ * @param route - resolved summarization route; undefined keeps official behavior.
+ * @returns A detached config safe to hand to a fresh engine construction.
+ */
+export declare function composeCompactionConfig(forwarded: BasicCompactionConfig, route: CompactionRoute | undefined): BasicCompactionConfig;
+/**
+ * Locate the official compaction row in the loader tree.
+ * Disabled entries stay in the tree, so a name-matched disable still matches.
+ * @param loader - the host loader, when one is reachable.
+ * @returns The official entry, or undefined when this profile has no such row.
+ */
+export declare function officialCompactionEntry(loader: Loader | undefined): Entry | undefined;
+/**
+ * Copy the official row's stored config, ignoring non-object payloads.
+ * @param entry - the official compaction entry.
+ * @returns A plain object spread; missing or invalid configs become `{}`.
+ */
+export declare function forwardedConfig(entry: Entry): BasicCompactionConfig;
+/**
+ * Mount the Model Switch compaction engine for this profile.
+ *
+ * Installs a sibling row that replaces the official compaction-basic engine
+ * with the same package under the configurable summarization route. Host
+ * settings and the loader are read structurally so a disabled `model-switch`
+ * row leaves official compaction untouched. Reconciles run on
+ * `model-switch/settings-update` (emitted by the host on volatile commits and
+ * ordinary saves); the listener is global so instances of this row inside
+ * agent-preset realms still hear the host row's emission. The initial
+ * reconcile is awaited so `/compact` resolves the service as soon as this row
+ * completes.
+ * @param ctx - this row's context.
+ */
+export declare function apply(ctx: Context): Promise<void>;