@ai-setting/roy-agent-core 1.7.32 → 1.7.34

package/dist/env/event-source/index.js

@@ -11,7 +11,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-4csc7ars.js";
+} from "../../shared/@ai-setting/roy-agent-core-ybg8sayk.js";
 import"../../shared/@ai-setting/roy-agent-core-0nz53t5v.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
@@ -22,7 +22,7 @@ import {
   isValidEventSourceType,
   validateEventSourceConfig
 } from "../../shared/@ai-setting/roy-agent-core-ds5f75pg.js";
-import"../../shared/@ai-setting/roy-agent-core-9z6gcy77.js";
+import"../../shared/@ai-setting/roy-agent-core-6f7cjzem.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../../shared/@ai-setting/roy-agent-core-1df0grva.js";
@@ -30,7 +30,7 @@ import"../../shared/@ai-setting/roy-agent-core-jdvgzf2y.js";
 import"../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
 import"../../shared/@ai-setting/roy-agent-core-jbc1t62x.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
+import"../../shared/@ai-setting/roy-agent-core-rmn29nrh.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
 import"../../shared/@ai-setting/roy-agent-core-m725wp1x.js";
 import"../../shared/@ai-setting/roy-agent-core-sf4bjgwz.js";

package/dist/env/index.js

@@ -1,6 +1,6 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-4t6m600m.js";
+} from "../shared/@ai-setting/roy-agent-core-mssk8f0g.js";
 import {
   TaskComponent
 } from "../shared/@ai-setting/roy-agent-core-m09a4xwh.js";
@@ -15,7 +15,7 @@ import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-4csc7ars.js";
+} from "../shared/@ai-setting/roy-agent-core-ybg8sayk.js";
 import"../shared/@ai-setting/roy-agent-core-0nz53t5v.js";
 import {
   EventSourceInitHooks,
@@ -24,7 +24,7 @@ import {
   isValidEventSourceType,
   validateEventSourceConfig
 } from "../shared/@ai-setting/roy-agent-core-ds5f75pg.js";
-import"../shared/@ai-setting/roy-agent-core-9z6gcy77.js";
+import"../shared/@ai-setting/roy-agent-core-6f7cjzem.js";
 import"../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import {
@@ -69,8 +69,8 @@ import"../shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   PluginComponent
-} from "../shared/@ai-setting/roy-agent-core-0ra1gtn9.js";
-import"../shared/@ai-setting/roy-agent-core-az13yzmc.js";
+} from "../shared/@ai-setting/roy-agent-core-bt7mg8j5.js";
+import"../shared/@ai-setting/roy-agent-core-rmn29nrh.js";
 import {
   McpComponent
 } from "../shared/@ai-setting/roy-agent-core-gjnhkemk.js";

package/dist/env/plugin/index.js

@@ -1,10 +1,11 @@
 import {
   EventBusNotificationChannel,
   PluginComponent
-} from "../../shared/@ai-setting/roy-agent-core-0ra1gtn9.js";
+} from "../../shared/@ai-setting/roy-agent-core-bt7mg8j5.js";
 import {
-  BasePlugin
-} from "../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
+  BasePlugin,
+  normalizeLarkAtMentions
+} from "../../shared/@ai-setting/roy-agent-core-rmn29nrh.js";
 import"../../shared/@ai-setting/roy-agent-core-m725wp1x.js";
 import"../../shared/@ai-setting/roy-agent-core-sf4bjgwz.js";
 import"../../shared/@ai-setting/roy-agent-core-g772q3gf.js";
@@ -64,6 +65,7 @@ ${options.content}`;
     return new Promise((resolve, reject) => {
       const { chatId, messageId, content, profile } = options;
       let args;
+      const normalizedContent = normalizeLarkAtMentions(content);
       if (messageId) {
         args = [
           "im",
@@ -71,7 +73,7 @@ ${options.content}`;
           "--message-id",
           messageId,
           "--markdown",
-          content,
+          normalizedContent,
           "--as",
           "bot"
         ];
