@klarkxy/dsh-model-hub 0.1.1 → 0.1.3

package/lib/client.js

@@ -67,12 +67,68 @@ function normalizeModelRoute(value) {
 }
 //#endregion
 //#region ../dsh-model-route/src/catalog.ts
+/** Both services are required: Cordis checks the nested namespace separately. */
+const MODEL_CATALOG_INJECT = ["remote", "remote.session"];
 function asRecord(value) {
 	return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
 function asText(value) {
 	return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
+/** A useful diagnostic even when a transport rejects with a plain object. */
+function modelCatalogErrorMessage(value) {
+	if (value instanceof Error && value.message) return value.message;
+	return asText(asRecord(value)?.message) ?? asText(value) ?? "Unable to load the model catalog.";
+}
+/**
+* Validate and unwrap a successful catalog without discarding provider failures
+* or newer host metadata. Names and metadata remain optional for older hosts.
+* A broken response is never presented as a successfully loaded empty menu.
+*/
+function checkedModelCatalog(value) {
+	const envelope = asRecord(value);
+	if (envelope?.ok === false) throw new Error(modelCatalogErrorMessage(envelope.error ?? envelope));
+	const root = envelope?.ok === true ? asRecord(envelope.value) : envelope;
+	const malformed = (field) => {
+		throw new Error(`Invalid model catalog: ${field}.`);
+	};
+	if (!root || !Array.isArray(root.groups)) return malformed("groups must be an array");
+	for (const value of root.groups) {
+		const group = asRecord(value);
+		if (!group || !asText(group.id) || !Array.isArray(group.models)) return malformed("each group needs an id and models array");
+		for (const value of group.models) {
+			const model = asRecord(value);
+			if (!model || !asText(model.id)) return malformed("each model needs an id");
+			if (model.reasoning !== void 0) {
+				const reasoning = asRecord(model.reasoning);
+				if (!reasoning || !Array.isArray(reasoning.efforts) || reasoning.efforts.some((value) => !parseEffort(value))) return malformed("reasoning efforts must be an array of identified efforts");
+			}
+		}
+	}
+	if (root.failures !== void 0 && (!Array.isArray(root.failures) || root.failures.some((value) => {
+		const failure = asRecord(value);
+		return !failure || !asText(failure.id) || typeof failure.name !== "string" || typeof failure.message !== "string";
+	}))) return malformed("failures must be an array of provider failures");
+	return root;
+}
+/** Read through the injected session namespace; absence and rejection are errors. */
+async function readModelCatalog(client) {
+	const session = client.remote?.session;
+	if (typeof session?.modelCatalog !== "function") throw new Error("Model catalog unavailable: inject both remote and remote.session.");
+	return checkedModelCatalog(await session.modelCatalog());
+}
+/** Provider failures are partial results, not a transport failure. */
+function modelCatalogFailures(value) {
+	try {
+		return checkedModelCatalog(value).failures ?? [];
+	} catch {
+		return [];
+	}
+}
+/** Text adapter for existing model-hub status messages. */
+function catalogFailures(value) {
+	return modelCatalogFailures(value).map((failure) => `${failure.name || failure.id}: ${failure.message}`);
+}
 function parseEffort(value) {
 	const row = asRecord(value);
 	const id = row ? asText(row.id) : void 0;
@@ -169,6 +225,59 @@ function groupModelMenuChoices(choices, query) {
 	return groups;
 }
 //#endregion
+//#region ../dsh-model-route/src/catalog-ui.tsx
+/** Also accepts a mapped state from a caller that owns broader async orchestration. */
+function ModelCatalogStatus({ state, locale }) {
+	const zh = locale?.toLowerCase().startsWith("zh") === true;
+	const copy = zh ? {
+		loading: "正在加载模型…",
+		error: "模型列表加载失败",
+		partial: "部分提供商的模型未能加载",
+		retry: "重试"
+	} : {
+		loading: "Loading models…",
+		error: "Unable to load models",
+		partial: "Some providers could not load their models",
+		retry: "Retry"
+	};
+	if (!state.loading && !state.error && state.failures.length === 0) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "dsh-model-catalog-status",
+		lang: zh ? "zh" : "en",
+		children: [
+			state.loading ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				role: "status",
+				children: copy.loading
+			}) : null,
+			state.error ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+				role: "alert",
+				children: [
+					copy.error,
+					": ",
+					state.error
+				]
+			}) : null,
+			state.failures.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				role: "status",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: copy.partial }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", { children: state.failures.map((failure, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", { children: [
+					failure.name || failure.id,
+					": ",
+					failure.message
+				] }, `${failure.id}:${index}`)) })]
+			}) : null,
+			state.error || state.failures.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+				type: "button",
+				size: "sm",
+				disabled: state.loading,
+				onClick: () => {
+					state.refresh();
+				},
+				children: copy.retry
+			}) : null
+		]
+	});
+}
+//#endregion
 //#region ../dsh-model-route/src/ui.tsx
 /**
 * ModelMenu: the standard editor of one model-route field — the visible half
@@ -1178,6 +1287,29 @@ ${scope} {
 & .dsh-ui-select:disabled { color: var(--dsw-alias-label-tertiary); cursor: default; }
 & .dsh-ui-select[aria-invalid='true'] { border-color: var(--dsw-alias-state-error-primary); }
 
+/* --- Native textarea. The primitives ship no textarea either, so a settings
+ * prompt keeps the platform element and the same field shell as the select:
+ * 0.5px l4, radius-md, layer-3, 13/1.5 type. It grows vertically instead of
+ * locking to the select's 34px row. --- */
+& .dsh-ui-textarea {
+  box-sizing: border-box;
+  width: 100%;
+  min-width: 0;
+  resize: vertical;
+  padding: 8px 12px;
+  border: 0.5px solid var(--dsw-alias-border-l4);
+  border-radius: var(--dsw-radius-md);
+  background: var(--dsw-alias-bg-layer-3);
+  font: inherit;
+  font-size: 13px;
+  line-height: 1.5;
+  color: var(--dsw-alias-label-primary);
+}
+& .dsh-ui-textarea:focus-visible { outline: none; border-color: var(--dsw-alias-state-business-primary); }
+& .dsh-ui-textarea:disabled { color: var(--dsw-alias-label-tertiary); cursor: default; }
+& .dsh-ui-textarea::placeholder { color: var(--dsw-alias-label-dimmed); }
+& .dsh-ui-textarea[aria-invalid='true'] { border-color: var(--dsw-alias-state-error-primary); }
+
 /* Long panels scroll inside themselves instead of growing the host page. */
 & .dsh-ui-panel { display: flex; flex-direction: column; gap: 16px; min-width: 0; }
 & .dsh-ui-panel-wide { max-width: 100%; }
