@ai-setting/roy-agent-core 1.6.9 → 1.6.10

package/dist/shared/@ai-setting/{roy-agent-core-brfryc0b.js → roy-agent-core-1gsnq4p2.js}

@@ -1,10 +1,9 @@
+import {
+  EnvSource
+} from "./roy-agent-core-y3g3ar7a.js";
 import {
   XDG_PATHS
 } from "./roy-agent-core-qxnbvgwe.js";
-import {
-  fromEnvKey,
-  toEnvKey
-} from "./roy-agent-core-qxhq8ven.js";
 import {
   BaseComponent
 } from "./roy-agent-core-j62bjagf.js";
@@ -426,197 +425,6 @@ class FileSource {
   }
 }
 
-// src/config/env-source.ts
-class EnvSource {
-  name = "env";
-  priority = 20;
-  prefix;
-  transform;
-  pollInterval;
-  watchers = new Set;
-  pollTimer;
-  lastValues = new Map;
-  watchEnabled = true;
-  constructor(options = {}) {
-    this.prefix = options.prefix ?? "";
-    this.transform = options.transform;
-    this.pollInterval = options.pollInterval;
-    this.watchEnabled = options.watch ?? true;
-  }
-  getEnvKey(key) {
-    return toEnvKey(key, this.prefix);
-  }
-  getInternalKey(envKey) {
-    return fromEnvKey(envKey, this.prefix);
-  }
-  read(key) {
-    const envKey = this.getEnvKey(key);
-    const value = process.env[envKey];
-    if (value === undefined) {
-      return;
-    }
-    if (this.transform) {
-      return this.transform(value, key);
-    }
-    return value;
-  }
-  write(key, value) {
-    const envKey = this.getEnvKey(key);
-    const oldValue = process.env[envKey];
-    const stringValue = String(value);
-    process.env[envKey] = stringValue;
-    const event = {
-      type: oldValue === undefined ? "add" : "change",
-      key,
-      oldValue: oldValue !== undefined ? this.transformValue(oldValue, key) : undefined,
-      newValue: this.transformValue(stringValue, key),
-      source: this.name,
-      timestamp: Date.now()
-    };
-    this.notifyWatchers(event);
-    return true;
-  }
-  delete(key) {
-    const envKey = this.getEnvKey(key);
-    const oldValue = process.env[envKey];
-    if (oldValue === undefined) {
-      return false;
-    }
-    delete process.env[envKey];
-    const event = {
-      type: "delete",
-      key,
-      oldValue: this.transformValue(oldValue, key),
-      newValue: undefined,
-      source: this.name,
-      timestamp: Date.now()
-    };
-    this.notifyWatchers(event);
-    return true;
-  }
-  list() {
-    const result = [];
-    const prefix = this.prefix.toUpperCase();
-    for (const envKey of Object.keys(process.env)) {
-      if (prefix && !envKey.startsWith(prefix)) {
-        continue;
-      }
-      const key = this.getInternalKey(envKey);
-      const value = process.env[envKey];
-      if (value !== undefined) {
-        result.push({
-          key,
-          value: this.transformValue(value, key)
-        });
-      }
-    }
-    return result;
-  }
-  watch(callback) {
-    this.watchers.add(callback);
-    if (!this.watchEnabled) {
-      return () => {
-        this.watchers.delete(callback);
-      };
-    }
-    this.ensurePolling();
-    this.recordCurrentValues();
-    return () => {
-      this.watchers.delete(callback);
-      if (this.watchers.size === 0) {
-        this.stopPolling();
-      }
-    };
-  }
-  ensurePolling() {
-    if (this.pollTimer !== undefined) {
-      return;
-    }
-    const interval = this.pollInterval ?? 1000;
-    this.pollTimer = setInterval(() => {
-      this.checkForChanges();
-    }, interval);
-  }
-  stopPolling() {
-    if (this.pollTimer) {
-      clearInterval(this.pollTimer);
-      this.pollTimer = undefined;
-    }
-  }
-  recordCurrentValues() {
-    this.lastValues.clear();
-    const entries = this.list();
-    for (const entry of entries) {
-      const envKey = this.getEnvKey(entry.key);
-      const value = process.env[envKey];
-      if (value !== undefined) {
-        this.lastValues.set(envKey, value);
-      }
-    }
-  }
-  checkForChanges() {
-    const currentEntries = this.list();
-    const currentValues = new Map;
-    for (const entry of currentEntries) {
-      const envKey = this.getEnvKey(entry.key);
-      const value = process.env[envKey];
-      if (value !== undefined) {
-        currentValues.set(envKey, value);
-      }
-    }
-    for (const [envKey, oldValue] of this.lastValues.entries()) {
-      if (!currentValues.has(envKey)) {
-        const key = this.getInternalKey(envKey);
-        this.notifyWatchers({
-          type: "delete",
-          key,
-          oldValue: this.transformValue(oldValue, key),
-          newValue: undefined,
-          source: this.name,
-          timestamp: Date.now()
-        });
-      }
-    }
-    for (const [envKey, newValue] of currentValues.entries()) {
-      const key = this.getInternalKey(envKey);
-      const oldValue = this.lastValues.get(envKey);
-      if (oldValue === undefined) {
-        this.notifyWatchers({
-          type: "add",
-          key,
-          oldValue: undefined,
-          newValue: this.transformValue(newValue, key),
-          source: this.name,
-          timestamp: Date.now()
-        });
-      } else if (oldValue !== newValue) {
-        this.notifyWatchers({
-          type: "change",
-          key,
-          oldValue: this.transformValue(oldValue, key),
-          newValue: this.transformValue(newValue, key),
-          source: this.name,
-          timestamp: Date.now()
-        });
-      }
-    }
-    this.lastValues = currentValues;
-  }
-  transformValue(value, key) {
-    if (this.transform) {
-      return this.transform(value, key);
-    }
-    return value;
-  }
-  notifyWatchers(event) {
-    this.watchers.forEach((cb) => cb(event));
-  }
-  close() {
-    this.stopPolling();
-    this.watchers.clear();
-  }
-}
-
 // src/config/protocol-resolver.ts
 var PROTOCOL_PATTERN = /^\$\{([^:]+):\/\/([^:#]+)(?:#([^:-]+))?(?::-(.*))?\}$/;
 
@@ -1246,4 +1054,4 @@ class ConfigComponent extends BaseComponent {
   }
 }
 
-export { parseJSONC, substituteEnvVars, parseJSONCWithEnv, substituteProtocolRefs, parseJSONCWithProtocols, FileSource, EnvSource, ConfigSourceNotFoundError, ConfigFileNotFoundError, MemorySource, ConfigComponent };
+export { parseJSONC, substituteEnvVars, parseJSONCWithEnv, substituteProtocolRefs, parseJSONCWithProtocols, FileSource, ConfigSourceNotFoundError, ConfigFileNotFoundError, MemorySource, ConfigComponent };

package/dist/shared/@ai-setting/{roy-agent-core-qdgaghhw.js → roy-agent-core-2ek596yd.js}

@@ -4,7 +4,7 @@ import {
 } from "./roy-agent-core-y5ymc4f8.js";
 import {
   envKeyToConfigKey
-} from "./roy-agent-core-qxhq8ven.js";
+} from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
 } from "./roy-agent-core-j62bjagf.js";
