@ai-agent-forge/agent-forge 0.87.0 → 0.88.1

package/dist/core/extensions/bootstrap-agent-loop.js

@@ -1,23 +1,27 @@
 /**
- * Default agent-loop bootstrap executor (W3).
+ * Default agent-loop bootstrap executor (W3; D-082 批 3 拆分登记).
  *
-/**
- * Registers the default main-loop capabilities through the public extension
- * face so the default loop stays a replaceable first-party plugin:
- * - the five default loop-hook links (capability lifecycle dispatch, image
- *   normalization, context strategy, compaction + next-turn refresh, and the
- *   repeated-tool-call guard: shouldStopAfterTurn decision + transformContext
- *   warn-reminder injection), and
- * - the default post-run continuation strategy (the host's own candidate
- *   decision).
+ * Registers the default main-loop event-dispatch links through the public
+ * extension face so the default loop stays a replaceable first-party plugin:
+ * the four default loop-hook links (capability lifecycle dispatch, image
+ * normalization, context strategy, compaction + next-turn refresh).
+ *
+ * D-082 批 3 拆分事实：默认重复工具调用护栏（createRepeatedToolCallStopPolicy
+ * 的 shouldStopAfterTurn 决策链 + transformContext 提醒注入链）与默认
+ * run-loop strategy（decideNextCycle 直通）不消费 {@link AgentLoopWiringV1}，
+ * 已迁出为 `plugins/agent-loop-policy`（插件 id
+ * `agent-forge.plugin.agent-loop-policy`），经 sdk 的 bundled 分发通道装配；
+ * 禁用面为会话装配的 `disabledPluginIds`。本模块保留的四条链是宿主事件分发
+ * 装配（与 bootstrap-lifecycle 同类的内核事件机制接线）：它们消费 wiring 的
+ * 会话闭包成员，无法经插件通道获得，故留宿主内嵌。
  *
  * The default links need session-bound host state (session id, revision,
  * correlation id, error observation, settings). That state is injected as
  * {@link AgentLoopWiringV1} — host wiring, not a plugin capability. Third-party
  * plugins register additional links through `api.registerLoopHook`; they run
- * after the default links in registration order.
+ * after the default links in registration order (the bundled agent-loop-policy
+ * plugin's guard/strategy links land in that same trailing region).
  */
-import { createHash } from "node:crypto";
 import { normalizeToolResultImages } from "../../utils/tool-result-images.js";
 import { t } from "../i18n/index.js";
 import { loadCapabilityPluginSync } from "./capability-plugin.js";
@@ -25,236 +29,14 @@ import { applyCapabilityContextStrategy } from "./context-strategy-binding.js";
 import { TOOL_CALL_EVENT_ID, TOOL_CALL_EVENT_VERSION, TOOL_EXECUTE_EVENT_ID, TOOL_EXECUTE_EVENT_VERSION, TOOL_RESULT_RAW_EVENT_ID, TOOL_RESULT_RAW_EVENT_VERSION, TOOL_RESULT_TRANSFORM_EVENT_ID, TOOL_RESULT_TRANSFORM_EVENT_VERSION, } from "./lifecycle-catalog.js";
 import { detachedSessionSnapshot, EXPERIMENTAL_PUBLIC_API_VERSION, } from "./public-api.js";
 export const BOOTSTRAP_AGENT_LOOP_PLUGIN_ID = "agent-forge.bootstrap-agent-loop";
-export const DEFAULT_RUN_LOOP_STRATEGY_NAME = "default";
-/** 滑动窗口大小：护栏只回看最近 N 个工具调用签名（跨回合累计）。 */
-export const REPEATED_TOOL_CALL_WINDOW_SIZE = 6;
-/** 提醒阈值：窗口尾部连续相同签名达到该次数时提醒模型（不停机，两级响应第一级）。 */
-export const REPEATED_TOOL_CALL_WARN_THRESHOLD = 3;
-/** 停机阈值：提醒后仍连续相同达到该次数才请求停机（两级响应第二级兜底）。 */
-export const REPEATED_TOOL_CALL_STOP_THRESHOLD = 5;
-/** 停机提示消息的 customType（用户可见面，随 agent_end 的 messages 带出）。 */
-export const REPEATED_TOOL_CALL_STOP_CUSTOM_TYPE = "loop_guard_stop";
-/** 提醒消息的 customType（用户可见面经 sendMessage 持久化+渲染；模型面注入复用同一标记）。 */
-export const REPEATED_TOOL_CALL_WARN_CUSTOM_TYPE = "loop_guard_warn";
-/** 提示消息中参数串的最大长度，超出截断（只影响提示文本，不影响检测签名）。 */
-export const REPEATED_TOOL_CALL_NOTICE_MAX_ARGS_CHARS = 200;
-/**
- * 参数稳定字符串化：对象键递归排序后逐层拼接（数组保持顺序），循环引用输出
- * 固定占位。只用于签名比较与提示文本，不是通用 JSON 序列化器。
- */
-export function stableSerializeValue(value, seen = new WeakSet()) {
-    if (value === null)
-        return "null";
-    switch (typeof value) {
-        case "string":
-            return JSON.stringify(value);
-        case "number":
-            return String(value);
-        case "boolean":
-            return String(value);
-        case "undefined":
-            return "undefined";
-        case "bigint":
-            return `bigint:${String(value)}`;
-        case "function":
-            return "function";
-        case "symbol":
-            return "symbol";
-        case "object":
-            break;
-        default:
-            return "unknown";
-    }
-    if (seen.has(value))
-        return '"[cycle]"';
-    seen.add(value);
-    const serialized = Array.isArray(value)
-        ? `[${value.map((item) => stableSerializeValue(item, seen)).join(",")}]`
-        : (() => {
-            const record = value;
-            const keys = Object.keys(record).sort();
-            return `{${keys.map((key) => `${JSON.stringify(key)}:${stableSerializeValue(record[key], seen)}`).join(",")}}`;
-        })();
-    seen.delete(value);
-    return serialized;
-}
 /**
- * 工具结果哈希（签名第三要素）：拼接结果的 text 内容后做全量 SHA-256（十六进制），
- * isError 一并纳入（同参同果且同错误状态才计重复）。任何字节差异都产生不同哈希，
- * 因此长结果（前缀稳定、尾部变化）的合法轮询不会被误判成"同果"——签名不受任何
- * 截断影响。无文本结果（纯图像等）与结果缺席都返回空串占位：签名退化为两要素
- * （工具名 + 参数），这是已知局限——无文本的同参结果彼此不可区分。
- * 调用与结果按 toolCallId 对应，正常流程中每个调用都有结果；无结果返回空串。
+ * 默认 run-loop strategy 名（宿主会话配置缺省名，D-082 批 3）。策略实现本体已
+ * 迁出为 `plugins/agent-loop-policy`（其 `DEFAULT_RUN_LOOP_STRATEGY_NAME` 与本
+ * 值逐字相同，两侧测试各自钉值）；宿主保留该名字用于 `runLoopStrategyName`
+ * 缺省解析——策略缺席时宿主回退自身的延续候选（行为不变），存在时经
+ * `runtime.decideRunLoop` 咨询。
  */