@@ -1435,20 +1567,6 @@ function messageOf(error) {
 	if (error && typeof error === "object" && "message" in error) return String(error.message);
 	return String(error);
 }
-function checkedCatalog(value) {
-	if (value && typeof value === "object" && "ok" in value && value.ok === false) throw new Error("error" in value ? messageOf(value.error) : "Request failed");
-	return value;
-}
-function catalogFailures(value) {
-	if (!value || typeof value !== "object") return [];
-	const root = "ok" in value && value.ok === true && "value" in value ? value.value : value;
-	if (!root || typeof root !== "object" || !("failures" in root) || !Array.isArray(root.failures)) return [];
-	return root.failures.map((failure) => {
-		if (!failure || typeof failure !== "object") return messageOf(failure);
-		const provider = "name" in failure ? failure.name : "id" in failure ? failure.id : "provider" in failure ? failure.provider : "";
-		return provider ? `${provider}: ${messageOf(failure)}` : messageOf(failure);
-	});
-}
 //#endregion
 //#region src/client-copy.ts
 function hubText(value, language) {
@@ -1553,7 +1671,6 @@ const TEXT$1 = {
 		loading: "正在读取…",
 		failed: (message) => `读取失败：${message}`,
 		syncFailed: (message) => `自动同步不可用：${message}`,
-		catalogFailed: (message) => `模型列表读取失败：${message}`,
 		writeFailed: (message) => `未保存：${message}。请刷新后重试。`,
 		saved: "已保存，正在刷新…",
 		savedRefreshFailed: (message) => `已保存；阵容刷新失败：${message}。请刷新以读取最新设置。`,
@@ -1576,7 +1693,13 @@ const TEXT$1 = {
 		effortDefault: "默认",
 		searchModels: "搜索模型…",
 		noModels: "没有匹配的模型",
-		clearSearch: "清除搜索"
+		clearSearch: "清除搜索",
+		runningTitle: "运行中的子代理",
+		runningEmpty: "当前没有运行中的子代理。",
+		runningPending: "尚未发起模型请求",
+		runningRemote: "远程子代理，无法读取路由",
+		runningFailed: (message) => `运行状态读取失败：${message}`,
+		effortAdapterDefault: (effort) => `${effort}（适配器默认）`
 	},
 	en: {
 		title: "Subagent Cast",
@@ -1585,7 +1708,6 @@ const TEXT$1 = {
 		loading: "Loading…",
 		failed: (message) => `Load failed: ${message}`,
 		syncFailed: (message) => `Live sync unavailable: ${message}`,
-		catalogFailed: (message) => `Model list failed: ${message}`,
 		writeFailed: (message) => `Not saved: ${message}. Refresh, then try again.`,
 		saved: "Saved; refreshing…",
 		savedRefreshFailed: (message) => `Saved; cast refresh failed: ${message}. Refresh to read the latest settings.`,
@@ -1608,7 +1730,13 @@ const TEXT$1 = {
 		effortDefault: "Default",
 		searchModels: "Search models…",
 		noModels: "No matching models",
-		clearSearch: "Clear search"
+		clearSearch: "Clear search",
+		runningTitle: "Running subagents",
+		runningEmpty: "No subagents are running.",
+		runningPending: "No model request yet",
+		runningRemote: "Remote subagent; route unavailable",
+		runningFailed: (message) => `Running state failed: ${message}`,
+		effortAdapterDefault: (effort) => `${effort} (adapter default)`
 	}
 };
 function useText$1(locale) {
@@ -1631,6 +1759,11 @@ const castCss = `
 .dsh-model-hub .cast-banner{display:flex;gap:12px;align-items:center;justify-content:space-between;flex-wrap:wrap}
 .dsh-model-hub .cast-add{display:flex}
 .dsh-model-hub .cast-add .dsh-model-menu-root{max-width:100%}
+.dsh-model-hub .cast-running{margin-top:16px}
+.dsh-model-hub .cast-running-title{font-size:14px;line-height:22px;font-weight:600;margin:0 0 4px;color:var(--dsw-alias-label-primary)}
+.dsh-model-hub .cast-running-row{display:flex;gap:12px;align-items:baseline;flex-wrap:wrap;padding:6px 0;border-bottom:.5px solid var(--dsw-alias-border-l1)}
+.dsh-model-hub .cast-running-label{font-size:13px;line-height:20px;color:var(--dsw-alias-label-primary);overflow-wrap:anywhere;min-width:0}
+.dsh-model-hub .cast-running-route{font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary);overflow-wrap:anywhere;min-width:0}
 @media(max-width:520px){.dsh-model-hub .cast-row{grid-template-columns:minmax(0,1fr);gap:8px}}
 `;
 /** CAS rejections all carry a refresh hint in either language. */
@@ -1654,6 +1787,14 @@ function routeInput(route) {
 		model: normalized.model
 	};
 }
+/** One live subagent row: label (or short id) plus its effective route. */
+function runningRouteText(entry, t) {
+	if (!entry.local) return t("runningRemote");
+	const route = entry.route;
+	if (!route) return t("runningPending");
+	const effort = route.reasoningEffort ? entry.effortIsAdapterDefault ? t("effortAdapterDefault", route.reasoningEffort) : route.reasoningEffort : "";
+	return `${route.provider} / ${route.model}${effort ? ` · ${effort}` : ""}`;
+}
 /** One cast entry: model picker, tendency input saved on blur, remove button. */
 function CastRow({ t, catalog, route, tendencyRevision, draftReview, disabled, tendencyDisabled, menuDisabled, onSetRoute, onSetTendency, onRemove }) {
 	const label = `${route.provider} / ${route.model}`;
@@ -1737,6 +1878,8 @@ function CastPage({ api, locale }) {
 	const t = useText$1(locale);
 	const [cast, setCast] = (0, react.useState)(null);
 	const [catalog, setCatalog] = (0, react.useState)(null);
+	const [running, setRunning] = (0, react.useState)(null);
+	const [runningError, setRunningError] = (0, react.useState)("");
 	const [loadError, setLoadError] = (0, react.useState)("");
 	const [catalogError, setCatalogError] = (0, react.useState)("");
 	const [syncError, setSyncError] = (0, react.useState)("");
@@ -1756,7 +1899,11 @@ function CastPage({ api, locale }) {
 		scope.queued = false;
 		scope.busy = true;
 		setRefreshing(true);
-		const [castResult, models] = await Promise.allSettled([Promise.resolve().then(() => scope.api.getCast()), Promise.resolve().then(() => scope.api.modelCatalog()).then(checkedCatalog)]);
+		const [castResult, models, live] = await Promise.allSettled([
+			Promise.resolve().then(() => scope.api.getCast()),
+			Promise.resolve().then(() => scope.api.modelCatalog()).then(checkedModelCatalog),
+			Promise.resolve().then(() => scope.api.listRunning())
+		]);
 		if (!scope.active) return;
 		if (castResult.status === "fulfilled") {
 			setCast(castResult.value);
@@ -1770,6 +1917,10 @@ function CastPage({ api, locale }) {
 			setCatalog(models.value);
 			setCatalogError("");
 		} else setCatalogError(messageOf(models.reason));
+		if (live.status === "fulfilled") {
+			setRunning(live.value);
+			setRunningError("");
+		} else setRunningError(messageOf(live.reason));
 		scope.busy = false;
 		setRefreshing(false);
 		if (scope.queued) refresh(scope);
@@ -1791,6 +1942,8 @@ function CastPage({ api, locale }) {
 		setSyncError("");
 		setCast(null);
 		setCatalog(null);
+		setRunning(null);
+		setRunningError("");
 		refresh(scope);
 		const unsubscribe = api.subscribeChanges?.(() => {
 			if (!scope.active) return;
@@ -1833,12 +1986,17 @@ function CastPage({ api, locale }) {
 			}
 		});
 	};
-	const refreshNow = () => {
+	const refreshNow = async () => {
 		const scope = scopeRef.current;
-		if (scope?.api === api) refresh(scope, true);
+		if (scope?.api === api && !scope.busy) await refresh(scope, true);
 	};
 	const disabled = saving !== "" || refreshing || writeError !== "" || saved && loadError !== "";
-	const failures = catalogFailures(catalog);
+	const catalogStatus = {
+		loading: refreshing,
+		error: catalogError ? hubMessage(catalogError, t.language) : "",
+		failures: modelCatalogFailures(catalog),
+		refresh: refreshNow
+	};
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "cast-root dsh-ui-stack",
 		"aria-label": t("title"),
@@ -1883,16 +2041,10 @@ function CastPage({ api, locale }) {
 				className: "dsh-ui-error dsh-ui-wrap",
 				children: t("syncFailed", hubMessage(syncError, t.language))
 			}) : null,
-			catalogError ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-				role: "alert",
-				className: "dsh-ui-error dsh-ui-wrap",
-				children: t("catalogFailed", hubMessage(catalogError, t.language))
-			}) : null,
-			failures.map((failure, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-				role: "alert",
-				className: "dsh-ui-error dsh-ui-wrap",
-				children: t("catalogFailed", hubMessage(failure, t.language))
-			}, index)),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ModelCatalogStatus, {
+				state: catalogStatus,
+				locale: t.language
+			}),
 			writeError ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "dsh-ui-banner dsh-ui-banner--danger cast-banner",
 				role: "alert",
@@ -1969,7 +2121,40 @@ function CastPage({ api, locale }) {
 						expectedRevision: cast.revision
 					}))
 				})