@@ -616,6 +616,50 @@ function matchEventType(eventType, patterns) {
   }
   return false;
 }
+function buildLarkRecommendedAction(opts) {
+  const { profile, chatType, appId, chatId, messageId } = opts;
+  const profileFlag = profile ? `--profile ${profile} ` : "";
+  const profileWarn = profile ? `（⚠️ 必须用 profile="${profile}" 调 lark-cli；openId per-app 隔离，换 profile 会失败）` : "";
+  const isGroup = chatType === "group";
+  const scopeHint = isGroup ? '群聊消息；回复到 replyTo.chatId。如需 @mention 发件人，请在 Markdown 正文开头加 <at user_id="<senderId>"/>' : "p2p 私聊消息；回复到 replyTo.chatId";
+  const scopeWord = isGroup ? "群聊" : "p2p 私聊";
+  const action = [
+    `处理飞书 ${scopeWord}消息并以机器人身份回复${profileWarn}。`,
+    `scope: ${scopeHint}。`,
+    ``,
+    `## 安全传 Markdown（必读，避免飞书收到字面 $ 和字面反斜杠+n）`,
+    `多行 / 复杂 Markdown 必须先写入临时 .md 文件，再 cat 出来当 --markdown 的值。`,
+    `原因：agent 工具调用层不做 shell 展开。`,
+    ``,
+    `推荐调用模板（4 步缺一不可，照抄）:`,
+    `  reply_file="$(mktemp /tmp/lark-reply.XXXXXX.md)"   # 1. 唯一文件名（避免并发覆盖）`,
+    `  trap 'rm -f "$reply_file"' EXIT                   # 2. 注册退出清理（无论成败都删，避免 /tmp 累积）`,
+    `  cat > "$reply_file" <<'LARK_REPLY_EOF'            # 3. 写入 Markdown（heredoc 单引号防 shell 展开）`,
+    `  ...（这里是回复的 Markdown 内容，可以多行 / 含特殊字符）`,
+    `  LARK_REPLY_EOF`,
+    `  lark-cli ${profileFlag}im +messages-reply --message-id <取自 replyTo.messageId> --as bot --markdown "$(cat "$reply_file")"   # 4. 真正调用`,
+    ``,
+    `## 禁止（用 words 描述，避免被 LLM 当字面 trap 抄）`,
+    `- 禁止把多行 Markdown 直接拼进 --markdown 参数`,
+    `- 禁止 bash ANSI-C 引号语法（特征：dollar 符号紧跟单引号的引号形式）`,
+    `- 禁止字面反斜杠+n（即 \\n 两个字符，不是 0x0A 控制字符）`,
+    `- 禁止 stdin 形式传 Markdown（--markdown 后接一个短横线作为值的写法）`,
+    `- 禁止 at-file 形式传 Markdown（--markdown 后接 @ 符号加文件名的写法）`,
+    ``,
+    `## 必须使用 replyTo 里给定的值`,
+    `profile / chatId / messageId / --as bot 必须原样取自 recommendedAction.replyTo；不要凭印象自己拼接。`
+  ].join(`
+`);
+  return {
+    action,
+    replyTo: {
+      appId,
+      profile,
+      chatId,
+      messageId
+    }
+  };
+}
 function extractMetadata(rawEvent, eventType) {
   const event = rawEvent;
   const metadata = {};
@@ -654,17 +698,13 @@ function extractMetadata(rawEvent, eventType) {
   let recommendedAction;
   if (eventType === "im.message.receive_v1" || event.type === "im.message.receive_v1") {
     const profile2 = event.profile;
-    const profileFlag = profile2 ? `--profile ${profile2} ` : "";
-    const profileHint = profile2 ? `（⚠️ 必须使用 profile="${profile2}" 调用 lark-cli，否则会因 openId 跨 app 失败）` : "";
-    recommendedAction = {
-      action: `处理飞书消息并以机器人身份回复${profileHint}，例如：lark-cli ${profileFlag}im +messages-reply --message-id "xxxxid" --as bot --markdown "Markdown 格式回复内容"`,
-      replyTo: {
-        appId: metadata.appId,
-        profile: profile2,
-        chatId: metadata.chatId,
-        messageId: metadata.messageId
-      }
-    };
+    recommendedAction = buildLarkRecommendedAction({
+      profile: profile2,
+      chatType: metadata.chatType,
+      appId: metadata.appId,
+      chatId: metadata.chatId,
+      messageId: metadata.messageId
+    });
   }
   const profile = event.profile;
   const replyChannel = {

package/dist/shared/@ai-setting/{roy-agent-core-tbn8cerp.js → roy-agent-core-2yavqjsh.js}

@@ -3,7 +3,7 @@ import {
 } from "./roy-agent-core-g1s2h0e5.js";
 import {
   envKeyToConfigKey
-} from "./roy-agent-core-qxhq8ven.js";
+} from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
 } from "./roy-agent-core-j62bjagf.js";

package/dist/shared/@ai-setting/{roy-agent-core-7rsfynhz.js → roy-agent-core-38kbfarg.js}

@@ -7,7 +7,7 @@ import {
 import {
   envKeyToConfigKey,
   toEnvKey
-} from "./roy-agent-core-qxhq8ven.js";
+} from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
 } from "./roy-agent-core-j62bjagf.js";

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