@@ -82,7 +84,7 @@ ${options.content}`;
           "--chat-id",
           chatId,
           "--markdown",
-          content
+          normalizedContent
         ];
       }
       if (profile) {

package/dist/env/task/plugins/index.js

@@ -10,7 +10,7 @@ import {
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-9z6gcy77.js";
+} from "../../../shared/@ai-setting/roy-agent-core-6f7cjzem.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../../../shared/@ai-setting/roy-agent-core-1df0grva.js";
@@ -18,7 +18,7 @@ import"../../../shared/@ai-setting/roy-agent-core-jdvgzf2y.js";
 import"../../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
 import"../../../shared/@ai-setting/roy-agent-core-jbc1t62x.js";
 import"../../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
+import"../../../shared/@ai-setting/roy-agent-core-rmn29nrh.js";
 import"../../../shared/@ai-setting/roy-agent-core-m2pxg5d8.js";
 import"../../../shared/@ai-setting/roy-agent-core-7p6rny5m.js";
 import"../../../shared/@ai-setting/roy-agent-core-38rtrpk3.js";

package/dist/index.js

@@ -66,7 +66,7 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-4t6m600m.js";
+} from "./shared/@ai-setting/roy-agent-core-mssk8f0g.js";
 import {
   TaskComponent
 } from "./shared/@ai-setting/roy-agent-core-m09a4xwh.js";
@@ -92,7 +92,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "./shared/@ai-setting/roy-agent-core-4csc7ars.js";
+} from "./shared/@ai-setting/roy-agent-core-ybg8sayk.js";
 import {
   LogTraceComponent,
   LogTraceConfigSchema
@@ -109,7 +109,7 @@ import {
 import {
   TaskTagPlugin,
   createAutoTaskPlugin
-} from "./shared/@ai-setting/roy-agent-core-9z6gcy77.js";
+} from "./shared/@ai-setting/roy-agent-core-6f7cjzem.js";
 import {
   TaskHookPoints
 } from "./shared/@ai-setting/roy-agent-core-1pg0fepg.js";
@@ -189,10 +189,10 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   PluginComponent
-} from "./shared/@ai-setting/roy-agent-core-0ra1gtn9.js";
+} from "./shared/@ai-setting/roy-agent-core-bt7mg8j5.js";
 import {
   BasePlugin
-} from "./shared/@ai-setting/roy-agent-core-az13yzmc.js";
+} from "./shared/@ai-setting/roy-agent-core-rmn29nrh.js";
 import {
   McpComponent
 } from "./shared/@ai-setting/roy-agent-core-gjnhkemk.js";

package/dist/shared/@ai-setting/{roy-agent-core-9z6gcy77.js → roy-agent-core-6f7cjzem.js}

@@ -11,8 +11,9 @@ import {
   enqueueToAddFakeUserMessage
 } from "./roy-agent-core-jbc1t62x.js";
 import {
-  BasePlugin
-} from "./roy-agent-core-az13yzmc.js";
+  BasePlugin,
+  normalizeLarkAtMentions
+} from "./roy-agent-core-rmn29nrh.js";
 import {
   init_context
 } from "./roy-agent-core-m2pxg5d8.js";
@@ -556,6 +557,7 @@ ${content}`;
     return new Promise((resolve, reject) => {
       const { chatId, messageId, content, profile } = options;
       let args;
+      const normalizedContent = normalizeLarkAtMentions(content);
       if (messageId) {
         args = [
           "im",
@@ -563,7 +565,7 @@ ${content}`;
           "--message-id",
           messageId,
           "--markdown",
-          content,
+          normalizedContent,
           "--as",
           "bot"
         ];
@@ -574,7 +576,7 @@ ${content}`;
           "--chat-id",
           chatId,
           "--markdown",
-          content
+          normalizedContent
         ];
       }
       if (profile) {
@@ -1138,7 +1140,7 @@ class PerTaskGroupChatPlugin {
       "--chat-id",
       opts.chatId,
       "--markdown",
-      opts.content,
+      normalizeLarkAtMentions(opts.content),
       "--as",
       "bot"
     ];
@@ -1175,9 +1177,9 @@ class PerTaskGroupChatPlugin {
   }
   sendToMain(replyChannel, opts) {
     return new Promise((resolve, reject) => {
-      const message = `${opts.title}
+      const message = normalizeLarkAtMentions(`${opts.title}
 
-${opts.content}`;
+${opts.content}`);
       const args = replyChannel.messageId ? ["im", "+messages-reply", "--message-id", replyChannel.messageId, "--markdown", message, "--as", "bot"] : ["im", "+messages-send", "--chat-id", replyChannel.chatId, "--markdown", message];
       if (opts.profile) {
         args.unshift("--profile", opts.profile);

package/dist/shared/@ai-setting/{roy-agent-core-0ra1gtn9.js → roy-agent-core-bt7mg8j5.js}

@@ -1,6 +1,6 @@
 import {
   BasePlugin
-} from "./roy-agent-core-az13yzmc.js";
+} from "./roy-agent-core-rmn29nrh.js";
 import {
   BaseComponent
 } from "./roy-agent-core-m725wp1x.js";

package/dist/shared/@ai-setting/{roy-agent-core-4t6m600m.js → roy-agent-core-mssk8f0g.js}

@@ -1,6 +1,6 @@
 import {
   createAutoTaskPlugin
-} from "./roy-agent-core-9z6gcy77.js";
+} from "./roy-agent-core-6f7cjzem.js";
 import {
   ContextError,
   ErrorCodes

package/dist/shared/@ai-setting/roy-agent-core-rmn29nrh.js

@@ -0,0 +1,34 @@
+// src/env/plugin/types.ts
+class BasePlugin {
+  version = "1.0.0";
+  description;
+  priority = 0;
+  constructor() {}
+  init(env) {}
+  dispose() {}
+}
+
+// src/env/lark-mention-utils.ts
+var SELF_CLOSING_AT_RE = /<at\s+user_id\s*=\s*(?:"([^"]+)"|'([^']+)'|([^\s>]+))\s*\/\s*>/g;
+function normalizeLarkAtMentions(content, nameMap) {
+  if (!content)
+    return content;
+  return content.replace(SELF_CLOSING_AT_RE, (_match, dq, sq, bare) => {
+    const userId = dq ?? sq ?? bare ?? "";
+    if (!userId)
+      return _match;
+    const displayName = nameMap?.get(userId);
+    if (displayName) {
+      return `<at user_id="${escapeXmlAttr(userId)}">${escapeXmlText(displayName)}</at>`;
+    }
+    return `<at user_id="${escapeXmlAttr(userId)}"></at>`;
+  });
+}
+function escapeXmlAttr(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function escapeXmlText(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+
+export { BasePlugin, normalizeLarkAtMentions };

package/dist/shared/@ai-setting/{roy-agent-core-4csc7ars.js → roy-agent-core-ybg8sayk.js}

@@ -2,7 +2,10 @@ import {
   TaskTagPlugin,
   createLarkCliTaskNotifyHook,
   createPerTaskGroupChatPlugin
-} from "./roy-agent-core-9z6gcy77.js";
+} from "./roy-agent-core-6f7cjzem.js";
+import {
+  normalizeLarkAtMentions
+} from "./roy-agent-core-rmn29nrh.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-7hh0brvs.js";
@@ -867,6 +870,17 @@ function buildLarkRecommendedAction(opts) {
     `处理飞书 ${scopeWord}消息并以机器人身份回复${profileWarn}。`,
     `scope: ${scopeHint}。`,
     ``,
+    `## ⭐ 关键: 所有飞书回复必须用 --markdown flag (不要用 --text, 也不要裸调用)`,
+    `lark-cli 默认会让消息渲染成 plain text — 你的 Markdown 标签 (<at> mention、列表、`,
+    `**bold**、code block、表格等) 会被当成字面字符显示, 用户看到的就是`,
+    `一堆 raw 符号, 完全没法用。`,
+    `正确做法: 调 im +messages-{send,reply} 时必须显式加 --markdown <content>,`,
+    `飞书才会按 Markdown 渲染 rich format。`,
+    `**严禁**: 使用 --text flag (直接导致 rich format 失效, 是最常见的回归路径)`,
+    `          使用 --msg-type text (同理, --msg-type post 也可以但需对应结构,`,
+    `          最稳的仍然是 --markdown flag)`,
+    `          不加任何 content flag (会按 plain text 默认值处理)`,
+    ``,
     `## 安全传 Markdown（必读，避免飞书收到字面 $ 和字面反斜杠+n）`,
     `多行 / 复杂 Markdown 必须先写入临时 .md 文件，再 cat 出来当 --markdown 的值。`,
     `原因：agent 工具调用层不做 shell 展开。`,
@@ -877,7 +891,7 @@ function buildLarkRecommendedAction(opts) {
     `  cat > "$reply_file" <<'LARK_REPLY_EOF'            # 3. 写入 Markdown（heredoc 单引号防 shell 展开）`,
     `  ...（这里是回复的 Markdown 内容，可以多行 / 含特殊字符）`,
     `  LARK_REPLY_EOF`,
-    `  lark-cli ${profileFlag}im +messages-reply --message-id <取自 replyTo.messageId> --as bot --markdown "$(cat "$reply_file")"   # 4. 真正调用`,
+    `  lark-cli ${profileFlag}im +messages-reply --message-id <取自 replyTo.messageId> --as bot --markdown "$(cat "$reply_file")"   # 4. 真正调用 (注意 --markdown flag, 不要用 --text)`,
     ``,
     `## 禁止（用 words 描述，避免被 LLM 当字面 trap 抄）`,
     `- 禁止把多行 Markdown 直接拼进 --markdown 参数`,
@@ -885,6 +899,8 @@ function buildLarkRecommendedAction(opts) {
     `- 禁止字面反斜杠+n（即 \\n 两个字符，不是 0x0A 控制字符）`,
     `- 禁止 stdin 形式传 Markdown（--markdown 后接一个短横线作为值的写法）`,
     `- 禁止 at-file 形式传 Markdown（--markdown 后接 @ 符号加文件名的写法）`,
+    `- 禁止 --text flag（让 lark-cli 把消息当 plain text, rich format 全部失效 — 见顶部说明）`,
+    `- 禁止 --msg-type text（同理, --msg-type post 可选但需对应结构, 仍不如 --markdown flag 稳）`,
     ``,
     `## 必须使用 replyTo 里给定的值`,
     `profile / chatId / messageId / --as bot 必须原样取自 recommendedAction.replyTo；不要凭印象自己拼接。`
@@ -1437,14 +1453,15 @@ class LarkCliInstance {
   async sendLarkMessage(options) {
     return new Promise((resolve, reject) => {
       const { chatId, userId, messageId, content, as: identity, format = "text", profile } = options;
+      const normalizedContent = normalizeLarkAtMentions(content);
       const contentFlag = format === "markdown" ? "--markdown" : "--text";
       const args = ["im"];
       if (messageId) {
-        args.push("+messages-reply", "--message-id", messageId, "--as", identity, contentFlag, content);
+        args.push("+messages-reply", "--message-id", messageId, "--as", identity, contentFlag, normalizedContent);
       } else if (chatId) {
-        args.push("+messages-send", "--chat-id", chatId, "--as", identity, contentFlag, content);
+        args.push("+messages-send", "--chat-id", chatId, "--as", identity, contentFlag, normalizedContent);
       } else if (userId) {
-        args.push("+messages-send", "--user-id", userId, "--as", identity, contentFlag, content);
+        args.push("+messages-send", "--user-id", userId, "--as", identity, contentFlag, normalizedContent);
       } else {
         reject(new Error("No target specified for sending message"));
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-core",
-  "version": "1.7.32",
+  "version": "1.7.34",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",

package/dist/shared/@ai-setting/roy-agent-core-az13yzmc.js

@@ -1,11 +0,0 @@
-// src/env/plugin/types.ts
-class BasePlugin {
-  version = "1.0.0";
-  description;
-  priority = 0;
-  constructor() {}
-  init(env) {}
-  dispose() {}
-}
-
-export { BasePlugin };