@ai-setting/roy-agent-core 1.5.50 → 1.5.52

package/dist/shared/@ai-setting/roy-agent-core-awmae5ax.js

@@ -0,0 +1,258 @@
+import {
+  WORKFLOW_JSON_OUTPUT_PLUGIN_KEY,
+  init_workflow_json_output_plugin,
+  registerWorkflowJsonOutputPlugin,
+  tracedExtractStructuredJsonViaLlm
+} from "./roy-agent-core-29867p67.js";
+import {
+  AskUserError,
+  init_workflow_hil
+} from "./roy-agent-core-e25xkv53.js";
+import {
+  TracedAs,
+  init_decorator
+} from "./roy-agent-core-q5qj0fes.js";
+import {
+  __esm,
+  __legacyDecorateClassTS
+} from "./roy-agent-core-fs0mn2jk.js";
+
+// src/env/workflow/nodes/agent-component-adapter.ts
+var AgentComponentAdapter;
+var init_agent_component_adapter = __esm(() => {
+  init_workflow_hil();
+  init_workflow_json_output_plugin();
+  init_decorator();
+  AgentComponentAdapter = class AgentComponentAdapter {
+    agentComponent;
+    options;
+    _sessionComponent;
+    _llmComponent;
+    agentSessionPrefix = "agent";
+    _currentAgentSessionId;
+    pendingSessions = new Map;
+    runSessionToAgentSessions = new Map;
+    jsonOutputPluginRegistered = false;
+    constructor(agentComponent, options = {}, _sessionComponent, _llmComponent) {
+      this.agentComponent = agentComponent;
+      this.options = options;
+      this._sessionComponent = _sessionComponent;
+      this._llmComponent = _llmComponent;
+      this.ensureJsonOutputPluginRegistered();
+    }
+    setLLMComponent(llmComponent) {
+      this._llmComponent = llmComponent;
+      this.ensureJsonOutputPluginRegistered();
+    }
+    ensureJsonOutputPluginRegistered() {
+      if (this.jsonOutputPluginRegistered || !this._llmComponent) {
+        return;
+      }
+      registerWorkflowJsonOutputPlugin(this._llmComponent);
+      this.jsonOutputPluginRegistered = true;
+    }
+    setSessionComponent(sessionComponent) {
+      this._sessionComponent = sessionComponent;
+    }
+    getCurrentAgentSessionId() {
+      return this._currentAgentSessionId;
+    }
+    registerAgent(name, config) {
+      this.agentComponent.registerAgent(name, {
+        type: config.type || "general",
+        model: config.model,
+        systemPrompt: config.systemPrompt,
+        maxIterations: config.maxIterations,
+        allowedTools: config.allowedTools,
+        deniedTools: config.deniedTools,
+        timeout: config.timeout,
+        maxErrorRetries: config.maxErrorRetries
+      });
+      if (config.sessionIdPrefix) {
+        this.agentSessionPrefixes.set(name, config.sessionIdPrefix);
+      }
+    }
+    async run(config, resumeOptions) {
+      const startTime = Date.now();
+      const nodeId = config.nodeId || "unknown";
+      const runId = config.runId || "unknown";
+      const workflowSessionId = config.workflowSessionId;
+      const isResume = !!resumeOptions?.userQuery;
+      let agentSessionId = resumeOptions?.agentSessionId || config.agentSessionId || this._currentAgentSessionId;
+      if (!agentSessionId && this._sessionComponent) {
+        agentSessionId = `${this.agentSessionPrefix}_${runId}_${nodeId}_${Date.now()}`;
+        try {
+          await this._sessionComponent.create({
+            title: `Agent Session: ${config.type} (${agentSessionId})`,
+            metadata: {
+              type: "agent",
+              workflowRunId: runId,
+              workflowNodeId: nodeId
+            }
+          });
+        } catch (error) {
+          console.warn(`Failed to create agent session ${agentSessionId}:`, error);
+        }
+      }
+      if (agentSessionId) {
+        this._currentAgentSessionId = agentSessionId;
+        if (workflowSessionId && this._sessionComponent) {
+          const mapping = this.runSessionToAgentSessions.get(workflowSessionId) || [];
+          if (!mapping.includes(agentSessionId)) {
+            mapping.push(agentSessionId);
+            this.runSessionToAgentSessions.set(workflowSessionId, mapping);
+          }
+        }
+        if (isResume) {
+          this.pendingSessions.delete(agentSessionId);
+        } else {
+          this.pendingSessions.set(agentSessionId, {
+            agentSessionId,
+            nodeId,
+            runId,
+            createdAt: Date.now()
+          });
+        }
+      }
+      try {
+        const outputSchema = config.options?.outputSchema;
+        const context = {};
+        if (config.options?.timeout) {
+          context.abort = new AbortController;
+        }
+        if (agentSessionId) {
+          context.sessionId = agentSessionId;
+        }
+        if (config.options?.allowedTools) {
+          context.allowedTools = config.options.allowedTools;
+        }
+        if (config.options?.deniedTools) {
+          context.deniedTools = config.options.deniedTools;
+        }
+        context.metadata = {
+          runId,
+          nodeId,
+          sessionId: agentSessionId,
+          outputSchema
+        };
+        if (outputSchema) {
+          context.pluginEnabled = {
+            ...context.pluginEnabled ?? {},
+            [WORKFLOW_JSON_OUTPUT_PLUGIN_KEY]: true
+          };
+        }
+        if (config.workflowHistory) {
+          context.workflowHistory = config.workflowHistory;
+        }
+        let additionInfo = config.prompt;
+        let userInput = resumeOptions?.userQuery || "";
+        if (agentSessionId && this._sessionComponent && !isResume) {
+          try {
+            const priorMessages = await this._sessionComponent.getMessages(agentSessionId);
+            const hasPriorAssistant = priorMessages.some((m) => m.role === "assistant" && (Boolean(m.content?.trim()) || m.parts?.some((p) => p.type === "tool-call" || p.type === "text")));
+            if (hasPriorAssistant && !userInput) {
+              userInput = "[Workflow re-run] Inputs were updated since your last reply. Produce a new result for this run.";
+            }
+          } catch {}
+        }
+        context.additionInfo = additionInfo;
+        const result = await this.agentComponent.run(config.type || "general", userInput, context);
+        if (result.error?.startsWith("__ASK_USER_ERROR__:")) {
+          const jsonStr = result.error.substring("__ASK_USER_ERROR__:".length);
+          const errorInfo = JSON.parse(jsonStr);
+          throw new AskUserError(runId, errorInfo.sessionId, errorInfo.nodeId, errorInfo.nodeType || "agent", errorInfo.query);
+        }
+        const duration = Date.now() - startTime;
+        if (agentSessionId) {
+          this.pendingSessions.delete(agentSessionId);
+        }
+        const structuredOutput = await this.resolveStructuredOutput(result.structuredOutput, outputSchema, config, agentSessionId);
+        return {
+          output: structuredOutput ?? result.finalText ?? result.output,
+          structuredOutput,
+          metadata: {
+            duration,
+            iterations: result.iterations,
+            toolCalls: result.toolCalls?.length,
+            toolCallsDetail: result.toolCalls,
+            agentSessionId
+          }
+        };
+      } catch (error) {
+        const isAskUserError = error instanceof Error && error.name === "AskUserError";
+        if (isAskUserError) {
+          throw error;
+        }
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (agentSessionId) {
+          this.pendingSessions.delete(agentSessionId);
+        }
+        return {
+          output: undefined,
+          metadata: {
+            duration,
+            error: errorMessage,
+            agentSessionId
+          }
+        };
+      } finally {
+        if (isResume) {
+          this._currentAgentSessionId = undefined;
+        }
+      }
+    }
+    async resumeAgent(agentSessionId, userQuery, config) {
+      this.pendingSessions.delete(agentSessionId);
+      this._currentAgentSessionId = agentSessionId;
+      config.agentSessionId = agentSessionId;
+      return this.run(config, { userQuery, agentSessionId });
+    }
+    getPendingSession(agentSessionId) {
+      return this.pendingSessions.get(agentSessionId);
+    }
+    getPendingSessionsForRun(runId) {
+      return Array.from(this.pendingSessions.values()).filter((session) => session.runId === runId);
+    }
+    getAgentSessionsForWorkflowSession(workflowSessionId) {
+      return this.runSessionToAgentSessions.get(workflowSessionId) || [];
+    }
+    hasAgent(name) {
+      return this.agentComponent.getAgent(name) !== undefined;
+    }
+    listAgents() {
+      return this.agentComponent.listAgents().map((a) => a.name);
+    }
+    getAgentComponent() {
+      return this.agentComponent;
+    }
+    async resolveStructuredOutput(fromPlugin, outputSchema, config, agentSessionId) {
+      if (fromPlugin) {
+        return fromPlugin;
+      }
+      if (!outputSchema || !this._llmComponent || !agentSessionId || !this._sessionComponent) {
+        return;
+      }
+      try {
+        const sessionMessages = await this._sessionComponent.getMessages(agentSessionId);
+        const history = sessionMessages.map((m) => ({
+          role: m.role,
+          content: m.content ?? ""
+        }));
+        return await tracedExtractStructuredJsonViaLlm(this._llmComponent, history, outputSchema, {
+          model: config.options?.model,
+          sessionId: agentSessionId
+        });
+      } catch (error) {
+        console.warn("Workflow JSON extraction fallback failed:", error);
+        return;
+      }
+    }
+    agentSessionPrefixes = new Map;
+  };
+  __legacyDecorateClassTS([
+    TracedAs("workflow.agent_adapter.run", { recordParams: true, recordResult: true, log: true })
+  ], AgentComponentAdapter.prototype, "run", null);
+});
+
+export { AgentComponentAdapter, init_agent_component_adapter };

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