@@ -1,7 +1,7 @@
 import {
   envKeyToConfigKey,
   toEnvKey
-} from "./roy-agent-core-qxhq8ven.js";
+} from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
 } from "./roy-agent-core-j62bjagf.js";

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

@@ -6,7 +6,7 @@ import {
   WorkflowEngine,
   exports_engine,
   init_engine
-} from "./roy-agent-core-062gyaz8.js";
+} from "./roy-agent-core-0n2a8cbn.js";
 import {
   askUserTool,
   createRunWorkflowTool,
@@ -18,7 +18,7 @@ import {
   createWorkflowSearchTool,
   createWorkflowTagListTool,
   createWorkflowValidateTool
-} from "./roy-agent-core-qyarxwzg.js";
+} from "./roy-agent-core-g9p7e2ys.js";
 import {
   WorkflowService
 } from "./roy-agent-core-p2vpsd1d.js";
@@ -141,7 +141,7 @@ class WorkflowComponent extends BaseComponent {
     if (!agentRunner && this._workflowEnv) {
       const agentComponent = this._workflowEnv.getComponent("agent");
       if (agentComponent) {
-        const { AgentComponentAdapter } = await import("./roy-agent-core-w1e55apa.js");
+        const { AgentComponentAdapter } = await import("./roy-agent-core-z7f8hyv7.js");
         agentRunner = new AgentComponentAdapter(agentComponent, {}, this.sessionComponent);
       }
     }

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

@@ -3,6 +3,11 @@ function toEnvKey(key, prefix) {
   let keyNormalized = key.replace(/[.-]/g, "_");
   keyNormalized = keyNormalized.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/_+/g, "_").toUpperCase();
   if (prefix) {
+    const prefixCore = prefix.toUpperCase().replace(/^_+|_+$/g, "");
+    const prefixCoreWithSep = `${prefixCore}_`;
+    if (prefixCore && keyNormalized.startsWith(prefixCoreWithSep)) {
+      return keyNormalized;
+    }
     const separator = prefix.endsWith("_") ? "" : "_";
     return `${prefix}${separator}${keyNormalized}`;
   }

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

@@ -1,3 +1,6 @@
+import {
+  EnvSource
+} from "./roy-agent-core-y3g3ar7a.js";
 import {
   invoke
 } from "./roy-agent-core-dcd1s7ct.js";
@@ -8,7 +11,7 @@ import {
 import {
   envKeyToConfigKey,
   toEnvKey
-} from "./roy-agent-core-qxhq8ven.js";
+} from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
 } from "./roy-agent-core-j62bjagf.js";
