@monotykamary/dsh-client-ui-skill 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-skill/README.md
+README.md: 5ca3ff05e3935fc1013d786ddf081c2e8474cb52
+README.zh.md: 023d9782f0b3fa21ac9c828902b0c3164556c18e

package/README.md

@@ -0,0 +1,37 @@
+# @monotykamary/dsh-client-ui-skill
+
+English | [中文](README.zh.md)
+
+Skill invocation source, browser half: registers the `/`-trigger `skill` source into `ctx.inputTriggers`. Ordinary-session candidates come from the `skill.list` RPC addressed by the per-call `ClientSessionContext` projection's `{sessionId}`, with the host resolving `cwd` from the session header. The host serves every user-invocable skill; a `modelInvocable: false` entry (a `disable-model-invocation` skill, whose only entry point is this path) wears the user-only marker as a description prefix in the active language. Catalog-addressed continuable children resolve no skill candidates locally because the existing skill RPC requires an attached session; viewing their persisted history must not activate them. Catalogs cache per ordinary session with a single-flight fetch; the scope-birth `warm` hook prewarms the session's entry, the forwarded `agent-preset/selected` owner event drops that one session's entry (the catalog belongs to the preset, and a blank session may switch after the warm), and `connection/reset` clears everything. Results filter by `startsWith(query)`.
+
+A pick lands the literal `/name ` text and the prompt ships the same literal ([slash-pipeline Agent Note](../../../.agents/notes/implemented/architecture/2026-07-25-web-input-machine-and-slash-pipeline.md)) — this source implements no adjudication hooks and no reference codec. Determinism lives host-side: the pre-step gesture boundary (`dsh-tool-skill`) recognizes whitespace-bounded `/name` tokens naming user-invocable skills anywhere in a user message and injects the rendered `<skill_content>` for every entry point, so a menu pick, a hand-typed token, and a TUI/ACP prompt all load the skill the same way. A name shared with a host command still resolves to the command: adjudication claims the line client-side before it ever becomes a prompt — deliberate precedence, matching peer products. The list RPC rides the plugin's root-context connection captured at registration — the source never reads services off a per-call argument; draft chip visuals derive from the `lexicon` scan.
+
+A failed `skill.list` throws from `candidates`, which the slash shell logs and folds into a silent menu-group drop — the menu shows only pending/ready states.
+
+The `/client` exports are the plugin body (`apply`/`inject`) only; the source object is internal to the registration effect.
+
+## Skill tool row
+
+The browser plugin also registers the `skill` wire name in `ui-tool`'s keyed `tool.call.toolview` slot. A collapsed row renders the 14-pixel skill document-and-sparkle glyph, `Skill` title, separator, and requested skill name with the same neutral hierarchy as the Bash row; running calls carry the transcript shimmer, failures replace the name with the first error line, and interrupted calls use the warning state. A settled row expands as one whole-row disclosure into a bounded `Instructions` card containing the exact durable tool output, with the standard trajectory `Inspect` affordance when available. The row derives its name, lifecycle, and body only from the frozen call/result slice supplied by `ui-tool`, never from the current catalog, so replay remains stable when installed skills or their descriptions change.
+
+## Model Experience
+
+### User-explicit skill invocation
+
+#### What the model sees
+
+The user's message reaches the model verbatim, `/name` literal included. The host's pre-step boundary (`dsh-tool-skill`) then appends the canonical `<skill_content>` block — the same `renderSkillContent` output the `skill` tool returns — as injected instructions context at the end of that step's injections, closest to the model's answer. Loading is deterministic: the model receives the full body without being asked to call the `skill` tool, and the catalog tells it not to re-load an inline-injected skill.
+
+#### Token effect
+
+One invocation adds the rendered skill body to that turn as injected context — the same cost as the model loading the skill through the tool, paid unconditionally instead of at the model's discretion. Menu browsing and the candidate fetch add zero model tokens.
+
+#### KV Cache effect
+
+Append-only: the injected message lands after the reusable history prefix. This package never edits earlier request tokens.
+
+## Known Limitations and Deferred Work
+
+- **Result-only history pages use the generic row** — keyed dispatch needs the paired call in the runtime window; pagination that leaves the call outside has no tool identity. This client presentation feature does not extend the history wire contract to recover it.
+- **Text is the truth** — the reference is plain draft text; a hand-typed identical token is the same reference, and the host gesture boundary judges the sent text, not the menu interaction. Chip visuals derive from the lexicon scan; no occurrence identity, position tracking, or structured reference payload on the prompt wire (both are ledger items).
+- **A menu opened before the prewarm settles** shows no skill candidates for that keystroke; the next keystroke re-polls the settled cache.

