dsh-model-switch 0.4.23 → 0.4.25

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

@@ -4,12 +4,9 @@ export declare const zh: {
     readonly subtitle: "为子代理与能力路由设置固定模型；当前会话模型用输入框旁的选择器直接切换。";
     readonly conversationRoutes: "对话路由";
     readonly capabilityRoutes: "能力路由";
-    readonly sendProtection: "发送保护";
     readonly settingsSynced: "设置已同步";
     readonly remoteSettingsUnavailable: "官方 DSH 在非本机浏览器禁用配置读取与写入；请在 Host 的 127.0.0.1 页面打开设置。";
     readonly cancel: "取消";
-    readonly compactOnSwitch: "切换时压缩";
-    readonly compactOnSwitchHelp: "发送且换了模型时，先按目标窗口检查上下文；超了就用切换前的模型压一次历史，再继续请求。只选模型、不发送，不会压缩。官方自动压缩和 /compact 不受影响。压缩会产生额外模型用量，摘要可能省略细节。";
     readonly provider: "提供商";
     readonly model: "模型";
     readonly providerDefault: "使用提供商默认值";
@@ -39,13 +36,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

@@ -10,11 +10,12 @@ export interface ModelSwitchSettingsView {
     searchModel?: string;
     imageProvider?: string;
     imageModel?: string;
-    compactOnSwitch?: boolean;
     autoReviewProvider?: string;
     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 +55,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

@@ -1,15 +1,29 @@
 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';
+import type { GenerateOptions, StreamChunk } from '@deepseek-ai/dsh-llm';
 /** 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". */
+/**
+ * Both identifiers trimmed and non-empty; undefined means "official default".
+ *
+ * Each summarization call derives its route per session (the session's provider
+ * group → the flat compaction card → the official row's `modelPolicies` /
+ * conversation-target fallback) and mutates `options.provider`/`options.model`
+ * in place before `ctx.llm.stream(options)` so the official `summarizeWithLlm`
+ * returns and durably records the exact route that wrote the summary in
+ * `compaction/summary`.
+ */
 export interface CompactionRoute {
     readonly provider: string;
     readonly model: string;
 }
+/** Public llm face the official compaction engine uses (`stream` + `resolveModelInfo`). */
+export interface CompactionLlm {
+    stream(options: GenerateOptions): AsyncIterable<StreamChunk>;
+}
 /**
  * Resolve the configurable summarization route from live settings.
  * @param settings - Model Switch settings carrying the optional compaction pair.
@@ -39,6 +53,56 @@ 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;
+/**
+ * Resolve the compaction summarization route for one session id.
+ *
+ * Looks up the session from `ctx.sessions` when available, derives its current
+ * provider (`pending` selection preferred over `lastUsed`, then logged routes),
+ * and resolves the provider group's compaction pair before falling back to the
+ * deployment-wide compaction pair.
+ * @param ctx - this row's context.
+ * @param sessionId - the session id carried on `GenerateOptions.sessionId`.
+ * @returns The derived compaction route, or undefined for the engine's own route.
+ */
+export declare function resolveSessionCompactionRoute(ctx: Context, sessionId: string | undefined): CompactionRoute | undefined;
+/**
+ * Wrap the real llm service so `purpose === 'compaction'` calls resolve their
+ * summarization route per session while keeping `compaction/summary` truthful.
+ *
+ * `summarizeWithLlm` builds a mutable `options` literal with `purpose: 'compaction'`
+ * and `sessionId: agent.session.id`, calls `ctx.llm.stream(options)`, and then
+ * returns `{ provider: options.provider, model: options.model }` to `commitCompactionBody`.
+ * Mutating `options.provider` and `options.model` in place before delegating to
+ * `target.stream(options)` ensures the durable `compaction/summary` event
+ * records the exact provider/model that wrote the summary. All other members
+ * (such as `resolveModelInfo`) pass through bound to `real`.
+ * @param real - the host's `ctx.llm`.
+ * @param resolve - per-session route resolver; undefined keeps `options` untouched.
+ * @param onError - optional error sink when the resolver throws.
+ * @returns A transparent Proxy over `real`.
+ */
+export declare function compactionLlm<T extends CompactionLlm>(real: T, resolve: (sessionId: string) => CompactionRoute | undefined, onError?: (cause: unknown) => void): T;
+/**
+ * Build the child context the compaction engine mounts under.
+ *
+ * When `ctx.llm` is present, shadows it with {@link compactionLlm} on an
+ * extended context so the child engine fiber resolves the per-session wrapper
+ * while registering `ctx.compaction` on the shared context tree.
+ * @param ctx - this row's context.
+ * @returns A context shadowing `llm` when available, else `ctx`.
+ */
+export declare function compactionScope(ctx: Context): Context;
+/**
+ * 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 +110,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

@@ -12,7 +12,6 @@ export interface ModelSwitchSettings {
     searchModel?: string;
     imageProvider?: string;
     imageModel?: string;
-    compactOnSwitch: boolean;
     /** Reviewer provider for the Auto preset; both fields unset = follow the session model. */
     autoReviewProvider?: string;
     /** Reviewer model for the Auto preset; set together with `autoReviewProvider`. */
@@ -21,6 +20,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;
 }
@@ -34,11 +37,12 @@ export interface Config {
     searchModel: Volatile<string | undefined>;
     imageProvider: Volatile<string | undefined>;
     imageModel: Volatile<string | undefined>;
-    compactOnSwitch: Volatile<boolean>;
     autoReviewProvider: Volatile<string | undefined>;
     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,18 @@
 /**
  * Provider configuration groups: per-provider presets for the compaction,
- * subagent, and auto-review routes.
+ * auto-review, 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 across releases.
+ *
+ * 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 across all four per-session capabilities. */
+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 +23,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 +45,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 +54,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>;

package/lib/types/session-route.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Per-session capability route derivation.
+ *
+ * Model Switch stores one deployment-wide route per capability (the flat
+ * settings fields) plus, per provider, a saved provider group. Nothing is
+ * written when a session changes provider: this module DERIVES the route a
+ * capability should use for one session from (a) the session's own provider and
+ * (b) the stored group table. Two sessions on different providers therefore
+ * resolve independently, and no session's actions rewrite another session's
+ * route.
+ *
+ * The session's provider is read from durable, official state in this order:
+ * the `modelSelection` session projection (`pending` before `lastUsed`, so a
+ * selection the user just made counts), then the latest logged request-context
+ * route, then the latest `request/header` route. Every read is optional: a
+ * session with no observable provider, an unregistered projection, or a
+ * profile without the projection package all resolve to the deployment default,
+ * which is exactly the pre-derivation behavior.
+ *
+ * All functions are pure except the readers, which never throw and never write.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Session } from '@deepseek-ai/dsh-session';
+import { type ProviderGroups } from './provider-group.js';
+/** Capabilities whose route can be derived per session. */
+export type CapabilityId = 'compaction' | 'autoReview' | 'title' | 'subagent';
+/** A complete pinned route; either half missing means "follow the default". */
+export interface CapabilityRoute {
+    readonly provider: string;
+    readonly model: string;
+}
+/**
+ * Settings fields a route can be derived from. Structurally satisfied by
+ * {@link ModelSwitchSettings}; declared separately so the resolver stays pure
+ * and testable without a host runtime.
+ */
+export interface RouteBearingSettings {
+    readonly subagentMode?: string;
+    readonly subagentProvider?: string;
+    readonly subagentModel?: string;
+    readonly subagentReasoningEffort?: string;
+    readonly autoReviewProvider?: string;
+    readonly autoReviewModel?: string;
+    readonly compactProvider?: string;
+    readonly compactModel?: string;
+    readonly titleProvider?: string;
+    readonly titleModel?: string;
+    readonly providerGroups?: ProviderGroups;
+}
+/**
+ * The deployment-wide route for one capability: the flat settings pair.
+ * @param settings - live Model Switch settings; undefined means none are reachable.
+ * @param capability - capability whose flat pair is read.
+ * @returns The complete pair, or undefined when the capability stays at its official/derived default.
+ */
+export declare function deploymentRoute(settings: RouteBearingSettings | undefined, capability: CapabilityId): CapabilityRoute | undefined;
+/** One capability's route plus the reasoning effort a subagent spawn also carries. */
+export interface SubagentRoute extends CapabilityRoute {
+    readonly reasoningEffort?: string;
+}
+/**
+ * The route a subagent spawn should use for one parent-session provider.
+ *
+ * A saved group for that provider pins the spawn; otherwise the flat Subagent
+ * card pins it, but only in `fixed` mode — `follow-main` IS the official inherit
+ * path, expressed by leaving the request untouched rather than by naming it.
+ * @param settings - live Model Switch settings.
+ * @param provider - the delegating session's provider, when one is observable.
+ * @returns The complete route, or undefined for official inherit.
+ */
+export declare function subagentRouteOf(settings: RouteBearingSettings | undefined, provider: string | undefined): SubagentRoute | undefined;
+/**
+ * One provider's saved route for one capability.
+ * @param settings - live Model Switch settings carrying the group table.
+ * @param provider - the session's provider; blank or unknown resolves to undefined.
+ * @param capability - capability whose group pin is read.
+ * @returns The complete group pair, or undefined when the group pins nothing here.
+ */
+export declare function groupRoute(settings: RouteBearingSettings | undefined, provider: string | undefined, capability: CapabilityId): CapabilityRoute | undefined;
+/**
+ * The route one capability should use for one session.
+ *
+ * A saved provider group for the session's provider wins; otherwise the flat
+ * deployment default applies. An unknown session provider skips every group, so
+ * a session Model Switch cannot attribute keeps the deployment default.
+ * @param settings - live Model Switch settings.
+ * @param provider - the session's provider, when one is observable.
+ * @param capability - capability being resolved.
+ * @returns The complete pair, or undefined for the capability's official default.
+ */
+export declare function resolveCapabilityRoute(settings: RouteBearingSettings | undefined, provider: string | undefined, capability: CapabilityId): CapabilityRoute | undefined;
+/**
+ * The provider one session is using, from official durable state.
+ *
+ * Preferred source is the session's own model selection (it covers a switch the
+ * client has sent but no request has consumed yet); the logged request-context
+ * and request-header routes cover profiles without the projection package and
+ * replayed sessions that never emitted a selection.
+ * @param ctx - context used for the optional projection read.
+ * @param session - the session to resolve; undefined resolves to undefined.
+ * @returns The provider, or undefined when nothing durable names one.
+ */
+export declare function sessionProviderOf(ctx: Context, session: Session | undefined): string | undefined;
+/**
+ * The subagent route one exact session's spawns should use.
+ * @param ctx - context used for the optional session reads.
+ * @param session - the delegating session; undefined keeps official inherit.
+ * @param settings - live Model Switch settings.
+ * @returns The complete route, or undefined for official inherit.
+ */
+export declare function sessionSubagentRouteOf(ctx: Context, session: Session | undefined, settings: RouteBearingSettings | undefined): SubagentRoute | undefined;

package/lib/types/session-title.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Entry, Loader } from '@deepseek-ai/cordis-plugin-loader';
+import type { SessionTitleAutomaticMode, SessionTitleProviderId, SessionTitleUserMessage } from '@deepseek-ai/dsh-session-title';
+import type { ResolvedSessionTitleLlmConfig, SessionTitleLlmConfig } from '@deepseek-ai/dsh-session-title-llm';
+import { type CapabilityRoute } from './session-route.js';
+/** Cordis plugin identity; matches the cordis.patch.yml insert row id. */
+export declare 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. */
+export declare const inject: string[];
+/** One official cadence package; the row's own package selects which one this profile runs. */
+export interface TitleCadence {
+    /** Official npm package that declares this cadence. */
+    readonly pkg: string;
+    /** Provider id recorded with every generated title; mirrors the official registration. */
+    readonly id: SessionTitleProviderId;
+    /** When the service starts automatic generation. */
+    readonly automatic: SessionTitleAutomaticMode;
+    /** Whether only the first human message is framed into the request. */
+    readonly firstPromptOnly: boolean;
+}
+/** Both official cadence packages, in the order a profile may declare them. */
+export declare const TITLE_CADENCES: readonly TitleCadence[];
+/**
+ * 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.
+ */
+export declare function titleCadence(pkg: string | undefined): TitleCadence | undefined;
+/**
+ * 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.
+ */
+export declare function composeTitleRoute(config: ResolvedSessionTitleLlmConfig, route: CapabilityRoute | undefined): ResolvedSessionTitleLlmConfig;
+/**
+ * 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.
+ */
+export declare function selectTitleMessages(messages: readonly SessionTitleUserMessage[], firstPromptOnly: boolean): readonly SessionTitleUserMessage[];
+/**
+ * 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.
+ */
+export declare function officialTitleEntry(loader: Loader | undefined): Entry | undefined;
+/**
+ * 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.
+ */
+export declare function forwardedConfig(entry: Entry): Partial<SessionTitleLlmConfig>;
+/**
+ * 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.
+ */
+export declare function officialTitlePackage(entry: Entry): string | undefined;
+/**
+ * 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.
+ */
+export declare function apply(ctx: Context): Promise<void>;

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

