@ai-setting/roy-agent-core 1.6.18 → 1.6.20

package/dist/env/agent/index.js

@@ -2,12 +2,12 @@ import {
   AgentComponent,
   AgentComponentConfigSchema,
   SummaryAgent
-} from "../../shared/@ai-setting/roy-agent-core-qyb2z42s.js";
+} from "../../shared/@ai-setting/roy-agent-core-zeztnvvb.js";
 import"../../shared/@ai-setting/roy-agent-core-8n0e62y4.js";
 import"../../shared/@ai-setting/roy-agent-core-eskgj8nc.js";
 import"../../shared/@ai-setting/roy-agent-core-ataagh3a.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../shared/@ai-setting/roy-agent-core-tycbpm17.js";
+import"../../shared/@ai-setting/roy-agent-core-fntxq0gf.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-ctdhjv68.js";
 import"../../shared/@ai-setting/roy-agent-core-7r72622v.js";

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

@@ -11,7 +11,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-6mz26khm.js";
+} from "../../shared/@ai-setting/roy-agent-core-bwqjwa0d.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -22,13 +22,13 @@ import {
   validateEventSourceConfig
 } from "../../shared/@ai-setting/roy-agent-core-ds5f75pg.js";
 import"../../shared/@ai-setting/roy-agent-core-1qjgwjjs.js";
-import"../../shared/@ai-setting/roy-agent-core-nreqmmtz.js";
+import"../../shared/@ai-setting/roy-agent-core-grajzyhd.js";
 import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../shared/@ai-setting/roy-agent-core-1mrc9a1r.js";
 import"../../shared/@ai-setting/roy-agent-core-bq1gskrf.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-65vpkh7x.js";
+import"../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
 import"../../shared/@ai-setting/roy-agent-core-akb8mb9v.js";

package/dist/env/index.js

@@ -1,11 +1,11 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-vc8e968b.js";
+} from "../shared/@ai-setting/roy-agent-core-b9q2jfx4.js";
 import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-6mz26khm.js";
+} from "../shared/@ai-setting/roy-agent-core-bwqjwa0d.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,
@@ -17,13 +17,13 @@ import"../shared/@ai-setting/roy-agent-core-1qjgwjjs.js";
 import {
   PluginComponent
 } from "../shared/@ai-setting/roy-agent-core-gc75v3px.js";
-import"../shared/@ai-setting/roy-agent-core-nreqmmtz.js";
+import"../shared/@ai-setting/roy-agent-core-grajzyhd.js";
 import"../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "../shared/@ai-setting/roy-agent-core-f6x6ksz3.js";
+} from "../shared/@ai-setting/roy-agent-core-mekk4as5.js";
 import"../shared/@ai-setting/roy-agent-core-77wfej1h.js";
-import"../shared/@ai-setting/roy-agent-core-yr3fp8tv.js";
+import"../shared/@ai-setting/roy-agent-core-f1cjs6c4.js";
 import"../shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"../shared/@ai-setting/roy-agent-core-gmnex23m.js";
 import"../shared/@ai-setting/roy-agent-core-ez91vxas.js";
@@ -41,22 +41,22 @@ import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-qyb2z42s.js";
+} from "../shared/@ai-setting/roy-agent-core-zeztnvvb.js";
 import"../shared/@ai-setting/roy-agent-core-8n0e62y4.js";
 import"../shared/@ai-setting/roy-agent-core-eskgj8nc.js";
 import"../shared/@ai-setting/roy-agent-core-ataagh3a.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-mvmgy9t0.js";
+} from "../shared/@ai-setting/roy-agent-core-rdf8tqj7.js";
 import"../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
 import"../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../shared/@ai-setting/roy-agent-core-n1fx2fx4.js";
+import"../shared/@ai-setting/roy-agent-core-8n3je2r0.js";
 import"../shared/@ai-setting/roy-agent-core-44g3synv.js";
 import"../shared/@ai-setting/roy-agent-core-zdzkzx5g.js";
-import"../shared/@ai-setting/roy-agent-core-65vpkh7x.js";
+import"../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../shared/@ai-setting/roy-agent-core-tycbpm17.js";
+import"../shared/@ai-setting/roy-agent-core-fntxq0gf.js";
 import {
   XDG_PATHS,
   getXDGPath,

package/dist/env/prompt/index.js

@@ -3,8 +3,8 @@ import {
   PromptConfigSchema,
   PromptPathSchema,
   PromptRenderer
-} from "../../shared/@ai-setting/roy-agent-core-h07kk80k.js";
-import"../../shared/@ai-setting/roy-agent-core-65vpkh7x.js";
+} from "../../shared/@ai-setting/roy-agent-core-ett06sn8.js";
+import"../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
 import"../../shared/@ai-setting/roy-agent-core-akb8mb9v.js";

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

