@morlay/dsh-subagent 0.0.1-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 morlay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# @morlay/dsh-subagent
+
+上游 `@deepseek-ai/dsh-subagent` 的**薄壳 fork**：host 半只改一件事——continuable 子代理首条任务后面的
+**回报指引换成中文**（上游是英文）。服务名（`ctx.subagents`）、providers、其余子路径（`./internal` 等）
+与装配位置都不变。设置页那张「子代理」卡片是本包自己的 client 半（见下），不是从上游 fork 来的。
+
+装配由本包的 bundle patch 完成（`cordis.patch.yml`）：官方 `subagent` 行 `disabled: true` + insert
+`subagent-fork`（`@morlay/dsh-subagent`），并停掉官方设置卡那两条行（`ui-settings-subagent` 与
+`subagent-model-selection-settings`，理由见 [ADR](./.agents/adrs/20260923-设置页自建client半并停掉官方两条入口行.md)）；
+app 的 `dsh.profile.bundles` 里引用本包。
+
+## 保留文件（3 个）
+
+薄壳 fork 只留**有意改过**的文件，其余上游文件不复制——保留文件里指向它们的 import 走相对路径指向
+`vendor/deepseek-harness/packages/subagent/subagent/src/...`，构建时内联进 `dist/index.mjs`
+（发布物自包含）。
+
+| 保留文件（`src/`）         | 保留什么                                                                       |
+| -------------------------- | ------------------------------------------------------------------------------ |
+| `continuation-messages.ts` | **唯一实质改动**：`withContinuableReturnGuidance` 的中文文案（保留父 id 插值） |
+| `continuation.ts`          | 只有一行接线不同：`continuation-messages.ts` 指向本包那一份                    |
+| `index.ts`                 | 接线 + 两处结构性偏离（见下）                                                  |
+
+静态 import 链决定了复制面：`continuation-messages` ← `continuation` ← `index`，要替换中间那一份就得
+连同引用它的两个文件一起接管。原因、被否掉的路线与后果见
+[ADR 薄壳 fork 接管 subagent 行只改回报文案](./.agents/adrs/20260923-薄壳fork接管subagent行只改回报文案.md)。
+
+## 两处结构性偏离
+
+- **`index.ts` 不复述 cordis 合并接口**：上游此处 `declare module '@deepseek-ai/cordis'` 声明
+  `Context.subagents` 与 `subagent/*` 事件；本包 `import type {} from '@deepseek-ai/dsh-subagent'`
+  引用上游那一份（同形声明复述两遍会在同一个 program 里撞 `TS2717`）。
+- **标准装饰器在构建期降级**：`@Remote(...)` 是 TC39 标准装饰器，rolldown/oxc 不降级它（上游管线里这步
+  由 tsc 完成），所以 `tsdown.config.ts` 里有一个 esbuild 预转换（只在检测到装饰器语法时生效）。
+
+本包三个保留文件**不做格式化**（`.oxfmtrc.json` 的 `ignorePatterns`）：它们与上游逐行对照是同步纪律的
+守护面，格式改了那条守护就失去意义。
+
+## 设置页（client 半）
+
+`src/client/` 是**本包自己的代码**（不与上游对照，格式照常走 oxfmt）：Plugins 页里那张「子代理」卡片，
+只有限额一段——递归深度（≥ 0）与并行上限（≥ 1），staged 编辑 + 保存/丢弃。
+
+| 面                                              | 内容                                                                          |
+| ----------------------------------------------- | ----------------------------------------------------------------------------- |
+| `plugins.row.config`（key `@morlay/dsh-subagent#subagent-fork`） | `view: 'summary'` 给一句话说明；`view: 'page'` 给限额表单 |
+| settings namespace `subagent-fork`              | 本包 host 行 id 就是 namespace 名；可编辑字段是 `Config` 的两个 volatile 字段 |
+| locale namespace `settings.subagent`            | 卡片文案（zh + en，标题「子代理」）                                           |
+
+装配只有两条：包声明了 `dsh.client`（`platform: 'web'`）与 `./client` 入口，client 半就随 app-boot 的
+browser roster 一起装（**不需要额外的插行**）；host 行被描述出来之后（`configForms.whileServed(['subagent-fork'])`）
+卡片才注册，行不在时卡片一起消失。表单原语来自 fork 的 `@morlay/dsh-client-ui-primitives/client`
+（`SettingsForm` / `SettingsValueField` / `SettingsFormModel` / `settingsNumberField`）。
+
+## 文档
+
+- 决策与理由：
+  [ADR 薄壳 fork 接管 subagent 行只改回报文案](./.agents/adrs/20260923-薄壳fork接管subagent行只改回报文案.md)、
+  [ADR 设置页自建 client 半并停掉官方两条入口行](./.agents/adrs/20260923-设置页自建client半并停掉官方两条入口行.md)
+- 已知的债（两处 `continuation-messages` 实例、保留文件跟随方式）：
+  [债务 continuation-messages 两份实例与保留文件跟随](./.agents/debts/20260923-continuation-messages两份实例与保留文件跟随.md)
+- 测试落点与判据：[本包规范 how-to-verify](./.agents/standards/how-to-verify.md)；薄壳 fork 的通用写法约束见
+  [`session/ui-conversation` 的 how-to-write](../../session/ui-conversation/.agents/standards/how-to-write.md)
+  （同一形态的包共享那份约束）。
+
+上游同步（patch / 裁剪 / 升级评估）走 `dsh-plugin-upstream-sync` 技能；发布走 CI，本地只构建验证。

