@klarkxy/dsh-current-title 0.2.0 → 0.2.1

package/lib/client.js

@@ -418,7 +418,7 @@ ${scope} {
   border: 0.5px solid var(--dsw-alias-border-l3);
   border-radius: var(--dsw-radius-md);
   background: var(--dsw-alias-bg-layer-1);
-  font-family: var(--ds-font-family-code, ui-monospace, 'Cascadia Mono', Consolas, monospace);
+  font-family: var(--ds-font-family-code);
   font-size: 12px;
   line-height: 20px;
   color: var(--dsw-alias-label-secondary);
@@ -494,6 +494,162 @@ ${scope} {
 `.replace(/^& (\.dsh-ui-[a-z0-9-]+)(?![+>~])/gm, (_match, className) => `&${className}, & ${className}`);
 }
 //#endregion
+//#region ../dsh-plugin-kit/src/contracts.ts
+/**
+* Remote contribution for model-settings change notifications.
+* Provided by `@klarkxy/dsh-model-hub` (`ModelSettingsChangesController`);
+* subscribers degrade silently when that package is not installed.
+* The stream carries invalidations only — `ready` is never a settings snapshot.
+*/
+const MODEL_SETTINGS_CHANGES_REMOTE = {
+	package: "@klarkxy/dsh-model-hub",
+	descriptors: [{
+		id: "modelSettingsChanges/watch",
+		service: "modelSettingsChangesController",
+		namespace: "modelSettingsChanges",
+		method: "watch",
+		mode: "stream",
+		invocation: { kind: "direct" },
+		parameters: [],
+		cancellation: { parameter: "signal" }
+	}]
+};
+//#endregion
+//#region ../dsh-plugin-kit/src/model-settings-client.ts
+/** This stream carries invalidations only; ready is never a settings snapshot. */
+function parseModelSettingsChangeFrame(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("Invalid model settings change frame");
+	const frame = value;
+	if (frame.kind === "ready" && Object.keys(frame).length === 1) return { kind: "ready" };
+	if (frame.kind === "changed" && Object.keys(frame).length === 3 && typeof frame.ns === "string" && frame.ns.length > 0 && typeof frame.revision === "number" && Number.isSafeInteger(frame.revision) && frame.revision >= 0) return {
+		kind: "changed",
+		ns: frame.ns,
+		revision: frame.revision
+	};
+	throw new Error("Invalid model settings change frame");
+}
+MODEL_SETTINGS_CHANGES_REMOTE.package, MODEL_SETTINGS_CHANGES_REMOTE.descriptors.map((descriptor) => ({
+	...descriptor,
+	result: {
+		mode: "strict",
+		typeSymbol: "ModelSettings.ChangeFrame",
+		create: () => ({ parse: parseModelSettingsChangeFrame })
+	}
+}));
+/** Native RemoteStream owns carrier reconnects; no timers or browser transport.
+* A factory shares one logical stream while at least one subscriber remains. */
+function createModelSettingsSubscriber(ctx, namespace) {
+	const listeners = /* @__PURE__ */ new Set();
+	let injection;
+	let current;
+	let lifecycle = 0;
+	let failureMessage;
+	const report = (message) => {
+		failureMessage = message;
+		for (const listener of [...listeners]) try {
+			listener.error?.(message);
+		} catch {}
+	};
+	const invalidate = () => {
+		for (const listener of [...listeners]) {
+			if (!listeners.has(listener)) continue;
+			try {
+				listener.change();
+			} catch (error) {
+				try {
+					listener.error?.(error instanceof Error ? error.message : String(error));
+				} catch {}
+			}
+		}
+	};
+	const start = () => {
+		const life = ++lifecycle;
+		injection = ctx.inject(["remote", "remote.modelSettingsChanges"], (injected) => {
+			if (life !== lifecycle || !listeners.size) return;
+			const scope = injected;
+			const stream = scope.remote.$stream({
+				name: "Model settings sync",
+				open: (signal) => scope.remote.modelSettingsChanges.watch(signal),
+				ended: (accepted) => /* @__PURE__ */ new Error(`Model settings sync stream ended ${accepted ? "after" : "before"} ready; refresh or reopen the page`)
+			});
+			const session = {
+				stream,
+				active: true
+			};
+			current = session;
+			scope.effect(() => () => {
+				session.active = false;
+				if (current === session) {
+					current = void 0;
+					if (life === lifecycle && listeners.size) report("Model settings sync service unavailable");
+				}
+				return stream.dispose();
+			});
+			(async () => {
+				let generation;
+				let ready = false;
+				try {
+					for await (const item of stream) {
+						if (!session.active || life !== lifecycle || !listeners.size) break;
+						if (item.signal.aborted) continue;
+						if (generation !== item.generation) {
+							generation = item.generation;
+							ready = false;
+						}
+						const frame = parseModelSettingsChangeFrame(item.value);
+						if (frame.kind === "ready") {
+							ready = true;
+							failureMessage = void 0;
+							item.accept();
+							invalidate();
+						} else {
+							if (!ready) throw new Error("Model settings sync change arrived before ready");
+							if (namespace === "*" || frame.ns === namespace) invalidate();
+						}
+					}
+				} catch (error) {
+					if (session.active && life === lifecycle) report(error instanceof Error ? error.message : String(error));
+				} finally {
+					if (current === session) current = void 0;
+					session.active = false;
+					await stream.dispose().catch(() => {});
+				}
+			})();
+		});
+		queueMicrotask(() => {
+			if (life === lifecycle && listeners.size && !current) report("Model settings sync service unavailable");
+		});
+	};
+	return Object.freeze({ subscribe(onChange, onError) {
+		const listener = {
+			change: onChange,
+			error: onError
+		};
+		listeners.add(listener);
+		if (!injection) start();
+		else if (failureMessage) queueMicrotask(() => {
+			if (listeners.has(listener) && failureMessage) try {
+				listener.error?.(failureMessage);
+			} catch {}
+		});
+		return () => {
+			if (!listeners.delete(listener) || listeners.size) return;
+			lifecycle++;
+			if (current) {
+				current.active = false;
+				current.stream.dispose().catch(() => {});
+			}
+			current = void 0;
+			failureMessage = void 0;
+			const previous = injection;
+			injection = void 0;
+			try {
+				Promise.resolve(previous?.dispose()).catch(() => {});
+			} catch {}
+		};
+	} });
+}
+//#endregion
 //#region src/contracts.ts
 const RPC_CHANNEL = "/dsh-current-title";
 const TITLE_CLIENT_SERVICE = "dshCurrentTitleClient";
@@ -517,7 +673,11 @@ const titleCopy = {
 		cadenceFirst: "仅首条消息",
 		saved: "已保存。",
 		failed: "无法读取标题设置。",
-		inactive: "标题服务未接管，新消息暂时不会自动更新。"
+		inactive: "标题服务未接管，新消息暂时不会自动更新。",
+		retry: "重试",
+		externalChange: "设置已在别处修改。提示词草稿已保留，请重新加载后确认。",
+		syncUnavailable: "自动刷新不可用，请手动重新加载设置。",
+		reload: "重新加载（丢弃草稿）"
 	},
 	en: {
 		label: "Auto Title",
@@ -536,9 +696,33 @@ const titleCopy = {
 		cadenceFirst: "First message only",
 		saved: "Saved.",
 		failed: "Could not read title settings.",
-		inactive: "Title generation is not active, so new messages will not rename this session."
+		inactive: "Title generation is not active, so new messages will not rename this session.",
+		retry: "Retry",
+		externalChange: "Settings changed elsewhere. Prompt draft preserved; reload and review.",
+		syncUnavailable: "Automatic refresh unavailable; reload settings manually.",
+		reload: "Reload (discard draft)"
 	}
 };
+/** Only plugin-owned defaults are translated; model output and remote diagnostics stay intact. */
+const titleMessages = [
+	["标题设置无效。", "Invalid title settings."],
+	["设置已更新，请刷新后重试。", "Settings changed. Refresh and try again."],
+	["无法保存标题设置。", "Could not save title settings."],
+	["缺少会话。", "A session is required."],
+	["找不到该会话。", "Session not found."],
+	["标题服务未就绪。", "Title service is not ready."],
+	["已取消。", "Cancelled."],
+	["标题生成失败。", "Title generation failed."],
+	["未知操作。", "Unknown operation."],
+	["缺少所需的宿主服务。", "required host services are missing"],
+	["原生标题服务位置已被占用。", "native title provider slot is occupied"],
+	["其他标题服务已接管；先前的服务未恢复。", "another title provider owns the slot; previous owner was not restored"],
+	[titleCopy.zh.saved, titleCopy.en.saved],
+	[titleCopy.zh.failed, titleCopy.en.failed]
+];
+function titleMessage(message, locale) {
+	return titleMessages.find((pair) => pair.includes(message))?.[locale === "zh" ? 0 : 1] ?? message;
+}
 /** `undefined` draft = not edited; an empty string is a real edit (use built-in instruction). */
 function promptFieldValue(draft, saved) {
 	return draft ?? saved;
@@ -705,12 +889,21 @@ function TitleSettings(props) {
 	const seat = useNativeSeat(props.client);
 	const sessionId = seat.sessionId;
 	const text = titleCopy[seat.locale];
+	const messages = titleCopy.en;
 	const [status, setStatus] = (0, react.useState)();
 	const [busy, setBusy] = (0, react.useState)(false);
 	const [note, setNote] = (0, react.useState)("");
 	const [error, setError] = (0, react.useState)("");
 	const [prompt, setPrompt] = (0, react.useState)(void 0);
 	const [choices, setChoices] = (0, react.useState)([]);
+	const [externalChange, setExternalChange] = (0, react.useState)(false);
+	const [syncError, setSyncError] = (0, react.useState)("");
+	const [loadingSettings, setLoadingSettings] = (0, react.useState)(true);
+	const dirty = (0, react.useRef)(false);
+	const external = (0, react.useRef)(false);
+	const reading = (0, react.useRef)(false);
+	const pending = (0, react.useRef)(false);
+	const syncRef = (0, react.useRef)(() => {});
 	const workRef = (0, react.useRef)(void 0);
 	if (!workRef.current) workRef.current = createTitleClientWork();
 	const work = workRef.current;
@@ -719,6 +912,11 @@ function TitleSettings(props) {
 	const readGate = readGateRef.current;
 	const busyRef = (0, react.useRef)(busy);
 	busyRef.current = busy;
+	const changeBusy = (value) => {
+		busyRef.current = value;
+		setBusy(value);
+		if (!value && pending.current) syncRef.current();
+	};
 	const call = (endpoint, payload = {}) => props.client.connection.rpc.call(RPC_CHANNEL, endpoint, payload);
 	const readCall = (endpoint, payload) => readGate.run(() => call(endpoint, payload));
 	function commitMarker(next) {
@@ -731,6 +929,8 @@ function TitleSettings(props) {
 	(0, react.useEffect)(() => props.client.connection.generation?.subscribe(() => {
 		readGate.reset();
 		work.beginLoad();
+		reading.current = false;
+		setLoadingSettings(false);
 		busyRef.current = false;
 		setBusy(false);
 	}), [
@@ -760,6 +960,9 @@ function TitleSettings(props) {
 	]);
 	(0, react.useEffect)(() => {
 		const generation = work.beginLoad();
+		reading.current = true;
+		pending.current = false;
+		setLoadingSettings(true);
 		readGate.reset();
 		const isCurrent = () => work.isLoad(generation);
 		setBusy(false);
@@ -769,10 +972,22 @@ function TitleSettings(props) {
 			call: readCall,
 			sessionId: sessionId || void 0,
 			isCurrent,
-			failedMessage: text.failed,
-			onStatus: setStatus,
-			onError: setError,
+			failedMessage: messages.failed,
+			onStatus: (next) => {
+				if (!pending.current) setStatus((current) => current && external.current ? {
+					...next,
+					settings: current.settings
+				} : next);
+			},
+			onError: (message) => {
+				if (!pending.current) setError(message);
+			},
 			onMarker: commitMarker
+		}).finally(() => {
+			if (!work.isLoad(generation)) return;
+			reading.current = false;
+			setLoadingSettings(false);
+			if (pending.current) syncRef.current();
 		});
 		return () => {
 			if (work.isLoad(generation)) work.beginLoad();
@@ -781,49 +996,95 @@ function TitleSettings(props) {
 		props.client,
 		props.marker,
 		sessionId,
-		text.failed,
 		work
 	]);
 	const refreshStatus = (0, react.useCallback)(() => {
 		if (!readGate.canRead() || shouldSkipTitleRefresh({ busy: busyRef.current }) || work.disposed) return;
+		if (reading.current) return;
+		reading.current = true;
+		setLoadingSettings(true);
 		readGate.reset();
 		const token = work.beginRequest();
 		runTitleStatusLoad({
 			call: readCall,
 			sessionId: sessionId || void 0,
 			isCurrent: () => work.isRequest(token) && !shouldSkipTitleRefresh({ busy: busyRef.current }),
-			failedMessage: text.failed,
+			failedMessage: messages.failed,
 			onStatus: (next) => {
-				if (shouldSkipTitleRefresh({ busy: busyRef.current })) return;
-				setStatus(next);
+				if (pending.current || shouldSkipTitleRefresh({ busy: busyRef.current })) return;
+				setStatus((current) => current && external.current ? {
+					...next,
+					settings: current.settings
+				} : next);
 				setError("");
 			},
-			onError: setError,
+			onError: (message) => {
+				if (!pending.current) setError(message);
+			},
 			onMarker: (next) => {
 				if (!next || shouldSkipTitleRefresh({ busy: busyRef.current })) return;
 				commitMarker(next);
 			}
+		}).finally(() => {
+			if (!work.isRequest(token)) return;
+			reading.current = false;
+			setLoadingSettings(false);
+			if (pending.current) syncRef.current();
 		});
 	}, [
 		props.client,
 		props.marker,
 		sessionId,
-		text.failed,
 		work
 	]);
 	useFeatureRefresh(props.client, sessionId, refreshStatus, status?.session?.generating === true && !busy, Boolean(sessionId));
+	syncRef.current = () => {
+		if (work.disposed) return;
+		if (reading.current || busyRef.current) {
+			pending.current = true;
+			return;
+		}
+		pending.current = false;
+		if (dirty.current) {
+			external.current = true;
+			setExternalChange(true);
+			return;
+		}
+		readGate.reset();
+		refreshStatus();
+	};
+	(0, react.useEffect)(() => {
+		setSyncError("");
+		let live = true;
+		const stop = props.subscribeSettings?.(() => {
+			if (!live) return;
+			setSyncError("");
+			if (dirty.current && !busyRef.current) {
+				external.current = true;
+				setExternalChange(true);
+			}
+			syncRef.current();
+		}, (message) => {
+			if (live) setSyncError(message);
+		});
+		return () => {
+			live = false;
+			stop?.();
+		};
+	}, [props.subscribeSettings, props.client]);
 	const savedPrompt = status?.settings.prompt ?? "";
 	const savedModel = status?.settings.model ?? {
 		provider: "",
 		model: ""
 	};
+	const selectableChoices = choices.some((choice) => choice.provider === savedModel.provider && choice.model === savedModel.model) ? choices : [...choices, ...catalogChoices({}, savedModel)];
 	const modelKey = savedModel.provider && savedModel.model ? `${savedModel.provider}\u001f${savedModel.model}` : "";
 	const title = status?.session?.title;
 	const pinned = status?.session?.pinned === true;
 	const weOwn = status?.support.weOwn === true;
-	const canRegenerate = Boolean(sessionId) && weOwn && !busy;
+	const canRegenerate = Boolean(sessionId) && weOwn && !busy && !loadingSettings;
 	function saveSettings(patch) {
-		if (!status) return;
+		if (!status || busyRef.current || reading.current || external.current) return;
 		readGate.reset();
 		const token = work.beginRequest();
 		setError("");
@@ -833,9 +1094,9 @@ function TitleSettings(props) {
 			...patch,
 			expectedRevision: status.settings.revision,
 			isCurrent: () => work.isRequest(token),
-			savedMessage: text.saved,
-			failedMessage: text.failed,
-			onBusy: setBusy,
+			savedMessage: messages.saved,
+			failedMessage: messages.failed,
+			onBusy: changeBusy,
 			onSettings: (settings) => setStatus((current) => current ? {
 				...current,
 				settings
@@ -846,6 +1107,7 @@ function TitleSettings(props) {
 	}
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 		className: "current-title-settings ct-root dsh-ui-panel",
+		lang: seat.locale,
 		"data-testid": "current-title-settings",
 		children: [
 			!status && !error ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
@@ -870,12 +1132,12 @@ function TitleSettings(props) {
 			status && !weOwn ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
 				role: "status",
 				className: "dsh-ui-hint",
-				children: [text.inactive, status.support.limitation ? ` ${status.support.limitation}` : ""]
+				children: [text.inactive, status.support.limitation ? ` ${titleMessage(status.support.limitation, seat.locale)}` : ""]
 			}) : null,
 			error ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 				role: "alert",
 				className: "dsh-ui-error dsh-ui-wrap",
-				children: error
+				children: titleMessage(error, seat.locale)
 			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
 				variant: "outline",
 				size: "sm",
@@ -884,16 +1146,39 @@ function TitleSettings(props) {
 					readGate.reset();
 					refreshStatus();
 				},
-				children: seat.locale === "zh" ? "重试" : "Retry"
+				children: text.retry
 			})] }) : null,
 			note ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 				role: "status",
 				className: "dsh-ui-notice",
-				children: note
+				children: titleMessage(note, seat.locale)
+			}) : null,
+			externalChange ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				role: "alert",
+				className: "dsh-ui-error",
+				children: text.externalChange
+			}) : null,
+			syncError ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				role: "status",
+				className: "dsh-ui-hint",
+				children: text.syncUnavailable
 			}) : null,
-			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "dsh-ui-actions",
-				children: sessionId ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+					variant: "ghost",
+					size: "sm",
+					disabled: busy || loadingSettings,
+					onClick: () => {
+						setPrompt(void 0);
+						dirty.current = false;
+						external.current = false;
+						setExternalChange(false);
+						readGate.reset();
+						syncRef.current();
+					},
+					children: text.reload
+				}), sessionId ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
 					variant: "outline",
 					size: "md",
 					disabled: !canRegenerate,
@@ -907,15 +1192,15 @@ function TitleSettings(props) {
 							call,
 							sessionId,
 							isCurrent: () => work.isRequest(token),
-							failedMessage: text.failed,
-							onBusy: setBusy,
+							failedMessage: messages.failed,
+							onBusy: changeBusy,
 							onStatus: setStatus,
 							onError: setError,
 							onMarker: commitMarker
 						});
 					},
 					children: text.regenerate
-				}) : null
+				}) : null]
 			}),
 			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
 				className: "dsh-ui-field",
@@ -929,15 +1214,17 @@ function TitleSettings(props) {
 						value: status ? promptFieldValue(prompt, savedPrompt) : "",
 						maxLength: 4e3,
 						rows: 5,
-						disabled: busy || !status,
+						disabled: busy || loadingSettings || !status,
 						onChange: (event) => {
+							dirty.current = true;
 							setPrompt(event.target.value);
 							setNote("");
 						},
 						onBlur: () => {
-							if (!status) return;
+							if (!status || busyRef.current || reading.current || external.current) return;
 							const next = promptToSave(prompt, savedPrompt);
 							if (next === void 0) {
+								dirty.current = false;
 								setPrompt(void 0);
 								return;
 							}
@@ -949,14 +1236,15 @@ function TitleSettings(props) {
 								prompt: next,
 								expectedRevision: status.settings.revision,
 								isCurrent: () => work.isRequest(token),
-								savedMessage: text.saved,
-								failedMessage: text.failed,
-								onBusy: setBusy,
+								savedMessage: messages.saved,
+								failedMessage: messages.failed,
+								onBusy: changeBusy,
 								onSettings: (settings) => {
 									setStatus((current) => current ? {
 										...current,
 										settings
 									} : current);
+									dirty.current = false;
 									setPrompt(void 0);
 								},
 								onNote: setNote,
@@ -978,10 +1266,10 @@ function TitleSettings(props) {
 				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
 					className: "dsh-ui-select",
 					value: modelKey,
-					disabled: busy || !status,
+					disabled: busy || loadingSettings || !status,
 					onChange: (event) => {
 						const value = event.target.value;
-						const choice = choices.find((item) => `${item.provider}\u001f${item.model}` === value);
+						const choice = selectableChoices.find((item) => `${item.provider}\u001f${item.model}` === value);
 						saveSettings({ model: choice ? {
 							provider: choice.provider,
 							model: choice.model
@@ -993,7 +1281,7 @@ function TitleSettings(props) {
 					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
 						value: "",
 						children: text.modelDefault
-					}), choices.map((choice) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+					}), selectableChoices.map((choice) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
 						value: `${choice.provider}\u001f${choice.model}`,
 						children: choice.label
 					}, `${choice.provider}\u001f${choice.model}`))]
@@ -1007,7 +1295,7 @@ function TitleSettings(props) {
 				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
 					className: "dsh-ui-select",
 					value: status?.settings.cadence ?? "all-prompts",
-					disabled: busy || !status,
+					disabled: busy || loadingSettings || !status,
 					onChange: (event) => {
 						saveSettings({ cadence: event.target.value === "first-prompt" ? "first-prompt" : "all-prompts" });
 					},
@@ -1045,6 +1333,8 @@ const styles = `${officialUiCss("ct-root")}
 `;
 function apply(ctx) {
 	const client = ctx;
+	const settingsSubscriber = createModelSettingsSubscriber(ctx, "@klarkxy/dsh-current-title");
+	const subscribeSettings = (change, error) => settingsSubscriber.subscribe(change, error);
 	const marker = createTitleClientMarker();
 	ctx.provide(TITLE_CLIENT_SERVICE, marker);
 	ctx.effect(() => {
@@ -1060,7 +1350,8 @@ function apply(ctx) {
 		key: "@klarkxy/dsh-current-title"
 	}, () => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TitleSettings, {
 		client,
-		marker
+		marker,
+		subscribeSettings
 	}))), "current-title.settings");
 	ctx.effect(() => {
 		let live = true;

package/lib/contracts.d.ts

@@ -1,3 +1,4 @@
+import { ModelRoute, defaultModelRoute, normalizeModelRoute } from "@klarkxy/dsh-model-route";
 import { RpcResult } from "@klarkxy/dsh-plugin-kit/contracts";
 //#region src/contracts.d.ts
 declare const PLUGIN_NAME = "@klarkxy/dsh-current-title";
@@ -36,12 +37,12 @@ interface TitleSnapshot {
   readonly eventSeq: number;
   readonly updatedAt: number;
 }
-/** Empty provider and model means the shared weak role. Both must be set together. */
-interface TitleModelRoute {
-  provider: string;
-  model: string;
-  reasoningEffort?: string;
-}
+/**
+ * Empty provider and model means the shared weak role. Both must be set together.
+ * No title-only fields: the stored value is the shared ModelRoute (250/80 caps
+ * live in @klarkxy/dsh-model-route). The alias keeps the title-specific name.
+ */
+type TitleModelRoute = ModelRoute;
 interface TitleSettings {
   revision: number;
   locale: TitleLocaleMode;
@@ -79,11 +80,9 @@ interface GenerateConfig {
   readonly timeoutMs: number;
   readonly maxTitleBytes: number;
 }
-declare function defaultModelRoute(): TitleModelRoute;
 declare function defaultSettings(locale?: TitleLocaleMode): TitleSettings;
 declare function normalizeCadence(value: unknown): TitleCadence;
 declare function normalizePrompt(value: unknown): string;
-declare function normalizeModelRoute(value: unknown): TitleModelRoute;
 declare function defaultGenerateConfig(locale?: TitleLocaleMode): GenerateConfig;
 declare function isTitleLocaleMode(value: unknown): value is TitleLocaleMode;
 //#endregion

package/lib/contracts.js

@@ -1,3 +1,4 @@
+import { defaultModelRoute, normalizeModelRoute } from "@klarkxy/dsh-model-route";
 //#region src/contracts.ts
 const PLUGIN_NAME = "@klarkxy/dsh-current-title";
 const FEATURE_ID = "current-title";
@@ -17,12 +18,6 @@ const DEFAULT_MAX_INPUT_BYTES = 4096;
 const DEFAULT_MAX_OUTPUT_TOKENS = 256;
 const DEFAULT_TIMEOUT_MS = 6e4;
 const DEFAULT_MAX_TITLE_BYTES = 80;
-function defaultModelRoute() {
-	return {
-		provider: "",
-		model: ""
-	};
-}
 function defaultSettings(locale = "auto") {
 	return {
 		revision: 0,
@@ -39,22 +34,6 @@ function normalizePrompt(value) {
 	if (typeof value !== "string") return "";
 	return value.replace(/\u0000/gu, "").trim().slice(0, MAX_PROMPT_CHARS);
 }
-function normalizeModelRoute(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return defaultModelRoute();
-	const route = value;
-	const provider = typeof route.provider === "string" ? route.provider.trim() : "";
-	const model = typeof route.model === "string" ? route.model.trim() : "";
-	const effort = typeof route.reasoningEffort === "string" ? route.reasoningEffort.trim() : "";
-	if (!provider || !model || provider.length > 250 || model.length > 250) return defaultModelRoute();
-	return effort && effort.length <= 80 ? {
-		provider,
-		model,
-		reasoningEffort: effort
-	} : {
-		provider,
-		model
-	};
-}
 function defaultGenerateConfig(locale = "auto") {
 	return {
 		maxRecentMessages: 8,