@khorsheed/dsh-local-agent-dsh 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # 变更记录
 
+## 0.2.2（2026-10-27）
+
+- 跟随本地 Agent 家族统一版本线发布，本包没有功能改动。
+
+## 0.2.1（2026-10-27）
+
+- **不用再打开开关**：「DeepSeek 委派」的启用开关去掉了，装上就能用；委派工具 `subagent_dsh` 随模式授予，只在开发、游戏开发、剪辑模式的会话里出现，不再出现在每个会话里。
+- **常驻模式（live）默认打开**：遇到问题可以在卡片上关掉，改回每次新起一个。
+- **设置存在自己的目录里**：默认模型等设置改存在子 DSH 自己的目录里，几个模式套件一起装时也能保存；改不成时显示「保存失败」，不再假装「已保存」。
+
 ## 0.2.0（2026-10-26）
 
 - **版本号去掉 rc**:社区包不再发 prerelease 版本(docs/publishing.md「版本号规则」),家族各包同版 0.2.0;本节原记为 0.2.0-rc.4。

package/README.en.md

@@ -4,19 +4,19 @@ English | [中文](README.md)
 
 Hand a subtask to a second, separately running DSH on your machine: it has its own sessions and settings, the result comes back to your session, and you can keep the conversation going.
 
-Some subtasks deserve a clean DSH: none of the current session's context, its own session history, and no way to disturb the instance you're using. With this plugin, turn on "DeepSeek delegation" in settings and the agent can hand such subtasks to a separate DSH started on your machine. Its output shows up live in a sub-session, the result comes back to you, and you can keep working in the same sub-session afterwards.
+Some subtasks deserve a clean DSH: none of the current session's context, its own session history, and no way to disturb the instance you're using. With this plugin, in sessions of the Dev, Game Dev and Video modes the agent can hand such subtasks to a separate DSH started on your machine. Its output shows up live in a sub-session, the result comes back to you, and you can keep working in the same sub-session afterwards.
 
-<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/local-agent-dsh.png" width="560" alt="The expanded DSH section: credentials follow the current DSH, the "DeepSeek delegation" switch on, the default-model picker and the resident-mode switch">
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/local-agent-dsh.png" width="560" alt="The “Local Agent Delegation” card with the “Local DSH Delegation” section open: signed in (0.2.1-rc.1), credentials taken from the host instance with no separate login, DeepSeek-V4.1-Flash as the default model, and resident mode (live) on">
 
 ## What it does
 
-- **Off by default, on when you want it**: with the switch off nothing changes; turn on "DeepSeek delegation" in the DSH section of the 「本机 Agent 委派」 (Local Agent Delegation) card and the agent can hand subtasks to it, no restart needed.
+- **Works once installed**: no switch to turn on; the delegation tool follows the mode — sessions of the Dev, Game Dev and Video modes get it, every other session is unchanged.
 - **No separate sign-in**: it uses the model and key you picked in your current DSH, and the card shows whether that credential works.
 - **Kept apart**: the second DSH's sessions, settings, and state live in their own folder; they never show up in your session list or change your current instance.
 - **See the work as it happens**: its output appears in the sub-session as it runs.
 - **Keep talking**: have the agent follow up, or open the sub-session and message it yourself; it's the same session on the second DSH.
 - **Choose the model**: pick one under "Default model" on the card and every hand-off uses it; leave it blank to follow your current DSH's default.
-- **Resident mode is faster**: turn on "Resident mode (live)" and the second DSH stays up; stopping doesn't kill it.
+- **Resident mode is faster**: on by default — the second DSH stays up and stopping doesn't kill it; if it misbehaves, turn off "Resident mode (live)" on the card to start a fresh one each time.
 
 ## Install
 