package/cordis.patch.yml

@@ -0,0 +1,17 @@
+# 上游 base bundle 的 `subagent` 行（`ctx.subagents` 服务定义）由本包接管：薄壳 fork 只改 continuable
+# 子代理的回报文案，服务名、providers、其余子路径（./internal 等）与装配位置都不变。
+- id: subagent
+  disabled: true
+
+# 设置页那张「Subagent」卡片换成本包自己的 client 半（`src/client/` 读 `subagent-fork` 这个 namespace），
+# 所以官方卡片行与它带的「模型白名单」服务行一起停掉：官方卡片读的是官方 `subagent` 行 id，本部署已没有
+# 那个 namespace；模型白名单那套也不要——子代理模型统一由 session mode 的顶层 `models`（各模式的默认模型）决定。
+- id: ui-settings-subagent
+  disabled: true
+
+- id: subagent-model-selection-settings
+  disabled: true
+
+- insert:
+    - id: subagent-fork
+      name: "@morlay/dsh-subagent"

package/dist/client.cjs

@@ -0,0 +1,265 @@
+window.__ModuleLoader__.load({
+	id: "@morlay/dsh-subagent",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		let _morlay_dsh_client_ui_primitives_client = require("@morlay/dsh-client-ui-primitives/client");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region src/client/SubagentLimitsCard.styles.ts
+		/** 卡片里那一段的样式。 */
+		const styles = {
+			section: {
+				display: "flex",
+				flexDirection: "column",
+				gap: "12px"
+			},
+			heading: {
+				margin: "0",
+				fontSize: "14px",
+				lineHeight: "20px",
+				fontWeight: "600",
+				color: "var(--dsw-alias-label-primary)"
+			},
+			limits: {
+				display: "grid",
+				gridTemplateColumns: "repeat(auto-fit, minmax(240px, 1fr))",
+				gap: "16px"
+			}
+		};
+		//#endregion
+		//#region src/client/locales.ts
+		/** 中文文案（部署语言偏好是 zh）。 */
+		const zh = {
+			overridden: "已覆盖",
+			reset: "恢复默认",
+			readOnly: "本部署的设置为只读。",
+			unavailable: "该插件当前未加载，暂时无法配置。",
+			save: "保存",
+			saving: "保存中…",
+			saveFailed: "本部署没有接受这些值，已保留供你修改。",
+			subagentTitle: "子代理",
+			subagentDescription: "设置子代理的递归深度与并行上限。",
+			subagentLimitsTitle: "运行限制",
+			subagentMaxDepth: "最大递归深度",
+			subagentDepthHelpLabel: "最大递归深度说明",
+			subagentDepthHelp: "限制 Agent 创建子代理的递归层级：「0」禁用子代理，「1」只允许主 Agent 创建子代理，更大的值放开到该层数。某个工具若自带最大深度，以该工具的设置为准。",
+			subagentMaxActive: "子代理并行数量上限",
+			subagentCapacityHelpLabel: "子代理并行数量上限说明",
+			subagentCapacityHelp: "同一主 Agent 下，所有递归层级同时存活的子代理总数，主 Agent 不计入。达到上限时，新的启动请求会被拒绝。",
+			subagentDepthInvalid: "请输入不小于 0 的整数。",
+			subagentCapacityInvalid: "请输入不小于 1 的整数。"
+		};
+		/** 英文文案。 */
+		const en = {
+			overridden: "Overridden",
+			reset: "Reset to default",
+			readOnly: "This deployment stores settings read-only.",
+			unavailable: "This plugin is not loaded, so it cannot be configured right now.",
+			save: "Save",
+			saving: "Saving…",
+			saveFailed: "The deployment did not accept these values; they were left for you to correct.",
+			subagentTitle: "Subagent",
+			subagentDescription: "Set Subagent recursion depth and parallelism limit.",
+			subagentLimitsTitle: "Limits",
+			subagentMaxDepth: "Maximum recursion depth",
+			subagentDepthHelpLabel: "About maximum recursion depth",
+			subagentDepthHelp: "Limits how many levels of Subagents an Agent can create: \"0\" disables Subagents, \"1\" lets only the main Agent create them, and a larger value opens that many levels. A tool that sets its own maximum depth takes precedence.",
+			subagentMaxActive: "Subagent parallelism limit",
+			subagentCapacityHelpLabel: "About the Subagent parallelism limit",
+			subagentCapacityHelp: "Total live Subagents under the same main Agent, across all recursion levels. The main Agent is excluded. New start requests are rejected when the limit is reached.",
+			subagentDepthInvalid: "Enter a whole number of 0 or more.",
+			subagentCapacityInvalid: "Enter a whole number of 1 or more."
+		};
+		/**
+		* 表单外框的文案，从本页字典里读。
+		* @param t - 本页的字典读取器。
+		* @returns 共享设置表单渲染用的标签。
+		*/
+		function formLabels(t) {
+			return {
+				unavailable: t("unavailable"),
+				readOnly: t("readOnly"),
+				saveFailed: t("saveFailed"),
+				save: t("save"),
+				saving: t("saving")
+			};
+		}
+		//#endregion
+		//#region src/client/SubagentLimitsCard.tsx
+		/**
+		* 设置页的「子代理」卡片：限额一段（递归深度与并行上限）。
+		*
+		* 页面画标题与一句话说明，卡片只画控件与保存：`view: 'summary'` 时给那句话，`view: 'page'` 时给表单。
+		* 两个字段都是 staged 编辑——输入只改草稿，保存才写；非法草稿停在屏幕上并禁用保存。
+		*/
+		/**
+		* 画限额那一段（或它的一句话说明）。
+		* @param props - 字典、限额快照、以及编辑与保存/丢弃动作。
+		* @returns 摘要文本，或带保存脚注的限额表单。
+		*/
+		function SubagentLimitsCard(props) {
+			const { t } = props;
+			const state = props.useSubagentLimitsCard((snapshot) => snapshot);
+			const headingId = (0, react.useId)();
+			if (props.view === "summary") return t("subagentDescription");
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_morlay_dsh_client_ui_primitives_client.SettingsForm, {
+				labels: formLabels(t),
+				state,
+				onSave: props.save,
+				onDiscard: props.discard,
+				children: state.available ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+					..._morlay_dsh_client_ui_primitives_client.styling.props(styles.section),
+					"aria-labelledby": headingId,
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+						..._morlay_dsh_client_ui_primitives_client.styling.props(styles.heading),
+						id: headingId,
+						children: t("subagentLimitsTitle")
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						..._morlay_dsh_client_ui_primitives_client.styling.props(styles.limits),
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_morlay_dsh_client_ui_primitives_client.SettingsValueField, {
+							id: "plugin-config-subagent-depth",
+							label: t("subagentMaxDepth"),
+							help: {
+								label: t("subagentDepthHelpLabel"),
+								content: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: t("subagentDepthHelp") })
+							},
+							overriddenLabel: t("overridden"),
+							resetLabel: t("reset"),
+							invalidLabel: t("subagentDepthInvalid"),
+							numeric: true,
+							disabled: !state.writable || state.saving,
+							...state.maxDepth,
+							onEdit: (text) => {
+								props.edit("maxDepth", text);
+							},
+							onReset: () => {
+								props.resetField("maxDepth");
+							}
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_morlay_dsh_client_ui_primitives_client.SettingsValueField, {
+							id: "plugin-config-subagent-capacity",
+							label: t("subagentMaxActive"),
+							help: {
+								label: t("subagentCapacityHelpLabel"),
+								content: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: t("subagentCapacityHelp") })
+							},
+							overriddenLabel: t("overridden"),
+							resetLabel: t("reset"),
+							invalidLabel: t("subagentCapacityInvalid"),
+							numeric: true,
+							disabled: !state.writable || state.saving,
+							...state.maxActiveSubagents,
+							onEdit: (text) => {
+								props.edit("maxActiveSubagents", text);
+							},
+							onReset: () => {
+								props.resetField("maxActiveSubagents");
+							}
+						})]
+					})]
+				}) : null
+			});
+		}
+		//#endregion
+		//#region src/client/subagent-limits-card-controller.ts
+		/** 本包 host 行 id：settings 的命名空间名与 `Config` 的 volatile 字段都在它下面。 */
+		const SUBAGENT_NS = "subagent-fork";
+		/**
+		* 一个整数限额字段：空草稿＝清除（回到默认），其余草稿必须是该字段下限之上的安全整数。
+		* 上游的同名实现就是这样卡住非法输入的——非法草稿保留在屏幕上并阻止保存，而不是被悄悄丢弃。
+		* @param field - 命名空间段内的字段名。
+		* @param minimum - 该字段接受的最小值。
+		* @returns 该字段的转换规则。
+		*/
+		function limitField(field, minimum) {
+			const numeric = (0, _morlay_dsh_client_ui_primitives_client.settingsNumberField)(field);
+			return {
+				...numeric,
+				parse: (text) => {
+					const write = numeric.parse(text);
+					if (write?.kind !== "set") return write;
+					const value = write.value;
+					return Number.isSafeInteger(value) && value >= minimum && !Object.is(value, -0) ? write : void 0;
+				}
+			};
+		}
+		/** 把两个限额绑在一个 staged 表单上。 */
+		var SubagentLimitsCardController = class {
+			form;
+			store;
+			/**
+			* @param scope - 本包 host 行（`subagent-fork`）的共享配置表单。
+			*/
+			constructor(scope) {
+				this.form = new _morlay_dsh_client_ui_primitives_client.SettingsFormModel(scope, [limitField("maxDepth", 0), limitField("maxActiveSubagents", 1)]);
+				this.store = this.form.bind(() => ({
+					...this.form.shell(),
+					maxDepth: this.form.field("maxDepth"),
+					maxActiveSubagents: this.form.field("maxActiveSubagents")
+				}));
+			}
+			/**
+			* 把限额编辑器绑到槽位渲染器上。
+			* @returns 限额快照与 staged 写动作。
+			*/
+			inject() {
+				return {
+					hooks: { subagentLimitsCard: this.store },
+					...this.form.actions()
+				};
+			}
+			/** 释放对已接受值的订阅。 */
+			dispose() {
+				this.form.dispose();
+			}
+		};
+		//#endregion
+		//#region src/client/index.ts
+		/** 本页字典的命名空间。 */
+		const NS = "settings.subagent";
+		/**
+		* 本行的配置入口 key：`<bundle 包名>#<行 id>`。
+		*
+		* 页面侧由 `ui-plugin-manager` 的 `rowConfigKey(bundle, rowId)` 生成同一个串——bundle 是本包
+		* （`dsh.profile.bundles` 里那一项），行 id 是本包 patch 里插的 `subagent-fork`。
+		*/
+		const SUBAGENT_ROW_CONFIG_KEY = "@morlay/dsh-subagent#subagent-fork";
+		/** 需要的服务：槽位（ui-renderer 提供的 registry）、字典、共享配置表单。 */
+		const inject = [
+			"slots",
+			"locale",
+			"configForms"
+		];
+		/**
+		* 装上设置页那张卡片。
+		* @param ctx - 浏览器插件上下文。
+		*/
+		function apply(ctx) {
+			const t = ctx.locale.bind(NS);
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "dsh-subagent: dictionaries");
+			const limits = new SubagentLimitsCardController(ctx.configForms.get(SUBAGENT_NS));
+			ctx.effect(() => () => {
+				limits.dispose();
+			}, "dsh-subagent: limits form subscription");
+			const face = limits.inject();
+			ctx.effect(() => ctx.configForms.whileServed([SUBAGENT_NS], () => ctx.slots.inject("plugins.row.config", () => ctx.slots.register({
+				name: "plugins.row.config",
+				key: SUBAGENT_ROW_CONFIG_KEY,
+				inject: () => ({
+					...face,
+					t
+				})
+			}, SubagentLimitsCard))), "dsh-subagent: settings page");
+		}
+		//#endregion
+		exports.NS = NS;
+		exports.SUBAGENT_ROW_CONFIG_KEY = SUBAGENT_ROW_CONFIG_KEY;
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});

