@monotykamary/dsh-client-ui-subagent 0.1.0-rc.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+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.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the 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/client/ui-subagent/README.md
+README.md: 0ce6b6ec3c87c0d1b77e82eab692282cd00fd03b
+README.zh.md: a6ef89bbb5a5a68d19993a9e7ea80fa89c802799

package/README.md

@@ -0,0 +1,34 @@
+# @monotykamary/dsh-client-ui-subagent
+
+English | [中文](README.zh.md)
+
+Web subagent feature owner: contributes the lazily expandable catalog tree to `conversation.session.header.actions`, reason-specific read-only replacements to the conversation composer chain, and the existing `@` reference source to `ctx.inputTriggers`.
+
+The header action reads `subagentsByParent` and session summaries through the standard `useSessions` hook. After a non-empty direct catalog arrives, its trigger counts the complete subagent-only descendant lineage, stops at ordinary forks, and shows ongoing activity when any counted descendant is running. The compact tree remains direct-catalog authoritative: continuable and one-shot rows display mode plus `running`/`inactive` activity and an optional log-backed title, while the trailing column stacks total durable provider usage above active-turn duration. Token totals sum the four disjoint `tokenUsage` buckets. Visual duration stays exact to the second below one day, then uses at most two adjacent units—days/hours, approximate months/days, or approximate years/months—while hover and the accessible name retain the exact day/hour/minute/second value. Duration sums completed `subagentTiming` turns, advances once per second only for an open turn on a running child, and freezes after the child becomes inactive; an interrupted open turn is bounded by its same-cut `active.through`, never by newer session metadata. An unlabeled one-shot row falls back to its session id, while corrupt, unsupported, or unavailable rows remain readable but disabled. Each healthy row's `hasChildren` hint determines disclosure before interaction, so known leaves never show an arrow; a catalog level reserves the disclosure column only when at least one healthy row is a branch, allowing branchless levels to start at the leading status marker. Expanding a branch immediately reserves one disabled loading row per known direct descendant, then lazily replaces them with that child's authoritative catalog. Every visible branch is reported to the runtime so membership frames cause a debounced refresh only where the tree is being consumed. Selecting any depth calls `SessionRuntime.openSubagent()` with the row's exact `{parentSessionId, childSessionId, mode}` address. Component-local state owns tree visibility, expanded branches, keyboard focus, and the running-duration clock. ArrowRight/ArrowLeft expand and collapse branches; ArrowUp/ArrowDown, Home, End, and Escape navigate or close the tree; closing returns focus to the trigger. Styling uses tokens only.
+
+A one-shot child always elects a read-only composer that identifies the transcript as a completed execution record. A continuable child does so only when its exact parent is unavailable and the child is not running, with copy explaining the recovery path; while such a child still runs, the selector yields to the ordinary composer, whose input and Send action are disabled but whose independent Stop stays usable, and the takeover returns once it stops. A continuable child with a live parent keeps the ordinary input chrome, whose Session routes prompts through `subagent.prompt`: typing and Send stay available while the child runs because every follow-up joins the child's FIFO inbox, while an independent Stop routes through `subagent.interrupt`. This package never receives host context or calls a model-facing tool. The catalog and composer behavior are specified by the [Web subagent conversations Agent Note](../../../.agents/notes/implemented/feature/2026-07-27-web-subagent-conversations.md) and the [current-turn interrupt Agent Note](../../../.agents/notes/implemented/feature/2026-08-06-continuable-subagent-interrupt.md).
+
+Subagent-origin Session rows are omitted from the ordinary sidebar, so the parent header catalog is their navigation entry point. Ordinary forks remain in the sidebar.
+
+The `@` source remains deliberately separate and inert. Candidates are zero-RPC running children from `ctx.sessions.list`; picking one inserts literal `@label ` text, and the codec projects `@label`. It has no command-adjudication hooks and does not resolve labels into continuation addresses.
+
+## Model Experience
+
+### Subagent label text in the user prompt
+
+#### What the model sees
+
+Only the legacy `@` reference source affects model input: a picked candidate reaches the ordinary user message as literal `@label`, without a dedicated block or host-side resolution. Catalog browsing, child navigation, and persisted transcript viewing add no prompt section; accepted continuation content becomes a normal FIFO user message through the host subagent adapter.
+
+#### Token effect
+
+Conditional and append-only: the literal `@label` or a human follow-up adds tokens only to its new user message. Catalog and transcript operations add zero model tokens.
+
+#### KV Cache effect
+
+Append-only. This package never edits earlier request tokens.
+
+## Known Limitations and Deferred Work
+
+- **The catalog has no durable outcome** — activity and timing do not distinguish completion, failure, or cancellation, and the UI exposes no Activation identity; stopping is limited to the composer's current-turn Stop for a running continuable child.
+- **`@` references remain display-title text** — duplicate or renamed labels are ambiguous, so they intentionally do not acquire continuation semantics.

package/README.zh.md