@@ -26,7 +26,7 @@ In DSH, open Plugins → Add plugin, enter this package name, and press Install:
 @khorsheed/dsh-bundle-local-agent
 ```
 
-This plugin comes with the 「多Agent协作」 (multi-agent) suite; all the local agents share one core, so on its own it won't work. The Dev Suite `@khorsheed/dsh-dev-suite` includes it too. Restart DSH, open the 「本机 Agent 委派」 card on the Plugins page, expand the DSH section, turn on "DeepSeek delegation", then tell the agent in a session "hand this subtask to the local DSH".
+This plugin comes with the 「多Agent协作」 (multi-agent) suite; all the local agents share one core, so on its own it won't work. The Dev Suite `@khorsheed/dsh-dev-suite` includes it too. Restart DSH, then in a Dev (or Game Dev, Video) mode session tell the agent "hand this subtask to the local DSH".
 
 ## Known limitations
 

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # last confirmed-consistent state. Both languages carry equal authority; after
 # editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/local-agent-dsh/README.en.md
-packages/local-agent-dsh/README.en.md: 40e63c45195893d980e8b2d8ababbdc3a1d6745d
-packages/local-agent-dsh/README.md: 65d1e8a0762e1fbc33f58e594f15cbf1a5e64fb5
+packages/local-agent-dsh/README.en.md: ae3dd795c6fe850b185d05dc2857f6c91d1aeaac
+packages/local-agent-dsh/README.md: 91968cfebfd1e6a70454e5fdb09bb87a0881d38f

package/README.md

@@ -4,19 +4,19 @@
 
 把子任务交给你电脑上另一个单独运行的 DSH：它有自己的会话和设置，跑完结果回到当前会话，还能接着聊。
 
-有些子任务你想让一个干净的 DSH 来做：不带当前会话的上下文，有自己的会话记录，也不会动到你正在用的这个实例。装上之后，在设置里打开「DeepSeek 委派」，agent 就能把这类子任务交给本机另起的一个 DSH；它的输出实时出现在子会话里，跑完把结果带回来，之后还能在同一个子会话里接着干。
+有些子任务你想让一个干净的 DSH 来做：不带当前会话的上下文，有自己的会话记录，也不会动到你正在用的这个实例。装上之后，在开发、游戏开发、剪辑这几个模式的会话里，agent 就能把这类子任务交给本机另起的一个 DSH；它的输出实时出现在子会话里，跑完把结果带回来，之后还能在同一个子会话里接着干。
 
-<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/local-agent-dsh.png" width="560" alt="展开的 DSH 一节：凭据沿用当前 DSH，「DeepSeek 委派」开关已打开，默认模型选择和常驻模式开关">
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/local-agent-dsh.png" width="560" alt="「本机 Agent 委派」卡片里展开的「本机 DSH 委派」一节：已登录（0.2.1-rc.1），凭据走宿主实例、无需单独登录，默认模型选的是 DeepSeek-V4.1-Flash，常驻模式（live）开着">
 
 ## 能做什么
 
-- **默认关着，想用再开**：开关关着时一切照旧；在「本机 Agent 委派」卡片的 DSH 一节打开「DeepSeek 委派」，agent 才能把子任务交给它，不用重启。
+- **装上就能用**：不用再打开什么开关；委派工具跟着模式走，开发、游戏开发、剪辑模式的会话里才有，其他会话一切照旧。
 - **不用另外登录**：它沿用你在当前 DSH 里选的模型和 key，卡片上直接显示凭据能不能用。
 - **互不打扰**：子 DSH 的会话、设置和状态都放在单独的目录里，不会出现在你的会话列表里，也不会改动当前实例。
 - **过程看得见**：子 DSH 的输出边跑边出现在子会话里。
 - **接着聊**：让 agent 追问，或者打开子会话直接发消息，继续的是同一个子 DSH 会话。
 - **指定模型**：卡片的「默认模型」里选一个模型，之后每次委派都用它；留空就跟随当前 DSH 的默认模型。
-- **常驻模式更快**：打开「常驻模式（live）」，子 DSH 常驻，停下不杀进程。
+- **常驻模式更快**：默认开着，子 DSH 常驻，停下不杀进程；遇到问题可以在卡片上关掉「常驻模式（live）」，改回每次新起一个。
 
 ## 安装
 
@@ -26,7 +26,7 @@
 @khorsheed/dsh-bundle-local-agent
 ```
 
-本插件会跟着「多Agent协作」套件一起装好（各家本机 agent 共用同一个底座，单装用不起来）；开发套件 `@khorsheed/dsh-dev-suite` 也包含它。装完重启 DSH，到「插件」页的「本机 Agent 委派」卡片里展开 DSH 一节，打开「DeepSeek 委派」，然后在会话里对 agent 说「把这个子任务交给本机的 DSH」。
+本插件会跟着「多Agent协作」套件一起装好（各家本机 agent 共用同一个底座，单装用不起来）；开发套件 `@khorsheed/dsh-dev-suite` 也包含它。装完重启 DSH，在开发（或游戏开发、剪辑）模式的会话里对 agent 说「把这个子任务交给本机的 DSH」。
 
 ## 已知限制
 

package/lib/client.js

@@ -93,6 +93,83 @@ window.__ModuleLoader__.load({
 			});
 			return channel;
 		}
+		/**
+		* Bind a settings card to the harness's own card-settings store (card-settings.ts
+		* on the host) layered over the row's host settings form: reads are the
+		* form's value with the stored overrides on top; writes go to the store only,
+		* never the profile patch — so they cannot be refused when several suites
+		* insert the same row. A host without the store keeps the plain row scope.
+		* @param ctx - the provider's client context.
+		* @param harness - the harness name (`dsh`, `kimi`, …).
+		* @param entryId - the plugin row id the base values come from.
+		* @returns the bound scope.
+		*/
+		function bindCardSettingsScope(ctx, harness, entryId) {
+			const row = bindSettingsScope(ctx, entryId);
+			const gateway = () => {
+				const remote = ctx.get("remote.localAgentGateway");
+				return typeof remote?.cardSettings === "function" && typeof remote.setCardSettings === "function" ? remote : void 0;
+			};
+			const listeners = /* @__PURE__ */ new Set();
+			let stored;
+			let cached;
+			const emit = () => {
+				for (const listener of [...listeners]) listener();
+			};
+			const load = () => {
+				gateway()?.cardSettings(harness).then((result) => {
+					if (!result.ok || result.value === void 0) return;
+					stored = result.value;
+					emit();
+				}).catch(() => {});
+			};
+			const write = async (patch) => {
+				const remote = gateway();
+				if (remote === void 0) return false;
+				try {
+					const result = await remote.setCardSettings(harness, patch);
+					if (!result.ok || result.value === void 0) return false;
+					stored = result.value;
+					emit();
+					return true;
+				} catch {
+					return false;
+				}
+			};
+			return {
+				getSnapshot: () => {
+					const rowSnapshot = row.getSnapshot();
+					if (cached !== void 0 && cached.rowSnapshot === rowSnapshot && cached.stored === stored) return cached.snapshot;
+					const overrides = stored ?? {};
+					const snapshot = gateway() === void 0 ? rowSnapshot : {
+						...rowSnapshot,
+						value: rowSnapshot.value === void 0 && stored === void 0 ? void 0 : {
+							...rowSnapshot.value,
+							...overrides
+						},
+						writable: true,
+						status: rowSnapshot.status === "loading" && stored !== void 0 ? "ready" : rowSnapshot.status === "unavailable" && stored !== void 0 ? "ready" : rowSnapshot.status
+					};
+					cached = {
+						rowSnapshot,
+						stored,
+						snapshot
+					};
+					return snapshot;
+				},
+				subscribe: (listener) => {
+					if (listeners.size === 0) load();
+					listeners.add(listener);
+					const off = row.subscribe(listener);
+					return () => {
+						listeners.delete(listener);
+						off();
+					};
+				},
+				set: (field, value) => gateway() === void 0 ? row.set(field, value) : write({ [field]: value }),
+				unset: (field) => gateway() === void 0 ? row.unset(field) : write({ [field]: null })
+			};
+		}
 		//#endregion
 		//#region src/client/locales.ts
 		/** `local-agent-dsh` namespace dictionaries. */
