dsh-model-switch 0.4.22 → 0.4.24

package/lib/session-title.js

@@ -0,0 +1,217 @@
+import { n as sessionProviderOf, t as resolveCapabilityRoute } from "./session-route-h9SAqajc.js";
+//#region lib/types/session-title.js
+/**
+* Model Switch-owned session-naming row.
+*
+* The official naming rows hardwire the naming route at registration time: the
+* configured provider/model pair wins over the session's own logged route for
+* every session in the profile. This row registers ONE provider of its own and
+* resolves the route PER REQUEST instead, so a session whose provider has a
+* saved group is named through that group's pair while every other session keeps
+* following its own model.
+*
+* The call itself stays inside the official implementation: the exported
+* `generateSessionTitleWithLlm` receives the session-resolved config and records
+* exactly that route in `session/title-llm-request`, so the durable record and
+* the actual request can never disagree. Nothing is remounted when settings
+* change — the route is read through on every naming request — so a settings
+* save can neither interrupt an in-flight naming request nor leave the profile
+* without a registered provider.
+*
+* `cordis.patch.yml` disables the official row (the seam allows one registered
+* provider per context), and this row mirrors the cadence the disabled row
+* declared, so a profile that restated the row as all-prompts keeps its cadence.
+*
+* @module dsh-model-switch/session-title
+*/
+var __rewriteRelativeImportExtension = function(path, preserveJsx) {
+	if (typeof path === "string" && /^\.\.?\//.test(path)) return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function(m, tsx, d, ext, cm) {
+		return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : d + ext + "." + cm.toLowerCase() + "js";
+	});
+	return path;
+};
+/** Official session-title provider row this module supersedes. */
+const OFFICIAL_TITLE_ROW = "session-title-llm";
+/** The auxiliary-LLM package carrying the shared naming policy and call. */
+const TITLE_LLM_PACKAGE = "@deepseek-ai/dsh-session-title-llm";
+/** Cordis plugin identity; matches the cordis.patch.yml insert row id. */
+const name = "model-switch-session-title";
+/** The loader names the disabled row, and the seam services the call needs are awaited before the first naming request. */
+const inject = [
+	"loader",
+	"sessionTitle",
+	"llm"
+];
+/** Both official cadence packages, in the order a profile may declare them. */
+const TITLE_CADENCES = Object.freeze([Object.freeze({
+	pkg: "@deepseek-ai/dsh-session-title-first-prompt-llm",
+	id: "session-title-first-prompt-llm",
+	automatic: "first-prompt",
+	firstPromptOnly: true
+}), Object.freeze({
+	pkg: "@deepseek-ai/dsh-session-title-all-prompts-llm",
+	id: "session-title-all-prompts-llm",
+	automatic: "all-prompts",
+	firstPromptOnly: false
+})]);
+/**
+* The cadence one official package name declares.
+* @param pkg - the disabled row's package name.
+* @returns The matching cadence, or undefined for a row this row cannot mirror.
+*/
+function titleCadence(pkg) {
+	if (pkg === void 0) return void 0;
+	return TITLE_CADENCES.find((cadence) => cadence.pkg === pkg);
+}
+/**
+* Overlay the session-resolved route over the row's own validated policy.
+*
+* A resolved route always names both halves. When nothing resolves, the row's
+* own policy is returned unchanged: an explicit pair the profile configured on
+* the official row stays the deployment default, and a row without one keeps
+* following each session's logged route.
+* @param config - policy validated from the disabled official row.
+* @param route - session-resolved naming route, or undefined for the row's own policy.
+* @returns A detached config for one naming request.
+*/
+function composeTitleRoute(config, route) {
+	if (route === void 0) return config;
+	return {
+		...config,
+		provider: route.provider,
+		model: route.model
+	};
+}
+/**
+* Frame the exact human messages one naming revision represents.
+* @param messages - every eligible human message of the revision.
+* @param firstPromptOnly - cadence flag: true mirrors the first-prompt provider.
+* @returns The selected messages, in order.
+* @throws when a first-prompt cadence receives an empty revision — the official provider's own contract.
+*/
+function selectTitleMessages(messages, firstPromptOnly) {
+	if (!firstPromptOnly) return messages;
+	const first = messages[0];
+	if (first === void 0) throw new Error("first-prompt title provider requires one human message");
+	return [first];
+}
+/**
+* Locate the official session-title provider 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 officialTitleEntry(loader) {
+	if (!loader) return void 0;
+	for (const entry of loader.entries()) {
+		if (entry.id === OFFICIAL_TITLE_ROW) return entry;
+		const pkg = entry.options?.name;
+		if (typeof pkg === "string" && TITLE_CADENCES.some((cadence) => cadence.pkg === pkg)) return entry;
+	}
+}
+/**
+* Copy the official row's stored config, ignoring non-object payloads.
+* @param entry - the official session-title provider entry.
+* @returns A plain object spread; missing or invalid configs become `{}`. The
+* result is untrusted: the profile may be hand-edited, so the official policy
+* validator runs over it before any naming request is served.
+*/
+function forwardedConfig(entry) {
+	const raw = entry.options?.config;
+	if (raw && typeof raw === "object" && !Array.isArray(raw)) return raw;
+	return {};
+}
+/**
+* The official package name this row mounts (either cadence).
+* @param entry - the official session-title provider entry.
+* @returns The package name, or undefined when the row declares none.
+*/
+function officialTitlePackage(entry) {
+	const pkg = entry.options?.name;
+	return typeof pkg === "string" && pkg.trim() !== "" ? pkg : void 0;
+}
+/**
+* Read live Model Switch settings without requiring the host row.
+*
+* The host is read structurally instead of injected so this row keeps mirroring
+* the official naming behavior when the `model-switch` row is disabled: an
+* unreachable host resolves to the row's own policy rather than to a pinned
+* route.
+* @param ctx - this row's context.
+* @returns The settings, or undefined when the host is unavailable.
+*/
+function currentSettings(ctx) {
+	try {
+		return ctx.get("modelSwitch", false)?.currentSettings();
+	} catch {
+		return;
+	}
+}
+/**
+* Execute one naming request through the official implementation.
+*
+* The route is resolved from the session being titled — its provider selects the
+* saved group, and the flat settings pair is the deployment default — and is
+* handed to `generateSessionTitleWithLlm`, which frames the request, records the
+* exact route in `session/title-llm-request`, and validates the result.
+* @param ctx - this row's context, exposing `llm`.
+* @param module - the loaded auxiliary-LLM module.
+* @param plan - the profile's fixed naming policy.
+* @param request - service-owned session, message revision, and cancellation.
+* @returns The official provider result.
+*/
+async function generateTitle(ctx, module, plan, request) {
+	const provider = sessionProviderOf(ctx, request.session);
+	const route = resolveCapabilityRoute(currentSettings(ctx), provider, "title");
+	return module.generateSessionTitleWithLlm(ctx, composeTitleRoute(plan.config, route), request, selectTitleMessages(request.messages, plan.cadence.firstPromptOnly), plan.cadence.id);
+}
+/**
+* Mount the Model Switch session-naming row for this profile.
+*
+* A profile with no official naming row, an unrecognized row package, a missing
+* auxiliary-LLM package, or an invalid stored policy keeps the session-title
+* service's deterministic fallback titles and reports the lost capability
+* explicitly instead of guessing a route. The registration is an effect of this
+* row's fiber, so unloading the profile unregisters the provider.
+* @param ctx - this row's context.
+*/
+async function apply(ctx) {
+	const entry = officialTitleEntry(ctx.get("loader", false));
+	const cadence = titleCadence(entry === void 0 ? void 0 : officialTitlePackage(entry)) ?? TITLE_CADENCES[0];
+	if (cadence === void 0) return;
+	if (entry === void 0) ctx.logger.info("model-switch: no instantiated official session-title row to mirror; naming uses the first-prompt cadence");
+	/** The displaced row's naming policy, or the official defaults when it is absent. */
+	const forwarded = entry === void 0 ? {} : forwardedConfig(entry);
+	let module;
+	try {
+		module = await import(__rewriteRelativeImportExtension(TITLE_LLM_PACKAGE));
+	} catch (cause) {
+		ctx.logger.error(`model-switch: ${TITLE_LLM_PACKAGE} is unavailable; model-backed session naming cannot run at all`);
+		ctx.logger.error(cause);
+		return;
+	}
+	let config;
+	try {
+		config = module.resolveSessionTitleLlmConfig(forwarded);
+	} catch (cause) {
+		ctx.logger.error("model-switch: the official session-title row has no valid naming policy; naming keeps the deterministic fallback");
+		ctx.logger.error(cause);
+		return;
+	}
+	const plan = {
+		cadence,
+		config
+	};
+	try {
+		ctx.sessionTitle.register({
+			id: cadence.id,
+			automatic: cadence.automatic,
+			generate: (request) => generateTitle(ctx, module, plan, request)
+		});
+	} catch (cause) {
+		ctx.logger.error("model-switch: another session-title provider is already registered; the configurable naming route is unavailable");
+		ctx.logger.error(cause);
+	}
+}
+//#endregion
+export { TITLE_CADENCES, apply, composeTitleRoute, forwardedConfig, inject, name, officialTitleEntry, officialTitlePackage, selectTitleMessages, titleCadence };

