@blade-hq/agent-client 2612.0.0-beta.17 → 2612.0.0-beta.19

package/README.md

@@ -162,15 +162,15 @@ const first = index.items[0] // SessionTurnIndexItem
 
 创建会话时可以绑定 Streamable HTTP MCP 来源；BA 会在创建成功前读取并保存工具列表，
 来源此时必须可访问且接受创建请求中的 Bearer 凭据。之后沿用已发现的工具目录，
-刷新来源时更新目录。默认 `exposure: "lazy"` 通过 `plugin_list`、`plugin_inspect`、
-`plugin_run` 发现和调用工具；`exposure: "eager"` 会将 `include_tools` 允许的工具和完整
+刷新来源时更新目录。默认 `exposure: "lazy"` 通过 `lazy_tool_list`、`lazy_tool_inspect`、
+`lazy_tool_run` 发现和调用工具；`exposure: "eager"` 会将 `include_tools` 允许的工具和完整
 参数 schema 直接加入执行模式的模型工具列表，无需先 inspect。`eager_tools` 可在 lazy
 来源中选出直接暴露的工具，也可指定 eager 来源中的优先工具。主运行和子智能体使用相同
 策略，计划模式不加载。直接工具的名称为 `mcp_<来源>__<工具>_<hash>`，调用仍经 Go MCP
-dispatcher。会话 MCP 的可用工具名称按来源注入 `plugin_catalog`，lazy 工具完整 schema
-仍由 `plugin_inspect` 按需读取。每个运行最多直接加载 32 个工具、64 KiB 完整工具定义；
+dispatcher。会话 MCP 的可用工具名称按来源注入 `lazy_tool_catalog`，lazy 工具完整 schema
+由 `lazy_tool_inspect({tool: "session:<source>/<tool>"})` 按需读取。每个运行最多直接加载 32 个工具、64 KiB 完整工具定义；
 超预算的工具仍可通过
-`plugin_inspect/plugin_run` 使用。
+`lazy_tool_inspect/lazy_tool_run` 使用。
 Bearer 凭据只在创建或轮换时提交，查询不会返回它：
 
 ```ts
@@ -670,28 +670,17 @@ function Message({ message }: { message: ChatMessage }) {
 }
 ```
 
-### 让用户挑一个技能来做事
+### 在消息中引用技能
 
-自己实现技能选择器时，用 `transformSlashCommand` 把选中的技能翻译成智能体能执行的一段话：
+`SkillRef` 表示技能身份，`MessageRef` 是技能与插件引用的联合类型；`normalizeMessageRefs` 可校验和去重引用。自定义技能选择器把技能身份放进 `refs`，正文保留用户输入。运行时另行提供技能描述和文件路径，智能体根据原文判断解释、比较还是使用。
 
 ```ts
-import { transformSlashCommand, type SkillMentionAvailability } from "@blade-hq/agent-client"
-
-transformSlashCommand("org/data-analysis", "分析这份季度报表")
-// "请使用 org/data-analysis skill 完成任务\n分析这份季度报表"
-```
-
-第三个参数说明这个技能眼下能不能直接用。技能装没装、加载没加载，用户不需要知道，但智能体需要——传进来之后它会被翻译成对应的 CLI 步骤：
-
-```ts
-// Blade Hub 上已安装、但当前会话还没加载：要求先 use
-transformSlashCommand(skillId, prompt, { local: false, installed: true })
-
-// Blade Hub 上还没安装：要求先 install 再 use
-transformSlashCommand(skillId, prompt, { local: false, installed: false })
+session.send("@org/data-analysis 这是什么？", {
+  refs: [{ provider: "skill", id: "org/data-analysis", label: "org/data-analysis" }],
+})
 ```
 
-不传第三个参数时按本地已有处理，和不带这个参数的老用法结果一致。
+技能引用仅属于本条消息。`transformSlashCommand` 只把 `<skill>名称</skill>` 标记转换为 `@名称`，不会增加执行或安装指令；调用方仍需单独发送 `refs`。
 
 ## 运行错误说明：userFacingErrorText
 

package/dist/{chunk-IYVYCSNC.js → chunk-XKAHFAEI.js}

@@ -213,7 +213,7 @@ var ToolProvider = class {
 
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "2612.0.0-beta.17" : "1.1.1";
+var SDK_VERSION = true ? "2612.0.0-beta.19" : "1.1.1";
 
 // src/auth-login.ts
 function isAuthCallbackMessage(value) {
@@ -457,6 +457,19 @@ function normalizePluginRefs(value) {
     return [{ provider: "plugin", plugin: item.plugin, server: item.server, id: item.id, label: item.label }];
   });
 }