package/README.zh.md

@@ -0,0 +1,37 @@
+# @monotykamary/dsh-client-ui-skill
+
+[English](README.md) | 中文
+
+skill（技能）调用 source 的浏览器端：把 `/` 触发的 `skill` source 注册进 `ctx.inputTriggers`。普通会话的候选来自 `skill.list` RPC，以每次调用的 `ClientSessionContext` 投影中的 `{sessionId}` 寻址，host 从会话 header 解析 `cwd`。宿主提供每一个用户可调用的 skill；`modelInvocable: false` 的条目（即 `disable-model-invocation` skill，此路径是其唯一入口）会以当前语言把仅限用户标记作为描述前缀带上。由目录寻址的可继续 subagent 在客户端解析为没有 skill 候选，因为现有 skill RPC 要求会话已挂载；查看其持久化历史不得激活它。目录按普通会话缓存，拉取走 single-flight；scope 创建时的 `warm` 钩子预热该会话的缓存项，转发的 owner 事件 `agent-preset/selected` 丢弃该会话这一项（目录属于 preset，而空会话可能在预热之后才切换），`connection/reset` 清空全部缓存。结果按 `startsWith(query)` 过滤。
+
+pick 会落下字面文本 `/name `，发出的提示词中也是同一段字面文本（[slash 流水线 Agent Note](../../../.agents/notes/implemented/architecture/2026-07-25-web-input-machine-and-slash-pipeline.md)）——本 source 不实现任何裁决钩子，也没有引用 codec。确定性在宿主侧：pre-step 手势边界（`dsh-tool-skill`）识别用户消息中任意位置、以空白为界、指名用户可调用 skill 的 `/name` token，并为每个入口注入渲染后的 `<skill_content>`，因此菜单 pick、手动键入的 token 与 TUI/ACP（Agent Client Protocol）提示词都以同一种方式加载 skill。与宿主命令同名的名称仍解析为命令：裁决在客户端把该行认领走，它根本不会成为提示词——这是有意的优先级，与同类产品一致。列表 RPC 使用插件注册时捕获的根上下文连接——source 绝不从每次调用的参数上读取服务；草稿 chip 视觉由 `lexicon` 扫描派生。
+
+`skill.list` 失败时 `candidates` 抛出异常，slash 壳层记录日志，并静默丢弃该菜单组——菜单只显示 pending／ready 状态。
+
+`/client` 导出接口只有插件主体（`apply`／`inject`）；source 对象是注册 effect 的内部实现。
+
+## skill 工具行
+
+浏览器插件还会把 `skill` wire 名称注册进 `ui-tool` 的 keyed `tool.call.toolview` slot。收起的行以与 Bash 行相同的中性视觉层级显示 14 像素的 skill 文档与闪光组合图标、`Skill` 标题、分隔符和请求加载的 skill 名称；运行中的工具调用带有 transcript（文本记录）的扫光效果，失败时用错误首行替换名称，中断的工具调用则使用警告状态。已结算的行以整行作为展开入口，展开后显示一个尺寸受限的 `Instructions` 卡片，其中原样呈现持久化的工具输出；可用时还会提供标准执行轨迹的 `Inspect` 入口。该行的名称、生命周期和正文只派生自 `ui-tool` 提供的冻结的工具调用／工具结果切片，绝不读取当前 skill 目录，因此即使已安装的 skill 或其描述发生变化，回放仍保持稳定。
+
+## 模型体验
+
+### 用户显式 skill 调用
+
+#### 模型看到的内容
+
+用户消息原样到达模型，字面文本 `/name` 也包含在内。随后宿主的 pre-step 边界（`dsh-tool-skill`）把规范的 `<skill_content>` 块——与 `skill` 工具返回的 `renderSkillContent` 输出相同——作为注入的指令上下文追加在该步骤各项注入的末尾，最贴近模型的回答。加载是确定性的：模型无需被要求调用 `skill` 工具就能收到完整正文，目录也会告诉它不要重新加载已内联注入的 skill。
+
+#### Token 影响
+
+一次调用会把渲染后的 skill 正文作为注入上下文加进该轮次——成本与模型经由工具加载该 skill 相同，只是无条件支付，而非由模型自行裁量。浏览菜单和拉取候选不会增加任何模型 token。
+
+#### KV Cache 影响
+
+仅追加：注入的消息落在可复用历史前缀之后。该包绝不改写较早的请求 token。
+
+## 已知限制与暂缓事项
+
+- **仅含工具结果的 history 页使用通用行**：键控分派要求配对的工具调用位于运行时窗口内；分页将工具调用留在窗口外时，工具结果没有工具身份。这项客户端呈现功能不会为了恢复该身份而扩展 history 协议约定。
+- **文本是唯一依据**：引用是普通的草稿文本；手动键入的相同 token 就是同一个引用，宿主手势边界评判的是发出的文本，而不是菜单交互。chip 视觉由 lexicon 扫描派生；没有 occurrence 身份、位置跟踪，也没有提示词协议上的结构化引用载荷（两者都是台账事项）。
+- **预热落定之前打开的菜单**：在那次击键下不显示 skill 候选；下一次击键会重新轮询已落定的缓存。