package/dist/client.d.cts

@@ -0,0 +1,78 @@
+import { Context } from "@deepseek-ai/cordis";
+import { SettingsFieldState, SettingsFormActions, SettingsFormShell } from "@morlay/dsh-client-ui-primitives/client";
+import { InjectFace, PropsRuntime, TranslateNS } from "@deepseek-ai/dsh-client-ui-slots";
+import { SnapshotStore } from "@deepseek-ai/dsh-client-store";
+//#region src/client/locales.d.ts
+/** 中文文案（部署语言偏好是 zh）。 */
+declare const zh: {
+  overridden: string;
+  reset: string;
+  readOnly: string;
+  unavailable: string;
+  save: string;
+  saving: string;
+  saveFailed: string;
+  subagentTitle: string;
+  subagentDescription: string;
+  subagentLimitsTitle: string;
+  subagentMaxDepth: string;
+  subagentDepthHelpLabel: string;
+  subagentDepthHelp: string;
+  subagentMaxActive: string;
+  subagentCapacityHelpLabel: string;
+  subagentCapacityHelp: string;
+  subagentDepthInvalid: string;
+  subagentCapacityInvalid: string;
+};
+/** 本卡片渲染的文案 key。 */
+type SubagentSettingsLocaleKey = keyof typeof zh;
+//#endregion
+//#region src/client/subagent-limits-card-controller.d.ts
+/** host 侧的委派默认值与实时容量（`SubagentRuntime.Config` 的两个 volatile 字段）。 */
+interface SubagentLimitsSettings {
+  maxDepth: number;
+  maxActiveSubagents: number;
+}
+/** 限额卡片呈现的生效值与草稿。 */
+interface SubagentLimitsCardState extends SettingsFormShell {
+  maxDepth: SettingsFieldState;
+  maxActiveSubagents: SettingsFieldState;
+}
+/** 槽位渲染器绑定的动作与可观察状态。 */
+interface SubagentLimitsCardFace extends SettingsFormActions {
+  hooks: {
+    subagentLimitsCard: SnapshotStore<SubagentLimitsCardState>;
+  };
+}
+//#endregion
+//#region src/client/SubagentLimitsCard.d.ts
+/** 槽位渲染器给卡片的 props：运行时面 + 限额表单与字典的注入面（`t` 由本包的 `inject` 面带进来）。 */
+type SubagentLimitsCardProps = PropsRuntime<"plugins.row.config"> & InjectFace<SubagentLimitsCardFace & {
+  t: TranslateNS<"settings.subagent">;
+}>;
+//#endregion
+//#region src/client/index.d.ts
+declare module "@deepseek-ai/dsh-client-ui-slots" {
+  interface LocaleNamespaceMap {
+    /** 子代理设置卡的文案。 */
+    "settings.subagent": SubagentSettingsLocaleKey;
+  }
+}
+/** 本页字典的命名空间。 */
+declare const NS = "settings.subagent";
+/**
+ * 本行的配置入口 key：`<bundle 包名>#<行 id>`。
+ *
+ * 页面侧由 `ui-plugin-manager` 的 `rowConfigKey(bundle, rowId)` 生成同一个串——bundle 是本包
+ * （`dsh.profile.bundles` 里那一项），行 id 是本包 patch 里插的 `subagent-fork`。
+ */
+declare const SUBAGENT_ROW_CONFIG_KEY = "@morlay/dsh-subagent#subagent-fork";
+/** 需要的服务：槽位（ui-renderer 提供的 registry）、字典、共享配置表单。 */
+declare const inject: string[];
+/**
+ * 装上设置页那张卡片。
+ * @param ctx - 浏览器插件上下文。
+ */
+declare function apply(ctx: Context): void;
+//#endregion
+export { NS, SUBAGENT_ROW_CONFIG_KEY, type SubagentLimitsCardFace, type SubagentLimitsCardProps, type SubagentLimitsCardState, type SubagentLimitsSettings, type SubagentSettingsLocaleKey, apply, inject };