package/lib/subagent-runtime.js

@@ -1,3 +1,4 @@
+import { r as sessionSubagentRouteOf } from "./session-route-h9SAqajc.js";
 import { ReasoningEffortId } from "@deepseek-ai/dsh-llm";
 import OfficialSubagentRuntime from "@deepseek-ai/dsh-subagent";
 //#region lib/types/subagent-runtime.js
@@ -20,27 +21,28 @@ function present(value) {
 function spawnHasAnyRouteField(options) {
 	return present(options?.provider) || present(options?.model) || options?.reasoningEffort !== void 0;
 }
-function fixedRoute(settings) {
-	if (!present(settings.subagentProvider) || !present(settings.subagentModel)) return void 0;
-	return {
-		provider: settings.subagentProvider,
-		model: settings.subagentModel,
-		...present(settings.subagentReasoningEffort) ? { reasoningEffort: ReasoningEffortId(settings.subagentReasoningEffort) } : {}
-	};
-}
-/** Inject a fixed Default Subagent route, or leave the request for Official inherit. */
-function routeSubagentRequest(request, settings) {
+/**
+* Inject one resolved route into a spawn that names none.
+*
+* A spawn that already names a provider, model, or effort keeps it: the caller's
+* explicit selection outranks any profile policy. The route itself is derived
+* from the DELEGATING session (its provider selects a saved group, else the flat
+* Subagent card in `fixed` mode), so two sessions on different providers route
+* their own spawns and neither can rewrite the other's policy.
+* @param request - the caller's spawn request.
+* @param route - the delegating session's resolved route, or undefined for official inherit.
+* @returns The request to hand the official runtime.
+*/
+function routeSubagentRequest(request, route) {
 	if (spawnHasAnyRouteField(request.agentOptions)) return request;
-	if (settings.subagentMode !== "fixed") return request;
-	const selected = fixedRoute(settings);
-	if (selected === void 0) return request;
+	if (route === void 0) return request;
 	return {
 		...request,
 		agentOptions: {
 			...request.agentOptions,
-			provider: selected.provider,
-			model: selected.model,
-			...selected.reasoningEffort === void 0 ? {} : { reasoningEffort: selected.reasoningEffort }
+			provider: route.provider,
+			model: route.model,
+			...route.reasoningEffort === void 0 ? {} : { reasoningEffort: ReasoningEffortId(route.reasoningEffort) }
 		}
 	};
 }
@@ -170,7 +172,8 @@ var ModelSwitchSubagentRuntime = class extends OfficialSubagentRuntime {
 	routed(name, request) {
 		const provider = this.ctx.subagents.getProvider(name);
 		if (provider !== void 0 && provider.capabilities.agentOptions !== true) return request;
-		return routeSubagentRequest(request, routingSurface(this.ctx).currentSettings());
+		const modelSwitch = routingSurface(this.ctx);
+		return routeSubagentRequest(request, sessionSubagentRouteOf(this.ctx, request.parent.session, modelSwitch.currentSettings()));
 	}
 	start(name, request) {
 		return super.start(name, this.routed(name, request));

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

@@ -9,6 +9,14 @@
  * route configured the wrapper passes options through by identity, so the
  * reviewer follows the session model exactly.
  *
+ * The reviewer route is deliberately DEPLOYMENT-WIDE. The official gate builds
+ * its request with no session id and no purpose and closes over the single
+ * context it was applied with, so this plugin has no public way to tell which
+ * session a review serves; guessing one would attribute a review to the wrong
+ * session and make the recorded reviewer route false. The unsupported
+ * per-session reviewer route is recorded in `docs/seam-gap.md` with the public
+ * seam it would need.
+ *
  * 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

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

@@ -2,27 +2,30 @@ import { type ReactNode } from 'react';
 import type { ModelProviderGroup } from '@deepseek-ai/dsh-api-session-controller/types';
 import type { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client';
 import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
-import { type CapabilityRouteView, type MainSettingsView, type ModelSwitchSettingsView, type SubagentSettingsView } from '../client-contract.js';
+import { type CapabilityRouteView, type ModelSwitchSettingsView, type SubagentSettingsView } from '../client-contract.js';
 import { type ProviderGroupConfig } from '../provider-group.js';
 import type { RuntimeCapabilities } from '../runtime-capabilities.js';
 import { type CapabilitiesSnapshot } from './search-capabilities.js';
 import type { ModelSwitchLocaleKey } from './locales.js';
-import type { ConfigViewForm } from './derived-config-form.js';
+import type { ConfigViewForm, ConfigViewOp } from './derived-config-form.js';
 export interface ModelSwitchSettingsFace {
     t: (key: ModelSwitchLocaleKey) => string;
     hooks: {
-        mainSettings: ConfigViewForm<MainSettingsView>;
         subagentSettings: ConfigViewForm<SubagentSettingsView>;
         searchSettings: ConfigViewForm<CapabilityRouteView>;
         imageSettings: ConfigViewForm<CapabilityRouteView>;
         autoReviewSettings: ConfigViewForm<CapabilityRouteView>;
         compactionSettings: ConfigViewForm<CapabilityRouteView>;
+        titleSettings: 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' | 'autoReview' | 'compaction', field: 'provider' | 'model', value: string | undefined) => Promise<void>;
+    /**
+     * Apply one row's changes as a SINGLE revision-fenced write, so a refused
+     * write can never leave a half-written provider/model pair behind.
+     */
+    saveSubagent: (ops: readonly ConfigViewOp<SubagentSettingsView>[]) => Promise<void>;
+    saveCapability: (route: 'search' | 'image' | 'autoReview' | 'compaction' | 'title', ops: readonly ConfigViewOp<CapabilityRouteView>[]) => Promise<void>;
     setCompactOnSwitch: (value: boolean) => Promise<void>;
     /** Replace or remove (undefined) one provider's saved capability group. */
     saveProviderGroup: (provider: string, group: ProviderGroupConfig | undefined) => Promise<void>;

package/lib/types/client/derived-config-form.d.ts

@@ -1,9 +1,23 @@
 import type { ConfigForm, ConfigFormSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client';
+/** One field-level change expressed against a view model, before source-path mapping. */
+export interface ConfigViewOp<T> {
+    field: keyof T & string;
+    value?: unknown;
+}
 export interface ConfigViewForm<T> {
     getSnapshot(): ConfigFormSnapshot<T>;
     subscribe(listener: () => void): () => void;
     set(field: keyof T & string, value: unknown): Promise<void>;
     unset(field: keyof T & string): Promise<void>;
+    /**
+     * Apply several view-field changes as ONE revision-fenced source write, so a row save
+     * either lands completely or is rejected as a whole instead of leaving a half-written pair.
+     *
+     * @param ops view fields to change; `value === undefined` unsets the source field
+     * @param expectedRevision revision the draft was seeded from; forwarded to the source fence
+     * @returns a promise that rejects with `settings-rejected` when the host refuses the write
+     */
+    mutate(ops: readonly ConfigViewOp<T>[], expectedRevision?: number): Promise<void>;
 }
 export declare function deriveConfigForm<Source, View>(source: ConfigForm<Source>, project: (value: Source) => View, fields: {
     [K in keyof View & string]: keyof Source & string;

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

@@ -1,22 +1,21 @@
 export declare const zh: {
     readonly nav: "模型切换";
     readonly title: "模型切换";
-    readonly subtitle: "为主会话、子代理和能力工具设置默认模型。修改只影响新请求。";
+    readonly subtitle: "为子代理与能力路由设置固定模型；当前会话模型用输入框旁的选择器直接切换。";
     readonly conversationRoutes: "对话路由";
     readonly capabilityRoutes: "能力路由";
     readonly sendProtection: "发送保护";
     readonly settingsSynced: "设置已同步";
     readonly remoteSettingsUnavailable: "官方 DSH 在非本机浏览器禁用配置读取与写入；请在 Host 的 127.0.0.1 页面打开设置。";
-    readonly defaultBadge: "默认";
     readonly cancel: "取消";
     readonly compactOnSwitch: "切换时压缩";
     readonly compactOnSwitchHelp: "发送且换了模型时，先按目标窗口检查上下文；超了就用切换前的模型压一次历史，再继续请求。只选模型、不发送，不会压缩。官方自动压缩和 /compact 不受影响。压缩会产生额外模型用量，摘要可能省略细节。";
-    readonly main: "主模型";
     readonly provider: "提供商";
     readonly model: "模型";
     readonly providerDefault: "使用提供商默认值";
     readonly providerDefaultShort: "Provider 默认";
     readonly effort: "推理强度";
+    readonly effortPinned: "已固定";
     readonly save: "保存";
     readonly saving: "保存中…";
     readonly saved: "已保存";
@@ -30,10 +29,8 @@ export declare const zh: {
     readonly imageHelp: "统一 generate_image 会调用所选 Codex 或 Grok Adapter；Provider 原有图片工具仍保留。";
     readonly unavailable: "未接入";
     readonly loading: "正在加载设置…";
-    readonly readonly: "设置为只读";
     readonly requestFailed: "保存失败";
     readonly catalogFailed: "无法加载模型目录。";
-    readonly conflict: "设置已在其他位置更改，请检查最新值后重试。";
     readonly autoReview: "自动审查模型";
     readonly autoReviewFollow: "跟随会话模型";
     readonly autoReviewHelp: "为官方 auto-review（Auto 权限预设的逐调用审查）指定审查模型；需启用官方 auto-review 能力包。关闭时审查跟随当前会话模型。";
@@ -42,14 +39,18 @@ export declare const zh: {
     readonly compactionFollow: "跟随会话模型";
     readonly compactionHelp: "为官方压缩（/compact 与官方自动压缩）指定摘要模型；关闭（两个字段都留空）时使用官方默认，即当前会话的目标模型。";
     readonly compactionRouteHelp: "摘要请求固定使用这里的 Provider/模型，与会话目标模型无关；保存后对下一次压缩立即生效。保存时若恰有压缩进行中，可能被打断并在下次重试。";
+    readonly sessionTitle: "会话命名模型";
+    readonly titleFollow: "跟随会话模型";
+    readonly titleHelp: "为官方自动命名（新会话首条消息后生成标题）指定模型；关闭（两个字段都留空）时命名跟随当前会话模型。";
+    readonly titleRouteHelp: "命名请求固定使用这里的 Provider/模型（不带推理强度）；关闭时跟随会话模型。保存后立即对下一次命名生效，不会中断正在进行的命名，会话日志记录的也是实际使用的模型。";
     readonly providerGroups: "供应商配置组";
     readonly providerGroupsCard: "按供应商预设路由";
-    readonly providerGroupsSummary: "切换主模型供应商时自动应用对应组";
-    readonly providerGroupsHelp: "为压缩、子代理、审查按供应商分别保存路由。";
-    readonly providerGroupsBodyHelp: "每个供应商保存一组压缩、子代理、审查路由；主模型切换到该供应商时，这三条路由自动写入上方对应卡片。切换到未配置的供应商时现有路由保持不变；应用会覆盖三张卡片的当前值（含手动修改）。";
+    readonly providerGroupsSummary: "使用该供应商的会话自动采用对应组";
+    readonly providerGroupsHelp: "为会话命名与子代理按供应商分别保存路由。";
+    readonly providerGroupsBodyHelp: "每个供应商保存一组会话命名与子代理路由。会话自身的供应商与该组一致时，该会话的命名与子代理按组解析，否则回落到上方卡片里的全局设置。切换某个会话的模型不会写入任何全局设置，因此不同供应商的多个会话互不影响。压缩与自动审查仍是全局卡片：压缩事件要如实记录实际写入摘要的模型，审查的拦截点没有会话身份。";
     readonly providerGroupPick: "选择供应商以编辑其配置组。";
     readonly providerGroupDelete: "删除该组";
-    readonly providerGroupApplyFailed: "主模型已保存，但供应商组应用失败：";
+    readonly saveTimeout: "保存超时，请重试";
     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/main-row-controller.d.ts

@@ -1,49 +1,30 @@
 import type { ModelProviderGroup } from '@deepseek-ai/dsh-api-session-controller/types';
-import type { ConfigFormSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client';
-import { type CapabilityRouteView, type MainSettingsView, type SubagentSettingsView } from '../client-contract.js';
+import type { CapabilityRouteView } from '../client-contract.js';
 import type { ModelSwitchLocaleKey } from './locales.js';
-type Share<T> = (selector: (snapshot: ConfigFormSnapshot<T>) => ConfigFormSnapshot<T>) => ConfigFormSnapshot<T>;
-export interface SettingsControllerInputs {
-    useMainSettings: Share<MainSettingsView>;
-    useSubagentSettings: Share<SubagentSettingsView>;
-    saveMain(next: MainSettingsView, expectedRevision: number): Promise<number>;
-    loadCatalog(): Promise<readonly ModelProviderGroup[]>;
-    subscribeProviderOrder?: (listener: () => void) => () => void;
-    t(key: ModelSwitchLocaleKey): string;
-}
 export interface Choice {
     id: string;
     name: string;
     unavailable?: true;
 }
+/** A concrete provider/model/effort triple; route editors copy these fields. */
+export interface RouteModelSelection {
+    provider: string;
+    model: string;
+    reasoningEffort?: string;
+}
 /** Build a settings route for a newly selected model using only that model's default effort. */
-export declare function selectRouteModel(groups: readonly ModelProviderGroup[], provider: string, model: string): MainSettingsView;
+export declare function selectRouteModel(groups: readonly ModelProviderGroup[], provider: string, model: string): RouteModelSelection;
 export declare function deriveRouteChoices(groups: readonly ModelProviderGroup[], route: CapabilityRouteView | undefined, allowedProviders?: readonly string[]): {
     providers: Choice[];
     models: Choice[];
 };
-export declare function expectedMainRevision(mirror: number, accepted?: number): number;
-export declare function acceptedRevisionAfterFailure(accepted: number | undefined, error: unknown): number | undefined;
-export declare function deriveMainChoices(groups: readonly ModelProviderGroup[], draft?: MainSettingsView): {
-    providers: Choice[];
-    models: Choice[];
-    efforts: Choice[];
-};
-export declare function useModelSwitchSettingsController(input: SettingsControllerInputs): {
-    main: ConfigFormSnapshot<MainSettingsView>;
-    subagent: ConfigFormSnapshot<SubagentSettingsView>;
-    draft: MainSettingsView | undefined;
+export interface SettingsCatalogInputs {
+    loadCatalog(): Promise<readonly ModelProviderGroup[]>;
+    subscribeProviderOrder?: (listener: () => void) => () => void;
+    t(key: ModelSwitchLocaleKey): string;
+}
+/** Load the model catalog backing every route editor, reloading on provider-order changes. */
+export declare function useSettingsCatalog(input: SettingsCatalogInputs): {
     groups: readonly ModelProviderGroup[];
-    providers: Choice[];
-    models: Choice[];
-    efforts: Choice[];
-    busy: boolean;
-    message: string | undefined;
-    disabled: boolean;
-    setProvider: (provider: string) => void;
-    setModel: (id: string) => void;
-    setReasoningEffort: (value: string) => void;
-    reset: () => void;
-    save: () => Promise<void>;
+    catalogError: string | undefined;
 };
-export {};

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

@@ -13,8 +13,6 @@ interface ComposerPickerBaseProps {
     /** Hide/disable Agent-role groups on existing DSH sessions that are not native-bound. */
     agentLocked?: boolean;
     available: boolean;
-    /** Explain a disabled picker when the official Host has no persistent settings channel. */
-    unavailableReason?: string;
     directory: PickerDirectoryView;
     t: (key: PickerKey, params?: Record<string, string>) => string;
     embedded?: boolean;
@@ -44,4 +42,4 @@ export interface ModelPaneHeaderProps {
     onQueryChange: (query: string) => void;
 }
 export declare function ModelPaneHeader({ title, backLabel, searchLabel, closeSearchLabel, searchable, searching, query, onBack, onStartSearch, onCloseSearch, onQueryChange, }: ModelPaneHeaderProps): import("react").JSX.Element;
-export declare function ComposerPicker({ locked, providerLock, agentLocked, available, unavailableReason, directory, t, draft, onDraftChange, embedded, tone, resolveInteractionOperations, roleOf, }: ComposerPickerProps): import("react").JSX.Element | null;
+export declare function ComposerPicker({ locked, providerLock, agentLocked, available, directory, t, draft, onDraftChange, embedded, tone, resolveInteractionOperations, roleOf, }: ComposerPickerProps): import("react").JSX.Element | null;

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

@@ -1,7 +1,5 @@
 import type { PendingQuestion } from '@deepseek-ai/dsh-client-ui-user-questions/client';
-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 { PlanPreviewBinding } from './plan-preview.ts';
 import { type PickerDirectoryFace } from './PickerDirectory.ts';
@@ -22,8 +20,6 @@ export interface PlanReviewFace extends PickerDirectoryFace {
     };
     /** Re-read the native binding now (mount, turn transitions, pre-selection). */
     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). */
@@ -34,8 +30,6 @@ export interface PlanReviewFace extends PickerDirectoryFace {
 export type PlanReviewCardProps = PropsRuntime<'conversation.composer'> & PropsLocale<'composer-picker'> & InjectFace<PlanReviewFace> & {
     matched: PendingQuestion;
 };
-/** Match the model seat's admission guard before letting either picker offer a change. */
-export declare function mainDefaultsUnavailableReason(snapshot: ConfigFormSnapshot<MainSettingsView>, t: PlanReviewCardProps['t']): string | undefined;
 /** Inline failed lock-read status; history and log reading stay unaffected. */
 export declare function ProviderLockHint(props: {
     t: PlanReviewCardProps['t'];

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

@@ -20,9 +20,6 @@ export declare const zh: {
     'thinking.off': string;
     'effort.providerDefault': string;
     'status.loading': string;
-    'settings.remoteUnavailable': string;
-    'settings.loading': string;
-    'settings.unavailable': string;
     'error.action': string;
     'error.picker': string;
     'action.reload': string;
@@ -43,7 +40,6 @@ export declare const zh: {
     'plan.pickerCrash': string;
     'plan.feedback': string;
     'plan.feedbackPlaceholder': string;
-    'plan.notRestored': string;
     'plan.dismissUnsupported': string;
     'plan.goalRun': string;
     'plan.goalFailed': string;
@@ -77,9 +73,6 @@ export declare const en: {
     'thinking.off': string;
     'effort.providerDefault': string;
     'status.loading': string;
-    'settings.remoteUnavailable': string;
-    'settings.loading': string;
-    'settings.unavailable': string;
     'error.action': string;
     'error.picker': string;
     'action.reload': string;
@@ -100,7 +93,6 @@ export declare const en: {
     'plan.pickerCrash': string;
     'plan.feedback': string;
     'plan.feedbackPlaceholder': string;
-    'plan.notRestored': string;
     'plan.dismissUnsupported': string;
     'plan.goalRun': string;
     'plan.goalFailed': string;

package/lib/types/client/picker/provider-group-watch.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Apply a provider's saved capability group whenever the seat session's
+ * provider changes — on any switch surface.
+ *
+ * The official model-selection directory projects the Session's durable
+ * `model/selection` events into `store.current` (the sole emitter of those
+ * events is the `session.selectModel` RPC), so a switch performed through the
+ * TUI or any other client lands in the same store this plugin already reads.
+ * One watcher therefore covers every surface for sessions open in this Web
+ * UI, where the previous wiring only covered this plugin's own two call sites.
+ *
+ * Semantics stay exactly as before: a provider change applies the target
+ * provider's group when one exists; a provider without a group, a same-model
+ * change within one provider, and the subscription baseline itself write
+ * nothing. A failed apply is reported and never disturbs the switch.
+ */
+import type { ModelSelection } from '@deepseek-ai/dsh-api-session-controller/types';
+/** The directory store slice the watcher observes. */
+export interface DirectoryWatchSource {
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => {
+        current: ModelSelection | null;
+    };
+}
+export interface ProviderGroupWatchOptions {
+    source: DirectoryWatchSource;
+    /** Adopt the target provider's saved group; a group-less provider must write nothing. */
+    apply: (provider: string) => Promise<void>;
+    /** Reported apply failure; defaults to a console warning. */
+    onFailure?: (error: unknown) => void;
+}
+export interface ProviderGroupWatch {
+    /** Detach from the store; in-flight applies are left to finish. */
+    dispose: () => void;
+}
+/**
+ * Watch one directory store and apply groups on provider changes.
+ *
+ * - The first observed provider (or the one already loaded) is the baseline
+ *   and never triggers a write, so mounting and initial load stay silent.
+ * - Applies are serialized: a change arriving mid-apply coalesces to the
+ *   latest target and runs once the current apply finishes, so two writes
+ *   never interleave pair writes.
+ * - `current` being null (catalog still loading) is ignored, not a change.
+ * @param options - the store to watch and the apply to run.
+ * @returns the watch handle.
+ */
+export declare function createProviderGroupWatch(options: ProviderGroupWatchOptions): ProviderGroupWatch;

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

@@ -1,15 +1,6 @@
 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";
-export interface MainSettingsView {
-    provider: string;
-    model: string;
-    reasoningEffort?: string;
-}
-export declare class MainSettingsConflictError extends Error {
-    readonly name = "MainSettingsConflictError";
-}
 export interface ModelSwitchSettingsView {
     subagentMode: 'follow-main' | 'fixed';
     subagentProvider?: string;
@@ -24,6 +15,8 @@ export interface ModelSwitchSettingsView {
     autoReviewModel?: string;
     compactProvider?: string;
     compactModel?: string;
+    titleProvider?: string;
+    titleModel?: string;
     /** Raw saved per-provider groups; edited whole through the provider-groups card. */
     providerGroups?: ProviderGroupsStorage;
 }
@@ -63,10 +56,16 @@ export declare const COMPACTION_SETTINGS_FIELDS: Readonly<{
     readonly provider: "compactProvider";
     readonly model: "compactModel";
 }>;
+/** Automatic session-title naming route; both unset means the official default (the session's own logged route). */
+export declare const TITLE_SETTINGS_FIELDS: Readonly<{
+    readonly provider: "titleProvider";
+    readonly model: "titleModel";
+}>;
 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;
+export declare function deriveTitleSettings(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;