@ai-setting/roy-agent-core 1.7.53 → 1.7.56

package/dist/env/task/plugins/lark-cli-task-notify-plugin.d.ts

@@ -23,10 +23,8 @@
  * ```
  */
 import type { Hook, HookContext } from "../../hook/types";
-import type { Task } from "../types";
 import { getEnvContextOrEmpty } from "../../context";
 import { LarkCardPatchNotifier } from "./lark-card-patch-notifier";
-import { type ChatOwnership } from "./card-chat-routing";
 /**
  * 从 EnvContext 提取 lark 专属字段
  *
@@ -82,16 +80,6 @@ export interface TaskNotifyConfig {
      * 不传 → plugin 自己 new 一个（messageId 由 plugin 的 Map 跟踪）。
      */
     cardNotifier?: LarkCardPatchNotifier;
-    /**
-     * ★ Task #4331：是否允许路由决策走"new-group"路径（建专属群）
-     *
-     * 默认 false：触发群是别人的群 + 本 task 无群时，**不**建专属群，退回触发群
-     * 适用：默认行为（用户新要求：默认不建群）
-     *
-     * 设为 true：保留 #4230 老行为（建专属群并改投）
-     * 适用：显式开启（向后兼容）
-     */
-    allowNewGroup?: boolean;
 }
 /**
  * 卡片路由端口（Task #4230 follow-up）
@@ -101,25 +89,16 @@ export interface TaskNotifyConfig {
  */
 export interface CardRoutingPorts {
     /**
-     * 反查「该群是否是某个 task 的专属群」（多重信号）
+     * task 查询（lineage 上溯：无触发群时找本 task / 祖先的专属群兜底）
      *
-     * 实现建议（见 event-source-handlers.ts）：
-     * - session 的 chat↔task 绑定
-     * - task.context.larkPerTaskChatId / *followup_chat_id
-     * - 群名 "Task 3999" / "#3999"（DB 记录的群名，必要时实时查）
+     * ★ Task #4394：`lookupChatOwnership` / `ensureTaskGroupChat` 两个端口已删除
+     *   —— 卡片不再做"触发群是不是别 task 专属群"的判定，也不再自动建群。
+     *   建群改由用户在卡片上点「为这个任务建群」按钮触发（见 lark-card-action-handler.ts）。
      */
-    lookupChatOwnership?: (chatId: string) => Promise<ChatOwnership | undefined>;
-    /** task 查询（lineage 上溯） */
     getTask?: (id: number) => Promise<{
         context?: string;
         parent_task_id?: number | null;
     } | undefined>;
-    /** 为 task 建/取专属群（lineage 无群且触发群是别人的群时用） */
-    ensureTaskGroupChat?: (task: Task) => Promise<{
-        chatId: string;
-        profile?: string;
-        name?: string;
-    } | undefined>;
 }
 export declare class LarkCliTaskNotifyHook implements Hook {
     readonly name: string;
@@ -156,8 +135,8 @@ export declare class LarkCliTaskNotifyHook implements Hook {
      *
      * 根因：`sendCardStart` 里 `ensureTaskGroupChat` 会写 task.context → 同步触发
      * `task:after.update` → 本 hook 重入 `sendCardUpdate`；此时首卡 messageId 还没写进
-     * `cardMessageIds` → 触发 fallback 补一张卡 + 再发一张改投卡片（同一 task 3 张卡、
-     * 触发群 2 张改投卡片）。
+     * `cardMessageIds` → 触发 fallback 补一张重复卡（同一 task 多张卡）。
+     * （Task #4394 已删除"再发一张改投卡片"那条路径，哨兵仍用于防重复补卡。）
      *
      * 修法：进入 `sendCardStart` 前先占位；重入的 update 看到哨兵直接跳过。
      */
@@ -189,16 +168,20 @@ export declare class LarkCliTaskNotifyHook implements Hook {
     /**
      * 解析「卡片该发到哪个群」（Task #4230 follow-up）
      *
-     * 规则见 card-chat-routing.ts：触发群优先，但跳过"别的 task 的专属群"；
-     * 若是别人的群 → 用本 task（或祖先）的专属群；都没有 → 新建一个。
+     * 规则见 card-chat-routing.ts（Task #4394 简化版）：
+     * - **有触发群 → 就用触发群**（无条件，不改投）
+     * - 没有触发群 → 用本 task（或祖先）已有的专属群兜底
+     * - 都没有 → none（caller skip）
+     *
+     * 已经不再"自动建群"——建群由用户在卡片上点按钮触发。
      *
-     * @returns decision + 最终可用的 chatId/profile + 是否需要回补链接卡片
+     * @returns decision（chatId / profile / source / reason）
      */
     private resolveCardTarget;
     /**
      * 收集 task 的 lineage（自己 → 父 → 祖父…，最多 10 层）
      *
-     * 用于：(a) 找最近的专属群；(b) 判断"某个群属于谁"时确认是否在自己 lineage 上。
+     * 用于：无触发群时找最近的专属群兜底（Task #4394：不再用于"是否别人的群"判定）。
      */
     private collectLineage;
     /** 发初始卡片（+ pin）并缓存 messageId */

package/dist/env/task/plugins/per-task-group-chat-plugin.d.ts

@@ -193,10 +193,10 @@ export interface PerTaskGroupConfig {
      * - 用户在卡片顶部点"为这个任务建群"按钮 → 走 ensureGroupChat 按需建群
      * - 适用：减少群聊爆炸 / 集中讨论 / 减少噪音
      *
-     * ★ 与 LarkCliTaskNotifyPlugin.cardRoutingPorts.ensureTaskGroupChat 协同：
-     *   - LarkCliTaskNotifyPlugin 在路由决策 source="new-group" 时也会调 ensureGroupChat
-     *   - 用户本次改造明确要求"默认不建群"，所以 LarkCliTaskNotifyPlugin 的 new-group 路径
-     *     也被改造为 fallback-to-trigger（不调 ensure）
+     * ★ Task #4394：`LarkCliTaskNotifyPlugin.cardRoutingPorts.ensureTaskGroupChat`
+     *   及其 `new-group` / `fallback-to-trigger` 两条 source 已删除 —— 卡片路由
+     *   **不再自动建群**，`ensureGroupChat` 现在只剩一个调用方：用户点卡片上
+     *   「为这个任务建群」按钮（见 lark-card-action-handler.ts）。
      */
     autoCreateGroup?: boolean;
     /**

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

@@ -2,8 +2,8 @@ import {
   SQLiteTaskStore,
   getDefaultDataDir,
   getDefaultTaskDbPath
-} from "../../../shared/@ai-setting/roy-agent-core-qm9jda8p.js";
-import"../../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+} from "../../../shared/@ai-setting/roy-agent-core-3kz6934b.js";
+import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

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

@@ -9,9 +9,9 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-7g03zkkb.js";
-import"../../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+} from "../../../shared/@ai-setting/roy-agent-core-pemxr5n4.js";
+import"../../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
+import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/tool/built-in/index.js

@@ -8,20 +8,20 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../../shared/@ai-setting/roy-agent-core-athdr2m0.js";
+} from "../../../shared/@ai-setting/roy-agent-core-4zy2v3br.js";
 import {
   getUnderstandImageLLMProvider,
   resetUnderstandImageLLMProvider,
   setUnderstandImageLLMProvider,
   understandImageTool
 } from "../../../shared/@ai-setting/roy-agent-core-xwm8zavb.js";
-import"../../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
 import {
   createQueryBackgroundProcessTool,
   queryBackgroundProcessTool
 } from "../../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
 import"../../../shared/@ai-setting/roy-agent-core-tbrn9wdm.js";
-import"../../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+import"../../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
+import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/tool/index.js

@@ -9,14 +9,13 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../shared/@ai-setting/roy-agent-core-athdr2m0.js";
+} from "../../shared/@ai-setting/roy-agent-core-4zy2v3br.js";
 import {
   getUnderstandImageLLMProvider,
   resetUnderstandImageLLMProvider,
   setUnderstandImageLLMProvider,
   understandImageTool
 } from "../../shared/@ai-setting/roy-agent-core-xwm8zavb.js";
-import"../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
 import"../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
 import"../../shared/@ai-setting/roy-agent-core-tbrn9wdm.js";
 import {
@@ -25,16 +24,17 @@ import {
   ToolValidator,
   getMaxOutputSize,
   setToolConfigComponent
-} from "../../shared/@ai-setting/roy-agent-core-fvs48d38.js";
+} from "../../shared/@ai-setting/roy-agent-core-98aa9r0x.js";
 import"../../shared/@ai-setting/roy-agent-core-kzg1jwt8.js";
+import"../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-tdbv7ff4.js";
-import"../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+import"../../shared/@ai-setting/roy-agent-core-40xzbjtm.js";
+import"../../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
+import"../../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
+import"../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
+import"../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
+import"../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/workflow/engine/engine.d.ts

@@ -217,12 +217,61 @@ export declare class WorkflowEngine extends EventEmitter {
      * Main scheduling loop
      */
     private scheduleAndExecute;
+    /**
+     * Dispatch a node without waiting for it to finish (Task #4392 P0-1).
+     *
+     * Registers the node's promise in `sessionState.inFlight` **synchronously**
+     * so the scheduler loop can (a) join it and (b) never mistake "no tracked
+     * work" for "done". The returned promise is intentionally swallowed: node
+     * outcomes propagate through `scheduler.markFailed` and the `node.failed`
+     * event, exactly as they did when the dispatch path awaited them.
+     *
+     * ## Claim guard — why this is not just "call startNode"
+     *
+     * A node can be reachable from **two** dispatch paths:
+     *   1. `scheduleAvailableNodes()` → `scheduler.getReadyNodes()` (DAG readiness)
+     *   2. `processConditionalEdgesAfterCompletion()` → `edgeResult.toStart`
+     *
+     * Under the old serial loop this never mattered: path 2 awaited each target
+     * to completion, so path 1 always found them `completed` already. Once
+     * dispatch became concurrent the two paths race and the *same* node was
+     * executed twice (proven by `engine-parallel-scheduling.test.ts`:
+     * `parallelLimit=2` produced peak concurrency 3 with 4 of 6 leaves run twice).
+     *
+     * `scheduler.running` is the tie-breaker. `startNode` calls
+     * `scheduler.markStarted()` before its first `await`, so the claim is visible
+     * synchronously to the next dispatcher on the same tick — no interleaving
+     * window. Returns `true` only for the caller that actually won the claim.
+     *
+     * ⚠️ The guard deliberately keys off `scheduler.running` and **not** off
+     * `inFlight`, even though both look equivalent. A self-loop back-edge
+     * (`implement → implement`) re-dispatches the node *from inside its own
+     * completion handler*, i.e. while its own promise is still in `inFlight` but
+     * after `resetNodeForReEntry()` cleared `running`. Guarding on `inFlight`
+     * deadlocks exactly that case: the node waits for itself forever.
+     */
+    private dispatchNode;
     /**
      * Wait for next node event
      *
      * Optimization: When there are running nodes, use pure event-driven waiting
      * (no polling). When there are only pending nodes (dependencies not yet met),
      * use a small timeout to re-check scheduling conditions.
+     *
+     * Task #4392 P0-1 — two additions that concurrent dispatch makes necessary:
+     *
+     * 1. **`inFlight` also arms the timeout.** `scheduler.running` is cleared by
+     *    `markCompleted` inside `validateAndExecute`, but the node's promise is
+     *    still settling (AFTER_NODE hook, conditional edges, `checkAndFinalize`).
+     *    In that window `hasRunningNodes` is false while real work continues, so
+     *    we must keep a wakeup source armed or the loop could park forever.
+     *
+     * 2. **`node.scheduled` resolves the wait.** Concurrent dispatch publishes
+     *    `node.scheduled` for sibling nodes (and for loop re-entries) *after* this
+     *    waiter subscribed — with `node.completed`/`node.failed` as the only
+     *    trigger, a round whose completion event fired during the synchronous
+     *    dispatch section would leave the loop blocked until the 100ms poll.
+     *    Subscribing to `node.scheduled` closes that lost-wakeup window.
      */
     private waitForNextNodeEvent;
     /**
@@ -368,6 +417,22 @@ export declare class WorkflowEngine extends EventEmitter {
      * Get session metadata
      */
     private getSessionMetadata;
+    /**
+     * Serialized session-metadata read-modify-write (Task #4392 P0-1).
+     *
+     * Every `node.completed` / `node.failed` handler and every terminal-state
+     * transition mutates metadata via `get → spread → update`. That is safe only
+     * if mutations never interleave. Now that nodes are dispatched concurrently,
+     * two completions can both `await get()` the same snapshot and the later
+     * `update()` silently drops the other's `agentSessions` marker.
+     *
+     * `mutate` receives the freshly-read metadata and must return the next
+     * metadata object. Mutations are chained onto `sessionState.sessionMetadataQueue`
+     * so they apply in a strict total order, and the queue never rejects (a
+     * failed mutation is logged and skipped) so one bad update cannot poison
+     * every later write.
+     */
+    private updateSessionMetadata;
     /**
      * Find workflow definition from repository
      */

package/dist/env/workflow/engine/index.js

@@ -5,26 +5,26 @@ import {
   Scheduler,
   WorkflowEngine,
   init_engine
-} from "../../../shared/@ai-setting/roy-agent-core-35s1w7tc.js";
+} from "../../../shared/@ai-setting/roy-agent-core-v2188rnk.js";
 import"../../../shared/@ai-setting/roy-agent-core-6atd905e.js";
-import"../../../shared/@ai-setting/roy-agent-core-6167phd4.js";
-import"../../../shared/@ai-setting/roy-agent-core-x8n1r7h4.js";
+import"../../../shared/@ai-setting/roy-agent-core-833t16n1.js";
+import"../../../shared/@ai-setting/roy-agent-core-n3b7ztms.js";
 import"../../../shared/@ai-setting/roy-agent-core-1db4vpc6.js";
 import"../../../shared/@ai-setting/roy-agent-core-ze068vc9.js";
-import"../../../shared/@ai-setting/roy-agent-core-fs36xgcs.js";
-import"../../../shared/@ai-setting/roy-agent-core-9csa89jx.js";
-import"../../../shared/@ai-setting/roy-agent-core-tjg71zqp.js";
+import"../../../shared/@ai-setting/roy-agent-core-3dkzqqsd.js";
+import"../../../shared/@ai-setting/roy-agent-core-r9qe0ghe.js";
+import"../../../shared/@ai-setting/roy-agent-core-3mc6vmvj.js";
 import"../../../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
 import {
   DAGManager
-} from "../../../shared/@ai-setting/roy-agent-core-8s9jd2qy.js";
+} from "../../../shared/@ai-setting/roy-agent-core-nra8vfrs.js";
 import"../../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
 import"../../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+import"../../../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
+import"../../../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
+import"../../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
+import"../../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
+import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/workflow/hooks/index.js

@@ -1,17 +1,17 @@
 import {
   init_hooks
-} from "../../../shared/@ai-setting/roy-agent-core-fs36xgcs.js";
+} from "../../../shared/@ai-setting/roy-agent-core-3dkzqqsd.js";
 import {
   WorkflowHookPoints,
   emitWorkflowNodeHook,
   emitWorkflowRunHook,
   getRegisteredWorkflowHookPoints
-} from "../../../shared/@ai-setting/roy-agent-core-9csa89jx.js";
-import"../../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+} from "../../../shared/@ai-setting/roy-agent-core-r9qe0ghe.js";
+import"../../../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
+import"../../../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
+import"../../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
+import"../../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
+import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/workflow/index.js

@@ -1,7 +1,7 @@
 import {
   WorkflowComponent
-} from "../../shared/@ai-setting/roy-agent-core-4vpk40ss.js";
-import"../../shared/@ai-setting/roy-agent-core-vrsxhw9e.js";
+} from "../../shared/@ai-setting/roy-agent-core-nhk0dsxr.js";
+import"../../shared/@ai-setting/roy-agent-core-e677am8e.js";
 import {
   Edge,
   NodeAs,
@@ -14,24 +14,24 @@ import {
   DecoratorNode,
   init_decorator_node
 } from "../../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
-import"../../shared/@ai-setting/roy-agent-core-vvxb9522.js";
-import"../../shared/@ai-setting/roy-agent-core-yd21n6c7.js";
-import"../../shared/@ai-setting/roy-agent-core-h93v6p6y.js";
+import"../../shared/@ai-setting/roy-agent-core-0bmk44ye.js";
+import"../../shared/@ai-setting/roy-agent-core-bwzy00t2.js";
+import"../../shared/@ai-setting/roy-agent-core-tc7gw38m.js";
 import"../../shared/@ai-setting/roy-agent-core-hhrg314p.js";
-import"../../shared/@ai-setting/roy-agent-core-7evvpfwc.js";
-import"../../shared/@ai-setting/roy-agent-core-35s1w7tc.js";
+import"../../shared/@ai-setting/roy-agent-core-5rxs0ra3.js";
+import"../../shared/@ai-setting/roy-agent-core-v2188rnk.js";
 import"../../shared/@ai-setting/roy-agent-core-6atd905e.js";
-import"../../shared/@ai-setting/roy-agent-core-6167phd4.js";
-import"../../shared/@ai-setting/roy-agent-core-x8n1r7h4.js";
+import"../../shared/@ai-setting/roy-agent-core-833t16n1.js";
+import"../../shared/@ai-setting/roy-agent-core-n3b7ztms.js";
 import"../../shared/@ai-setting/roy-agent-core-1db4vpc6.js";
 import"../../shared/@ai-setting/roy-agent-core-ze068vc9.js";
-import"../../shared/@ai-setting/roy-agent-core-fs36xgcs.js";
-import"../../shared/@ai-setting/roy-agent-core-9csa89jx.js";
+import"../../shared/@ai-setting/roy-agent-core-3dkzqqsd.js";
+import"../../shared/@ai-setting/roy-agent-core-r9qe0ghe.js";
 import"../../shared/@ai-setting/roy-agent-core-7exqwax1.js";
-import"../../shared/@ai-setting/roy-agent-core-na73mym1.js";
-import"../../shared/@ai-setting/roy-agent-core-tjg71zqp.js";
+import"../../shared/@ai-setting/roy-agent-core-202v00x4.js";
+import"../../shared/@ai-setting/roy-agent-core-3mc6vmvj.js";
 import"../../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
-import"../../shared/@ai-setting/roy-agent-core-8s9jd2qy.js";
+import"../../shared/@ai-setting/roy-agent-core-nra8vfrs.js";
 import {
   BaseEventSchema,
   ControlPauseEventSchema,
@@ -85,8 +85,9 @@ import {
   unresolvedVariable
 } from "../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
 import"../../shared/@ai-setting/roy-agent-core-rvxg1wps.js";
-import"../../shared/@ai-setting/roy-agent-core-pk1b3kvf.js";
-import"../../shared/@ai-setting/roy-agent-core-zy3hqfwg.js";
+import"../../shared/@ai-setting/roy-agent-core-ns3pbyz4.js";
+import"../../shared/@ai-setting/roy-agent-core-yv9x4wmg.js";
+import"../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import {
   AskUserError,
@@ -94,12 +95,12 @@ import {
   createWorkflowAskUserEvent
 } from "../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-tdbv7ff4.js";
-import"../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+import"../../shared/@ai-setting/roy-agent-core-40xzbjtm.js";
+import"../../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
+import"../../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
+import"../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
+import"../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
+import"../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/workflow/nodes/index.js

@@ -7,8 +7,8 @@ import {
   init_skill_node,
   init_tool_node,
   init_workflow_node
-} from "../../../shared/@ai-setting/roy-agent-core-x8n1r7h4.js";
-import"../../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+} from "../../../shared/@ai-setting/roy-agent-core-n3b7ztms.js";
+import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/workflow/nodes/tool-node.d.ts

@@ -52,6 +52,12 @@ export declare class ToolNode implements Node {
      *   - value is not an object
      *   - success === true (or success field is missing)
      *   - wrapper has no error string
+     *
+     * Task #4392 P0-2: when the wrapper signals a non-zero `exit_code` but carries
+     * no stderr, the bare `Tool exited with code N` message is useless on its own
+     * (#4385 measured 27 such `exit 2` occurrences in the creator sessions, and
+     * 291 failed runs whose `session.metadata.error` was null). We therefore append
+     * the (redacted, single-line, truncated) command plus a stdout tail.
      */
     private extractErrorFromWrapper;
 }

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

@@ -1,14 +1,14 @@
 import {
   LarkCliWorkflowNotifyHook,
   createLarkCliWorkflowNotifyHook
-} from "../../../shared/@ai-setting/roy-agent-core-brwzs8wf.js";
-import"../../../shared/@ai-setting/roy-agent-core-j8e92gj8.js";
-import"../../../shared/@ai-setting/roy-agent-core-9csa89jx.js";
-import"../../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+} from "../../../shared/@ai-setting/roy-agent-core-xcq04fq0.js";
+import"../../../shared/@ai-setting/roy-agent-core-nntphgww.js";
+import"../../../shared/@ai-setting/roy-agent-core-r9qe0ghe.js";
+import"../../../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
+import"../../../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
+import"../../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
+import"../../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
+import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/workflow/service/index.js

@@ -5,9 +5,9 @@ import {
 } from "../../../shared/@ai-setting/roy-agent-core-hhrg314p.js";
 import {
   WorkflowService
-} from "../../../shared/@ai-setting/roy-agent-core-7evvpfwc.js";
+} from "../../../shared/@ai-setting/roy-agent-core-5rxs0ra3.js";
 import"../../../shared/@ai-setting/roy-agent-core-7exqwax1.js";
-import"../../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/workflow/storage/index.js

@@ -8,12 +8,12 @@ import {
   migrateEmptyTagsToDefault,
   resetDatabase,
   rowToWorkflow
-} from "../../../shared/@ai-setting/roy-agent-core-978b6wfx.js";
+} from "../../../shared/@ai-setting/roy-agent-core-5psjwd08.js";
 import {
   TagRepository
-} from "../../../shared/@ai-setting/roy-agent-core-nde5gzta.js";
+} from "../../../shared/@ai-setting/roy-agent-core-m8n0dffe.js";
 import"../../../shared/@ai-setting/roy-agent-core-rvxg1wps.js";
-import"../../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/workflow/tools/index.js

@@ -24,10 +24,10 @@ import {
   getRunWorkflowTool,
   initRunWorkflowTool,
   resetRunWorkflowTool
-} from "../../../shared/@ai-setting/roy-agent-core-vvxb9522.js";
-import"../../../shared/@ai-setting/roy-agent-core-yd21n6c7.js";
-import"../../../shared/@ai-setting/roy-agent-core-h93v6p6y.js";
-import"../../../shared/@ai-setting/roy-agent-core-7evvpfwc.js";
+} from "../../../shared/@ai-setting/roy-agent-core-0bmk44ye.js";
+import"../../../shared/@ai-setting/roy-agent-core-bwzy00t2.js";
+import"../../../shared/@ai-setting/roy-agent-core-tc7gw38m.js";
+import"../../../shared/@ai-setting/roy-agent-core-5rxs0ra3.js";
 import {
   WORKFLOW_SUBMIT_OUTPUT_TOOL_NAME,
   WorkflowJsonOutputMarker,
@@ -37,21 +37,22 @@ import {
 } from "../../../shared/@ai-setting/roy-agent-core-1db4vpc6.js";
 import"../../../shared/@ai-setting/roy-agent-core-ze068vc9.js";
 import"../../../shared/@ai-setting/roy-agent-core-7exqwax1.js";
-import"../../../shared/@ai-setting/roy-agent-core-na73mym1.js";
-import"../../../shared/@ai-setting/roy-agent-core-8s9jd2qy.js";
+import"../../../shared/@ai-setting/roy-agent-core-202v00x4.js";
+import"../../../shared/@ai-setting/roy-agent-core-nra8vfrs.js";
 import"../../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
 import"../../../shared/@ai-setting/roy-agent-core-rvxg1wps.js";
-import"../../../shared/@ai-setting/roy-agent-core-pk1b3kvf.js";
-import"../../../shared/@ai-setting/roy-agent-core-zy3hqfwg.js";
+import"../../../shared/@ai-setting/roy-agent-core-ns3pbyz4.js";
+import"../../../shared/@ai-setting/roy-agent-core-yv9x4wmg.js";
+import"../../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
 import"../../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import"../../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../../shared/@ai-setting/roy-agent-core-tdbv7ff4.js";
-import"../../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+import"../../../shared/@ai-setting/roy-agent-core-40xzbjtm.js";
+import"../../../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
+import"../../../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
+import"../../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
+import"../../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
+import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
 import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/workflow/tools/workflow-validate-tool.d.ts

@@ -34,18 +34,27 @@ import type { WorkflowService } from "../service/workflow-service";
 /**
  * Input schema for workflow_validate tool.
  *
- * Accepts either `yaml` (string) or `definition` (object) — same flexibility
- * as workflow_add, for symmetric API design.
+ * Accepts `file` (path), `yaml`/`definition_yaml` (string) or `definition`
+ * (object). Precedence: `definition` > `file` > `yaml` / `definition_yaml`.
+ *
+ * Task #4392 P0-4: `file` was added because the tool performs **no shell
+ * expansion**, yet LLMs kept passing `yaml: "$(cat /tmp/x.yaml)"`. That string
+ * is literal, YAML.parse returns a *string*, and the tool replied
+ * `Parsed definition is not an object` — 30 of the 31 measured validate
+ * failures in #4385 §2 C2.
  */
 export declare const WorkflowValidateInputSchema: z.ZodObject<{
     definition: z.ZodOptional<z.ZodAny>;
     definition_yaml: z.ZodOptional<z.ZodString>;
     yaml: z.ZodOptional<z.ZodString>;
+    file: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    file?: string | undefined;
     definition?: any;
     definition_yaml?: string | undefined;
     yaml?: string | undefined;
 }, {
+    file?: string | undefined;
     definition?: any;
     definition_yaml?: string | undefined;
     yaml?: string | undefined;

package/dist/env/workflow/types/run.d.ts

@@ -186,6 +186,25 @@ export interface NodeExecutionContext {
     askUser(query: string): never;
     /** Patch agent sub-session id onto latest workflow.node.start (agent nodes) */
     attachAgentSessionToLastStart?(nodeId: string, agentSessionId: string): Promise<void>;
+    /**
+     * Register (or refresh) an agent sub-session entry in the parent workflow
+     * session's `metadata.agentSessions` (Task #4412 C1).
+     *
+     * AgentNode must use this instead of doing its own
+     * `get → push → update` on the parent metadata. That read-modify-write is
+     * unsafe once dispatch is concurrent: N sibling agent nodes all read the
+     * same parent snapshot and each writes back its own array-with-one-extra
+     * entry, so the last writer wins and every sibling's marker is silently
+     * dropped (measured: 4 concurrent agents → only 2 markers survive).
+     *
+     * The engine implements this by routing the mutation through the same
+     * per-session serialization queue it uses for its own metadata writes, so
+     * the whole class of lost updates is closed by construction.
+     *
+     * Optional for backward compatibility with hand-built contexts in tests;
+     * AgentNode falls back to the legacy inline RMW when it is absent.
+     */
+    registerAgentSubSession?(nodeId: string, agentSessionId: string): Promise<void>;
     /**
      * Abort signal for this node's execution (Task #1976).
      *