@ai-setting/roy-agent-core 1.7.77 → 1.7.88

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

@@ -1,7 +1,7 @@
 import {
   init_global_hook_manager,
   init_hook_manager
-} from "./roy-agent-core-cpcd24n2.js";
+} from "./roy-agent-core-yet36q5k.js";
 import {
   __esm
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -11,7 +11,7 @@ import {
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   __esm,
   __legacyDecorateClassTS

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

@@ -1,7 +1,7 @@
 import {
   init_env_context,
   init_env_event
-} from "./roy-agent-core-7cbpmk4q.js";
+} from "./roy-agent-core-p31ftgq9.js";
 import {
   __esm
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -1,22 +1,22 @@
 import {
   isToolUnavailableError,
   truncateOutputInline
-} from "./roy-agent-core-v85n42ve.js";
+} from "./roy-agent-core-mx855td4.js";
 import {
   AgentRegistry
-} from "./roy-agent-core-ed233k5z.js";
+} from "./roy-agent-core-v1n0106v.js";
 import {
   createTaskOpWatermarkPlugin,
   enqueueToAddFakeUserMessage
-} from "./roy-agent-core-h21gngxf.js";
+} from "./roy-agent-core-7yh5wps0.js";
 import {
   SessionMessageConverter
-} from "./roy-agent-core-0snm5hc5.js";
+} from "./roy-agent-core-y6shd91r.js";
 import {
   parseToolArgsStrict,
   safeParseToolArgs,
   withTimeout
-} from "./roy-agent-core-fghc2m8z.js";
+} from "./roy-agent-core-aa8kv18f.js";
 import {
   getCurrentBgTaskId
 } from "./roy-agent-core-c1v263jn.js";