package/dist/client.d.mts

@@ -0,0 +1,78 @@
+import { SettingsFieldState, SettingsFormActions, SettingsFormShell } from "@morlay/dsh-client-ui-primitives/client";
+import { Context } from "@deepseek-ai/cordis";
+import { InjectFace, PropsRuntime, TranslateNS } from "@deepseek-ai/dsh-client-ui-slots";
+import { SnapshotStore } from "@deepseek-ai/dsh-client-store";
+//#region src/client/locales.d.ts
+/** 中文文案（部署语言偏好是 zh）。 */
+declare const zh: {
+  overridden: string;
+  reset: string;
+  readOnly: string;
+  unavailable: string;
+  save: string;
+  saving: string;
+  saveFailed: string;
+  subagentTitle: string;
+  subagentDescription: string;
+  subagentLimitsTitle: string;
+  subagentMaxDepth: string;
+  subagentDepthHelpLabel: string;
+  subagentDepthHelp: string;
+  subagentMaxActive: string;
+  subagentCapacityHelpLabel: string;
+  subagentCapacityHelp: string;
+  subagentDepthInvalid: string;
+  subagentCapacityInvalid: string;
+};
+/** 本卡片渲染的文案 key。 */
+type SubagentSettingsLocaleKey = keyof typeof zh;
+//#endregion
+//#region src/client/subagent-limits-card-controller.d.ts
+/** host 侧的委派默认值与实时容量（`SubagentRuntime.Config` 的两个 volatile 字段）。 */
+interface SubagentLimitsSettings {
+  maxDepth: number;
+  maxActiveSubagents: number;
+}
+/** 限额卡片呈现的生效值与草稿。 */
+interface SubagentLimitsCardState extends SettingsFormShell {
+  maxDepth: SettingsFieldState;
+  maxActiveSubagents: SettingsFieldState;
+}
+/** 槽位渲染器绑定的动作与可观察状态。 */
+interface SubagentLimitsCardFace extends SettingsFormActions {
+  hooks: {
+    subagentLimitsCard: SnapshotStore<SubagentLimitsCardState>;
+  };
+}
+//#endregion
+//#region src/client/SubagentLimitsCard.d.ts
+/** 槽位渲染器给卡片的 props：运行时面 + 限额表单与字典的注入面（`t` 由本包的 `inject` 面带进来）。 */
+type SubagentLimitsCardProps = PropsRuntime<"plugins.row.config"> & InjectFace<SubagentLimitsCardFace & {
+  t: TranslateNS<"settings.subagent">;
+}>;
+//#endregion
+//#region src/client/index.d.ts
+declare module "@deepseek-ai/dsh-client-ui-slots" {
+  interface LocaleNamespaceMap {
+    /** 子代理设置卡的文案。 */
+    "settings.subagent": SubagentSettingsLocaleKey;
+  }
+}
+/** 本页字典的命名空间。 */
+declare const NS = "settings.subagent";
+/**
+ * 本行的配置入口 key：`<bundle 包名>#<行 id>`。
+ *
+ * 页面侧由 `ui-plugin-manager` 的 `rowConfigKey(bundle, rowId)` 生成同一个串——bundle 是本包
+ * （`dsh.profile.bundles` 里那一项），行 id 是本包 patch 里插的 `subagent-fork`。
+ */
+declare const SUBAGENT_ROW_CONFIG_KEY = "@morlay/dsh-subagent#subagent-fork";
+/** 需要的服务：槽位（ui-renderer 提供的 registry）、字典、共享配置表单。 */
+declare const inject: string[];
+/**
+ * 装上设置页那张卡片。
+ * @param ctx - 浏览器插件上下文。
+ */
+declare function apply(ctx: Context): void;
+//#endregion
+export { NS, SUBAGENT_ROW_CONFIG_KEY, type SubagentLimitsCardFace, type SubagentLimitsCardProps, type SubagentLimitsCardState, type SubagentLimitsSettings, type SubagentSettingsLocaleKey, apply, inject };