@agentdevjs/core 0.1.0 → 0.1.1

package/dist/BasicAgent-UBGLABDV.js

@@ -0,0 +1,12 @@
+import {
+  BasicAgent
+} from "./chunk-YYNP7MZC.js";
+import "./chunk-TKVOWEJ2.js";
+import "./chunk-OFBE43IS.js";
+import "./chunk-U3LWOJ3Q.js";
+import "./chunk-KCCLSQC4.js";
+import "./chunk-DGUM43GV.js";
+export {
+  BasicAgent
+};
+//# sourceMappingURL=BasicAgent-UBGLABDV.js.map

package/dist/ExplorerAgent-C62LOUTX.js

@@ -0,0 +1,12 @@
+import {
+  ExplorerAgent
+} from "./chunk-V3WM6EII.js";
+import "./chunk-TKVOWEJ2.js";
+import "./chunk-OFBE43IS.js";
+import "./chunk-U3LWOJ3Q.js";
+import "./chunk-KCCLSQC4.js";
+import "./chunk-DGUM43GV.js";
+export {
+  ExplorerAgent
+};
+//# sourceMappingURL=ExplorerAgent-C62LOUTX.js.map

package/dist/{chunk-BVF7RUXV.js → chunk-KCCLSQC4.js}

@@ -133,4 +133,4 @@ var PlaceholderResolver = class _PlaceholderResolver {
 export {
   PlaceholderResolver
 };
-//# sourceMappingURL=chunk-BVF7RUXV.js.map
+//# sourceMappingURL=chunk-KCCLSQC4.js.map

package/dist/chunk-KCCLSQC4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/template/resolver.ts"],"sourcesContent":["/**\r\n * 占位符解析器\r\n * 使用正则表达式实现占位符替换\r\n */\r\n\r\nimport type { PlaceholderContext } from './types.js';\r\n\r\n/**\r\n * 占位符解析器\r\n */\r\nexport class PlaceholderResolver {\r\n  // 正则表达式模式\r\n  private static PATTERNS = {\r\n    // {{#each}}...{{/each}} 循环渲染\r\n    each: /\\{\\{#each\\}\\}(.*?)\\{\\{\\/each\\}\\}/gs,\r\n    // {{#if}}...{{/if}} 条件渲染\r\n    conditional: /\\{\\{#if\\}\\}(.*?)\\{\\{\\/if\\}\\}/gs,\r\n    // {{variable}} 或 {{obj.key}} 或 {{var|default}}\r\n    variable: /\\{\\{([^}]+)\\}\\}/g,\r\n  };\r\n\r\n  /**\r\n   * 解析模板中的占位符\r\n   * @param template 模板内容\r\n   * @param context 变量上下文\r\n   * @returns 解析后的内容\r\n   */\r\n  static resolve(template: string, context: PlaceholderContext = {}): string {\r\n    // 1. 处理循环渲染 {{#each}}...{{/each}}\r\n    let result = PlaceholderResolver.processEach(template, context);\r\n\r\n    // 2. 处理条件渲染 {{#if}}...{{/if}}\r\n    result = PlaceholderResolver.processConditionals(result, context);\r\n\r\n    // 2. 处理变量替换（支持嵌套和默认值）\r\n    result = result.replace(PlaceholderResolver.PATTERNS.variable, (_, expr) => {\r\n      const trimmed = expr.trim();\r\n\r\n      // 分离默认值: var|default\r\n      const pipeIndex = trimmed.indexOf('|');\r\n      let path: string;\r\n      let defaultValue: string | undefined;\r\n\r\n      if (pipeIndex !== -1) {\r\n        path = trimmed.slice(0, pipeIndex).trim();\r\n        defaultValue = trimmed.slice(pipeIndex + 1).trim();\r\n      } else {\r\n        path = trimmed;\r\n      }\r\n\r\n      // 获取值（支持嵌套访问）\r\n      const value = PlaceholderResolver.getNestedValue(context, path);\r\n\r\n      // 返回值或默认值\r\n      if (value !== undefined && value !== null) {\r\n        return String(value);\r\n      }\r\n      return defaultValue ?? '';\r\n    });\r\n\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * 处理循环渲染 {{#each}}...{{/each}}\r\n   * 格式：{{#each}}arrayName\r\n   *   ...template...\r\n   * {{/each}}\r\n   * 在循环内可使用数组元素的字段（如 {{name}}, {{description}}）或 {{this}} 引用整个对象\r\n   */\r\n  private static processEach(\r\n    template: string,\r\n    context: PlaceholderContext\r\n  ): string {\r\n    return template.replace(\r\n      PlaceholderResolver.PATTERNS.each,\r\n      (match, body: string) => {\r\n        // 解析内容：第一行是数组变量名，其余是循环模板\r\n        const lines = body.split('\\n');\r\n        const arrayName = lines[0].trim();\r\n        const loopTemplate = lines.slice(1).join('\\n');\r\n\r\n        // 获取数组数据\r\n        const array = PlaceholderResolver.getNestedValue(context, arrayName);\r\n\r\n        // 不是数组则返回空\r\n        if (!Array.isArray(array)) {\r\n          return '';\r\n        }\r\n\r\n        // 渲染每个元素\r\n        return array.map((item) => {\r\n          // 将 item 的字段作为上下文，也提供 this 引用整个对象\r\n          const itemContext: PlaceholderContext = {\r\n            ...context,\r\n            ...item,\r\n            this: item,\r\n          };\r\n          return PlaceholderResolver.resolve(loopTemplate, itemContext);\r\n        }).join('');\r\n      });\r\n  }\r\n\r\n  /**\r\n   * 处理条件渲染 {{#if}}...{{/if}}\r\n   * 条件格式：{{#if}}varName{{/if}} - 只有当 varName 为真时才显示内容\r\n   */\r\n  private static processConditionals(\r\n    template: string,\r\n    context: PlaceholderContext\r\n  ): string {\r\n    return template.replace(\r\n      PlaceholderResolver.PATTERNS.conditional,\r\n    (_, content: string) => {\r\n      // 检查条件变量是否存在且为真\r\n      const trimmed = content.trim();\r\n      const value = PlaceholderResolver.getNestedValue(context, trimmed);\r\n\r\n      // 布尔值判断\r\n      if (value === true || value === 1 || value === 'true') {\r\n        return '';  // 条件为真，保留内容（但这里逻辑反了，应该返回内容）\r\n      }\r\n      if (value) {\r\n        return content;\r\n      }\r\n      return '';  // 条件为假，移除内容\r\n    });\r\n  }\r\n\r\n  /**\r\n   * 获取嵌套对象的值\r\n   * 支持点号分隔的路径，如 \"user.name\"\r\n   */\r\n  private static getNestedValue(obj: any, path: string): any {\r\n    const keys = path.split('.');\r\n    let current = obj;\r\n\r\n    for (const key of keys) {\r\n      if (current === null || current === undefined) {\r\n        return undefined;\r\n      }\r\n      current = current[key];\r\n    }\r\n\r\n    return current;\r\n  }\r\n\r\n  /**\r\n   * 获取模板中使用的变量列表\r\n   */\r\n  static extractVariables(template: string): string[] {\r\n    const variables = new Set<string>();\r\n    let match: RegExpExecArray | null;\r\n\r\n    // 提取所有变量（不包括条件渲染）\r\n    const regex = /\\{\\{([^}|]+?)(?:\\|[^}]*)?\\}\\}/g;\r\n    while ((match = regex.exec(template)) !== null) {\r\n      variables.add(match[1].trim());\r\n    }\r\n\r\n    return Array.from(variables);\r\n  }\r\n\r\n  /**\r\n   * 验证上下文是否包含所需变量\r\n   * @returns 缺失的变量数组\r\n   */\r\n  static validate(\r\n    template: string,\r\n    context: PlaceholderContext\r\n  ): string[] {\r\n    const required = PlaceholderResolver.extractVariables(template);\r\n    const missing: string[] = [];\r\n\r\n    for (const path of required) {\r\n      const value = PlaceholderResolver.getNestedValue(context, path);\r\n      if (value === undefined || value === null || value === '') {\r\n        missing.push(path);\r\n      }\r\n    }\r\n\r\n    return missing;\r\n  }\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/{chunk-KO4DJKM6.js → chunk-OFBE43IS.js}

@@ -96,4 +96,4 @@ export {
   emitTurnCompleted,
   emitTurnFailed
 };
-//# sourceMappingURL=chunk-KO4DJKM6.js.map
+//# sourceMappingURL=chunk-OFBE43IS.js.map

package/dist/{chunk-KO4DJKM6.js.map → chunk-OFBE43IS.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/session-events.ts"],"sourcesContent":["/**\r\n * Session Events - 会话事件流\r\n *\r\n * 职责：\r\n * - 定义无头模式（headless）消费的会话事件模型（codex exec 风格）\r\n * - 提供进程内订阅 API，消息变更单点发射\r\n *\r\n * 与通知系统（notification.ts）的分工：\r\n * - notification 是 UI 状态信号：节流、轻量、面向 Web UI 进度指示\r\n * - session event 是审计数据：不节流、完整、面向无头模式 stdout JSONL\r\n *\r\n * 事件模型（对齐 codex exec JSONL）：\r\n * - thread.started  线程（会话）开始\r\n * - turn.started    一次用户输入触发的回合开始\r\n * - item.started / item.completed  会话条目生命周期\r\n * - turn.completed  回合完成（含 token 用量）\r\n * - turn.failed     回合失败\r\n *\r\n * 术语（ADR-0002/Q6，一词不混用）：本事件流里的 `thread.started` 的 thread\r\n * 指**会话本身**（codex exec 对外 jsonl 审计契约，永不改义）；框架的接续链概念\r\n * 定名 **WorkThread**（见 `core/workthread/`），一处不混用。\r\n *\r\n * item 类型：\r\n * - agent_message  agent 的自然语言回复\r\n * - reasoning      agent 的思考摘要\r\n * - tool_call      工具调用（参数、结果、错误、状态）\r\n */\r\n\r\nimport type { LLMResponse, ToolCall } from './types.js';\r\nimport type { ToolExecResult } from './context.js';\r\n\r\n// ========== Item 模型 ==========\r\n\r\nexport interface SessionItemBase {\r\n  /** 条目唯一 ID：tool_call 用 LLM 生成的 call.id，其余用递增 item_N */\r\n  id: string;\r\n  /** 所属回合（callIndex） */\r\n  turn: number;\r\n}\r\n\r\nexport interface AgentMessageItem extends SessionItemBase {\r\n  type: 'agent_message';\r\n  text: string;\r\n}\r\n\r\nexport interface ReasoningItem extends SessionItemBase {\r\n  type: 'reasoning';\r\n  text: string;\r\n}\r\n\r\nexport type ToolCallStatus = 'in_progress' | 'completed' | 'failed';\r\n\r\nexport interface ToolCallItem extends SessionItemBase {\r\n  type: 'tool_call';\r\n  /** 工具名称（如 shell / read / lsp_hover） */\r\n  tool: string;\r\n  /** 工具调用参数 */\r\n  arguments?: unknown;\r\n  status: ToolCallStatus;\r\n  /** 成功时的结果内容 */\r\n  result?: unknown;\r\n  /** 失败时的错误信息 */\r\n  error?: string;\r\n  /**\r\n   * 终止标注（ticket 023 / ADR-0005）：工具被超时/用户打断终止但仍在 settle\r\n   * 窗口内收尾时出现。success 结果可携带此字段，无头 jsonl 审计据此区分\r\n   * 正常完成与被终止收尾。\r\n   */\r\n  interrupted?: { reason: 'timeout' | 'user' };\r\n}\r\n\r\nexport type SessionItem = AgentMessageItem | ReasoningItem | ToolCallItem;\r\n\r\n// ========== 事件模型 ==========\r\n\r\nexport interface TurnUsage {\r\n  inputTokens: number;\r\n  outputTokens: number;\r\n  totalTokens: number;\r\n}\r\n\r\n/**\r\n * 回合失败的结构化事实。\r\n *\r\n * message 只供人读；reason/category/retryable 供机器分流，\r\n * 与 CallOutcome 对齐（无头 CLI/JSONL 消费同一套语义）。\r\n */\r\nexport interface TurnFailure {\r\n  message: string;\r\n  /** 框架级终止原因（ExecutionReason） */\r\n  reason?: string;\r\n  /** 分类错误类型（APIErrorType / runtime_error / exception） */\r\n  category?: string;\r\n  statusCode?: number;\r\n  retryable?: boolean;\r\n}\r\n\r\nexport type SessionEvent =\r\n  | { type: 'thread.started'; threadId: string }\r\n  | { type: 'turn.started'; turn: number }\r\n  | { type: 'item.started'; item: SessionItem }\r\n  | { type: 'item.completed'; item: SessionItem }\r\n  | { type: 'turn.completed'; turn: number; usage?: TurnUsage }\r\n  | { type: 'turn.failed'; turn: number; error: TurnFailure };\r\n\r\nexport type SessionEventListener = (event: SessionEvent) => void;\r\n\r\n// ========== 订阅管理 ==========\r\n\r\nconst listeners = new Set<SessionEventListener>();\r\n\r\nlet nextItemSeq = 0;\r\n\r\nfunction nextItemId(): string {\r\n  return `item_${nextItemSeq++}`;\r\n}\r\n\r\n/**\r\n * 订阅会话事件流。\r\n * @returns 退订函数\r\n */\r\nexport function subscribeSessionEvents(listener: SessionEventListener): () => void {\r\n  listeners.add(listener);\r\n  return () => {\r\n    listeners.delete(listener);\r\n  };\r\n}\r\n\r\n/**\r\n * 发射会话事件。无订阅者时零开销。\r\n */\r\nexport function emitSessionEvent(event: SessionEvent): void {\r\n  if (listeners.size === 0) return;\r\n  for (const listener of listeners) {\r\n    try {\r\n      listener(event);\r\n    } catch {\r\n      // 订阅者异常不影响主流程\r\n    }\r\n  }\r\n}\r\n\r\n// ========== 发射辅助（context / agent 调用） ==========\r\n\r\n/**\r\n * 发射 assistant 响应产生的条目事件：\r\n * reasoning / agent_message 以 completed 出现（一次性内容），\r\n * 每个 toolCall 以 started 出现（等待执行结果）。\r\n */\r\nexport function emitAssistantResponseEvents(response: LLMResponse, turn: number): void {\r\n  if (listeners.size === 0) return;\r\n\r\n  if (response.reasoning && response.reasoning.trim()) {\r\n    emitSessionEvent({\r\n      type: 'item.completed',\r\n      item: { id: nextItemId(), turn, type: 'reasoning', text: response.reasoning },\r\n    });\r\n  }\r\n\r\n  if (response.content && response.content.trim()) {\r\n    emitSessionEvent({\r\n      type: 'item.completed',\r\n      item: { id: nextItemId(), turn, type: 'agent_message', text: response.content },\r\n    });\r\n  }\r\n\r\n  if (response.toolCalls) {\r\n    for (const call of response.toolCalls) {\r\n      emitSessionEvent({\r\n        type: 'item.started',\r\n        item: {\r\n          id: call.id ?? nextItemId(),\r\n          turn,\r\n          type: 'tool_call',\r\n          tool: call.name,\r\n          arguments: call.arguments,\r\n          status: 'in_progress',\r\n        },\r\n      });\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * 发射工具结果条目事件（与 emitAssistantResponseEvents 的 started 配对，靠 call.id 关联）。\r\n */\r\nexport function emitToolResultEvents(call: ToolCall, result: ToolExecResult, turn: number): void {\r\n  if (listeners.size === 0) return;\r\n\r\n  emitSessionEvent({\r\n    type: 'item.completed',\r\n    item: {\r\n      id: call.id ?? nextItemId(),\r\n      turn,\r\n      type: 'tool_call',\r\n      tool: call.name,\r\n      arguments: call.arguments,\r\n      status: result.success ? 'completed' : 'failed',\r\n      ...(result.success\r\n        ? { result: result.result }\r\n        : { error: result.error ?? 'tool execution failed' }),\r\n      ...(result.interrupted ? { interrupted: result.interrupted } : {}),\r\n    },\r\n  });\r\n}\r\n\r\n/**\r\n * 发射回合完成事件（附 token 用量）。\r\n */\r\nexport function emitTurnCompleted(turn: number, usage?: TurnUsage): void {\r\n  emitSessionEvent({ type: 'turn.completed', turn, ...(usage ? { usage } : {}) });\r\n}\r\n\r\n/**\r\n * 发射回合失败事件。\r\n *\r\n * 支持两种入参：\r\n * - CallOutcome（agent.ts 主链路）：展开为结构化 TurnFailure\r\n * - 简单 message（宿主致命错误等）：仅带 message\r\n */\r\nexport function emitTurnFailed(turn: number, source: string | import('./lifecycle.js').CallOutcome): void {\r\n  if (typeof source === 'string') {\r\n    emitSessionEvent({ type: 'turn.failed', turn, error: { message: source } });\r\n    return;\r\n  }\r\n  emitSessionEvent({\r\n    type: 'turn.failed',\r\n    turn,\r\n    error: {\r\n      message: source.error?.message ?? source.response ?? source.reason,\r\n      reason: source.reason,\r\n      ...(source.error ? {\r\n        category: source.error.category,\r\n        ...(typeof source.error.statusCode === 'number' ? { statusCode: source.error.statusCode } : {}),\r\n        ...(typeof source.error.retryable === 'boolean' ? { retryable: source.error.retryable } : {}),\r\n      } : {}),\r\n    },\r\n  });\r\n}\r\n"],"mappings":";AA6GA,IAAM,YAAY,oBAAI,IAA0B;AAEhD,IAAI,cAAc;AAElB,SAAS,aAAqB;AAC5B,SAAO,QAAQ,aAAa;AAC9B;AAMO,SAAS,uBAAuB,UAA4C;AACjF,YAAU,IAAI,QAAQ;AACtB,SAAO,MAAM;AACX,cAAU,OAAO,QAAQ;AAAA,EAC3B;AACF;AAKO,SAAS,iBAAiB,OAA2B;AAC1D,MAAI,UAAU,SAAS,EAAG;AAC1B,aAAW,YAAY,WAAW;AAChC,QAAI;AACF,eAAS,KAAK;AAAA,IAChB,QAAQ;AAAA,IAER;AAAA,EACF;AACF;AASO,SAAS,4BAA4B,UAAuB,MAAoB;AACrF,MAAI,UAAU,SAAS,EAAG;AAE1B,MAAI,SAAS,aAAa,SAAS,UAAU,KAAK,GAAG;AACnD,qBAAiB;AAAA,MACf,MAAM;AAAA,MACN,MAAM,EAAE,IAAI,WAAW,GAAG,MAAM,MAAM,aAAa,MAAM,SAAS,UAAU;AAAA,IAC9E,CAAC;AAAA,EACH;AAEA,MAAI,SAAS,WAAW,SAAS,QAAQ,KAAK,GAAG;AAC/C,qBAAiB;AAAA,MACf,MAAM;AAAA,MACN,MAAM,EAAE,IAAI,WAAW,GAAG,MAAM,MAAM,iBAAiB,MAAM,SAAS,QAAQ;AAAA,IAChF,CAAC;AAAA,EACH;AAEA,MAAI,SAAS,WAAW;AACtB,eAAW,QAAQ,SAAS,WAAW;AACrC,uBAAiB;AAAA,QACf,MAAM;AAAA,QACN,MAAM;AAAA,UACJ,IAAI,KAAK,MAAM,WAAW;AAAA,UAC1B;AAAA,UACA,MAAM;AAAA,UACN,MAAM,KAAK;AAAA,UACX,WAAW,KAAK;AAAA,UAChB,QAAQ;AAAA,QACV;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAKO,SAAS,qBAAqB,MAAgB,QAAwB,MAAoB;AAC/F,MAAI,UAAU,SAAS,EAAG;AAE1B,mBAAiB;AAAA,IACf,MAAM;AAAA,IACN,MAAM;AAAA,MACJ,IAAI,KAAK,MAAM,WAAW;AAAA,MAC1B;AAAA,MACA,MAAM;AAAA,MACN,MAAM,KAAK;AAAA,MACX,WAAW,KAAK;AAAA,MAChB,QAAQ,OAAO,UAAU,cAAc;AAAA,MACvC,GAAI,OAAO,UACP,EAAE,QAAQ,OAAO,OAAO,IACxB,EAAE,OAAO,OAAO,SAAS,wBAAwB;AAAA,MACrD,GAAI,OAAO,cAAc,EAAE,aAAa,OAAO,YAAY,IAAI,CAAC;AAAA,IAClE;AAAA,EACF,CAAC;AACH;AAKO,SAAS,kBAAkB,MAAc,OAAyB;AACvE,mBAAiB,EAAE,MAAM,kBAAkB,MAAM,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,EAAG,CAAC;AAChF;AASO,SAAS,eAAe,MAAc,QAA6D;AACxG,MAAI,OAAO,WAAW,UAAU;AAC9B,qBAAiB,EAAE,MAAM,eAAe,MAAM,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;AAC1E;AAAA,EACF;AACA,mBAAiB;AAAA,IACf,MAAM;AAAA,IACN;AAAA,IACA,OAAO;AAAA,MACL,SAAS,OAAO,OAAO,WAAW,OAAO,YAAY,OAAO;AAAA,MAC5D,QAAQ,OAAO;AAAA,MACf,GAAI,OAAO,QAAQ;AAAA,QACjB,UAAU,OAAO,MAAM;AAAA,QACvB,GAAI,OAAO,OAAO,MAAM,eAAe,WAAW,EAAE,YAAY,OAAO,MAAM,WAAW,IAAI,CAAC;AAAA,QAC7F,GAAI,OAAO,OAAO,MAAM,cAAc,YAAY,EAAE,WAAW,OAAO,MAAM,UAAU,IAAI,CAAC;AAAA,MAC7F,IAAI,CAAC;AAAA,IACP;AAAA,EACF,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../src/core/session-events.ts"],"sourcesContent":["/**\r\n * Session Events - 会话事件流\r\n *\r\n * 职责：\r\n * - 定义无头模式（headless）消费的会话事件模型（codex exec 风格）\r\n * - 提供进程内订阅 API，消息变更单点发射\r\n *\r\n * 与通知系统（notification.ts）的分工：\r\n * - notification 是 UI 状态信号：节流、轻量、面向 Web UI 进度指示\r\n * - session event 是审计数据：不节流、完整、面向无头模式 stdout JSONL\r\n *\r\n * 事件模型（对齐 codex exec JSONL）：\r\n * - thread.started  线程（会话）开始\r\n * - turn.started    一次用户输入触发的回合开始\r\n * - item.started / item.completed  会话条目生命周期\r\n * - turn.completed  回合完成（含 token 用量）\r\n * - turn.failed     回合失败\r\n *\r\n * 术语（ADR-0002/Q6，一词不混用）：本事件流里的 `thread.started` 的 thread\r\n * 指**会话本身**（codex exec 对外 jsonl 审计契约，永不改义）；框架的接续链概念\r\n * 定名 **WorkThread**（见 `core/workthread/`），一处不混用。\r\n *\r\n * item 类型：\r\n * - agent_message  agent 的自然语言回复\r\n * - reasoning      agent 的思考摘要\r\n * - tool_call      工具调用（参数、结果、错误、状态）\r\n */\r\n\r\nimport type { LLMResponse, ToolCall } from './types.js';\r\nimport type { ToolExecResult } from './context.js';\r\n\r\n// ========== Item 模型 ==========\r\n\r\nexport interface SessionItemBase {\r\n  /** 条目唯一 ID：tool_call 用 LLM 生成的 call.id，其余用递增 item_N */\r\n  id: string;\r\n  /** 所属回合（callIndex） */\r\n  turn: number;\r\n}\r\n\r\nexport interface AgentMessageItem extends SessionItemBase {\r\n  type: 'agent_message';\r\n  text: string;\r\n}\r\n\r\nexport interface ReasoningItem extends SessionItemBase {\r\n  type: 'reasoning';\r\n  text: string;\r\n}\r\n\r\nexport type ToolCallStatus = 'in_progress' | 'completed' | 'failed';\r\n\r\nexport interface ToolCallItem extends SessionItemBase {\r\n  type: 'tool_call';\r\n  /** 工具名称（如 shell / read / lsp_hover） */\r\n  tool: string;\r\n  /** 工具调用参数 */\r\n  arguments?: unknown;\r\n  status: ToolCallStatus;\r\n  /** 成功时的结果内容 */\r\n  result?: unknown;\r\n  /** 失败时的错误信息 */\r\n  error?: string;\r\n  /**\r\n   * 终止标注（ticket 023 / ADR-0005）：工具被超时/用户打断终止但仍在 settle\r\n   * 窗口内收尾时出现。success 结果可携带此字段，无头 jsonl 审计据此区分\r\n   * 正常完成与被终止收尾。\r\n   */\r\n  interrupted?: { reason: 'timeout' | 'user' };\r\n}\r\n\r\nexport type SessionItem = AgentMessageItem | ReasoningItem | ToolCallItem;\r\n\r\n// ========== 事件模型 ==========\r\n\r\nexport interface TurnUsage {\r\n  inputTokens: number;\r\n  outputTokens: number;\r\n  totalTokens: number;\r\n}\r\n\r\n/**\r\n * 回合失败的结构化事实。\r\n *\r\n * message 只供人读；reason/category/retryable 供机器分流，\r\n * 与 CallOutcome 对齐（无头 CLI/JSONL 消费同一套语义）。\r\n */\r\nexport interface TurnFailure {\r\n  message: string;\r\n  /** 框架级终止原因（ExecutionReason） */\r\n  reason?: string;\r\n  /** 分类错误类型（APIErrorType / runtime_error / exception） */\r\n  category?: string;\r\n  statusCode?: number;\r\n  retryable?: boolean;\r\n}\r\n\r\nexport type SessionEvent =\r\n  | { type: 'thread.started'; threadId: string }\r\n  | { type: 'turn.started'; turn: number }\r\n  | { type: 'item.started'; item: SessionItem }\r\n  | { type: 'item.completed'; item: SessionItem }\r\n  | { type: 'turn.completed'; turn: number; usage?: TurnUsage }\r\n  | { type: 'turn.failed'; turn: number; error: TurnFailure };\r\n\r\nexport type SessionEventListener = (event: SessionEvent) => void;\r\n\r\n// ========== 订阅管理 ==========\r\n\r\nconst listeners = new Set<SessionEventListener>();\r\n\r\nlet nextItemSeq = 0;\r\n\r\nfunction nextItemId(): string {\r\n  return `item_${nextItemSeq++}`;\r\n}\r\n\r\n/**\r\n * 订阅会话事件流。\r\n * @returns 退订函数\r\n */\r\nexport function subscribeSessionEvents(listener: SessionEventListener): () => void {\r\n  listeners.add(listener);\r\n  return () => {\r\n    listeners.delete(listener);\r\n  };\r\n}\r\n\r\n/**\r\n * 发射会话事件。无订阅者时零开销。\r\n */\r\nexport function emitSessionEvent(event: SessionEvent): void {\r\n  if (listeners.size === 0) return;\r\n  for (const listener of listeners) {\r\n    try {\r\n      listener(event);\r\n    } catch {\r\n      // 订阅者异常不影响主流程\r\n    }\r\n  }\r\n}\r\n\r\n// ========== 发射辅助（context / agent 调用） ==========\r\n\r\n/**\r\n * 发射 assistant 响应产生的条目事件：\r\n * reasoning / agent_message 以 completed 出现（一次性内容），\r\n * 每个 toolCall 以 started 出现（等待执行结果）。\r\n */\r\nexport function emitAssistantResponseEvents(response: LLMResponse, turn: number): void {\r\n  if (listeners.size === 0) return;\r\n\r\n  if (response.reasoning && response.reasoning.trim()) {\r\n    emitSessionEvent({\r\n      type: 'item.completed',\r\n      item: { id: nextItemId(), turn, type: 'reasoning', text: response.reasoning },\r\n    });\r\n  }\r\n\r\n  if (response.content && response.content.trim()) {\r\n    emitSessionEvent({\r\n      type: 'item.completed',\r\n      item: { id: nextItemId(), turn, type: 'agent_message', text: response.content },\r\n    });\r\n  }\r\n\r\n  if (response.toolCalls) {\r\n    for (const call of response.toolCalls) {\r\n      emitSessionEvent({\r\n        type: 'item.started',\r\n        item: {\r\n          id: call.id ?? nextItemId(),\r\n          turn,\r\n          type: 'tool_call',\r\n          tool: call.name,\r\n          arguments: call.arguments,\r\n          status: 'in_progress',\r\n        },\r\n      });\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * 发射工具结果条目事件（与 emitAssistantResponseEvents 的 started 配对，靠 call.id 关联）。\r\n */\r\nexport function emitToolResultEvents(call: ToolCall, result: ToolExecResult, turn: number): void {\r\n  if (listeners.size === 0) return;\r\n\r\n  emitSessionEvent({\r\n    type: 'item.completed',\r\n    item: {\r\n      id: call.id ?? nextItemId(),\r\n      turn,\r\n      type: 'tool_call',\r\n      tool: call.name,\r\n      arguments: call.arguments,\r\n      status: result.success ? 'completed' : 'failed',\r\n      ...(result.success\r\n        ? { result: result.result }\r\n        : { error: result.error ?? 'tool execution failed' }),\r\n      ...(result.interrupted ? { interrupted: result.interrupted } : {}),\r\n    },\r\n  });\r\n}\r\n\r\n/**\r\n * 发射回合完成事件（附 token 用量）。\r\n */\r\nexport function emitTurnCompleted(turn: number, usage?: TurnUsage): void {\r\n  emitSessionEvent({ type: 'turn.completed', turn, ...(usage ? { usage } : {}) });\r\n}\r\n\r\n/**\r\n * 发射回合失败事件。\r\n *\r\n * 支持两种入参：\r\n * - CallOutcome（agent.ts 主链路）：展开为结构化 TurnFailure\r\n * - 简单 message（宿主致命错误等）：仅带 message\r\n */\r\nimport type { CallOutcome } from './lifecycle.js';\r\n\r\nexport function emitTurnFailed(turn: number, source: string | CallOutcome): void {\r\n  if (typeof source === 'string') {\r\n    emitSessionEvent({ type: 'turn.failed', turn, error: { message: source } });\r\n    return;\r\n  }\r\n  emitSessionEvent({\r\n    type: 'turn.failed',\r\n    turn,\r\n    error: {\r\n      message: source.error?.message ?? source.response ?? source.reason,\r\n      reason: source.reason,\r\n      ...(source.error ? {\r\n        category: source.error.category,\r\n        ...(typeof source.error.statusCode === 'number' ? { statusCode: source.error.statusCode } : {}),\r\n        ...(typeof source.error.retryable === 'boolean' ? { retryable: source.error.retryable } : {}),\r\n      } : {}),\r\n    },\r\n  });\r\n}\r\n"],"mappings":";AA6GA,IAAM,YAAY,oBAAI,IAA0B;AAEhD,IAAI,cAAc;AAElB,SAAS,aAAqB;AAC5B,SAAO,QAAQ,aAAa;AAC9B;AAMO,SAAS,uBAAuB,UAA4C;AACjF,YAAU,IAAI,QAAQ;AACtB,SAAO,MAAM;AACX,cAAU,OAAO,QAAQ;AAAA,EAC3B;AACF;AAKO,SAAS,iBAAiB,OAA2B;AAC1D,MAAI,UAAU,SAAS,EAAG;AAC1B,aAAW,YAAY,WAAW;AAChC,QAAI;AACF,eAAS,KAAK;AAAA,IAChB,QAAQ;AAAA,IAER;AAAA,EACF;AACF;AASO,SAAS,4BAA4B,UAAuB,MAAoB;AACrF,MAAI,UAAU,SAAS,EAAG;AAE1B,MAAI,SAAS,aAAa,SAAS,UAAU,KAAK,GAAG;AACnD,qBAAiB;AAAA,MACf,MAAM;AAAA,MACN,MAAM,EAAE,IAAI,WAAW,GAAG,MAAM,MAAM,aAAa,MAAM,SAAS,UAAU;AAAA,IAC9E,CAAC;AAAA,EACH;AAEA,MAAI,SAAS,WAAW,SAAS,QAAQ,KAAK,GAAG;AAC/C,qBAAiB;AAAA,MACf,MAAM;AAAA,MACN,MAAM,EAAE,IAAI,WAAW,GAAG,MAAM,MAAM,iBAAiB,MAAM,SAAS,QAAQ;AAAA,IAChF,CAAC;AAAA,EACH;AAEA,MAAI,SAAS,WAAW;AACtB,eAAW,QAAQ,SAAS,WAAW;AACrC,uBAAiB;AAAA,QACf,MAAM;AAAA,QACN,MAAM;AAAA,UACJ,IAAI,KAAK,MAAM,WAAW;AAAA,UAC1B;AAAA,UACA,MAAM;AAAA,UACN,MAAM,KAAK;AAAA,UACX,WAAW,KAAK;AAAA,UAChB,QAAQ;AAAA,QACV;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAKO,SAAS,qBAAqB,MAAgB,QAAwB,MAAoB;AAC/F,MAAI,UAAU,SAAS,EAAG;AAE1B,mBAAiB;AAAA,IACf,MAAM;AAAA,IACN,MAAM;AAAA,MACJ,IAAI,KAAK,MAAM,WAAW;AAAA,MAC1B;AAAA,MACA,MAAM;AAAA,MACN,MAAM,KAAK;AAAA,MACX,WAAW,KAAK;AAAA,MAChB,QAAQ,OAAO,UAAU,cAAc;AAAA,MACvC,GAAI,OAAO,UACP,EAAE,QAAQ,OAAO,OAAO,IACxB,EAAE,OAAO,OAAO,SAAS,wBAAwB;AAAA,MACrD,GAAI,OAAO,cAAc,EAAE,aAAa,OAAO,YAAY,IAAI,CAAC;AAAA,IAClE;AAAA,EACF,CAAC;AACH;AAKO,SAAS,kBAAkB,MAAc,OAAyB;AACvE,mBAAiB,EAAE,MAAM,kBAAkB,MAAM,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,EAAG,CAAC;AAChF;AAWO,SAAS,eAAe,MAAc,QAAoC;AAC/E,MAAI,OAAO,WAAW,UAAU;AAC9B,qBAAiB,EAAE,MAAM,eAAe,MAAM,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;AAC1E;AAAA,EACF;AACA,mBAAiB;AAAA,IACf,MAAM;AAAA,IACN;AAAA,IACA,OAAO;AAAA,MACL,SAAS,OAAO,OAAO,WAAW,OAAO,YAAY,OAAO;AAAA,MAC5D,QAAQ,OAAO;AAAA,MACf,GAAI,OAAO,QAAQ;AAAA,QACjB,UAAU,OAAO,MAAM;AAAA,QACvB,GAAI,OAAO,OAAO,MAAM,eAAe,WAAW,EAAE,YAAY,OAAO,MAAM,WAAW,IAAI,CAAC;AAAA,QAC7F,GAAI,OAAO,OAAO,MAAM,cAAc,YAAY,EAAE,WAAW,OAAO,MAAM,UAAU,IAAI,CAAC;AAAA,MAC7F,IAAI,CAAC;AAAA,IACP;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/{chunk-YFSM6IYU.js → chunk-TKVOWEJ2.js}

@@ -1,14 +1,14 @@
 import {
   emitAssistantResponseEvents,
   emitToolResultEvents
-} from "./chunk-KO4DJKM6.js";
+} from "./chunk-OFBE43IS.js";
 import {
   DebugHub,
   runWithNotificationScope
-} from "./chunk-574NG4UB.js";
+} from "./chunk-U3LWOJ3Q.js";
 import {
   PlaceholderResolver
-} from "./chunk-BVF7RUXV.js";
+} from "./chunk-KCCLSQC4.js";
 
 // src/core/tool.ts
 function createTool(config, sourceFile) {
@@ -1126,11 +1126,11 @@ var CoreLifecycle = /* @__PURE__ */ ((CoreLifecycle2) => {
   CoreLifecycle2["ToolResultTransform"] = "ToolResultTransform";
   return CoreLifecycle2;
 })(CoreLifecycle || {});
-var Decision = /* @__PURE__ */ ((Decision3) => {
-  Decision3["Approve"] = "approve";
-  Decision3["Deny"] = "deny";
-  Decision3["Continue"] = "continue";
-  return Decision3;
+var Decision = /* @__PURE__ */ ((Decision2) => {
+  Decision2["Approve"] = "approve";
+  Decision2["Deny"] = "deny";
+  Decision2["Continue"] = "continue";
+  return Decision2;
 })(Decision || {});
 function normalizeDecision(result) {
   if (typeof result === "string") {
@@ -1717,11 +1717,8 @@ function getDefaultSessionStore() {
 
 // src/template/loader.ts
 import { readFile as readFile2 } from "fs/promises";
-import { resolve as resolve2, dirname } from "path";
-import { fileURLToPath } from "url";
+import { resolve as resolve2 } from "path";
 import { existsSync } from "fs";
-var __filename = fileURLToPath(import.meta.url);
-var projectRoot = resolve2(dirname(__filename), "..");
 var TemplateLoader = class {
   cache;
   searchDirs;
@@ -1779,7 +1776,7 @@ Please ensure the file exists.`
   /**
    * 加载模板（同步）
    */
-  loadSync(templatePath) {
+  loadSync(_templatePath) {
     throw new Error("Synchronous load not implemented. Use async load() instead.");
   }
   /**
@@ -2172,7 +2169,7 @@ function createListRenderer(config) {
 
 // src/skills/loader.ts
 import { readdir as readdir2, readFile as readFile3 } from "fs/promises";
-import { resolve as resolve3, isAbsolute, join as join2, normalize } from "path";
+import { resolve as resolve3, isAbsolute, join, normalize } from "path";
 import { existsSync as existsSync2 } from "fs";
 import { cwd as processCwd } from "process";
 import yaml from "js-yaml";
@@ -2249,7 +2246,7 @@ async function collectSkillFiles(dir) {
   try {
     const entries = await readdir2(dir, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = join2(dir, entry.name);
+      const fullPath = join(dir, entry.name);
       if (entry.isFile() && entry.name === "SKILL.md") {
         skillFiles.push(normalize(fullPath));
         continue;
@@ -2268,7 +2265,7 @@ async function collectSkillFiles(dir) {
           const subEntries = await readdir2(fullPath, { withFileTypes: true });
           for (const subEntry of subEntries) {
             if (subEntry.isFile() && subEntry.name === "SKILL.md") {
-              skillFiles.push(normalize(join2(fullPath, "SKILL.md")));
+              skillFiles.push(normalize(join(fullPath, "SKILL.md")));
               break;
             }
           }
@@ -2717,7 +2714,9 @@ function withDeadline(signal, timeoutMs) {
       merged.abort(signal.reason);
       return merged.signal;
     }
-    signal.addEventListener("abort", () => merged.abort(signal.reason), { once: true });
+    const onExternalAbort = () => merged.abort(signal.reason);
+    signal.addEventListener("abort", onExternalAbort, { once: true });
+    merged.signal.addEventListener("abort", () => signal.removeEventListener("abort", onExternalAbort), { once: true });
   }
   const timer = setTimeout(
     () => merged.abort(new DOMException(`Model call deadline exceeded after ${timeoutMs}ms`, "TimeoutError")),
@@ -3234,8 +3233,9 @@ var UsageStats = class {
    * @param callIndex Call 序号
    * @param step Step 序号
    * @param usage 用量数据
+   * @param model 该次请求的模型归因；缺省时不产生分段
    */
-  record(callIndex, step, usage) {
+  record(callIndex, step, usage, model) {
     this.totalUsage.inputTokens += usage.inputTokens;
     this.totalUsage.outputTokens += usage.outputTokens;
     this.totalUsage.totalTokens += usage.totalTokens;
@@ -3287,6 +3287,43 @@ var UsageStats = class {
     if (usage.audioTokens) {
       callSummary.totalUsage.audioTokens = (callSummary.totalUsage.audioTokens || 0) + usage.audioTokens;
     }
+    if (model) {
+      if (!callSummary.modelSegments) callSummary.modelSegments = [];
+      const segModelName = model.modelName || "";
+      const segPresetName = model.presetName || "";
+      let segment = callSummary.modelSegments.find(
+        (s) => s.modelName === segModelName && s.presetName === segPresetName
+      );
+      if (!segment) {
+        segment = {
+          modelName: segModelName,
+          presetName: segPresetName,
+          usage: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },
+          requests: 0,
+          cacheHitRequests: 0
+        };
+        callSummary.modelSegments.push(segment);
+      }
+      segment.usage.inputTokens += usage.inputTokens;
+      segment.usage.outputTokens += usage.outputTokens;
+      segment.usage.totalTokens += usage.totalTokens;
+      if (usage.cacheCreationTokens) {
+        segment.usage.cacheCreationTokens = (segment.usage.cacheCreationTokens || 0) + usage.cacheCreationTokens;
+      }
+      if (usage.cacheReadTokens) {
+        segment.usage.cacheReadTokens = (segment.usage.cacheReadTokens || 0) + usage.cacheReadTokens;
+      }
+      if (usage.reasoningTokens) {
+        segment.usage.reasoningTokens = (segment.usage.reasoningTokens || 0) + usage.reasoningTokens;
+      }
+      if (usage.audioTokens) {
+        segment.usage.audioTokens = (segment.usage.audioTokens || 0) + usage.audioTokens;
+      }
+      segment.requests++;
+      if (usage.cacheReadTokens) {
+        segment.cacheHitRequests++;
+      }
+    }
     this.lastRequestUsage = { ...usage };
   }
   /**
@@ -3305,19 +3342,29 @@ var UsageStats = class {
   getTotalUsage() {
     return { ...this.totalUsage };
   }
+  /** Call 汇总的深拷贝（totalUsage 与 modelSegments 均独立副本） */
+  cloneCallSummary(summary) {
+    return {
+      ...summary,
+      totalUsage: { ...summary.totalUsage },
+      ...summary.modelSegments ? {
+        modelSegments: summary.modelSegments.map((s) => ({ ...s, usage: { ...s.usage } }))
+      } : {}
+    };
+  }
   /**
    * 获取指定 Call 的用量汇总
    * @param callIndex Call 序号
    */
   getCallUsage(callIndex) {
     const summary = this.currentCallUsage.get(callIndex);
-    return summary ? { ...summary, totalUsage: { ...summary.totalUsage } } : void 0;
+    return summary ? this.cloneCallSummary(summary) : void 0;
   }
   /**
    * 获取所有 Call 的用量汇总
    */
   getAllCallUsage() {
-    return Array.from(this.currentCallUsage.values()).map((s) => ({ ...s, totalUsage: { ...s.totalUsage } }));
+    return Array.from(this.currentCallUsage.values()).map((s) => this.cloneCallSummary(s));
   }
   /**
    * 获取总请求次数
@@ -3377,7 +3424,7 @@ var UsageStats = class {
     this.totalCacheHitRequests = snapshot.totalCacheHitRequests ?? 0;
     this.currentCallUsage.clear();
     for (const call of snapshot.calls) {
-      this.currentCallUsage.set(call.callIndex, { ...call });
+      this.currentCallUsage.set(call.callIndex, this.cloneCallSummary(call));
     }
     this.lastRequestUsage = snapshot.lastRequestUsage ? { ...snapshot.lastRequestUsage } : null;
     this.currentStepRecords = [];
@@ -3401,8 +3448,8 @@ var UsageStats = class {
 
 // src/core/agent.ts
 import { existsSync as existsSync3, realpathSync } from "fs";
-import { dirname as dirname3, join as join3, relative, sep } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import { dirname, join as join2, relative, sep } from "path";
+import { fileURLToPath } from "url";
 
 // src/core/agent/hooks-executor.ts
 var hookLogger = createLogger("agent.forward-hook");
@@ -3486,7 +3533,7 @@ var TemplateResolver = class {
       ...this.systemContext
     };
     if (typeof this.systemMessage === "string") {
-      const { PlaceholderResolver: PlaceholderResolver2 } = await import("./resolver-F5SM2RHQ.js");
+      const { PlaceholderResolver: PlaceholderResolver2 } = await import("./resolver-4JA7VPYP.js");
       return PlaceholderResolver2.resolve(this.systemMessage, context);
     }
     if (this.templateComposer) {
@@ -3496,7 +3543,7 @@ var TemplateResolver = class {
     }
     if (this.systemMessage && typeof this.systemMessage === "object" && "file" in this.systemMessage) {
       const content = await this.templateLoader.load(this.systemMessage.file);
-      const { PlaceholderResolver: PlaceholderResolver2 } = await import("./resolver-F5SM2RHQ.js");
+      const { PlaceholderResolver: PlaceholderResolver2 } = await import("./resolver-4JA7VPYP.js");
       return PlaceholderResolver2.resolve(content, context);
     }
     return "";
@@ -3578,7 +3625,7 @@ var ToolExecutor = class {
   /**
    * 执行单个工具
    */
-  async execute(call, input, context, step, callIndex) {
+  async execute(call, input, context, step, _callIndex) {
     return await runWithLogScope({
       step,
       toolName: call.name,
@@ -3733,7 +3780,7 @@ var ToolExecutor = class {
           termination: () => null
         };
         try {
-          const { emitNotification, createToolStart } = await import("./notification-5DFBYKKN.js");
+          const { emitNotification, createToolStart } = await import("./notification-CASV7QYT.js");
           emitNotification(createToolStart(call.name));
         } catch {
         }
@@ -3900,7 +3947,7 @@ var ToolExecutor = class {
         success: result.success
       });
       try {
-        const { emitNotification, createToolComplete } = await import("./notification-5DFBYKKN.js");
+        const { emitNotification, createToolComplete } = await import("./notification-CASV7QYT.js");
         emitNotification(createToolComplete(call.name, result.success, result.duration));
       } catch {
       }
@@ -3968,7 +4015,7 @@ var ReActLoopRunner = class {
    * @returns 执行结果
    */
   async run(input, context, options) {
-    const { isFirstCall, callIndex, signal } = options;
+    const { callIndex, signal } = options;
     logger3.debug("ReAct loop started", { callIndex, hasSignal: !!signal, signalAborted: signal?.aborted });
     let completed = false;
     let finalResponse = "";
@@ -4002,6 +4049,7 @@ var ReActLoopRunner = class {
             let hasToolCalls = false;
             for (let emptyAttempt = 0; emptyAttempt <= MAX_EMPTY_RETRIES; emptyAttempt++) {
               const llmStartTime = Date.now();
+              const modelAtRequest = this.agent.getLLMMeta();
               response = await runWithLogScope({
                 lifecycle: "LLM",
                 namespace: "agent.llm",
@@ -4021,7 +4069,10 @@ var ReActLoopRunner = class {
               });
               providerStopReason = response.stopReason;
               if (response.usage) {
-                this.agent.recordUsage(callIndex, step, response.usage);
+                this.agent.recordUsage(callIndex, step, response.usage, {
+                  ...modelAtRequest.modelName ? { modelName: modelAtRequest.modelName } : {},
+                  ...modelAtRequest.presetName ? { presetName: modelAtRequest.presetName } : {}
+                });
               }
               hasToolCalls = !!(response.toolCalls && response.toolCalls.length > 0);
               if (!response.content && !hasToolCalls) {
@@ -4431,7 +4482,7 @@ var ReActLoopRunner = class {
         };
       }
       return null;
-    } catch (e) {
+    } catch {
       return null;
     }
   }
@@ -4570,11 +4621,14 @@ var AgentBase = class {
   _llmMeta = {};
   /** 外部消费者通过 onLLMSwap() 注册的回调 */
   _llmSwapCallbacks = [];
+  /** 应用层注入的 preset 解析服务（构造时注入；资产留在注入方） */
+  _modelResolver = null;
   constructor(config) {
     installConsoleBridge();
     this.agentId = DebugHub.getInstance().allocateAgentId();
     this.config = config;
     this.llm = config.llm;
+    this._modelResolver = config.modelResolver ?? null;
     this.maxTurns = config.maxTurns ?? 10;
     this.systemMessage = config.systemMessage;
     this.templateLoader = new TemplateLoader();
@@ -4778,12 +4832,12 @@ var AgentBase = class {
           preCallBoundary = context.captureBoundary();
           preCallRuntimeState = await this.captureRuntimeStateWithoutContext(this._callIndex - 1);
           try {
-            const { emitNotification, createCallStart } = await import("./notification-5DFBYKKN.js");
+            const { emitNotification, createCallStart } = await import("./notification-CASV7QYT.js");
             emitNotification(createCallStart());
           } catch {
           }
           try {
-            const { emitSessionEvent } = await import("./session-events-TETMQI45.js");
+            const { emitSessionEvent } = await import("./session-events-S7LMJ6MM.js");
             emitSessionEvent({ type: "turn.started", turn: this._callIndex });
           } catch {
           }
@@ -4825,12 +4879,12 @@ var AgentBase = class {
             outcome
           });
           try {
-            const { emitNotification, createCallFinish } = await import("./notification-5DFBYKKN.js");
+            const { emitNotification, createCallFinish } = await import("./notification-CASV7QYT.js");
             emitNotification(createCallFinish(outcome));
           } catch {
           }
           try {
-            const { emitSessionEvent, emitTurnCompleted, emitTurnFailed } = await import("./session-events-TETMQI45.js");
+            const { emitTurnCompleted, emitTurnFailed } = await import("./session-events-S7LMJ6MM.js");
             if (result.completed) {
               const callUsage = this.usageStats.getCallUsage(this._callIndex)?.totalUsage;
               emitTurnCompleted(
@@ -4905,12 +4959,12 @@ var AgentBase = class {
             outcome
           });
           try {
-            const { emitNotification, createCallFinish } = await import("./notification-5DFBYKKN.js");
+            const { emitNotification, createCallFinish } = await import("./notification-CASV7QYT.js");
             emitNotification(createCallFinish(outcome));
           } catch {
           }
           try {
-            const { emitTurnFailed } = await import("./session-events-TETMQI45.js");
+            const { emitTurnFailed } = await import("./session-events-S7LMJ6MM.js");
             emitTurnFailed(this._callIndex, outcome);
           } catch {
           }
@@ -4955,8 +5009,8 @@ var AgentBase = class {
       }
       for (const templateName of templateNames) {
         const candidates = [
-          join3(pkgInfo.root, "dist", "templates", `${templateName}.render.js`),
-          join3(pkgInfo.root, "dist", "features", feature.name, "templates", `${templateName}.render.js`)
+          join2(pkgInfo.root, "dist", "templates", `${templateName}.render.js`),
+          join2(pkgInfo.root, "dist", "features", feature.name, "templates", `${templateName}.render.js`)
         ];
         const templatePath = candidates.find((p) => existsSync3(p));
         if (!templatePath) continue;
@@ -5142,6 +5196,49 @@ var AgentBase = class {
   getLLMMeta() {
     return { ...this._llmMeta };
   }
+  /**
+   * 按 preset 名一键切换模型
+   *
+   * 编排：resolver.resolve → setLLM（换实例 / 贴 meta 标 / 通知 Feature / 推 Overview）。
+   * preset 表与凭证由应用层注入的 resolver 提供，本方法只编排流程，因此宿主与
+   * Feature 消费同一入口，切换后的模型状态以 getLLMMeta() 为唯一权威。
+   *
+   * 允许在 onCall 运行期间调用（mid-turn swap），语义同 setLLM。
+   *
+   * @param presetName preset 名
+   * @param opts.thinkingEffort 运行时档位覆盖；null 表示清除为厂商默认
+   * @param opts.source 切换发起方标记（'user' / 'feature:<name>' 等），写入 meta 供让位策略区分
+   * @returns false 表示 preset 解析失败（名字不存在 / 凭证缺失），模型未变
+   * @throws 未注入 modelResolver 时抛出 —— 装配缺失应显式失败而非静默
+   */
+  setModel(presetName, opts) {
+    if (!this._modelResolver) {
+      throw new Error("setModel: no modelResolver injected (pass config.modelResolver at assembly time)");
+    }
+    const overrides = opts && "thinkingEffort" in opts ? { thinkingEffort: opts.thinkingEffort ?? null } : void 0;
+    const resolved = this._modelResolver.resolve(presetName, overrides);
+    if (!resolved?.llm) return false;
+    this.setLLM(resolved.llm, {
+      ...resolved.meta,
+      ...opts?.source ? { source: opts.source } : {}
+    });
+    return true;
+  }
+  /**
+   * 仅调整思考档位（不动模型）：按当前 presetName 重 resolve。
+   * 档位固化在 LLM 实例构造里，因此调整档位 = 以覆盖档位重造客户端。
+   *
+   * @param effort 档位；null 表示清除为厂商默认
+   * @returns false 表示当前模型无 presetName 可锚定或解析失败
+   */
+  setThinkingEffort(effort, opts) {
+    const presetName = this._llmMeta.presetName;
+    if (!presetName) return false;
+    return this.setModel(presetName, {
+      thinkingEffort: effort,
+      ...opts?.source ? { source: opts.source } : {}
+    });
+  }
   async rollbackToCall(callIndex) {
     await this.ensureFeatureTools();
     const checkpoint = this._callCheckpoints.find((entry) => entry.callIndex === callIndex);
@@ -5350,9 +5447,10 @@ var AgentBase = class {
    * @param callIndex Call 序号
    * @param step Step 序号
    * @param usage 用量数据
+   * @param model 该次请求的模型归因（缺省不计入分段）
    */
-  recordUsage(callIndex, step, usage) {
-    this.usageStats.record(callIndex, step, usage);
+  recordUsage(callIndex, step, usage, model) {
+    this.usageStats.record(callIndex, step, usage, model);
     this.pushOverviewSnapshot();
   }
   /**
@@ -5400,14 +5498,14 @@ var AgentBase = class {
     if (factory) return factory();
     switch (type) {
       case "ExplorerAgent": {
-        const { ExplorerAgent } = await import("./ExplorerAgent-ITTSJRJI.js");
+        const { ExplorerAgent } = await import("./ExplorerAgent-C62LOUTX.js");
         return new ExplorerAgent({
           llm: this.llm
         });
       }
       case "BasicAgent":
       default: {
-        const { BasicAgent } = await import("./BasicAgent-RPYJHYCM.js");
+        const { BasicAgent } = await import("./BasicAgent-UBGLABDV.js");
         return new BasicAgent({
           llm: this.llm,
           tools: this.tools.getAll().slice(0, 3)
@@ -6001,7 +6099,7 @@ var AgentBase = class {
       } catch (rollbackError) {
         throw new Error(
           `Feature '${featureName}' reload failed at stage '${stage}', and rollback also failed. Original error: ${error instanceof Error ? error.message : String(error)}. Rollback error: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`,
-          { cause: error }
+          { cause: rollbackError }
         );
       }
       const message = error instanceof Error ? error.message : String(error);
@@ -6122,8 +6220,8 @@ var AgentBase = class {
     for (const [name, feature] of this.features) {
       if (name === "skill") continue;
       if (!feature.source) continue;
-      const filePath = feature.source.startsWith("file://") ? fileURLToPath2(feature.source) : feature.source;
-      const skillsDir = join3(dirname3(filePath), "skills");
+      const filePath = feature.source.startsWith("file://") ? fileURLToPath(feature.source) : feature.source;
+      const skillsDir = join2(dirname(filePath), "skills");
       if (!existsSync3(skillsDir)) continue;
       const found = await discover({ dir: skillsDir });
       if (found.length > 0) {
@@ -6192,11 +6290,17 @@ var AgentBase = class {
         debugPusher,
         features: this.features,
         hooksRegistry: this.hooksRegistry,
-        recordUsage: (callIndex, step, usage) => this.recordUsage(callIndex, step, usage),
+        recordUsage: (callIndex, step, usage, model) => this.recordUsage(callIndex, step, usage, model),
         endCallUsage: (callIndex) => this.endCallUsage(callIndex),
         dispatchTurnActivations: (refs, context) => this.dispatchTurnActivations(refs, context),
         stepSaveFn: this._createStepSaveFn(),
-        peekContinuationRequest: () => this._continuationRequest
+        peekContinuationRequest: () => this._continuationRequest,
+        // 模型热切换族（ADR-0009）：hook ctx 的 agent 是 facade，转发到本体，
+        // 保证 ctx.agent.setModel / setLLM / getLLMMeta 与直调行为一致。
+        setModel: (presetName, opts) => this.setModel(presetName, opts),
+        setThinkingEffort: (effort, opts) => this.setThinkingEffort(effort, opts),
+        setLLM: (llm, meta) => this.setLLM(llm, meta),
+        getLLMMeta: () => this.getLLMMeta()
       },
       (hookName, hookFn, options) => executeHook(this, hookFn, { hookName, ...options }),
       (call, input, context, step, callIndex) => this.toolExecutor.execute(call, input, context, step, callIndex),
@@ -6399,6 +6503,7 @@ var AgentBase = class {
       ...typeof this.llm?.modelName === "string" ? { modelName: this.llm.modelName } : {},
       ...typeof this._llmMeta.presetName === "string" && this._llmMeta.presetName ? { presetName: this._llmMeta.presetName } : {},
       ...this._llmMeta.thinkingEffort != null ? { thinkingEffort: this._llmMeta.thinkingEffort } : {},
+      ...typeof this._llmMeta.provider === "string" && this._llmMeta.provider ? { provider: this._llmMeta.provider } : {},
       ...typeof this._llmMeta.contextLength === "number" && this._llmMeta.contextLength > 0 ? { contextLength: this._llmMeta.contextLength } : {},
       ...typeof this._llmMeta.compressRatio === "number" && this._llmMeta.compressRatio > 0 ? { compressRatio: this._llmMeta.compressRatio } : {}
     };
@@ -6569,4 +6674,4 @@ export {
   HooksRegistry,
   AgentBase
 };
-//# sourceMappingURL=chunk-YFSM6IYU.js.map
+//# sourceMappingURL=chunk-TKVOWEJ2.js.map