@@ -0,0 +1,34 @@
+# @monotykamary/dsh-client-ui-subagent
+
+[English](README.md) | 中文
+
+Web subagent 功能 owner：向 `conversation.session.header.actions` 贡献可懒加载展开的目录树，向会话编辑器链贡献按原因区分的只读替代呈现，并保留注册到 `ctx.inputTriggers` 的既有 `@` 引用 source。
+
+页头操作通过标准 `useSessions` 钩子读取 `subagentsByParent` 与会话摘要。非空直接目录到达后，其触发器会统计仅含 subagent 的完整后代谱系，在普通 fork 处停止，并在任一计入统计的后代处于 `running` 时显示活动仍在进行。紧凑树仍以直接目录为权威依据：可继续和 one-shot 行会显示 mode、`running`／`inactive` 活动状态和由日志支撑的可选 title，尾随列则在上行显示提供方的持久化 token 用量总计，在下行显示活跃轮次耗时。token 用量总计为四个互不重叠的 `tokenUsage` 桶之和。视觉耗时在不足一天时精确到秒，达到一天后则最多使用两个相邻单位——天／小时、近似月份／天或近似年份／月份——而悬停信息与无障碍名称会保留精确的天／小时／分钟／秒数值。耗时会累加已完成的 `subagentTiming` 轮次，仅在运行中 child 存在未结束轮次时每秒递增一次，并在 child 变为 inactive 后冻结；被中断的未结束轮次以其同一切面的 `active.through` 为上界，绝不使用更新的会话元数据。没有 label 的 one-shot 行会回退到其会话 id，而损坏、不受支持或不可用的行仍保持可读但禁用。每个健康行的 `hasChildren` 提示会在交互前决定是否显示展开控件，因此已知叶子节点从不显示箭头；每层目录仅在其中至少一个健康行是分支时才预留展开列，使完全不含分支的层级能从最前面的状态标记开始。展开分支时，会立即为每个已知直接后代预留一行禁用的加载行，随后再用该 child 的权威目录懒加载结果替换这些占位行。每个可见分支都会上报给运行时，使成员帧只在树正被消费的位置触发去抖动刷新。选择任意深度的条目都会使用该行的确切地址 `{parentSessionId, childSessionId, mode}` 调用 `SessionRuntime.openSubagent()`。组件局部状态负责树的可见性、已展开分支、键盘焦点与运行中耗时时钟。ArrowRight／ArrowLeft 展开和折叠分支；ArrowUp／ArrowDown、Home、End 与 Escape 用于导航或关闭树；关闭后焦点返回触发器。样式只使用 token。
+
+one-shot child 始终选用只读编辑器，并将 transcript（文本记录）说明为已完成的执行记录。可继续 child 仅在其确切 parent 不可用且 child 未在运行时选用只读编辑器，并以文案说明恢复路径；此类 child 仍在运行期间，selector 会让位给普通编辑器——其输入区与 Send 操作被禁用，但独立的 Stop 保持可用，停止后只读替代恢复。确切 parent 存活时，可继续 child 保留普通输入 chrome，其会话通过 `subagent.prompt` 路由提示词：child 运行期间输入和 Send 保持可用，因为每条后续消息都会进入 child 的 FIFO inbox，而独立的 Stop 经由 `subagent.interrupt` 路由。本包绝不接收宿主上下文，也不调用面向模型的工具。目录与编辑器行为由 [Web subagent 对话 Agent Note](../../../.agents/notes/implemented/feature/2026-07-27-web-subagent-conversations.md) 与[当前轮次中断 Agent Note](../../../.agents/notes/implemented/feature/2026-08-06-continuable-subagent-interrupt.md) 规定。
+
+普通侧边栏会省略带 subagent origin 的会话行，因此 parent 页头目录是它们的导航入口。普通 fork 仍保留在侧边栏中。
+
+`@` source 仍然刻意保持独立且惰性。候选是从 `ctx.sessions.list` 零 RPC 得到的运行中 child；pick 会插入字面文本 `@label `，codec 投影为 `@label`。它不参与命令裁决，也不会把 label 解析成继续执行地址。
+
+## 模型体验
+
+### 用户提示词中的 subagent label 文本
+
+#### 模型看到的内容
+
+只有旧有 `@` 引用 source 会影响模型输入：pick 的候选以字面文本 `@label` 进入普通用户消息，没有专用内容块或宿主侧解析。浏览目录、导航 child 与查看持久化 transcript 都不会添加提示词 section；已接收的继续交互内容会经宿主 subagent 适配器成为普通 FIFO 用户消息。
+
+#### Token 影响
+
+有条件且仅追加：字面 `@label` 或用户后续消息只会向对应的新用户消息增加 token。目录与 transcript 操作增加零模型 token。
+
+#### KV Cache 影响
+
+仅追加。本包绝不改写更早的请求 token。
+
+## 已知限制与暂缓事项
+
+- **目录没有持久化结果**：活动状态与计时无法区分完成、失败或取消，且 UI 不公开 Activation 身份；停止能力仅限编辑器上针对运行中可继续 child 的当前轮次 Stop。
+- **`@` 引用仍是显示标题文本**：重复或改名后的 label 会有歧义，因此它们刻意不获得继续执行语义。

package/lib/client.js

