@ai-setting/roy-agent-core 1.5.90 → 1.5.92

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

@@ -1,7 +1,7 @@
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-vyygk314.js";
 
 // src/env/llm/tool-args-parser.ts
 init_logger();

package/dist/shared/@ai-setting/{roy-agent-core-83d035pp.js → roy-agent-core-97tjdb2r.js}

@@ -253,6 +253,25 @@ Workflow 是预定义的自动化流程，可以高效解决常见类型的任
 - **不要为了用 workflow 而用**，强行创建一个不合适的 workflow 来套用任务不如直接用传统方式解决
 - **委托子智能体时**：如果认为有 workflow 可能帮助子智能体，可以在 prompt 中提示子智能体先查询 tag 池搜索可用 workflow
 
+### ⚡ Session 恢复（重要，耗时 workflow 必备）
+
+对于耗时较长、易超时的 workflow（如 \`strict-task-agent\`），如遇超时/中断，可使用 \`-s\` 选项从断点继续运行，**避免重头开始**：
+
+    # 初次运行（可能超时）
+    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
+
+    # 长选项亦可：
+    roy-agent workflow run <workflow-name> --session workflow_run_1783407282099_1_ah8pho
+
+> **重要规则**：
+> - Session ID 必须以 \`workflow_\` 开头，否则 CLI 会立即报错
+> - 引擎会从 last message 推断恢复点（\`workflow.node.start\` → 节点级 resume；\`workflow.node.end\` → 下一节点；\`workflow.node.interrupt\` → ask_user）
+> - agentNode 恢复时会自动 attach \`agentSessionId\`，agent 从中断的 sub-session 继续
+> - 适合长时间 workflow（strict-task-agent / bench-agent-host 等）的超时重试
+
 ### {{memory}}`,
   roy: `You are Roy, a versatile AI assistant inspired by Jarvis - intelligent, proactive, and capable.
 
@@ -443,6 +462,24 @@ Workflows are pre-built automation pipelines. When tackling a complex task, **co
 
 **Key principle**: Workflows are here to help, not restrict. If no workflow fits, **do NOT force it** — just solve the task directly. This is the correct approach.
 
+#### ⚡ Session 恢复（重要）
+
+For long-running workflows (e.g., \`strict-task-agent\`, \`bench-agent-host\`) that may time out, use the \`-s\` / \`--session\` option to **resume from the interrupt point** instead of restarting from scratch:
+
+    # Initial run (may time out)
+    roy-agent workflow run <workflow-name> --input '{"query":"..."}'
+
+    # After timeout/interrupt, resume from where it stopped (using the Run ID):
+    roy-agent workflow run <workflow-name> -s workflow_run_1783407282099_1_ah8pho
+    # or
+    roy-agent workflow run <workflow-name> --session workflow_run_1783407282099_1_ah8pho
+
+> **Key rules**:
+> - Session ID must start with \`workflow_\` prefix (CLI validates and rejects otherwise)
+> - The engine infers the resume point from the last session message: \`workflow.node.start\` → node-level resume, \`workflow.node.end\` → next node, \`workflow.node.interrupt\` → ask_user
+> - For agentNode, \`agentSessionId\` is auto-attached so the agent continues from its sub-session
+> - **Highly recommended for strict-task-agent** — its 3-stage (plan/execute/verify) flow often hits timeouts on complex tasks
+
 #### EventSource Command
 
 \`\`\`bash
@@ -930,7 +967,39 @@ workflow_run(workflow_name="strict-task-agent", input={"task_description": "修
 # → 返回 run_id, status, output
 \`\`\`
 
-## 严格约束
+## ⚡ Session 恢复（核心能力）
+
+\`workflow_run\` 支持通过 \`-s\` / \`--session\` 选项从中断处继续运行。这是处理**长时间 workflow 超时**（特别是 \`strict-task-agent\` 的 plan→execute→verify 三阶段）时的关键能力。
+
+### 使用场景
+- **用户请求"继续之前的 workflow"** — 用户给的 prompt 包含 "继续" / "resume" / "接着" / "从断点" + session ID
+- **session ID 出现在用户消息** — 形如 \`workflow_run_1783407282099_1_ah8pho\`
+- **workflow 超时被报告** — 子智能体或上游报告"workflow 超时"+"session ID"
+
+### 触发条件识别
+如果满足以下任一条件，**优先使用 \`workflow_run\` 工具的 \`session\` 参数**而不是新建一个 workflow run：
+1. 用户消息中出现 \`workflow_run_xxx\` 格式的 ID
+2. 用户消息包含 resume/继续/接着/断点/从中断处 等关键词
+3. 上游任务报告某个 workflow 超时并提供了 session ID
+
+### 调用方式
+
+    # 不要走 workflow_get → workflow_run 这条 fresh-run 路径
+    # 直接走 session resume 路径：
+    workflow_run(
+      workflow_name="strict-task-agent",
+      session="workflow_run_1783407282099_1_ah8pho"
+      # 可选：如果用户提供了新的 query，可以加 input 字段
+    )
+
+### 关键约束
+- ✅ Session ID 必须以 \`workflow_\` 开头（CLI 校验，不合法会立即报错）
+- ✅ Resume 会从 last message 推断恢复点：start → 节点级 resume，end → 下一节点，interrupt → ask_user
+- ✅ agentNode 恢复时自动 attach \`agentSessionId\`，agent 从 sub-session 继续
+- ❌ 不要在 resume 时传 \`input\` 覆盖 query（除非用户明确说要修改任务）
+- ❌ 不要把 \`workflow_xxx\` 当作 workflow name 调 \`workflow_get\`（那是 session ID 不是 workflow name）
+
+### 严格约束
 
 - ✅ **只**通过 \`workflow_run\` 工具执行 workflow
 - ✅ 先调用 \`workflow_get\` 获取 schema，再调用 \`workflow_run\`

package/dist/shared/@ai-setting/{roy-agent-core-pcdzfwdv.js → roy-agent-core-9xby523m.js}

@@ -1,7 +1,7 @@
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-vyygk314.js";
 import {
   __esm,
   __export,

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

@@ -4,28 +4,28 @@ import {
 } from "./roy-agent-core-hvdfgvfz.js";
 import {
   DEFAULT_SUBAGENT_PROMPT
-} from "./roy-agent-core-nqzt9ne4.js";
+} from "./roy-agent-core-vady4w02.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-92z6t4he.js";
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-7tp56w6n.js";
+} from "./roy-agent-core-gp872e7m.js";
 import {
   init_context
-} from "./roy-agent-core-qg4rma4c.js";
+} from "./roy-agent-core-zttjq1h3.js";
 import {
   getCurrentTaskId
-} from "./roy-agent-core-y5d04fm3.js";
+} from "./roy-agent-core-scp0afxg.js";
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-k05v31rc.js";
+} from "./roy-agent-core-cg146hmg.js";
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-vyygk314.js";
 import {
   __legacyDecorateClassTS
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -5,11 +5,11 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "./roy-agent-core-mw4ty0ba.js";
+} from "./roy-agent-core-at05dk0z.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
-} from "./roy-agent-core-pcdzfwdv.js";
+} from "./roy-agent-core-9xby523m.js";
 import {
   batchArchiveTaskTool,
   batchDeleteTaskTool,
@@ -20,7 +20,7 @@ import {
   listTasksTool,
   searchTasksTool,
   updateTaskTool
-} from "./roy-agent-core-h5867smx.js";
+} from "./roy-agent-core-0ye4q2jj.js";
 import {
   createOperationTool,
   deleteOperationTool,
@@ -36,19 +36,19 @@ import {
 } from "./roy-agent-core-qxhq8ven.js";
 import {
   BaseComponent
-} from "./roy-agent-core-rgckng3p.js";
+} from "./roy-agent-core-pf1c360e.js";
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-7tp56w6n.js";
+} from "./roy-agent-core-gp872e7m.js";
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-k05v31rc.js";
+} from "./roy-agent-core-cg146hmg.js";
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-vyygk314.js";
 import {
   __legacyDecorateClassTS
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -4,7 +4,7 @@ import {
 } from "./roy-agent-core-rvv6ydff.js";
 import {
   BaseComponent
-} from "./roy-agent-core-rgckng3p.js";
+} from "./roy-agent-core-pf1c360e.js";
 import {
   __require
 } from "./roy-agent-core-fs0mn2jk.js";

package/dist/shared/@ai-setting/{roy-agent-core-3sv590cv.js → roy-agent-core-b77yz0wt.js}

@@ -1,7 +1,7 @@
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-k05v31rc.js";
+} from "./roy-agent-core-cg146hmg.js";
 import {
   __legacyDecorateClassTS
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -1,11 +1,11 @@
 import {
   init_decorator,
   wrapFunction
-} from "./roy-agent-core-k05v31rc.js";
+} from "./roy-agent-core-cg146hmg.js";
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-vyygk314.js";
 
 // src/env/task/plugins/auto-task-plugin.ts
 init_logger();

package/dist/shared/@ai-setting/{roy-agent-core-3czy06aq.js → roy-agent-core-bqwj1dq0.js}

@@ -8,17 +8,17 @@ import {
 } from "./roy-agent-core-fnv3ev18.js";
 import {
   adaptMcpTool
-} from "./roy-agent-core-djtkntar.js";
+} from "./roy-agent-core-4w6rgxs4.js";
 import {
   toEnvKey
 } from "./roy-agent-core-qxhq8ven.js";
 import {
   BaseComponent
-} from "./roy-agent-core-rgckng3p.js";
+} from "./roy-agent-core-pf1c360e.js";
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-vyygk314.js";
 
 // src/env/mcp/types.ts
 import { z } from "zod";

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

@@ -3,7 +3,7 @@ import {
   getMaxOutput,
   init_logger,
   simplifyFilePath
-} from "./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-vyygk314.js";
 import {
   getTracerProvider,
   init_tracer_provider

package/dist/shared/@ai-setting/{roy-agent-core-07290s9n.js → roy-agent-core-cx67bv9d.js}

@@ -6,11 +6,11 @@ import {
 } from "./roy-agent-core-qxhq8ven.js";
 import {
   BaseComponent
-} from "./roy-agent-core-rgckng3p.js";
+} from "./roy-agent-core-pf1c360e.js";
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-vyygk314.js";
 
 // src/env/skill/skill-component.ts
 init_logger();

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

@@ -5,11 +5,11 @@ import {
   initDatabase,
   initializeTables,
   resetDatabase
-} from "./roy-agent-core-h4h55x4h.js";
-import"./roy-agent-core-3sv590cv.js";
+} from "./roy-agent-core-jexyz11d.js";
+import"./roy-agent-core-b77yz0wt.js";
 import"./roy-agent-core-rvxg1wps.js";
-import"./roy-agent-core-k05v31rc.js";
-import"./roy-agent-core-shme7set.js";
+import"./roy-agent-core-cg146hmg.js";
+import"./roy-agent-core-vyygk314.js";
 import"./roy-agent-core-7z9b1fm8.js";
 import"./roy-agent-core-c6592r3c.js";
 import"./roy-agent-core-fs0mn2jk.js";

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

@@ -3,11 +3,11 @@ import {
   hasDecoratorNodes,
   init_node_registry_helper,
   registerDecoratorNodeType
-} from "./roy-agent-core-fjexv5nm.js";
+} from "./roy-agent-core-xgnpr28w.js";
 import"./roy-agent-core-ddwa0n6h.js";
 import"./roy-agent-core-1ce3fqrk.js";
-import"./roy-agent-core-k05v31rc.js";
-import"./roy-agent-core-shme7set.js";
+import"./roy-agent-core-cg146hmg.js";
+import"./roy-agent-core-vyygk314.js";
 import"./roy-agent-core-7z9b1fm8.js";
 import"./roy-agent-core-c6592r3c.js";
 import"./roy-agent-core-fs0mn2jk.js";

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

@@ -1,7 +1,7 @@
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-k05v31rc.js";
+} from "./roy-agent-core-cg146hmg.js";
 import {
   __legacyDecorateClassTS
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -1,6 +1,6 @@
 import {
   invoke
-} from "./roy-agent-core-0r4ndyn9.js";
+} from "./roy-agent-core-j7jeqxhd.js";
 import {
   ContextError,
   ErrorCodes
@@ -11,20 +11,20 @@ import {
 } from "./roy-agent-core-qxhq8ven.js";
 import {
   BaseComponent
-} from "./roy-agent-core-rgckng3p.js";
+} from "./roy-agent-core-pf1c360e.js";
 import {
   LLMHookPoints,
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-7tp56w6n.js";
+} from "./roy-agent-core-gp872e7m.js";
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-k05v31rc.js";
+} from "./roy-agent-core-cg146hmg.js";
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-vyygk314.js";
 import {
   __legacyDecorateClassTS
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -1,10 +1,10 @@
 import {
   SessionMessageConverter
-} from "./roy-agent-core-txwf64pd.js";
+} from "./roy-agent-core-yfhgxh5a.js";
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-vyygk314.js";
 import {
   __require
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -1,7 +1,7 @@
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-k05v31rc.js";
+} from "./roy-agent-core-cg146hmg.js";
 import {
   __esm,
   __legacyDecorateClassTS

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

@@ -1,9 +1,9 @@
 import {
   init_context
-} from "./roy-agent-core-qg4rma4c.js";
+} from "./roy-agent-core-zttjq1h3.js";
 import {
   getEnvContext
-} from "./roy-agent-core-y5d04fm3.js";
+} from "./roy-agent-core-scp0afxg.js";
 import {
   __esm
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -1,8 +1,8 @@
 import {
   TagRepository
-} from "./roy-agent-core-3sv590cv.js";
-import"./roy-agent-core-k05v31rc.js";
-import"./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-b77yz0wt.js";
+import"./roy-agent-core-cg146hmg.js";
+import"./roy-agent-core-vyygk314.js";
 import"./roy-agent-core-7z9b1fm8.js";
 import"./roy-agent-core-c6592r3c.js";
 import"./roy-agent-core-fs0mn2jk.js";

package/dist/shared/@ai-setting/{roy-agent-core-32m0nb9j.js → roy-agent-core-j3qb695p.js}

@@ -1,7 +1,7 @@
 import {
   TAG_MAX_COUNT,
   TAG_MIN_COUNT
-} from "./roy-agent-core-tq9528d3.js";
+} from "./roy-agent-core-e7t3rj0e.js";
 import {
   validateWorkflowDefinition
 } from "./roy-agent-core-8wd3qwx5.js";
@@ -12,11 +12,11 @@ import {
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-k05v31rc.js";
+} from "./roy-agent-core-cg146hmg.js";
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-vyygk314.js";
 import {
   __legacyDecorateClassTS
 } from "./roy-agent-core-fs0mn2jk.js";

package/dist/shared/@ai-setting/{roy-agent-core-0r4ndyn9.js → roy-agent-core-j7jeqxhd.js}

@@ -1,10 +1,10 @@
 import {
   safeParseToolArgs
-} from "./roy-agent-core-ce10b0ez.js";
+} from "./roy-agent-core-8x4ngxcy.js";
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-vyygk314.js";
 import {
   __require
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -1,6 +1,6 @@
 import {
   TagRepository
-} from "./roy-agent-core-3sv590cv.js";
+} from "./roy-agent-core-b77yz0wt.js";
 import {
   exports_search_query_parser,
   init_search_query_parser
@@ -8,7 +8,7 @@ import {
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-vyygk314.js";
 import {
   __require,
   __toCommonJS

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

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

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

@@ -1,51 +1,51 @@
 import {
   withTimeout
-} from "./roy-agent-core-0r4ndyn9.js";
+} from "./roy-agent-core-j7jeqxhd.js";
 import {
   truncateOutputInline
-} from "./roy-agent-core-hxsbegfc.js";
+} from "./roy-agent-core-ptb4pkva.js";
 import {
   AskUserError,
   init_workflow_hil
 } from "./roy-agent-core-e25xkv53.js";
 import {
   AgentRegistry
-} from "./roy-agent-core-nqzt9ne4.js";
+} from "./roy-agent-core-vady4w02.js";
 import {
   ContextError
 } from "./roy-agent-core-ctdhjv68.js";
 import {
   SessionMessageConverter
-} from "./roy-agent-core-txwf64pd.js";
+} from "./roy-agent-core-yfhgxh5a.js";
 import {
   safeParseToolArgs
-} from "./roy-agent-core-ce10b0ez.js";
+} from "./roy-agent-core-8x4ngxcy.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-qxhq8ven.js";
 import {
   BaseComponent
-} from "./roy-agent-core-rgckng3p.js";
+} from "./roy-agent-core-pf1c360e.js";
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-7tp56w6n.js";
+} from "./roy-agent-core-gp872e7m.js";
 import {
   init_context
-} from "./roy-agent-core-qg4rma4c.js";
+} from "./roy-agent-core-zttjq1h3.js";
 import {
   getCurrentTaskId,
   getEnvContext,
   runWithEnvContextAsync
-} from "./roy-agent-core-y5d04fm3.js";
+} from "./roy-agent-core-scp0afxg.js";
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-k05v31rc.js";
+} from "./roy-agent-core-cg146hmg.js";
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-shme7set.js";
+} from "./roy-agent-core-vyygk314.js";
 import {
   __legacyDecorateClassTS
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -1,9 +1,9 @@
 import {
   createHook
-} from "./roy-agent-core-b8r4tfqq.js";
+} from "./roy-agent-core-ksx9a556.js";
 import {
   HookManager
-} from "./roy-agent-core-7tp56w6n.js";
+} from "./roy-agent-core-gp872e7m.js";
 
 // src/env/component.ts
 class BaseComponent {