dsh-model-switch 0.4.20 → 0.4.22

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

@@ -38,9 +38,18 @@ export declare const zh: {
     readonly autoReviewFollow: "跟随会话模型";
     readonly autoReviewHelp: "为官方 auto-review（Auto 权限预设的逐调用审查）指定审查模型；需启用官方 auto-review 能力包。关闭时审查跟随当前会话模型。";
     readonly autoReviewRouteHelp: "审查请求固定使用这里的 Provider/模型，与会话模型无关；保存后对下一次审查立即生效。";
-    readonly planCompactThreshold: "计划执行前压缩阈值";
-    readonly planCompactThresholdHelp: "切换模型执行计划时，若上下文估算超过该 Token 数，先用切换后的模型压缩一次历史再提交执行；未切换模型不触发。0 = 关闭。压缩会产生额外模型用量，摘要可能省略细节。";
-    readonly planCompactThresholdInvalid: "请输入不小于 0 的整数。";
+    readonly compaction: "压缩模型";
+    readonly compactionFollow: "跟随会话模型";
+    readonly compactionHelp: "为官方压缩（/compact 与官方自动压缩）指定摘要模型；关闭（两个字段都留空）时使用官方默认，即当前会话的目标模型。";
+    readonly compactionRouteHelp: "摘要请求固定使用这里的 Provider/模型，与会话目标模型无关；保存后对下一次压缩立即生效。保存时若恰有压缩进行中，可能被打断并在下次重试。";
+    readonly providerGroups: "供应商配置组";
+    readonly providerGroupsCard: "按供应商预设路由";
+    readonly providerGroupsSummary: "切换主模型供应商时自动应用对应组";
+    readonly providerGroupsHelp: "为压缩、子代理、审查按供应商分别保存路由。";
+    readonly providerGroupsBodyHelp: "每个供应商保存一组压缩、子代理、审查路由；主模型切换到该供应商时，这三条路由自动写入上方对应卡片。切换到未配置的供应商时现有路由保持不变；应用会覆盖三张卡片的当前值（含手动修改）。";
+    readonly providerGroupPick: "选择供应商以编辑其配置组。";
+    readonly providerGroupDelete: "删除该组";
+    readonly providerGroupApplyFailed: "主模型已保存，但供应商组应用失败：";
     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,7 +3,6 @@ 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 { 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';
@@ -29,8 +28,6 @@ export interface PlanReviewFace extends PickerDirectoryFace {
     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

@@ -51,10 +51,6 @@ export declare const zh: {
     '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;
@@ -112,10 +108,6 @@ export declare const en: {
     '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/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

@@ -1,3 +1,4 @@
+import type { ProviderGroupsStorage } from './provider-group.js';
 export declare const MODEL_SWITCH_CONFIG_ID = "model-switch";
 export declare const MAIN_DEFAULT_CONFIG_ID = "agent-default-model";
 export declare const PROVIDERS_CONFIG_ID = "llm-providers-ui";
@@ -21,8 +22,10 @@ export interface ModelSwitchSettingsView {
     compactOnSwitch?: boolean;
     autoReviewProvider?: string;
     autoReviewModel?: string;
-    /** Plan-exit compaction threshold in tokens; absent = the shipped default. */
-    planCompactThreshold?: number;
+    compactProvider?: string;
+    compactModel?: string;
+    /** Raw saved per-provider groups; edited whole through the provider-groups card. */
+    providerGroups?: ProviderGroupsStorage;
 }
 export interface SubagentSettingsView {
     mode: 'follow-main' | 'fixed';
@@ -55,9 +58,15 @@ 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;
-/** Whether both reviewer fields form a complete route; an incomplete pair still follows the session model. */
-export declare function autoReviewRouteConfigured(route: CapabilityRouteView | undefined): boolean;
+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>;

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

@@ -1,43 +1,21 @@
 import { Context, Service } from '@deepseek-ai/cordis';
 import type { ModelSelection } from '@deepseek-ai/dsh-agent';
 import type { AgentDefaultModelConfig } from '@deepseek-ai/dsh-agent-default-model';
-import { type Config as ModelSwitchSettingsConfig, type ModelSwitchSettings } from './host-settings.js';
+import { Config, type Config as ModelSwitchSettingsConfig, type ModelSwitchSettings } from './host-settings.js';
 import { ModelSwitchAdapterRegistry } from './adapter-registry.js';
 declare module '@deepseek-ai/cordis' {
     interface Context {
         modelSwitch: ModelSwitchRuntime;
     }
+    interface Events {
+        /** Model Switch settings changed; reread via `modelSwitch.currentSettings()`. */
+        'model-switch/settings-update'(): void;
+    }
 }
 /** Host owner for Model Switch settings and the released Main-default adapter. */
 export declare class ModelSwitchRuntime extends Service {
     static inject: string[];
-    static Config: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
-        subagentMode: import("@deepseek-ai/schemastery").default<"follow-main" | "fixed", "follow-main" | "fixed", "volatile-defined">;
-        subagentProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        subagentModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        subagentReasoningEffort: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        searchProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        searchModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        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">;
-        subagentModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        subagentReasoningEffort: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        searchProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        searchModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        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">;
+    static Config: import("@deepseek-ai/schemastery").default<any, Config, "plain">;
     get capabilities(): {
         searchProviderAdapters: {
             available: boolean;

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

@@ -1,5 +1,6 @@
 import type { Volatile } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
+import { type ProviderGroupEntry, type ProviderGroups } from './provider-group.js';
 export type SubagentMode = 'follow-main' | 'fixed';
 /** Resolved live values consumed by Model Switch. */
 export interface ModelSwitchSettings {
@@ -16,8 +17,12 @@ export interface ModelSwitchSettings {
     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;
+    /** Summarization provider for `/compact` and automatic compaction; both fields unset = official default (the conversation target). */
+    compactProvider?: string;
+    /** Summarization model for `/compact` and automatic compaction; set together with `compactProvider`. */
+    compactModel?: string;
+    /** Per-provider compaction/subagent/review presets, keyed by provider id; absent when no group is saved. */
+    providerGroups?: ProviderGroups;
 }
 /** Loader-owned references; every field is directly editable in the profile form. */
 export interface Config {
@@ -32,33 +37,15 @@ export interface Config {
     compactOnSwitch: Volatile<boolean>;
     autoReviewProvider: Volatile<string | undefined>;
     autoReviewModel: Volatile<string | undefined>;
-    planCompactThreshold: Volatile<number>;
+    compactProvider: Volatile<string | undefined>;
+    compactModel: Volatile<string | undefined>;
+    /** Saved per-provider capability groups as one entry per provider; entry route fields are '' when the capability stays at its default. */
+    providerGroups: Volatile<readonly ProviderGroupEntry[]>;
 }
-export declare const Config: z<Schemastery.ObjectS<NoInfer<{
-    subagentMode: z<"follow-main" | "fixed", "follow-main" | "fixed", "volatile-defined">;
-    subagentProvider: z<string, string, "volatile">;
-    subagentModel: z<string, string, "volatile">;
-    subagentReasoningEffort: z<string, string, "volatile">;
-    searchProvider: z<string, string, "volatile">;
-    searchModel: z<string, string, "volatile">;
-    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">;
-    subagentModel: z<string, string, "volatile">;
-    subagentReasoningEffort: z<string, string, "volatile">;
-    searchProvider: z<string, string, "volatile">;
-    searchModel: z<string, string, "volatile">;
-    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">;
+/**
+ * Annotated rather than inferred: the nested entry schema's inferred type
+ * expands to cosmokit internals (`Dict`) that cannot be named in the emitted
+ * declaration, and the annotation pins the output shape to this interface.
+ */
+export declare const Config: z<any, Config, 'plain'>;
 export declare function readConfig(config: Config): ModelSwitchSettings;

package/lib/types/picker/plan-goal.d.ts

@@ -61,8 +61,33 @@ export type GoalHandoff = {
     readonly code?: string;
     readonly message: string;
 };
+/** Identity of the plan document under review, for its durable address. */
+export interface PlanDocumentRef {
+    /** Logged tool invocation that owns the plan; absent while only the review is pending. */
+    readonly callId?: string;
+    /** Browser-unique pending request identity (the review card's key). */
+    readonly requestKey: string;
+}
+/**
+ * Address the plan document exactly as the official opener does.
+ *
+ * A logged plan (`callId` present) resolves from `dsh-resource://plan/...`
+ * for as long as the session log holds the call; before that the pending
+ * review's own `dsh-resource://plan-review/...` address is the one that
+ * opens its preview.
+ *
+ * @param sessionId - the session that owns the review.
+ * @param ref - logged call identity plus the pending request key.
+ * @returns The plan resource address.
+ */
+export declare function planDocumentAddress(sessionId: string, ref: PlanDocumentRef): string;
 /**
- * Make the plan text this session's armed goal, replacing any unfinished goal.
+ * Make this plan the session's armed goal, replacing any unfinished goal.
+ *
+ * The objective is a short instruction carrying the plan document's address,
+ * not the plan's raw markdown: goal objectives are injected into every round,
+ * and a full plan would be truncated by length limits mid-sentence. The round
+ * driver reads the plan from the address instead.
  *
  * Ordering mirrors the card's own commit-then-answer rule: a refusal here keeps
  * the Plan pending instead of approving work that no goal tracks. The replace
@@ -71,7 +96,8 @@ export type GoalHandoff = {
  *
  * @param remote - the released goal remote, absent when no goal package is mounted.
  * @param sessionId - the session that owns both the review and the goal.
- * @param plan - the plan markdown under review.
+ * @param plan - the plan markdown under review (validated non-empty).
+ * @param ref - the plan document identity used for its address.
  * @returns Whether the goal now tracks this plan, or why it does not.
  */
-export declare function setPlanAsGoal(remote: GoalRemote | undefined, sessionId: string, plan: string): Promise<GoalHandoff>;
+export declare function setPlanAsGoal(remote: GoalRemote | undefined, sessionId: string, plan: string, ref: PlanDocumentRef): Promise<GoalHandoff>;

package/lib/types/provider-group.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Provider configuration groups: per-provider presets for the compaction,
+ * subagent, and auto-review routes.
+ *
+ * A group stores the exact flat settings fields it will write, so applying a
+ * group is a plain settings-layer write: every capability consumer keeps
+ * reading the live values unchanged. All functions here are pure and never
+ * throw on malformed storage.
+ */
+import type { SubagentMode } from './host-settings.js';
+/** Flat settings fields a provider group can pin — exactly what an application writes. */
+export type ProviderGroupRouteField = 'compactProvider' | 'compactModel' | 'autoReviewProvider' | 'autoReviewModel' | 'subagentProvider' | 'subagentModel' | 'subagentReasoningEffort';
+/** Stored entry: the owning provider plus every route field; '' means the capability stays at its default. */
+export interface ProviderGroupEntry {
+    provider: string;
+    compactProvider: string;
+    compactModel: string;
+    autoReviewProvider: string;
+    autoReviewModel: string;
+    subagentProvider: string;
+    subagentModel: string;
+    subagentReasoningEffort: string;
+}
+/** Normalized view of one provider's group; absent fields follow their default state. */
+export type ProviderGroupConfig = Partial<Record<ProviderGroupRouteField, string>>;
+/** Normalized provider → group map. */
+export type ProviderGroups = Readonly<Record<string, ProviderGroupConfig>>;
+/** Storage shape of the volatile `providerGroups` config field: one entry per provider. */
+export type ProviderGroupsStorage = readonly ProviderGroupEntry[];
+/**
+ * Strip a raw stored value to well-formed groups; never throws. Both storage
+ * shapes are accepted: the stored entry array (keys live in each entry's
+ * `provider` field) and a hand-written provider → routes map (keys are the
+ * providers). All-empty entries stay: they pin a provider to every default.
+ */
+export declare function normalizeProviderGroups(raw: unknown): ProviderGroups;
+/**
+ * The saved group for a provider.
+ * @returns the normalized group, or undefined when the provider has no group —
+ * which is what leaves the live routes untouched during a switch.
+ */
+export declare function groupOf(groups: ProviderGroups | undefined, provider: string): ProviderGroupConfig | undefined;
+/** One application write; `value` undefined means "unset this field". */
+export type ProviderGroupWrite = {
+    readonly field: 'subagentMode';
+    readonly mode: SubagentMode;
+} | {
+    readonly field: ProviderGroupRouteField;
+    readonly value: string | undefined;
+};
+/**
+ * Ordered writes applying one group with full-replacement semantics: pinned
+ * capabilities land as pairs, everything else reverts to its default state
+ * (compaction/review follow the session model; Subagent follows official
+ * inherit). The mode write comes last so a fixed route never publishes with
+ * the previous provider's fields still half-written.
+ */
+export declare function providerGroupWrites(group: ProviderGroupConfig): ProviderGroupWrite[];
+/** Storage entry for one provider's group; absent or blank route fields become ''. */
+export declare function entryOf(provider: string, group: ProviderGroupConfig): ProviderGroupEntry;
+/**
+ * The stored entry list with one provider's group replaced (an entry) or
+ * removed (undefined). Every entry is re-normalized and de-duplicated so a
+ * save can never write junk back; the input is never mutated. A blank
+ * provider only normalizes.
+ */
+export declare function withProviderGroup(storage: unknown, provider: string, group: ProviderGroupConfig | undefined): ProviderGroupsStorage;
+/** Minimal writable settings surface an application needs; satisfied by the owned ConfigForm. */
+export interface ProviderGroupSink {
+    set(field: 'subagentMode' | ProviderGroupRouteField, value: string): Promise<unknown>;
+    unset(field: ProviderGroupRouteField): Promise<unknown>;
+}
+/**
+ * Apply a saved group's routes to the live flat settings.
+ * @returns true when a group existed and every write settled; false when the
+ * provider has no group (nothing was written). A rejected write propagates.
+ */
+export declare function applyProviderGroupTo(sink: ProviderGroupSink, groups: ProviderGroups | undefined, provider: string): Promise<boolean>;