@@ -541,12 +544,42 @@ class LLMComponent extends BaseComponent {
         await configComponent.set(configKey, value);
       }
     }
+    if (envSource instanceof EnvSource) {
+      const knownKeys = new Set([
+        "llm.defaultModel",
+        "llm.defaultProvider",
+        "llm.temperature",
+        "llm.maxTokens",
+        "llm.topP",
+        "llm.stream",
+        "llm.options",
+        "llm.default",
+        "llm.providers",
+        "llm.limits",
+        "llm.capabilities"
+      ]);
+      envSource.validateUnrecognizedEnvVars({
+        componentName: "llm",
+        knownKeys,
+        logger: {
+          warn: (msg) => logger.warn(msg)
+        }
+      });
+    }
     if (config) {
       const flatConfig = this.flattenConfig(config);
       for (const [key, value] of Object.entries(flatConfig)) {
         await configComponent.set(key, value);
       }
     }
+    const configuredProviders = configComponent.get("llm.providers");
+    const configuredDefaultProvider = configComponent.get("llm.defaultProvider");
+    if (typeof configuredDefaultProvider === "string" && configuredProviders && typeof configuredProviders === "object" && Object.keys(configuredProviders).length > 0) {
+      const providerKeys = Object.keys(configuredProviders);
+      if (!providerKeys.includes(configuredDefaultProvider)) {
+        throw new Error(`[LLM] Invalid llm.defaultProvider: "${configuredDefaultProvider}". ` + `Known providers: ${providerKeys.join(", ")}. ` + `Add it to llm.providers first, or remove the env var / config entry.`);
+      }
+    }
     this.registerConfigWatcher(configComponent);
   }
   flattenConfig(obj, prefix = "llm") {

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

@@ -14,7 +14,7 @@ import {
 } from "./roy-agent-core-c1v263jn.js";
 import {
   isValidSessionId
-} from "./roy-agent-core-jmzz2yxs.js";
+} from "./roy-agent-core-nw39k111.js";
 import {
   TracedAs,
   init_decorator

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

@@ -68,6 +68,46 @@ function registerWorkflowJsonOutputPlugin(options = undefined) {
   });
   logger.info("Workflow JSON output plugin registered on agent:after.react");
 }
