@morlay/dsh-reference-injection 0.0.2-alpha.0

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,23 @@
+# @morlay/dsh-reference-injection
+
+把用户消息里的 skill 引用在 `agent/pre-step` 边界展开成 `<skill_content>` 注入消息：引用由 client 面同一份
+统一解析（`@morlay/dsh-client-ui-primitives` 的 `findReferences`）认领，消息文本本身不动。
+
+## 行为
+
+- 只扫描本步 claimed 的 `source.kind === 'user'` 消息（外部文本伪造不了这个手势）；
+- 认领所有引用形态：`skill:name`、`@skill:name`、`[label](skill:name)`、`@[label](skill:name)`；
+  手写的 inline code（`` `skill:name` ``）由 `parseReferenceToken` 再兜一次；
+  代码块内的同形文本不会命中（解析器保证）；
+- 名字不在 skill 注册表里、或该 skill 不允许用户调用时保持普通文本；
+- 去重按首次出现顺序；每个名字注入一条 instructions 形态的消息，追加在本步已有注入之后。
+
+## 装配
+
+部署侧（preset / profile bundle）插入一行即可；本部署的装配在 `@morlay/dsh-preset` 的 bundle patch 里
+（`packages/preset/dsh-preset/cordis.patch.yml`）。
+
+## 范围
+
+只处理 `protocol === 'skill'` 的引用；文件引用的解析与渲染不在本插件，判定见
+[ADR-引用的统一解析与渲染转换](../../session/ui-conversation-message-actions/.agents/adrs/20260917-引用的统一解析与渲染转换.md)。

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+# 本包是纯插件：装配点是部署侧（preset）的一行，不经 bundle patch；
+# 空 patch 只为满足包 exports 约定。
+[]

package/dist/index.d.mts

@@ -0,0 +1,7 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/index.d.ts
+declare const name = "reference-injection";
+declare const inject: string[];
+declare function apply(ctx: Context): void;
+//#endregion
+export { apply, inject, name };

package/dist/index.mjs

@@ -0,0 +1,81 @@
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
+import { isUserInvocable, renderSkillContent } from "@deepseek-ai/dsh-skill";
+import { findReferences, parseReferenceToken } from "@morlay/dsh-client-ui-primitives";
+import { fromMarkdown } from "mdast-util-from-markdown";
+//#region src/links.ts
+const SKILL_PROTOCOL = "skill";
+function walk(node, visit) {
+	visit(node);
+	for (const child of node.children ?? []) walk(child, visit);
+}
+function inlineCodeSkillNames(text) {
+	const names = [];
+	walk(fromMarkdown(text), (node) => {
+		if (node.type !== "inlineCode" || node.value === void 0) return;
+		const reference = parseReferenceToken(node.value);
+		if (reference?.protocol === SKILL_PROTOCOL && reference.path !== void 0) names.push(reference.path);
+	});
+	return names;
+}
+function skillNamesIn(messages) {
+	const names = [];
+	const push = (name) => {
+		if (name === void 0 || name === "" || names.includes(name)) return;
+		names.push(name);
+	};
+	for (const message of messages) {
+		if (message.source.kind !== "user") continue;
+		for (const block of message.content) {
+			if (block.type !== "text") continue;
+			for (const span of findReferences(block.text)) {
+				if (span.reference.protocol !== SKILL_PROTOCOL) continue;
+				push(span.reference.path);
+			}
+			for (const name of inlineCodeSkillNames(block.text)) push(name);
+		}
+	}
+	return names;
+}
+//#endregion
+//#region src/index.ts
+const name = "reference-injection";
+const inject = ["skills"];
+function apply(ctx) {
+	ctx.on("agent/pre-step", async ({ agent, messages, signal }, next) => {
+		const decision = await next();
+		if (decision.kind === "reject") return decision;
+		const names = skillNamesIn(messages);
+		if (names.length === 0) return decision;
+		signal.throwIfAborted();
+		const lookup = {
+			cwd: agent.session.header.cwd,
+			signal,
+			scope: agent
+		};
+		const injections = [];
+		for (const name of names) {
+			const skill = await ctx.skills.get(name, lookup);
+			signal.throwIfAborted();
+			if (skill === void 0 || !isUserInvocable(skill)) continue;
+			const source = {
+				kind: "skill-invocation",
+				name,
+				form: "instructions"
+			};
+			injections.push(createUserMessage({
+				content: [{
+					type: "text",
+					text: renderSkillContent(skill)
+				}],
+				source
+			}));
+		}
+		if (injections.length === 0) return decision;
+		return {
+			...decision,
+			messages: [...decision.messages, ...injections]
+		};
+	});
+}
+//#endregion
+export { apply, inject, name };

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@morlay/dsh-reference-injection",
+  "version": "0.0.2-alpha.0",
+  "description": "Expands a referenced skill (`skill:name`) into an injected <skill_content> instructions message at the pre-step boundary.",
+  "keywords": [
+    "context",
+    "dsh",
+    "dsh-plugin",
+    "reference",
+    "skill"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/morlay/dsh-plugin.git"
+  },
+  "files": [
+    "dist",
+    "src",
+    "cordis.patch.yml",
+    "!**/__tests__"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json",
+    "./cordis.patch.yml": "./cordis.patch.yml"
+  },
+  "dependencies": {
+    "@morlay/dsh-client-ui-primitives": "^0.0.2-alpha.0",
+    "mdast-util-from-markdown": "^2.0.3"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-skill": "^0.1.6-alpha.2",
+    "@types/mdast": "^4.0.4"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-skill": "^0.1.6-alpha.2"
+  },
+  "scripts": {
+    "build": "pnpm exec tsdown"
+  }
+}