@@ -3,11 +3,11 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-n1fx2fx4.js";
+} from "../../../shared/@ai-setting/roy-agent-core-8n3je2r0.js";
 import"../../../shared/@ai-setting/roy-agent-core-44g3synv.js";
-import"../../../shared/@ai-setting/roy-agent-core-65vpkh7x.js";
+import"../../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../../../shared/@ai-setting/roy-agent-core-tycbpm17.js";
+import"../../../shared/@ai-setting/roy-agent-core-fntxq0gf.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-vc7p80sd.js";

package/dist/env/task/index.js

@@ -5,20 +5,20 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-mvmgy9t0.js";
+} from "../../shared/@ai-setting/roy-agent-core-rdf8tqj7.js";
 import"../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-n1fx2fx4.js";
+import"../../shared/@ai-setting/roy-agent-core-8n3je2r0.js";
 import"../../shared/@ai-setting/roy-agent-core-44g3synv.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
 } from "../../shared/@ai-setting/roy-agent-core-zdzkzx5g.js";
-import"../../shared/@ai-setting/roy-agent-core-65vpkh7x.js";
+import"../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../../shared/@ai-setting/roy-agent-core-tycbpm17.js";
+import"../../shared/@ai-setting/roy-agent-core-fntxq0gf.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-c7e3htaq.js";
 import"../../shared/@ai-setting/roy-agent-core-rn57psp0.js";

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

@@ -8,13 +8,13 @@ import {
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-nreqmmtz.js";
+} from "../../../shared/@ai-setting/roy-agent-core-grajzyhd.js";
 import"../../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../../shared/@ai-setting/roy-agent-core-1mrc9a1r.js";
 import"../../../shared/@ai-setting/roy-agent-core-bq1gskrf.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-65vpkh7x.js";
+import"../../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-sqt96sam.js";
 import"../../../shared/@ai-setting/roy-agent-core-dtkbj8fk.js";

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

@@ -5,7 +5,7 @@ import {
   Scheduler,
   WorkflowEngine,
   init_engine
-} from "../../../shared/@ai-setting/roy-agent-core-yr3fp8tv.js";
+} from "../../../shared/@ai-setting/roy-agent-core-f1cjs6c4.js";
 import"../../../shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"../../../shared/@ai-setting/roy-agent-core-gmnex23m.js";
 import"../../../shared/@ai-setting/roy-agent-core-ez91vxas.js";

package/dist/env/workflow/index.js

@@ -1,8 +1,8 @@
 import {
   WorkflowComponent
-} from "../../shared/@ai-setting/roy-agent-core-f6x6ksz3.js";
+} from "../../shared/@ai-setting/roy-agent-core-mekk4as5.js";
 import"../../shared/@ai-setting/roy-agent-core-77wfej1h.js";
-import"../../shared/@ai-setting/roy-agent-core-yr3fp8tv.js";
+import"../../shared/@ai-setting/roy-agent-core-f1cjs6c4.js";
 import"../../shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"../../shared/@ai-setting/roy-agent-core-gmnex23m.js";
 import"../../shared/@ai-setting/roy-agent-core-ez91vxas.js";

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   PromptComponent,
   PromptStore
-} from "./shared/@ai-setting/roy-agent-core-h07kk80k.js";
+} from "./shared/@ai-setting/roy-agent-core-ett06sn8.js";
 import {
   LLMComponent,
   LLMConfigSchema,
@@ -63,7 +63,7 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-vc8e968b.js";
+} from "./shared/@ai-setting/roy-agent-core-b9q2jfx4.js";
 import {
   BountyIMInstance,
   EventSourceComponent,
@@ -76,7 +76,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "./shared/@ai-setting/roy-agent-core-6mz26khm.js";
+} from "./shared/@ai-setting/roy-agent-core-bwqjwa0d.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -96,18 +96,18 @@ import {
 import {
   TaskTagPlugin,
   createAutoTaskPlugin
-} from "./shared/@ai-setting/roy-agent-core-nreqmmtz.js";
+} from "./shared/@ai-setting/roy-agent-core-grajzyhd.js";
 import {
   BasePlugin
 } from "./shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "./shared/@ai-setting/roy-agent-core-f6x6ksz3.js";