+function readProviderReasoning(source) {
+  if (!source)
+    return;
+  const configComponent = source.configComponent;
+  if (!configComponent)
+    return;
+  const isConfigError = (e) => e instanceof Error && (e.name === "ConfigValidationError" || e.name === "ConfigError");
+  let providerId;
+  try {
+    providerId = configComponent.get("llm.defaultProvider");
+  } catch (e) {
+    if (isConfigError(e))
+      return;
+    throw e;
+  }
+  if (!providerId)
+    return;
+  let capabilities;
+  try {
+    const capKey = `llm.providers.${providerId}.capabilities`;
+    capabilities = configComponent.get(capKey);
+  } catch (e) {
+    if (isConfigError(e))
+      return;
+    throw e;
+  }
+  return { providerId, reasoning: capabilities?.reasoning === true };
+}
+function resolveProviderToolChoice(source) {
+  const ctx = readProviderReasoning(source);
+  if (!ctx)
+    return "required";
+  if (FIRST_PARTY_PROVIDERS.has(ctx.providerId)) {
+    return "required";
+  }
+  if (ctx.reasoning) {
+    return "auto";
+  }
+  return "required";
+}
 async function runWorkflowJsonOutputExtraction(hookCtx) {
   const schema = hookCtx.context.metadata?.outputSchema;
   if (!schema) {
@@ -113,11 +153,13 @@ async function runWorkflowJsonOutputExtraction(hookCtx) {
       content: userQuery
     }
   ];
+  const resolvedToolChoice = resolveProviderToolChoice(agentComponentRef);
   const extractContext = {
     messages: messagesOverride,
     extraTools: [submitToolAsExtra],
     persistSession: false,
-    abort: hookCtx.context.abort
+    abort: hookCtx.context.abort,
+    toolChoice: resolvedToolChoice
   };
   try {
     const result = await agentComponentRef.run("json-extract", "", extractContext);
@@ -134,7 +176,7 @@ async function runWorkflowJsonOutputExtraction(hookCtx) {
     logger.error(`Workflow JSON extraction: json-extract sub-agent threw: ${error instanceof Error ? error.message : String(error)}`);
   }
 }
-var logger, WORKFLOW_JSON_OUTPUT_SOURCE_ID = "workflow", WORKFLOW_JSON_OUTPUT_PLUGIN_NAME = "json-output", WORKFLOW_JSON_OUTPUT_PLUGIN_KEY, HOOK_POINT = "agent:after.react", HOOK_NAME, registered = false, agentComponentRef = null, tracedRunWorkflowJsonOutputExtraction;
+var logger, WORKFLOW_JSON_OUTPUT_SOURCE_ID = "workflow", WORKFLOW_JSON_OUTPUT_PLUGIN_NAME = "json-output", WORKFLOW_JSON_OUTPUT_PLUGIN_KEY, HOOK_POINT = "agent:after.react", HOOK_NAME, registered = false, agentComponentRef = null, FIRST_PARTY_PROVIDERS, tracedRunWorkflowJsonOutputExtraction;
 var init_workflow_json_output_plugin = __esm(() => {
   init_global_hook_manager();
   init_workflow_hil();
@@ -144,6 +186,7 @@ var init_workflow_json_output_plugin = __esm(() => {
   logger = createLogger("WorkflowJsonOutputPlugin");
   WORKFLOW_JSON_OUTPUT_PLUGIN_KEY = `${WORKFLOW_JSON_OUTPUT_SOURCE_ID}:${WORKFLOW_JSON_OUTPUT_PLUGIN_NAME}`;
   HOOK_NAME = `${WORKFLOW_JSON_OUTPUT_PLUGIN_NAME}:${HOOK_POINT}`;
+  FIRST_PARTY_PROVIDERS = new Set(["openai", "anthropic", "google"]);
   tracedRunWorkflowJsonOutputExtraction = wrapFunction(runWorkflowJsonOutputExtraction, "workflow.json_output.extraction", { recordParams: true, recordResult: true, log: true });
 });
 

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

@@ -3,7 +3,7 @@ import {
 } from "./roy-agent-core-dcd1s7ct.js";
 import {
   truncateOutputInline
-} from "./roy-agent-core-sk4xg1dw.js";
+} from "./roy-agent-core-zs31w092.js";
 import {
   AskUserError,
   init_workflow_hil
@@ -22,7 +22,7 @@ import {
 } from "./roy-agent-core-8x4ngxcy.js";
 import {
   envKeyToConfigKey
-} from "./roy-agent-core-qxhq8ven.js";
+} from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
 } from "./roy-agent-core-j62bjagf.js";
@@ -628,6 +628,22 @@ class AgentComponent extends BaseComponent {
     hookCtx.messages.push(message);
     this.notifyMessageAdded(message);
   }
+  consumeMetaProtocolUserMessage(hookCtx) {
+    const toolResultMeta = hookCtx.toolResult?.result?.metadata;
+    if (!toolResultMeta || !("toAddFakeUserMessage" in toolResultMeta)) {
+      return;
+    }
+    const userMsg = toolResultMeta.toAddFakeUserMessage;
+    delete toolResultMeta.toAddFakeUserMessage;
+    if (!userMsg || userMsg.role !== "user") {
+      return;
+    }
+    return userMsg;
+  }
+  flushPendingFakeUserMessage(hookCtx, pendingMsg, iter) {
+    this.pushMessage(hookCtx, pendingMsg);
+    logger.debug(`[ReAct] Meta-protocol: flushed user message AFTER all tool-results (iter=${iter})`);
+  }
   async _run(agentName, query, context) {
     await this.refreshDependencies();
     const agent = this.getAgent(agentName);
@@ -866,6 +882,7 @@ class AgentComponent extends BaseComponent {
             });
             iterAllToolCalls = llmOutput.toolCalls ?? [];
             iterProcessedCount = 0;
+            let pendingFakeUserMessage;
             for (const toolCall of iterAllToolCalls) {
               if (this.aborted.get(runId) || effectiveContext.abort?.aborted) {
                 hookCtx._stopped = true;
@@ -918,19 +935,18 @@ class AgentComponent extends BaseComponent {
                 }]
               });
               {
-                const toolResultMeta = hookCtx.toolResult?.result?.metadata;
-                if (toolResultMeta && "toAddFakeUserMessage" in toolResultMeta) {
-                  const userMsg = toolResultMeta.toAddFakeUserMessage;
-                  if (userMsg && userMsg.role === "user") {
-                    this.pushMessage(hookCtx, userMsg);
-                    logger.debug(`[ReAct] Meta-protocol: appended user message after tool result (tool=${toolResult.name}, iter=${iteration})`);
-                    delete toolResultMeta.toAddFakeUserMessage;
-                  }
+                const captured = this.consumeMetaProtocolUserMessage(hookCtx);
+                if (captured) {
+                  pendingFakeUserMessage = captured;
+                  logger.debug(`[ReAct] Meta-protocol: captured user message (tool=${toolResult.name}, iter=${iteration}); will flush after loop`);
                 }
               }
               result.toolCalls.push(hookCtx.currentToolCall);
               iterProcessedCount++;
             }