package/src/index.ts

@@ -0,0 +1,45 @@
+import type { Context } from "@deepseek-ai/cordis";
+import type { PreStepDecision } from "@deepseek-ai/dsh-agent";
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
+import type { UserMessage } from "@deepseek-ai/dsh-session";
+import {
+  isUserInvocable,
+  renderSkillContent,
+  type SkillInvocationSource,
+} from "@deepseek-ai/dsh-skill";
+import { skillNamesIn } from "./links.ts";
+
+export const name = "reference-injection";
+
+export const inject = ["skills"];
+
+export function apply(ctx: Context): void {
+  ctx.on("agent/pre-step", async ({ agent, messages, signal }, next): Promise<PreStepDecision> => {
+    const decision = await next();
+    if (decision.kind === "reject") return decision;
+    const names = skillNamesIn(messages);
+    if (names.length === 0) return decision;
+    signal.throwIfAborted();
+    const lookup = { cwd: agent.session.header.cwd, signal, scope: agent };
+    const injections: UserMessage[] = [];
+    for (const name of names) {
+      const skill = await ctx.skills.get(name, lookup);
+      signal.throwIfAborted();
+
+      if (skill === undefined || !isUserInvocable(skill)) continue;
+      const source: SkillInvocationSource = {
+        kind: "skill-invocation",
+        name,
+        form: "instructions",
+      };
+      injections.push(
+        createUserMessage({
+          content: [{ type: "text", text: renderSkillContent(skill) }],
+          source,
+        }),
+      );
+    }
+    if (injections.length === 0) return decision;
+    return { ...decision, messages: [...decision.messages, ...injections] };
+  });
+}

package/src/links.ts

@@ -0,0 +1,49 @@
+import type { UserMessage } from "@deepseek-ai/dsh-session";
+import { findReferences, parseReferenceToken } from "@morlay/dsh-client-ui-primitives";
+import { fromMarkdown } from "mdast-util-from-markdown";
+
+const SKILL_PROTOCOL = "skill";
+
+interface MarkdownNode {
+  readonly type: string;
+  readonly value?: string;
+  readonly children?: readonly MarkdownNode[];
+}
+
+function walk(node: MarkdownNode, visit: (node: MarkdownNode) => void): void {
+  visit(node);
+  for (const child of node.children ?? []) walk(child, visit);
+}
+
+function inlineCodeSkillNames(text: string): string[] {
+  const names: string[] = [];
+  const root = fromMarkdown(text) as unknown as MarkdownNode;
+  walk(root, (node) => {
+    if (node.type !== "inlineCode" || node.value === undefined) return;
+    const reference = parseReferenceToken(node.value);
+    if (reference?.protocol === SKILL_PROTOCOL && reference.path !== undefined) {
+      names.push(reference.path);
+    }
+  });
+  return names;
+}
+
+export function skillNamesIn(messages: readonly UserMessage[]): string[] {
+  const names: string[] = [];
+  const push = (name: string | undefined): void => {
+    if (name === undefined || name === "" || names.includes(name)) return;
+    names.push(name);
+  };
+  for (const message of messages) {
+    if ((message.source as { kind?: unknown }).kind !== "user") continue;
+    for (const block of message.content) {
+      if (block.type !== "text") continue;
+      for (const span of findReferences(block.text)) {
+        if (span.reference.protocol !== SKILL_PROTOCOL) continue;
+        push(span.reference.path);
+      }
+      for (const name of inlineCodeSkillNames(block.text)) push(name);
+    }
+  }
+  return names;
+}