package/lib/client.js

@@ -0,0 +1,327 @@
+window.__ModuleLoader__.load({
+	id: "@monotykamary/dsh-client-ui-skill",
+	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_ui_primitives = require("@monotykamary/dsh-client-ui-primitives");
+		//#region \0dsh-css:/Users/monotykamary/VCS/working-remote/open-source/deepseek-harness/packages/client/ui-skill/src/client/SkillRow.module.css.mjs
+		const css = ".HXy9aG_card{flex-direction:column;display:flex}.HXy9aG_row{align-items:center;min-width:0;height:24px;display:flex;position:relative;overflow:hidden}.HXy9aG_row[data-expandable]{cursor:pointer}.HXy9aG_card[data-state=running] .HXy9aG_row:after{content:\"\";background:linear-gradient(90deg, transparent 0%, color-mix(in srgb, var(--dsw-alias-bg-base) 60%, transparent) 55%, transparent 100%);pointer-events:none;width:300px;animation:2.6s ease-out infinite HXy9aG_dsh-skill-row-sweep;position:absolute;inset:0 auto 0 0}@keyframes HXy9aG_dsh-skill-row-sweep{0%{left:-300px}90%,to{left:100%}}.HXy9aG_leading{width:16px;height:16px;color:var(--dsw-alias-label-tertiary);flex:none;justify-content:center;align-items:center;margin-right:6px;display:inline-flex;position:relative}.HXy9aG_chevron{color:var(--dsw-alias-label-secondary)}.HXy9aG_iconIdle{opacity:1;transition:opacity .1s;display:inline-flex}.HXy9aG_chevronHover{opacity:0;margin:auto;transition:opacity .1s;position:absolute;inset:0}.HXy9aG_row:hover .HXy9aG_iconIdle{opacity:0}.HXy9aG_row:hover .HXy9aG_chevronHover{opacity:1}.HXy9aG_title{color:var(--dsw-alias-label-secondary);flex:none;font-size:14px;line-height:24px}.HXy9aG_separator{background:var(--dsw-alias-label-caption);border-radius:1px;flex:none;width:2px;height:2px;margin:0 8px}.HXy9aG_summary{text-overflow:ellipsis;white-space:nowrap;min-width:0;color:var(--dsw-alias-label-tertiary);flex:auto;font-size:14px;line-height:24px;overflow:hidden}.HXy9aG_errorSummary{color:var(--dsw-alias-state-error-primary)}.HXy9aG_bodyWrap{flex-direction:column;display:flex}.HXy9aG_instructionsCard{border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-markdown-code-block);border-radius:12px;flex-direction:column;max-height:260px;margin:4px 0 4px 4px;display:flex;overflow:hidden}.HXy9aG_instructionsHeader{border-bottom:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-markdown-code-block-banner);color:var(--dsw-alias-label-caption);text-transform:uppercase;letter-spacing:.04em;flex:none;padding:8px 12px;font-size:11px;font-weight:500;line-height:16px}.HXy9aG_instructions{white-space:pre-wrap;overflow-wrap:anywhere;min-height:0;font:var(--dsw-font-markdown-code-block-small);color:var(--dsw-alias-label-secondary);margin:0;padding:10px 12px 12px;overflow:auto}.HXy9aG_instructions[data-error]{color:var(--dsw-alias-state-error-primary)}.HXy9aG_instructions::-webkit-scrollbar-thumb{background-clip:padding-box;border:2px solid #0000;border-radius:6px}.HXy9aG_instructions::-webkit-scrollbar-track{margin:6px 0}.HXy9aG_inspectButton{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-secondary);cursor:pointer;opacity:0;border-radius:999px;align-self:flex-start;align-items:center;gap:4px;margin:4px 0 2px 4px;padding:2px 8px;font-size:11px;line-height:16px;transition:opacity .1s;display:inline-flex}.HXy9aG_card:hover .HXy9aG_inspectButton,.HXy9aG_inspectButton:focus-visible{opacity:1}.HXy9aG_inspectButton:hover{background:var(--dsw-alias-interactive-bg-hover-solid);color:var(--dsw-alias-label-primary)}.HXy9aG_visuallyHidden{clip:rect(0 0 0 0);white-space:nowrap;width:1px;height:1px;position:absolute;overflow:hidden}@media (prefers-reduced-motion:reduce){.HXy9aG_card[data-state=running] .HXy9aG_row:after{animation:none;display:none}.HXy9aG_iconIdle,.HXy9aG_chevronHover,.HXy9aG_inspectButton{transition:none}}";
+		const tagId = "@monotykamary/dsh-client-ui-skill/SkillRow.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-skill";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var SkillRow_module_css_default = {
+			"visuallyHidden": "HXy9aG_visuallyHidden",
+			"leading": "HXy9aG_leading",
+			"title": "HXy9aG_title",
+			"instructionsHeader": "HXy9aG_instructionsHeader",
+			"inspectButton": "HXy9aG_inspectButton",
+			"instructions": "HXy9aG_instructions",
+			"instructionsCard": "HXy9aG_instructionsCard",
+			"row": "HXy9aG_row",
+			"bodyWrap": "HXy9aG_bodyWrap",
+			"dsh-skill-row-sweep": "HXy9aG_dsh-skill-row-sweep",
+			"chevronHover": "HXy9aG_chevronHover",
+			"summary": "HXy9aG_summary",
+			"errorSummary": "HXy9aG_errorSummary",
+			"separator": "HXy9aG_separator",
+			"iconIdle": "HXy9aG_iconIdle",
+			"card": "HXy9aG_card",
+			"chevron": "HXy9aG_chevron"
+		};
+		//#endregion
+		//#region lib/types/client/SkillRow.js
+		/** First physical line for the collapsed error summary and malformed-args fallback. */
+		function firstLine(text) {
+			const newline = text.indexOf("\n");
+			return newline === -1 ? text : text.slice(0, newline);
+		}
+		/** Skill names are the only call argument the compact row presents. */
+		function skillName(argsRaw, callId) {
+			try {
+				const parsed = JSON.parse(argsRaw);
+				if (typeof parsed === "object" && parsed !== null) {
+					const name = parsed.name;
+					if (typeof name === "string" && name !== "") return firstLine(name);
+				}
+			} catch {}
+			return argsRaw === "" ? callId : firstLine(argsRaw);
+		}
+		/** Flatten durable result blocks under the generic Tool-row text contract.
+		*  Keep aligned with ui-tool's models/tool-call-model.ts `resultText`. */
+		function resultText(block) {
+			if (!("kind" in block)) return null;
+			const parts = [];
+			for (const item of block.content) parts.push(item.type === "text" ? item.text : JSON.stringify(item, null, 2));
+			if (parts.length === 0 && block.error !== void 0) parts.push(`${block.error.name}: ${block.error.code}`);
+			return parts.join("\n") || null;
+		}
+		/** Derive display state without consulting the live skill catalog. */
+		function skillRowModel(block) {
+			const settled = "kind" in block;
+			const argsRaw = (settled ? block.call?.argsRaw : block.argsRaw) ?? "";
+			const state = !settled ? "running" : block.error?.code === "interrupted" ? "stopped" : block.isError ? "error" : "ok";
+			const output = resultText(block);
+			return {
+				name: skillName(argsRaw, block.callId),
+				output,
+				errorSummary: state === "error" && output !== null ? firstLine(output) : null,
+				state
+			};
+		}
+		/** State substitution for the collapsed leading slot. */
+		function leadingFor(state) {
+			switch (state) {
+				case "error": return (0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.StateDot, { state: "error" });
+				case "stopped": return (0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.StateDot, { state: "warning" });
+				default: return (0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.IconSkillOutline16, { size: 14 });
+			}
+		}
+		/** Leading disclosure slot: state icon at rest, chevron on hover or while open. */
+		function disclosureLeading(state, open, expandable) {
+			if (open) return (0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.IconChevronDownOutline14, { className: SkillRow_module_css_default.chevron });
+			const icon = leadingFor(state);
+			if (!expandable) return icon;
+			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsx)("span", {
+				className: SkillRow_module_css_default.iconIdle,
+				children: icon
+			}), (0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.IconChevronDownOutline14, { className: `${SkillRow_module_css_default.chevron} ${SkillRow_module_css_default.chevronHover}` })] });
+		}
+		/** Visually hidden state copy for the colour-only lifecycle cues. */
+		function stateStatus(state, t) {
+			switch (state) {
+				case "running": return t("row.running");
+				case "error": return t("row.failed");
+				case "stopped": return t("row.stopped");
+				default: return null;
+			}
+		}
+		/**
+		* Render one `skill` tool call as an accent summary and instructions disclosure.
+		* @param props - keyed toolview payload plus the skill locale seat.
+		* @returns the dedicated skill row.
+		*/
+		function SkillRow({ block, inspect, t }) {
+			const model = skillRowModel(block);
+			const [expanded, setExpanded] = (0, react.useState)(false);
+			const expandable = model.output !== null;
+			const open = expanded && expandable;
+			const status = stateStatus(model.state, t);
+			const summary = model.errorSummary ?? model.name;
+			const toggleExpand = () => {
+				setExpanded((value) => !value);
+			};
+			const toggleFromKeyboard = (event) => {
+				if (!expandable || event.key !== "Enter" && event.key !== " ") return;
+				event.preventDefault();
+				toggleExpand();
+			};
+			const disclosureProps = expandable ? {
+				role: "button",
+				tabIndex: 0,
+				"aria-expanded": open,
+				onClick: toggleExpand,
+				onKeyDown: toggleFromKeyboard
+			} : {};
+			const leading = disclosureLeading(model.state, open, expandable);
+			return (0, react_jsx_runtime.jsxs)("div", {
+				className: SkillRow_module_css_default.card,
+				"data-tool": "skill",
+				"data-state": model.state,
+				children: [(0, react_jsx_runtime.jsxs)("div", {
+					className: SkillRow_module_css_default.row,
+					"data-expandable": expandable || void 0,
+					...disclosureProps,
+					children: [
+						(0, react_jsx_runtime.jsx)("span", {
+							className: SkillRow_module_css_default.leading,
+							children: leading
+						}),
+						status !== null ? (0, react_jsx_runtime.jsx)("span", {
+							className: SkillRow_module_css_default.visuallyHidden,
+							children: status
+						}) : null,
+						(0, react_jsx_runtime.jsx)("span", {
+							className: SkillRow_module_css_default.title,
+							children: "Skill"
+						}),
+						(0, react_jsx_runtime.jsx)("span", {
+							className: SkillRow_module_css_default.separator,
+							"aria-hidden": true
+						}),
+						(0, react_jsx_runtime.jsx)("span", {
+							className: model.errorSummary === null ? SkillRow_module_css_default.summary : `${SkillRow_module_css_default.summary} ${SkillRow_module_css_default.errorSummary}`,
+							children: summary
+						})
+					]
+				}), open ? (0, react_jsx_runtime.jsxs)("div", {
+					className: SkillRow_module_css_default.bodyWrap,
+					children: [(0, react_jsx_runtime.jsxs)("section", {
+						className: SkillRow_module_css_default.instructionsCard,
+						"aria-label": t("row.instructions"),
+						children: [(0, react_jsx_runtime.jsx)("div", {
+							className: SkillRow_module_css_default.instructionsHeader,
+							children: t("row.instructions")
+						}), (0, react_jsx_runtime.jsx)("pre", {
+							className: SkillRow_module_css_default.instructions,
+							"data-error": model.state === "error" || void 0,
+							children: model.output
+						})]
+					}), inspect !== void 0 ? (0, react_jsx_runtime.jsxs)("button", {
+						type: "button",
+						className: SkillRow_module_css_default.inspectButton,
+						onClick: inspect,
+						children: [(0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.IconInspectOutline12, {}), "Inspect"]
+					}) : null]
+				}) : null]
+			});
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		/** `skill` namespace dictionaries for the dedicated tool row. */
+		/** Dictionary namespace owned by this plugin. */
+		const NS = "skill";
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"row.running": "正在加载 skill",
+			"row.failed": "skill 加载失败",
+			"row.stopped": "skill 加载已中止",
+			"row.instructions": "说明",
+			"menu.userOnly": "仅用户"
+		};
+		/** English dictionary, checked complete against the zh key set. */
+		const en = {
+			"row.running": "Loading skill",
+			"row.failed": "Skill load failed",
+			"row.stopped": "Skill load stopped",
+			"row.instructions": "Instructions",
+			"menu.userOnly": "user-only"
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** Required services: reference source faces plus the tool-row and locale registries. */
+		const inject = [
+			"inputTriggers",
+			"connection",
+			"sessions",
+			"slots",
+			"locale",
+			"remote"
+		];
+		/**
+		* Client plugin body: register the '/' source, dictionaries, and keyed tool row.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "ui-skill: dictionaries");
+			ctx.slots.inject("tool.call.toolview", () => ctx.slots.register({
+				name: "tool.call.toolview",
+				key: "skill",
+				locale: NS
+			}, SkillRow));
+			const skills = ctx.get("connection").api.skills;
+			const sessions = ctx.get("sessions");
+			const fetches = /* @__PURE__ */ new Map();
+			const lexiconListeners = /* @__PURE__ */ new Map();
+			const notifyLexicon = (sessionId) => {
+				for (const listener of [...lexiconListeners.get(sessionId) ?? []]) try {
+					listener();
+				} catch (error) {
+					console.error("[ui-skill] lexicon listener failed:", error);
+				}
+			};
+			const fetchCatalog = (sessionId) => {
+				if (sessions.subagentAddress(sessionId) !== void 0) return Promise.resolve([]);
+				const existing = fetches.get(sessionId);
+				if (existing !== void 0) return existing.promise;
+				const abort = new AbortController();
+				const promise = (async () => {
+					const { result } = await skills.list({ sessionId }, abort.signal);
+					if (!result.ok) throw new Error(`skill.list failed: ${result.error.code}: ${result.error.message}`);
+					return result.value.skills;
+				})();
+				const entry = {
+					promise,
+					abort
+				};
+				fetches.set(sessionId, entry);
+				promise.then((skills) => {
+					entry.settled = skills;
+					notifyLexicon(sessionId);
+				}, () => {
+					if (fetches.get(sessionId) === entry) fetches.delete(sessionId);
+				});
+				return promise;
+			};
+			const invalidate = (key) => {
+				const entry = fetches.get(key);
+				if (entry === void 0) return;
+				fetches.delete(key);
+				entry.abort.abort();
+				notifyLexicon(key);
+			};
+			const clearAll = () => {
+				for (const key of [...fetches.keys()]) invalidate(key);
+			};
+			const t = ctx.locale.bind(NS);
+			const source = {
+				trigger: "/",
+				name: "skill",
+				order: 2,
+				async candidates(session, { query, signal }) {
+					const skills = await fetchCatalog(session.sessionId);
+					if (signal.aborted) return [];
+					return skills.filter((skill) => skill.name.startsWith(query)).map((skill) => ({
+						name: skill.name,
+						description: skill.modelInvocable ? skill.description : `${t("menu.userOnly")} · ${skill.description}`
+					}));
+				},
+				warm(session) {
+					fetchCatalog(session.sessionId).catch(() => {});
+				},
+				lexicon(session) {
+					return fetches.get(session.sessionId)?.settled?.map((skill) => skill.name);
+				},
+				subscribeLexicon(session, listener) {
+					const key = session.sessionId;
+					const listeners = lexiconListeners.get(key) ?? /* @__PURE__ */ new Set();
+					listeners.add(listener);
+					lexiconListeners.set(key, listeners);
+					return () => {
+						listeners.delete(listener);
+						if (listeners.size === 0) lexiconListeners.delete(key);
+					};
+				},
+				onPick({ candidate }) {
+					return { text: `/${candidate.name} ` };
+				}
+			};
+			const inputTriggers = ctx.get("inputTriggers");
+			ctx.remote.$on("agent-preset/selected", invalidate);
+			ctx.on("connection/reset", clearAll);
+			ctx.effect(() => {
+				const unregister = inputTriggers.registerSource(source);
+				return () => {
+					unregister();
+					clearAll();
+				};
+			}, "ui-skill: source");
+		}
+		//#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
+/**
+* Skill 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,25 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@monotykamary/dsh-client-ui-skill`.
+* @module @monotykamary/dsh-client-ui-skill/invariant
+*/
+const PACKAGE_NAME = "@monotykamary/dsh-client-ui-skill";
+/** Cordis companion plugin name. */
+const name = "client-ui-skill-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: the slash source, locale dictionaries, and keyed
+* toolview are registry-owned registrations whose disposal is proven by the
+* HMR-safety spec. They emit no cordis events and own 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/SkillRow.d.ts