@@ -32,20 +32,20 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-pgvcf91v.js";
+} from "./roy-agent-core-m39v7qpx.js";
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-cpcd24n2.js";
+} from "./roy-agent-core-yet36q5k.js";
 import {
   init_context
-} from "./roy-agent-core-qqaak24r.js";
+} from "./roy-agent-core-tkpp1ba0.js";
 import {
   getCurrentTaskId,
   getEnvContext,
   resolveEnvParentTaskId,
   runWithEnvContextAsync
-} from "./roy-agent-core-7cbpmk4q.js";
+} from "./roy-agent-core-p31ftgq9.js";
 import {
   TracedAs,
   agentRunParamFilter,
@@ -57,7 +57,7 @@ import {
   recordSessionMessagesParamFilter,
   toolExecParamFilter,
   toolExecResultFilter
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger
@@ -69,8 +69,6 @@ import {
 
 // src/env/agent/agent-component.ts
 init_logger();
-import fs from "fs/promises";
-import path from "path";
 import { z } from "zod";
 
 // src/env/task/plugins/max-iteration-reminder-plugin.ts
@@ -556,10 +554,16 @@ var AgentInstanceSchema = z.object({
 var AgentComponentConfigSchema = z.object({
   defaultAgent: AgentInstanceSchema
 });
-function filterToolsByAgent(tools, agent) {
+function filterToolsByAgent(tools, agent, extendTools) {
   if (!tools?.length)
     return tools ?? [];
   return tools.filter((t) => {
+    if (t.metadata?.channelOnly === true) {
+      if (!extendTools || extendTools.length === 0)
+        return false;
+      if (!extendTools.includes(t.name))
+        return false;
+    }
     const allowedList = t.metadata?.allowedAgentTypes;
     if (!allowedList || allowedList.length === 0)
       return true;
@@ -601,6 +605,7 @@ class AgentComponent extends BaseComponent {
   abortControllers = new Map;
   defaultTools = [];
   doomLoopCaches = new Map;
+  _cacheSnapshots = new Map;
   fallbackState = new Map;
   configComponent;
   skipAbortRunningTasksOnStop = false;
@@ -958,7 +963,8 @@ class AgentComponent extends BaseComponent {
     this.defaultTools = tools;
   }
   getAvailableTools(agent, context) {
-    let tools = filterToolsByAgent([...this.defaultTools], agent);
+    const extendTools = context?.extendTools;
+    let tools = filterToolsByAgent([...this.defaultTools], agent, extendTools);
     logger2.debug(`[getAvailableTools] After defaultTools (filtered): ${tools.length} tools`, {
       toolNames: tools.map((t) => t.name)
     });
@@ -966,7 +972,7 @@ class AgentComponent extends BaseComponent {
       const componentTools = this.toolComponent.listTools({
         allowedAgent: agent.name
       });
-      const filteredComponentTools = filterToolsByAgent(componentTools, agent);
+      const filteredComponentTools = filterToolsByAgent(componentTools, agent, extendTools);
       tools = [...tools, ...filteredComponentTools];
       logger2.debug(`[getAvailableTools] After adding componentTools: ${tools.length} tools`, {
         componentToolNames: filteredComponentTools.map((t) => t.name)
@@ -988,7 +994,7 @@ class AgentComponent extends BaseComponent {
       });
     }
     if (context?.extraTools?.length) {
-      const filteredExtraTools = filterToolsByAgent(context.extraTools, agent);
+      const filteredExtraTools = filterToolsByAgent(context.extraTools, agent, extendTools);
       tools = [...tools, ...filteredExtraTools];
       logger2.debug(`[getAvailableTools] After extraTools (filtered): ${tools.length} tools`, {
         extraToolNames: filteredExtraTools.map((t) => t.name)
@@ -1613,25 +1619,14 @@ class AgentComponent extends BaseComponent {
       return { snapshot: null, systemPromptOverride: undefined };
     }
     try {
-      const sessionComponent = this.env?.getComponent?.("session");
-      if (!sessionComponent) {
-        return { snapshot: null, systemPromptOverride: undefined };
-      }
-      const session = await sessionComponent.get(sessionId);
-      const existingSnapshot = session?.metadata?.cacheSnapshot;
-      if (existingSnapshot && typeof existingSnapshot === "object" && existingSnapshot.systemPrompt) {
-        const stale = await this._isMemorySnapshotStale(existingSnapshot);
-        if (stale) {
-          logger2.info(`[AgentComponent._run] cacheSnapshot for session ${sessionId} is stale (${stale}); recreating`);
-        } else {
-          logger2.debug(`[AgentComponent._run] Reusing cacheSnapshot for session ${sessionId} (snapshotAt=${existingSnapshot.snapshotAt})`);
-          return {
-            snapshot: existingSnapshot,
-            systemPromptOverride: existingSnapshot.systemPrompt
-          };
-        }
+      const existingSnapshot = this._cacheSnapshots.get(sessionId);
+      if (existingSnapshot) {
+        logger2.debug(`[AgentComponent._run] Reusing cacheSnapshot for session ${sessionId} (snapshotAt=${existingSnapshot.snapshotAt})`);
+        return {
+          snapshot: existingSnapshot,
+          systemPromptOverride: existingSnapshot.systemPrompt
+        };
       }
-      const memoryStat = await this._collectMemoryStat();
       let resolvedSystemPrompt = initialSystemPrompt;
       if (resolvedSystemPrompt && resolvedSystemPrompt.includes("{{memory}}")) {
         try {
@@ -1650,66 +1645,16 @@ class AgentComponent extends BaseComponent {
       const snapshot = {
         systemPrompt: resolvedSystemPrompt ?? agentConfigSystemPrompt ?? "",
         additionInfo: effectiveContext.additionInfo || "",
-        snapshotAt: Date.now(),
-        memoryStat
+        snapshotAt: Date.now()
       };
-      try {
-        await sessionComponent.update(sessionId, {
-          metadata: {
-            ...session?.metadata ?? {},
-            cacheSnapshot: snapshot
-          }
-        });
-        logger2.debug(`[AgentComponent._run] Created cacheSnapshot for session ${sessionId} (snapshotAt=${snapshot.snapshotAt})`);
-      } catch (updateErr) {
-        logger2.warn(`[AgentComponent._run] Failed to persist cacheSnapshot for session ${sessionId}: ${updateErr}`);
-      }
+      this._cacheSnapshots.set(sessionId, snapshot);
+      logger2.debug(`[AgentComponent._run] Created cacheSnapshot for session ${sessionId} (snapshotAt=${snapshot.snapshotAt})`);
       return { snapshot, systemPromptOverride: resolvedSystemPrompt };
     } catch (err) {
       logger2.warn(`[AgentComponent._run] Failed to load cacheSnapshot: ${err}`);
       return { snapshot: null, systemPromptOverride: undefined };
     }
   }
-  async _isMemorySnapshotStale(snapshot) {
-    const stat = snapshot.memoryStat;
-    if (!stat || typeof stat !== "object") {
-      return "no-memoryStat (legacy snapshot)";
-    }
-    const current = await this._collectMemoryStat();
-    if (current.globalMtime !== stat.globalMtime) {
-      return `global memory.md mtime changed (${stat.globalMtime} -> ${current.globalMtime})`;
-    }
-    if (current.projectMtime !== stat.projectMtime) {
-      return `project memory.md mtime changed (${stat.projectMtime} -> ${current.projectMtime})`;
-    }
-    return null;
-  }
-  async _collectMemoryStat() {
-    const empty = { globalMtime: 0, projectMtime: 0 };
-    try {
-      const memoryComponent = this.env?.getComponent?.("memory");
-      if (!memoryComponent?.getMemoryPaths || !memoryComponent.getMemoryFile) {
-        return empty;
-      }
-      const memoryFile = memoryComponent.getMemoryFile();
-      const paths = memoryComponent.getMemoryPaths();
-      const result = { globalMtime: 0, projectMtime: 0 };
-      for (const p of paths) {
-        const filePath = path.join(p.path, memoryFile);
-        try {
-          const st = await fs.stat(filePath);
-          if (p.type === "global") {
-            result.globalMtime = st.mtimeMs;
-          } else if (p.type === "project") {
-            result.projectMtime = st.mtimeMs;
-          }
-        } catch {}
-      }
-      return result;
-    } catch {
-      return empty;
-    }
-  }
   async _fallbackReplaceMemory(systemPrompt) {
     if (!systemPrompt.includes("{{memory}}"))
       return systemPrompt;
@@ -1991,7 +1936,8 @@ class AgentComponent extends BaseComponent {
           ...ctx._runId ? { runId: ctx._runId } : {},
           ...ctx.context.sessionId ? { sessionId: ctx.context.sessionId } : {},
           ...ctx.context.agentType ? { agentType: ctx.context.agentType } : {},
-          ...ctx.agent?.name ? { agentName: ctx.agent.name } : {}
+          ...ctx.agent?.name ? { agentName: ctx.agent.name } : {},
+          ...ctx.context.extendTools?.length ? { extendTools: ctx.context.extendTools } : {}
         }
       };
       const request = {

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

@@ -4,7 +4,7 @@ import {
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger

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

@@ -8,7 +8,7 @@ import {
 } from "./roy-agent-core-qxnbvgwe.js";
 import {
   BaseComponent
-} from "./roy-agent-core-pgvcf91v.js";
+} from "./roy-agent-core-m39v7qpx.js";
 import {
   __require
 } from "./roy-agent-core-fs0mn2jk.js";

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

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

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

@@ -1,6 +1,6 @@
 import {
   init_sqlite_task_store
-} from "./roy-agent-core-ezvpreqz.js";
+} from "./roy-agent-core-6k8mb7zx.js";
 
 // src/env/task/storage/index.ts
 init_sqlite_task_store();

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

@@ -7,7 +7,8 @@ var BUILT_IN_EVENT_SOURCE_TYPES = {
   LARK_CLI: "lark-cli",
   TIMER: "timer",
   BOUNTY_IM: "bounty-im",
-  CLI_COMMAND: "cli-command"
+  CLI_COMMAND: "cli-command",
+  WECOM_CLI: "wecom-cli"
 };
 var BUILT_IN_EVENT_SOURCE_TYPE_LIST = Object.values(BUILT_IN_EVENT_SOURCE_TYPES);
 var defaultLarkCliRunner = {
@@ -60,6 +61,8 @@ function getDefaultConfigForType(type) {
   switch (type) {
     case BUILT_IN_EVENT_SOURCE_TYPES.LARK_CLI:
       return { command: "lark-cli event consume im.message.receive_v1 --as bot" };
+    case BUILT_IN_EVENT_SOURCE_TYPES.WECOM_CLI:
+      return { command: "wecom-cli event consume" };
     default:
       return {};
   }

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

@@ -2,10 +2,10 @@ import {
   WorkflowRepository,
   migrateEmptyTagsToDefault,
   rowToWorkflow
-} from "./roy-agent-core-r5wt1h3c.js";
-import"./roy-agent-core-mcy5apay.js";
+} from "./roy-agent-core-4fkxy2gv.js";
+import"./roy-agent-core-vf9sp6s3.js";
 import"./roy-agent-core-rvxg1wps.js";
-import"./roy-agent-core-qq96p0tj.js";
+import"./roy-agent-core-5s2t8z00.js";
 import"./roy-agent-core-7f7t9wwp.js";
 import"./roy-agent-core-85xyctnb.js";
 import"./roy-agent-core-fs0mn2jk.js";

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

@@ -9,7 +9,7 @@ import {
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger

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

@@ -1,21 +1,21 @@
 import {
   LarkCardPatchNotifier,
   formatDurationMs
-} from "./roy-agent-core-w0qjeq2v.js";
+} from "./roy-agent-core-shb1qsyg.js";
 import {
   WorkflowHookPoints,
   init_workflow_hook_points
-} from "./roy-agent-core-c2gbt68e.js";
+} from "./roy-agent-core-h83zdsrq.js";
 import {
   init_context
-} from "./roy-agent-core-qqaak24r.js";
+} from "./roy-agent-core-tkpp1ba0.js";
 import {
   getEnvContextOrEmpty
-} from "./roy-agent-core-7cbpmk4q.js";
+} from "./roy-agent-core-p31ftgq9.js";
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger

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

@@ -0,0 +1,56 @@
+// src/env/tool/validator.ts
+import { ZodError } from "zod";
+var REASON_REQUIRED_CONFIG_KEY = "tool.reason.required";
+var moduleLevelReasonRequired = true;
+var configComponentRef = null;
+function setToolReasonConfigComponent(component) {
+  configComponentRef = component;
+}
+function isToolReasonRequired() {
+  if (configComponentRef) {
+    const v = configComponentRef.get(REASON_REQUIRED_CONFIG_KEY);
+    if (typeof v === "boolean")
+      return v;
+    if (typeof v === "string")
+      return v !== "false";
+  }
+  return moduleLevelReasonRequired;
+}
+
+class ToolValidator {
+  async validate(tool, args) {
+    if (isToolReasonRequired()) {
+      const reason = args?.["reason"];
+      if (typeof reason !== "string" || reason.trim() === "") {
+        return {
+          success: false,
+          error: `Missing or empty required parameter 'reason' for tool '${tool.name}': ` + `provide a one-sentence explanation of why you are calling this tool.`
+        };
+      }
+    }
+    try {
+      const parsed = await tool.parameters.parseAsync(args);
+      return {
+        success: true,
+        data: parsed
+      };
+    } catch (error) {
+      if (error instanceof ZodError) {
+        const errorMessage = tool.formatValidationError ? tool.formatValidationError(error) : this.formatError(error);
+        return {
+          success: false,
+          error: `Invalid arguments for tool '${tool.name}': ${errorMessage}`
+        };
+      }
+      return {
+        success: false,
+        error: `Validation error: ${error}`
+      };
+    }
+  }
+  formatError(error) {
+    return error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join("; ");
+  }
+}
+
+export { setToolReasonConfigComponent, isToolReasonRequired, ToolValidator };

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

@@ -1,6 +1,6 @@
 import {
   safeParseToolArgs
-} from "./roy-agent-core-fghc2m8z.js";
+} from "./roy-agent-core-aa8kv18f.js";
 
 // src/env/session/session-message-converter.ts
 import { randomUUID } from "crypto";

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

@@ -439,7 +439,7 @@ subSessionId: sub-session-xyz
 | session 规模 | 建议处置 |
 |---|---|
 | **小**（超限比例 < 30%，消息数不多） | 直接 \`compact_session\` → 压缩成功后用 \`sub_session_id\` 续跑 |
-| **大**（超限比例很高 / 消息数很多） | \`compact_session\` **可能要跑很久甚至撞 120s 工具超时** → **不要在同一个 session 上死磕**，直接**开新 session** + 明确列出「已完成项 / 断点 / 小目标」 |
+| **大**（超限比例很高 / 消息数很多） | \`compact_session\` **可能要跑很久甚至撞 120s 工具超时** → **不要在同一个 session 上死磕**，走下面的**兜底路径**（压缩复查 → 仍无效才开新 session）+ 明确列出「已完成项 / 断点 / 小目标」 |
 
 **为什么必须先评估**（实测数据）：
 
@@ -474,7 +474,7 @@ const r = await compact_session({ session_id: "sub-session-xyz" });
 2. **再检查一次**该 session 的**消息数 / checkpoint** —— \`compact_session\` 成功会返回 \`checkpointId\`，也可以用 session 相关工具确认消息是否已被 archived
 3. 再决定走哪条路：
    - **压缩其实成功了** → 用 \`sub_session_id\` 续跑（上下文已经变小，安全）
-   - **压缩确实没生效** → 才走下面的「开新 session」路径
+   - **压缩确实没生效** → 才走下面的兜底路径（换新 session）
 
 **第 3 步：带同一个 \`sub_session_id\` 续跑**
 
@@ -502,9 +502,9 @@ delegate_task({
 
 \`\`\`typescript
 delegate_task({
-  description: "接续工作（上下文已超限，改用新 session）",
+  description: "接续工作（上下文已超限，压缩复查后仍不可救，换新 session）",
   prompt: "【已完成】... \\n【断点】... \\n【小目标】... \\n【相关文件路径】... \\n【已知结论】...",
-  // 不传 sub_session_id —— 开新 session
+  sub_session_id: "sub-session-xyz",  // ⚠️ 兜底路径：仅在 compact_session 也无效时才省略
 });
 \`\`\`
 
@@ -512,9 +512,9 @@ delegate_task({
 
 #### ❌ 反模式警示
 
-- ❌ **不要从头重新委托**（不传 \`sub_session_id\` 直接 \`delegate_task\`）—— 丢掉全部上下文，前面的调研和代码全白做，还可能重复踩已解决过的坑。
-- ❌ **不要在压缩失败时反复用同一个 session 续跑** —— 同样的超限会再发生一次，徒增 token 消耗。压缩失败就走"开新 session + 明确列出已完成项/断点/小目标"的兜底路径。
-- ❌ **不要在 session 规模很大时死磕 \`compact_session\`** —— 先按第 0 步评估，message 数很多就直接开新 session。
+- ❌ **不要从头重新委托** —— 不传 \`sub_session_id\` 直接 \`delegate_task\` 是**最后手段**，只在旧 session 上下文已确认不可救（compact_session 后仍超限 / 迭代上限且无可复用断点）时才允许。其余情况一律带 \`sub_session_id\` 续跑（不传才会丢掉全部上下文，前面的调研和代码全白做，还可能重复踩已解决过的坑）。
+- ❌ **不要在压缩失败时反复用同一个 session 续跑** —— 同样的超限会再发生一次，徒增 token 消耗。压缩失败就走"换新 session（不传 \`sub_session_id\`）+ 明确列出已完成项/断点/小目标"的兜底路径。
+- ❌ **不要在 session 规模很大时死磕 \`compact_session\`** —— 先按第 0 步评估，message 数很多就走兜底路径（压缩复查 → 仍无效才换新 session）。
 - ❌ **不要用 \`compact_session\` 压缩当前会话自己** —— 工具会直接拒绝（自毁）。
 - ❌ **不要压缩还在 running/pending 的后台任务** —— 先 \`stop_task\`。
 

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

@@ -1,9 +1,9 @@
 import {
   init_context
-} from "./roy-agent-core-qqaak24r.js";
+} from "./roy-agent-core-tkpp1ba0.js";
 import {
   getEnvContext
-} from "./roy-agent-core-7cbpmk4q.js";
+} from "./roy-agent-core-p31ftgq9.js";
 import {
   __esm
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -1,13 +1,13 @@
 import {
   AgentComponentAdapter,
   init_agent_component_adapter
-} from "./roy-agent-core-dqxec05w.js";
+} from "./roy-agent-core-bjtc9d35.js";
 import"./roy-agent-core-1db4vpc6.js";
 import"./roy-agent-core-mkc3zshb.js";
-import"./roy-agent-core-cpcd24n2.js";
-import"./roy-agent-core-qqaak24r.js";
-import"./roy-agent-core-7cbpmk4q.js";
-import"./roy-agent-core-qq96p0tj.js";
+import"./roy-agent-core-yet36q5k.js";
+import"./roy-agent-core-tkpp1ba0.js";
+import"./roy-agent-core-p31ftgq9.js";
+import"./roy-agent-core-5s2t8z00.js";
 import"./roy-agent-core-7f7t9wwp.js";
 import"./roy-agent-core-85xyctnb.js";
 import"./roy-agent-core-fs0mn2jk.js";

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

@@ -1,16 +1,22 @@
 import {
   builtInHandlers
-} from "./roy-agent-core-3gpygqcx.js";
+} from "./roy-agent-core-gr5h1dyr.js";
+import {
+  appendAuditLog,
+  checkSourceCountDrop,
+  readSourceCountFromDisk,
+  snapshotConfigDir
+} from "./roy-agent-core-2stt4rp5.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-pgvcf91v.js";
+} from "./roy-agent-core-m39v7qpx.js";
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger
@@ -57,6 +63,23 @@ class EventSourceComponent extends BaseComponent {
   buffers = new Map;
   configPath = "";
   persistenceEnabled = true;
+  constructor() {
+    super();
+    this.applyTestEnvironmentGuard();
+  }
+  static isTestEnvironment() {
+    return "BUN_TEST_WORKER_ID" in process.env;
+  }
+  applyTestEnvironmentGuard() {
+    if (this.persistenceEnabled && EventSourceComponent.isTestEnvironment()) {
+      if (process.env.ROY_AGENT_ES_PERSISTENCE === "1") {
+        logger.debug("EventSource persistence opt-out active in test env (ROY_AGENT_ES_PERSISTENCE=1)");
+        return;
+      }
+      this.persistenceEnabled = false;
+      logger.debug("EventSource persistence disabled by test-environment guard (Task #5181)");
+    }
+  }
   configComponent;
   configWatcher;
   async onInit() {
@@ -86,6 +109,7 @@ class EventSourceComponent extends BaseComponent {
     }
     await this.onInit();
     this.setStatus("running");
+    this.applyTestEnvironmentGuard();
   }
   async onStart() {}
   async onStop() {
@@ -116,7 +140,7 @@ class EventSourceComponent extends BaseComponent {
     }
   }
   async executeInitHooks() {
-    const { EventSourceInitHooks } = await import("./roy-agent-core-99nwgj84.js");
+    const { EventSourceInitHooks } = await import("./roy-agent-core-fzw9xzm1.js");
     await EventSourceInitHooks.execute(this);
   }
   registerHandler(handler) {
@@ -365,6 +389,17 @@ class EventSourceComponent extends BaseComponent {
       const eventHandler = this.eventHandlers.get(id) ?? this.createDefaultEventHandler(id, config.type);
       instance.onEvent(eventHandler);
       await instance.start();
+      const instanceStatus = instance.getStatus();
+      if (instanceStatus === "error") {
+        this.statuses.set(id, "error");
+        const reason = instance.getLastError?.() ?? `event source '${config.type}' failed to start`;
+        logger.error(`EventSource degraded to error state: ${id} (${config.type}) — ${reason}`);
+        this.getEnv()?.pushEnvEvent({
+          type: "event-source.error",
+          payload: { sourceId: id, sourceType: config.type, reason }
+        });
+        throw new Error(reason);
+      }
       this.statuses.set(id, "running");
       this.getEnv()?.pushEnvEvent({
         type: "event-source.started",
@@ -420,11 +455,37 @@ class EventSourceComponent extends BaseComponent {
       return;
     try {
       const configPath = this.getConfigFilePath();
+      const configDir = join(configPath, "..");
+      const diskCount = readSourceCountFromDisk(configPath);
+      const newCount = this.sources.size;
+      const dropCheck = checkSourceCountDrop(diskCount, newCount);
+      if (!dropCheck.allowed && process.env.ROY_AGENT_ES_FORCE_SAVE !== "1") {
+        appendAuditLog(configDir, {
+          file: "event-sources.json",
+          action: "drop-blocked",
+          detail: dropCheck.reason
+        });
+        logger.error(`Refusing to save event sources: ${dropCheck.reason}`);
+        throw new Error(`EventSource saveConfig blocked: ${dropCheck.reason}`);
+      }
+      const snapDir = snapshotConfigDir(configDir);
+      if (snapDir) {
+        appendAuditLog(configDir, {
+          file: "event-sources.json",
+          action: "pre-save-snapshot",
+          detail: `snapshot=${snapDir}`
+        });
+      }
       const config = {
         version: "1.0.0",
         sources: Array.from(this.sources.values())
       };
       writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
+      appendAuditLog(configDir, {
+        file: "event-sources.json",
+        action: "save",
+        detail: `${newCount} sources (disk had ${diskCount})`
+      });
       logger.debug(`Saved ${this.sources.size} event source configurations`);
     } catch (error) {
       logger.error("Failed to save event source configurations:", error);