+} from "./shared/@ai-setting/roy-agent-core-mekk4as5.js";
 import {
   init_node_registry_helper,
   registerDecoratorNodeType
 } from "./shared/@ai-setting/roy-agent-core-77wfej1h.js";
-import"./shared/@ai-setting/roy-agent-core-yr3fp8tv.js";
+import"./shared/@ai-setting/roy-agent-core-f1cjs6c4.js";
 import"./shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"./shared/@ai-setting/roy-agent-core-gmnex23m.js";
 import"./shared/@ai-setting/roy-agent-core-ez91vxas.js";
@@ -131,7 +131,7 @@ import"./shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-qyb2z42s.js";
+} from "./shared/@ai-setting/roy-agent-core-zeztnvvb.js";
 import {
   createInvokeConfig,
   invoke,
@@ -150,10 +150,10 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-mvmgy9t0.js";
+} from "./shared/@ai-setting/roy-agent-core-rdf8tqj7.js";
 import"./shared/@ai-setting/roy-agent-core-amkqnyzy.js";
 import"./shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"./shared/@ai-setting/roy-agent-core-n1fx2fx4.js";
+import"./shared/@ai-setting/roy-agent-core-8n3je2r0.js";
 import"./shared/@ai-setting/roy-agent-core-44g3synv.js";
 import {
   SQLiteTaskStore,
@@ -162,11 +162,11 @@ import {
 import {
   getBuiltInPrompt,
   getBuiltInPromptNames
-} from "./shared/@ai-setting/roy-agent-core-65vpkh7x.js";
+} from "./shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"./shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import {
   AgentRegistry
-} from "./shared/@ai-setting/roy-agent-core-tycbpm17.js";
+} from "./shared/@ai-setting/roy-agent-core-fntxq0gf.js";
 import {
   XDG_PATHS,
   getXDGPath,

package/dist/shared/@ai-setting/{roy-agent-core-n1fx2fx4.js → roy-agent-core-8n3je2r0.js}

@@ -4,13 +4,13 @@ import {
 } from "./roy-agent-core-44g3synv.js";
 import {
   builtInPrompts
-} from "./roy-agent-core-65vpkh7x.js";
+} from "./roy-agent-core-skqt40yy.js";
 import {
   runWithBgTaskIdAsync
 } from "./roy-agent-core-c1v263jn.js";
 import {
   DEFAULT_SUBAGENT_PROMPT
-} from "./roy-agent-core-tycbpm17.js";
+} from "./roy-agent-core-fntxq0gf.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";

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

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

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

@@ -1,7 +1,7 @@
 import {
   TaskTagPlugin,
   createLarkCliTaskNotifyHook
-} from "./roy-agent-core-nreqmmtz.js";
+} from "./roy-agent-core-grajzyhd.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-7hh0brvs.js";

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

@@ -1,6 +1,6 @@
 import {
   builtInPrompts
-} from "./roy-agent-core-65vpkh7x.js";
+} from "./roy-agent-core-skqt40yy.js";
 import {
   getXDGPath
 } from "./roy-agent-core-qxnbvgwe.js";

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

@@ -2322,7 +2322,7 @@ var init_engine = __esm(() => {
         scheduler.markFailed(nodeId);
       }
     }