@@ -0,0 +1,710 @@
+window.__ModuleLoader__.load({
+	id: "@monotykamary/dsh-client-ui-subagent",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react_jsx_runtime = require("react/jsx-runtime");
+		let react = require("react");
+		let _monotykamary_dsh_client_runtime_client = require("@monotykamary/dsh-client-runtime/client");
+		let _monotykamary_dsh_client_ui_primitives = require("@monotykamary/dsh-client-ui-primitives");
+		//#region \0dsh-css:/Users/monotykamary/VCS/working-remote/open-source/deepseek-harness/packages/client/ui-subagent/src/client/SubagentCatalogAction.module.css.mjs
+		const css$1 = ".F4LKcq_root{position:relative}.F4LKcq_trigger{min-height:28px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:0;border-radius:6px;align-items:center;gap:3px;padding:3px 2px;font-size:12px;line-height:18px;display:inline-flex}.F4LKcq_count{margin:0 5px}.F4LKcq_activitySlot{flex:none;width:10px;height:10px;display:inline-flex}.F4LKcq_trigger:hover,.F4LKcq_trigger:focus-visible{color:var(--dsw-alias-label-secondary)}.F4LKcq_trigger svg{transition:transform .12s}.F4LKcq_triggerOpen{transform:rotate(180deg)}.F4LKcq_menu{z-index:100;box-sizing:border-box;background:var(--dsw-specific-menu);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);width:336px;max-width:min(400px,100vw - 32px);max-height:min(560px,100vh - 140px);box-shadow:var(--dsw-shadow-lv3);border-radius:12px;flex-direction:column;padding:4px;display:flex;position:absolute;top:calc(100% + 5px);left:0;overflow:auto}.F4LKcq_node{min-width:0;position:relative}.F4LKcq_menu>.F4LKcq_node{margin-left:-3px}.F4LKcq_row{box-sizing:border-box;width:100%;min-height:50px;color:var(--dsw-alias-label-primary);text-align:left;cursor:pointer;background:0 0;border:0;border-radius:8px;outline:none;align-items:flex-start;gap:8px;padding:7px 8px 7px 11px;font-size:13px;line-height:18px;display:flex;position:relative}.F4LKcq_row:hover>.F4LKcq_clickarea,.F4LKcq_row:focus-visible>.F4LKcq_clickarea{background:var(--dsw-alias-interactive-bg-hover)}.F4LKcq_clickarea{box-sizing:border-box;border-radius:8px;flex:1;align-self:stretch;align-items:flex-start;gap:8px;min-width:0;margin:-7px -8px;padding:7px 8px;display:flex}.F4LKcq_row>[data-state],.F4LKcq_clickarea>[data-state]{margin-top:4px}.F4LKcq_disabled{color:var(--dsw-alias-label-dimmed);cursor:not-allowed}.F4LKcq_disabled:hover{background:0 0}.F4LKcq_loadingRow{cursor:default}.F4LKcq_disclosure,.F4LKcq_disclosureSpace{flex:none;width:14px;height:18px}.F4LKcq_disclosure{color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:0;justify-content:center;align-items:center;padding:0;transition:transform .12s;display:inline-flex}.F4LKcq_disclosure:hover{color:var(--dsw-alias-label-primary)}.F4LKcq_disclosureOpen{transform:rotate(90deg)}.F4LKcq_content{flex-direction:column;flex:1;min-width:0;display:flex}.F4LKcq_label,.F4LKcq_summary{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.F4LKcq_label{color:inherit;font-weight:400}.F4LKcq_summary,.F4LKcq_metrics{color:var(--dsw-alias-label-tertiary);font-size:11px;line-height:16px}.F4LKcq_metrics{font-variant-numeric:tabular-nums;text-align:right;white-space:nowrap;flex:none;grid-template-rows:18px 16px;display:grid}.F4LKcq_metricToken{grid-row:1;line-height:18px}.F4LKcq_metricDuration{grid-row:2}.F4LKcq_children{margin-left:18px;padding-left:4px;position:relative}.F4LKcq_children:before,.F4LKcq_children>.F4LKcq_node:before{content:\"\";border-left:1px solid var(--dsw-alias-border-l2);position:absolute;left:0}.F4LKcq_children:before{height:26px;top:-26px}.F4LKcq_children[aria-busy=true]:before{content:none}.F4LKcq_children>.F4LKcq_node:before{top:0;bottom:0;left:-4px}.F4LKcq_children>.F4LKcq_node:last-child:before{height:17px;bottom:auto}.F4LKcq_children>.F4LKcq_node>.F4LKcq_row:before{content:\"\";border-top:1px solid var(--dsw-alias-border-l2);width:14px;position:absolute;top:16px;left:-4px}.F4LKcq_notice,.F4LKcq_error{color:var(--dsw-alias-label-tertiary);padding:10px 12px;font-size:12px;line-height:18px}.F4LKcq_error{color:var(--dsw-alias-state-error-primary);justify-content:space-between;align-items:center;gap:12px;display:flex}.F4LKcq_refresh{color:inherit;cursor:pointer;background:0 0;border:0;border-radius:6px;flex:none;align-items:center;gap:4px;padding:4px 6px;display:inline-flex}.F4LKcq_refresh:hover{background:var(--dsw-alias-interactive-bg-hover)}";
+		const tagId$1 = "@monotykamary/dsh-client-ui-subagent/SubagentCatalogAction.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@monotykamary/dsh-client-ui-subagent";
+			tag.dataset.pluginCss = tagId$1;
+			tag.textContent = css$1;
+			document.head.appendChild(tag);
+		}
+		var SubagentCatalogAction_module_css_default = {
+			"disabled": "F4LKcq_disabled",
+			"summary": "F4LKcq_summary",
+			"disclosureOpen": "F4LKcq_disclosureOpen",
+			"label": "F4LKcq_label",
+			"root": "F4LKcq_root",
+			"content": "F4LKcq_content",
+			"clickarea": "F4LKcq_clickarea",
+			"refresh": "F4LKcq_refresh",
+			"triggerOpen": "F4LKcq_triggerOpen",
+			"count": "F4LKcq_count",
+			"trigger": "F4LKcq_trigger",
+			"metricToken": "F4LKcq_metricToken",
+			"children": "F4LKcq_children",
+			"notice": "F4LKcq_notice",
+			"error": "F4LKcq_error",
+			"disclosureSpace": "F4LKcq_disclosureSpace",
+			"row": "F4LKcq_row",
+			"menu": "F4LKcq_menu",
+			"disclosure": "F4LKcq_disclosure",
+			"node": "F4LKcq_node",
+			"activitySlot": "F4LKcq_activitySlot",
+			"loadingRow": "F4LKcq_loadingRow",
+			"metrics": "F4LKcq_metrics",
+			"metricDuration": "F4LKcq_metricDuration"
+		};
+		//#endregion
+		//#region lib/types/client/SubagentCatalogAction.js
+		function diagnosticReason(entry, t) {
+			switch (entry.reason) {
+				case "corrupt": return t("diagnostic.corrupt");
+				case "unsupported": return t("diagnostic.unsupported");
+				case "unavailable": return t("diagnostic.unavailable");
+			}
+		}
+		function treeItems(root) {
+			return root === null ? [] : Array.from(root.querySelectorAll("[role=\"treeitem\"]:not([aria-disabled=\"true\"])"));
+		}
+		/** Compact token count shared in shape with the conversation stats strip. */
+		function formatTokens(value) {
+			const scaled = (next) => next >= 100 ? String(Math.round(next)) : String(Math.round(next * 10) / 10);
+			if (value < 1e3) return String(value);
+			if (value < 1e6) return `${scaled(value / 1e3)}K`;
+			return `${scaled(value / 1e6)}M`;
+		}
+		/** Sum the four disjoint durable provider-usage buckets. */
+		function tokenTotal(usage) {
+			return usage === void 0 ? void 0 : usage.uncachedInputTokens + usage.outputTokens + usage.cacheReadTokens + usage.cacheWriteTokens;
+		}
+		/** Exact whole-second active-turn duration for one catalog row. */
+		function activityDuration(summary, activity, now) {
+			if (summary === void 0) return void 0;
+			const timing = summary.projectionValues?.subagentTiming;
+			if (timing === void 0) return void 0;
+			if (timing.active === void 0) return timing.settledMs;
+			const end = activity === "running" ? now : timing.active.through;
+			return timing.settledMs + Math.max(0, end - timing.active.since);
+		}
+		function splitDuration(ms) {
+			const totalSeconds = Math.floor(Math.max(0, ms) / 1e3);
+			const totalMinutes = Math.floor(totalSeconds / 60);
+			const totalHours = Math.floor(totalMinutes / 60);
+			return {
+				seconds: totalSeconds % 60,
+				minutes: totalMinutes % 60,
+				hours: totalHours % 24,
+				days: Math.floor(totalHours / 24),
+				totalMinutes,
+				totalHours
+			};
+		}
+		/** Format a duration with decreasing visual precision at larger scales. */
+		function formatDuration(ms, t) {
+			const { seconds, minutes, hours, days, totalMinutes, totalHours } = splitDuration(ms);
+			if (days >= 365) {
+				const years = Math.floor(days / 365);
+				const months = Math.floor(days % 365 / 30);
+				return months === 0 ? t("duration.years", { years }) : t("duration.yearsMonths", {
+					years,
+					months
+				});
+			}
+			if (days >= 30) {
+				const months = Math.floor(days / 30);
+				const remainingDays = days % 30;
+				return remainingDays === 0 ? t("duration.months", { months }) : t("duration.monthsDays", {
+					months,
+					days: remainingDays
+				});
+			}
+			if (days > 0) return hours === 0 ? t("duration.days", { days }) : t("duration.daysHours", {
+				days,
+				hours
+			});
+			if (totalHours > 0) return t("duration.hours", {
+				hours: totalHours,
+				minutes: String(minutes).padStart(2, "0"),
+				seconds: String(seconds).padStart(2, "0")
+			});
+			if (totalMinutes > 0) return t("duration.minutes", {
+				minutes: totalMinutes,
+				seconds: String(seconds).padStart(2, "0")
+			});
+			return t("duration.seconds", { seconds });
+		}
+		/** Preserve exact whole seconds for hover and accessible naming. */
+		function formatExactDuration(ms, t) {
+			const { seconds, minutes, hours, days } = splitDuration(ms);
+			return days === 0 ? formatDuration(ms, t) : t("duration.exactDays", {
+				days,
+				hours: String(hours).padStart(2, "0"),
+				minutes: String(minutes).padStart(2, "0"),
+				seconds: String(seconds).padStart(2, "0")
+			});
+		}
+		const NO_DESCENDANTS = {
+			count: 0,
+			runningCount: 0
+		};
+		/** Render the known direct-child shape while its authoritative catalog hydrates. */
+		function CatalogLoadingRows({ parentSessionId, summaries, level, t }) {
+			const children = Object.values(summaries).filter((summary) => summary.origin === "subagent" && summary.parentId === parentSessionId);
+			if (children.length === 0) return (0, react_jsx_runtime.jsx)("div", {
+				className: SubagentCatalogAction_module_css_default.notice,
+				children: t("loading.label")
+			});
+			return children.map((summary) => (0, react_jsx_runtime.jsx)("div", {
+				className: SubagentCatalogAction_module_css_default.node,
+				children: (0, react_jsx_runtime.jsxs)("div", {
+					role: "treeitem",
+					"aria-disabled": "true",
+					"aria-level": level,
+					"aria-label": t("loading.aria"),
+					className: `${SubagentCatalogAction_module_css_default.row} ${SubagentCatalogAction_module_css_default.disabled} ${SubagentCatalogAction_module_css_default.loadingRow}`,
+					children: [
+						(0, react_jsx_runtime.jsx)("span", { className: SubagentCatalogAction_module_css_default.disclosureSpace }),
+						(0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.StateDot, { state: summary.running ? "ongoing" : "done" }),
+						(0, react_jsx_runtime.jsx)("span", {
+							className: SubagentCatalogAction_module_css_default.content,
+							children: (0, react_jsx_runtime.jsx)("span", {
+								className: SubagentCatalogAction_module_css_default.label,
+								children: t("loading.label")
+							})
+						})
+					]
+				})
+			}, summary.id));
+		}
+		/** Render one catalog level and recurse only through explicitly expanded rows. */
+		function CatalogRows({ parentSessionId, catalog, catalogs, summaries, expanded, level, now, openChild, refresh, toggleBranch, closeCatalog, t }) {
+			const emptyLoading = catalog.state === "loading" && catalog.entries.length === 0;
+			const reserveDisclosure = catalog.entries.some((entry) => entry.kind === "child" && entry.hasChildren);
+			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				emptyLoading && (0, react_jsx_runtime.jsx)(CatalogLoadingRows, {
+					parentSessionId,
+					summaries,
+					level,
+					t
+				}),
+				catalog.state === "error" && (0, react_jsx_runtime.jsxs)("div", {
+					className: SubagentCatalogAction_module_css_default.error,
+					children: [(0, react_jsx_runtime.jsx)("span", { children: catalog.error?.message ?? t("load.error") }), (0, react_jsx_runtime.jsxs)("button", {
+						type: "button",
+						className: SubagentCatalogAction_module_css_default.refresh,
+						onClick: () => {
+							refresh(parentSessionId);
+						},
+						children: [(0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.IconRefreshOutline14, {}), t("retry")]
+					})]
+				}),
+				catalog.entries.map((entry) => {
+					if (entry.kind === "diagnostic") {
+						const reason = diagnosticReason(entry, t);
+						return (0, react_jsx_runtime.jsx)("div", {
+							className: SubagentCatalogAction_module_css_default.node,
+							children: (0, react_jsx_runtime.jsxs)("div", {
+								role: "treeitem",
+								"aria-disabled": "true",
+								"aria-level": level,
+								"aria-label": `${entry.id} ${reason}`,
+								className: `${SubagentCatalogAction_module_css_default.row} ${SubagentCatalogAction_module_css_default.disabled}`,
+								title: reason,
+								children: [
+									reserveDisclosure && (0, react_jsx_runtime.jsx)("span", { className: SubagentCatalogAction_module_css_default.disclosureSpace }),
+									(0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.StateDot, { state: "error" }),
+									(0, react_jsx_runtime.jsxs)("span", {
+										className: SubagentCatalogAction_module_css_default.content,
+										children: [(0, react_jsx_runtime.jsx)("span", {
+											className: SubagentCatalogAction_module_css_default.label,
+											children: entry.id
+										}), (0, react_jsx_runtime.jsx)("span", {
+											className: SubagentCatalogAction_module_css_default.summary,
+											children: reason
+										})]
+									})
+								]
+							})
+						}, entry.id);
+					}
+					const childCatalog = catalogs[entry.id];
+					const isExpanded = expanded.has(entry.id);
+					const knownLeaf = !entry.hasChildren;
+					const childLoading = childCatalog === void 0 || childCatalog.state === "loading" && childCatalog.entries.length === 0;
+					const summary = summaries[entry.id];
+					const label = entry.label ?? entry.id;
+					const mode = entry.mode === "one-shot" ? t("mode.oneShot") : t("mode.continuable");
+					const activity = entry.activity === "running" ? t("activity.running") : t("activity.inactive");
+					const secondary = [
+						summary?.title,
+						mode,
+						activity
+					].filter((value) => value !== void 0).join(" · ");
+					const totalTokens = tokenTotal(summary?.projectionValues?.tokenUsage);
+					const durationMs = activityDuration(summary, entry.activity, now);
+					const tokenMetric = totalTokens === void 0 ? void 0 : `${formatTokens(totalTokens)} tok`;
+					const durationMetric = durationMs === void 0 ? void 0 : {
+						compact: formatDuration(durationMs, t),
+						exact: formatExactDuration(durationMs, t)
+					};
+					const metrics = [tokenMetric, durationMetric?.exact].filter((value) => value !== void 0).join(" · ");
+					const open = () => {
+						openChild({
+							parentSessionId,
+							childSessionId: entry.id,
+							mode: entry.mode
+						});
+						closeCatalog();
+					};
+					const handleKey = (event) => {
+						if (event.key === "Enter" || event.key === " ") {
+							event.preventDefault();
+							event.stopPropagation();
+							open();
+						} else if (event.key === "ArrowRight" && !knownLeaf && !isExpanded || event.key === "ArrowLeft" && isExpanded) {
+							event.preventDefault();
+							event.stopPropagation();
+							toggleBranch(entry.id);
+						}
+					};
+					const toggle = (event) => {
+						event.preventDefault();
+						event.stopPropagation();
+						toggleBranch(entry.id);
+					};
+					return (0, react_jsx_runtime.jsxs)("div", {
+						className: SubagentCatalogAction_module_css_default.node,
+						children: [(0, react_jsx_runtime.jsxs)("div", {
+							role: "treeitem",
+							tabIndex: 0,
+							"aria-level": level,
+							"aria-label": [
+								label,
+								secondary,
+								metrics
+							].filter((value) => value !== "").join(" "),
+							...knownLeaf ? {} : { "aria-expanded": isExpanded },
+							className: SubagentCatalogAction_module_css_default.row,
+							onClick: open,
+							onKeyDown: handleKey,
+							children: [knownLeaf ? reserveDisclosure && (0, react_jsx_runtime.jsx)("span", { className: SubagentCatalogAction_module_css_default.disclosureSpace }) : (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								tabIndex: -1,
+								className: `${SubagentCatalogAction_module_css_default.disclosure} ${isExpanded ? SubagentCatalogAction_module_css_default.disclosureOpen : ""}`,
+								"aria-label": t(isExpanded ? "branch.collapse" : "branch.expand", { label }),
+								onClick: toggle,
+								children: (0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.IconChevronRightOutline14, {})
+							}), (0, react_jsx_runtime.jsxs)("div", {
+								className: SubagentCatalogAction_module_css_default.clickarea,
+								children: [
+									(0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.StateDot, { state: entry.activity === "running" ? "ongoing" : "done" }),
+									(0, react_jsx_runtime.jsxs)("span", {
+										className: SubagentCatalogAction_module_css_default.content,
+										children: [(0, react_jsx_runtime.jsx)("span", {
+											className: SubagentCatalogAction_module_css_default.label,
+											children: label
+										}), (0, react_jsx_runtime.jsx)("span", {
+											className: SubagentCatalogAction_module_css_default.summary,
+											children: secondary
+										})]
+									}),
+									metrics !== "" && (0, react_jsx_runtime.jsxs)("span", {
+										className: SubagentCatalogAction_module_css_default.metrics,
+										children: [tokenMetric !== void 0 && (0, react_jsx_runtime.jsx)("span", {
+											className: SubagentCatalogAction_module_css_default.metricToken,
+											children: tokenMetric
+										}), durationMetric !== void 0 && (0, react_jsx_runtime.jsx)("span", {
+											className: SubagentCatalogAction_module_css_default.metricDuration,
+											title: t("duration.exactTitle", { duration: durationMetric.exact }),
+											children: durationMetric.compact
+										})]
+									})
+								]
+							})]
+						}), isExpanded && !knownLeaf && (0, react_jsx_runtime.jsx)("div", {
+							role: "group",
+							className: SubagentCatalogAction_module_css_default.children,
+							"aria-busy": childLoading || void 0,
+							children: childCatalog === void 0 ? (0, react_jsx_runtime.jsx)(CatalogLoadingRows, {
+								parentSessionId: entry.id,
+								summaries,
+								level: level + 1,
+								t
+							}) : (0, react_jsx_runtime.jsx)(CatalogRows, {
+								parentSessionId: entry.id,
+								catalog: childCatalog,
+								catalogs,
+								summaries,
+								expanded,
+								level: level + 1,
+								now,
+								openChild,
+								refresh,
+								toggleBranch,
+								closeCatalog,
+								t
+							})
+						})]
+					}, entry.id);
+				})
+			] });
+		}
+		/**
+		* Render the current session's direct catalog and lazily expanded descendants.
+		* @param props - session standard props plus catalog navigation actions.
+		* @returns The action while the catalog is pending or summaries establish descendants.
+		*/
+		function SubagentCatalogAction({ sessionId, useSessions, openChild, refresh, setCatalogOpen, t }) {
+			const catalogs = useSessions((state) => state.subagentsByParent);
+			const summaries = useSessions((state) => state.byId);
+			const catalog = catalogs[sessionId];
+			const [open, setOpen] = (0, react.useState)(false);
+			const [now, setNow] = (0, react.useState)(() => Date.now());
+			const [expanded, setExpanded] = (0, react.useState)(() => /* @__PURE__ */ new Set());
+			const rootRef = (0, react.useRef)(null);
+			const triggerRef = (0, react.useRef)(null);
+			const observedCatalogs = (0, react.useRef)(/* @__PURE__ */ new Set());
+			const setCatalogOpenRef = (0, react.useRef)(setCatalogOpen);
+			setCatalogOpenRef.current = setCatalogOpen;
+			const healthy = catalog?.entries.filter((entry) => entry.kind === "child") ?? [];
+			const descendants = (0, react.useMemo)(() => (0, _monotykamary_dsh_client_runtime_client.indexSubagentDescendants)(summaries).get(sessionId) ?? NO_DESCENDANTS, [sessionId, summaries]);
+			const descendantCount = Math.max(healthy.length, descendants.count);
+			const totalCountKey = descendantCount === 1 ? "count.total.one" : "count.total.other";
+			const runningCountKey = descendants.runningCount === 1 ? "count.running.one" : "count.running.other";
+			const presentedCatalog = descendants.count > 0 && (catalog === void 0 || catalog.state === "ready" && catalog.entries.length === 0) ? {
+				entries: [],
+				parentAvailable: catalog?.parentAvailable ?? false,
+				state: "loading",
+				error: null
+			} : catalog;
+			const observeCatalog = (parentSessionId, next) => {
+				if (next) observedCatalogs.current.add(parentSessionId);
+				else observedCatalogs.current.delete(parentSessionId);
+				setCatalogOpen(parentSessionId, next);
+			};
+			const closeAllCatalogs = () => {
+				for (const parentSessionId of observedCatalogs.current) setCatalogOpen(parentSessionId, false);
+				observedCatalogs.current.clear();
+				setExpanded(/* @__PURE__ */ new Set());
+			};
+			const changeOpen = (next, restoreFocus = false) => {
+				setOpen(next);
+				if (next) {
+					setNow(Date.now());
+					observeCatalog(sessionId, true);
+				} else closeAllCatalogs();
+				if (restoreFocus) queueMicrotask(() => {
+					triggerRef.current?.focus();
+				});
+			};
+			const closeBranch = (root) => {
+				const closing = /* @__PURE__ */ new Set();
+				const visit = (parentSessionId) => {
+					if (closing.has(parentSessionId) || !expanded.has(parentSessionId)) return;
+					closing.add(parentSessionId);
+					const branch = catalogs[parentSessionId];
+					for (const entry of branch?.entries ?? []) if (entry.kind === "child") visit(entry.id);
+				};
+				visit(root);
+				for (const parentSessionId of closing) observeCatalog(parentSessionId, false);
+				setExpanded((current) => new Set([...current].filter((id) => !closing.has(id))));
+			};
+			const toggleBranch = (childSessionId) => {
+				if (expanded.has(childSessionId)) {
+					closeBranch(childSessionId);
+					return;
+				}
+				setExpanded((current) => new Set(current).add(childSessionId));
+				observeCatalog(childSessionId, true);
+			};
+			(0, react.useEffect)(() => {
+				if (!open) return;
+				const closeOutside = (event) => {
+					if (event.target instanceof Node && !rootRef.current?.contains(event.target)) changeOpen(false);
+				};
+				document.addEventListener("pointerdown", closeOutside);
+				return () => {
+					document.removeEventListener("pointerdown", closeOutside);
+				};
+			}, [open]);
+			(0, react.useEffect)(() => {
+				if (!open || descendants.runningCount === 0) return;
+				const timer = setInterval(() => {
+					setNow(Date.now());
+				}, 1e3);
+				return () => {
+					clearInterval(timer);
+				};
+			}, [open, descendants.runningCount]);
+			(0, react.useEffect)(() => () => {
+				for (const parentSessionId of observedCatalogs.current) setCatalogOpenRef.current(parentSessionId, false);
+				observedCatalogs.current.clear();
+			}, []);
+			const visible = presentedCatalog !== void 0 && (presentedCatalog.state === "error" || presentedCatalog.entries.length > 0 || descendantCount > 0);
+			(0, react.useEffect)(() => {
+				if (visible || !open) return;
+				setOpen(false);
+				closeAllCatalogs();
+			}, [visible, open]);
+			if (!visible) return null;
+			const focusAt = (index) => {
+				const items = treeItems(rootRef.current);
+				if (items.length === 0) return;
+				items[(index + items.length) % items.length]?.focus();
+			};
+			const navigate = (event) => {
+				const items = treeItems(rootRef.current);
+				const index = items.indexOf(document.activeElement);
+				if (event.key === "Escape") {
+					event.preventDefault();
+					changeOpen(false, true);
+				} else if (event.key === "Home") {
+					event.preventDefault();
+					focusAt(0);
+				} else if (event.key === "End") {
+					event.preventDefault();
+					focusAt(items.length - 1);
+				} else if (event.key === "ArrowDown") {
+					event.preventDefault();
+					focusAt(index + 1);
+				} else if (event.key === "ArrowUp") {
+					event.preventDefault();
+					focusAt(index < 0 ? items.length - 1 : index - 1);
+				}
+			};
+			return (0, react_jsx_runtime.jsxs)("div", {
+				className: SubagentCatalogAction_module_css_default.root,
+				ref: rootRef,
+				onKeyDown: navigate,
+				children: [(0, react_jsx_runtime.jsxs)("button", {
+					ref: triggerRef,
+					type: "button",
+					className: SubagentCatalogAction_module_css_default.trigger,
+					"aria-haspopup": "tree",
+					"aria-expanded": open,
+					"aria-label": t(descendants.runningCount > 0 ? runningCountKey : totalCountKey, { count: descendants.runningCount > 0 ? descendants.runningCount : descendantCount }),
+					onClick: () => {
+						changeOpen(!open);
+					},
+					onKeyDown: (event) => {
+						if (event.key !== "ArrowDown") return;
+						event.preventDefault();
+						if (!open) changeOpen(true);
+						queueMicrotask(() => {
+							focusAt(0);
+						});
+					},
+					children: [
+						(0, react_jsx_runtime.jsx)("span", {
+							className: SubagentCatalogAction_module_css_default.activitySlot,
+							children: descendants.runningCount > 0 && (0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.StateDot, { state: "ongoing" })
+						}),
+						(0, react_jsx_runtime.jsx)("span", {
+							className: SubagentCatalogAction_module_css_default.count,
+							children: t(totalCountKey, { count: descendantCount })
+						}),
+						(0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.IconChevronDownOutline14, { className: open ? SubagentCatalogAction_module_css_default.triggerOpen : void 0 })
+					]
+				}), open && (0, react_jsx_runtime.jsx)("div", {
+					className: SubagentCatalogAction_module_css_default.menu,
+					role: "tree",
+					"aria-label": t("tree.aria"),
+					children: (0, react_jsx_runtime.jsx)(CatalogRows, {
+						parentSessionId: sessionId,
+						catalog: presentedCatalog,
+						catalogs,
+						summaries,
+						expanded,
+						level: 1,
+						now,
+						openChild,
+						refresh,
+						toggleBranch,
+						closeCatalog: () => {
+							changeOpen(false);
+						},
+						t
+					})
+				})]
+			});
+		}
+		//#endregion
+		//#region \0dsh-css:/Users/monotykamary/VCS/working-remote/open-source/deepseek-harness/packages/client/ui-subagent/src/client/SubagentReadOnlyComposer.module.css.mjs
+		const css = ".t4SSma_frame{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);min-height:54px;color:var(--dsw-alias-label-tertiary);border-radius:14px;justify-content:center;align-items:center;gap:8px;margin:0 24px 20px;padding:10px 16px;font-size:13px;line-height:20px;display:flex}.t4SSma_frame strong{color:var(--dsw-alias-label-primary);font-weight:510}";
+		const tagId = "@monotykamary/dsh-client-ui-subagent/SubagentReadOnlyComposer.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@monotykamary/dsh-client-ui-subagent";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var SubagentReadOnlyComposer_module_css_default = { "frame": "t4SSma_frame" };
+		//#endregion
+		//#region lib/types/client/SubagentReadOnlyComposer.js
+		/**
+		* Explain why the normal composer is unavailable for an addressed child.
+		* @param props - selector-owned read-only reason plus standard slot props.
+		* @returns A read-only composer replacement.
+		*/
+		function SubagentReadOnlyComposer({ matched, t }) {
+			const oneShot = matched.reason === "one-shot";
+			return (0, react_jsx_runtime.jsxs)("div", {
+				className: SubagentReadOnlyComposer_module_css_default.frame,
+				role: "status",
+				children: [(0, react_jsx_runtime.jsx)("strong", { children: t(oneShot ? "readonly.oneShot.title" : "readonly.title") }), (0, react_jsx_runtime.jsx)("span", { children: t(oneShot ? "readonly.oneShot.body" : "readonly.body") })]
+			});
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		/** `subagent` namespace dictionaries. */
+		/** Dictionary namespace owned by this plugin. */
+		const NS = "subagent";
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"diagnostic.corrupt": "会话记录损坏",
+			"diagnostic.unsupported": "子代理记录版本不受支持",
+			"diagnostic.unavailable": "会话记录暂不可用",
+			"duration.seconds": "{seconds}秒",
+			"duration.minutes": "{minutes}分{seconds}秒",
+			"duration.hours": "{hours}小时{minutes}分{seconds}秒",
+			"duration.days": "{days}天",
+			"duration.daysHours": "{days}天{hours}小时",
+			"duration.months": "约{months}个月",
+			"duration.monthsDays": "约{months}个月{days}天",
+			"duration.years": "约{years}年",
+			"duration.yearsMonths": "约{years}年{months}个月",
+			"duration.exactDays": "{days}天{hours}小时{minutes}分{seconds}秒",
+			"duration.exactTitle": "总活跃耗时：{duration}",
+			"loading.label": "正在加载子代理…",
+			"loading.aria": "正在加载子代理",
+			"load.error": "无法加载子代理",
+			"retry": "重试",
+			"mode.oneShot": "一次性",
+			"mode.continuable": "可继续",
+			"activity.running": "正在运行",
+			"activity.inactive": "当前未运行",
+			"branch.collapse": "收起 {label} 的下级子代理",
+			"branch.expand": "展开 {label} 的下级子代理",
+			"count.total.one": "{count} 个子代理",
+			"count.total.other": "{count} 个子代理",
+			"count.running.one": "{count} 个子代理，正在运行",
+			"count.running.other": "{count} 个子代理，正在运行",
+			"tree.aria": "子代理会话",
+			"readonly.oneShot.title": "一次性子代理记录",
+			"readonly.title": "此子代理暂时只读",
+			"readonly.oneShot.body": "一次性任务不支持后续消息，可在这里查看完整执行记录。",
+			"readonly.body": "父会话当前不在线，重新打开父会话后即可继续发送消息。"
+		};
+		/** English dictionary, key-identical to the Chinese source of truth. */
+		const en = {
+			"diagnostic.corrupt": "corrupted session record",
+			"diagnostic.unsupported": "unsupported subagent record version",
+			"diagnostic.unavailable": "session record temporarily unavailable",
+			"duration.seconds": "{seconds}s",
+			"duration.minutes": "{minutes}m {seconds}s",
+			"duration.hours": "{hours}h {minutes}m {seconds}s",
+			"duration.days": "{days}d",
+			"duration.daysHours": "{days}d {hours}h",
+			"duration.months": "~{months}mo",
+			"duration.monthsDays": "~{months}mo {days}d",
+			"duration.years": "~{years}y",
+			"duration.yearsMonths": "~{years}y {months}mo",
+			"duration.exactDays": "{days}d {hours}h {minutes}m {seconds}s",
+			"duration.exactTitle": "Total active duration: {duration}",
+			"loading.label": "Loading subagents…",
+			"loading.aria": "Loading subagents",
+			"load.error": "Unable to load subagents",
+			"retry": "Retry",
+			"mode.oneShot": "one-shot",
+			"mode.continuable": "continuable",
+			"activity.running": "running",
+			"activity.inactive": "not running",
+			"branch.collapse": "Collapse {label} descendants",
+			"branch.expand": "Expand {label} descendants",
+			"count.total.one": "{count} subagent",
+			"count.total.other": "{count} subagents",
+			"count.running.one": "{count} subagent running",
+			"count.running.other": "{count} subagents running",
+			"tree.aria": "Subagent sessions",
+			"readonly.oneShot.title": "One-shot subagent record",
+			"readonly.title": "This subagent is read-only for now",
+			"readonly.oneShot.body": "One-shot tasks do not accept follow-ups; review the full execution record here.",
+			"readonly.body": "The parent session is offline; reopen it to continue sending messages."
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** Required services for references, conversation slots, and session navigation. */
+		const inject = [
+			"inputTriggers",
+			"sessions",
+			"slots",
+			"locale"
+		];
+		/** Claim the composer for one-shot history or an unavailable continuation owner. */
+		function selectReadOnlySubagent(owner) {
+			const subagent = owner.session?.subagent;
+			if (subagent === void 0 || subagent === null) return null;
+			if (subagent.address.mode === "one-shot") return { reason: "one-shot" };
+			if (subagent.parentAvailable) return null;
+			return owner.session?.running === true ? null : { reason: "parent-unavailable" };
+		}
+		/**
+		* Client plugin body: register the '@' subagent source over the root session list.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "ui-subagent: dictionaries");
+			const sessions = ctx.sessions;
+			const childLabels = (session, query) => {
+				const { byId } = sessions.list.getSnapshot();
+				return Object.values(byId).filter((child) => child.parentId === session.sessionId && child.running && child.displayTitle.includes(query)).map((child) => child.displayTitle);
+			};
+			const source = {
+				trigger: "@",
+				name: "subagent",
+				candidates(session, { query }) {
+					return Promise.resolve(childLabels(session, query).map((name) => ({ name })));
+				},
+				lexicon(session) {
+					return childLabels(session, "");
+				},
+				subscribeLexicon(_session, listener) {
+					return sessions.list.subscribe(listener);
+				},
+				onPick({ candidate }) {
+					return { text: `@${candidate.name} ` };
+				},
+				codec: {
+					clipboardText: (ref) => `@${ref}`,
+					serialize: (ref) => Promise.resolve(`@${ref}`)
+				}
+			};
+			const inputTriggers = ctx.get("inputTriggers");
+			ctx.effect(() => inputTriggers.registerSource(source), "ui-subagent: @ source");
+			const catalogActions = (_parentSessionId) => ({
+				openChild(address) {
+					sessions.openSubagent(address);
+				},
+				refresh(parentSessionId) {
+					sessions.refreshSubagents(parentSessionId);
+				},
+				setCatalogOpen(parentSessionId, open) {
+					sessions.setSubagentCatalogOpen(parentSessionId, open);
+				}
+			});
+			ctx.slots.inject("conversation.session.header.actions", () => ctx.slots.register({
+				name: "conversation.session.header.actions",
+				id: "subagent-catalog",
+				order: 10,
+				locale: NS,
+				inject: catalogActions
+			}, SubagentCatalogAction));
+			ctx.slots.inject("conversation.composer", () => ctx.slots.register({
+				name: "conversation.composer",
+				priority: -10,
+				locale: NS,
+				select: selectReadOnlySubagent
+			}, SubagentReadOnlyComposer));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,11 @@
+//#region lib/types/index.js
+/**
+* Subagent reference plugin, node half. Pure UI plugin: the empty apply
+* exists so the plugin appears in the host cordis.yml / Loader; the browser
+* half ships via exports["./client"], discovered through the package.json
+* dsh.client declaration.
+*/
+/** Host plugin body — no host-side behavior for this source plugin. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,24 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@monotykamary/dsh-client-ui-subagent`.
+* @module @monotykamary/dsh-client-ui-subagent/invariant
+*/
+const PACKAGE_NAME = "@monotykamary/dsh-client-ui-subagent";
+/** Cordis companion plugin name. */
+const name = "client-ui-subagent-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: a single slash-source registration whose disposal is
+* proven by the HMR-safety spec — it emits no cordis events and owns no
+* cross-plugin mutable state.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

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

@@ -0,0 +1,18 @@
+import { type SessionId, type SubagentAddress } from '@monotykamary/dsh-client-runtime/client';
+import type { PropsLocale, PropsRuntime } from '@monotykamary/dsh-client-ui-slots';
+import { NS } from './locales.ts';
+/** Business actions supplied by the slot registration. */
+export interface SubagentCatalogInjected {
+    openChild: (address: SubagentAddress) => void;
+    refresh: (parentSessionId: SessionId) => void;
+    setCatalogOpen: (parentSessionId: SessionId, open: boolean) => void;
+}
+/** Full props for the session-header catalog action. */
+export type SubagentCatalogActionProps = PropsRuntime<'conversation.session.header.actions'> & SubagentCatalogInjected & PropsLocale<typeof NS>;
+/**
+ * Render the current session's direct catalog and lazily expanded descendants.
+ * @param props - session standard props plus catalog navigation actions.
+ * @returns The action while the catalog is pending or summaries establish descendants.
+ */
+export declare function SubagentCatalogAction({ sessionId, useSessions, openChild, refresh, setCatalogOpen, t, }: SubagentCatalogActionProps): import("react").JSX.Element | null;
+//# sourceMappingURL=SubagentCatalogAction.d.ts.map

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

@@ -0,0 +1,17 @@
+import type { PropsLocale, PropsRuntime } from '@monotykamary/dsh-client-ui-slots';
+import { NS } from './locales.ts';
+/** Why a catalog-addressed conversation cannot accept human input. */
+export interface SubagentReadOnlyMatch {
+    reason: 'one-shot' | 'parent-unavailable';
+}
+/** Full chain props after the read-only subagent selector accepts the owner currency. */
+export type SubagentReadOnlyComposerProps = PropsRuntime<'conversation.composer'> & {
+    matched: SubagentReadOnlyMatch;
+} & PropsLocale<typeof NS>;
+/**
+ * Explain why the normal composer is unavailable for an addressed child.
+ * @param props - selector-owned read-only reason plus standard slot props.
+ * @returns A read-only composer replacement.
+ */
+export declare function SubagentReadOnlyComposer({ matched, t, }: Pick<SubagentReadOnlyComposerProps, 'matched' | 't'>): import("react").JSX.Element;
+//# sourceMappingURL=SubagentReadOnlyComposer.d.ts.map

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

@@ -0,0 +1,31 @@
+/**
+ * Subagent reference plugin, browser half: registers the '@' source —
+ * candidates filtered from the session list snapshot's running children
+ * (zero RPC; the list rides the plugin's root-context sessions service, the
+ * scoped session comes from the per-call projection), pick inserts the
+ * literal `@label ` text (plain-text-reference decision, see
+ * .agents/notes/implemented/architecture/2026-07-25-web-input-machine-and-slash-pipeline.md:
+ * the draft carries plain text, chip
+ * visuals are derived by scanning against the source lexicon, and the
+ * prompt ships the same literal). Consumption semantics stay with future
+ * business work. No adjudication hooks: subagent
+ * references never enter command adjudication.
+ */
+import type { ClientContext } from '@monotykamary/dsh-client-runtime/client';
+import { type SubagentKey } from './locales.ts';
+declare module '@monotykamary/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Subagent catalog and read-only composer copy. */
+        'subagent': SubagentKey;
+    }
+}
+export type { SubagentCatalogActionProps, SubagentCatalogInjected, } from './SubagentCatalogAction.tsx';
+export type { SubagentReadOnlyComposerProps, SubagentReadOnlyMatch, } from './SubagentReadOnlyComposer.tsx';
+/** Required services for references, conversation slots, and session navigation. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the '@' subagent source over the root session list.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,44 @@
+/** `subagent` namespace dictionaries. */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "subagent";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    readonly 'diagnostic.corrupt': "会话记录损坏";
+    readonly 'diagnostic.unsupported': "子代理记录版本不受支持";
+    readonly 'diagnostic.unavailable': "会话记录暂不可用";
+    readonly 'duration.seconds': "{seconds}秒";
+    readonly 'duration.minutes': "{minutes}分{seconds}秒";
+    readonly 'duration.hours': "{hours}小时{minutes}分{seconds}秒";
+    readonly 'duration.days': "{days}天";
+    readonly 'duration.daysHours': "{days}天{hours}小时";
+    readonly 'duration.months': "约{months}个月";
+    readonly 'duration.monthsDays': "约{months}个月{days}天";
+    readonly 'duration.years': "约{years}年";
+    readonly 'duration.yearsMonths': "约{years}年{months}个月";
+    readonly 'duration.exactDays': "{days}天{hours}小时{minutes}分{seconds}秒";
+    readonly 'duration.exactTitle': "总活跃耗时：{duration}";
+    readonly 'loading.label': "正在加载子代理…";
+    readonly 'loading.aria': "正在加载子代理";
+    readonly 'load.error': "无法加载子代理";
+    readonly retry: "重试";
+    readonly 'mode.oneShot': "一次性";
+    readonly 'mode.continuable': "可继续";
+    readonly 'activity.running': "正在运行";
+    readonly 'activity.inactive': "当前未运行";
+    readonly 'branch.collapse': "收起 {label} 的下级子代理";
+    readonly 'branch.expand': "展开 {label} 的下级子代理";
+    readonly 'count.total.one': "{count} 个子代理";
+    readonly 'count.total.other': "{count} 个子代理";
+    readonly 'count.running.one': "{count} 个子代理，正在运行";
+    readonly 'count.running.other': "{count} 个子代理，正在运行";
+    readonly 'tree.aria': "子代理会话";
+    readonly 'readonly.oneShot.title': "一次性子代理记录";
+    readonly 'readonly.title': "此子代理暂时只读";
+    readonly 'readonly.oneShot.body': "一次性任务不支持后续消息，可在这里查看完整执行记录。";
+    readonly 'readonly.body': "父会话当前不在线，重新打开父会话后即可继续发送消息。";
+};
+/** English dictionary, key-identical to the Chinese source of truth. */
+export declare const en: Record<SubagentKey, string>;
+/** Key domain of the `subagent` namespace (zh is the source of truth). */
+export type SubagentKey = keyof typeof zh;
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Subagent reference plugin, node half. Pure UI plugin: the empty apply
+ * exists so the plugin appears in the host cordis.yml / Loader; the browser
+ * half ships via exports["./client"], discovered through the package.json
+ * dsh.client declaration.
+ */
+/** Host plugin body — no host-side behavior for this source plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@monotykamary/dsh-client-ui-subagent`.
+ * @module @monotykamary/dsh-client-ui-subagent/invariant
+ */
+import type { Context } from '@monotykamary/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-subagent-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@monotykamary/dsh-client-ui-subagent",
+  "description": "Subagent conversation catalog, continuation routing UI, and '@' reference source",
+  "version": "0.1.0-rc.5",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-subagent"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@monotykamary/dsh-client-locale",
+        "@monotykamary/dsh-client-runtime",
+        "@monotykamary/dsh-client-ui-conversation",
+        "@monotykamary/dsh-client-ui-primitives",
+        "@monotykamary/dsh-client-ui-input-trigger"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "dependencies": {
+    "react": "^18.2.0"
+  },
+  "peerDependencies": {
+    "@monotykamary/dsh-client-locale": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-conversation": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-primitives": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-slots": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-runtime": "^0.1.0-rc.5",
+    "@monotykamary/dsh-subagent": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-input-trigger": "^0.1.0-rc.5",
+    "@monotykamary/cordis": "^4.0.1",
+    "@monotykamary/dsh-invariants": "^0.1.0-rc.5",
+    "@monotykamary/dsh-token-meter": "^0.1.0-rc.5"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "@monotykamary/dsh-client-ui-input-trigger": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-primitives": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-locale": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-runtime": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-test-runtime": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-conversation": "^0.1.0-rc.5",
+    "@monotykamary/dsh-invariants": "^0.1.0-rc.5",
+    "@monotykamary/dsh-subagent": "^0.1.0-rc.5",
+    "@monotykamary/cordis": "^4.0.1",
+    "@monotykamary/dsh-client-ui-slots": "^0.1.0-rc.5",
+    "@monotykamary/dsh-token-meter": "^0.1.0-rc.5"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}