@ai-setting/roy-agent-core 1.6.19 → 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-8wd5awxg.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-btp589bw.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-4djnmd86.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-m0wy7p0q.js";
+} from "../shared/@ai-setting/roy-agent-core-b9q2jfx4.js";
 import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-8wd5awxg.js";
+} from "../shared/@ai-setting/roy-agent-core-bwqjwa0d.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,
@@ -17,7 +17,7 @@ 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-btp589bw.js";
+import"../shared/@ai-setting/roy-agent-core-grajzyhd.js";
 import"../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
@@ -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-5kc9qtej.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-mqeqevym.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-4djnmd86.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-5ka95kh7.js";
-import"../../shared/@ai-setting/roy-agent-core-4djnmd86.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-mqeqevym.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-4djnmd86.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-5kc9qtej.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-mqeqevym.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-4djnmd86.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-btp589bw.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-4djnmd86.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/index.js

@@ -1,7 +1,7 @@
 import {
   PromptComponent,
   PromptStore
-} from "./shared/@ai-setting/roy-agent-core-5ka95kh7.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-m0wy7p0q.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-8wd5awxg.js";
+} from "./shared/@ai-setting/roy-agent-core-bwqjwa0d.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -96,7 +96,7 @@ import {
 import {
   TaskTagPlugin,
   createAutoTaskPlugin
-} from "./shared/@ai-setting/roy-agent-core-btp589bw.js";
+} from "./shared/@ai-setting/roy-agent-core-grajzyhd.js";
 import {
   BasePlugin
 } from "./shared/@ai-setting/roy-agent-core-az13yzmc.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-5kc9qtej.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-mqeqevym.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-4djnmd86.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-mqeqevym.js → roy-agent-core-8n3je2r0.js}

@@ -4,13 +4,13 @@ import {
 } from "./roy-agent-core-44g3synv.js";
 import {
   builtInPrompts
-} from "./roy-agent-core-4djnmd86.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-m0wy7p0q.js → roy-agent-core-b9q2jfx4.js}

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

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

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

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

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

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-btp589bw.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-4djnmd86.js";
+} from "./roy-agent-core-skqt40yy.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";

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

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

package/dist/shared/@ai-setting/{roy-agent-core-4djnmd86.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=[]
 )
 \`\`\`
 
@@ -379,13 +402,22 @@ const status = await query_background_process({ bgProcessId: result.bgProcessId
 
 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（标准路径）
 
 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-runner\` 执行**：用下列模板派发
+5. **委托 \`workflow-runner\` 执行**：用下列模板派发（workflow_name 由 default agent 自己查好后填入，或改成"按 search-first 流程自行选定"）
 
 \`\`\`text
 delegate_task(
@@ -394,6 +426,14 @@ delegate_task(
 )
 \`\`\`
 
+**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-runner\` 执行
 > - ✅ 现有 workflow 可以作为参考模板 → 参考其设计自行实现
@@ -1111,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 工具
@@ -1119,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 |
@@ -1136,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.19",
+  "version": "1.6.20",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",