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

package/dist/shared/@ai-setting/{roy-agent-core-tft0pa6h.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),
@@ -1148,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,
@@ -1233,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) {
@@ -1252,7 +1298,7 @@ class LarkCliInstance {
       }
     }
   }
-  handleEvent(rawData) {
+  async handleEvent(rawData) {
     let dedupKey;
     try {
       const parsed = JSON.parse(rawData);
@@ -1319,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
@@ -1341,7 +1388,8 @@ class LarkCliInstance {
           plugins,
           pluginEnabled,
           replyChannel,
-          agent
+          agent,
+          parentTaskId: parentTaskId ?? undefined
         },
         payload: {
           sourceId: this.config.id,
@@ -1351,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.36",
+  "version": "1.7.37",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",