@ai-setting/roy-agent-core 1.7.35 → 1.7.37

package/dist/shared/@ai-setting/{roy-agent-core-242peyss.js → roy-agent-core-em8618g6.js}

@@ -2,7 +2,7 @@ import {
   TaskTagPlugin,
   createLarkCliTaskNotifyHook,
   createPerTaskGroupChatPlugin
-} from "./roy-agent-core-gcnvcbft.js";
+} from "./roy-agent-core-e4v61k3j.js";
 import {
   normalizeLarkAtMentions
 } from "./roy-agent-core-rmn29nrh.js";
@@ -11,18 +11,18 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-62c1t7wr.js";
+} from "./roy-agent-core-m7dppx2p.js";
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-743510fc.js";
+} from "./roy-agent-core-fym6zz5a.js";
 import {
   init_context
-} from "./roy-agent-core-1kcstbn3.js";
+} from "./roy-agent-core-whta3f53.js";
 import {
   createEnvContext,
   runWithEnvContext
-} from "./roy-agent-core-jxgprc5a.js";
+} from "./roy-agent-core-n82acszf.js";
 import {
   TracedAs,
   init_decorator
@@ -832,6 +832,9 @@ var bountyCliHandler = {
 // src/env/event-source/event-source-handlers.ts
 init_logger();
 var logger = createLogger("lark-cli:event-source");
+function isPluginDebugEnabled() {
+  return process.env.ROY_TASK_NOTIFY_DEBUG === "1" || process.env.ROY_TRACE_DEBUG === "1";
+}
 var BUILT_IN_PLUGIN_FACTORIES = {
   LarkCliTaskNotifyPlugin: (cfg) => createLarkCliTaskNotifyHook(cfg),
   PerTaskGroupChatPlugin: (cfg) => createPerTaskGroupChatPlugin(cfg),
@@ -864,55 +867,49 @@ function buildLarkRecommendedAction(opts) {
   const profileFlag = profile ? `--profile ${profile} ` : "";
   const profileWarn = profile ? `（⚠️ 必须用 profile="${profile}" 调 lark-cli；openId per-app 隔离，换 profile 会失败）` : "";
   const isGroup = chatType === "group";
-  const scopeHint = isGroup ? `群聊消息；回复到 replyTo.chatId。如需 @mention 发件人，请在 Markdown 正文开头加空闭合的 <at user_id="<senderId>"></at>（飞书只认这种语法，自闭合的 <at user_id="<senderId>"/> 不工作，会渲染成原始标签文本）。` : "p2p 私聊消息；回复到 replyTo.chatId";
+  const scopeHint = isGroup ? `群聊消息；回复到 replyTo.chatId。如需 @发件人，用结构化 at 节点 {"tag":"at","user_id":"<senderId>"}（不要写 <at> 文本标签）` : "p2p 私聊消息；回复到 replyTo.chatId";
   const scopeWord = isGroup ? "群聊" : "p2p 私聊";
   const action = [
     `处理飞书 ${scopeWord}消息并以机器人身份回复${profileWarn}。`,
     `scope: ${scopeHint}。`,
     ``,
-    `## ⭐ 关键 1: 所有飞书回复必须用 --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 默认值处理)`,
-    ``,
-    `## ⭐ 关键 2: @-mention 必须用空闭合标签 <at user_id="ou_xxx"></at>`,
-    `飞书只识别空闭合形式: <at user_id="ou_xxx"></at> (开始标签 + 结束标签, 中间为空)。`,
-    `自闭合形式 <at user_id="ou_xxx"/> 飞书不解析, 用户会看到原始 <at> 标签字面字符,`,
-    `跟 plain text 一样坏掉 — mention 完全失效。`,
+    `## ⭐ 关键 1: 飞书回复必须用结构化 post content（--msg-type post --content）`,
+    `lark-cli 默认把消息当 plain text；而 @mention 只有在**结构化 at 节点**里才会被`,
+    `飞书识别为真实 @。所以回复统一走 post 的 --content JSON：`,
     ``,
-    `正确示例 (群聊 @发件人):`,
-    `  <at user_id="ou_1759934f98e0677e17f09591389c24f1"></at> 这里写正文内容`,
+    `  {"zh_cn":{"content":[`,
+    `    [ {"tag":"at","user_id":"ou_xxx"} ],                            // @某人：结构化节点（可多个/多段）`,
+    `    [ {"tag":"md","text":"正文 Markdown（标题/表格/加粗都支持）"} ]  // 正文：单个 md 节点`,
+    `  ]}}`,
     ``,
-    `**严禁**: 自闭合形式 <at user_id="ou_xxx"/>`,
-    `**严禁**: 反引号/HTML entity 转义 (&lt;at&gt; / <at>)`,
-    `**严禁**: 不用 <at> 直接 @userId 字符串 (飞书当成普通文本)`,
+    `- @mention：用 {"tag":"at","user_id":"ou_xxx"}（user_id 填对方 open_id；@所有人填 "all"）`,
+    `- 正文：全部放进 {"tag":"md","text":"..."} 这一个节点里`,
+    `- 不需要 @ 时，content 里只放 md 节点：{"zh_cn":{"content":[[{"tag":"md","text":"..."}]]}}`,
+    `**严禁**: 用 --text（plain text，Markdown 全部失效）`,
+    `          用 --markdown（无法携带结构化 at 节点，@ 会退化成普通文本）`,
+    `          在正文里写 <at user_id="ou_xxx"/> 或 <at user_id="ou_xxx"></at> 文本标签`,
+    `          （飞书不识别文本标签，只认结构化 at 节点；写文本标签会显示成原始字符）`,
     ``,
-    `## 安全传 Markdown（必读，避免飞书收到字面 $ 和字面反斜杠+n）`,
-    `多行 / 复杂 Markdown 必须先写入临时 .md 文件，再 cat 出来当 --markdown 的值。`,
-    `原因：agent 工具调用层不做 shell 展开。`,
+    `## 关键 2: 安全构造 content（照抄，避免 JSON 转义地狱）`,
+    `把 Markdown 正文写进临时文件，再用 jq 组装（jq 会自动把换行转义为反斜杠+n）：`,
     ``,
-    `推荐调用模板（4 步缺一不可，照抄）:`,
-    `  reply_file="$(mktemp /tmp/lark-reply.XXXXXX.md)"   # 1. 唯一文件名（避免并发覆盖）`,
-    `  trap 'rm -f "$reply_file"' EXIT                   # 2. 注册退出清理（无论成败都删，避免 /tmp 累积）`,
-    `  cat > "$reply_file" <<'LARK_REPLY_EOF'            # 3. 写入 Markdown（heredoc 单引号防 shell 展开）`,
-    `  ...（这里是回复的 Markdown 内容，可以多行 / 含特殊字符）`,
+    `  body_file="$(mktemp /tmp/lark-reply.XXXXXX.md)"`,
+    `  trap 'rm -f "$body_file"' EXIT`,
+    `  cat > "$body_file" <<'LARK_REPLY_EOF'`,
+    `  ...（回复的 Markdown 正文，可多行 / 含表格 / 含特殊字符；不要写 <at> 标签）`,
     `  LARK_REPLY_EOF`,
-    `  lark-cli ${profileFlag}im +messages-reply --message-id <取自 replyTo.messageId> --as bot --markdown "$(cat "$reply_file")"   # 4. 真正调用 (注意 --markdown flag, 不要用 --text)`,
+    `  content="$(jq -nc --rawfile md "$body_file" --arg uid "<senderId>" '{zh_cn:{content:[[{tag:"at",user_id:$uid}],[{tag:"md",text:$md}]]}}')"`,
+    `  lark-cli ${profileFlag}im +messages-reply --message-id <取自 replyTo.messageId> --as bot --msg-type post --content "$content"`,
     ``,
-    `## 禁止（用 words 描述，避免被 LLM 当字面 trap 抄）`,
-    `- 禁止把多行 Markdown 直接拼进 --markdown 参数`,
-    `- 禁止 bash ANSI-C 引号语法（特征：dollar 符号紧跟单引号的引号形式）`,
+    `不需要 @ 某人时，把 jq 表达式换成 '{zh_cn:{content:[[{tag:"md",text:$md}]]}}'。`,
+    ``,
+    `## 禁止`,
+    `- 禁止 --text / --msg-type text（plain text，Markdown 全部失效）`,
+    `- 禁止 --markdown（无法携带结构化 at 节点）`,
+    `- 禁止在正文里写 <at user_id=".."/> 或 <at user_id=".."></at> 文本标签`,
+    `- 禁止把多行 Markdown 直接拼进 --content 参数（必须走上面的 jq --rawfile）`,
     `- 禁止字面反斜杠+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 稳）`,
+    `- 禁止 bash ANSI-C 引号语法（dollar 符号紧跟单引号）`,
     ``,
     `## 必须使用 replyTo 里给定的值`,
     `profile / chatId / messageId / --as bot 必须原样取自 recommendedAction.replyTo；不要凭印象自己拼接。`
@@ -1154,6 +1151,7 @@ class LarkCliInstance {
   registerPluginHooks(plugin) {
     const pluginName = plugin.name || "unknown";
     this.injectTaskUpdater(plugin);
+    this.injectSessionComponent(plugin);
     if (typeof plugin.init === "function") {
       const pluginEnv = {
         getComponent: () => null,
@@ -1239,6 +1237,48 @@ class LarkCliInstance {
     };
     plugin.setTaskUpdater(taskUpdater);
   }
+  injectSessionComponent(plugin) {
+    if (typeof plugin.setSessionComponent !== "function") {
+      return;
+    }
+    if (typeof plugin.hasSessionComponent === "function" && plugin.hasSessionComponent()) {
+      return;
+    }
+    if (!this.environment?.getComponent) {
+      if (isPluginDebugEnabled()) {
+        console.debug(`[LarkCliInstance] ${plugin.name || "plugin"} has setSessionComponent but ` + `environment not injected (setEnvironment not called). ` + `chat↔task 绑定将不会写入。`);
+      }
+      return;
+    }
+    const sessionComponent = this.environment.getComponent("session");
+    if (!sessionComponent?.upsertChatTaskBinding) {
+      if (isPluginDebugEnabled()) {
+        console.debug(`[LarkCliInstance] ${plugin.name || "plugin"} has setSessionComponent but ` + `sessionComponent or upsertChatTaskBinding not found via env.getComponent('session'). ` + `chat↔task 绑定将不会写入。`);
+      }
+      return;
+    }
+    plugin.setSessionComponent(sessionComponent);
+    if (isPluginDebugEnabled()) {
+      console.debug(`[LarkCliInstance] SessionComponent injected for plugin ${plugin.name || "unknown"} ` + `(sourceId=${this.config.id})`);
+    }
+  }
+  async resolveChatTaskBinding(chatId) {
+    if (!chatId)
+      return null;
+    const sessionComponent = this.environment?.getComponent?.("session");
+    if (!sessionComponent?.getChatTaskBinding)
+      return null;
+    try {
+      const binding = await sessionComponent.getChatTaskBinding(chatId);
+      if (binding && binding.status === "ready" && typeof binding.taskId === "number" && binding.taskId > 0) {
+        return binding.taskId;
+      }
+      return null;
+    } catch (err) {
+      logger.warn(`[LarkCliInstance] resolveChatTaskBinding failed for chatId=${chatId}: ${err}. ` + `群消息将不会注入 parentTaskId。`);
+      return null;
+    }
+  }
   unloadPlugins() {
     for (const plugin of this.loadedPlugins) {
       for (const hook of plugin.hooks) {
@@ -1258,7 +1298,7 @@ class LarkCliInstance {
       }
     }
   }
-  handleEvent(rawData) {
+  async handleEvent(rawData) {
     let dedupKey;
     try {
       const parsed = JSON.parse(rawData);
@@ -1325,6 +1365,7 @@ class LarkCliInstance {
         eventSourceId: this.config.id
       };
       const { metadata, replyChannel, recommendedAction } = extractMetadata(enrichedEvent, eventType);
+      const parentTaskId = await this.resolveChatTaskBinding(metadata?.chatId);
       const message = JSON.stringify({
         rawData,
         recommendedAction
@@ -1347,7 +1388,8 @@ class LarkCliInstance {
           plugins,
           pluginEnabled,
           replyChannel,
-          agent
+          agent,
+          parentTaskId: parentTaskId ?? undefined
         },
         payload: {
           sourceId: this.config.id,
@@ -1357,7 +1399,8 @@ class LarkCliInstance {
           metadata,
           replyChannel,
           recommendedAction,
-          timestamp
+          timestamp,
+          parentTaskId: parentTaskId ?? undefined
         }
       };
       const userId = this.extractUserId(rawEvent);

package/dist/shared/@ai-setting/{roy-agent-core-743510fc.js → roy-agent-core-fym6zz5a.js}

@@ -1,9 +1,9 @@
 import {
   init_context
-} from "./roy-agent-core-1kcstbn3.js";
+} from "./roy-agent-core-whta3f53.js";
 import {
   getEnvContext
-} from "./roy-agent-core-jxgprc5a.js";
+} from "./roy-agent-core-n82acszf.js";
 import {
   __esm
 } from "./roy-agent-core-fs0mn2jk.js";

package/dist/shared/@ai-setting/{roy-agent-core-anwh7050.js → roy-agent-core-fytqnxrd.js}

@@ -19,12 +19,12 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-62c1t7wr.js";
+} from "./roy-agent-core-m7dppx2p.js";
 import {
   LLMHookPoints,
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-743510fc.js";
+} from "./roy-agent-core-fym6zz5a.js";
 import {
   TracedAs,
   init_decorator,

package/dist/shared/@ai-setting/{roy-agent-core-62c1t7wr.js → roy-agent-core-m7dppx2p.js}

@@ -1,9 +1,9 @@
 import {
   createHook
-} from "./roy-agent-core-n094tbjh.js";
+} from "./roy-agent-core-w457586k.js";
 import {
   HookManager
-} from "./roy-agent-core-743510fc.js";
+} from "./roy-agent-core-fym6zz5a.js";
 
 // src/env/component.ts
 class BaseComponent {

package/dist/shared/@ai-setting/{roy-agent-core-axh3vn8k.js → roy-agent-core-mdaew65f.js}

@@ -6,7 +6,7 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-62c1t7wr.js";
+} from "./roy-agent-core-m7dppx2p.js";
 import {
   createLogger,
   init_logger

package/dist/shared/@ai-setting/{roy-agent-core-3x6ej9vm.js → roy-agent-core-mwaesrpc.js}

@@ -11,16 +11,16 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-62c1t7wr.js";
+} from "./roy-agent-core-m7dppx2p.js";
 import {
   ToolHookPoints,
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-743510fc.js";
+} from "./roy-agent-core-fym6zz5a.js";
 import {
   getCurrentTaskId,
   init_env_context
-} from "./roy-agent-core-jxgprc5a.js";
+} from "./roy-agent-core-n82acszf.js";
 import {
   TracedAs,
   init_decorator

package/dist/shared/@ai-setting/{roy-agent-core-2adayzfa.js → roy-agent-core-mxwaq8ey.js}

@@ -13,7 +13,7 @@ import {
   createWorkflowSearchTool,
   createWorkflowTagListTool,
   createWorkflowValidateTool
-} from "./roy-agent-core-52yt7e1t.js";
+} from "./roy-agent-core-pxyyrxnn.js";
 import {
   WorkflowService
 } from "./roy-agent-core-j9ejsmsj.js";
@@ -21,10 +21,10 @@ import {
   WorkflowEngine,
   exports_engine,
   init_engine
-} from "./roy-agent-core-63nkhqa4.js";
+} from "./roy-agent-core-x4wev4rn.js";
 import {
   BaseComponent
-} from "./roy-agent-core-62c1t7wr.js";
+} from "./roy-agent-core-m7dppx2p.js";
 import {
   createLogger,
   init_logger
@@ -141,7 +141,7 @@ class WorkflowComponent extends BaseComponent {
     if (!agentRunner && this._workflowEnv) {
       const agentComponent = this._workflowEnv.getComponent("agent");
       if (agentComponent) {
-        const { AgentComponentAdapter } = await import("./roy-agent-core-xgarc0t2.js");
+        const { AgentComponentAdapter } = await import("./roy-agent-core-s53yya0w.js");
         agentRunner = new AgentComponentAdapter(agentComponent, {}, this.sessionComponent);
       }
     }

package/dist/shared/@ai-setting/{roy-agent-core-jxgprc5a.js → roy-agent-core-n82acszf.js}

@@ -141,7 +141,8 @@ function createEnvContext(options) {
     replyChannel,
     pluginEnabled: options.pluginEnabled,
     plugins: options.plugins,
-    timestamp: options.timestamp ?? Date.now()
+    timestamp: options.timestamp ?? Date.now(),
+    parentTaskId: options.parentTaskId
   };
 }
 function mergeEnvContext(partial) {

package/dist/shared/@ai-setting/{roy-agent-core-52yt7e1t.js → roy-agent-core-pxyyrxnn.js}

@@ -1,6 +1,6 @@
 import {
   isValidSessionId
-} from "./roy-agent-core-6thjwx6v.js";
+} from "./roy-agent-core-rx8whb18.js";
 import {
   TAG_MAX_COUNT,
   TAG_MIN_COUNT

package/dist/shared/@ai-setting/{roy-agent-core-hs75rxp3.js → roy-agent-core-q8vew3zh.js}

@@ -9,7 +9,7 @@ import {
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-743510fc.js";
+} from "./roy-agent-core-fym6zz5a.js";
 import {
   TracedAs,
   init_decorator,

package/dist/shared/@ai-setting/{roy-agent-core-zfcwa3w7.js → roy-agent-core-qhtejtpc.js}

@@ -1,7 +1,8 @@
 import {
+  getEnvContextOrEmpty,
   init_env_context,
   setCurrentTaskId
-} from "./roy-agent-core-jxgprc5a.js";
+} from "./roy-agent-core-n82acszf.js";
 import {
   createLogger,
   init_logger
@@ -333,6 +334,25 @@ function createTaskTool(taskComponent) {
         rather than rejected, to preserve backward compatibility. The
         auto-injection of \`created_at\` / \`worktree_path\` is best-effort.
 
+      ## Task Binding Inheritance (Task #4023)
+
+      When this tool is called from inside a per-task group chat, the
+      event-source handler resolves the chat↔task binding and injects the
+      bound task id into \`EnvContext.parentTaskId\`. This tool reads that
+      value and uses it as the default \`parent_task_id\`, so the LLM
+      doesn't need to know the task tree to attach subtasks to the
+      correct parent.
+
+      Priority order (highest → lowest):
+        1. Caller's explicit \`parent_task_id\` (always wins)
+        2. \`EnvContext.parentTaskId\` injected from chat binding
+        3. No parent (creates a root task, as before)
+
+      When the env-injected parent doesn't exist in the DB, the tool
+      fails fast (does not silently create an orphan). When the
+      env-injected value is 0 / negative / non-integer, it's treated as
+      missing — only positive integers are honored.
+
     `,
     parameters: CreateTaskToolSchema,
     execute: async (args, ctx) => {
@@ -340,12 +360,14 @@ function createTaskTool(taskComponent) {
       const sessionId = ctx.session_id || "unknown";
       const detectedWorktree = detectWorktree();
       let enrichedContext = params.context;
+      const envParentTaskId = getEnvContextOrEmpty().parentTaskId;
+      const effectiveParentTaskId = params.parent_task_id !== undefined && params.parent_task_id !== null ? params.parent_task_id : envParentTaskId !== undefined && envParentTaskId !== null && Number.isInteger(envParentTaskId) && envParentTaskId > 0 ? envParentTaskId : undefined;
       let inheritedProjectPath = params.project_path && params.project_path.trim() !== "" ? params.project_path : undefined;
       let inheritedTags = params.tags;
       let inheritedContext;
-      if (params.parent_task_id !== undefined && params.parent_task_id !== null) {
+      if (effectiveParentTaskId !== undefined) {
         try {
-          const parent = await taskComponent.getTask(params.parent_task_id);
+          const parent = await taskComponent.getTask(effectiveParentTaskId);
           if (parent) {
             const inherited = inheritChildContext({
               parent: {
@@ -370,7 +392,7 @@ function createTaskTool(taskComponent) {
             inheritedContext = inherited.context;
           }
         } catch (err) {
-          logger2.debug(`[task_create] failed to pre-load parent #${params.parent_task_id} for context inheritance: ${err instanceof Error ? err.message : String(err)}`);
+          logger2.debug(`[task_create] failed to pre-load parent #${effectiveParentTaskId} for context inheritance: ${err instanceof Error ? err.message : String(err)}`);
         }
       }
       try {
@@ -399,7 +421,7 @@ function createTaskTool(taskComponent) {
       }
       try {
         const task = await taskComponent.createTask({
-          parent_task_id: params.parent_task_id,
+          parent_task_id: effectiveParentTaskId,
           title: params.title,
           description: params.description,
           priority: params.priority,

package/dist/shared/@ai-setting/{roy-agent-core-6thjwx6v.js → roy-agent-core-rx8whb18.js}

@@ -12,7 +12,7 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-62c1t7wr.js";
+} from "./roy-agent-core-m7dppx2p.js";
 import {
   TracedAs,
   init_decorator
@@ -334,6 +334,103 @@ class SessionComponent extends BaseComponent {
     }
     return success ?? false;
   }
+  chatBindingCache = new Map;
+  static CHAT_BINDING_CACHE_TTL_MS = 60000;
+  static CHAT_BINDING_CACHE_MAX = 1000;
+  async upsertChatTaskBinding(opts) {
+    if (!opts.chatId || typeof opts.chatId !== "string") {
+      throw new Error("upsertChatTaskBinding: chatId is required (non-empty string)");
+    }
+    if (typeof opts.taskId !== "number" || !Number.isInteger(opts.taskId) || opts.taskId <= 0) {
+      throw new Error(`upsertChatTaskBinding: taskId must be a positive integer, got ${JSON.stringify(opts.taskId)}`);
+    }
+    const now = new Date().toISOString();
+    const desiredStatus = opts.status ?? "ready";
+    const existing = await this.getChatTaskBinding(opts.chatId);
+    let rebindCount = existing?.rebindCount ?? 0;
+    let resolvedTaskId = opts.taskId;
+    if (existing && existing.taskId !== opts.taskId) {
+      rebindCount += 1;
+      resolvedTaskId = existing.taskId;
+      logger.warn(`[SessionComponent] upsertChatTaskBinding: rebind detected for chatId=${opts.chatId}: ` + `existing taskId=${existing.taskId}, requested taskId=${opts.taskId}; ` + `keeping existing. rebindCount=${rebindCount}`);
+    }
+    const binding = {
+      chatId: opts.chatId,
+      taskId: resolvedTaskId,
+      profile: opts.profile,
+      boundAt: now,
+      status: desiredStatus,
+      errorMessage: opts.errorMessage ?? null,
+      rebindCount
+    };
+    const session = await this.get(opts.chatId);
+    if (session) {
+      const mergedMetadata = {
+        ...session.metadata ?? {},
+        larkChat: binding
+      };
+      await this.update(opts.chatId, { metadata: mergedMetadata });
+    } else {
+      const newMetadata = {
+        larkChat: binding
+      };
+      await this.create({
+        id: opts.chatId,
+        title: `lark-chat:${opts.chatId}`,
+        directory: ".",
+        metadata: newMetadata
+      });
+    }
+    this.chatBindingCache.set(opts.chatId, {
+      binding,
+      cachedAt: Date.now()
+    });
+    this.evictStaleChatBindingCache();
+    logger.info(`[SessionComponent] upsertChatTaskBinding: chatId=${opts.chatId} → taskId=${resolvedTaskId} ` + `status=${binding.status} rebindCount=${rebindCount}`);
+    return binding;
+  }
+  async getChatTaskBinding(chatId) {
+    if (!chatId)
+      return null;
+    const cached = this.chatBindingCache.get(chatId);
+    if (cached) {
+      const age = Date.now() - cached.cachedAt;
+      if (age < SessionComponent.CHAT_BINDING_CACHE_TTL_MS) {
+        return cached.binding;
+      }
+      this.chatBindingCache.delete(chatId);
+    }
+    const session = await this.get(chatId);
+    if (!session) {
+      return null;
+    }
+    const binding = session.metadata?.larkChat;
+    if (!binding || typeof binding !== "object") {
+      return null;
+    }
+    this.chatBindingCache.set(chatId, {
+      binding,
+      cachedAt: Date.now()
+    });
+    this.evictStaleChatBindingCache();
+    return binding;
+  }
+  evictStaleChatBindingCache() {
+    if (this.chatBindingCache.size <= SessionComponent.CHAT_BINDING_CACHE_MAX)
+      return;
+    const now = Date.now();
+    for (const [k, v] of this.chatBindingCache) {
+      if (now - v.cachedAt >= SessionComponent.CHAT_BINDING_CACHE_TTL_MS) {
+        this.chatBindingCache.delete(k);
+      }
+    }
+    while (this.chatBindingCache.size > SessionComponent.CHAT_BINDING_CACHE_MAX) {
+      const firstKey = this.chatBindingCache.keys().next().value;
+      if (!firstKey)
+        break;
+      this.chatBindingCache.delete(firstKey);
+    }
+  }
   getActiveSession() {
     if (!this.activeSessionId)
       return;
@@ -858,6 +955,20 @@ class SessionComponent extends BaseComponent {
     };
   }
 }
+__legacyDecorateClassTS([
+  TracedAs("session.upsertChatTaskBinding", {
+    recordParams: false,
+    recordResult: false,
+    log: true
+  })
+], SessionComponent.prototype, "upsertChatTaskBinding", null);
+__legacyDecorateClassTS([
+  TracedAs("session.getChatTaskBinding", {
+    recordParams: false,
+    recordResult: false,
+    log: false
+  })
+], SessionComponent.prototype, "getChatTaskBinding", null);
 __legacyDecorateClassTS([
   TracedAs("session.generateCompactHint")
 ], SessionComponent.prototype, "generateCompactHint", null);

package/dist/shared/@ai-setting/{roy-agent-core-xgarc0t2.js → roy-agent-core-s53yya0w.js}

@@ -1,12 +1,12 @@
 import {
   AgentComponentAdapter,
   init_agent_component_adapter
-} from "./roy-agent-core-hs75rxp3.js";
+} from "./roy-agent-core-q8vew3zh.js";
 import"./roy-agent-core-1db4vpc6.js";
 import"./roy-agent-core-e25xkv53.js";
-import"./roy-agent-core-743510fc.js";
-import"./roy-agent-core-1kcstbn3.js";
-import"./roy-agent-core-jxgprc5a.js";
+import"./roy-agent-core-fym6zz5a.js";
+import"./roy-agent-core-whta3f53.js";
+import"./roy-agent-core-n82acszf.js";
 import"./roy-agent-core-qhjm0bxm.js";
 import"./roy-agent-core-8seq65bp.js";
 import"./roy-agent-core-jnszp0jq.js";

package/dist/shared/@ai-setting/{roy-agent-core-n094tbjh.js → roy-agent-core-w457586k.js}

@@ -1,7 +1,7 @@
 import {
   init_global_hook_manager,
   init_hook_manager
-} from "./roy-agent-core-743510fc.js";
+} from "./roy-agent-core-fym6zz5a.js";
 
 // src/env/hook/types.ts
 function createHook(meta, fn) {

package/dist/shared/@ai-setting/{roy-agent-core-1kcstbn3.js → roy-agent-core-whta3f53.js}

@@ -1,7 +1,7 @@
 import {
   init_env_context,
   init_env_event
-} from "./roy-agent-core-jxgprc5a.js";
+} from "./roy-agent-core-n82acszf.js";
 import {
   __esm
 } from "./roy-agent-core-fs0mn2jk.js";

package/dist/shared/@ai-setting/{roy-agent-core-63nkhqa4.js → roy-agent-core-x4wev4rn.js}

@@ -7,7 +7,7 @@ import {
 import {
   AgentComponentAdapter,
   init_agent_component_adapter
-} from "./roy-agent-core-hs75rxp3.js";
+} from "./roy-agent-core-q8vew3zh.js";
 import {
   PythonCallNode,
   SkillNode,

package/dist/shared/@ai-setting/{roy-agent-core-h1zamsb9.js → roy-agent-core-zekkw27m.js}

@@ -17,14 +17,14 @@ import {
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-743510fc.js";
+} from "./roy-agent-core-fym6zz5a.js";
 import {
   init_context
-} from "./roy-agent-core-1kcstbn3.js";
+} from "./roy-agent-core-whta3f53.js";
 import {
   getCurrentTaskId,
   getEnvContext
-} from "./roy-agent-core-jxgprc5a.js";
+} from "./roy-agent-core-n82acszf.js";
 import {
   TracedAs,
   init_decorator,

package/package.json

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