@@ -1,6 +1,6 @@
 import { Context } from '@deepseek-ai/cordis';
 import OfficialSubagentRuntime, { type ContinuableStart, type ContinuableStartSpec, type SubagentRun, type SubagentStartRequest } from '@deepseek-ai/dsh-subagent';
-import type { ModelSwitchSettings } from './host-settings.js';
+import { type SubagentRoute } from './session-route.js';
 /** Raised only when an explicit startup check finds an unsupported public surface. */
 export declare class StartupIncompatibilityError extends Error {
     readonly name = "StartupIncompatibilityError";
@@ -21,8 +21,19 @@ export interface MountedStartup<T> {
     readonly dispose: () => Promise<void>;
 }
 type RoutableSubagentRequest = Pick<SubagentStartRequest, 'parent' | 'agentOptions'>;
-/** Inject a fixed Default Subagent route, or leave the request for Official inherit. */
-export declare function routeSubagentRequest<T extends RoutableSubagentRequest>(request: T, settings: ModelSwitchSettings): T;
+/**
+ * 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.
+ */
+export declare function routeSubagentRequest<T extends RoutableSubagentRequest>(request: T, route: SubagentRoute | undefined): T;
 /**
  * Mount a candidate and use the fallback only for typed startup incompatibility.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-model-switch",
-  "version": "0.4.23",
+  "version": "0.4.25",
   "description": "Explicit model routing plus composer/Plan picker for DeepSeek Harness",
   "repository": {
     "type": "git",
@@ -46,6 +46,10 @@
       "types": "./lib/types/compaction.d.ts",
       "default": "./lib/compaction.js"
     },
+    "./session-title": {
+      "types": "./lib/types/session-title.d.ts",
+      "default": "./lib/session-title.js"
+    },
     "./subagent-runtime": {
       "types": "./lib/types/subagent-runtime.d.ts",
       "default": "./lib/subagent-runtime.js"
@@ -134,6 +138,10 @@
     "@deepseek-ai/dsh-permission-presets": ">=0.1.7-alpha.2",
     "@deepseek-ai/dsh-plan-mode": ">=0.1.7-alpha.2",
     "@deepseek-ai/dsh-session": ">=0.1.7-alpha.2",
+    "@deepseek-ai/dsh-session-title": ">=0.1.7-alpha.2",
+    "@deepseek-ai/dsh-session-title-all-prompts-llm": ">=0.1.7-alpha.2",
+    "@deepseek-ai/dsh-session-title-first-prompt-llm": ">=0.1.7-alpha.2",
+    "@deepseek-ai/dsh-session-title-llm": ">=0.1.7-alpha.2",
     "@deepseek-ai/dsh-settings": ">=0.1.7-alpha.2",
     "@deepseek-ai/dsh-subagent": ">=0.1.7-alpha.2",
     "@deepseek-ai/dsh-system-prompt": ">=0.1.7-alpha.2",
@@ -210,6 +218,9 @@
     "@deepseek-ai/dsh-session-query": ">=0.1.7-alpha.2",
     "@deepseek-ai/dsh-session-reference": ">=0.1.7-alpha.2",
     "@deepseek-ai/dsh-session-title": ">=0.1.7-alpha.2",
+    "@deepseek-ai/dsh-session-title-all-prompts-llm": ">=0.1.7-alpha.2",
+    "@deepseek-ai/dsh-session-title-first-prompt-llm": ">=0.1.7-alpha.2",
+    "@deepseek-ai/dsh-session-title-llm": ">=0.1.7-alpha.2",
     "@deepseek-ai/dsh-settings": ">=0.1.7-alpha.2",
     "@deepseek-ai/dsh-shell": ">=0.1.7-alpha.2",
     "@deepseek-ai/dsh-skill": ">=0.1.7-alpha.2",
@@ -323,6 +334,18 @@
     "@deepseek-ai/dsh-compaction-basic": {
       "optional": true
     },
+    "@deepseek-ai/dsh-session-title": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session-title-all-prompts-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session-title-first-prompt-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session-title-llm": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-settings": {
       "optional": true
     },

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

@@ -1,4 +0,0 @@
-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/picker/main-default-restore.d.ts

@@ -1,56 +0,0 @@
-/**
- * Compensate the Host's own deployment-default write after a Session-only
- * model switch.
- *
- * `session.selectModel` installs the Session selection and, on Hosts that
- * persist a selection as the deployment default, also writes that default.
- * The plugin switches a Session only, so the captured Main default is restored
- * afterwards.
- *
- * That Host write is fenced by a settings revision, and its timing is not part
- * of the released contract: the 0.1.x generation awaited the default write
- * before its RPC resolved, while the 0.2.x generation fires it without
- * awaiting. A fixed `captured + 1` fence therefore either refuses the restore
- * or silently leaves the default switched. Poll-by-revision is used instead:
- * wait for the observed revision to leave the captured one, then fence on the
- * revision actually observed.
- */
-import type { SettingsPathOpView } from '@deepseek-ai/dsh-api-remotes/client';
-import type { ConfigFormSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client';
-import type { MainSettingsView } from '../../client-contract.ts';
-/** The Main Settings namespace surface this module needs. */
-export interface MainDefaultForm {
-    getSnapshot(): ConfigFormSnapshot<MainSettingsView>;
-    subscribe(listener: () => void): () => void;
-    mutate(ops: readonly SettingsPathOpView[], expectedRevision?: number): Promise<boolean>;
-}
-/** Outcome of one compensation attempt. */
-export interface MainDefaultRestore {
-    /** The captured Main default is the effective one again (or no write occurred). */
-    restored: boolean;
-    /** A newer revision won instead; the concurrent edit is left untouched. */
-    conflict: boolean;
-}
-export interface MainDefaultRestoreOptions {
-    /** Timeout primitive; tests inject a deterministic one. */
-    wait?: (ms: number) => Promise<void>;
-    /** How long to await the unawaited Host default write. */
-    timeoutMs?: number;
-    /** Total fences, including one retry after a concurrent revision change. */
-    attempts?: number;
-}
-/** Field writes restoring one complete Main selection; the Host replaces the section. */
-export declare function mainDefaultOps(selection: MainSettingsView): SettingsPathOpView[];
-/**
- * Restore the Main default captured before a Session-only model switch.
- *
- * Never throws and never blocks a Plan answer: a failed compensation is
- * reported, not enforced, because the Session selection the human asked for is
- * already installed by the time this runs.
- *
- * @param form - the official Main Settings namespace form.
- * @param before - the snapshot captured before the switch.
- * @param options - wait/timeout/attempt overrides for tests.
- * @returns Whether the captured default stands again, and whether a newer edit won.
- */
-export declare function restoreMainDefault(form: MainDefaultForm, before: ConfigFormSnapshot<MainSettingsView>, options?: MainDefaultRestoreOptions): Promise<MainDefaultRestore>;