@@ -118,11 +195,6 @@ window.__ModuleLoader__.load({
 			"model.applied": "已保存，下一轮委派生效；进行中的轮次不受影响",
 			"model.error": "保存失败，请重试",
 			"auth.host": "dsh 凭据走宿主实例的凭证设置，无需单独登录。",
-			"enable.title": "DeepSeek 委派",
-			"enable.switch": "启用",
-			"enable.switch.aria": "DeepSeek 委派开关",
-			"enable.on": "已开启：模型可使用 subagent_dsh 委派给本机 dsh",
-			"enable.off": "已关闭：委派只走官方内置子代理工具",
 			"live.title": "常驻模式（live）",
 			"live.info.aria": "常驻模式说明",
 			"live.info": "常驻模式 = 成员进程常驻：输出实时流入成员会话、取消不杀进程、崩溃后自动续上原会话；关闭则每轮独立进程，跑完一次性出结果。设置为全局偏好，对所有后续委派生效。",
@@ -150,11 +222,6 @@ window.__ModuleLoader__.load({
 			"model.applied": "Saved — takes effect on the next delegation round; rounds in flight are unaffected",
 			"model.error": "Save failed, please retry",
 			"auth.host": "dsh authenticates through the host instance’s credential settings — no separate sign-in.",
-			"enable.title": "DeepSeek delegation",
-			"enable.switch": "Enabled",
-			"enable.switch.aria": "DeepSeek delegation switch",
-			"enable.on": "ON: the model can delegate to the local dsh via subagent_dsh",
-			"enable.off": "OFF: delegation goes through the official in-process subagent tool only",
 			"live.title": "Resident mode (live)",
 			"live.info.aria": "About resident mode",
 			"live.info": "Resident mode keeps the member process alive: output streams into the member session in real time, cancelling does not kill the process, and a crash resumes the same session. Off means every round runs as an independent one-shot process. The setting is global and applies to every later delegation.",
@@ -204,8 +271,13 @@ window.__ModuleLoader__.load({
 		* re-probes so a mid-session credential loss cannot leave a stale green dot.
 		* @module @khorsheed/dsh-local-agent/client — auth status bus
 		*/
-		const statuses = /* @__PURE__ */ new Map();
-		const listeners = /* @__PURE__ */ new Set();
+		const BUS_KEY = Symbol.for("dsh.local-agent.auth-status");
+		const bus = globalThis[BUS_KEY] ??= {
+			statuses: /* @__PURE__ */ new Map(),
+			listeners: /* @__PURE__ */ new Set()
+		};
+		const statuses = bus.statuses;
+		const listeners = bus.listeners;
 		/** Record one harness's latest probe result and notify subscribers. */
 		function publishAuthStatus(harnessId, status) {
 			if (statuses.get(harnessId) === status) return;
@@ -263,30 +335,30 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var ProviderAuthBlock_module_css_default = {
-			"rowCard": "On5p7W_rowCard",
-			"rowName": "On5p7W_rowName",
-			"rowHead": "On5p7W_rowHead",
-			"section": "On5p7W_section",
-			"dotOff": "On5p7W_dotOff",
-			"logoutButton": "On5p7W_logoutButton",
-			"rosterError": "On5p7W_rosterError",
-			"dotOn": "On5p7W_dotOn",
-			"promptText": "On5p7W_promptText",
-			"title": "On5p7W_title",
-			"rowTag": "On5p7W_rowTag",
-			"intro": "On5p7W_intro",
 			"rows": "On5p7W_rows",
-			"dotPending": "On5p7W_dotPending",
-			"rowActions": "On5p7W_rowActions",
-			"loginButton": "On5p7W_loginButton",
+			"logoutButton": "On5p7W_logoutButton",
 			"rowPending": "On5p7W_rowPending",
-			"retryButton": "On5p7W_retryButton",
-			"openPage": "On5p7W_openPage",
-			"status": "On5p7W_status",
+			"intro": "On5p7W_intro",
+			"title": "On5p7W_title",
 			"credentialDot": "On5p7W_credentialDot",
 			"loginPrompt": "On5p7W_loginPrompt",
+			"rowCard": "On5p7W_rowCard",
+			"dotOn": "On5p7W_dotOn",
+			"rosterError": "On5p7W_rosterError",
+			"dotPending": "On5p7W_dotPending",
+			"status": "On5p7W_status",
+			"loginButton": "On5p7W_loginButton",
+			"promptText": "On5p7W_promptText",
+			"dotOff": "On5p7W_dotOff",
 			"rowIdentity": "On5p7W_rowIdentity",
-			"codeInput": "On5p7W_codeInput"
+			"openPage": "On5p7W_openPage",
+			"rowTag": "On5p7W_rowTag",
+			"rowHead": "On5p7W_rowHead",
+			"retryButton": "On5p7W_retryButton",
+			"codeInput": "On5p7W_codeInput",
+			"section": "On5p7W_section",
+			"rowActions": "On5p7W_rowActions",
+			"rowName": "On5p7W_rowName"
 		};
 		//#endregion
 		//#region ../local-agent/src/client/ProviderAuthBlock.tsx
@@ -439,8 +511,8 @@ window.__ModuleLoader__.load({
 			const statusKind = usePublishedAuthStatus(harness.id) ?? view.status;
 			const authenticated = statusKind === "authenticated";
 			const loginPending = pendingSince !== void 0;
-			const loginable = view.loginable ?? true;
-			const logoutable = view.logoutable ?? true;
+			const loginable = view.loginable ?? statusKind !== "unavailable";
+			const logoutable = view.logoutable ?? statusKind !== "unavailable";
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
 				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: ProviderAuthBlock_module_css_default.rowHead,
@@ -473,7 +545,7 @@ window.__ModuleLoader__.load({
 								statusKind === "checking" && t("loading"),
 								statusKind === "authenticated" && t("settings.authenticated"),
 								statusKind === "anonymous" && t("settings.notAuthenticated"),
-								statusKind === "unavailable" && t("error")
+								statusKind === "unavailable" && t("settings.statusFailed")
 							]
 						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
@@ -565,10 +637,10 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var AuthStatusDot_module_css_default = {
-			"credentialDot": "OFjNUG_credentialDot",
 			"dotOff": "OFjNUG_dotOff",
-			"dotOn": "OFjNUG_dotOn",
-			"dotPending": "OFjNUG_dotPending"
+			"credentialDot": "OFjNUG_credentialDot",
+			"dotPending": "OFjNUG_dotPending",
+			"dotOn": "OFjNUG_dotOn"
 		};
 		//#endregion
 		//#region ../local-agent/src/client/AuthStatusDot.tsx
@@ -594,40 +666,40 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var SettingsCard_module_css_default = {
-			"errorText": "_3LBPpW_errorText",
-			"modelMenu": "_3LBPpW_modelMenu",
-			"rowLabel": "_3LBPpW_rowLabel",
-			"description": "_3LBPpW_description",
-			"body": "_3LBPpW_body",
-			"chevron": "_3LBPpW_chevron",
-			"modelMenuButton": "_3LBPpW_modelMenuButton",
+			"blockTitle": "_3LBPpW_blockTitle",
+			"info": "_3LBPpW_info",
 			"modelItemCheck": "_3LBPpW_modelItemCheck",
-			"headText": "_3LBPpW_headText",
-			"modelItemCurrent": "_3LBPpW_modelItemCurrent",
-			"header": "_3LBPpW_header",
 			"chevronOpen": "_3LBPpW_chevronOpen",
+			"description": "_3LBPpW_description",
+			"switchOn": "_3LBPpW_switchOn",
+			"modelMenu": "_3LBPpW_modelMenu",
+			"row": "_3LBPpW_row",
+			"card": "_3LBPpW_card",
+			"headText": "_3LBPpW_headText",
+			"rowLabel": "_3LBPpW_rowLabel",
+			"modelMenuChevron": "_3LBPpW_modelMenuChevron",
+			"modelMenuUp": "_3LBPpW_modelMenuUp",
+			"modelItemLabel": "_3LBPpW_modelItemLabel",
+			"block": "_3LBPpW_block",
 			"knob": "_3LBPpW_knob",
+			"saved": "_3LBPpW_saved",
 			"modelMenuChevronOpen": "_3LBPpW_modelMenuChevronOpen",
+			"cardOpen": "_3LBPpW_cardOpen",
 			"modelItemDefault": "_3LBPpW_modelItemDefault",
-			"modelItemLabel": "_3LBPpW_modelItemLabel",
 			"switch": "_3LBPpW_switch",
-			"blockTitle": "_3LBPpW_blockTitle",
-			"modelItem": "_3LBPpW_modelItem",
 			"modelInput": "_3LBPpW_modelInput",
-			"card": "_3LBPpW_card",
-			"cardOpen": "_3LBPpW_cardOpen",
-			"row": "_3LBPpW_row",
+			"body": "_3LBPpW_body",
+			"chevron": "_3LBPpW_chevron",
+			"modelField": "_3LBPpW_modelField",
+			"header": "_3LBPpW_header",
+			"modelItem": "_3LBPpW_modelItem",
+			"errorText": "_3LBPpW_errorText",
+			"modelMenuButton": "_3LBPpW_modelMenuButton",
+			"modelItemCurrent": "_3LBPpW_modelItemCurrent",
+			"name": "_3LBPpW_name",
 			"modelSave": "_3LBPpW_modelSave",
-			"modelMenuUp": "_3LBPpW_modelMenuUp",
-			"saved": "_3LBPpW_saved",
 			"hint": "_3LBPpW_hint",
-			"modelMenuChevron": "_3LBPpW_modelMenuChevron",
-			"switchOn": "_3LBPpW_switchOn",
-			"block": "_3LBPpW_block",
-			"nameRow": "_3LBPpW_nameRow",
-			"modelField": "_3LBPpW_modelField",
-			"info": "_3LBPpW_info",
-			"name": "_3LBPpW_name"
+			"nameRow": "_3LBPpW_nameRow"
 		};
 		//#endregion
 		//#region src/client/SettingsCard.tsx
@@ -694,8 +766,9 @@ window.__ModuleLoader__.load({
 			const write = (field, value) => {
 				setSaved(false);
 				setError(false);
-				scope.set(field, value).then(() => {
-					setSaved(true);
+				scope.set(field, value).then((accepted) => {
+					if (accepted === false) setError(true);
+					else setSaved(true);
 				}, () => {
 					setError(true);
 				});
@@ -756,7 +829,7 @@ window.__ModuleLoader__.load({
 		}
 		/** The card body both settings surfaces share: the auth block, the delegation switch, the default-model block, and the resident-mode block. */
 		function CardBody({ state, auth, authT, renderModelPicker, useSessions, t }) {
-			const { snapshot, saved, error, ready, enabled, live, storedModel, modelValue, modelSaved, modelError, choices, modelMenuOpen, modelMenuUp, modelFieldRef, modelPlaceholder, modelDefaultItem, saveModel, write, toggleModelMenu, setModelDraft, setModelMenuOpen } = state;
+			const { snapshot, saved, error, ready, live, storedModel, modelValue, modelSaved, modelError, choices, modelMenuOpen, modelMenuUp, modelFieldRef, modelPlaceholder, modelDefaultItem, saveModel, write, toggleModelMenu, setModelDraft, setModelMenuOpen } = state;
 			const modelInputElement = /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
 				type: "text",
 				className: SettingsCard_module_css_default.modelInput,
@@ -794,37 +867,6 @@ window.__ModuleLoader__.load({
 							})
 						]
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
-						className: SettingsCard_module_css_default.block,
-						children: [
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
-								className: SettingsCard_module_css_default.blockTitle,
-								children: t("enable.title")
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-								className: SettingsCard_module_css_default.row,
-								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-									className: SettingsCard_module_css_default.rowLabel,
-									children: t("enable.switch")
-								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-									type: "button",
-									role: "switch",
-									"aria-checked": enabled,
-									"aria-label": t("enable.switch.aria"),
-									className: enabled ? `${SettingsCard_module_css_default.switch} ${SettingsCard_module_css_default.switchOn}` : SettingsCard_module_css_default.switch,
-									disabled: !ready,
-									onClick: () => {
-										write("enabled", !enabled);
-									},
-									children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { className: SettingsCard_module_css_default.knob })
-								})]
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-								className: SettingsCard_module_css_default.hint,
-								children: t(enabled ? "enable.on" : "enable.off")
-							})
-						]
-					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 						className: SettingsCard_module_css_default.block,
 						children: [
@@ -1122,7 +1164,7 @@ window.__ModuleLoader__.load({
 				en
 			}), "local-agent-dsh: dictionaries");
 			const t = ctx.locale.bind(NS);
-			const scope = bindSettingsScope(ctx, "local-agent-dsh");
+			const scope = bindCardSettingsScope(ctx, "dsh", "local-agent-dsh");
 			const authT = ctx.locale.bind("local-agent");
 			const gateway = () => ctx.get("remote.localAgentGateway");
 			const cardFace = () => ({

package/lib/index.js

@@ -5,7 +5,6 @@ import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import z from "@deepseek-ai/schemastery";
 import { ModelDirectoryCache, extendModelDirectory, settingsFace, vol } from "@khorsheed/dsh-local-agent";
-import { mountSubagentDelegationTool } from "@khorsheed/dsh-local-agent/tool-factory";
 //#region lib/types/live-switch.js
 /**
 * The settings-driven live-driver switch: owns the active driver generation
@@ -404,7 +403,7 @@ const inject = [
 */
 const SETTINGS_FIELDS = {
 	enabled: z.boolean().default(false),
-	live: z.boolean().default(false),
+	live: z.boolean().default(true),
 	liveMirrorGranularity: z.union([z.const("event"), z.const("token")]).default("token"),
 	model: z.string(),
 	recentModels: z.array(z.string()).default([])
@@ -446,34 +445,6 @@ const DSH_SETTINGS_NAMESPACE = "local-agent-dsh";
 * the YAML config's deployment defaults through the composition base.
 */
 const DSH_SETTINGS_SCHEMA = z.object(SETTINGS_FIELDS);
-/** The delegation tool the toggle mounts while ON. */
-const DSH_TOOL_NAME = "subagent_dsh";
-/**
-* This package's own name, passed to the family tool factory as the
-* tool-origin owner (AGENTS.md § Tool origin tagging — a shared factory never
-* hardcodes an owner), the same pattern the worktrees/room `./tool` entries
-* use.
-*/
-const PACKAGE_NAME = "@khorsheed/dsh-local-agent-dsh";
-/**
-* The `subagent_dsh` mount, as a plugin object over the family factory: the
-* toggle owns its lifecycle, so it mounts dynamically through `ctx.plugin`
-* instead of shipping a `./tool` composition row like the CLI providers.
-*/
-const dshSubagentTool = {
-	name: "local-agent-dsh-tool",
-	inject: [
-		"tools",
-		"subagents",
-		"localAgent"
-	],
-	apply: (toolCtx) => {
-		mountSubagentDelegationTool(toolCtx, {
-			provider: "dsh-cli",
-			toolName: DSH_TOOL_NAME
-		}, PACKAGE_NAME);
-	}
-};
 /**
 * Mount the toggle controller: register the settings namespace, then mirror
 * its value into harness/provider/tool registrations, live.
@@ -485,7 +456,7 @@ function apply(ctx, config) {
 	ctx.effect(() => {
 		const readSettings = () => ({
 			enabled: vol(config.enabled) ?? false,
-			live: vol(config.live) ?? false,
+			live: vol(config.live) ?? true,
 			liveMirrorGranularity: vol(config.liveMirrorGranularity) ?? "token",
 			model: vol(config.model),
 			recentModels: vol(config.recentModels) ?? []
@@ -502,6 +473,7 @@ function apply(ctx, config) {
 		}
 		const face = settingsFace(ctx, {
 			namespace: DSH_SETTINGS_NAMESPACE,
+			harness: "dsh",
 			legacySchema: DSH_SETTINGS_SCHEMA,
 			legacyBase,
 			read: readSettings
@@ -620,7 +592,6 @@ function apply(ctx, config) {
 			if (enabled === currentEnabled) return;
 			currentEnabled = enabled;
 			generation += 1;
-			const gen = generation;
 			for (const dispose of disposers.splice(0)) dispose();
 			if (!enabled) return;
 			provisionDshScope(homeDir, config, profileDirOption());
@@ -632,25 +603,10 @@ function apply(ctx, config) {
 				if (currentLiveSwitch === liveSwitch) currentLiveSwitch = void 0;
 				liveSwitch.dispose();
 			});
-			ctx.plugin(dshSubagentTool).then((fiber) => {
-				if (gen !== generation) {
-					fiber.dispose();
-					return;
-				}
-				disposers.push(() => {
-					fiber.dispose();
-				});
-			}, (error) => {
-				ctx.logger.warn(`local-agent-dsh: delegation tool mount failed: ${error instanceof Error ? error.message : String(error)}`);
-			});
 		};
-		sync(face.get().enabled);
-		const unwatch = face.watch((next) => {
-			sync(next.enabled);
-		});
+		sync(true);
 		return () => {
 			modelCatalog.dispose();
-			unwatch();
 			generation += 1;
 			for (const dispose of disposers.splice(0)) dispose();
 		};

package/lib/tool.js

@@ -0,0 +1,40 @@
+import { mountSubagentDelegationTool, subagentToolConfigSchema } from "@khorsheed/dsh-local-agent/tool-factory";
+//#region lib/types/tool.js
+const PACKAGE_NAME = "@khorsheed/dsh-local-agent-dsh";
+/** This entry's own defaults: a preset row needs no config. */
+const DEFAULT_PROVIDER = "dsh-cli";
+const DEFAULT_TOOL_NAME = "subagent_dsh";
+/** Cordis plugin name used by loader diagnostics. */
+const name = "local-agent-dsh-tool";
+/**
+* The family core's `localAgent` service is a declared inject (the
+* owning-family companion exception to the community-service probe rule): a
+* preset's standing scope mounts at registry-activation time, BEFORE the
+* profile's later bundle rows provide the core, so a one-shot ctx.get probe
+* at apply saw ABSENT there and nothing re-ran the row (rc.1 boot order; the
+* worktrees `./tool` entry documents the incident). The declared inject pends
+* the row until the core provides, then the body applies.
+*/
+const inject = [
+	"tools",
+	"subagents",
+	"localAgent"
+];
+const Config = subagentToolConfigSchema(DEFAULT_PROVIDER, DEFAULT_TOOL_NAME);
+/**
+* Plugin body: mount the delegation tool through the family factory, stamped
+* with THIS package as the tool-origin owner (AGENTS.md § Tool origin
+* tagging — the shared factory never hardcodes an owner).
+* @param ctx - Cordis context (the preset's agent-plane mount).
+* @param config - row config (schema defaults already applied; the `??`
+* fallbacks cover a direct ctx.plugin caller that bypassed validation).
+*/
+function apply(ctx, config) {
+	const resolved = {
+		provider: config.provider ?? DEFAULT_PROVIDER,
+		toolName: config.toolName ?? DEFAULT_TOOL_NAME
+	};
+	mountSubagentDelegationTool(ctx, resolved, PACKAGE_NAME);
+}
+//#endregion
+export { Config, apply, inject, name };

package/lib/types/client/SettingsCard.js

@@ -78,7 +78,11 @@ function useCardState(active, useSettings, scope, harnessModel, t) {
     const write = (field, value) => {
         setSaved(false);
         setError(false);
-        void scope.set(field, value).then(() => { setSaved(true); }, () => { setError(true); });
+        // The host answers a refused write with `false` (ConfigForm), not a rejection.
+        void scope.set(field, value).then((accepted) => { if (accepted === false)
+            setError(true);
+        else
+            setSaved(true); }, () => { setError(true); });
     };
     // The suggestion vocabulary: the broker's deduped union (settings + host
     // default selection + recent) when the surface answered, the card's own
@@ -152,13 +156,13 @@ function useCardState(active, useSettings, scope, harnessModel, t) {
 }
 /** The card body both settings surfaces share: the auth block, the delegation switch, the default-model block, and the resident-mode block. */
 function CardBody({ state, auth, authT, renderModelPicker, useSessions, t }) {
-    const { snapshot, saved, error, ready, enabled, live, storedModel, modelValue, modelSaved, modelError, choices, modelMenuOpen, modelMenuUp, modelFieldRef, modelPlaceholder, modelDefaultItem, saveModel, write, toggleModelMenu, setModelDraft, setModelMenuOpen, } = state;
+    const { snapshot, saved, error, ready, live, storedModel, modelValue, modelSaved, modelError, choices, modelMenuOpen, modelMenuUp, modelFieldRef, modelPlaceholder, modelDefaultItem, saveModel, write, toggleModelMenu, setModelDraft, setModelMenuOpen, } = state;
     // The free-text input, single-sourced for both presentations: bare when no
     // vocabulary exists (a fresh install degrades to exactly the pre-picker
     // field), or inside the select-like field next to its chevron. No datalist:
     // the chevron menu is the single choice list.
     const modelInputElement = (_jsx("input", { type: "text", className: css.modelInput, value: modelValue, placeholder: modelPlaceholder, "aria-label": t('model.title'), disabled: !ready, onChange: (event) => { setModelDraft(event.target.value); } }));
-    return (_jsxs("div", { className: css.body, children: [_jsxs("section", { className: css.block, children: [_jsx("h3", { className: css.blockTitle, children: t('auth.title') }), _jsx(ProviderAuthBlock, { harness: { id: 'dsh', label: 'dsh' }, useSessions: useSessions, status: auth.status, runCommand: auth.runCommand, t: authT }), _jsx("span", { className: css.hint, children: t('auth.host') })] }), _jsxs("section", { className: css.block, children: [_jsx("h3", { className: css.blockTitle, children: t('enable.title') }), _jsxs("div", { className: css.row, children: [_jsx("span", { className: css.rowLabel, children: t('enable.switch') }), _jsx("button", { type: "button", role: "switch", "aria-checked": enabled, "aria-label": t('enable.switch.aria'), className: enabled ? `${css.switch} ${css.switchOn}` : css.switch, disabled: !ready, onClick: () => { write('enabled', !enabled); }, children: _jsx("span", { className: css.knob }) })] }), _jsx("span", { className: css.hint, children: t(enabled ? 'enable.on' : 'enable.off') })] }), _jsxs("section", { className: css.block, children: [_jsxs("h3", { className: css.blockTitle, children: [t('model.title'), _jsx(Tooltip, { label: t('model.info'), side: "bottom", maxWidth: 360, children: _jsx("button", { type: "button", className: css.info, "aria-label": t('model.info.aria'), children: "\u24D8" }) })] }), _jsxs("div", { className: css.row, children: [renderModelPicker?.({ value: modelValue, onChange: setModelDraft, disabled: !ready, defaultLabel: modelDefaultItem }) ?? (choices.length > 0 ? (_jsxs("div", { className: css.modelField, ref: modelFieldRef, children: [modelInputElement, _jsx("button", { type: "button", className: css.modelMenuButton, "aria-label": t('model.menu'), "aria-haspopup": "menu", "aria-expanded": modelMenuOpen, disabled: !ready, onClick: () => { toggleModelMenu(); }, children: _jsx(IconChevronDownOutlineMedium, { className: modelMenuOpen ? `${css.modelMenuChevron} ${css.modelMenuChevronOpen}` : css.modelMenuChevron }) }), modelMenuOpen && (_jsxs("div", { className: modelMenuUp ? `${css.modelMenu} ${css.modelMenuUp}` : css.modelMenu, role: "menu", "aria-label": t('model.menu'), children: [_jsxs("button", { type: "button", role: "menuitemradio", "aria-checked": modelValue.trim() === '', className: modelValue.trim() === '' ? `${css.modelItemDefault} ${css.modelItemCurrent}` : css.modelItemDefault, onClick: () => { setModelDraft(''); setModelMenuOpen(false); }, children: [_jsx("span", { className: css.modelItemLabel, children: modelDefaultItem }), _jsx("span", { className: css.modelItemCheck, "aria-hidden": true, children: modelValue.trim() === '' ? '✓' : '' })] }), choices.map(choice => (_jsxs("button", { type: "button", role: "menuitemradio", "aria-checked": choice === modelValue, className: choice === modelValue ? css.modelItemCurrent : css.modelItem, onClick: () => { setModelDraft(choice); setModelMenuOpen(false); }, children: [_jsx("span", { className: css.modelItemLabel, children: choice }), _jsx("span", { className: css.modelItemCheck, "aria-hidden": true, children: choice === modelValue ? '✓' : '' })] }, choice)))] }))] })) : modelInputElement), _jsx("button", { type: "button", className: css.modelSave, disabled: !ready || modelValue.trim() === storedModel, onClick: () => { saveModel(); }, children: t('model.save') })] }), modelSaved && _jsx("span", { className: css.saved, children: t('model.applied') }), modelError && _jsx("span", { className: css.errorText, children: t('model.error') })] }), _jsxs("section", { className: css.block, children: [_jsxs("div", { className: css.row, children: [_jsxs("span", { className: css.rowLabel, children: [t('live.title'), _jsx(Tooltip, { label: t('live.info'), side: "bottom", maxWidth: 360, children: _jsx("button", { type: "button", className: css.info, "aria-label": t('live.info.aria'), children: "\u24D8" }) })] }), _jsx("button", { type: "button", role: "switch", "aria-checked": live, "aria-label": t('live.title'), className: live ? `${css.switch} ${css.switchOn}` : css.switch, disabled: !ready, onClick: () => { write('live', !live); }, children: _jsx("span", { className: css.knob }) })] }), snapshot.status === 'unavailable' && (_jsx("span", { className: css.hint, children: t('live.unavailable') }))] }), saved && _jsx("span", { className: css.saved, children: t('live.applied') }), error && _jsx("span", { className: css.errorText, children: t('live.error') })] }));
+    return (_jsxs("div", { className: css.body, children: [_jsxs("section", { className: css.block, children: [_jsx("h3", { className: css.blockTitle, children: t('auth.title') }), _jsx(ProviderAuthBlock, { harness: { id: 'dsh', label: 'dsh' }, useSessions: useSessions, status: auth.status, runCommand: auth.runCommand, t: authT }), _jsx("span", { className: css.hint, children: t('auth.host') })] }), _jsxs("section", { className: css.block, children: [_jsxs("h3", { className: css.blockTitle, children: [t('model.title'), _jsx(Tooltip, { label: t('model.info'), side: "bottom", maxWidth: 360, children: _jsx("button", { type: "button", className: css.info, "aria-label": t('model.info.aria'), children: "\u24D8" }) })] }), _jsxs("div", { className: css.row, children: [renderModelPicker?.({ value: modelValue, onChange: setModelDraft, disabled: !ready, defaultLabel: modelDefaultItem }) ?? (choices.length > 0 ? (_jsxs("div", { className: css.modelField, ref: modelFieldRef, children: [modelInputElement, _jsx("button", { type: "button", className: css.modelMenuButton, "aria-label": t('model.menu'), "aria-haspopup": "menu", "aria-expanded": modelMenuOpen, disabled: !ready, onClick: () => { toggleModelMenu(); }, children: _jsx(IconChevronDownOutlineMedium, { className: modelMenuOpen ? `${css.modelMenuChevron} ${css.modelMenuChevronOpen}` : css.modelMenuChevron }) }), modelMenuOpen && (_jsxs("div", { className: modelMenuUp ? `${css.modelMenu} ${css.modelMenuUp}` : css.modelMenu, role: "menu", "aria-label": t('model.menu'), children: [_jsxs("button", { type: "button", role: "menuitemradio", "aria-checked": modelValue.trim() === '', className: modelValue.trim() === '' ? `${css.modelItemDefault} ${css.modelItemCurrent}` : css.modelItemDefault, onClick: () => { setModelDraft(''); setModelMenuOpen(false); }, children: [_jsx("span", { className: css.modelItemLabel, children: modelDefaultItem }), _jsx("span", { className: css.modelItemCheck, "aria-hidden": true, children: modelValue.trim() === '' ? '✓' : '' })] }), choices.map(choice => (_jsxs("button", { type: "button", role: "menuitemradio", "aria-checked": choice === modelValue, className: choice === modelValue ? css.modelItemCurrent : css.modelItem, onClick: () => { setModelDraft(choice); setModelMenuOpen(false); }, children: [_jsx("span", { className: css.modelItemLabel, children: choice }), _jsx("span", { className: css.modelItemCheck, "aria-hidden": true, children: choice === modelValue ? '✓' : '' })] }, choice)))] }))] })) : modelInputElement), _jsx("button", { type: "button", className: css.modelSave, disabled: !ready || modelValue.trim() === storedModel, onClick: () => { saveModel(); }, children: t('model.save') })] }), modelSaved && _jsx("span", { className: css.saved, children: t('model.applied') }), modelError && _jsx("span", { className: css.errorText, children: t('model.error') })] }), _jsxs("section", { className: css.block, children: [_jsxs("div", { className: css.row, children: [_jsxs("span", { className: css.rowLabel, children: [t('live.title'), _jsx(Tooltip, { label: t('live.info'), side: "bottom", maxWidth: 360, children: _jsx("button", { type: "button", className: css.info, "aria-label": t('live.info.aria'), children: "\u24D8" }) })] }), _jsx("button", { type: "button", role: "switch", "aria-checked": live, "aria-label": t('live.title'), className: live ? `${css.switch} ${css.switchOn}` : css.switch, disabled: !ready, onClick: () => { write('live', !live); }, children: _jsx("span", { className: css.knob }) })] }), snapshot.status === 'unavailable' && (_jsx("span", { className: css.hint, children: t('live.unavailable') }))] }), saved && _jsx("span", { className: css.saved, children: t('live.applied') }), error && _jsx("span", { className: css.errorText, children: t('live.error') })] }));
 }
 /**
  * The dsh harness settings card of the retired 0.1.5 plugin configuration

package/lib/types/client/index.js

@@ -1,4 +1,4 @@
-import { bindSettingsScope } from '@khorsheed/dsh-local-agent/src/client/settings-scope.ts';
+import { bindCardSettingsScope } from '@khorsheed/dsh-local-agent/src/client/settings-scope.ts';
 /**
  * Local-agent-dsh plugin, browser half: the dsh settings card — a section of
  * the family core's「本机 Agent 委派」family card on the Plugins page
@@ -45,7 +45,7 @@ export const inject = ['slots', 'remote', 'remote.commands', 'locale'];
 export function apply(ctx) {
     ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'local-agent-dsh: dictionaries');
     const t = ctx.locale.bind(NS);
-    const scope = bindSettingsScope(ctx, 'local-agent-dsh');
+    const scope = bindCardSettingsScope(ctx, 'dsh', 'local-agent-dsh');
     // The auth block's copy lives in the family core's dictionary; binding is
     // stable per namespace and late dictionary registration still resolves.
     const authT = ctx.locale.bind('local-agent');