dsh-model-switch 0.4.23 → 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

@@ -7,7 +7,7 @@ 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: {
@@ -16,11 +16,16 @@ export interface ModelSwitchSettingsFace {
         imageSettings: ConfigViewForm<CapabilityRouteView>;
         autoReviewSettings: ConfigViewForm<CapabilityRouteView>;
         compactionSettings: ConfigViewForm<CapabilityRouteView>;
+        titleSettings: ConfigViewForm<CapabilityRouteView>;
         switchSettings: Pick<ConfigForm<ModelSwitchSettingsView>, 'getSnapshot' | 'subscribe'>;
     };
     capabilities: RuntimeCapabilities;
-    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

@@ -39,13 +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: "每个供应商保存一组压缩、子代理、审查路由；本会话的模型切换到该供应商时（无论通过插件的模型选择器还是 TUI 等其他界面），这三条路由自动写入上方对应卡片。切换到未配置的供应商时现有路由保持不变；应用会覆盖三张卡片的当前值（含手动修改）。";
+    readonly providerGroupsSummary: "使用该供应商的会话自动采用对应组";
+    readonly providerGroupsHelp: "为会话命名与子代理按供应商分别保存路由。";
+    readonly providerGroupsBodyHelp: "每个供应商保存一组会话命名与子代理路由。会话自身的供应商与该组一致时，该会话的命名与子代理按组解析，否则回落到上方卡片里的全局设置。切换某个会话的模型不会写入任何全局设置，因此不同供应商的多个会话互不影响。压缩与自动审查仍是全局卡片：压缩事件要如实记录实际写入摘要的模型，审查的拦截点没有会话身份。";
     readonly providerGroupPick: "选择供应商以编辑其配置组。";
     readonly providerGroupDelete: "删除该组";
+    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-contract.d.ts

@@ -15,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;
 }
@@ -54,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;

package/lib/types/compaction.d.ts

@@ -5,7 +5,16 @@ import type { BasicCompactionConfig } from '@deepseek-ai/dsh-compaction-basic';
 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". */
+/**
+ * Both identifiers trimmed and non-empty; undefined means "official default".
+ *
+ * The summarization route stays deployment-wide on purpose. The official
+ * compaction transaction durably records the provider/model that wrote the
+ * summary, so a per-session rewrite of the summarization call would make that
+ * record false; a deployment that needs provider-scoped summarization uses the
+ * official exact-target `modelPolicies` table, which this row forwards
+ * verbatim from the profile's `compaction-basic` row config.
+ */
 export interface CompactionRoute {
     readonly provider: string;
     readonly model: string;
@@ -39,6 +48,17 @@ export declare function officialCompactionEntry(loader: Loader | undefined): Ent
  * @returns A plain object spread; missing or invalid configs become `{}`.
  */
 export declare function forwardedConfig(entry: Entry): BasicCompactionConfig;
+/**
+ * Whether the compaction capability is actually served from this context.
+ *
+ * Awaiting a plugin fiber settles even when the plugin's injections were never
+ * satisfied, so the mount is confirmed through the public service instead of by
+ * the absence of an error: an unactivated engine must never be recorded as the
+ * live engine, or the row would stop retrying while `/compact` had no service.
+ * @param ctx - this row's context.
+ * @returns true when `ctx.compaction` exposes the engine's public entry points.
+ */
+export declare function engineActive(ctx: Context): boolean;
 /**
  * Mount the Model Switch compaction engine for this profile.
  *
@@ -46,9 +66,10 @@ export declare function forwardedConfig(entry: Entry): BasicCompactionConfig;
  * 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
+ * `model-switch/settings-update` (emitted by the host at construction, on
+ * volatile commits, and on ordinary saves) and read the settled settings, so one
+ * save costs at most one remount; 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.

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

@@ -21,6 +21,10 @@ export interface ModelSwitchSettings {
     compactProvider?: string;
     /** Summarization model for `/compact` and automatic compaction; set together with `compactProvider`. */
     compactModel?: string;
+    /** Naming provider for automatic session titles; both fields unset = official default (the session's own logged route). */
+    titleProvider?: string;
+    /** Naming model for automatic session titles; set together with `titleProvider`. */
+    titleModel?: string;
     /** Per-provider compaction/subagent/review presets, keyed by provider id; absent when no group is saved. */
     providerGroups?: ProviderGroups;
 }
@@ -39,6 +43,8 @@ export interface Config {
     autoReviewModel: Volatile<string | undefined>;
     compactProvider: Volatile<string | undefined>;
     compactModel: Volatile<string | undefined>;
+    titleProvider: Volatile<string | undefined>;
+    titleModel: 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[]>;
 }

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

@@ -1,15 +1,24 @@
 /**
- * Provider configuration groups: per-provider presets for the compaction,
- * subagent, and auto-review routes.
+ * Provider configuration groups: per-provider presets for the session-naming
+ * and subagent 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.
+ * A group is a DERIVED policy, not a write: `src/session-route.ts` resolves the
+ * routes one session should use from its own provider plus this stored table, so
+ * switching a session's provider never rewrites deployment-wide settings and two
+ * sessions on different providers cannot overwrite each other. The field names
+ * below are the flat settings field names a group pins, which keeps the stored
+ * shape identical to the earlier write-through design.
+ *
+ * Legacy entries may still carry `compactProvider`/`compactModel`/
+ * `autoReviewProvider`/`autoReviewModel`: normalization preserves them so an
+ * older stored document is never silently rewritten into a different meaning,
+ * while the consumption side ignores them (a group save from the current UI
+ * writes '' for every unsupported field, which normalization drops).
+ *
+ * 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';
+/** Flat settings fields a provider group carries; the first four are legacy-only. */
+export type ProviderGroupRouteField = 'compactProvider' | 'compactModel' | 'autoReviewProvider' | 'autoReviewModel' | 'subagentProvider' | 'subagentModel' | 'subagentReasoningEffort' | 'titleProvider' | 'titleModel';
 /** Stored entry: the owning provider plus every route field; '' means the capability stays at its default. */
 export interface ProviderGroupEntry {
     provider: string;
@@ -20,6 +29,8 @@ export interface ProviderGroupEntry {
     subagentProvider: string;
     subagentModel: string;
     subagentReasoningEffort: string;
+    titleProvider: string;
+    titleModel: string;
 }
 /** Normalized view of one provider's group; absent fields follow their default state. */
 export type ProviderGroupConfig = Partial<Record<ProviderGroupRouteField, string>>;
@@ -40,22 +51,6 @@ export declare function normalizeProviderGroups(raw: unknown): ProviderGroups;
  * 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;
 /**
@@ -65,14 +60,3 @@ export declare function entryOf(provider: string, group: ProviderGroupConfig): P
  * 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>;