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

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-8wd5awxg.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-btp589bw.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-4djnmd86.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-m0wy7p0q.js";
 import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-6mz26khm.js";
+} from "../shared/@ai-setting/roy-agent-core-8wd5awxg.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-btp589bw.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";
@@ -48,13 +48,13 @@ 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-5kc9qtej.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-mqeqevym.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-4djnmd86.js";
 import"../shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import"../shared/@ai-setting/roy-agent-core-tycbpm17.js";
 import {

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-5ka95kh7.js";
+import"../../shared/@ai-setting/roy-agent-core-4djnmd86.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,9 +3,9 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-n1fx2fx4.js";
+} from "../../../shared/@ai-setting/roy-agent-core-mqeqevym.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-4djnmd86.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-qxnbvgwe.js";

package/dist/env/task/index.js

@@ -5,18 +5,18 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-mvmgy9t0.js";
+} from "../../shared/@ai-setting/roy-agent-core-5kc9qtej.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-mqeqevym.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-4djnmd86.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-qxnbvgwe.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-btp589bw.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-4djnmd86.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-5ka95kh7.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-m0wy7p0q.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-8wd5awxg.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-btp589bw.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";
@@ -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-5kc9qtej.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-mqeqevym.js";
 import"./shared/@ai-setting/roy-agent-core-44g3synv.js";
 import {
   SQLiteTaskStore,
@@ -162,7 +162,7 @@ import {
 import {
   getBuiltInPrompt,
   getBuiltInPromptNames
-} from "./shared/@ai-setting/roy-agent-core-65vpkh7x.js";
+} from "./shared/@ai-setting/roy-agent-core-4djnmd86.js";
 import"./shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import {
   AgentRegistry

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

@@ -377,52 +377,67 @@ const status = await query_background_process({ bgProcessId: result.bgProcessId
 
 ## Workflow 操作指南
 
-Workflow 是预定义的自动化流程，可以高效解决常见类型的任务。在接手一个复杂任务时，**建议先用 workflow 检索看看有没有现成的解决方案**。
+Workflow 是预定义的自动化流程，可以高效解决常见类型的任务。**Default agent 自身不应直接 bash 跑 workflow**——所有 workflow 调用必须通过 \`delegate_task\` 委托给 \`workflow-runner\` 子智能体执行。
+
+### 如何通过 \`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\` 执行**：用下列模板派发
+
+\`\`\`text
+delegate_task(
+  subagent_type="workflow-runner",
+  prompt="调用 workflow_run 执行 workflow <workflow-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
-
-### ⚡ Session 恢复（重要，耗时 workflow 必备）
+- **Default agent 不直接调用 workflow**：所有 workflow 调用必须通过 \`delegate_task(subagent_type="workflow-runner", ...)\` 委托子智能体执行
 
-对于耗时较长、易超时的 workflow（如 \`strict-task-agent\`），如遇超时/中断，可使用 \`-s\` 选项从断点继续运行，**避免重头开始**：
+### ⚡ Session 恢复（重要，耗时 workflow 必备 — default agent 视角）
 
-    # 初次运行（可能超时）
-    roy-agent workflow run <workflow-name> --input '{"query":"..."}'
+workflow-runner 报告 workflow runId 后，对于耗时较长、易超时的 workflow（如 \`strict-task-agent\`），如遇超时/中断，**default agent 应重新派发 \`delegate_task\` 给 \`workflow-runner\`**，并附带 \`-s\` / \`--session\` 选项让 workflow-runner 从断点继续运行：
 
-    # 拿到 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}}`,

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

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

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

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

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

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

package/dist/shared/@ai-setting/{roy-agent-core-nreqmmtz.js → roy-agent-core-btp589bw.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-4djnmd86.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.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-vc8e968b.js → roy-agent-core-m0wy7p0q.js}

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

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-n1fx2fx4.js → roy-agent-core-mqeqevym.js}

@@ -4,7 +4,7 @@ import {
 } from "./roy-agent-core-44g3synv.js";
 import {
   builtInPrompts
-} from "./roy-agent-core-65vpkh7x.js";
+} from "./roy-agent-core-4djnmd86.js";
 import {
   runWithBgTaskIdAsync
 } from "./roy-agent-core-c1v263jn.js";

package/package.json

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