@@ -0,0 +1,12 @@
+import type { ToolCallViewProps } from '@monotykamary/dsh-client-ui-tool/client';
+import type { PropsLocale } from '@monotykamary/dsh-client-ui-slots';
+/** Full row props: the toolview runtime share plus this package's locale seat. */
+type SkillRowProps = ToolCallViewProps & PropsLocale<'skill'>;
+/**
+ * Render one `skill` tool call as an accent summary and instructions disclosure.
+ * @param props - keyed toolview payload plus the skill locale seat.
+ * @returns the dedicated skill row.
+ */
+export declare function SkillRow({ block, inspect, t }: SkillRowProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=SkillRow.d.ts.map

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

@@ -0,0 +1,16 @@
+import type { ClientContext } from '@monotykamary/dsh-client-runtime/client';
+import { type SkillKey } from './locales.ts';
+declare module '@monotykamary/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The dedicated skill tool row's copy. */
+        skill: SkillKey;
+    }
+}
+/** Required services: reference source faces plus the tool-row and locale registries. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the '/' source, dictionaries, and keyed tool row.
+ * @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,22 @@
+/** `skill` namespace dictionaries for the dedicated tool row. */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "skill";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'row.running': string;
+    'row.failed': string;
+    'row.stopped': string;
+    'row.instructions': string;
+    'menu.userOnly': string;
+};
+/** The skill namespace key union. */
+export type SkillKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'row.running': string;
+    'row.failed': string;
+    'row.stopped': string;
+    'row.instructions': string;
+    'menu.userOnly': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Skill 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-skill`.
+ * @module @monotykamary/dsh-client-ui-skill/invariant
+ */
+import type { Context } from '@monotykamary/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-skill-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,85 @@
+{
+  "name": "@monotykamary/dsh-client-ui-skill",
+  "description": "Web skill references and the dedicated skill tool row",
+  "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-skill"
+  },
+  "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-runtime",
+        "@monotykamary/dsh-client-locale",
+        "@monotykamary/dsh-client-ui-tool",
+        "@monotykamary/dsh-client-ui-input-trigger",
+        "@monotykamary/dsh-api-remotes"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "@monotykamary/dsh-api-remotes": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-connection": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-locale": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-input-trigger": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-tool": "^0.1.0-rc.5",
+    "@monotykamary/dsh-invariants": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-runtime": "^0.1.0-rc.5",
+    "@monotykamary/cordis": "^4.0.1",
+    "@monotykamary/dsh-client-ui-primitives": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-slots": "^0.1.0-rc.5"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "@monotykamary/dsh-client-locale": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-connection": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-runtime": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-primitives": "^0.1.0-rc.5",
+    "@monotykamary/dsh-api-remotes": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-input-trigger": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-slots": "^0.1.0-rc.5",
+    "@monotykamary/dsh-invariants": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-test-runtime": "^0.1.0-rc.5",
+    "@monotykamary/cordis": "^4.0.1",
+    "@monotykamary/dsh-client-ui-tool": "^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"
+  }
+}