-    async checkLoopGuardWithSnapshot(sessionState, templateResolver, reEntryId, _snapshotPreviousOutput) {
+    async checkLoopGuardWithSnapshot(sessionState, templateResolver, reEntryId, snapshotPreviousOutput) {
       const guard = sessionState.dagManager.getLoopGuard(reEntryId);
       if (!guard) {
         return { trip: false, counterKey: "", nextCount: 0 };
@@ -2330,19 +2330,42 @@ var init_engine = __esm(() => {
       const counterKey = `_loop_guard_consecutive_${reEntryId}`;
       const previousCount = sessionState.loopGuardCounters.get(reEntryId) ?? 0;
       const previousValue = templateResolver.resolveValue(guard.previous_signal);
-      const cwd = guard.cwd ?? sessionState.config.workflowInput?.project_path ?? process.cwd();
+      const resolvedCwdRaw = templateResolver.resolveValue(guard.cwd);
+      const resolvedCwd = typeof resolvedCwdRaw === "string" && resolvedCwdRaw.length > 0 ? resolvedCwdRaw : undefined;
+      const resolvedCommandRaw = templateResolver.resolveValue(guard.current_signal_command);
+      const resolvedCommand = typeof resolvedCommandRaw === "string" && resolvedCommandRaw.length > 0 ? resolvedCommandRaw : guard.current_signal_command;
+      const cwd = resolvedCwd ?? sessionState.config.workflowInput?.project_path ?? process.cwd();
       let currentValue;
       try {
-        const { stdout } = await execFileAsync("/bin/sh", ["-c", guard.current_signal_command], {
+        const { stdout } = await execFileAsync("/bin/sh", ["-c", resolvedCommand], {
           cwd,
           timeout: 1e4
         });
         currentValue = stdout.trim();
       } catch (err) {
-        logger3.warn(`[WorkflowEngine] loop_guard command failed for ${reEntryId}: ${err instanceof Error ? err.message : String(err)}. Allowing re-entry.`);
-        return { trip: false, counterKey, nextCount: 0 };
+        const errMessage = err instanceof Error ? err.message : String(err);
+        logger3.error(`[WorkflowEngine] loop_guard command failed for ${reEntryId}: ${errMessage}. Counting as no-progress.`);
+        const nextCount2 = previousCount + 1;
+        const maxAllowed2 = guard.max_consecutive_no_progress;
+        if (nextCount2 >= maxAllowed2) {
+          const failMessage = guard.fail_message ?? `loop_guard command failed for ${reEntryId} after ${nextCount2} consecutive re-entries: ${errMessage}`;
+          return { trip: true, failMessage, counterKey, nextCount: nextCount2 };
+        }
+        sessionState.loopGuardCounters.set(reEntryId, nextCount2);
+        return { trip: false, counterKey, nextCount: nextCount2 };
       }
       if (previousValue === undefined) {
+        const snapshotHasContent = snapshotPreviousOutput !== undefined && snapshotPreviousOutput !== null && typeof snapshotPreviousOutput === "object" && Object.keys(snapshotPreviousOutput).length > 0;
+        if (snapshotHasContent) {
+          const nextCount2 = previousCount + 1;
+          const maxAllowed2 = guard.max_consecutive_no_progress;
+          if (nextCount2 >= maxAllowed2) {
+            const failMessage = guard.fail_message ?? `loop_guard previous_signal path unresolved for ${reEntryId} after ${nextCount2} consecutive re-entries: ${guard.previous_signal}`;
+            return { trip: true, failMessage, counterKey, nextCount: nextCount2 };
+          }
+          sessionState.loopGuardCounters.set(reEntryId, nextCount2);
+          return { trip: false, counterKey, nextCount: nextCount2 };
+        }
         return { trip: false, counterKey, nextCount: 0 };
       }
       const isUnchanged = JSON.stringify(previousValue) === JSON.stringify(currentValue);

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

@@ -165,7 +165,7 @@ class AgentRegistry {
     const agent = {
       name,
       type: "sub",
-      description: "Workflow runner — 负责调用 workflow_run 启动 workflow，支持 session resume 和 stop；失败接管由 prompt 推理触发 (Task #2251 简化版)。",
+      description: "Workflow runner — 接受带 workflow_name（必填）的委托，或指示其按 search-first 流程自行选定（workflow_tag_list + workflow_search + workflow_list + workflow_get），然后通过 workflow_run 执行 workflow；支持 session resume 和 stop；失败接管由 prompt 推理触发 (Task #2251)。**调用方必须在 prompt 中明确指定 workflow 名，或指示 sub-agent 自行搜索选择；禁止盲猜/绕过/跳过 schema 验证** (Task #2486)。",
       systemPromptRef: "workflow-runner",
       deniedTools: ["delegate_task", "stop_task"],
       maxIterations: 30

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

@@ -6,7 +6,7 @@ import {
 } from "./roy-agent-core-1mrc9a1r.js";
 import {
   WORKFLOW_EXTRACT_PROMPT
-} from "./roy-agent-core-65vpkh7x.js";
+} from "./roy-agent-core-skqt40yy.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";

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

@@ -6,7 +6,7 @@ import {
   WorkflowEngine,
   exports_engine,
   init_engine
-} from "./roy-agent-core-yr3fp8tv.js";
+} from "./roy-agent-core-f1cjs6c4.js";
 import {
   askUserTool,
   createRunWorkflowTool,

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

@@ -8,7 +8,7 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "./roy-agent-core-n1fx2fx4.js";
+} from "./roy-agent-core-8n3je2r0.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath

package/dist/shared/@ai-setting/{roy-agent-core-65vpkh7x.js → roy-agent-core-skqt40yy.js}

@@ -110,6 +110,10 @@ var builtInPrompts = {
 
 ## 子智能体选择策略
 
+**核心铁律**：选了某个 subagent 后，必须**遵循该 subagent 的工作模式**——把任务用它的 prompt 模板、工具集和决策路径表达，**不能用自己的方式硬塞**。
+
+> \uD83D\uDCA1 **典型例子**：选 \`workflow-runner\` 时，prompt 必须**明确指定 workflow 名**（让 sub-agent 直接 \`workflow_run\`）**或**让 sub-agent **先 \`workflow_search\` / \`workflow_list\` / \`workflow_get\` 自行选定**——不要让 sub-agent 替你做不属于它的决策（如 \`workflow_creat\`）。
+
 你有多类子智能体。**默认首次委托使用 \`roy\`**。**调用 workflow 解决的任务，委托给 \`workflow-runner\`**（兼容语法：\`strict-task-agent\` / \`code-review\` / \`bench-agent-host\` / \`workspace-analyzer\` / \`test-workflow-agent\` 等旧名仍可用，会被自动重写）。
 
 ### \uD83E\uDD47 首选：\`roy\`（首次委托默认）
@@ -147,15 +151,34 @@ delegate_task(
 - **安全关键型变更** — 验证不可妥协
 - **代码审查/审计** — 需要系统性对照目标进行检查
 
-使用：
+#### 两种合法委托模式（**workflow_name 必传 / search-first 二选一**）
+
+\`workflow-runner\` 的 \`<workflow_name>\` 是它的第一铁律（参见 \`workflow-runner\` prompt 的"## ⚠️ workflow_name 处理规则"）。委托时必须在 prompt 里：
+
+- **模式 A — 传具体 workflow_name**（首选）：你已经知道该跑哪个 workflow，直接在 prompt 中指定名字，sub-agent 直接 \`workflow_get(name)\` → \`workflow_run\`。
+- **模式 B — search-first 兜底**：你只知道任务目标但不确定 workflow 名，指示 sub-agent 自行 \`workflow_tag_list\` + \`workflow_search\` + \`workflow_list\` + \`workflow_get\` 选定再 \`workflow_run\`。
+
+**禁止**：让 sub-agent 猜 workflow_name、绕过 workflow 自己完成任务、或跳过 schema 验证。
+
+#### 模式 A 示例 — 传具体 workflow_name
+
 \`\`\`
 delegate_task(
-  description="简要 3-5 字摘要",
-  prompt="详细说明。
+  description="执行 strict-task-agent workflow",
+  prompt="调用 workflow_run 执行 workflow strict-task-agent，任务是修复 roy-rd-with-trace 中的 X bug。",
+  subagent_type="workflow-runner",
+  similar_task_ids=[]
+)
+\`\`\`
 
-重要：遵循任务作为一等公民原则 — 使用 \`task_create\` 创建任务，使用 \`task_update\` 跟踪进度，使用 \`task_operation_create\` 记录里程碑，并使用 \`task_complete\` 完成任务。",
-  subagent_type="workflow-runner", prompt="运行 workflow strict-task-agent，任务是..."
-  similar_task_ids=[]  // 必填：先使用 task_search 搜索相似任务，将找到的 ID 填入此处（最多 3 个）
+#### 模式 B 示例 — search-first 兜底
+
+\`\`\`
+delegate_task(
+  description="寻找并执行合适的 workflow",
+  prompt="用户目标：批量跑 stock 筛选分析。请按 workflow-runner 的 search-first 流程：先 \`workflow_tag_list\` + \`workflow_search --keyword stock\` + \`workflow_list\` 找到匹配的 workflow，再 \`workflow_get <name>\` 验证 schema，最后 \`workflow_run <name>\` 执行。不要猜测 workflow 名。",
+  subagent_type="workflow-runner",
+  similar_task_ids=[]
 )
 \`\`\`
 
@@ -377,52 +400,84 @@ const status = await query_background_process({ bgProcessId: result.bgProcessId
 
 ## Workflow 操作指南
 
-Workflow 是预定义的自动化流程，可以高效解决常见类型的任务。在接手一个复杂任务时，**建议先用 workflow 检索看看有没有现成的解决方案**。
+Workflow 是预定义的自动化流程，可以高效解决常见类型的任务。**Default agent 自身不应直接 bash 跑 workflow**——所有 workflow 调用必须通过 \`delegate_task\` 委托给 \`workflow-runner\` 子智能体执行。
+
+### ⚠️ 委托时 workflow_name 必传 / search-first 二选一（Task #2486）
+
+\`workflow-runner\` 的 \`<workflow_name>\` 是它的**第一铁律**（详见 \`workflow-runner\` prompt "## ⚠️ workflow_name 处理规则"）。**Default agent 在委托时必须**：
+
+- **指定 workflow 名** — prompt 里明确写出 \`运行 workflow <workflow-name>\`，sub-agent 直接 \`workflow_get(name)\` → \`workflow_run\`。
+- **或指示 sub-agent 自行搜索** — prompt 里说"按 search-first 流程：先 \`workflow_tag_list\` + \`workflow_search\` + \`workflow_list\` + \`workflow_get\` 选定再执行"，让 sub-agent 自决。
+
+**绝对禁止**：让 sub-agent 猜 workflow 名 / 绕过 workflow / 跳过 schema 验证。
+
+### 如何通过 \`delegate_task\` 调用 workflow（标准路径）
 
-### 如何用 workflow 辅助解决任务
 1. **查 tag 发现可用 workflow**：\`workflow tag list\` — 查看 tag 池，找与任务领域匹配的 tag
 2. **按 tag 搜索 workflow**：\`workflow list --tag <tag>\` — 找到相关的 workflow
 3. **按关键词搜索**：\`workflow search --keyword <key>\` — 用关键词匹配
 4. **查看详情**：\`workflow get <name>\` — 了解 workflow 的输入参数和节点流程
-5. **运行 workflow**：\`workflow run <name> --input '{"key":"value"}'\` — 直接执行
+5. **委托 \`workflow-runner\` 执行**：用下列模板派发（workflow_name 由 default agent 自己查好后填入，或改成"按 search-first 流程自行选定"）
+
+\`\`\`text
+delegate_task(
+  subagent_type="workflow-runner",
+  prompt="调用 workflow_run 执行 workflow <workflow-name>，输入参数: {...}"
+)
+\`\`\`
+
+**search-first 替代模板**（当你不确定 workflow 名时）：
+\`\`\`text
+delegate_task(
+  subagent_type="workflow-runner",
+  prompt="按 search-first 流程执行：先 \`workflow_tag_list\` + \`workflow_search --keyword <key>\` + \`workflow_list\` 找到匹配 workflow，再 \`workflow_get <name>\` 验证 schema，最后 \`workflow_run <name>\` 执行。"
+)
+\`\`\`
 
 > \uD83D\uDCA1 **什么时候该用 workflow？**
-> - ✅ 你的任务与现有 workflow 的 tag 或描述高度匹配时 → 优先用 \`workflow run\`
+> - ✅ 你的任务与现有 workflow 的 tag 或描述高度匹配时 → 委托 \`workflow-runner\` 执行
 > - ✅ 现有 workflow 可以作为参考模板 → 参考其设计自行实现
-> - ❌ 找不到匹配的 workflow → **用传统方式解决**（委托子智能体、直接编码等）
+> - ❌ 找不到匹配的 workflow → **用传统方式解决**（委托 \`roy\` / \`general\` / \`explore\` / 直接编码）
+
+### 可用命令速查（仅供 \`workflow-runner\` 子智能体使用，**default agent 不要直接调用**）
 
-### 可用命令速查
 - \`workflow tag list\` — 查看所有 tag
 - \`workflow list --tag <tag>\` — 按 tag 搜索
-- \`workflow search --keyword <key>\` — 按关键词搜索
+- \`workflow search --keyword <keyword>\` — 按关键词搜索
 - \`workflow get <name>\` — 查看详情
-- \`workflow run <name>\` — 执行 workflow（如果已找到匹配的）
-- \`workflow add --file <path> --tags "a,b,c"\` — 添加新 workflow
+- \`workflow add --file <path> --tags "a,b,c"\` — 添加新 workflow（默认 1-3 个 tag）
 - \`workflow validate --file <path>\` — 验证 workflow 定义
 
+> ⚠️ \`workflow run <name>\` 是 workflow-runner 的内部触发命令——**default agent 不要直接 bash 调用**，必须通过 \`delegate_task(subagent_type="workflow-runner", ...)\` 委托子智能体执行。
+
 ### ⚠️ 重要原则
 - **Workflow 是辅助手段，不是目的**。如果能找到现成 workflow 就使用它；如果找不到或效果不好，**用非 workflow 方式解决**也是完全正确的
 - **不要为了用 workflow 而用**，强行创建一个不合适的 workflow 来套用任务不如直接用传统方式解决
-- **委托子智能体时**：如果认为有 workflow 可能帮助子智能体，可以在 prompt 中提示子智能体先查询 tag 池搜索可用 workflow
+- **Default agent 不直接调用 workflow**：所有 workflow 调用必须通过 \`delegate_task(subagent_type="workflow-runner", ...)\` 委托子智能体执行
 
-### ⚡ Session 恢复（重要，耗时 workflow 必备）
+### ⚡ Session 恢复（重要，耗时 workflow 必备 — default agent 视角）
 
-对于耗时较长、易超时的 workflow（如 \`strict-task-agent\`），如遇超时/中断，可使用 \`-s\` 选项从断点继续运行，**避免重头开始**：
+workflow-runner 报告 workflow runId 后，对于耗时较长、易超时的 workflow（如 \`strict-task-agent\`），如遇超时/中断，**default agent 应重新派发 \`delegate_task\` 给 \`workflow-runner\`**，并附带 \`-s\` / \`--session\` 选项让 workflow-runner 从断点继续运行：
 
-    # 初次运行（可能超时）
-    roy-agent workflow run <workflow-name> --input '{"query":"..."}'
-
-    # 拿到 Run ID 后（如 workflow_run_1783407282099_1_ah8pho），从中断处继续：
-    roy-agent workflow run <workflow-name> -s workflow_run_1783407282099_1_ah8pho
+\`\`\`text
+# 初次调用：直接派发 delegate_task（workflow-runner 内部用 workflow_run 启动）
+delegate_task(
+  subagent_type="workflow-runner",
+  prompt="调用 workflow_run 执行 workflow <workflow-name>，输入参数: {...}"
+)
 
-    # 长选项亦可：
-    roy-agent workflow run <workflow-name> --session workflow_run_1783407282099_1_ah8pho
+# 拿到 runId 后（如 workflow_run_1783407282099_1_ah8pho），从中断处继续：
+delegate_task(
+  subagent_type="workflow-runner",
+  prompt="调用 workflow_run 续跑 workflow <workflow-name>，-s workflow_run_1783407282099_1_ah8pho"
+)
+\`\`\`
 
-> **重要规则**（Task #1837 — runId == sessionId）：
+> **关键规则**（Task #1837 — runId == sessionId）：
 > - Run ID / Session ID 形如 \`workflow_\${Date.now()}_\${counter}_\${random}\`，直接以 \`workflow_\` 开头
 > - runId 和 sessionId 是同一个值（不再需要 \`workflow_\${runId}\` 派生）
-> - 引擎会从 last message 推断恢复点（\`workflow.node.start\` → 节点级 resume；\`workflow.node.end\` → 下一节点；\`workflow.node.interrupt\` → ask_user）
-> - agentNode 恢复时会自动 attach \`agentSessionId\`，agent 从中断的 sub-session 继续
+> - 引擎从 last message 推断恢复点（\`workflow.node.start\` → 节点级 resume；\`workflow.node.end\` → 下一节点；\`workflow.node.interrupt\` → ask_user）
+> - agentNode 恢复时自动 attach \`agentSessionId\`，agent 从中断的 sub-session 继续
 > - 适合长时间 workflow（通过 \`workflow-runner\` 调度的任意 workflow）的超时重试
 
 ### {{memory}}`,
@@ -1096,6 +1151,36 @@ When reusing an existing task, you MUST follow these rules:
 
 workflow 名必须从 \`<workflow_name>\` 标签读取，不得根据上下文猜测。
 
+## ⚠️ workflow_name 处理规则（关键 — Task #2486）
+
+**这是 workflow-runner 的第一铁律。** 在调用任何 \`workflow_run\` 之前，**必须**确认 workflow 名是真实、确定的。
+
+### 三种合法情况
+
+| 情况 | 判定 | 第一步动作 |
+|---|---|---|
+| (1) **parent 已传具体 workflow_name** | \`<workflow_name>\` 标签里是非空字符串（如 \`roy-rd-with-trace\`） | 直接走"## 默认 workflow-run 模式" — 调 \`workflow_get(name)\` 确认 schema 后 \`workflow_run\` |
+| (2) **parent 没传 workflow_name**，但 original_prompt / task_description 里**明确指名** | 用户在原任务里说"跑 X workflow" | 用文本中提到的名字当作 workflow_name，调 \`workflow_get(name)\` 验证该 workflow 真实存在；**验证不通过则降级到 (3)** |
+| (3) **parent 没传，文本也没指名** | \`<workflow_name>\` 为空 / 占位符 / 用户只描述目标 | **必须走 search-first 流程**（见下） |
+
+### Search-first 流程（情况 (3) 的强制路径）
+
+当且仅当 workflow_name 真正缺失时，**第一步必须是下列搜索组合**（顺序由你判断，但**至少 2 个工具**）：
+
+1. \`workflow_tag_list\` — 看 tag 池，找与任务领域匹配的 tag
+2. \`workflow_search --keyword <keyword>\` — 用 task_description 的核心动词/名词搜
+3. \`workflow_list\`（或 \`workflow list --tag <tag>\`）— 列候选
+4. \`workflow_get <name>\` — **对每个候选都必须**查看 input schema，确认与 original_prompt 描述的目标匹配
+
+**选定后**，按"## 默认 workflow-run 模式"调 \`workflow_run\`。
+
+### \uD83D\uDEAB 绝对禁止
+
+- ❌ **禁止根据上下文猜测 / 编造 workflow_name** — 必须从 workflow_list / workflow_search / workflow_get 的真实返回里选定
+- ❌ **禁止绕过 workflow 直接调其他工具完成任务** — 你存在的全部意义就是执行 workflow；找不到合适 workflow 时返回明确的"未找到匹配 workflow"错误，让 parent agent 决策（走传统方式 vs 创建新 workflow）
+- ❌ **禁止跳过 schema 验证** — 即使 parent agent 传了 workflow_name，**仍必须**先 \`workflow_get\` 确认 input schema 合法再 \`workflow_run\`
+- ❌ **禁止把 search-first 流程当作可选项** — 情况 (3) 是默认；只有情况 (1)(2) 才能省略
+
 ## 可用工具
 
 ### Workflow 工具
@@ -1104,6 +1189,8 @@ workflow 名必须从 \`<workflow_name>\` 标签读取，不得根据上下文
 |---|---|
 | workflow_get | 读取真实 workflow 定义、输入 schema、节点与依赖 |
 | workflow_list | 列出已注册 workflow |
+| workflow_search | 按关键词搜索 workflow（search-first 流程必用） |
+| workflow_tag_list | 列出 tag 池（search-first 流程必用） |
 | workflow_run | 启动或恢复 workflow |
 | workflow_run_status | 查询原 run_id 的真实状态与节点进度 |
 | workflow_run_stop | 按要求停止 run |
@@ -1121,15 +1208,16 @@ workflow 名必须从 \`<workflow_name>\` 标签读取，不得根据上下文
 
 ## 默认 workflow-run 模式
 
-1. 调 \`workflow_get(name)\`，确认 input schema、节点描述和 DAG 依赖。
-2. 从 original_prompt 提取合法 input。
-3. 没有 existing_sub_session_id 时调用 fresh \`workflow_run\`；有该 ID 时先调
+1. **再次确认 workflow_name 已通过 search-first 流程选定**（参见"## ⚠️ workflow_name 处理规则"）。
+2. 调 \`workflow_get(name)\`，确认 input schema、节点描述和 DAG 依赖。
+3. 从 original_prompt 提取合法 input。
+4. 没有 existing_sub_session_id 时调用 fresh \`workflow_run\`；有该 ID 时先调
    \`workflow_run_status(run_id)\`，再以同一 ID 作为 session 恢复。runId == sessionId。
 
    Copy-paste CLI 示例：
    \`roy-agent workflow run roy-rd-with-trace -s workflow_run_1783407282099_1_ah8pho\`
-4. 对 \`completed\` / \`paused\` 返回真实 output；对 \`running\` / \`stopped\` 按真实状态报告。
-5. 对每次 \`failed\` / \`timeout\`，扫描你自己最近的 workflow_run tool results，推理连续失败次数。
+5. 对 \`completed\` / \`paused\` 返回真实 output；对 \`running\` / \`stopped\` 按真实状态报告。
+6. 对每次 \`failed\` / \`timeout\`，扫描你自己最近的 workflow_run tool results，推理连续失败次数。
 
 ## 连续 2 次失败阈值（由 LLM 自行推理）
 

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

@@ -10,7 +10,7 @@ import {
 } from "./roy-agent-core-e25xkv53.js";
 import {
   AgentRegistry
-} from "./roy-agent-core-tycbpm17.js";
+} from "./roy-agent-core-fntxq0gf.js";
 import {
   ContextError
 } from "./roy-agent-core-ctdhjv68.js";

package/package.json

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