-			}) : null
+			}) : null,
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				className: "cast-running",
+				"aria-label": t("runningTitle"),
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+						className: "cast-running-title",
+						children: t("runningTitle")
+					}),
+					runningError ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						role: "alert",
+						className: "dsh-ui-error dsh-ui-wrap",
+						children: t("runningFailed", hubMessage(runningError, t.language))
+					}) : null,
+					running === null && !runningError ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "dsh-ui-loading",
+						children: t("loading")
+					}) : null,
+					running !== null && running.entries.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "dsh-ui-help",
+						children: t("runningEmpty")
+					}) : null,
+					running?.entries.map((entry) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "cast-running-row",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: "cast-running-label",
+							children: entry.label || entry.id
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: "cast-running-route",
+							children: runningRouteText(entry, t)
+						})]
+					}, entry.id))
+				]
+			})
 		]
 	});
 }
@@ -1987,8 +2172,7 @@ const name = "dsh-model-hub-client";
 const inject = [
 	"slots",
 	"connection",
-	"remote",
-	"remote.session",
+	...MODEL_CATALOG_INJECT,
 	"locale"
 ];
 const CHANNEL = "/dsh-model-hub";
@@ -2120,7 +2304,7 @@ function HubPage({ view, api, locale, initialEntries = null, initialCatalog = nu
 		scope.queued = false;
 		scope.busy = true;
 		setRefreshing(true);
-		const [fields, models] = await Promise.allSettled([Promise.resolve().then(() => scope.api.list()), Promise.resolve().then(() => scope.api.modelCatalog()).then(checkedCatalog)]);
+		const [fields, models] = await Promise.allSettled([Promise.resolve().then(() => scope.api.list()), Promise.resolve().then(() => scope.api.modelCatalog()).then(checkedModelCatalog)]);
 		if (!scope.active) return;
 		if (fields.status === "fulfilled") {
 			setEntries(fields.value);
@@ -2233,7 +2417,16 @@ function HubPage({ view, api, locale, initialEntries = null, initialCatalog = nu
 		})
 	})).filter((entry) => entry.fields.length > 0 || (entry.error || entry.catalogError) && (!needle || [entry.ns, pluginTitle(entry, t)].some((text) => text.toLocaleLowerCase().includes(needle))));
 	const disabled = writing !== "" || refreshing || writeError !== "" || saved && listError !== "";