-export function toolResultHash(result) {
-    if (!result)
-        return "";
-    const text = result.content
-        .filter((block) => block.type === "text")
-        .map((block) => block.text)
-        .join("\n");
-    if (text === "")
-        return "";
-    return `${result.isError ? "error" : "ok"}:${createHash("sha256").update(text).digest("hex")}`;
-}
-/** 工具调用签名：工具名 + 参数稳定字符串化 + 结果哈希。 */
-export function repeatedToolCallSignature(toolName, args, resultHash) {
-    return `${JSON.stringify(toolName)}:${stableSerializeValue(args)}:${resultHash}`;
-}
-/** 参数摘要截断：超出 {@link REPEATED_TOOL_CALL_NOTICE_MAX_ARGS_CHARS} 打截断标记（用户可见消息与日志通道共用）。 */
-function truncateNoticeArgs(argsText) {
-    return argsText.length > REPEATED_TOOL_CALL_NOTICE_MAX_ARGS_CHARS
-        ? `${argsText.slice(0, REPEATED_TOOL_CALL_NOTICE_MAX_ARGS_CHARS)}...(truncated)`
-        : argsText;
-}
-/** 停机提示消息：随停机回合的 newMessages 带出（agent_end 可见），并经 deliverNotice 投递到宿主公共面。 */
-export function createRepeatedToolCallStopNotice(toolName, argsText, stopThreshold) {
-    const truncated = truncateNoticeArgs(argsText);
-    return {
-        role: "custom",
-        customType: REPEATED_TOOL_CALL_STOP_CUSTOM_TYPE,
-        content: `Loop guard: stopped after the same tool call (${toolName}) was repeated ${stopThreshold} times in a row. Args: ${truncated}`,
-        display: true,
-        timestamp: Date.now(),
-    };
-}
-/**
- * 提醒通知消息（用户可见面，loop_guard_warn）：经 deliverWarn 投递（默认安装接
- * `SessionAPI.sendMessage`，持久化 + 实时渲染），与停机通知（loop_guard_stop）
- * 的 customType 区分。提醒不进入 newMessages——模型面提醒由 transformContext
- * 注入承担，用户面提醒由本消息的持久化+渲染承担。
- */
-export function createRepeatedToolCallWarnNotice(toolName, argsText, warnThreshold) {
-    const truncated = truncateNoticeArgs(argsText);
-    return {
-        role: "custom",
-        customType: REPEATED_TOOL_CALL_WARN_CUSTOM_TYPE,
-        content: `Loop guard: the same tool call (${toolName}) was repeated ${warnThreshold} times in a row with the same result. Args: ${truncated}`,
-        display: true,
-        timestamp: Date.now(),
-    };
-}
-/**
- * 模型面提醒消息（transformContext 注入用）：display:false 的 custom 消息，
- * 经 convertToLlm 转为 user 文本进入下一次模型请求。只存在于该次请求视图
- * （不写 context.messages、不进 newMessages，故不持久化）；customType 复用
- * loop_guard_warn 标记来源。
- */
-export function createRepeatedToolCallWarnReminder(warnThreshold) {
-    return {
-        role: "custom",
-        customType: REPEATED_TOOL_CALL_WARN_CUSTOM_TYPE,
-        content: `You have repeated the identical tool call with an identical result ${warnThreshold} times. If you are waiting for external state to change, change your approach instead of retrying the same call.`,
-        display: false,
-        timestamp: Date.now(),
-    };
-}
-/**
- * 默认重复工具调用护栏（主对话循环护栏切片A，两级响应）。
- *
- * 每个完成的回合从 assistant 消息中按序取出工具调用，签名（工具名 + 键序参数
- * + 本轮结果哈希，结果按 toolCallId 对应）追加进滑动窗口并裁剪到 windowSize；
- * 然后按窗口尾部连续相同签名段（含同一回合内多次相同调用）做两级响应：
- *
- * - 第一级（达到 warnThreshold，缺省 3）：返回 false 不停机，改为提醒——内部
- *   标记 pendingWarn，由本工厂返回的 transformContext 链路在下一轮请求前把提醒
- *   消息追加到请求视图尾部（agent-loop 的 runLoop 在每次 shouldStopAfterTurn
- *   之后、下一次 streamAssistantResponse 之前消费 transformContext，故提醒必然
- *   进入下一次请求）；同时把用户可见提醒经 deliverWarn 投递、事实经 onWarn 记
- *   日志。同一连续重复段只提醒一次（warnedForRun 闩）；连续段断开（模型改变
- *   行为）即复位，后续新的连续段可再次提醒。
- * - 第二级（达到 stopThreshold，缺省 5）：返回 true 请求停机——先向
- *   {@link ShouldStopAfterTurnContext} 的 newMessages 追加一条用户可见的停机消
- *   息并交给 deliverNotice（禁止静默停机），再经 onStop 记日志。判据不可能完
- *   美，因此不可逆停机不是第一响应。
- *
- * 同参不同果（合法轮询，如等待外部状态就绪）不计重复：结果要素是全量哈希，
- * 任何字节差异（包括 >200 字符长结果仅尾部变化）都产生不同签名；无文本结果
- * 退化为两要素（见 {@link toolResultHash} 局限声明）。无工具调用或结果缺席的
- * 轮次不进窗口。
- *
- * 挂载点说明：两条链路都由 {@link installBootstrapAgentLoop} 经公共扩展面
- * `api.registerLoopHook` 注册为默认链路（transformContext 注入链注册在默认上
- * 下文策略链之后，提醒落到最终请求视图尾部）；disabledBootstrapPlugins 跳过本
- * 插件时均不注册，护栏随之关闭。wireDefaultLoop 只消费链，不直接安装本策略。
- */
-export function createRepeatedToolCallStopPolicy(options = {}) {
-    const windowSize = options.windowSize ?? REPEATED_TOOL_CALL_WINDOW_SIZE;
-    const warnThreshold = options.warnThreshold ?? REPEATED_TOOL_CALL_WARN_THRESHOLD;
-    const stopThreshold = options.stopThreshold ?? REPEATED_TOOL_CALL_STOP_THRESHOLD;
-    const window = [];
-    let lastToolName = "";
-    let lastArgsText = "";
-    /** 待注入的提醒事实：warn 时置位，transformContext 消费即清除（只注入一次）。 */
-    let pendingWarn;
-    /** 当前连续重复段已提醒闩：同段不重复提醒；段断开（尾部连续段短于提醒阈值）时复位。 */
-    let warnedForRun = false;
-    /** 窗口尾部连续相同签名的段长。 */
-    const trailingRunLength = () => {
-        const last = window[window.length - 1];
-        if (last === undefined)
-            return 0;
-        let run = 0;
-        for (let i = window.length - 1; i >= 0 && window[i] === last; i -= 1)
-            run += 1;
-        return run;
-    };
-    const shouldStopAfterTurn = (context) => {
-        const toolCalls = context.message.content.filter((block) => block.type === "toolCall");
-        // 三要素签名需要本轮工具结果：结果缺席时无法判定"同果"，该轮不进窗口，
-        // 避免把合法轮询误判成重复。
-        if (toolCalls.length > 0 && context.toolResults.length > 0) {
-            const resultById = new Map(context.toolResults.map((result) => [result.toolCallId, result]));
-            for (const call of toolCalls) {
-                window.push(repeatedToolCallSignature(call.name, call.arguments, toolResultHash(resultById.get(call.id))));
-                lastToolName = call.name;
-                lastArgsText = stableSerializeValue(call.arguments);
-            }
-        }
-        if (window.length > windowSize) {
-            window.splice(0, window.length - windowSize);
-        }
-        const run = trailingRunLength();
-        if (run >= stopThreshold) {
-            // 第二级兜底：硬停，走停机全通道（newMessages + deliverNotice + onStop）。
-            // 先于提醒判定：stopThreshold 被显式覆盖到不大于 warnThreshold 时停机优先。
-            pendingWarn = undefined;
-            const notice = createRepeatedToolCallStopNotice(lastToolName, lastArgsText, stopThreshold);
-            context.newMessages.push(notice);
-            options.deliverNotice?.(notice);
-            // 日志可见通道（D-072 6(a)）：与用户可见提示成对发出；onStop 属宿主接线，
-            // 策略本身不知道任何具体日志实现。
-            options.onStop?.({ toolName: lastToolName, argsSummary: truncateNoticeArgs(lastArgsText), stopThreshold });
-            return true;
-        }
-        if (run < warnThreshold) {
-            // 连续段断开：模型改变行为。复位已提醒闩并丢弃未消费的待注入提醒
-            // （正常流程中它已在下一轮请求前被消费；此处只兜底运行中断的残留）。
-            warnedForRun = false;
-            pendingWarn = undefined;
-            return false;
-        }
-        // 第一级：提醒不停机。标记待注入（transformContext 链路消费），经
-        // deliverWarn/onWarn 双通道可见；同一连续段只提醒一次。
-        if (!warnedForRun) {
-            warnedForRun = true;
-            pendingWarn = { toolName: lastToolName, argsSummary: truncateNoticeArgs(lastArgsText), warnThreshold };
-            options.deliverWarn?.(createRepeatedToolCallWarnNotice(lastToolName, lastArgsText, warnThreshold));
-            options.onWarn?.(pendingWarn);
-        }
-        return false;
-    };
-    const transformContext = async (messages, _signal) => {
-        const info = pendingWarn;
-        if (!info)
-            return undefined;
-        // 消费即清除：提醒只注入一次；重复继续发生不重复注入。非变异地追加到
-        // 请求视图尾部（不写 context.messages，故不持久化、不进 newMessages）。
-        pendingWarn = undefined;
-        return [...messages, createRepeatedToolCallWarnReminder(info.warnThreshold)];
-    };
-    return { shouldStopAfterTurn, transformContext };
-}
+export const DEFAULT_RUN_LOOP_STRATEGY_NAME = "default";
 /**
  * Default beforeToolCall link: the `tool.call@1` candidate dispatch with
  * identity/revision checks. Moved from the AgentSession tool-hook wiring.
@@ -511,56 +293,12 @@ export function installBootstrapAgentLoop(runtime, wiring) {
         api.registerLoopHook("afterToolCall", createDefaultAfterToolCallLink(runtime, wiring));
         api.registerLoopHook("transformContext", createDefaultTransformContextLink(runtime, wiring));
         api.registerLoopHook("prepareNextTurn", createDefaultPrepareNextTurnLink(wiring));
-        // The default repeated-tool-call guard rides the public loop-hook
-        // chains like any other first-party link; disabling this plugin
-        // removes both of its links. It answers with two levels (judgments
-        // can be wrong, so an irreversible stop is never the first response):
-        // - warn (third identical call): the shouldStopAfterTurn link votes
-        //   false and the transformContext link below injects a reminder into
-        //   the next request view (runLoop consumes transformContext after
-        //   shouldStopAfterTurn and before the next model call); the user-
-        //   facing warn notice is delivered through the public SessionAPI
-        //   sendMessage face (persisted custom_message entry with live
-        //   message_start/message_end rendering), plus a warn log through
-        //   the public LoggerAPI.
-        // - stop (fifth identical call): the shouldStopAfterTurn link votes
-        //   true; the stop notice rides agent_end newMessages, sendMessage
-        //   persistence + rendering, and a warn log — all channels on.
-        // Absent host features (session/logger) degrade to the remaining
-        // channels instead of blocking the guard.
-        const loopGuard = createRepeatedToolCallStopPolicy({
-            deliverWarn: (notice) => {
-                void api.session?.sendMessage?.(notice, { triggerTurn: false });
-            },
-            onWarn: (info) => {
-                api.logger?.warn("Loop guard warned the model", {
-                    tool: info.toolName,
-                    repeats: info.warnThreshold,
-                    argsSummary: info.argsSummary,
-                });
-            },
-            deliverNotice: (notice) => {
-                void api.session?.sendMessage?.(notice, { triggerTurn: false });
-            },
-            onStop: (info) => {
-                api.logger?.warn("Loop guard stopped the turn", {
-                    tool: info.toolName,
-                    repeats: info.stopThreshold,
-                    argsSummary: info.argsSummary,
-                });
-            },
-        });
-        api.registerLoopHook("shouldStopAfterTurn", loopGuard.shouldStopAfterTurn);
-        // Registered after the default context-strategy link, so the reminder
-        // is appended to the final post-strategy request view (survives any
-        // strategy pruning) at its tail.
-        api.registerLoopHook("transformContext", loopGuard.transformContext);
-        // The default continuation strategy reproduces the host's own
-        // post-run decision byte for byte; a replacement strategy overrides
-        // the continue/stop call through registerRunLoopStrategy.
-        api.registerRunLoopStrategy(DEFAULT_RUN_LOOP_STRATEGY_NAME, {
-            decideNextCycle: (request) => ({ continueLoop: request.hostWillContinue }),
-        });
+        // D-082 批 3：默认重复工具调用护栏（shouldStopAfterTurn 决策链 +
+        // transformContext 提醒注入链）与默认 run-loop strategy 不再在此注册——
+        // 它们不消费 wiring，已迁出为 plugins/agent-loop-policy
+        // （agent-forge.plugin.agent-loop-policy），经 sdk bundled 分发通道装配；
+        // 其链接在本执行器之后注册，落链顺序与内嵌时代一致（护栏注入链仍在
+        // 默认上下文策略链之后、第三方链接之前）。
     });
 }
 //# sourceMappingURL=bootstrap-agent-loop.js.map

package/dist/core/extensions/bootstrap-agent-loop.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-agent-loop.js","sourceRoot":"","sources":["../../../src/core/extensions/bootstrap-agent-loop.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Default agent-loop bootstrap executor (W3).\n *\n/**\n * Registers the default main-loop capabilities through the public extension\n * face so the default loop stays a replaceable first-party plugin:\n * - the five default loop-hook links (capability lifecycle dispatch, image\n *   normalization, context strategy, compaction + next-turn refresh, and the\n *   repeated-tool-call guard: shouldStopAfterTurn decision + transformContext\n *   warn-reminder injection), and\n * - the default post-run continuation strategy (the host's own candidate\n *   decision).\n *\n * The default links need session-bound host state (session id, revision,\n * correlation id, error observation, settings). That state is injected as\n * {@link AgentLoopWiringV1} — host wiring, not a plugin capability. Third-party\n * plugins register additional links through `api.registerLoopHook`; they run\n * after the default links in registration order.\n */\n\nimport { createHash } from \"node:crypto\";\nimport type {\n\tAgentContext,\n\tAgentLoopTurnUpdate,\n\tAgentMessage,\n\tAgentTool,\n\tPrepareNextTurnContext,\n\tShouldStopAfterTurnContext,\n\tThinkingLevel,\n} from \"@agent-forge/agent-core\";\nimport type { ToolCall, ToolResultMessage } from \"@agent-forge/ai\";\nimport type { Api, ImageContent, Model, TextContent, Usage } from \"@agent-forge/ai/compat\";\nimport { normalizeToolResultImages } from \"../../utils/tool-result-images.ts\";\nimport { t } from \"../i18n/index.ts\";\nimport type { CustomMessage } from \"../messages.ts\";\nimport { type CapabilityPluginHandle, loadCapabilityPluginSync } from \"./capability-plugin.ts\";\nimport type { CapabilityRuntime } from \"./capability-runtime.ts\";\nimport { applyCapabilityContextStrategy } from \"./context-strategy-binding.ts\";\nimport {\n\tTOOL_CALL_EVENT_ID,\n\tTOOL_CALL_EVENT_VERSION,\n\tTOOL_EXECUTE_EVENT_ID,\n\tTOOL_EXECUTE_EVENT_VERSION,\n\tTOOL_RESULT_RAW_EVENT_ID,\n\tTOOL_RESULT_RAW_EVENT_VERSION,\n\tTOOL_RESULT_TRANSFORM_EVENT_ID,\n\tTOOL_RESULT_TRANSFORM_EVENT_VERSION,\n\ttype ToolCallEventDataV1,\n\ttype ToolExecuteEventDataV1,\n\ttype ToolResultRawEventDataV1,\n\ttype ToolResultTransformEventDataV1,\n} from \"./lifecycle-catalog.ts\";\nimport {\n\ttype AgentLoopAfterToolCallHookV1,\n\ttype AgentLoopBeforeToolCallHookV1,\n\ttype AgentLoopPrepareNextTurnHookV1,\n\ttype AgentLoopTransformContextHookV1,\n\tdetachedSessionSnapshot,\n\tEXPERIMENTAL_PUBLIC_API_VERSION,\n\ttype SessionRevisionV1,\n} from \"./public-api.ts\";\n\nexport const BOOTSTRAP_AGENT_LOOP_PLUGIN_ID = \"agent-forge.bootstrap-agent-loop\";\nexport const DEFAULT_RUN_LOOP_STRATEGY_NAME = \"default\";\n\n/** 滑动窗口大小：护栏只回看最近 N 个工具调用签名（跨回合累计）。 */\nexport const REPEATED_TOOL_CALL_WINDOW_SIZE = 6;\n/** 提醒阈值：窗口尾部连续相同签名达到该次数时提醒模型（不停机，两级响应第一级）。 */\nexport const REPEATED_TOOL_CALL_WARN_THRESHOLD = 3;\n/** 停机阈值：提醒后仍连续相同达到该次数才请求停机（两级响应第二级兜底）。 */\nexport const REPEATED_TOOL_CALL_STOP_THRESHOLD = 5;\n/** 停机提示消息的 customType（用户可见面，随 agent_end 的 messages 带出）。 */\nexport const REPEATED_TOOL_CALL_STOP_CUSTOM_TYPE = \"loop_guard_stop\";\n/** 提醒消息的 customType（用户可见面经 sendMessage 持久化+渲染；模型面注入复用同一标记）。 */\nexport const REPEATED_TOOL_CALL_WARN_CUSTOM_TYPE = \"loop_guard_warn\";\n/** 提示消息中参数串的最大长度，超出截断（只影响提示文本，不影响检测签名）。 */\nexport const REPEATED_TOOL_CALL_NOTICE_MAX_ARGS_CHARS = 200;\n\n/** {@link createRepeatedToolCallStopPolicy} 的窗口与两级阈值参数（缺省用上方命名常量）。 */\nexport interface RepeatedToolCallStopPolicyOptions {\n\t/** 滑动窗口大小，缺省 {@link REPEATED_TOOL_CALL_WINDOW_SIZE}。 */\n\twindowSize?: number;\n\t/** 提醒阈值（第一级，不停机），缺省 {@link REPEATED_TOOL_CALL_WARN_THRESHOLD}。 */\n\twarnThreshold?: number;\n\t/** 停机阈值（第二级兜底），缺省 {@link REPEATED_TOOL_CALL_STOP_THRESHOLD}。显式设为不大于提醒阈值时停机优先。 */\n\tstopThreshold?: number;\n\t/**\n\t * 提醒时的日志面回调（与 {@link onStop} 同纪律：info 只携带脱敏后的事实——\n\t * 工具名、截断参数摘要、提醒阈值，不含完整工具参数）。只在第一级实际提醒的\n\t * 回合调用一次；缺省不接 = 行为不变。\n\t */\n\tonWarn?: (info: RepeatedToolCallWarnInfo) => void;\n\t/**\n\t * 停机时的日志面回调（D-072 治理纪律 6(a)：用户可见 + 日志可见双通道）。\n\t * 只在策略实际请求停机的回合调用一次；缺省不接 = 行为不变。info 只携带\n\t * 脱敏后的事实（工具名、截断参数摘要、阈值），不含完整工具参数。\n\t */\n\tonStop?: (info: RepeatedToolCallStopInfo) => void;\n\t/**\n\t * 提醒通知投递缝：策略把提醒消息交给宿主选定的公共面。默认安装把它接到\n\t * `SessionAPI.sendMessage`（持久化 + message_start 实时渲染）；缺席时提醒\n\t * 仍经 transformContext 注入模型请求（模型面不依赖该缝）。\n\t */\n\tdeliverWarn?: (notice: CustomMessage) => void;\n\t/**\n\t * 停机通知投递缝：策略把停机提示消息交给宿主选定的公共面。默认安装把它接到\n\t * `SessionAPI.sendMessage`（运行中排队、run 收尾 flush 落为 custom_message\n\t * 条目——持久化 + message_start 实时渲染）；缺席时停机事实仅随 agent_end 的\n\t * newMessages 带出（行为不变）。\n\t */\n\tdeliverNotice?: (notice: CustomMessage) => void;\n}\n\n/** 提醒事实（脱敏）：{@link RepeatedToolCallStopPolicyOptions.onWarn} 的载荷。 */\nexport interface RepeatedToolCallWarnInfo {\n\t/** 触发提醒的最后一个工具名。 */\n\ttoolName: string;\n\t/** 截断后的参数稳定序列化摘要（复用 {@link REPEATED_TOOL_CALL_NOTICE_MAX_ARGS_CHARS}）。 */\n\targsSummary: string;\n\t/** 达到的连续重复提醒阈值。 */\n\twarnThreshold: number;\n}\n\n/** 停机事实（脱敏）：{@link RepeatedToolCallStopPolicyOptions.onStop} 的载荷。 */\nexport interface RepeatedToolCallStopInfo {\n\t/** 触发停机的最后一个工具名。 */\n\ttoolName: string;\n\t/** 截断后的参数稳定序列化摘要（复用 {@link REPEATED_TOOL_CALL_NOTICE_MAX_ARGS_CHARS}）。 */\n\targsSummary: string;\n\t/** 达到的连续重复停机阈值。 */\n\tstopThreshold: number;\n}\n\n/**\n * 参数稳定字符串化：对象键递归排序后逐层拼接（数组保持顺序），循环引用输出\n * 固定占位。只用于签名比较与提示文本，不是通用 JSON 序列化器。\n */\nexport function stableSerializeValue(value: unknown, seen: WeakSet<object> = new WeakSet()): string {\n\tif (value === null) return \"null\";\n\tswitch (typeof value) {\n\t\tcase \"string\":\n\t\t\treturn JSON.stringify(value);\n\t\tcase \"number\":\n\t\t\treturn String(value);\n\t\tcase \"boolean\":\n\t\t\treturn String(value);\n\t\tcase \"undefined\":\n\t\t\treturn \"undefined\";\n\t\tcase \"bigint\":\n\t\t\treturn `bigint:${String(value)}`;\n\t\tcase \"function\":\n\t\t\treturn \"function\";\n\t\tcase \"symbol\":\n\t\t\treturn \"symbol\";\n\t\tcase \"object\":\n\t\t\tbreak;\n\t\tdefault:\n\t\t\treturn \"unknown\";\n\t}\n\tif (seen.has(value)) return '\"[cycle]\"';\n\tseen.add(value);\n\tconst serialized = Array.isArray(value)\n\t\t? `[${value.map((item) => stableSerializeValue(item, seen)).join(\",\")}]`\n\t\t: (() => {\n\t\t\t\tconst record = value as Record<string, unknown>;\n\t\t\t\tconst keys = Object.keys(record).sort();\n\t\t\t\treturn `{${keys.map((key) => `${JSON.stringify(key)}:${stableSerializeValue(record[key], seen)}`).join(\",\")}}`;\n\t\t\t})();\n\tseen.delete(value);\n\treturn serialized;\n}\n\n/**\n * 工具结果哈希（签名第三要素）：拼接结果的 text 内容后做全量 SHA-256（十六进制），\n * isError 一并纳入（同参同果且同错误状态才计重复）。任何字节差异都产生不同哈希，\n * 因此长结果（前缀稳定、尾部变化）的合法轮询不会被误判成\"同果\"——签名不受任何\n * 截断影响。无文本结果（纯图像等）与结果缺席都返回空串占位：签名退化为两要素\n * （工具名 + 参数），这是已知局限——无文本的同参结果彼此不可区分。\n * 调用与结果按 toolCallId 对应，正常流程中每个调用都有结果；无结果返回空串。\n */\nexport function toolResultHash(result: ToolResultMessage | undefined): string {\n\tif (!result) return \"\";\n\tconst text = result.content\n\t\t.filter((block): block is TextContent => block.type === \"text\")\n\t\t.map((block) => block.text)\n\t\t.join(\"\\n\");\n\tif (text === \"\") return \"\";\n\treturn `${result.isError ? \"error\" : \"ok\"}:${createHash(\"sha256\").update(text).digest(\"hex\")}`;\n}\n\n/** 工具调用签名：工具名 + 参数稳定字符串化 + 结果哈希。 */\nexport function repeatedToolCallSignature(toolName: string, args: unknown, resultHash: string): string {\n\treturn `${JSON.stringify(toolName)}:${stableSerializeValue(args)}:${resultHash}`;\n}\n\n/** 参数摘要截断：超出 {@link REPEATED_TOOL_CALL_NOTICE_MAX_ARGS_CHARS} 打截断标记（用户可见消息与日志通道共用）。 */\nfunction truncateNoticeArgs(argsText: string): string {\n\treturn argsText.length > REPEATED_TOOL_CALL_NOTICE_MAX_ARGS_CHARS\n\t\t? `${argsText.slice(0, REPEATED_TOOL_CALL_NOTICE_MAX_ARGS_CHARS)}...(truncated)`\n\t\t: argsText;\n}\n\n/** 停机提示消息：随停机回合的 newMessages 带出（agent_end 可见），并经 deliverNotice 投递到宿主公共面。 */\nexport function createRepeatedToolCallStopNotice(\n\ttoolName: string,\n\targsText: string,\n\tstopThreshold: number,\n): CustomMessage {\n\tconst truncated = truncateNoticeArgs(argsText);\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType: REPEATED_TOOL_CALL_STOP_CUSTOM_TYPE,\n\t\tcontent: `Loop guard: stopped after the same tool call (${toolName}) was repeated ${stopThreshold} times in a row. Args: ${truncated}`,\n\t\tdisplay: true,\n\t\ttimestamp: Date.now(),\n\t};\n}\n\n/**\n * 提醒通知消息（用户可见面，loop_guard_warn）：经 deliverWarn 投递（默认安装接\n * `SessionAPI.sendMessage`，持久化 + 实时渲染），与停机通知（loop_guard_stop）\n * 的 customType 区分。提醒不进入 newMessages——模型面提醒由 transformContext\n * 注入承担，用户面提醒由本消息的持久化+渲染承担。\n */\nexport function createRepeatedToolCallWarnNotice(\n\ttoolName: string,\n\targsText: string,\n\twarnThreshold: number,\n): CustomMessage {\n\tconst truncated = truncateNoticeArgs(argsText);\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType: REPEATED_TOOL_CALL_WARN_CUSTOM_TYPE,\n\t\tcontent: `Loop guard: the same tool call (${toolName}) was repeated ${warnThreshold} times in a row with the same result. Args: ${truncated}`,\n\t\tdisplay: true,\n\t\ttimestamp: Date.now(),\n\t};\n}\n\n/**\n * 模型面提醒消息（transformContext 注入用）：display:false 的 custom 消息，\n * 经 convertToLlm 转为 user 文本进入下一次模型请求。只存在于该次请求视图\n * （不写 context.messages、不进 newMessages，故不持久化）；customType 复用\n * loop_guard_warn 标记来源。\n */\nexport function createRepeatedToolCallWarnReminder(warnThreshold: number): CustomMessage {\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType: REPEATED_TOOL_CALL_WARN_CUSTOM_TYPE,\n\t\tcontent: `You have repeated the identical tool call with an identical result ${warnThreshold} times. If you are waiting for external state to change, change your approach instead of retrying the same call.`,\n\t\tdisplay: false,\n\t\ttimestamp: Date.now(),\n\t};\n}\n\n/** {@link createRepeatedToolCallStopPolicy} 返回的两条链路（共享同一滑动窗口与两级状态）。 */\nexport interface RepeatedToolCallGuard {\n\t/**\n\t * \"shouldStopAfterTurn\" 链路：两级判定的决策面（返回 true 即请求停机）。\n\t */\n\tshouldStopAfterTurn: (context: ShouldStopAfterTurnContext) => boolean;\n\t/**\n\t * \"transformContext\" 链路：提醒注入面。有待注入提醒时返回追加了提醒消息的\n\t * 新数组（进入下一次模型请求视图），否则返回 undefined（保留输入）。\n\t */\n\ttransformContext: (messages: readonly unknown[], signal?: AbortSignal) => Promise<readonly unknown[] | undefined>;\n}\n\n/**\n * 默认重复工具调用护栏（主对话循环护栏切片A，两级响应）。\n *\n * 每个完成的回合从 assistant 消息中按序取出工具调用，签名（工具名 + 键序参数\n * + 本轮结果哈希，结果按 toolCallId 对应）追加进滑动窗口并裁剪到 windowSize；\n * 然后按窗口尾部连续相同签名段（含同一回合内多次相同调用）做两级响应：\n *\n * - 第一级（达到 warnThreshold，缺省 3）：返回 false 不停机，改为提醒——内部\n *   标记 pendingWarn，由本工厂返回的 transformContext 链路在下一轮请求前把提醒\n *   消息追加到请求视图尾部（agent-loop 的 runLoop 在每次 shouldStopAfterTurn\n *   之后、下一次 streamAssistantResponse 之前消费 transformContext，故提醒必然\n *   进入下一次请求）；同时把用户可见提醒经 deliverWarn 投递、事实经 onWarn 记\n *   日志。同一连续重复段只提醒一次（warnedForRun 闩）；连续段断开（模型改变\n *   行为）即复位，后续新的连续段可再次提醒。\n * - 第二级（达到 stopThreshold，缺省 5）：返回 true 请求停机——先向\n *   {@link ShouldStopAfterTurnContext} 的 newMessages 追加一条用户可见的停机消\n *   息并交给 deliverNotice（禁止静默停机），再经 onStop 记日志。判据不可能完\n *   美，因此不可逆停机不是第一响应。\n *\n * 同参不同果（合法轮询，如等待外部状态就绪）不计重复：结果要素是全量哈希，\n * 任何字节差异（包括 >200 字符长结果仅尾部变化）都产生不同签名；无文本结果\n * 退化为两要素（见 {@link toolResultHash} 局限声明）。无工具调用或结果缺席的\n * 轮次不进窗口。\n *\n * 挂载点说明：两条链路都由 {@link installBootstrapAgentLoop} 经公共扩展面\n * `api.registerLoopHook` 注册为默认链路（transformContext 注入链注册在默认上\n * 下文策略链之后，提醒落到最终请求视图尾部）；disabledBootstrapPlugins 跳过本\n * 插件时均不注册，护栏随之关闭。wireDefaultLoop 只消费链，不直接安装本策略。\n */\nexport function createRepeatedToolCallStopPolicy(\n\toptions: RepeatedToolCallStopPolicyOptions = {},\n): RepeatedToolCallGuard {\n\tconst windowSize = options.windowSize ?? REPEATED_TOOL_CALL_WINDOW_SIZE;\n\tconst warnThreshold = options.warnThreshold ?? REPEATED_TOOL_CALL_WARN_THRESHOLD;\n\tconst stopThreshold = options.stopThreshold ?? REPEATED_TOOL_CALL_STOP_THRESHOLD;\n\tconst window: string[] = [];\n\tlet lastToolName = \"\";\n\tlet lastArgsText = \"\";\n\t/** 待注入的提醒事实：warn 时置位，transformContext 消费即清除（只注入一次）。 */\n\tlet pendingWarn: RepeatedToolCallWarnInfo | undefined;\n\t/** 当前连续重复段已提醒闩：同段不重复提醒；段断开（尾部连续段短于提醒阈值）时复位。 */\n\tlet warnedForRun = false;\n\n\t/** 窗口尾部连续相同签名的段长。 */\n\tconst trailingRunLength = (): number => {\n\t\tconst last = window[window.length - 1];\n\t\tif (last === undefined) return 0;\n\t\tlet run = 0;\n\t\tfor (let i = window.length - 1; i >= 0 && window[i] === last; i -= 1) run += 1;\n\t\treturn run;\n\t};\n\n\tconst shouldStopAfterTurn = (context: ShouldStopAfterTurnContext): boolean => {\n\t\tconst toolCalls = context.message.content.filter((block): block is ToolCall => block.type === \"toolCall\");\n\t\t// 三要素签名需要本轮工具结果：结果缺席时无法判定\"同果\"，该轮不进窗口，\n\t\t// 避免把合法轮询误判成重复。\n\t\tif (toolCalls.length > 0 && context.toolResults.length > 0) {\n\t\t\tconst resultById = new Map(context.toolResults.map((result) => [result.toolCallId, result]));\n\t\t\tfor (const call of toolCalls) {\n\t\t\t\twindow.push(repeatedToolCallSignature(call.name, call.arguments, toolResultHash(resultById.get(call.id))));\n\t\t\t\tlastToolName = call.name;\n\t\t\t\tlastArgsText = stableSerializeValue(call.arguments);\n\t\t\t}\n\t\t}\n\t\tif (window.length > windowSize) {\n\t\t\twindow.splice(0, window.length - windowSize);\n\t\t}\n\t\tconst run = trailingRunLength();\n\t\tif (run >= stopThreshold) {\n\t\t\t// 第二级兜底：硬停，走停机全通道（newMessages + deliverNotice + onStop）。\n\t\t\t// 先于提醒判定：stopThreshold 被显式覆盖到不大于 warnThreshold 时停机优先。\n\t\t\tpendingWarn = undefined;\n\t\t\tconst notice = createRepeatedToolCallStopNotice(lastToolName, lastArgsText, stopThreshold);\n\t\t\tcontext.newMessages.push(notice);\n\t\t\toptions.deliverNotice?.(notice);\n\t\t\t// 日志可见通道（D-072 6(a)）：与用户可见提示成对发出；onStop 属宿主接线，\n\t\t\t// 策略本身不知道任何具体日志实现。\n\t\t\toptions.onStop?.({ toolName: lastToolName, argsSummary: truncateNoticeArgs(lastArgsText), stopThreshold });\n\t\t\treturn true;\n\t\t}\n\t\tif (run < warnThreshold) {\n\t\t\t// 连续段断开：模型改变行为。复位已提醒闩并丢弃未消费的待注入提醒\n\t\t\t// （正常流程中它已在下一轮请求前被消费；此处只兜底运行中断的残留）。\n\t\t\twarnedForRun = false;\n\t\t\tpendingWarn = undefined;\n\t\t\treturn false;\n\t\t}\n\t\t// 第一级：提醒不停机。标记待注入（transformContext 链路消费），经\n\t\t// deliverWarn/onWarn 双通道可见；同一连续段只提醒一次。\n\t\tif (!warnedForRun) {\n\t\t\twarnedForRun = true;\n\t\t\tpendingWarn = { toolName: lastToolName, argsSummary: truncateNoticeArgs(lastArgsText), warnThreshold };\n\t\t\toptions.deliverWarn?.(createRepeatedToolCallWarnNotice(lastToolName, lastArgsText, warnThreshold));\n\t\t\toptions.onWarn?.(pendingWarn);\n\t\t}\n\t\treturn false;\n\t};\n\n\tconst transformContext = async (\n\t\tmessages: readonly unknown[],\n\t\t_signal?: AbortSignal,\n\t): Promise<readonly unknown[] | undefined> => {\n\t\tconst info = pendingWarn;\n\t\tif (!info) return undefined;\n\t\t// 消费即清除：提醒只注入一次；重复继续发生不重复注入。非变异地追加到\n\t\t// 请求视图尾部（不写 context.messages，故不持久化、不进 newMessages）。\n\t\tpendingWarn = undefined;\n\t\treturn [...messages, createRepeatedToolCallWarnReminder(info.warnThreshold)];\n\t};\n\n\treturn { shouldStopAfterTurn, transformContext };\n}\n\n/**\n * Session-bound host state the default loop links read at execution time.\n * Host wiring injected into the bootstrap executor; not part of the plugin\n * capability surface.\n */\nexport interface AgentLoopWiringV1 {\n\t/** Canonical session id for lifecycle payloads. */\n\tgetSessionId(): string;\n\t/** Detached revision snapshot captured at payload build time. */\n\tgetRevision(): SessionRevisionV1;\n\t/** Correlation id of the current prompt run, if any. */\n\tgetTurnCorrelationId(): string | undefined;\n\t/** Non-fatal delivery error sink (same surface as session-level observation). */\n\tobserveError(error: unknown, extensionPath: string, event: string): void;\n\t/** Image auto-resize setting for tool-result normalization. */\n\tgetImageAutoResize(): boolean;\n\t/** Compaction hook chained first inside the default prepareNextTurn link. */\n\tcompactBeforeNextAssistantResponse(context: AgentContext, signal?: AbortSignal): Promise<AgentContext>;\n\t/** Next-turn refresh snapshot applied last inside the default prepareNextTurn link. */\n\tgetTurnRefresh(): {\n\t\tsystemPrompt: string;\n\t\ttools: AgentTool[];\n\t\tmodel: Model<Api>;\n\t\tthinkingLevel: ThinkingLevel;\n\t};\n\t/** The agent's construction-time prepare adapter, chained after compaction. */\n\tgetInitialPrepareNextTurn():\n\t\t| ((\n\t\t\t\tcontext: PrepareNextTurnContext,\n\t\t\t\tsignal?: AbortSignal,\n\t\t  ) => Promise<AgentLoopTurnUpdate | undefined> | AgentLoopTurnUpdate | undefined)\n\t\t| undefined;\n\t/** Configured external context strategy name, if any. */\n\tgetContextStrategyName(): string | undefined;\n}\n\ninterface LifecycleFailureReport {\n\treport?: { failures?: readonly { error: unknown; pluginId: string; kind: string }[] };\n}\n\n/**\n * Default beforeToolCall link: the `tool.call@1` candidate dispatch with\n * identity/revision checks. Moved from the AgentSession tool-hook wiring.\n */\nfunction createDefaultBeforeToolCallLink(\n\truntime: CapabilityRuntime,\n\twiring: AgentLoopWiringV1,\n): AgentLoopBeforeToolCallHookV1 {\n\treturn async ({ toolCallId, toolName, args, signal }) => {\n\t\t// v8 ignore next -- bootstrap lifecycle 恒定义全部生命周期事件，其 token 在 dispose 前恒活跃，提前返回不可达\n\t\tif (!runtime.hasLifecycleEvent(TOOL_CALL_EVENT_ID, TOOL_CALL_EVENT_VERSION)) return undefined;\n\t\tconst data: ToolCallEventDataV1 = {\n\t\t\tversion: 1,\n\t\t\tsessionId: wiring.getSessionId(),\n\t\t\trevision: wiring.getRevision(),\n\t\t\ttoolCallId,\n\t\t\ttoolName,\n\t\t\tinput: detachedSessionSnapshot(args),\n\t\t};\n\t\ttry {\n\t\t\tconst delivery = await runtime.dispatchLifecycle({\n\t\t\t\ttype: TOOL_CALL_EVENT_ID,\n\t\t\t\tversion: TOOL_CALL_EVENT_VERSION,\n\t\t\t\tphase: \"candidate\",\n\t\t\t\tdata,\n\t\t\t\tsource: \"agent-session\",\n\t\t\t\tcorrelationId: wiring.getTurnCorrelationId(),\n\t\t\t\tsignal,\n\t\t\t});\n\t\t\tfor (const failure of delivery.report.failures) {\n\t\t\t\twiring.observeError(\n\t\t\t\t\tfailure.error,\n\t\t\t\t\tfailure.pluginId,\n\t\t\t\t\t`${TOOL_CALL_EVENT_ID}@${TOOL_CALL_EVENT_VERSION}/${failure.kind}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst transformed = delivery.data;\n\t\t\tconst revision = transformed.revision;\n\t\t\tif (\n\t\t\t\ttransformed.sessionId !== data.sessionId ||\n\t\t\t\ttransformed.toolCallId !== data.toolCallId ||\n\t\t\t\ttransformed.toolName !== data.toolName ||\n\t\t\t\trevision.version !== data.revision.version ||\n\t\t\t\trevision.sessionId !== data.revision.sessionId ||\n\t\t\t\trevision.sequence !== data.revision.sequence ||\n\t\t\t\trevision.leafId !== data.revision.leafId\n\t\t\t) {\n\t\t\t\tthrow new Error(t(\"tool.call transform cannot change call identity or revision\"));\n\t\t\t}\n\t\t\treturn { args: transformed.input };\n\t\t} catch (error) {\n\t\t\tconst report = (error as LifecycleFailureReport).report;\n\t\t\tif (report?.failures) {\n\t\t\t\tfor (const failure of report.failures) {\n\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\tfailure.error,\n\t\t\t\t\t\tfailure.pluginId,\n\t\t\t\t\t\t`${TOOL_CALL_EVENT_ID}@${TOOL_CALL_EVENT_VERSION}/${failure.kind}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t};\n}\n\n/**\n * Default afterToolCall link: `tool.execute@1` committed, `tool.result.raw@1`\n * raw, the legacy `tool_result` extension hook (via wiring), image\n * normalization, and the `tool.result.transform@1` candidate dispatch — in the\n * exact order the previous single AgentSession hook used. Moved from the\n * AgentSession tool-hook wiring.\n */\nfunction createDefaultAfterToolCallLink(\n\truntime: CapabilityRuntime,\n\twiring: AgentLoopWiringV1,\n): AgentLoopAfterToolCallHookV1 {\n\treturn async ({ toolCallId, toolName, args, result, isError, signal }) => {\n\t\tconst toolResult = result as {\n\t\t\tcontent?: (TextContent | ImageContent)[];\n\t\t\tdetails?: unknown;\n\t\t\tisError?: boolean;\n\t\t\tusage?: Usage;\n\t\t};\n\t\tif (runtime.hasLifecycleEvent(TOOL_EXECUTE_EVENT_ID, TOOL_EXECUTE_EVENT_VERSION)) {\n\t\t\ttry {\n\t\t\t\tconst data: ToolExecuteEventDataV1 = {\n\t\t\t\t\tversion: 1,\n\t\t\t\t\tsessionId: wiring.getSessionId(),\n\t\t\t\t\trevision: wiring.getRevision(),\n\t\t\t\t\ttoolCallId,\n\t\t\t\t\ttoolName,\n\t\t\t\t\tinput: detachedSessionSnapshot(args),\n\t\t\t\t\tisError,\n\t\t\t\t\tcontent: detachedSessionSnapshot(toolResult.content ?? []),\n\t\t\t\t};\n\t\t\t\tconst delivery = await runtime.dispatchLifecycle({\n\t\t\t\t\ttype: TOOL_EXECUTE_EVENT_ID,\n\t\t\t\t\tversion: TOOL_EXECUTE_EVENT_VERSION,\n\t\t\t\t\tphase: \"committed\",\n\t\t\t\t\tdata,\n\t\t\t\t\tsource: \"agent-session\",\n\t\t\t\t\tcorrelationId: wiring.getTurnCorrelationId(),\n\t\t\t\t});\n\t\t\t\tfor (const failure of delivery.report.failures) {\n\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\tfailure.error,\n\t\t\t\t\t\tfailure.pluginId,\n\t\t\t\t\t\t`${TOOL_EXECUTE_EVENT_ID}@${TOOL_EXECUTE_EVENT_VERSION}/${failure.kind}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t} catch (error) {\n\t\t\t\tconst report = (error as LifecycleFailureReport).report;\n\t\t\t\tif (report?.failures) {\n\t\t\t\t\tfor (const failure of report.failures) {\n\t\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\t\tfailure.error,\n\t\t\t\t\t\t\tfailure.pluginId,\n\t\t\t\t\t\t\t`${TOOL_EXECUTE_EVENT_ID}@${TOOL_EXECUTE_EVENT_VERSION}/${failure.kind}`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\terror,\n\t\t\t\t\t\t\"<capability-lifecycle>\",\n\t\t\t\t\t\t`${TOOL_EXECUTE_EVENT_ID}@${TOOL_EXECUTE_EVENT_VERSION}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tif (runtime.hasLifecycleEvent(TOOL_RESULT_RAW_EVENT_ID, TOOL_RESULT_RAW_EVENT_VERSION) && !signal?.aborted) {\n\t\t\ttry {\n\t\t\t\tconst data: ToolResultRawEventDataV1 = {\n\t\t\t\t\tversion: 1,\n\t\t\t\t\tsessionId: wiring.getSessionId(),\n\t\t\t\t\trevision: wiring.getRevision(),\n\t\t\t\t\ttoolCallId,\n\t\t\t\t\ttoolName,\n\t\t\t\t\tisError,\n\t\t\t\t\tcontent: detachedSessionSnapshot(toolResult.content ?? []),\n\t\t\t\t};\n\t\t\t\tconst delivery = await runtime.dispatchLifecycle({\n\t\t\t\t\ttype: TOOL_RESULT_RAW_EVENT_ID,\n\t\t\t\t\tversion: TOOL_RESULT_RAW_EVENT_VERSION,\n\t\t\t\t\tphase: \"raw\",\n\t\t\t\t\tdata,\n\t\t\t\t\tsource: \"agent-session\",\n\t\t\t\t\tcorrelationId: wiring.getTurnCorrelationId(),\n\t\t\t\t\tsignal,\n\t\t\t\t});\n\t\t\t\tfor (const failure of delivery.report.failures) {\n\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\tfailure.error,\n\t\t\t\t\t\tfailure.pluginId,\n\t\t\t\t\t\t`${TOOL_RESULT_RAW_EVENT_ID}@${TOOL_RESULT_RAW_EVENT_VERSION}/${failure.kind}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t} catch (error) {\n\t\t\t\tif (!signal?.aborted) {\n\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\terror,\n\t\t\t\t\t\t\"host\",\n\t\t\t\t\t\t`${TOOL_RESULT_RAW_EVENT_ID}@${TOOL_RESULT_RAW_EVENT_VERSION}/dispatch`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tconst content = toolResult.content ?? [];\n\t\t// Images are normalized before the transform dispatch so injected or\n\t\t// replaced images are normalized too.\n\t\tconst normalizedContent = await normalizeToolResultImages(content, {\n\t\t\tautoResizeImages: wiring.getImageAutoResize(),\n\t\t});\n\t\tconst legacyIsError = isError;\n\n\t\t// Standard tool.result.transform@1 candidate dispatch runs on the\n\t\t// normalized result candidate, after the legacy tool_result hook and\n\t\t// before the result is returned for session commit. Transform output is\n\t\t// schema-validated and identity-checked; failures propagate to the\n\t\t// agent loop's existing afterToolCall error isolation.\n\t\tlet finalContent: (typeof normalizedContent)[number][] = normalizedContent;\n\t\tlet finalIsError = legacyIsError;\n\t\tif (\n\t\t\truntime.hasLifecycleEvent(TOOL_RESULT_TRANSFORM_EVENT_ID, TOOL_RESULT_TRANSFORM_EVENT_VERSION) &&\n\t\t\t!signal?.aborted\n\t\t) {\n\t\t\tconst data: ToolResultTransformEventDataV1 = {\n\t\t\t\tversion: 1,\n\t\t\t\tsessionId: wiring.getSessionId(),\n\t\t\t\trevision: wiring.getRevision(),\n\t\t\t\ttoolCallId,\n\t\t\t\ttoolName,\n\t\t\t\tisError: legacyIsError,\n\t\t\t\tcontent: detachedSessionSnapshot(normalizedContent),\n\t\t\t};\n\t\t\ttry {\n\t\t\t\tconst delivery = await runtime.dispatchLifecycle({\n\t\t\t\t\ttype: TOOL_RESULT_TRANSFORM_EVENT_ID,\n\t\t\t\t\tversion: TOOL_RESULT_TRANSFORM_EVENT_VERSION,\n\t\t\t\t\tphase: \"candidate\",\n\t\t\t\t\tdata,\n\t\t\t\t\tsource: \"agent-session\",\n\t\t\t\t\tcorrelationId: wiring.getTurnCorrelationId(),\n\t\t\t\t\tsignal,\n\t\t\t\t});\n\t\t\t\tfor (const failure of delivery.report.failures) {\n\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\tfailure.error,\n\t\t\t\t\t\tfailure.pluginId,\n\t\t\t\t\t\t`${TOOL_RESULT_TRANSFORM_EVENT_ID}@${TOOL_RESULT_TRANSFORM_EVENT_VERSION}/${failure.kind}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst transformed = delivery.data;\n\t\t\t\tconst revision = transformed.revision;\n\t\t\t\tif (\n\t\t\t\t\ttransformed.sessionId !== data.sessionId ||\n\t\t\t\t\ttransformed.toolCallId !== data.toolCallId ||\n\t\t\t\t\ttransformed.toolName !== data.toolName ||\n\t\t\t\t\trevision.version !== data.revision.version ||\n\t\t\t\t\trevision.sessionId !== data.revision.sessionId ||\n\t\t\t\t\trevision.sequence !== data.revision.sequence ||\n\t\t\t\t\trevision.leafId !== data.revision.leafId\n\t\t\t\t) {\n\t\t\t\t\tthrow new Error(t(\"tool.result.transform transform cannot change result identity or revision\"));\n\t\t\t\t}\n\t\t\t\tfinalContent = transformed.content as (typeof normalizedContent)[number][];\n\t\t\t\tfinalIsError = transformed.isError;\n\t\t\t} catch (error) {\n\t\t\t\tconst report = (error as LifecycleFailureReport).report;\n\t\t\t\tif (report?.failures) {\n\t\t\t\t\tfor (const failure of report.failures) {\n\t\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\t\tfailure.error,\n\t\t\t\t\t\t\tfailure.pluginId,\n\t\t\t\t\t\t\t`${TOOL_RESULT_TRANSFORM_EVENT_ID}@${TOOL_RESULT_TRANSFORM_EVENT_VERSION}/${failure.kind}`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\n\t\tif (finalContent === content && finalIsError === isError) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\treturn {\n\t\t\tcontent: finalContent,\n\t\t\tdetails: toolResult.details,\n\t\t\tisError: finalIsError,\n\t\t\tusage: toolResult.usage,\n\t\t};\n\t};\n}\n\n/**\n * Default transformContext link: the explicitly selected capability context\n * strategy. Moved from the AgentSession context-transform wiring (the legacy\n * chaining wrapper keeps composing it for the pre-chain path).\n */\nfunction createDefaultTransformContextLink(\n\truntime: CapabilityRuntime,\n\twiring: AgentLoopWiringV1,\n): AgentLoopTransformContextHookV1 {\n\treturn async (messages, signal) => {\n\t\tconst strategyName = wiring.getContextStrategyName();\n\t\tif (!strategyName) return undefined;\n\t\treturn applyCapabilityContextStrategy(\n\t\t\tmessages as AgentMessage[],\n\t\t\truntime,\n\t\t\tstrategyName,\n\t\t\twiring.getSessionId(),\n\t\t\tsignal,\n\t\t);\n\t};\n}\n\n/**\n * Default prepareNextTurn link: compaction first, then the agent's\n * construction-time prepare adapter, then the system-prompt/tools/model/\n * thinking-level refresh. Moved from the AgentSession next-turn wiring.\n */\nfunction createDefaultPrepareNextTurnLink(wiring: AgentLoopWiringV1): AgentLoopPrepareNextTurnHookV1 {\n\treturn async (turn, signal) => {\n\t\tconst turnContext = turn as PrepareNextTurnContext;\n\t\tconst context = await wiring.compactBeforeNextAssistantResponse(turnContext.context, signal);\n\t\tconst previousSnapshot = await wiring.getInitialPrepareNextTurn()?.({ ...turnContext, context }, signal);\n\t\tconst nextContext = previousSnapshot?.context ?? context;\n\t\tconst refresh = wiring.getTurnRefresh();\n\n\t\treturn {\n\t\t\t...previousSnapshot,\n\t\t\tcontext: {\n\t\t\t\t...nextContext,\n\t\t\t\tsystemPrompt: refresh.systemPrompt,\n\t\t\t\ttools: refresh.tools,\n\t\t\t},\n\t\t\tmodel: refresh.model,\n\t\t\tthinkingLevel: refresh.thinkingLevel,\n\t\t};\n\t};\n}\n\n/**\n * Install the default agent-loop executor as a first-party plugin. Default\n * links register first, so third-party links registered later chain after\n * them in registration order.\n */\nexport function installBootstrapAgentLoop(\n\truntime: CapabilityRuntime,\n\twiring: AgentLoopWiringV1,\n): CapabilityPluginHandle {\n\treturn loadCapabilityPluginSync(\n\t\truntime,\n\t\t{\n\t\t\tid: BOOTSTRAP_AGENT_LOOP_PLUGIN_ID,\n\t\t\tversion: \"0.0.0\",\n\t\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\t\tentry: \"<embedded:bootstrap-agent-loop>\",\n\t\t},\n\t\t(api) => {\n\t\t\tapi.registerLoopHook(\"beforeToolCall\", createDefaultBeforeToolCallLink(runtime, wiring));\n\t\t\tapi.registerLoopHook(\"afterToolCall\", createDefaultAfterToolCallLink(runtime, wiring));\n\t\t\tapi.registerLoopHook(\"transformContext\", createDefaultTransformContextLink(runtime, wiring));\n\t\t\tapi.registerLoopHook(\"prepareNextTurn\", createDefaultPrepareNextTurnLink(wiring));\n\t\t\t// The default repeated-tool-call guard rides the public loop-hook\n\t\t\t// chains like any other first-party link; disabling this plugin\n\t\t\t// removes both of its links. It answers with two levels (judgments\n\t\t\t// can be wrong, so an irreversible stop is never the first response):\n\t\t\t// - warn (third identical call): the shouldStopAfterTurn link votes\n\t\t\t//   false and the transformContext link below injects a reminder into\n\t\t\t//   the next request view (runLoop consumes transformContext after\n\t\t\t//   shouldStopAfterTurn and before the next model call); the user-\n\t\t\t//   facing warn notice is delivered through the public SessionAPI\n\t\t\t//   sendMessage face (persisted custom_message entry with live\n\t\t\t//   message_start/message_end rendering), plus a warn log through\n\t\t\t//   the public LoggerAPI.\n\t\t\t// - stop (fifth identical call): the shouldStopAfterTurn link votes\n\t\t\t//   true; the stop notice rides agent_end newMessages, sendMessage\n\t\t\t//   persistence + rendering, and a warn log — all channels on.\n\t\t\t// Absent host features (session/logger) degrade to the remaining\n\t\t\t// channels instead of blocking the guard.\n\t\t\tconst loopGuard = createRepeatedToolCallStopPolicy({\n\t\t\t\tdeliverWarn: (notice) => {\n\t\t\t\t\tvoid api.session?.sendMessage?.(notice, { triggerTurn: false });\n\t\t\t\t},\n\t\t\t\tonWarn: (info) => {\n\t\t\t\t\tapi.logger?.warn(\"Loop guard warned the model\", {\n\t\t\t\t\t\ttool: info.toolName,\n\t\t\t\t\t\trepeats: info.warnThreshold,\n\t\t\t\t\t\targsSummary: info.argsSummary,\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t\tdeliverNotice: (notice) => {\n\t\t\t\t\tvoid api.session?.sendMessage?.(notice, { triggerTurn: false });\n\t\t\t\t},\n\t\t\t\tonStop: (info) => {\n\t\t\t\t\tapi.logger?.warn(\"Loop guard stopped the turn\", {\n\t\t\t\t\t\ttool: info.toolName,\n\t\t\t\t\t\trepeats: info.stopThreshold,\n\t\t\t\t\t\targsSummary: info.argsSummary,\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t});\n\t\t\tapi.registerLoopHook(\"shouldStopAfterTurn\", loopGuard.shouldStopAfterTurn);\n\t\t\t// Registered after the default context-strategy link, so the reminder\n\t\t\t// is appended to the final post-strategy request view (survives any\n\t\t\t// strategy pruning) at its tail.\n\t\t\tapi.registerLoopHook(\"transformContext\", loopGuard.transformContext);\n\t\t\t// The default continuation strategy reproduces the host's own\n\t\t\t// post-run decision byte for byte; a replacement strategy overrides\n\t\t\t// the continue/stop call through registerRunLoopStrategy.\n\t\t\tapi.registerRunLoopStrategy(DEFAULT_RUN_LOOP_STRATEGY_NAME, {\n\t\t\t\tdecideNextCycle: (request) => ({ continueLoop: request.hostWillContinue }),\n\t\t\t});\n\t\t},\n\t);\n}\n"]}
+{"version":3,"file":"bootstrap-agent-loop.js","sourceRoot":"","sources":["../../../src/core/extensions/bootstrap-agent-loop.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Default agent-loop bootstrap executor (W3; D-082 批 3 拆分登记).\n *\n * Registers the default main-loop event-dispatch links through the public\n * extension face so the default loop stays a replaceable first-party plugin:\n * the four default loop-hook links (capability lifecycle dispatch, image\n * normalization, context strategy, compaction + next-turn refresh).\n *\n * D-082 批 3 拆分事实：默认重复工具调用护栏（createRepeatedToolCallStopPolicy\n * 的 shouldStopAfterTurn 决策链 + transformContext 提醒注入链）与默认\n * run-loop strategy（decideNextCycle 直通）不消费 {@link AgentLoopWiringV1}，\n * 已迁出为 `plugins/agent-loop-policy`（插件 id\n * `agent-forge.plugin.agent-loop-policy`），经 sdk 的 bundled 分发通道装配；\n * 禁用面为会话装配的 `disabledPluginIds`。本模块保留的四条链是宿主事件分发\n * 装配（与 bootstrap-lifecycle 同类的内核事件机制接线）：它们消费 wiring 的\n * 会话闭包成员，无法经插件通道获得，故留宿主内嵌。\n *\n * The default links need session-bound host state (session id, revision,\n * correlation id, error observation, settings). That state is injected as\n * {@link AgentLoopWiringV1} — host wiring, not a plugin capability. Third-party\n * plugins register additional links through `api.registerLoopHook`; they run\n * after the default links in registration order (the bundled agent-loop-policy\n * plugin's guard/strategy links land in that same trailing region).\n */\n\nimport type {\n\tAgentContext,\n\tAgentLoopTurnUpdate,\n\tAgentMessage,\n\tAgentTool,\n\tPrepareNextTurnContext,\n\tThinkingLevel,\n} from \"@agent-forge/agent-core\";\nimport type { Api, ImageContent, Model, TextContent, Usage } from \"@agent-forge/ai/compat\";\nimport { normalizeToolResultImages } from \"../../utils/tool-result-images.ts\";\nimport { t } from \"../i18n/index.ts\";\nimport { type CapabilityPluginHandle, loadCapabilityPluginSync } from \"./capability-plugin.ts\";\nimport type { CapabilityRuntime } from \"./capability-runtime.ts\";\nimport { applyCapabilityContextStrategy } from \"./context-strategy-binding.ts\";\nimport {\n\tTOOL_CALL_EVENT_ID,\n\tTOOL_CALL_EVENT_VERSION,\n\tTOOL_EXECUTE_EVENT_ID,\n\tTOOL_EXECUTE_EVENT_VERSION,\n\tTOOL_RESULT_RAW_EVENT_ID,\n\tTOOL_RESULT_RAW_EVENT_VERSION,\n\tTOOL_RESULT_TRANSFORM_EVENT_ID,\n\tTOOL_RESULT_TRANSFORM_EVENT_VERSION,\n\ttype ToolCallEventDataV1,\n\ttype ToolExecuteEventDataV1,\n\ttype ToolResultRawEventDataV1,\n\ttype ToolResultTransformEventDataV1,\n} from \"./lifecycle-catalog.ts\";\nimport {\n\ttype AgentLoopAfterToolCallHookV1,\n\ttype AgentLoopBeforeToolCallHookV1,\n\ttype AgentLoopPrepareNextTurnHookV1,\n\ttype AgentLoopTransformContextHookV1,\n\tdetachedSessionSnapshot,\n\tEXPERIMENTAL_PUBLIC_API_VERSION,\n\ttype SessionRevisionV1,\n} from \"./public-api.ts\";\n\nexport const BOOTSTRAP_AGENT_LOOP_PLUGIN_ID = \"agent-forge.bootstrap-agent-loop\";\n\n/**\n * 默认 run-loop strategy 名（宿主会话配置缺省名，D-082 批 3）。策略实现本体已\n * 迁出为 `plugins/agent-loop-policy`（其 `DEFAULT_RUN_LOOP_STRATEGY_NAME` 与本\n * 值逐字相同，两侧测试各自钉值）；宿主保留该名字用于 `runLoopStrategyName`\n * 缺省解析——策略缺席时宿主回退自身的延续候选（行为不变），存在时经\n * `runtime.decideRunLoop` 咨询。\n */\nexport const DEFAULT_RUN_LOOP_STRATEGY_NAME = \"default\";\n\n/**\n * Session-bound host state the default loop links read at execution time.\n * Host wiring injected into the bootstrap executor; not part of the plugin\n * capability surface.\n */\nexport interface AgentLoopWiringV1 {\n\t/** Canonical session id for lifecycle payloads. */\n\tgetSessionId(): string;\n\t/** Detached revision snapshot captured at payload build time. */\n\tgetRevision(): SessionRevisionV1;\n\t/** Correlation id of the current prompt run, if any. */\n\tgetTurnCorrelationId(): string | undefined;\n\t/** Non-fatal delivery error sink (same surface as session-level observation). */\n\tobserveError(error: unknown, extensionPath: string, event: string): void;\n\t/** Image auto-resize setting for tool-result normalization. */\n\tgetImageAutoResize(): boolean;\n\t/** Compaction hook chained first inside the default prepareNextTurn link. */\n\tcompactBeforeNextAssistantResponse(context: AgentContext, signal?: AbortSignal): Promise<AgentContext>;\n\t/** Next-turn refresh snapshot applied last inside the default prepareNextTurn link. */\n\tgetTurnRefresh(): {\n\t\tsystemPrompt: string;\n\t\ttools: AgentTool[];\n\t\tmodel: Model<Api>;\n\t\tthinkingLevel: ThinkingLevel;\n\t};\n\t/** The agent's construction-time prepare adapter, chained after compaction. */\n\tgetInitialPrepareNextTurn():\n\t\t| ((\n\t\t\t\tcontext: PrepareNextTurnContext,\n\t\t\t\tsignal?: AbortSignal,\n\t\t  ) => Promise<AgentLoopTurnUpdate | undefined> | AgentLoopTurnUpdate | undefined)\n\t\t| undefined;\n\t/** Configured external context strategy name, if any. */\n\tgetContextStrategyName(): string | undefined;\n}\n\ninterface LifecycleFailureReport {\n\treport?: { failures?: readonly { error: unknown; pluginId: string; kind: string }[] };\n}\n\n/**\n * Default beforeToolCall link: the `tool.call@1` candidate dispatch with\n * identity/revision checks. Moved from the AgentSession tool-hook wiring.\n */\nfunction createDefaultBeforeToolCallLink(\n\truntime: CapabilityRuntime,\n\twiring: AgentLoopWiringV1,\n): AgentLoopBeforeToolCallHookV1 {\n\treturn async ({ toolCallId, toolName, args, signal }) => {\n\t\t// v8 ignore next -- bootstrap lifecycle 恒定义全部生命周期事件，其 token 在 dispose 前恒活跃，提前返回不可达\n\t\tif (!runtime.hasLifecycleEvent(TOOL_CALL_EVENT_ID, TOOL_CALL_EVENT_VERSION)) return undefined;\n\t\tconst data: ToolCallEventDataV1 = {\n\t\t\tversion: 1,\n\t\t\tsessionId: wiring.getSessionId(),\n\t\t\trevision: wiring.getRevision(),\n\t\t\ttoolCallId,\n\t\t\ttoolName,\n\t\t\tinput: detachedSessionSnapshot(args),\n\t\t};\n\t\ttry {\n\t\t\tconst delivery = await runtime.dispatchLifecycle({\n\t\t\t\ttype: TOOL_CALL_EVENT_ID,\n\t\t\t\tversion: TOOL_CALL_EVENT_VERSION,\n\t\t\t\tphase: \"candidate\",\n\t\t\t\tdata,\n\t\t\t\tsource: \"agent-session\",\n\t\t\t\tcorrelationId: wiring.getTurnCorrelationId(),\n\t\t\t\tsignal,\n\t\t\t});\n\t\t\tfor (const failure of delivery.report.failures) {\n\t\t\t\twiring.observeError(\n\t\t\t\t\tfailure.error,\n\t\t\t\t\tfailure.pluginId,\n\t\t\t\t\t`${TOOL_CALL_EVENT_ID}@${TOOL_CALL_EVENT_VERSION}/${failure.kind}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst transformed = delivery.data;\n\t\t\tconst revision = transformed.revision;\n\t\t\tif (\n\t\t\t\ttransformed.sessionId !== data.sessionId ||\n\t\t\t\ttransformed.toolCallId !== data.toolCallId ||\n\t\t\t\ttransformed.toolName !== data.toolName ||\n\t\t\t\trevision.version !== data.revision.version ||\n\t\t\t\trevision.sessionId !== data.revision.sessionId ||\n\t\t\t\trevision.sequence !== data.revision.sequence ||\n\t\t\t\trevision.leafId !== data.revision.leafId\n\t\t\t) {\n\t\t\t\tthrow new Error(t(\"tool.call transform cannot change call identity or revision\"));\n\t\t\t}\n\t\t\treturn { args: transformed.input };\n\t\t} catch (error) {\n\t\t\tconst report = (error as LifecycleFailureReport).report;\n\t\t\tif (report?.failures) {\n\t\t\t\tfor (const failure of report.failures) {\n\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\tfailure.error,\n\t\t\t\t\t\tfailure.pluginId,\n\t\t\t\t\t\t`${TOOL_CALL_EVENT_ID}@${TOOL_CALL_EVENT_VERSION}/${failure.kind}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t};\n}\n\n/**\n * Default afterToolCall link: `tool.execute@1` committed, `tool.result.raw@1`\n * raw, the legacy `tool_result` extension hook (via wiring), image\n * normalization, and the `tool.result.transform@1` candidate dispatch — in the\n * exact order the previous single AgentSession hook used. Moved from the\n * AgentSession tool-hook wiring.\n */\nfunction createDefaultAfterToolCallLink(\n\truntime: CapabilityRuntime,\n\twiring: AgentLoopWiringV1,\n): AgentLoopAfterToolCallHookV1 {\n\treturn async ({ toolCallId, toolName, args, result, isError, signal }) => {\n\t\tconst toolResult = result as {\n\t\t\tcontent?: (TextContent | ImageContent)[];\n\t\t\tdetails?: unknown;\n\t\t\tisError?: boolean;\n\t\t\tusage?: Usage;\n\t\t};\n\t\tif (runtime.hasLifecycleEvent(TOOL_EXECUTE_EVENT_ID, TOOL_EXECUTE_EVENT_VERSION)) {\n\t\t\ttry {\n\t\t\t\tconst data: ToolExecuteEventDataV1 = {\n\t\t\t\t\tversion: 1,\n\t\t\t\t\tsessionId: wiring.getSessionId(),\n\t\t\t\t\trevision: wiring.getRevision(),\n\t\t\t\t\ttoolCallId,\n\t\t\t\t\ttoolName,\n\t\t\t\t\tinput: detachedSessionSnapshot(args),\n\t\t\t\t\tisError,\n\t\t\t\t\tcontent: detachedSessionSnapshot(toolResult.content ?? []),\n\t\t\t\t};\n\t\t\t\tconst delivery = await runtime.dispatchLifecycle({\n\t\t\t\t\ttype: TOOL_EXECUTE_EVENT_ID,\n\t\t\t\t\tversion: TOOL_EXECUTE_EVENT_VERSION,\n\t\t\t\t\tphase: \"committed\",\n\t\t\t\t\tdata,\n\t\t\t\t\tsource: \"agent-session\",\n\t\t\t\t\tcorrelationId: wiring.getTurnCorrelationId(),\n\t\t\t\t});\n\t\t\t\tfor (const failure of delivery.report.failures) {\n\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\tfailure.error,\n\t\t\t\t\t\tfailure.pluginId,\n\t\t\t\t\t\t`${TOOL_EXECUTE_EVENT_ID}@${TOOL_EXECUTE_EVENT_VERSION}/${failure.kind}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t} catch (error) {\n\t\t\t\tconst report = (error as LifecycleFailureReport).report;\n\t\t\t\tif (report?.failures) {\n\t\t\t\t\tfor (const failure of report.failures) {\n\t\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\t\tfailure.error,\n\t\t\t\t\t\t\tfailure.pluginId,\n\t\t\t\t\t\t\t`${TOOL_EXECUTE_EVENT_ID}@${TOOL_EXECUTE_EVENT_VERSION}/${failure.kind}`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\terror,\n\t\t\t\t\t\t\"<capability-lifecycle>\",\n\t\t\t\t\t\t`${TOOL_EXECUTE_EVENT_ID}@${TOOL_EXECUTE_EVENT_VERSION}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tif (runtime.hasLifecycleEvent(TOOL_RESULT_RAW_EVENT_ID, TOOL_RESULT_RAW_EVENT_VERSION) && !signal?.aborted) {\n\t\t\ttry {\n\t\t\t\tconst data: ToolResultRawEventDataV1 = {\n\t\t\t\t\tversion: 1,\n\t\t\t\t\tsessionId: wiring.getSessionId(),\n\t\t\t\t\trevision: wiring.getRevision(),\n\t\t\t\t\ttoolCallId,\n\t\t\t\t\ttoolName,\n\t\t\t\t\tisError,\n\t\t\t\t\tcontent: detachedSessionSnapshot(toolResult.content ?? []),\n\t\t\t\t};\n\t\t\t\tconst delivery = await runtime.dispatchLifecycle({\n\t\t\t\t\ttype: TOOL_RESULT_RAW_EVENT_ID,\n\t\t\t\t\tversion: TOOL_RESULT_RAW_EVENT_VERSION,\n\t\t\t\t\tphase: \"raw\",\n\t\t\t\t\tdata,\n\t\t\t\t\tsource: \"agent-session\",\n\t\t\t\t\tcorrelationId: wiring.getTurnCorrelationId(),\n\t\t\t\t\tsignal,\n\t\t\t\t});\n\t\t\t\tfor (const failure of delivery.report.failures) {\n\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\tfailure.error,\n\t\t\t\t\t\tfailure.pluginId,\n\t\t\t\t\t\t`${TOOL_RESULT_RAW_EVENT_ID}@${TOOL_RESULT_RAW_EVENT_VERSION}/${failure.kind}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t} catch (error) {\n\t\t\t\tif (!signal?.aborted) {\n\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\terror,\n\t\t\t\t\t\t\"host\",\n\t\t\t\t\t\t`${TOOL_RESULT_RAW_EVENT_ID}@${TOOL_RESULT_RAW_EVENT_VERSION}/dispatch`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tconst content = toolResult.content ?? [];\n\t\t// Images are normalized before the transform dispatch so injected or\n\t\t// replaced images are normalized too.\n\t\tconst normalizedContent = await normalizeToolResultImages(content, {\n\t\t\tautoResizeImages: wiring.getImageAutoResize(),\n\t\t});\n\t\tconst legacyIsError = isError;\n\n\t\t// Standard tool.result.transform@1 candidate dispatch runs on the\n\t\t// normalized result candidate, after the legacy tool_result hook and\n\t\t// before the result is returned for session commit. Transform output is\n\t\t// schema-validated and identity-checked; failures propagate to the\n\t\t// agent loop's existing afterToolCall error isolation.\n\t\tlet finalContent: (typeof normalizedContent)[number][] = normalizedContent;\n\t\tlet finalIsError = legacyIsError;\n\t\tif (\n\t\t\truntime.hasLifecycleEvent(TOOL_RESULT_TRANSFORM_EVENT_ID, TOOL_RESULT_TRANSFORM_EVENT_VERSION) &&\n\t\t\t!signal?.aborted\n\t\t) {\n\t\t\tconst data: ToolResultTransformEventDataV1 = {\n\t\t\t\tversion: 1,\n\t\t\t\tsessionId: wiring.getSessionId(),\n\t\t\t\trevision: wiring.getRevision(),\n\t\t\t\ttoolCallId,\n\t\t\t\ttoolName,\n\t\t\t\tisError: legacyIsError,\n\t\t\t\tcontent: detachedSessionSnapshot(normalizedContent),\n\t\t\t};\n\t\t\ttry {\n\t\t\t\tconst delivery = await runtime.dispatchLifecycle({\n\t\t\t\t\ttype: TOOL_RESULT_TRANSFORM_EVENT_ID,\n\t\t\t\t\tversion: TOOL_RESULT_TRANSFORM_EVENT_VERSION,\n\t\t\t\t\tphase: \"candidate\",\n\t\t\t\t\tdata,\n\t\t\t\t\tsource: \"agent-session\",\n\t\t\t\t\tcorrelationId: wiring.getTurnCorrelationId(),\n\t\t\t\t\tsignal,\n\t\t\t\t});\n\t\t\t\tfor (const failure of delivery.report.failures) {\n\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\tfailure.error,\n\t\t\t\t\t\tfailure.pluginId,\n\t\t\t\t\t\t`${TOOL_RESULT_TRANSFORM_EVENT_ID}@${TOOL_RESULT_TRANSFORM_EVENT_VERSION}/${failure.kind}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst transformed = delivery.data;\n\t\t\t\tconst revision = transformed.revision;\n\t\t\t\tif (\n\t\t\t\t\ttransformed.sessionId !== data.sessionId ||\n\t\t\t\t\ttransformed.toolCallId !== data.toolCallId ||\n\t\t\t\t\ttransformed.toolName !== data.toolName ||\n\t\t\t\t\trevision.version !== data.revision.version ||\n\t\t\t\t\trevision.sessionId !== data.revision.sessionId ||\n\t\t\t\t\trevision.sequence !== data.revision.sequence ||\n\t\t\t\t\trevision.leafId !== data.revision.leafId\n\t\t\t\t) {\n\t\t\t\t\tthrow new Error(t(\"tool.result.transform transform cannot change result identity or revision\"));\n\t\t\t\t}\n\t\t\t\tfinalContent = transformed.content as (typeof normalizedContent)[number][];\n\t\t\t\tfinalIsError = transformed.isError;\n\t\t\t} catch (error) {\n\t\t\t\tconst report = (error as LifecycleFailureReport).report;\n\t\t\t\tif (report?.failures) {\n\t\t\t\t\tfor (const failure of report.failures) {\n\t\t\t\t\t\twiring.observeError(\n\t\t\t\t\t\t\tfailure.error,\n\t\t\t\t\t\t\tfailure.pluginId,\n\t\t\t\t\t\t\t`${TOOL_RESULT_TRANSFORM_EVENT_ID}@${TOOL_RESULT_TRANSFORM_EVENT_VERSION}/${failure.kind}`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\n\t\tif (finalContent === content && finalIsError === isError) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\treturn {\n\t\t\tcontent: finalContent,\n\t\t\tdetails: toolResult.details,\n\t\t\tisError: finalIsError,\n\t\t\tusage: toolResult.usage,\n\t\t};\n\t};\n}\n\n/**\n * Default transformContext link: the explicitly selected capability context\n * strategy. Moved from the AgentSession context-transform wiring (the legacy\n * chaining wrapper keeps composing it for the pre-chain path).\n */\nfunction createDefaultTransformContextLink(\n\truntime: CapabilityRuntime,\n\twiring: AgentLoopWiringV1,\n): AgentLoopTransformContextHookV1 {\n\treturn async (messages, signal) => {\n\t\tconst strategyName = wiring.getContextStrategyName();\n\t\tif (!strategyName) return undefined;\n\t\treturn applyCapabilityContextStrategy(\n\t\t\tmessages as AgentMessage[],\n\t\t\truntime,\n\t\t\tstrategyName,\n\t\t\twiring.getSessionId(),\n\t\t\tsignal,\n\t\t);\n\t};\n}\n\n/**\n * Default prepareNextTurn link: compaction first, then the agent's\n * construction-time prepare adapter, then the system-prompt/tools/model/\n * thinking-level refresh. Moved from the AgentSession next-turn wiring.\n */\nfunction createDefaultPrepareNextTurnLink(wiring: AgentLoopWiringV1): AgentLoopPrepareNextTurnHookV1 {\n\treturn async (turn, signal) => {\n\t\tconst turnContext = turn as PrepareNextTurnContext;\n\t\tconst context = await wiring.compactBeforeNextAssistantResponse(turnContext.context, signal);\n\t\tconst previousSnapshot = await wiring.getInitialPrepareNextTurn()?.({ ...turnContext, context }, signal);\n\t\tconst nextContext = previousSnapshot?.context ?? context;\n\t\tconst refresh = wiring.getTurnRefresh();\n\n\t\treturn {\n\t\t\t...previousSnapshot,\n\t\t\tcontext: {\n\t\t\t\t...nextContext,\n\t\t\t\tsystemPrompt: refresh.systemPrompt,\n\t\t\t\ttools: refresh.tools,\n\t\t\t},\n\t\t\tmodel: refresh.model,\n\t\t\tthinkingLevel: refresh.thinkingLevel,\n\t\t};\n\t};\n}\n\n/**\n * Install the default agent-loop executor as a first-party plugin. Default\n * links register first, so third-party links registered later chain after\n * them in registration order.\n */\nexport function installBootstrapAgentLoop(\n\truntime: CapabilityRuntime,\n\twiring: AgentLoopWiringV1,\n): CapabilityPluginHandle {\n\treturn loadCapabilityPluginSync(\n\t\truntime,\n\t\t{\n\t\t\tid: BOOTSTRAP_AGENT_LOOP_PLUGIN_ID,\n\t\t\tversion: \"0.0.0\",\n\t\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\t\tentry: \"<embedded:bootstrap-agent-loop>\",\n\t\t},\n\t\t(api) => {\n\t\t\tapi.registerLoopHook(\"beforeToolCall\", createDefaultBeforeToolCallLink(runtime, wiring));\n\t\t\tapi.registerLoopHook(\"afterToolCall\", createDefaultAfterToolCallLink(runtime, wiring));\n\t\t\tapi.registerLoopHook(\"transformContext\", createDefaultTransformContextLink(runtime, wiring));\n\t\t\tapi.registerLoopHook(\"prepareNextTurn\", createDefaultPrepareNextTurnLink(wiring));\n\t\t\t// D-082 批 3：默认重复工具调用护栏（shouldStopAfterTurn 决策链 +\n\t\t\t// transformContext 提醒注入链）与默认 run-loop strategy 不再在此注册——\n\t\t\t// 它们不消费 wiring，已迁出为 plugins/agent-loop-policy\n\t\t\t// （agent-forge.plugin.agent-loop-policy），经 sdk bundled 分发通道装配；\n\t\t\t// 其链接在本执行器之后注册，落链顺序与内嵌时代一致（护栏注入链仍在\n\t\t\t// 默认上下文策略链之后、第三方链接之前）。\n\t\t},\n\t);\n}\n"]}

package/dist/core/extensions/capability-runtime-types.d.ts

@@ -260,9 +260,11 @@ export interface CapabilityRuntime {
     /**
      * Ordered stream-function wrappers registered through the public
      * `registerStreamFnWrapper` face (provider-failover family), filtered by
-     * active owners, in registration order (first registered = outermost).
-     * The host's default stream assembly composes them around its own stream
-     * call at request time.
+     * active owners, sorted by (priority ascending, registration order
+     * ascending) — lower priority wraps outermost; equal priorities keep
+     * registration order (first registered = outermost), the pre-priority
+     * semantics (contract A, D-082 批 3b). The host's default stream assembly
+     * composes them around its own stream call at request time.
      */
     getStreamFnWrappers(): readonly StreamFnWrapper[];
     getOperationStatus(id: string): OperationStatus | undefined;