+function normalizeMessageRefs(value) {
+  if (!Array.isArray(value)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  return value.flatMap((item) => {
+    if (!item || typeof item !== "object") return [];
+    const ref = item.provider === "skill" && typeof item.id === "string" && item.id && typeof item.label === "string" && item.label ? { provider: "skill", id: item.id, label: item.label } : normalizePluginRefs([item])[0];
+    if (!ref) return [];
+    const key = ref.provider === "skill" ? JSON.stringify([ref.provider, ref.id]) : JSON.stringify([ref.provider, ref.plugin, ref.server, ref.id]);
+    if (seen.has(key)) return [];
+    seen.add(key);
+    return [ref];
+  });
+}
 
 // src/schemas/topic-assets.ts
 function normalizeTopicAssetRefs(value) {
@@ -1710,7 +1723,7 @@ var ClientProjectionBuilder = class {
   onUserMessage(_loopId, payload) {
     const entryId = String(payload.entry_id ?? this.nextTurnId("user"));
     const displayContent = payload.display_content ?? payload.content ?? "";
-    const refs = normalizePluginRefs(payload.refs);
+    const refs = normalizeMessageRefs(payload.refs);
     const turn = {
       id: entryId,
       sequence: this.nextSeq(),
@@ -2423,6 +2436,10 @@ function projectHistory(entries) {
         // root Agent 工具调用兜底配对,工作流 fork 没有,子智能体卡会整体消失)。
         parent_fork_tool_call_id: stringOrNull(message._parent_fork_tool_call_id)
       };
+      if (role === "user") {
+        const refs = normalizeMessageRefs(message.refs);
+        if (refs.length) turn.refs = refs;
+      }
       const isNativeToolEntry = role === "assistant" && Array.isArray(message.tool_calls) && message.tool_calls.some(
         (toolCall) => isRecord(toolCall) && typeof toolCall.provider === "string"
       );
@@ -2844,7 +2861,7 @@ var HeadlessResource = class {
     return this.runTracked(session_id, prompt, options, true);
   }
   async runTracked(sessionId, prompt, options, returnEnvelope) {
-    if ((options.refs?.length ?? 0) > 20) throw new HeadlessError("\u6BCF\u6761\u6D88\u606F\u6700\u591A\u9009\u62E9 20 \u4E2A\u63D2\u4EF6\u6761\u76EE");
+    if ((options.refs?.length ?? 0) > 20) throw new HeadlessError("\u6BCF\u6761\u6D88\u606F\u6700\u591A\u9009\u62E9 20 \u4E2A\u5F15\u7528");
     if ((options.topicAssetRefs?.length ?? 0) > 20) throw new HeadlessError("\u6BCF\u6761\u6D88\u606F\u6700\u591A\u5F15\u7528 20 \u4E2A\u4E3B\u9898\u8D44\u4EA7");
     const timeoutMs = options.timeoutMs ?? 3e5;
     const session_id = sessionId;
@@ -4654,15 +4671,8 @@ function contentPreview(content, maxLen = 80) {
   const text = getTextContent(content).trim();
   return text.length > maxLen ? `${text.slice(0, maxLen)}\u2026` : text;
 }
-function transformSlashCommand(skillName, rawInput, { local = true, installed = true } = {}) {
-  const prompt = rawInput.replace(`<skill>${skillName}</skill>`, "").trim();
-  if (local) {
-    return prompt ? `\u8BF7\u4F7F\u7528 ${skillName} skill \u5B8C\u6210\u4EFB\u52A1
-${prompt}` : `\u8BF7\u4F7F\u7528 ${skillName} skill \u5B8C\u6210\u4EFB\u52A1`;
-  }
-  const steps = installed ? `\u8BF7\u5148\u8FD0\u884C blade hub skill use ${skillName} \u52A0\u8F7D\u6280\u80FD` : `\u8BE5\u6280\u80FD\u5C1A\u672A\u5B89\u88C5\u3002\u8BF7\u5148\u8FD0\u884C blade hub skill install ${skillName} \u5B89\u88C5\uFF0C\u518D\u8FD0\u884C blade hub skill use ${skillName} \u52A0\u8F7D`;
-  return prompt ? `${steps}\uFF0C\u7136\u540E\u5B8C\u6210\u4EFB\u52A1\uFF1A
-${prompt}` : `${steps}\uFF0C\u7136\u540E\u4F7F\u7528\u5B83\u5B8C\u6210\u4EFB\u52A1`;
+function transformSlashCommand(skillName, rawInput, _availability = {}) {
+  return rawInput.replace(`<skill>${skillName}</skill>`, `@${skillName}`).trim();
 }
 var ATTACHMENT_TAG_RE = /\[附件:\s*([^\]]+)\](?:[ \t]*已上传到工作区路径:[ \t]*([^\r\n]+))?/g;
 var CONTEXT_PART_RE = /^\[上下文:\s*([^\]]+)\]\n([\s\S]*)$/;
@@ -8464,6 +8474,7 @@ export {
   SDK_VERSION,
   isRecord,
   normalizePluginRefs,
+  normalizeMessageRefs,
   normalizeTopicAssetRefs,
   inferToolStatus,
   contextProjectionData,
@@ -8543,4 +8554,4 @@ export {
   createSocket,
   BladeClient
 };
-//# sourceMappingURL=chunk-IYVYCSNC.js.map
+//# sourceMappingURL=chunk-XKAHFAEI.js.map