-	const failures = catalogFailures(catalog);
+	const refreshNow = async () => {
+		const scope = scopeRef.current;
+		if (scope?.api === api && !scope.busy) await refresh(scope);
+	};
+	const catalogStatus = {
+		loading: refreshing,
+		error: catalogError ? hubMessage(catalogError, t.language) : "",
+		failures: modelCatalogFailures(catalog),
+		refresh: refreshNow
+	};
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 		className: "dsh-model-hub dsh-ui-stack",
 		lang: t.language,
@@ -2277,10 +2470,7 @@ function HubPage({ view, api, locale, initialEntries = null, initialCatalog = nu
 						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
 							variant: "ghost",
 							disabled: writing !== "" || refreshing,
-							onClick: () => {
-								const scope = scopeRef.current;
-								if (scope?.api === api) refresh(scope);
-							},
+							onClick: refreshNow,
 							children: refreshing ? t("refreshing") : t("refresh")
 						})]
 					}),
@@ -2294,16 +2484,10 @@ function HubPage({ view, api, locale, initialEntries = null, initialCatalog = nu
 						className: "dsh-ui-error dsh-ui-wrap",
 						children: t("syncFailed", hubMessage(syncError, t.language))
 					}) : null,
-					catalogError ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-						role: "alert",
-						className: "dsh-ui-error dsh-ui-wrap",
-						children: t("catalogFailed", hubMessage(catalogError, t.language))
-					}) : null,
-					failures.map((failure, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-						role: "alert",
-						className: "dsh-ui-error dsh-ui-wrap",
-						children: t("catalogFailed", hubMessage(failure, t.language))
-					}, index)),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ModelCatalogStatus, {
+						state: catalogStatus,
+						locale: t.language
+					}),
 					writeError ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						role: "alert",
 						className: "dsh-ui-error dsh-ui-wrap",