@@ -1,9 +1,9 @@
 import {
   createHook
-} from "./roy-agent-core-yq4fv8ce.js";
+} from "./roy-agent-core-hd9p5490.js";
 import {
   HookManager
-} from "./roy-agent-core-48v06q1b.js";
+} from "./roy-agent-core-qmr365f5.js";
 
 // src/env/component.ts
 class BaseComponent {

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

@@ -8,12 +8,12 @@ import {
 } from "./roy-agent-core-qxhq8ven.js";
 import {
   BaseComponent
-} from "./roy-agent-core-rjf59e7k.js";
+} from "./roy-agent-core-cssnkkkg.js";
 import {
   LLMHookPoints,
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-48v06q1b.js";
+} from "./roy-agent-core-qmr365f5.js";
 import {
   TracedAs,
   init_decorator
@@ -371,9 +371,10 @@ function convertToSDKMessages(messages) {
         if (tc.function?.arguments) {
           if (typeof tc.function.arguments === "string") {
             try {
-              input = JSON.parse(tc.function.arguments);
+              const parsed = JSON.parse(tc.function.arguments);
+              input = typeof parsed === "string" ? { _raw: parsed } : parsed;
             } catch {
-              input = tc.function.arguments;
+              input = { _raw: tc.function.arguments };
             }
           } else {
             input = tc.function.arguments;
@@ -381,9 +382,10 @@ function convertToSDKMessages(messages) {
         } else if (tc.arguments) {
           if (typeof tc.arguments === "string") {
             try {
-              input = JSON.parse(tc.arguments);
+              const parsed = JSON.parse(tc.arguments);
+              input = typeof parsed === "string" ? { _raw: parsed } : parsed;
             } catch {
-              input = tc.arguments;
+              input = { _raw: tc.arguments };
             }
           } else {
             input = tc.arguments;
@@ -529,9 +531,9 @@ function processThinkingStream(textDelta, config, state) {
   }
   const tags = config.tags || ["thinking"];
   let remainingText = textDelta;
-  const reasoningEvents = [];
-  let isOpen = state.isOpen;
-  let currentContent = state.content;
+  const reasoningEvents2 = [];
+  let isOpen2 = state.isOpen;
+  let currentContent2 = state.content;
   for (const tag of tags) {
     const openTag = `<${tag}>`;
     const closeTag = `</${tag}>`;
@@ -542,35 +544,35 @@ function processThinkingStream(textDelta, config, state) {
     if (openIndex !== -1 && (closeIndex === -1 || openIndex < closeIndex)) {
       const beforeOpen = text.substring(0, openIndex);
       const afterOpen = text.substring(openIndex + openTag.length);
-      if (!isOpen) {
-        isOpen = true;
-        currentContent = "";
-        reasoningEvents.push("");
+      if (!isOpen2) {
+        isOpen2 = true;
+        currentContent2 = "";
+        reasoningEvents2.push("");
       }
       result += beforeOpen;
       const innerCloseIndex = afterOpen.toLowerCase().indexOf(closeTag.toLowerCase());
       if (innerCloseIndex !== -1) {
         const thinkingContent = afterOpen.substring(0, innerCloseIndex);
         const afterClose = afterOpen.substring(innerCloseIndex + closeTag.length);
-        currentContent += thinkingContent;
-        reasoningEvents.push(currentContent);
-        isOpen = false;
-        currentContent = "";
+        currentContent2 += thinkingContent;
+        reasoningEvents2.push(currentContent2);
+        isOpen2 = false;
+        currentContent2 = "";
         result += afterClose;
       } else {
-        currentContent += afterOpen;
-        reasoningEvents.push(currentContent);
+        currentContent2 += afterOpen;
+        reasoningEvents2.push(currentContent2);
         result += "";
       }
       remainingText = result;
     } else if (closeIndex !== -1) {
       const beforeClose = text.substring(0, closeIndex);
       const afterClose = text.substring(closeIndex + closeTag.length);
-      if (isOpen) {
-        currentContent += beforeClose;
-        reasoningEvents.push(currentContent);
-        isOpen = false;
-        currentContent = "";
+      if (isOpen2) {
+        currentContent2 += beforeClose;
+        reasoningEvents2.push(currentContent2);
+        isOpen2 = false;
+        currentContent2 = "";
         result = afterClose;
       } else {
         result = text;
@@ -578,11 +580,16 @@ function processThinkingStream(textDelta, config, state) {
       remainingText = result;
     }
   }
+  if (isOpen2 && remainingText === textDelta) {
+    currentContent2 += remainingText;
+    reasoningEvents2.push(currentContent2);
+    remainingText = "";
+  }
   return {
     cleanedText: remainingText,
-    isThinkingTagOpen: isOpen,
-    currentThinkingContent: currentContent,
-    reasoningEvents
+    isThinkingTagOpen: isOpen2,
+    currentThinkingContent: currentContent2,
+    reasoningEvents: reasoningEvents2
   };
 }
 async function invoke(config, options, ctx) {
@@ -705,9 +712,6 @@ async function invoke(config, options, ctx) {
           break;
         }
         case "reasoning-end":
-          if (emitToEnv) {
-            emitToEnv({ type: "reasoning", content: reasoningContent, phase: "end" });
-          }
           break;
         case "tool-call": {
           const toolInput = streamPart.input;

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

@@ -7,7 +7,7 @@ import {
 } from "./roy-agent-core-qxhq8ven.js";
 import {
   BaseComponent
-} from "./roy-agent-core-rjf59e7k.js";
+} from "./roy-agent-core-cssnkkkg.js";
 import {
   __require
 } from "./roy-agent-core-fs0mn2jk.js";

package/dist/shared/@ai-setting/{roy-agent-core-7b35emr7.js → roy-agent-core-ew29335n.js}

@@ -26,7 +26,8 @@ class SessionMessageConverter {
           let parsedArgs = {};
           if (typeof toolPart.arguments === "string") {
             try {
-              parsedArgs = JSON.parse(toolPart.arguments);
+              const parsed = JSON.parse(toolPart.arguments);
+              parsedArgs = typeof parsed === "string" ? { _raw: parsed } : parsed;
             } catch {
               parsedArgs = { _raw: toolPart.arguments };
             }
@@ -98,7 +99,7 @@ class SessionMessageConverter {
             type: "tool-call",
             toolCallId: p.toolCallId,
             toolName: p.toolName,
-            arguments: p.input,
+            arguments: typeof p.input === "string" ? { _raw: p.input } : p.input,
             state: "pending"
           });
         } else if (p.type === "tool-result") {

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

@@ -6,10 +6,10 @@ import {
 } from "./roy-agent-core-92z6t4he.js";
 import {
   init_context
-} from "./roy-agent-core-c7cm1wjt.js";
+} from "./roy-agent-core-13vzexp2.js";
 import {
   getEnvContextOrEmpty
-} from "./roy-agent-core-s7bgrtch.js";
+} from "./roy-agent-core-v7583cf9.js";
 import {
   TracedAs,
   init_decorator

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

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

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

@@ -4,7 +4,7 @@ import {
 } from "./roy-agent-core-qxhq8ven.js";
 import {
   BaseComponent
-} from "./roy-agent-core-rjf59e7k.js";
+} from "./roy-agent-core-cssnkkkg.js";
 import {
   createLogger,
   init_logger

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

@@ -6,7 +6,7 @@ import {
 } from "./roy-agent-core-qxhq8ven.js";
 import {
   BaseComponent
-} from "./roy-agent-core-rjf59e7k.js";
+} from "./roy-agent-core-cssnkkkg.js";
 import {
   createLogger,
   init_logger

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

@@ -1,6 +1,6 @@
 import {
   SessionMessageConverter
-} from "./roy-agent-core-7b35emr7.js";
+} from "./roy-agent-core-ew29335n.js";
 import {
   __require
 } from "./roy-agent-core-fs0mn2jk.js";

package/dist/shared/@ai-setting/{roy-agent-core-48v06q1b.js → roy-agent-core-qmr365f5.js}

@@ -1,9 +1,9 @@
 import {
   init_context
-} from "./roy-agent-core-c7cm1wjt.js";
+} from "./roy-agent-core-13vzexp2.js";
 import {
   getEnvContext
-} from "./roy-agent-core-s7bgrtch.js";
+} from "./roy-agent-core-v7583cf9.js";
 import {
   __esm
 } from "./roy-agent-core-fs0mn2jk.js";

package/dist/shared/@ai-setting/{roy-agent-core-316v7cm4.js → roy-agent-core-rmndq0sb.js}

@@ -1,7 +1,7 @@
 import {
   AgentComponentAdapter,
   init_agent_component_adapter
-} from "./roy-agent-core-fy1y1aqx.js";
+} from "./roy-agent-core-awmae5ax.js";
 import {
   buildWorkflowNodeMetadata,
   getWorkflowNodeIdFromMetadata,

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

@@ -1,10 +1,10 @@
 import {
   BaseComponent
-} from "./roy-agent-core-rjf59e7k.js";
+} from "./roy-agent-core-cssnkkkg.js";
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-48v06q1b.js";
+} from "./roy-agent-core-qmr365f5.js";
 import {
   createLogger,
   init_logger

package/dist/shared/@ai-setting/{roy-agent-core-4b18eceq.js → roy-agent-core-smwwze1m.js}

@@ -6,7 +6,7 @@ import {
   WorkflowEngine,
   exports_engine,
   init_engine
-} from "./roy-agent-core-316v7cm4.js";
+} from "./roy-agent-core-rmndq0sb.js";
 import {
   WorkflowService
 } from "./roy-agent-core-4t40mkpv.js";
@@ -15,7 +15,7 @@ import {
 } from "./roy-agent-core-0vbdz0x7.js";
 import {
   BaseComponent
-} from "./roy-agent-core-rjf59e7k.js";
+} from "./roy-agent-core-cssnkkkg.js";
 import {
   createLogger,
   init_logger
@@ -136,7 +136,7 @@ class WorkflowComponent extends BaseComponent {
       const agentComponent = this._workflowEnv.getComponent("agent");
       const llmComponent = this._workflowEnv.getComponent("llm");
       if (agentComponent) {
-        const { AgentComponentAdapter } = await import("./roy-agent-core-fpb999vd.js");
+        const { AgentComponentAdapter } = await import("./roy-agent-core-0frwccap.js");
         agentRunner = new AgentComponentAdapter(agentComponent, {}, this.sessionComponent, llmComponent);
       }
     }
@@ -208,7 +208,7 @@ class WorkflowComponent extends BaseComponent {
       const sessionComponent = this._workflowEnv?.getComponent("session");
       componentLogger.info(`initSqliteService - toolComponent: ${!!toolComponent}, llmComponent: ${!!llmComponent}, skillRegistry: ${!!skillComponent}, sessionComponent: ${!!sessionComponent}`);
       if (llmComponent) {
-        const { registerWorkflowJsonOutputPlugin } = await import("./roy-agent-core-5ng0awvn.js");
+        const { registerWorkflowJsonOutputPlugin } = await import("./roy-agent-core-3jk7ngmx.js");
         registerWorkflowJsonOutputPlugin(llmComponent);
       }
       this.createService({

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

@@ -22,7 +22,7 @@ function hasEnvContext() {
   return envContextStorage.getStore() !== undefined;
 }
 function getCurrentTaskId() {
-  return envContextStorage.getStore()?.currentTaskId;
+  return envContextStorage.getStore()?.agentContext?.currentTaskId;
 }
 function runWithEnvContext(context, fn) {
   if (context) {
@@ -52,6 +52,10 @@ function createEnvContext(options) {
 function mergeEnvContext(partial) {
   const current = envContextStorage.getStore();
   if (current) {
+    if (partial.agentContext && current.agentContext) {
+      Object.assign(current.agentContext, partial.agentContext);
+      delete partial.agentContext;
+    }
     Object.assign(current, partial);
   }
 }
@@ -63,7 +67,13 @@ var init_env_context = __esm(() => {
   envContextStorage = new AsyncLocalStorage;
   setCurrentTaskId = wrapFunction(function _setCurrentTaskId(taskId) {
     const prev = getCurrentTaskId();
-    mergeEnvContext({ currentTaskId: taskId });
+    const ctx = envContextStorage.getStore();
+    if (ctx) {
+      if (!ctx.agentContext) {
+        ctx.agentContext = {};
+      }
+      ctx.agentContext.currentTaskId = taskId;
+    }
     logger.info(`[setCurrentTaskId] taskId=${taskId ?? "undefined"} (was: ${prev ?? "undefined"})`);
   }, "env-context.setCurrentTaskId", { recordParams: true, recordResult: false, log: true });
 });

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

@@ -7,14 +7,14 @@ import {
 } from "./roy-agent-core-qxhq8ven.js";
 import {
   BaseComponent
-} from "./roy-agent-core-rjf59e7k.js";
+} from "./roy-agent-core-cssnkkkg.js";
 import {
   createHook
-} from "./roy-agent-core-yq4fv8ce.js";
+} from "./roy-agent-core-hd9p5490.js";
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-48v06q1b.js";
+} from "./roy-agent-core-qmr365f5.js";
 import {
   createLogger,
   init_logger
@@ -110,23 +110,26 @@ var builtInPrompts = {
 | 工具 | 描述 |
 |------|------|
 | \`delegate_task\` | 委托复杂/多步骤任务给子智能体执行 |
-| \`bash\` | **仅**用于执行简单的 Roy Agent 相关命令（如 \`bun packages/cli/dist/bin/roy-agent.js ...\`） |
+| \`bash\` | **仅**用于执行一行简单的 Roy Agent 命令或一次性操作 |
 
 ### 工具使用规则
 
-**\`delegate_task\`** — 用于一切复杂、多步骤、需要读文件、运行命令、搜索、实现功能等场景。这是你的主要工具。
+**\`delegate_task\`** — 这是你的**主要工具**。用于一切复杂、多步骤、需要读文件、运行命令、代码分析、搜索、实现功能等场景。**当不确定用哪个时，选 \`delegate_task\`。**
 
-**\`bash\`** — **仅限**以下简单场景：
-- 执行简单的 \`roy-agent\` 命令（如 \`bun packages/cli/dist/bin/roy-agent.js act "你好"\`）
-- 检查 Roy Agent 版本或帮助信息
-- 运行已经由子智能体构建好的脚本
-- 创建简单的问候或快速测试
+**\`bash\`** — **仅限**以下**一次性简单操作**：
+- 调用一行 \`roy-agent\` 命令（如 \`bun packages/cli/dist/bin/roy-agent.js tasks list\`）
+- 执行一个简单的 shell 命令（如 \`ls\`、\`echo hello\`）
+- 检查版本或帮助信息
+
+**\`bash\` 的边界判定：**
+> 如果需要 **2 步以上**、涉及**条件判断**、需要**读取结果后再决策**，或者**不确认能否一行完成**，**一律用 \`delegate_task\`**。
 
 **\`bash\` 禁止用于：**
-- 任何需要多步骤的复杂逻辑
-- 代码分析、文件读写、搜索
-- 功能开发、调试、重构
-- 即使可以用 bash 实现，复杂任务也必须使用 \`delegate_task\`
+- ❌ 任何需要多步骤的复杂逻辑
+- ❌ 代码分析、文件读写、搜索
+- ❌ 功能开发、调试、重构
+- ❌ 读取文件内容、grep 代码
+- ❌ 即使可以用 bash 实现，**只要超过 1 步**就必须用 \`delegate_task\`
 
 ## 何时委托
 
@@ -139,10 +142,12 @@ var builtInPrompts = {
 - **不明确的请求** — 需要探索才能明确方向的任务
 - **文件/代码/数据访问** — 任何需要读文件、运行命令或查询数据的请求
 
-**不需要委托的情况：**
+**不需要委托的情况（极少）：**
 - 简单的问候 / 闲聊
 - 你凭自身知识就能回答的一次性简单问题
 
+> ⚠️ **当你不确定是否需要委托时，一律委托。** 宁可多委托一次，也不要自己用 bash 做多步骤操作。
+
 ## 子智能体选择策略
 
 你有两个子智能体。**默认首次委托使用 \`roy\`**。仅在需要严格 Plan→Execute→Verify 纪律时使用 \`strict-task-agent\`。
@@ -199,7 +204,7 @@ delegate_task(
 ## 行为规则
 
 1. **复杂任务必须委托** — 不要尝试自己解决复杂任务。使用 \`delegate_task\` 委托给子智能体。
-2. **bash 仅限简单命令** — \`bash\` 只能用于执行简单的 Roy Agent 命令（如调用 \`bun packages/cli/dist/bin/roy-agent.js ...\`）。任何需要多步骤逻辑的复杂工作，即使可以用 bash 实现，也必须使用 \`delegate_task\`。
+2. **bash 仅限一次操作** — \`bash\` 只能用于执行一行简单的 shell 命令或 \`roy-agent\` 命令。**任何超过 1 步的操作，即使可以用一行 bash 实现，也必须使用 \`delegate_task\`**。如果不确定，就委托。
 3. **保持简洁** — 简短分析，然后立即委托。不要冗长。
 4. **首选 roy** — 首次委托默认使用 \`roy\`
 5. **次选 strict-task-agent** — 需要严格 Plan→Execute→Verify 纪律时使用