+            if (pendingFakeUserMessage) {
+              this.flushPendingFakeUserMessage(hookCtx, pendingFakeUserMessage, iteration);
+            }
             await this.executePluginHooks(agent, "agent:on.iteration", hookCtx);
           }
         } catch (error) {
@@ -1499,6 +1515,12 @@ __legacyDecorateClassTS([
 __legacyDecorateClassTS([
   TracedAs("agent.component.resolveSystemPrompt", { recordParams: true, recordResult: true, log: true })
 ], AgentComponent.prototype, "resolveSystemPrompt", null);
+__legacyDecorateClassTS([
+  TracedAs("agent.meta-protocol.consumeUserMessage", { recordParams: false, recordResult: false, log: true })
+], AgentComponent.prototype, "consumeMetaProtocolUserMessage", null);
+__legacyDecorateClassTS([
+  TracedAs("agent.meta-protocol.flushPendingUserMessage", { recordParams: false, recordResult: false, log: true })
+], AgentComponent.prototype, "flushPendingFakeUserMessage", null);
 __legacyDecorateClassTS([
   TracedAs("agent.component.run", { recordParams: true, recordResult: true, log: true })
 ], AgentComponent.prototype, "_run", null);

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

@@ -9,7 +9,7 @@ import {
 } from "./roy-agent-core-95bbd2jv.js";
 import {
   envKeyToConfigKey
-} from "./roy-agent-core-qxhq8ven.js";
+} from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
 } from "./roy-agent-core-j62bjagf.js";

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

@@ -37,7 +37,7 @@ import {
 } from "./roy-agent-core-1pg0fepg.js";
 import {
   envKeyToConfigKey
-} from "./roy-agent-core-qxhq8ven.js";
+} from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
 } from "./roy-agent-core-j62bjagf.js";

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

@@ -11,7 +11,7 @@ import {
 } from "./roy-agent-core-4w6rgxs4.js";
 import {
   toEnvKey
-} from "./roy-agent-core-qxhq8ven.js";
+} from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
 } from "./roy-agent-core-j62bjagf.js";

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

@@ -3,7 +3,7 @@ import {
 } from "./roy-agent-core-psvxt4c9.js";
 import {
   envKeyToConfigKey
-} from "./roy-agent-core-qxhq8ven.js";
+} from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
 } from "./roy-agent-core-j62bjagf.js";

package/dist/shared/@ai-setting/{roy-agent-core-1qcpvtp8.js → roy-agent-core-xxgazz27.js}

@@ -1,6 +1,6 @@
 import {
   envKeyToConfigKey
-} from "./roy-agent-core-qxhq8ven.js";
+} from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
 } from "./roy-agent-core-j62bjagf.js";