@@ -2423,14 +2607,15 @@ async function apply(ctx) {
 	const api = Object.freeze({
 		list: () => call("fields.list", {}),
 		setField: (payload) => call("fields.set", payload),
-		modelCatalog: () => client.remote.session.modelCatalog(),
+		modelCatalog: () => readModelCatalog(client),
 		subscribeChanges: changes.subscribe,
 		getCast: () => call("cast.get", {}),
 		setCastEnabled: (payload) => call("cast.setEnabled", payload),
 		addCastRoute: (payload) => call("cast.addRoute", payload),
 		setCastRoute: (payload) => call("cast.setRoute", payload),
 		removeCastRoute: (payload) => call("cast.removeRoute", payload),
-		setCastTendency: (payload) => call("cast.setTendency", payload)
+		setCastTendency: (payload) => call("cast.setTendency", payload),
+		listRunning: () => call("cast.running", {})
 	});
 	client.slots.inject("plugins.bundle.config", () => client.slots.register({
 		name: "plugins.bundle.config",

package/lib/index.js

@@ -6,7 +6,7 @@ import { modelRouteRoleSchemastery, modelRouteSchemastery } from "@klarkxy/dsh-m
 import { detectModelFields, modelRouteOverride, normalizeModelRoute } from "@klarkxy/dsh-model-route";
 import { MODEL_SETTINGS_CHANGED_EVENT, collectModelSettings, notifyModelSettingsChanged } from "@klarkxy/dsh-plugin-kit/model-settings";
 import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
-import { MODEL_SETTINGS_CHANGES_REMOTE } from "@klarkxy/dsh-plugin-kit/contracts";
+import { MODEL_SETTINGS_CHANGES_REMOTE, isSubagentSession } from "@klarkxy/dsh-plugin-kit/contracts";
 import { parseModelSettingsChangeFrame } from "@klarkxy/dsh-plugin-kit/model-settings-client";
 //#region src/probe.ts
 /**
@@ -457,9 +457,15 @@ function validateIndex(value) {
 */
 function buildCastPrompt(enabled, routes) {
 	if (!enabled || !routes.length) return "";
-	const annotated = routes.filter((route) => typeof route.tendency === "string" && route.tendency);
-	if (!annotated.length) return "";
-	return ["Subagent cast: the user has annotated the models available for subagent delegation with task tendencies. When delegating to a subagent, prefer a model whose tendency matches the task at hand; treat models without a tendency as general-purpose. These tendencies are advisory — the final model choice is always yours.", ...annotated.map((route) => `- ${route.provider}/${route.model}${route.reasoningEffort ? ` (reasoning effort: ${route.reasoningEffort})` : ""}: ${route.tendency}`)].join("\n");
+	const annotated = routes.filter((route) => typeof route.tendency === "string" && route.tendency.trim());
+	const guidance = [
+		"Subagent model selection:",
+		"When delegating an independent task, actively choose a suitable model instead of silently inheriting your own. If list_subagent_models and a delegation tool with provider/model fields are available, inspect the available routes before the first model-selectable delegation in this task, reuse those results for later delegations, and supply provider and model together explicitly.",
+		"For independent reviews, alternative approaches, or disputed conclusions, prefer a model different from your own when a suitable candidate is available. Choose for task fit and the user's constraints; using the same model is appropriate when it fits better or no suitable alternative is available. Do not create extra subtasks solely for model diversity.",
+		"The current Session's discovery results and tool schema are authoritative. Configured model notes may refer to routes unavailable in this Session. If discovery or model-selection fields are unavailable, use the supported delegation behavior; do not invent routes or pass unsupported fields to tools such as subagent_fork. When changing models, omit reasoning_effort unless you have verified a supported value."
+	];
+	if (annotated.length) guidance.push("User-provided task tendencies (advisory): prefer a matching tendency among available models. Models without a tendency remain general-purpose candidates; no model-specific strengths are assumed.", ...annotated.map((route) => `- ${route.provider}/${route.model}${route.reasoningEffort ? ` (reasoning effort: ${route.reasoningEffort})` : ""}: ${route.tendency}`));
+	return guidance.join("\n");
 }
 function createCast(deps) {
 	const castFile = () => {
@@ -683,7 +689,7 @@ function createCast(deps) {
 			return buildCastPrompt(snapshot.enabled, mergeTendencies(snapshot.routes, readTendencies().tendencies));
 		} catch (error) {
 			deps.logger?.warn("model-hub: cast tendencies unavailable: %s", error.message);
-			return "";
+			return buildCastPrompt(snapshot.enabled, snapshot.routes);
 		}
 	};
 	return {
@@ -697,6 +703,128 @@ function createCast(deps) {
 	};
 }
 //#endregion
+//#region src/running.ts
+/**
+* dsh-model-hub — running subagent routes (host half).
+*
+* Read-only live view answering "which model and reasoning effort is each
+* running subagent actually using". `subagent/start` and `subagent/end`
+* maintain the live set; each child's effective route is read from its
+* session epoch header (`session.requestHeader()`) and kept current through
+* the session's own `request/header` events (reason `change` covers mid-run
+* model switches). Children already running when this plugin (re)loads are
+* recovered from the live agent registry via `isSubagentSession`.
+*
+* The effective route is session data recorded by the host; this tracker
+* never writes to sessions or settings. Display-only invalidations reuse the
+* model-settings change channel with RUNNING_NAMESPACE so open pages refetch.
+*/
+/** Invalidation namespace for the running-subagent view; carries no settings. */
+const RUNNING_NAMESPACE = "@klarkxy/dsh-model-hub/running-subagents";
+function text(value) {
+	return typeof value === "string" ? value.trim() : "";
+}
+/** Normalize one epoch header into the display route plus the adapter-default flag. */
+function routeFromHeader(header) {
+	const config = header?.config;
+	const provider = text(config?.provider);
+	const model = text(config?.model);
+	if (!provider || !model) return {};
+	const effort = text(config?.reasoningEffort);
+	return {
+		route: effort ? {
+			provider,
+			model,
+			reasoningEffort: effort
+		} : {
+			provider,
+			model
+		},
+		...effort && header?.adapterDefaults?.reasoningEffort === true ? { effortIsAdapterDefault: true } : {}
+	};
+}
+function sameRoute(left, right) {
+	return left.route?.provider === right.route?.provider && left.route?.model === right.route?.model && left.route?.reasoningEffort === right.route?.reasoningEffort && left.effortIsAdapterDefault === right.effortIsAdapterDefault;
+}
+function createRunningTracker(deps) {
+	const entries = /* @__PURE__ */ new Map();
+	let revision = 0;
+	const bump = () => deps.notify(++revision);
+	const add = (id, info) => {
+		const session = (deps.agents?.get(id))?.session;
+		const next = routeFromHeader(session?.requestHeader?.());
+		const existing = entries.get(id);
+		if (existing) {
+			const providerName = info?.provider ?? existing.providerName;
+			const local = info?.local ?? existing.local;
+			const changed = existing.providerName !== providerName || existing.local !== local || !sameRoute(existing, next);
+			existing.providerName = providerName;
+			existing.local = local;
+			existing.route = next.route;
+			existing.effortIsAdapterDefault = next.effortIsAdapterDefault;
+			if (changed) bump();
+			return;
+		}
+		entries.set(id, {
+			id,
+			local: info?.local !== false,
+			...info?.provider ? { providerName: info.provider } : {},
+			...typeof session?.header?.parentSession === "string" && session.header.parentSession ? { parentSessionId: session.header.parentSession } : {},
+			...typeof session?.header?.createdAt === "number" ? { startedAt: session.header.createdAt } : {},
+			route: next.route,
+			effortIsAdapterDefault: next.effortIsAdapterDefault
+		});
+		bump();
+	};
+	const remove = (id) => {
+		if (entries.delete(id)) bump();
+	};
+	try {
+		for (const agent of deps.agents?.list() ?? []) if (agent?.id && isSubagentSession(agent.session)) add(agent.id);
+	} catch {}
+	deps.events.on("subagent/start", (info) => {
+		if (typeof info?.id === "string" && info.id) add(info.id, info);
+	});
+	deps.events.on("subagent/end", (info) => {
+		if (typeof info?.id === "string") remove(info.id);
+	});
+	deps.events.on("agent/disposed", (payload) => {
+		if (typeof payload?.agent?.id === "string") remove(payload.agent.id);
+	});
+	deps.events.on("session/event", (session, event) => {
+		if (event?.type !== "request/header") return;
+		const id = typeof session?.id === "string" ? session.id : void 0;
+		const entry = id ? entries.get(id) : void 0;
+		if (!entry) return;
+		const next = routeFromHeader(event.data?.header);
+		if (sameRoute(entry, next)) return;
+		entry.route = next.route;
+		entry.effortIsAdapterDefault = next.effortIsAdapterDefault;
+		bump();
+	});
+	return { async list(signal) {
+		const pendingParents = /* @__PURE__ */ new Set();
+		for (const entry of entries.values()) if (entry.label === void 0 && entry.parentSessionId) pendingParents.add(entry.parentSessionId);
+		if (deps.subagents && pendingParents.size) await Promise.allSettled([...pendingParents].map(async (parent) => {
+			const children = await deps.subagents.listChildren(parent, signal);
+			const labels = new Map(children.map((child) => [child.id, child.label]));
+			for (const entry of entries.values()) {
+				if (entry.parentSessionId !== parent || entry.label !== void 0) continue;
+				const label = labels.get(entry.id);
+				if (typeof label === "string" && label.trim()) entry.label = label.trim();
+			}
+		}));
+		const snapshot = [...entries.values()].map((entry) => ({
+			...entry,
+			route: entry.route ? { ...entry.route } : void 0
+		})).sort((a, b) => (a.startedAt ?? 0) - (b.startedAt ?? 0) || a.id.localeCompare(b.id));
+		return {
+			revision,
+			entries: snapshot
+		};
+	} };
+}
+//#endregion
 //#region src/index.ts
 /**
 * dsh-model-hub — cross-plugin model settings hub.
@@ -751,6 +879,12 @@ function apply(ctx) {
 		logger: ctx.logger,
 		notifyTendenciesChanged: (revision) => notifyModelSettingsChanged(ctx, CAST_TENDENCIES_NAMESPACE, revision)
 	});
+	const running = createRunningTracker({
+		events: ctx,
+		agents: ctx.get("agents"),
+		subagents: ctx.get("subagents"),
+		notify: (revision) => notifyModelSettingsChanged(ctx, RUNNING_NAMESPACE, revision)
+	});
 	ctx.systemPrompt.section({
 		name: "model-hub:subagent-cast",
 		order: ctx.systemPrompt.getSectionOrder("TOOL_SUBAGENT") + 1,
@@ -812,6 +946,10 @@ function apply(ctx) {
 					ok: true,
 					value: cast.setTendency(row.provider, row.model, row.tendency, row.expectedRevision, signal)
 				};
+				if (endpoint === "cast.running") return {
+					ok: true,
+					value: await running.list(signal)
+				};
 			}
 			throw new Error(`Unknown endpoint: ${endpoint}`);
 		} catch (error) {