@zhin.js/agent 1.1.35 → 1.1.38

package/lib/subagent-goal-notify.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-goal-notify.js","sourceRoot":"","sources":["../src/subagent-goal-notify.ts"],"names":[],"mappings":"AAEA,qCAAqC;AACrC,MAAM,CAAC,MAAM,8BAA8B,GAAG,gBAAgB,CAAC;AAK/D,MAAM,CAAC,MAAM,8BAA8B,GAA0C;IACnF,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,IAAI;IACd,IAAI,EAAE,IAAI;CACX,CAAC;AAYF,MAAM,UAAU,2BAA2B,CAAC,KAAyB,EAAE,IAAY;IACjF,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,yBAAyB,CAAC,OAEzC;IACC,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAChC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IACxB,OAAO,CAAC,IAAI,SAAS,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,IAA2B;IAC1E,OAAO,8BAA8B,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACtD,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,+BAA+B,CAAC,MAAgC;IAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,gCAAgC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IAC1C,MAAM,KAAK,GAAG,yBAAyB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,OAAO,MAAM,MAAM,KAAK,OAAO,OAAO,KAAK,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAqB;IAC3D,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAE,WAAgC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,8BAA8B,CAAC,CAAC;IACnD,OAAO,OAAO,EAAE,KAAK,UAAU,CAAC,CAAC,CAAE,EAA2B,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAgC,EAChC,MAAgC;IAEhC,MAAM,MAAM,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO;IAC1D,IAAI,CAAC;QACH,MAAM,MAAM,CAAC;YACX,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;YAC5B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;SAC3B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC"}
+{"version":3,"file":"subagent-goal-notify.js","sourceRoot":"","sources":["../src/subagent-goal-notify.ts"],"names":[],"mappings":"AAEA,qCAAqC;AACrC,MAAM,CAAC,MAAM,8BAA8B,GAAG,gBAAgB,CAAC;AAK/D,MAAM,CAAC,MAAM,8BAA8B,GAA0C;IACnF,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,IAAI;IACd,IAAI,EAAE,IAAI;CACX,CAAC;AAYF,MAAM,UAAU,2BAA2B,CAAC,KAAyB,EAAE,IAAY;IACjF,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,yBAAyB,CAAC,OAEzC;IACC,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAChC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IACxB,OAAO,CAAC,IAAI,SAAS,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,IAA2B;IAC1E,OAAO,8BAA8B,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACtD,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,+BAA+B,CAAC,MAAgC;IAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,gCAAgC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IAC1C,MAAM,KAAK,GAAG,yBAAyB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,OAAO,MAAM,MAAM,KAAK,OAAO,OAAO,KAAK,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAqB;IAC3D,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAE,WAAgC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,8BAA8B,CAAC,CAAC;IACnD,OAAO,OAAO,EAAE,KAAK,UAAU,CAAC,CAAC,CAAE,EAA2B,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAgC,EAChC,MAAgC;IAEhC,MAAM,MAAM,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO;IAC1D,IAAI,CAAC;QACH,MAAM,MAAM,CAAC;YACX,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;YAC5B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;SAC3B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC","sourcesContent":["import type { AgentTurnMessage, Message } from '@zhin.js/core';\n\n/** AgentTurnMessage.extra 中挂载的回调键 */\nexport const SUBAGENT_GOAL_NOTIFY_EXTRA_KEY = 'onSubagentGoal';\n\n/** 用户可见的执行通道（进度提示中间段） */\nexport type SubagentExecutionKind = 'async' | 'sync' | 'deferred' | 'cron';\n\nexport const SUBAGENT_EXECUTION_KIND_LABELS: Record<SubagentExecutionKind, string> = {\n  async: '异步',\n  sync: '同步',\n  deferred: '编排',\n  cron: '定时',\n};\n\nexport interface SubagentProcessingNotice {\n  taskId: string;\n  kind: SubagentExecutionKind;\n  label: string;\n  /** ai.agents / spawn_task 的 agent 名（如 draw、vision） */\n  agent?: string;\n}\n\nexport type SubagentGoalNotifier = (notice: SubagentProcessingNotice) => void | Promise<void>;\n\nexport function resolveSubagentDisplayLabel(label: string | undefined, task: string): string {\n  const trimmed = label?.trim();\n  if (trimmed) return trimmed;\n  return task.slice(0, 30) + (task.length > 30 ? '...' : '');\n}\n\n/** spawn / spawnSync 的执行通道 */\nexport function resolveSpawnExecutionKind(options: {\n  sync?: boolean;\n}): SubagentExecutionKind {\n  if (options.sync) return 'sync';\n  return 'async';\n}\n\n/** 日志与进度提示用的 agent 展示名 */\nexport function resolveSubagentAgentLabel(agent?: string): string | undefined {\n  const a = agent?.trim();\n  return a || undefined;\n}\n\nexport function formatSubagentExecutionKindLabel(kind: SubagentExecutionKind): string {\n  return SUBAGENT_EXECUTION_KIND_LABELS[kind] ?? kind;\n}\n\n/** 用户可见格式：任务【taskId】:执行通道·agent => label */\nexport function formatSubagentProcessingMessage(notice: SubagentProcessingNotice): string {\n  const taskId = notice.taskId.trim();\n  const kindLabel = formatSubagentExecutionKindLabel(notice.kind);\n  const label = notice.label.trim() || '任务';\n  const agent = resolveSubagentAgentLabel(notice.agent);\n  const channel = agent ? `${kindLabel}·${agent}` : kindLabel;\n  return `任务【${taskId}】:${channel} => ${label}`;\n}\n\nexport function getSubagentGoalNotifier(commMessage?: Message): SubagentGoalNotifier | undefined {\n  const extra = commMessage ? (commMessage as AgentTurnMessage).extra : undefined;\n  const fn = extra?.[SUBAGENT_GOAL_NOTIFY_EXTRA_KEY];\n  return typeof fn === 'function' ? (fn as SubagentGoalNotifier) : undefined;\n}\n\nexport async function notifySubagentGoal(\n  commMessage: Message | undefined,\n  notice: SubagentProcessingNotice,\n): Promise<void> {\n  const notify = getSubagentGoalNotifier(commMessage);\n  if (!notify) return;\n  if (!notice.taskId.trim() || !notice.label.trim()) return;\n  try {\n    await notify({\n      taskId: notice.taskId.trim(),\n      kind: notice.kind,\n      label: notice.label.trim(),\n    });\n  } catch {\n    // 进度提示失败不中断子任务\n  }\n}\n"]}

package/lib/subagent-parent-context.d.ts

@@ -15,4 +15,3 @@ export declare function buildParentContextPreamble(messages: AgentMessage[], opt
     maxChars?: number;
     maxMessages?: number;
 }): string;
-//# sourceMappingURL=subagent-parent-context.d.ts.map

package/lib/subagent-parent-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-parent-context.js","sourceRoot":"","sources":["../src/subagent-parent-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"subagent-parent-context.js","sourceRoot":"","sources":["../src/subagent-parent-context.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * fork 模式：从主会话 active_leaf 链构建子 agent 上下文前导（过滤编排噪声）\n */\nimport {\n  assistantText,\n  type AgentMessage,\n  type AssistantMessage,\n  type ToolResultMessage,\n} from '@zhin.js/ai';\n\nconst ORCHESTRATION_TOOLS = new Set(['spawn_task']);\nconst DEFAULT_MAX_CHARS = 4096;\nconst DEFAULT_MAX_MESSAGES = 20;\n\ntype TextBlock = { type: string; text?: string };\n\nfunction blocksToText(blocks: TextBlock[]): string {\n  return blocks\n    .filter((b) => b.type === 'text' && b.text)\n    .map((b) => b.text!)\n    .join('\\n');\n}\n\nfunction messageToLine(message: AgentMessage): string | null {\n  if (message.role === 'user' || message.role === 'assistant' || message.role === 'toolResult') {\n    const blocks = (message as { content: TextBlock[] }).content;\n    if (message.role === 'user') {\n      const text = Array.isArray(blocks) ? blocksToText(blocks).trim() : '';\n      return text ? `User: ${text}` : null;\n    }\n    if (message.role === 'assistant') {\n      const text = assistantText(message as AssistantMessage).trim();\n      return text ? `Assistant: ${text}` : null;\n    }\n    const tr = message as ToolResultMessage;\n    if (ORCHESTRATION_TOOLS.has(tr.toolName)) return null;\n    const text = Array.isArray(blocks) ? blocksToText(blocks) : '';\n    const preview = text.length > 500 ? `${text.slice(0, 500)}…` : text;\n    return preview.trim() ? `Tool(${tr.toolName}): ${preview}` : null;\n  }\n  return null;\n}\n\nexport async function buildParentContextSnapshot(\n  agentSessionStore: { findActive(key: string): Promise<{ session_id: string } | null> },\n  contextRepository: { loadContext(sessionId: string): Promise<{ messages: AgentMessage[] }> },\n  sessionKey: string,\n): Promise<string | undefined> {\n  const active = await agentSessionStore.findActive(sessionKey);\n  if (!active) return undefined;\n  const ctx = await contextRepository.loadContext(active.session_id);\n  const preamble = buildParentContextPreamble(ctx.messages);\n  return preamble || undefined;\n}\n\nexport function buildParentContextPreamble(\n  messages: AgentMessage[],\n  options?: { maxChars?: number; maxMessages?: number },\n): string {\n  const maxChars = options?.maxChars ?? DEFAULT_MAX_CHARS;\n  const maxMessages = options?.maxMessages ?? DEFAULT_MAX_MESSAGES;\n  const lines: string[] = [];\n  let total = 0;\n  for (const msg of messages.slice(-maxMessages)) {\n    const line = messageToLine(msg);\n    if (!line) continue;\n    if (total + line.length + 1 > maxChars) break;\n    lines.push(line);\n    total += line.length + 1;\n  }\n  return lines.join('\\n');\n}\n"]}

package/lib/subagent-preset.d.ts

@@ -7,4 +7,3 @@ export type SubagentContextMode = 'fork' | 'fresh';
 export declare function isAgentRole(value: string): value is AgentRole;
 export declare function resolveSubagentRole(meta: AgentMeta | null | undefined, agentName?: string): AgentRole;
 export declare function resolveSubagentContextMode(meta: AgentMeta | null | undefined, role: AgentRole, explicit?: SubagentContextMode): SubagentContextMode;
-//# sourceMappingURL=subagent-preset.d.ts.map

package/lib/subagent-preset.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-preset.js","sourceRoot":"","sources":["../src/subagent-preset.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC;IAC/C,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS;CAClF,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAA8B;IACrD,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF,MAAM,4BAA4B,GAA2C;IAC3E,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,MAAM;IACd,UAAU,EAAE,MAAM;IAClB,SAAS,EAAE,OAAO;IAClB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAkC,EAClC,SAAkB;IAElB,IAAI,IAAI,EAAE,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAC3D,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,QAAQ,GAAG,mBAAmB,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9D,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,IAAkC,EAClC,IAAe,EACf,QAA8B;IAE9B,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,EAAE,WAAW,CAAC;IACnC,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IACjE,OAAO,4BAA4B,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"subagent-preset.js","sourceRoot":"","sources":["../src/subagent-preset.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC;IAC/C,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS;CAClF,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAA8B;IACrD,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF,MAAM,4BAA4B,GAA2C;IAC3E,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,MAAM;IACd,UAAU,EAAE,MAAM;IAClB,SAAS,EAAE,OAAO;IAClB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAkC,EAClC,SAAkB;IAElB,IAAI,IAAI,EAAE,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAC3D,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,QAAQ,GAAG,mBAAmB,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9D,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,IAAkC,EAClC,IAAe,EACf,QAA8B;IAE9B,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,EAAE,WAAW,CAAC;IACnC,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IACjE,OAAO,4BAA4B,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC","sourcesContent":["/**\n * Sub-agent 预设解析：role / contextMode（对齐 pi-subagents frontmatter 与默认映射）\n */\nimport type { AgentMeta } from './discovery/agents.js';\nimport type { AgentRole } from './resource-hub/role-configs.js';\n\nexport type SubagentContextMode = 'fork' | 'fresh';\n\nconst KNOWN_ROLES: ReadonlySet<string> = new Set([\n  'subtask', 'worker', 'researcher', 'evaluator', 'executor', 'reviewer', 'planner',\n]);\n\nconst PRESET_ROLE_BY_NAME: Record<string, AgentRole> = {\n  reviewer: 'reviewer',\n  planner: 'planner',\n  researcher: 'researcher',\n  evaluator: 'evaluator',\n  scout: 'researcher',\n  explorer: 'researcher',\n  worker: 'subtask',\n  executor: 'executor',\n};\n\nconst DEFAULT_CONTEXT_MODE_BY_ROLE: Record<AgentRole, SubagentContextMode> = {\n  subtask: 'fork',\n  worker: 'fork',\n  researcher: 'fork',\n  evaluator: 'fresh',\n  executor: 'fork',\n  reviewer: 'fresh',\n  planner: 'fresh',\n};\n\nexport function isAgentRole(value: string): value is AgentRole {\n  return KNOWN_ROLES.has(value);\n}\n\nexport function resolveSubagentRole(\n  meta: AgentMeta | null | undefined,\n  agentName?: string,\n): AgentRole {\n  if (meta?.role && isAgentRole(meta.role)) return meta.role;\n  if (agentName) {\n    const inferred = PRESET_ROLE_BY_NAME[agentName.toLowerCase()];\n    if (inferred) return inferred;\n  }\n  return 'subtask';\n}\n\nexport function resolveSubagentContextMode(\n  meta: AgentMeta | null | undefined,\n  role: AgentRole,\n  explicit?: SubagentContextMode,\n): SubagentContextMode {\n  if (explicit === 'fork' || explicit === 'fresh') return explicit;\n  const fromMeta = meta?.contextMode;\n  if (fromMeta === 'fork' || fromMeta === 'fresh') return fromMeta;\n  return DEFAULT_CONTEXT_MODE_BY_ROLE[role];\n}\n"]}

package/lib/subagent-prompt.d.ts

@@ -2,4 +2,3 @@
  * 子 agent system prompt 净化：剥离父级编排指令。
  */
 export declare function sanitizeSubagentSystemPrompt(prompt: string): string;
-//# sourceMappingURL=subagent-prompt.d.ts.map

package/lib/subagent-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-prompt.js","sourceRoot":"","sources":["../src/subagent-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,4BAA4B,CAAC,MAAc;IACzD,MAAM,eAAe,GAAG,oBAAoB,CAAC,MAAM,EAAE,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/E,OAAO,wBAAwB,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc,EAAE,YAA+B;IAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YACpC,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IACjC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,CAAC,EAAE,CAAC;IACrD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"subagent-prompt.js","sourceRoot":"","sources":["../src/subagent-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,4BAA4B,CAAC,MAAc;IACzD,MAAM,eAAe,GAAG,oBAAoB,CAAC,MAAM,EAAE,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/E,OAAO,wBAAwB,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc,EAAE,YAA+B;IAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YACpC,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IACjC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,CAAC,EAAE,CAAC;IACrD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;AACnE,CAAC","sourcesContent":["/**\n * 子 agent system prompt 净化：剥离父级编排指令。\n */\n\nexport function sanitizeSubagentSystemPrompt(prompt: string): string {\n  const withoutSections = removePromptSections(prompt, ['orchestration', '主编排']);\n  return redactOrchestrationTerms(withoutSections).trim();\n}\n\nfunction removePromptSections(prompt: string, sectionNames: readonly string[]): string {\n  const lines = prompt.split('\\n');\n  const kept: string[] = [];\n  let skipping = false;\n  for (const line of lines) {\n    const heading = readMarkdownHeading(line);\n    if (heading) {\n      const lower = heading.toLowerCase();\n      skipping = sectionNames.some((name) => lower === name.toLowerCase());\n    }\n    if (!skipping) kept.push(line);\n  }\n  return kept.join('\\n');\n}\n\nfunction readMarkdownHeading(line: string): string | null {\n  const trimmed = line.trimStart();\n  if (!trimmed.startsWith('#')) return null;\n  let i = 0;\n  while (i < trimmed.length && trimmed[i] === '#') i++;\n  return trimmed.slice(i).trim();\n}\n\nfunction redactOrchestrationTerms(text: string): string {\n  return text.replaceAll('spawn_task', '[orchestration-redacted]');\n}\n"]}

package/lib/task-executor.d.ts

@@ -37,4 +37,3 @@ export declare function createTaskExecutor(deps: TaskExecutorDeps): {
     dispose: () => Promise<void>;
 };
 export type TaskExecutor = ReturnType<typeof createTaskExecutor>;
-//# sourceMappingURL=task-executor.d.ts.map

package/lib/task-executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-executor.js","sourceRoot":"","sources":["../src/task-executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-executor.js","sourceRoot":"","sources":["../src/task-executor.ts"],"names":[],"mappings":"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","sourcesContent":["/** Delivery boundary for the independent schedule execution domain. */\nimport { getLogger } from '@zhin.js/logger';\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport type { NotificationRouter } from './assistant/notification-router.js';\nimport type { ScheduleJob, ScheduleJobExecutionPlan } from './assistant/types.js';\nimport { scheduleJobCreatorFromPrincipal } from './assistant/job-creator.js';\nimport type { ScheduleInvocationContext } from './assistant/schedule-job-service.js';\nimport { deliverScheduleToAdapter } from './assistant/deliver-schedule-to-adapter.js';\nimport { KeyedMutex } from './utils/keyed-mutex.js';\nimport {\n  ScheduleExecutionDomainImpl,\n  type ScheduleExecutionDomain,\n  type ScheduleExecutionResult,\n  type ScheduleTurnPort,\n} from './schedule-domain/execution-domain.js';\nimport { JsonlScheduleAuditLogger } from './schedule-domain/audit-logger.js';\nimport type { ZhinAgentConfig } from './config/zhin-agent-config.js';\nimport { DEFAULT_CONFIG } from './config/zhin-agent-defaults.js';\n\nconst logger = getLogger('task-executor');\n\nexport interface TaskExecutionResult extends ScheduleExecutionResult {\n  responseText: string;\n  executionPlan?: ScheduleJobExecutionPlan;\n}\n\nexport interface TaskExecutorDeps {\n  turn?: ScheduleTurnPort;\n  config?: Required<ZhinAgentConfig>;\n  router: NotificationRouter;\n  activity?: ScheduleActivityPort;\n  defaultNotify?: import('./assistant/types.js').JobNotify;\n  domain?: ScheduleExecutionDomain;\n  dataDir?: string;\n}\n\nexport interface TaskExecutionOptions {\n  previewSource?: ScheduleInvocationContext;\n  signal?: AbortSignal;\n}\n\nexport interface ScheduleActivityEvent {\n  readonly phase: 'start' | 'finish' | 'error';\n  readonly job: ScheduleJob;\n  readonly previewSource?: ScheduleInvocationContext;\n  readonly notify: import('./assistant/types.js').JobNotify;\n}\n\nexport interface ScheduleActivityPort {\n  publish(event: ScheduleActivityEvent): void | Promise<void>;\n}\n\nexport function createTaskExecutor(deps: TaskExecutorDeps) {\n  const sceneLocks = new KeyedMutex();\n  const executionContext = new AsyncLocalStorage<boolean>();\n  let disposed = false;\n  let disposal: Promise<void> | undefined;\n  const { router } = deps;\n  const domain = deps.domain ?? new ScheduleExecutionDomainImpl({\n    turn: deps.turn ?? missingScheduleTurnPort(),\n    config: deps.config ?? DEFAULT_CONFIG,\n    auditLogger: new JsonlScheduleAuditLogger(deps.dataDir),\n  });\n\n  async function execute(job: ScheduleJob, options: TaskExecutionOptions = {}): Promise<TaskExecutionResult> {\n    if (disposed) throw new Error('TaskExecutor has been disposed');\n    options.signal?.throwIfAborted();\n    const previewSource = options.previewSource;\n    const effectiveNotify = router.resolveEffectiveNotify(job.notify, deps.defaultNotify);\n    const event = async (phase: ScheduleActivityEvent['phase']) => {\n      if (!job.activityFeedback) return;\n      await deps.activity?.publish({ phase, job, previewSource, notify: effectiveNotify });\n    };\n    const lockKey = previewSource\n      ? `preview:${previewSource.sessionKey}`\n      : scheduleLockKey(job, effectiveNotify);\n\n    return sceneLocks.run(lockKey, () => executionContext.run(true, async () => {\n      // Activity belongs to admitted execution, not to time spent waiting for\n      // the per-scene mutex. Keeping its terminal inside the same critical\n      // section prevents a prior run from clearing a later run's indicator.\n      await event('start');\n      let result: ScheduleExecutionResult;\n      try {\n        result = await domain.execute(job, {\n          preview: Boolean(previewSource),\n          signal: options.signal,\n        });\n        options.signal?.throwIfAborted();\n      } catch (error) {\n        await event('error');\n        throw error;\n      }\n      const executionPlan = previewSource\n        ? {\n            prompt: job.action.prompt,\n            tools: result.audit.toolsResolved.length ? result.audit.toolsResolved : undefined,\n            skills: result.audit.skillsResolved?.length ? result.audit.skillsResolved : undefined,\n            previewSample: result.output || undefined,\n            previewedAt: Date.now(),\n            confirmed: false,\n          }\n        : job.executionPlan;\n\n      if (!result.success) {\n        await event('error');\n        logger.error(`[TaskExecutor] 执行失败: ${result.error ?? 'unknown error'}`);\n      } else if (previewSource) {\n        await event('finish');\n      } else {\n        if (result.output) {\n          try {\n            await deliverScheduleToAdapter({\n              notify: effectiveNotify,\n              content: result.output,\n              router,\n              source: 'scheduled',\n            });\n          } catch (error) {\n            await event('error');\n            throw error;\n          }\n        }\n        await event('finish');\n      }\n\n      return { ...result, responseText: result.output, executionPlan };\n    }), options.signal);\n  }\n\n  async function preview(\n    prompt: string,\n    source: ScheduleInvocationContext,\n    options: { activityFeedback?: boolean } = {},\n  ): Promise<TaskExecutionResult> {\n    const now = Date.now();\n    const job: ScheduleJob = {\n      id: `preview-${now}`,\n      enabled: true,\n      schedule: { kind: 'at', atMs: now },\n      action: { kind: 'agent', prompt },\n      notify: { channel: 'silent' },\n      createdAt: now,\n      updatedAt: now,\n      state: {},\n      source: 'manual',\n      createdBy: scheduleJobCreatorFromPrincipal(source.principal),\n      activityFeedback: options.activityFeedback,\n    };\n    return execute(job, { previewSource: source });\n  }\n\n  function dispose(): Promise<void> {\n    if (executionContext.getStore()) {\n      return Promise.reject(new Error(\n        'TaskExecutor cannot dispose from inside its own execution callback; dispose it from the owning lifecycle',\n      ));\n    }\n    if (disposal) return disposal;\n    disposed = true;\n    disposal = sceneLocks.drain();\n    return disposal;\n  }\n\n  return { execute, preview, dispose };\n}\n\nfunction missingScheduleTurnPort(): ScheduleTurnPort {\n  return Object.freeze({\n    execute: async () => {\n      throw new Error('TaskExecutor requires a ScheduleTurnPort when no execution domain is supplied');\n    },\n  });\n}\n\nfunction scheduleLockKey(job: ScheduleJob, notify: import('./assistant/types.js').JobNotify): string {\n  if (notify.channel !== 'im') return `schedule:${job.id}`;\n  const scene = notify.target.scene;\n  return `im:${scene.platform}:${scene.endpointKey}:${scene.kind}:${scene.sceneId}`;\n}\n\nexport type TaskExecutor = ReturnType<typeof createTaskExecutor>;\n"]}

package/lib/tool/builtin-policy-extractors.d.ts

@@ -1,3 +1,2 @@
 import type { ToolPolicyInputResolver } from './tool-runtime.js';
 export declare const resolveBuiltinToolPolicyInput: ToolPolicyInputResolver;
-//# sourceMappingURL=builtin-policy-extractors.d.ts.map

package/lib/tool/builtin-policy-extractors.js.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-policy-extractors.js","sourceRoot":"","sources":["../../src/tool/builtin-policy-extractors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"builtin-policy-extractors.js","sourceRoot":"","sources":["../../src/tool/builtin-policy-extractors.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Builtin 工具的策略输入提取器注册。\n *\n * 每个 builtin 声明如何从工具参数派生 ToolPolicyInput，\n * 供 ToolRuntime 在执行前统一调用 runToolPolicies。\n *\n * 注意：web_fetch 和 web_search 有 per-URL 的二次策略检查，\n * 这些通过 ToolRuntime.checkPolicy() 在工具内部调用。\n */\nimport { expandHome } from '../discovery/utils.js';\nimport type { ToolPolicyInput } from '../security/policy-facade.js';\nimport type { ToolPolicyInputExtractor, ToolPolicyInputResolver } from './tool-runtime.js';\n\nconst fileReadExtractor: ToolPolicyInputExtractor = (toolName, args, commMessage) => {\n  const filePathArg = String(args.file_path || args.path || '');\n  const fp = filePathArg ? expandHome(filePathArg) : undefined;\n  return {\n    toolName,\n    filePath: fp,\n    rawFilePath: filePathArg || undefined,\n    fileOperation: 'read' as const,\n    devicePathGuard: true,\n    commMessage,\n  };\n};\n\nconst fileWriteExtractor = (op: 'create' | 'update'): ToolPolicyInputExtractor =>\n  (toolName, args, commMessage) => {\n    const filePathArg = String(args.file_path || args.path || '');\n    const fp = filePathArg ? expandHome(filePathArg) : undefined;\n    return {\n      toolName,\n      filePath: fp,\n      rawFilePath: filePathArg || undefined,\n      fileOperation: op,\n      commMessage,\n    };\n  };\n\nconst dirExtractor: ToolPolicyInputExtractor = (toolName, args, commMessage) => {\n  const dirPath = String(args.path || args.directory || args.cwd || process.cwd());\n  return { toolName, filePath: dirPath, commMessage };\n};\n\nconst bashExtractor: ToolPolicyInputExtractor = (toolName, args, commMessage) => ({\n  toolName: 'bash',\n  command: String(args.command || ''),\n  commMessage,\n});\n\nconst webFetchExtractor: ToolPolicyInputExtractor = (toolName, _args, commMessage) => ({\n  toolName: 'web_fetch',\n  commMessage,\n});\n\nconst webSearchExtractor: ToolPolicyInputExtractor = (toolName, _args, commMessage) => ({\n  toolName: 'web_search',\n  commMessage,\n});\n\nconst BUILTIN_POLICY_EXTRACTORS: Readonly<Record<string, ToolPolicyInputExtractor>> = Object.freeze({\n  read_file: fileReadExtractor,\n  write_file: fileWriteExtractor('create'),\n  edit_file: fileWriteExtractor('update'),\n  glob: dirExtractor,\n  grep: dirExtractor,\n  list_dir: dirExtractor,\n  bash: bashExtractor,\n  web_fetch: webFetchExtractor,\n  web_search: webSearchExtractor,\n});\n\nexport const resolveBuiltinToolPolicyInput: ToolPolicyInputResolver =\n  (toolName, args, commMessage) => {\n    const extractor = BUILTIN_POLICY_EXTRACTORS[toolName];\n    return extractor\n      ? extractor(toolName, args, commMessage)\n      : { toolName, commMessage };\n  };\n"]}

package/lib/tool/context-tools.d.ts

@@ -4,4 +4,3 @@
 import type { AgentTool } from '@zhin.js/ai';
 import type { UserProfileStore } from '../user-profile.js';
 export declare function createUserProfileTool(userId: string, profiles: UserProfileStore): AgentTool;
-//# sourceMappingURL=context-tools.d.ts.map

package/lib/tool/context-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-tools.js","sourceRoot":"","sources":["../../src/tool/context-tools.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,QAA0B;IAC9E,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,iBAAiB;QACzB,WAAW,EAAE,6EAA6E;QAC1F,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;oBACzD,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;iBAC/B;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sDAAsD;iBACpE;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wDAAwD;iBACtE;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;QACD,IAAI,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC;QAC1C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC;QAChE,KAAK,CAAC,OAAO,CAAC,IAA6B;YACzC,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAE/D,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,KAAK,CAAC,CAAC,CAAC;oBACX,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBACpC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;wBAAE,OAAO,YAAY,CAAC;oBAC9C,OAAO,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxE,CAAC;gBACD,KAAK,KAAK,CAAC,CAAC,CAAC;oBACX,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK;wBAAE,OAAO,kBAAkB,CAAC;oBAC9C,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;oBACvC,OAAO,QAAQ,GAAG,MAAM,KAAK,EAAE,CAAC;gBAClC,CAAC;gBACD,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,IAAI,CAAC,GAAG;wBAAE,OAAO,UAAU,CAAC;oBAC5B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;oBACnD,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC;gBACnD,CAAC;gBACD;oBACE,OAAO,2BAA2B,CAAC;YACvC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"context-tools.js","sourceRoot":"","sources":["../../src/tool/context-tools.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,QAA0B;IAC9E,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,iBAAiB;QACzB,WAAW,EAAE,6EAA6E;QAC1F,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;oBACzD,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;iBAC/B;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sDAAsD;iBACpE;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wDAAwD;iBACtE;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;QACD,IAAI,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC;QAC1C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC;QAChE,KAAK,CAAC,OAAO,CAAC,IAA6B;YACzC,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAE/D,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,KAAK,CAAC,CAAC,CAAC;oBACX,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBACpC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;wBAAE,OAAO,YAAY,CAAC;oBAC9C,OAAO,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxE,CAAC;gBACD,KAAK,KAAK,CAAC,CAAC,CAAC;oBACX,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK;wBAAE,OAAO,kBAAkB,CAAC;oBAC9C,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;oBACvC,OAAO,QAAQ,GAAG,MAAM,KAAK,EAAE,CAAC;gBAClC,CAAC;gBACD,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,IAAI,CAAC,GAAG;wBAAE,OAAO,UAAU,CAAC;oBAC5B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;oBACnD,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC;gBACnD,CAAC;gBACD;oBACE,OAAO,2BAA2B,CAAC;YACvC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * 运行时上下文工具（session / profile），由 ToolSystem 按 turn 注入。\n */\nimport type { AgentTool } from '@zhin.js/ai';\nimport type { UserProfileStore } from '../user-profile.js';\nexport function createUserProfileTool(userId: string, profiles: UserProfileStore): AgentTool {\n  return {\n    name: 'user_profile',\n    source: 'builtin:context',\n    description: '读取或保存用户的个人偏好和信息。当用户告诉你他的名字、偏好、兴趣、习惯等个人信息时，用 set 操作保存。当需要了解用户偏好时，用 get 操作读取。',\n    parameters: {\n      type: 'object',\n      properties: {\n        action: {\n          type: 'string',\n          description: '操作类型: get（读取所有偏好）, set（保存偏好）, delete（删除偏好）',\n          enum: ['get', 'set', 'delete'],\n        },\n        key: {\n          type: 'string',\n          description: '偏好名称，如: name, style, interests, timezone, language 等',\n        },\n        value: {\n          type: 'string',\n          description: '偏好值（仅 set 操作需要）。language / preferred_language 会影响回复语言。',\n        },\n      },\n      required: ['action'],\n    },\n    tags: ['profile', '偏好', '用户', '个性化', '记住'],\n    keywords: ['我叫', '我的名字', '记住我', '我喜欢', '我偏好', '我习惯', '叫我', '我是'],\n    async execute(args: Record<string, unknown>) {\n      const action = typeof args.action === 'string' ? args.action : '';\n      const key = typeof args.key === 'string' ? args.key : '';\n      const value = typeof args.value === 'string' ? args.value : '';\n\n      switch (action) {\n        case 'get': {\n          const all = await profiles.getAll(userId);\n          const entries = Object.entries(all);\n          if (entries.length === 0) return '暂无保存的用户偏好。';\n          return '用户偏好：\\n' + entries.map(([k, v]) => `  ${k}: ${v}`).join('\\n');\n        }\n        case 'set': {\n          if (!key || !value) return '需要提供 key 和 value';\n          await profiles.set(userId, key, value);\n          return `已保存: ${key} = ${value}`;\n        }\n        case 'delete': {\n          if (!key) return '需要提供 key';\n          const deleted = await profiles.delete(userId, key);\n          return deleted ? `已删除: ${key}` : `未找到偏好: ${key}`;\n        }\n        default:\n          return '不支持的操作，请使用 get/set/delete';\n      }\n    },\n  };\n}\n"]}

package/lib/tool/contracts.d.ts

@@ -37,4 +37,3 @@ export interface ToolFilter {
 }
 export interface ToolSystemConfig {
 }
-//# sourceMappingURL=contracts.d.ts.map

package/lib/tool/contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/tool/contracts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/tool/contracts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * Tool System — 模块契约（与实现同步）。\n *\n * 实现：`ToolSystem.collectForTurn` 异步收集 `AgentTool[]`（`ToolSource.collectTools` 返回 `Promise<AgentTool[]>` 或同步 `AgentTool[]`）；\n * 每 turn 通过 `createDefaultToolSources` 独立 Source 列表，避免并发 mutate。\n */\n\nimport type { AgentTool } from '@zhin.js/ai';\nimport type { Message } from '@zhin.js/core';\nimport type { ToolScope } from '../resource-hub/types.js';\n\n/**\n * Tool registered on `ZhinAgent.registerTool` (runtime agent tool directory).\n * Extends the IM-agnostic {@link AgentTool} with the same per-message access\n * vocabulary as `@zhin.js/tool` ToolIndex descriptors\n * (platforms / scopes / permissions / hidden). `RegisteredToolSource`\n * enforces it via Core `canAccessTool`, so both registration paths share\n * one access predicate (see docs/advanced/agent-authoring.md).\n */\nexport interface RegisteredAgentTool extends AgentTool {\n  platforms?: string[];\n  scopes?: ToolScope[];\n  hidden?: boolean;\n}\n\nexport interface TurnContext {\n  message: Message;\n}\n\nexport interface FilterContext {\n  message: Message;\n}\n\nexport interface ToolSource {\n  name: string;\n  priority: number;\n  collectTools(context: TurnContext): AgentTool[] | Promise<AgentTool[]>;\n}\n\nexport interface ToolFilter {\n  name: string;\n  filter(tools: AgentTool[], context: FilterContext): AgentTool[];\n}\n\nexport interface ToolSystemConfig {\n  /** 预留扩展面 */\n}\n"]}

package/lib/tool/conversation-reference-tool.d.ts

@@ -2,4 +2,3 @@ import type { PluginId } from '@zhin.js/plugin-runtime';
 import type { ToolCapability } from '../plugin-runtime/capability-ingress.js';
 import type { TurnRequest } from '../turn/turn-ingress.js';
 export declare function createConversationReferenceCapability(owner: PluginId, request: TurnRequest): ToolCapability | undefined;
-//# sourceMappingURL=conversation-reference-tool.d.ts.map

package/lib/tool/conversation-reference-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-reference-tool.js","sourceRoot":"","sources":["../../src/tool/conversation-reference-tool.ts"],"names":[],"mappings":"AAKA,MAAM,SAAS,GAAG,gCAAgC,CAAC;AAEnD,MAAM,UAAU,qCAAqC,CACnD,KAAe,EACf,OAAoB;IAEpB,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;IACtC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IACvD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK;QACL,IAAI,EAAE,SAAS;QACf,aAAa,EAAE,SAAS;QACxB,WAAW,EAAE,kKAAkK;QAC/K,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2DAA2D,EAAE;gBACvG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;aAC1E;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACY;QACrC,gBAAgB,EAAE,OAAO;QACzB,MAAM,EAAE,8BAA8B;QACtC,KAAK,CAAC,OAAO,CAAsC,KAAa;YAC9D,MAAM,IAAI,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAY,CAAC;YAC1F,CAAC;YACD,MAAM,cAAc,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;gBAClF,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;gBACxB,CAAC,CAAC,CAAC,CAAC;YACN,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;gBACvB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;gBAC/C,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,MAAM;aACjB,EAAE,OAAO,CAAC,MAAM,CAAqB,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"conversation-reference-tool.js","sourceRoot":"","sources":["../../src/tool/conversation-reference-tool.ts"],"names":[],"mappings":"AAKA,MAAM,SAAS,GAAG,gCAAgC,CAAC;AAEnD,MAAM,UAAU,qCAAqC,CACnD,KAAe,EACf,OAAoB;IAEpB,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;IACtC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IACvD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK;QACL,IAAI,EAAE,SAAS;QACf,aAAa,EAAE,SAAS;QACxB,WAAW,EAAE,kKAAkK;QAC/K,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2DAA2D,EAAE;gBACvG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;aAC1E;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACY;QACrC,gBAAgB,EAAE,OAAO;QACzB,MAAM,EAAE,8BAA8B;QACtC,KAAK,CAAC,OAAO,CAAsC,KAAa;YAC9D,MAAM,IAAI,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAY,CAAC;YAC1F,CAAC;YACD,MAAM,cAAc,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;gBAClF,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;gBACxB,CAAC,CAAC,CAAC,CAAC;YACN,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;gBACvB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;gBAC/C,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,MAAM;aACjB,EAAE,OAAO,CAAC,MAAM,CAAqB,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { PluginId } from '@zhin.js/plugin-runtime';\nimport type { ToolInputJsonObjectSchema } from '@zhin.js/tool';\nimport type { ToolCapability } from '../plugin-runtime/capability-ingress.js';\nimport type { TurnRequest } from '../turn/turn-ingress.js';\n\nconst TOOL_NAME = 'inspect_conversation_reference';\n\nexport function createConversationReferenceCapability(\n  owner: PluginId,\n  request: TurnRequest,\n): ToolCapability | undefined {\n  const references = request.input.references ?? [];\n  const port = request.ports.references;\n  if (references.length === 0 || !port) return undefined;\n  const allowed = new Set(references.map((reference) => reference.key));\n  return Object.freeze({\n    owner,\n    name: TOOL_NAME,\n    qualifiedName: TOOL_NAME,\n    description: 'Read a quoted message, merged-forward record, or media reference from the current conversation. Only references listed in the current user message are accepted.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        reference: { type: 'string', description: 'Scoped reference key shown in the current message context' },\n        depth: { type: 'number', description: 'Nested forward depth, maximum 2' },\n      },\n      required: ['reference'],\n    } satisfies ToolInputJsonObjectSchema,\n    requiresApproval: 'never',\n    source: 'builtin:conversation-context',\n    async execute<TInput = unknown, TResult = unknown>(input: TInput): Promise<TResult> {\n      const args = input && typeof input === 'object' ? input as Record<string, unknown> : {};\n      const key = typeof args.reference === 'string' ? args.reference : '';\n      if (!allowed.has(key)) {\n        return Object.freeze({ status: 'forbidden', code: 'reference_not_in_turn' }) as TResult;\n      }\n      const requestedDepth = typeof args.depth === 'number' && Number.isFinite(args.depth)\n        ? Math.floor(args.depth)\n        : 1;\n      return port.resolve(key, {\n        depth: Math.max(0, Math.min(requestedDepth, 2)),\n        maxEntries: 50,\n        maxChars: 12_000,\n      }, request.signal) as Promise<TResult>;\n    },\n  });\n}\n"]}

package/lib/tool/deferred-resolution.d.ts

@@ -13,4 +13,3 @@ export interface ResolvedToolsForTurn {
 export declare function resolveAgentToolsForTurn(agent: ZhinAgentPrivate, allTools: AgentTool[], sessionId: string, platform?: string): Promise<ResolvedToolsForTurn>;
 export declare function persistDeferredToolSnapshot(agent: ZhinAgentPrivate, sessionId: string, snapshot: DeferredToolSessionSnapshot): Promise<void>;
 export declare function buildLlmToolsForProvider(sdk: string | undefined, catalog: ToolCatalogItem[], apiTools: AgentTool[], alwaysLoaded: Set<string>, sessionLoadedNames: string[]): LlmTool[];
-//# sourceMappingURL=deferred-resolution.d.ts.map

package/lib/tool/deferred-resolution.js.map

@@ -1 +1 @@
-{"version":3,"file":"deferred-resolution.js","sourceRoot":"","sources":["../../src/tool/deferred-resolution.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deferred-resolution.js","sourceRoot":"","sources":["../../src/tool/deferred-resolution.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AgentTool, type LlmTool, getLoadedToolNamesFromSnapshot, addSkillToSnapshot, touchToolsInSnapshot, type DeferredToolSessionSnapshot } from '@zhin.js/ai';\nimport { resolveMcpConnectionFromToolName } from '@zhin.js/ai/mcp-qualified-name';\nimport { agentToolToLlmTool } from '../tool-bridge.js';\nimport {\n  buildDeferredStats,\n  buildToolCatalog,\n  resolveDeferredApiTools,\n} from '../tool-catalog/tool-catalog.js';\nimport { DEFERRED_META_TOOL_NAMES, type ToolCatalogItem } from '../tool-catalog/types.js';\nimport { resolveDeferredToolsConfig } from '../tool-catalog/resolve-config.js';\nimport type { ZhinAgentPrivate } from '../internal/agent-host.js';\nimport { createDeferredTurnController, type DeferredTurnController } from '../tool-catalog/deferred-turn-controller.js';\nimport { buildSkillInstructionReaderForAgent } from '../skill/skill-instruction-reader-factory.js';\nexport interface ResolvedToolsForTurn {\n  tools: AgentTool[];\n  catalog: ToolCatalogItem[];\n  deferred: boolean;\n  deferredStats?: string;\n  sessionSnapshot: DeferredToolSessionSnapshot;\n  controller?: DeferredTurnController;\n}\n\nfunction buildMcpServerMap(tools: AgentTool[]): Map<string, string> {\n  const map = new Map<string, string>();\n  for (const tool of tools) {\n    const connection = resolveMcpConnectionFromToolName(tool.name, tool.source);\n    if (connection) map.set(tool.name, connection);\n  }\n  return map;\n}\n\nexport async function resolveAgentToolsForTurn(\n  agent: ZhinAgentPrivate,\n  allTools: AgentTool[],\n  sessionId: string,\n  platform?: string,\n): Promise<ResolvedToolsForTurn> {\n  const deferredCfg = resolveDeferredToolsConfig(agent.config);\n  const alwaysLoaded = new Set(deferredCfg.alwaysLoadedTools);\n  const baseTools = allTools.filter(tool => !DEFERRED_META_TOOL_NAMES.has(tool.name));\n  const mcpServerByTool = buildMcpServerMap(baseTools);\n\n  const baseCatalog = buildToolCatalog({\n    tools: baseTools,\n    mcpServerByTool,\n    alwaysLoaded,\n  });\n\n  let sessionSnapshot = await agent.contextRepository.getDeferredToolSnapshot(sessionId);\n  let touched = false;\n  const alwaysSkills = agent.skillSystem?.getAlwaysSkills()\n    ?? agent.skillRegistry?.getAlwaysSkills?.()\n    ?? [];\n  if (alwaysSkills.length > 0) {\n    for (const skill of alwaysSkills) {\n      sessionSnapshot = addSkillToSnapshot(sessionSnapshot, skill.name);\n      sessionSnapshot = touchToolsInSnapshot(\n        sessionSnapshot,\n        skill.tools.map(t => t.name).filter(name => !alwaysLoaded.has(name)),\n        deferredCfg.maxLoadedPerSession,\n      );\n      touched = true;\n    }\n  }\n  if (touched) {\n    await persistDeferredToolSnapshot(agent, sessionId, sessionSnapshot);\n  }\n  const controller = createDeferredTurnController({\n    sessionId,\n    platform,\n    catalog: baseCatalog,\n    skillRegistry: agent.skillRegistry,\n    snapshot: sessionSnapshot,\n    maxLoadedPerSession: deferredCfg.maxLoadedPerSession,\n    pinnedTools: alwaysLoaded,\n    discoverTopK: deferredCfg.discoverTopK,\n    persistSnapshot: async (snapshot) => {\n      agent.deferred.lastSessionSnapshot = snapshot;\n      await persistDeferredToolSnapshot(agent, sessionId, snapshot);\n    },\n    onSkillLoaded: (_name, instructions) => agent.appendActiveSkillsContext(instructions),\n    skillInstructions: buildSkillInstructionReaderForAgent(agent),\n  });\n  const turnTools = [...baseTools, ...controller.tools as unknown as AgentTool[]];\n  const catalog = buildToolCatalog({\n    tools: turnTools,\n    mcpServerByTool,\n    alwaysLoaded,\n  });\n  const sessionLoaded = getLoadedToolNamesFromSnapshot(sessionSnapshot);\n  const apiTools = resolveDeferredApiTools(catalog, alwaysLoaded, sessionLoaded);\n  const deferredStats = buildDeferredStats(catalog, apiTools);\n\n  agent.deferred.catalog = catalog.map(c => c.fullTool);\n\n  return {\n    tools: apiTools,\n    catalog,\n    deferred: true,\n    deferredStats,\n    sessionSnapshot,\n    controller,\n  };\n}\n\nexport async function persistDeferredToolSnapshot(\n  agent: ZhinAgentPrivate,\n  sessionId: string,\n  snapshot: DeferredToolSessionSnapshot,\n): Promise<void> {\n  await agent.contextRepository.setDeferredToolSnapshot(sessionId, snapshot);\n}\n\nexport function buildLlmToolsForProvider(\n  sdk: string | undefined,\n  catalog: ToolCatalogItem[],\n  apiTools: AgentTool[],\n  alwaysLoaded: Set<string>,\n  sessionLoadedNames: string[],\n): LlmTool[] {\n  const loaded = new Set([...alwaysLoaded, ...sessionLoadedNames]);\n  if (sdk === 'anthropic') {\n    return catalog\n      .filter(item => item.source !== 'meta')\n      .map(item => ({\n        ...agentToolToLlmTool(item.fullTool),\n        deferLoading: !loaded.has(item.name),\n      }));\n  }\n  return apiTools.map(t => agentToolToLlmTool(t));\n}\n"]}

package/lib/tool/executable-tool-registry.d.ts

@@ -8,4 +8,3 @@ export declare class ExecutableToolRegistry {
     resolve(name: string): AgentTool | undefined;
     list(): AgentTool[];
 }
-//# sourceMappingURL=executable-tool-registry.d.ts.map

package/lib/tool/executable-tool-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"executable-tool-registry.js","sourceRoot":"","sources":["../../src/tool/executable-tool-registry.ts"],"names":[],"mappings":"AAEA,+FAA+F;AAC/F,MAAM,OAAO,sBAAsB;IACxB,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE/C,YAAY,QAA8B,EAAE;QAC1C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,CAAC,KAA2B;QACjC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,UAAU,CAAC,KAA0B;QACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;CACF"}
+{"version":3,"file":"executable-tool-registry.js","sourceRoot":"","sources":["../../src/tool/executable-tool-registry.ts"],"names":[],"mappings":"AAEA,+FAA+F;AAC/F,MAAM,OAAO,sBAAsB;IACxB,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE/C,YAAY,QAA8B,EAAE;QAC1C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,CAAC,KAA2B;QACjC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,UAAU,CAAC,KAA0B;QACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;CACF","sourcesContent":["import type { AgentTool } from '@zhin.js/ai';\n\n/** Turn-owned source of truth for tools visible to the model and executable by the runtime. */\nexport class ExecutableToolRegistry {\n  readonly #tools = new Map<string, AgentTool>();\n\n  constructor(tools: readonly AgentTool[] = []) {\n    this.replace(tools);\n  }\n\n  replace(tools: readonly AgentTool[]): void {\n    this.#tools.clear();\n    for (const tool of tools) this.#tools.set(tool.name, tool);\n  }\n\n  addMissing(tools: Iterable<AgentTool>): void {\n    for (const tool of tools) {\n      if (!this.#tools.has(tool.name)) this.#tools.set(tool.name, tool);\n    }\n  }\n\n  resolve(name: string): AgentTool | undefined {\n    return this.#tools.get(name);\n  }\n\n  list(): AgentTool[] {\n    return [...this.#tools.values()];\n  }\n}\n"]}

package/lib/tool/index.d.ts

@@ -14,4 +14,3 @@ export type { TurnToolsPrep } from './prepare-turn-tools.js';
 export { TurnToolExecutionAuthority, TurnToolRuntime } from './turn-tool-runtime.js';
 export type { TurnToolOutcome } from './turn-tool-runtime.js';
 export { createConversationReferenceCapability } from './conversation-reference-tool.js';
-//# sourceMappingURL=index.d.ts.map

package/lib/tool/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tool/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,WAAW,EACX,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAErF,OAAO,EAAE,qCAAqC,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tool/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,WAAW,EACX,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAErF,OAAO,EAAE,qCAAqC,EAAE,MAAM,kCAAkC,CAAC","sourcesContent":["/**\n * Tool System — ToolSystem + Source + 运行时/延迟解析（契约见 contracts.ts）。\n */\n\nexport type {\n  ToolSource,\n  ToolFilter,\n  ToolSystemConfig,\n  TurnContext,\n  FilterContext,\n  RegisteredAgentTool,\n} from './contracts.js';\n\nexport type { ResolvedToolsForTurn } from './deferred-resolution.js';\nexport type { CollectToolsContext, CollectToolsForTurnInput } from './tool-system.js';\nexport type { CollectRuntimeToolsOptions, ToolRunPlan } from './runtime.js';\n\nexport {\n  ToolSystem,\n  defaultToolSystem,\n  createToolSystem,\n  createDefaultToolSources,\n  planToolRun,\n  buildPreExecFastPathPrompt,\n} from './tool-system.js';\n\nexport {\n  ExternalToolSource,\n  SkillToolSource,\n  RegisteredToolSource,\n  BuiltinToolSource,\n  McpToolSource,\n  DedupeToolFilter,\n} from './sources.js';\n\nexport {\n  resolveAgentToolsForTurn,\n  persistDeferredToolSnapshot,\n  buildLlmToolsForProvider,\n} from './deferred-resolution.js';\n\nexport { collectRuntimeTools } from './runtime.js';\nexport { prepareTurnTools } from './prepare-turn-tools.js';\nexport type { TurnToolsPrep } from './prepare-turn-tools.js';\nexport { TurnToolExecutionAuthority, TurnToolRuntime } from './turn-tool-runtime.js';\nexport type { TurnToolOutcome } from './turn-tool-runtime.js';\nexport { createConversationReferenceCapability } from './conversation-reference-tool.js';\n"]}

package/lib/tool/pre-exec.d.ts

@@ -4,4 +4,3 @@ export interface PreExecuteResult {
     data: string;
 }
 export declare function runPreExecutableTools(tools: AgentTool[], timeoutMs: number): Promise<PreExecuteResult>;
-//# sourceMappingURL=pre-exec.d.ts.map

package/lib/tool/pre-exec.js.map

@@ -1 +1 @@
-{"version":3,"file":"pre-exec.js","sourceRoot":"","sources":["../../src/tool/pre-exec.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAkB,EAClB,SAAiB;IAEjB,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9D,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAChB,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAC5B,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;SACrD,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC,CAAC,CACH,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW;YAAE,SAAS;QACvC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7F,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACnB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,qBAAqB,CAAC,CAAC,MAAM,eAAe,CAAC;QACrE,CAAC;QACD,IAAI,IAAI,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"pre-exec.js","sourceRoot":"","sources":["../../src/tool/pre-exec.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAkB,EAClB,SAAiB;IAEjB,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9D,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAChB,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAC5B,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;SACrD,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC,CAAC,CACH,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW;YAAE,SAAS;QACvC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7F,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACnB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,qBAAqB,CAAC,CAAC,MAAM,eAAe,CAAC;QACrE,CAAC;QACD,IAAI,IAAI,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC","sourcesContent":["import type { AgentTool } from '@zhin.js/ai';\n\nexport interface PreExecuteResult {\n  tools: AgentTool[];\n  data: string;\n}\n\nexport async function runPreExecutableTools(\n  tools: AgentTool[],\n  timeoutMs: number,\n): Promise<PreExecuteResult> {\n  const preExecTools = tools.filter(tool => tool.preExecutable);\n  let data = '';\n  if (preExecTools.length === 0) {\n    return { tools: preExecTools, data };\n  }\n\n  const results = await Promise.allSettled(\n    preExecTools.map(async (tool) => {\n      const result = await Promise.race([\n        tool.execute({}),\n        new Promise<never>((_, rej) =>\n          setTimeout(() => rej(new Error('超时')), timeoutMs)),\n      ]);\n      return { name: tool.name, result };\n    }),\n  );\n\n  for (const r of results) {\n    if (r.status !== 'fulfilled') continue;\n    let s = typeof r.value.result === 'string' ? r.value.result : JSON.stringify(r.value.result);\n    if (s.length > 500) {\n      s = s.slice(0, 500) + `\\n... (truncated, ${s.length} chars total)`;\n    }\n    data += `\\n【${r.value.name}】${s}`;\n  }\n\n  return { tools: preExecTools, data };\n}\n"]}

package/lib/tool/prepare-turn-tools.d.ts

@@ -19,4 +19,3 @@ export declare function prepareTurnTools(host: ZhinAgentPrivate, opts: {
     userId: string;
     mcpServerNames: string[];
 }): Promise<TurnToolsPrep>;
-//# sourceMappingURL=prepare-turn-tools.d.ts.map

package/lib/tool/prepare-turn-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"prepare-turn-tools.js","sourceRoot":"","sources":["../../src/tool/prepare-turn-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prepare-turn-tools.js","sourceRoot":"","sources":["../../src/tool/prepare-turn-tools.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from '@zhin.js/ai';\nimport type { Message } from '@zhin.js/core';\nimport {\n  ensureMcpConnectionsForBinding,\n  getMcpToolsForBinding,\n} from '../resource-hub/mcp-lifecycle.js';\nimport { rehydrateTurnActiveSkills } from '../assistant/schedule-skills.js';\nimport { captureDeferredSnapshotBefore, cloneDeferredSnapshot } from '../internal/turn-context.js';\nimport type { ZhinAgentPrivate, Tool } from '../internal/agent-host.js';\nimport { defaultToolSystem } from '../tool/tool-system.js';\nimport type { ResolvedToolsForTurn } from './deferred-resolution.js';\n\nfunction listSpawnableAgentNames(host: ZhinAgentPrivate): string[] {\n  const presets = host.resourceHub?.subagents.getAllPresets().map((p) => p.name) ?? [];\n  return [...new Set(presets.filter(Boolean))].sort();\n}\n\nexport interface TurnToolsPrep {\n  contextForTools: Message;\n  allTools: AgentTool[];\n  resolved: ResolvedToolsForTurn;\n  resolvedTools: AgentTool[];\n  deferredStats?: string;\n  catalog: ResolvedToolsForTurn['catalog'];\n  sessionSnapshot: ResolvedToolsForTurn['sessionSnapshot'];\n}\n\nexport async function prepareTurnTools(\n  host: ZhinAgentPrivate,\n  opts: {\n    content: string;\n    commMessage: Message;\n    externalTools: Tool[];\n    sessionId: string;\n    userId: string;\n    mcpServerNames: string[];\n  },\n): Promise<TurnToolsPrep> {\n  const userId = opts.userId;\n  const contextForTools = opts.commMessage;\n\n  if (host.resourceHub && opts.mcpServerNames.length > 0) {\n    await ensureMcpConnectionsForBinding(host.resourceHub.mcps, opts.mcpServerNames, (event) => {\n      const payload = host.emitter.createPayload(opts.sessionId, contextForTools, 'text', {\n        path: 'agent',\n        serverName: event.serverName,\n        loadedToolNames: event.toolNames,\n        reason: event.connected === false ? 'disconnected' : undefined,\n        error: event.error,\n      });\n      if (event.phase === 'start') {\n        host.emitter.emit('ai.mcp.connect.start', payload);\n      } else if (event.phase === 'finish') {\n        host.emitter.emit('ai.mcp.connect.finish', payload);\n      } else {\n        host.emitter.emit('ai.mcp.connect.error', payload);\n      }\n    });\n  }\n\n  const mcpTools = host.resourceHub && opts.mcpServerNames.length > 0\n    ? getMcpToolsForBinding(host.resourceHub.mcps, opts.mcpServerNames)\n    : [];\n\n  const toolSystem = host.toolSystem ?? defaultToolSystem;\n  const allTools = await toolSystem.collectForTurn({\n    host,\n    message: contextForTools,\n    content: opts.content,\n    sessionId: opts.sessionId,\n    userId,\n    config: host.config,\n    skillRegistry: host.skillRegistry,\n    externalTools: opts.externalTools,\n    externalRegistered: host.externalTools,\n    userProfiles: host.userProfiles,\n    mcpTools,\n    spawnableAgentNames: host.subagentSystem ? listSpawnableAgentNames(host) : undefined,\n  });\n\n  const resolved = await toolSystem.resolveForTurn(\n    host,\n    allTools,\n    opts.sessionId,\n    String(contextForTools.clientAdapter ?? contextForTools.conversation.endpoint.adapter),\n  );\n  const { tools: resolvedTools, deferredStats, catalog, sessionSnapshot: initialSnapshot } = resolved;\n\n  const sessionSnapshot = initialSnapshot;\n  captureDeferredSnapshotBefore(sessionSnapshot);\n  host.deferred.lastSnapshotBefore = cloneDeferredSnapshot(sessionSnapshot);\n  await rehydrateTurnActiveSkills(host, opts.sessionId, host.getAlwaysSkillsBaseline());\n  host.deferred.lastSessionSnapshot = sessionSnapshot;\n  host.deferred.lastCatalog = catalog;\n  host.deferred.lastToolSearchStats = deferredStats;\n\n  return {\n    contextForTools,\n    allTools,\n    resolved,\n    resolvedTools,\n    deferredStats,\n    catalog,\n    sessionSnapshot,\n  };\n}\n"]}

package/lib/tool/runtime.d.ts

@@ -21,4 +21,3 @@ export interface CollectRuntimeToolsOptions {
 export declare function collectRuntimeTools(options: CollectRuntimeToolsOptions): Promise<AgentTool[]>;
 export type { ToolRunPlan };
 export { planToolRun, buildPreExecFastPathPrompt } from './tool-system.js';
-//# sourceMappingURL=runtime.d.ts.map

package/lib/tool/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/tool/runtime.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAIlB,MAAM,kBAAkB,CAAC;AAe1B,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAmC;IAC3E,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC;IAC3D,MAAM,GAAG,GAAwB;QAC/B,OAAO,EAAE,OAAO,CAAC,WAAW;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;IACF,OAAO,UAAU,CAAC,YAAY,CAAC,GAAG,EAAE,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC;AACrE,CAAC;AAGD,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/tool/runtime.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAIlB,MAAM,kBAAkB,CAAC;AAe1B,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAmC;IAC3E,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC;IAC3D,MAAM,GAAG,GAAwB;QAC/B,OAAO,EAAE,OAAO,CAAC,WAAW;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;IACF,OAAO,UAAU,CAAC,YAAY,CAAC,GAAG,EAAE,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC;AACrE,CAAC;AAGD,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC","sourcesContent":["import type { AgentTool } from '@zhin.js/ai';\nimport type { Tool, Message } from '../resource-hub/types.js';\nimport type { SkillRegistry } from '../resource-hub/skill-registry.js';\nimport type { ZhinAgentConfig } from '../config/zhin-agent-config.js';\nimport type { UserProfileStore } from '../user-profile.js';\nimport type { RegisteredAgentTool } from './contracts.js';\nimport {\n  createDefaultToolSources,\n  defaultToolSystem,\n  type CollectToolsContext,\n  type ToolRunPlan,\n  type ToolSystem,\n} from './tool-system.js';\nexport interface CollectRuntimeToolsOptions {\n  content: string;\n  commMessage: Message;\n  externalTools: Tool[];\n  config: Required<ZhinAgentConfig>;\n  skillRegistry: SkillRegistry | null;\n  externalRegistered: Map<string, RegisteredAgentTool>;\n  sessionId: string;\n  userId: string;\n  userProfiles: UserProfileStore;\n  mcpTools?: AgentTool[];\n  toolSystem?: ToolSystem;\n}\n\nexport async function collectRuntimeTools(options: CollectRuntimeToolsOptions): Promise<AgentTool[]> {\n  const toolSystem = options.toolSystem ?? defaultToolSystem;\n  const ctx: CollectToolsContext = {\n    message: options.commMessage,\n    content: options.content,\n    sessionId: options.sessionId,\n    userId: options.userId,\n    config: options.config,\n    skillRegistry: options.skillRegistry,\n    externalTools: options.externalTools,\n    externalRegistered: options.externalRegistered,\n    userProfiles: options.userProfiles,\n    mcpTools: options.mcpTools,\n  };\n  return toolSystem.collectTools(ctx, createDefaultToolSources(ctx));\n}\n\nexport type { ToolRunPlan };\nexport { planToolRun, buildPreExecFastPathPrompt } from './tool-system.js';\n"]}

package/lib/tool/sources.d.ts

@@ -63,4 +63,3 @@ export declare class DedupeToolFilter implements ToolFilter {
     name: string;
     filter(tools: AgentTool[]): AgentTool[];
 }
-//# sourceMappingURL=sources.d.ts.map

package/lib/tool/sources.js.map

@@ -1 +1 @@
-{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../src/tool/sources.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../src/tool/sources.ts"],"names":[],"mappings":"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","sourcesContent":["import { isReservedToolName, type AgentTool } from '@zhin.js/ai';\nimport { canAccessTool, type Tool as CoreTool } from '@zhin.js/core';\nimport { getLogger } from '@zhin.js/logger';\nimport type { PermissionHost } from '@zhin.js/permission';\nimport type { Tool, Message } from '../resource-hub/types.js';\nimport type { SkillRegistry } from '../resource-hub/skill-registry.js';\nimport type { ZhinAgentConfig } from '../config/zhin-agent-config.js';\nimport { KEYWORD_TRIGGERS } from '../config/keyword-triggers.js';\nimport { createUserProfileTool } from '../tool/context-tools.js';\nimport type { UserProfileStore } from '../user-profile.js';\nimport { normalizeTool } from '../resource-hub/tool-selection.js';\nimport { RESERVED_TOOL_NAMES, RESERVED_TOOL_NAME_PREFIXES } from '../reserved-tools.js';\nimport type { RegisteredAgentTool, ToolFilter, ToolSource } from './contracts.js';\nconst logger = getLogger('ToolSystem');\n\nexport interface CollectToolsContext {\n  message: Message;\n  content: string;\n  sessionId: string;\n  userId: string;\n  config: Required<ZhinAgentConfig>;\n  skillRegistry: SkillRegistry | null;\n  externalTools: Tool[];\n  externalRegistered: Map<string, RegisteredAgentTool>;\n  userProfiles: UserProfileStore;\n  mcpTools?: AgentTool[];\n  /** PermissionHost（permit 声明的工具经其判定；缺省 fail-closed）。 */\n  permissionHost?: PermissionHost | null;\n}\n\nexport class ExternalToolSource implements ToolSource {\n  name = 'external';\n  priority = 200;\n\n  constructor(private readonly externalTools: Tool[]) {}\n\n  async collectTools(context: CollectToolsContext): Promise<AgentTool[]> {\n    const tools: AgentTool[] = [];\n    for (const tool of this.externalTools) {\n      if (!(await canAccessTool(tool as unknown as CoreTool, context.message, context.permissionHost))) continue;\n      tools.push(normalizeTool(tool, context.message));\n    }\n    return tools;\n  }\n}\n\nexport class SkillToolSource implements ToolSource {\n  name = 'skills';\n  priority = 100;\n\n  constructor(private readonly skillRegistry: SkillRegistry | null) {}\n\n  collectTools(context: CollectToolsContext): AgentTool[] {\n    if (!this.skillRegistry) return [];\n    return this.skillRegistry.collectAllTools().map((tool) =>\n      normalizeTool(tool, context.message),\n    );\n  }\n}\n\nexport class RegisteredToolSource implements ToolSource {\n  name = 'registered';\n  priority = 150;\n\n  constructor(private readonly externalRegistered: Map<string, RegisteredAgentTool>) {}\n\n  /**\n   * Same per-message access predicate as {@link ExternalToolSource} — one\n   * `canAccessTool` for both registration paths; `hidden` tools stay\n   * executable by name but are never offered to the model.\n   */\n  async collectTools(context: CollectToolsContext): Promise<AgentTool[]> {\n    const tools: AgentTool[] = [];\n    for (const tool of this.externalRegistered.values()) {\n      if (tool.hidden) continue;\n      if (!(await canAccessTool(tool as unknown as CoreTool, context.message, context.permissionHost))) continue;\n      tools.push(tool);\n    }\n    return tools;\n  }\n}\n\nexport class BuiltinToolSource implements ToolSource {\n  name = 'builtin';\n  priority = 1000;\n\n  collectTools(context: CollectToolsContext): AgentTool[] {\n    const tools: AgentTool[] = [];\n    if (KEYWORD_TRIGGERS.userProfile.test(context.content)) {\n      tools.push(createUserProfileTool(context.userId, context.userProfiles));\n    }\n    return tools;\n  }\n}\n\nexport class McpToolSource implements ToolSource {\n  name = 'mcp';\n  priority = 50;\n\n  collectTools(context: CollectToolsContext): AgentTool[] {\n    const tools: AgentTool[] = [];\n    for (const mcpTool of context.mcpTools ?? []) {\n      if (isReservedToolName(mcpTool.name, {\n        reservedNames: RESERVED_TOOL_NAMES,\n        reservedPrefixes: RESERVED_TOOL_NAME_PREFIXES,\n      })) {\n        logger.warn(`[MCP] Skipping tool \"${mcpTool.name}\": conflicts with reserved tool name`);\n        continue;\n      }\n      tools.push(mcpTool);\n    }\n    return tools;\n  }\n}\n\nexport class PermissionToolFilter implements ToolFilter {\n  name = 'permission';\n\n  filter(tools: AgentTool[]): AgentTool[] {\n    return tools;\n  }\n}\n\nexport class DedupeToolFilter implements ToolFilter {\n  name = 'dedupe';\n\n  filter(tools: AgentTool[]): AgentTool[] {\n    const names = new Set<string>();\n    const out: AgentTool[] = [];\n    for (const tool of tools) {\n      if (names.has(tool.name)) continue;\n      out.push(tool);\n      names.add(tool.name);\n    }\n    return out;\n  }\n}\n"]}

package/lib/tool/tool-approval-gate.d.ts

@@ -31,4 +31,3 @@ export interface ToolApprovalGateOptions {
  * Returns denial message when approval is required but not granted; otherwise null.
  */
 export declare function runToolApprovalGate(options: ToolApprovalGateOptions): Promise<string | null>;
-//# sourceMappingURL=tool-approval-gate.d.ts.map

package/lib/tool/tool-approval-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-approval-gate.js","sourceRoot":"","sources":["../../src/tool/tool-approval-gate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-approval-gate.js","sourceRoot":"","sources":["../../src/tool/tool-approval-gate.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Per-tool approval gate — stacks with ExecPolicy (ADR 0039 P1).\n */\nimport type { Message } from '@zhin.js/core';\nimport { AgentRunJournal, AgentStreamEventType, type AgentRunEventInput } from '@zhin.js/ai/agent-stream';\nimport type { ToolApprovalPolicy } from '@zhin.js/ai/tool-policy';\nimport type { AgentStreamBus, AgentStreamPublishContext } from '../event/agent-stream-bus.js';\nimport { isApprovalPortAvailable, type ApprovalPort } from '../session/approval-port.js';\nimport type { ToolApprovalOnceStore } from './tool-approval-once-store.js';\n\nexport type ToolApprovalGatePolicy = ToolApprovalPolicy;\n\nexport async function resolveToolApprovalRequired(\n  policy: ToolApprovalGatePolicy | undefined,\n  input: { toolName: string; args: Record<string, unknown>; sessionId: string },\n  onceStore?: ToolApprovalOnceStore,\n): Promise<boolean> {\n  if (!policy || policy === 'never') return false;\n  if (policy === 'always' || policy === 'on-risk') return true;\n  if (policy === 'once') {\n    if (!onceStore) return true;\n    return !onceStore.has(input.sessionId, input.toolName);\n  }\n  return Boolean(await policy({ toolName: input.toolName, args: input.args }));\n}\n\nexport interface ToolApprovalGateOptions {\n  toolName: string;\n  args: Record<string, unknown>;\n  sessionId: string;\n  commMessage: Message;\n  policy?: ToolApprovalGatePolicy;\n  bus?: AgentStreamBus;\n  port?: ApprovalPort;\n  onceStore?: ToolApprovalOnceStore;\n  publishCtx?: AgentStreamPublishContext;\n  /** Stream-turn journal; request/result become ordered run events when present. */\n  journal?: AgentRunJournal;\n  signal: AbortSignal;\n}\n\n/**\n * Returns denial message when approval is required but not granted; otherwise null.\n */\nexport async function runToolApprovalGate(\n  options: ToolApprovalGateOptions,\n): Promise<string | null> {\n  const required = await resolveToolApprovalRequired(options.policy, {\n    toolName: options.toolName,\n    args: options.args,\n    sessionId: options.sessionId,\n  }, options.onceStore);\n  if (!required) return null;\n\n  if (!isApprovalPortAvailable(options.port)) {\n    return 'Error: approval required but ApprovalPort unavailable';\n  }\n\n  const requestId = `approval_${options.toolName}_${Date.now()}`;\n  const publishCtx: AgentStreamPublishContext = {\n    sessionId: options.sessionId,\n    ...options.publishCtx,\n  };\n\n  await publishApprovalEvent(options, {\n    type: AgentStreamEventType.INPUT_REQUESTED,\n    data: {\n      sessionId: options.sessionId,\n      requestId,\n      sessionKey: options.sessionId,\n      requesterId: options.commMessage.sender?.id,\n      toolName: options.toolName,\n      kind: 'approval',\n      args: options.args,\n    },\n  }, publishCtx);\n\n  const question = `工具「${options.toolName}」需要确认后执行。是否继续？`;\n  let approved = false;\n  let failure: string | undefined;\n  try {\n    approved = await options.port.requestApproval({\n      requestId,\n      sessionKey: options.sessionId,\n      conversationScope: options.commMessage.conversation.kind,\n      requesterId: options.commMessage.sender?.id,\n      toolName: options.toolName,\n      scopeKey: `${options.toolName}:${stableApprovalValue(options.args)}`,\n      question,\n      signal: options.signal,\n    });\n  } catch (err) {\n    failure = err instanceof Error ? err.message : String(err);\n  }\n\n  await publishApprovalEvent(options, {\n    type: AgentStreamEventType.INPUT_COMPLETED,\n    data: {\n      sessionId: options.sessionId,\n      requestId,\n      toolName: options.toolName,\n      kind: 'approval',\n      approved,\n      ...(failure ? { error: failure } : {}),\n    },\n  }, publishCtx);\n\n  if (failure) return `Error: approval wait failed — ${failure}`;\n\n  if (!approved) {\n    return `Error: tool \"${options.toolName}\" execution denied by user`;\n  }\n\n  if (options.policy === 'once' && options.onceStore) {\n    options.onceStore.add(options.sessionId, options.toolName);\n  }\n  return null;\n}\n\nfunction stableApprovalValue(value: unknown): string {\n  if (Array.isArray(value)) return `[${value.map(stableApprovalValue).join(',')}]`;\n  if (value && typeof value === 'object') {\n    return `{${Object.entries(value as Record<string, unknown>)\n      .sort(([left], [right]) => left.localeCompare(right))\n      .map(([key, entry]) => `${JSON.stringify(key)}:${stableApprovalValue(entry)}`)\n      .join(',')}}`;\n  }\n  if (typeof value === 'undefined') return 'undefined';\n  try { return JSON.stringify(value); } catch { return String(value); }\n}\n\nasync function publishApprovalEvent(\n  options: ToolApprovalGateOptions,\n  event: AgentRunEventInput,\n  ctx: AgentStreamPublishContext,\n): Promise<void> {\n  const journalled = options.journal?.append(event);\n  if (options.journal && !journalled) return;\n  if (options.bus) await options.bus.publish(journalled ?? event, ctx);\n}\n"]}

package/lib/tool/tool-approval-once-store.d.ts

@@ -7,4 +7,3 @@ export declare class ToolApprovalOnceStore {
     add(sessionId: string, toolName: string): void;
     clear(): void;
 }
-//# sourceMappingURL=tool-approval-once-store.d.ts.map

package/lib/tool/tool-approval-once-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-approval-once-store.js","sourceRoot":"","sources":["../../src/tool/tool-approval-once-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACf,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,GAAG,CAAC,SAAiB,EAAE,QAAgB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,GAAG,CAAC,SAAiB,EAAE,QAAgB;QACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CACF"}
+{"version":3,"file":"tool-approval-once-store.js","sourceRoot":"","sources":["../../src/tool/tool-approval-once-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACf,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,GAAG,CAAC,SAAiB,EAAE,QAAgB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,GAAG,CAAC,SAAiB,EAAE,QAAgB;QACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CACF","sourcesContent":["/**\n * Per-resource-hub store for policy: 'once' tool approvals (ADR 0039 P1).\n */\nexport class ToolApprovalOnceStore {\n  private readonly keys = new Set<string>();\n\n  has(sessionId: string, toolName: string): boolean {\n    return this.keys.has(`${sessionId}:${toolName}`);\n  }\n\n  add(sessionId: string, toolName: string): void {\n    this.keys.add(`${sessionId}:${toolName}`);\n  }\n\n  clear(): void {\n    this.keys.clear();\n  }\n}\n"]}

package/lib/tool/tool-execution-authority.d.ts

@@ -23,4 +23,3 @@ export declare class RuntimeToolExecutionAuthority implements ToolExecutionAutho
     constructor(options: ToolExecutionAuthorityOptions);
     execute(tool: AgentTool, input: Readonly<Record<string, unknown>>, toolUseId: string): Promise<AgentCoreToolExecutionOutcome>;
 }
-//# sourceMappingURL=tool-execution-authority.d.ts.map

package/lib/tool/tool-execution-authority.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-execution-authority.js","sourceRoot":"","sources":["../../src/tool/tool-execution-authority.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-execution-authority.js","sourceRoot":"","sources":["../../src/tool/tool-execution-authority.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,6BAA6B,EAA+B,MAAM,6CAA6C,CAAC;AACzH,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAahD;;;GAGG;AACH,MAAM,OAAO,6BAA6B;IAC/B,QAAQ,CAAgC;IACxC,QAAQ,CAAc;IAE/B,YAAY,OAAsC;QAChD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC;YAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,WAAW,EAAE,OAAO,CAAC,OAAO;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACtB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,OAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;gBAC5D,CAAC,CAAC,SAAS;YACb,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM;YAC3B,mBAAmB,EAAE,6BAA6B;SACnD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CACX,IAAe,EACf,KAAwC,EACxC,SAAiB;QAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc;eACxC,IAAI,CAAC,gBAAgB;eACrB,IAAI,CAAC,gBAAgB,KAAK,OAAO;YACpC,CAAC,CAAC,iEAAiE;YACnE,CAAC,CAAC,MAAM,mBAAmB,CAAC;gBAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,IAAI,EAAE,EAAE,GAAG,KAAK,EAAE;gBAClB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,WAAW,EAAE,OAAO,CAAC,OAAO;gBAC5B,MAAM,EAAE,IAAI,CAAC,gBAAgB;gBAC7B,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc;gBAC7C,IAAI,EAAE,uBAAuB,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;oBACtD,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY;oBAC3B,CAAC,CAAC,SAAS;gBACb,UAAU,EAAE;oBACV,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B;gBACD,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY;gBACjD,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;QACL,IAAI,cAAc;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;QAEvF,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,kBAAkB,CACtC,OAAO,CAAC,OAAO,EACf,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,EAC1E,EAAE,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,CAChD,CAAC;YACF,MAAM,OAAO,GAAG,OAAO,CAAC,kBAAkB;gBACxC,CAAC,CAAC,MAAM,6BAA6B,CAAC,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC;gBAC1E,CAAC,CAAC,MAAM,OAAO,EAAE,CAAC;YACpB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC7E,CAAC;YACD,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,MAAM,EAAE,WAAW;gBACnB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC3B,OAAO,MAAM,CAAC,MAAM,CAAC;oBACnB,MAAM,EAAE,WAAW;oBACnB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,YAAY,KAAK;wBAC5C,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO;wBAC/B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,0BAA0B,CAAC;iBAChE,CAAC,CAAC;YACL,CAAC;YACD,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF","sourcesContent":["import type { AgentTool } from '@zhin.js/ai';\nimport type { AgentRunJournal } from '@zhin.js/ai/agent-stream';\nimport type { Message } from '@zhin.js/core';\nimport type {\n  AgentCoreToolExecutionOutcome,\n  ToolExecutionAuthority,\n} from '../core/tool-execution-authority.js';\nimport type { ZhinAgentPrivate } from '../internal/agent-host.js';\nimport { runWithCommMessage } from '../security/comm-message-context.js';\nimport { isApprovalPortAvailable } from '../session/approval-port.js';\nimport { runWithDeferredTurnController, type DeferredTurnController } from '../tool-catalog/deferred-turn-controller.js';\nimport { resolveBuiltinToolPolicyInput } from './builtin-policy-extractors.js';\nimport { runToolApprovalGate } from './tool-approval-gate.js';\nimport { ToolRuntime } from './tool-runtime.js';\n\nexport interface ToolExecutionAuthorityOptions {\n  readonly host: ZhinAgentPrivate;\n  readonly sessionId: string;\n  readonly message: Message;\n  readonly signal: AbortSignal;\n  readonly generation: number;\n  readonly rejectApproval: boolean;\n  readonly deferredController?: DeferredTurnController;\n  readonly journal?: AgentRunJournal;\n}\n\n/**\n * Adapter for the Tool definitions. AgentCore itself never\n * reads Message, policy configuration, or approval transports through this seam.\n */\nexport class RuntimeToolExecutionAuthority implements ToolExecutionAuthority {\n  readonly #options: ToolExecutionAuthorityOptions;\n  readonly #runtime: ToolRuntime;\n\n  constructor(options: ToolExecutionAuthorityOptions) {\n    this.#options = options;\n    this.#runtime = new ToolRuntime({\n      generation: options.generation,\n      signal: options.signal,\n      sessionId: options.sessionId,\n      commMessage: options.message,\n      journal: options.journal\n        ? { append: (event) => { options.journal!.append(event); } }\n        : undefined,\n      config: options.host.config,\n      policyInputResolver: resolveBuiltinToolPolicyInput,\n    });\n  }\n\n  async execute(\n    tool: AgentTool,\n    input: Readonly<Record<string, unknown>>,\n    toolUseId: string,\n  ): Promise<AgentCoreToolExecutionOutcome> {\n    const options = this.#options;\n    const approvalDenied = options.rejectApproval\n      && tool.requiresApproval\n      && tool.requiresApproval !== 'never'\n      ? 'Error: unattended execution rejects tools that require approval'\n      : await runToolApprovalGate({\n        toolName: tool.name,\n        args: { ...input },\n        sessionId: options.sessionId,\n        commMessage: options.message,\n        policy: tool.requiresApproval,\n        bus: options.host.resourceHub?.agentStreamBus,\n        port: isApprovalPortAvailable(options.host.approvalPort)\n          ? options.host.approvalPort\n          : undefined,\n        publishCtx: {\n          sessionId: options.sessionId,\n        },\n        onceStore: options.host.resourceHub?.approvalOnce,\n        journal: options.journal,\n        signal: options.signal,\n      });\n    if (approvalDenied) return Object.freeze({ status: 'denied', reason: approvalDenied });\n\n    try {\n      const execute = () => runWithCommMessage(\n        options.message,\n        () => this.#runtime.execute(tool, { ...input }, { toolCallId: toolUseId }),\n        { ownerApprovals: options.host.ownerApprovals },\n      );\n      const outcome = options.deferredController\n        ? await runWithDeferredTurnController(options.deferredController, execute)\n        : await execute();\n      if (outcome.denied) {\n        return Object.freeze({ status: 'denied', reason: String(outcome.output) });\n      }\n      return Object.freeze({\n        status: 'completed',\n        output: outcome.output,\n        durationMs: outcome.durationMs,\n      });\n    } catch (error) {\n      if (options.signal.aborted) {\n        return Object.freeze({\n          status: 'cancelled',\n          reason: options.signal.reason instanceof Error\n            ? options.signal.reason.message\n            : String(options.signal.reason ?? 'Tool execution cancelled'),\n        });\n      }\n      return Object.freeze({\n        status: 'failed',\n        error: error instanceof Error ? error.message : String(error),\n        retryable: false,\n      });\n    }\n  }\n}\n"]}

package/lib/tool/tool-model-output.d.ts

@@ -1,3 +1,2 @@
 import type { AgentTool } from '@zhin.js/ai';
 export declare function applyToolToModelOutput(tool: Pick<AgentTool, 'toModelOutput'>, raw: unknown, args: Record<string, unknown>): Promise<string>;
-//# sourceMappingURL=tool-model-output.d.ts.map

package/lib/tool/tool-model-output.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-model-output.js","sourceRoot":"","sources":["../../src/tool/tool-model-output.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAsC,EACtC,GAAY,EACZ,IAA6B;IAE7B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QACxB,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"tool-model-output.js","sourceRoot":"","sources":["../../src/tool/tool-model-output.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAsC,EACtC,GAAY,EACZ,IAA6B;IAE7B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QACxB,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC","sourcesContent":["import type { AgentTool } from '@zhin.js/ai';\n\nexport async function applyToolToModelOutput(\n  tool: Pick<AgentTool, 'toModelOutput'>,\n  raw: unknown,\n  args: Record<string, unknown>,\n): Promise<string> {\n  if (!tool.toModelOutput) {\n    return typeof raw === 'string' ? raw : JSON.stringify(raw ?? null);\n  }\n  return tool.toModelOutput({ result: raw, args });\n}\n"]}

package/lib/tool/tool-runtime.d.ts

@@ -50,4 +50,3 @@ export declare class ToolRuntime {
     checkPolicy(input: ToolPolicyInput): ToolPolicyResult;
     execute(tool: AgentTool, args: Record<string, unknown>, call: ToolCallContext): Promise<ToolExecutionOutcome>;
 }
-//# sourceMappingURL=tool-runtime.d.ts.map

package/lib/tool/tool-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-runtime.js","sourceRoot":"","sources":["../../src/tool/tool-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-runtime.js","sourceRoot":"","sources":["../../src/tool/tool-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ToolRuntime — 统一工具执行网关。\n *\n * 所有工具类型（builtin、Host、MCP、Skill、Agent）都必须通过 ToolRuntime 执行：\n * 1. Generation 验证 — 工具的 generation 戳是否仍有效\n * 2. 安全策略 — runToolPolicies() 统一执行（builtin 不再自行调用）\n * 3. 取消感知 — 对齐 turn AbortSignal\n * 4. Journal 事件 — 发射 tool_call / tool_result\n * 5. 审计 — policyAudit 链路记录\n *\n * ToolRuntime 按 turn 实例化，绑定 turn 级上下文。\n */\nimport type { AgentTool } from '@zhin.js/ai';\nimport type { Message } from '@zhin.js/core';\nimport type { ZhinAgentConfig } from '../config/index.js';\nimport {\n  runToolPolicies,\n  toolPolicyResultToMessage,\n  type ToolPolicyInput,\n  type ToolPolicyResult,\n  type ToolPolicyLayerRecord,\n} from '../security/policy-facade.js';\nimport type { ToolCallEvent, ToolResultEvent } from '../event/turn-event.js';\n\nexport interface ToolRuntimeJournalPort {\n  append(event: ToolCallEvent | ToolResultEvent): void | Promise<void>;\n}\n\n// ── 类型定义 ───────────────────────────────────────────────────────\n\nexport interface ToolRuntimeTurnContext {\n  readonly generation: number;\n  readonly signal: AbortSignal;\n  readonly sessionId: string;\n  readonly commMessage?: Message;\n  readonly journal?: ToolRuntimeJournalPort;\n  readonly config?: Required<ZhinAgentConfig>;\n  readonly policyInputResolver?: ToolPolicyInputResolver;\n  readonly isGenerationValid?: (gen: number) => boolean;\n}\n\nexport interface ToolCallContext {\n  readonly toolCallId: string;\n}\n\nexport interface ToolExecutionOutcome {\n  readonly output: unknown;\n  readonly durationMs: number;\n  readonly denied?: string;\n  readonly policyAudit: readonly ToolPolicyLayerRecord[];\n}\n\n/**\n * 工具策略输入提取器 — 从工具名和参数派生 ToolPolicyInput。\n * builtin 工具注册自己的提取器；非 builtin 使用默认提取器（仅 toolName）。\n */\nexport type ToolPolicyInputExtractor = (\n  toolName: string,\n  args: Record<string, unknown>,\n  commMessage?: Message,\n) => ToolPolicyInput;\nexport type ToolPolicyInputResolver = ToolPolicyInputExtractor;\n\nfunction defaultExtractor(toolName: string, _args: Record<string, unknown>, commMessage?: Message): ToolPolicyInput {\n  return { toolName, commMessage };\n}\n\n// ── ToolRuntime ─────────────────────────────────────────────────────\n\nexport class ToolRuntime {\n  readonly #context: ToolRuntimeTurnContext;\n\n  constructor(context: ToolRuntimeTurnContext) {\n    this.#context = context;\n  }\n\n  get generation(): number {\n    return this.#context.generation;\n  }\n\n  checkPolicy(input: ToolPolicyInput): ToolPolicyResult {\n    return runToolPolicies(input);\n  }\n\n  async execute(\n    tool: AgentTool,\n    args: Record<string, unknown>,\n    call: ToolCallContext,\n  ): Promise<ToolExecutionOutcome> {\n    const ctx = this.#context;\n    const t0 = performance.now();\n    const toolName = tool.name;\n\n    // 1. Generation 验证 — context-level and tool-level\n    if (ctx.isGenerationValid && !ctx.isGenerationValid(ctx.generation)) {\n      return {\n        output: `Error: tool「${toolName}」rejected — generation ${ctx.generation} is no longer valid`,\n        durationMs: performance.now() - t0,\n        denied: 'generation_invalid',\n        policyAudit: [],\n      };\n    }\n    if (tool.generation !== undefined && tool.generation !== ctx.generation) {\n      return {\n        output: `Error: tool「${toolName}」rejected — tool generation ${tool.generation} does not match turn generation ${ctx.generation}`,\n        durationMs: performance.now() - t0,\n        denied: 'generation_mismatch',\n        policyAudit: [],\n      };\n    }\n\n    // 2. 取消检查\n    if (ctx.signal.aborted) {\n      throw ctx.signal.reason instanceof Error\n        ? ctx.signal.reason\n        : new Error('Tool execution cancelled');\n    }\n\n    // 3. 安全策略\n    const extractor = ctx.policyInputResolver ?? defaultExtractor;\n    const policyInput = extractor(toolName, args, ctx.commMessage);\n    if (ctx.config) policyInput.config = ctx.config;\n    const policyResult = runToolPolicies(policyInput);\n    const policyAudit = policyResult.decisions;\n    const denied = toolPolicyResultToMessage(policyResult, toolName);\n    if (denied) {\n      await emitToolEvents(ctx, toolName, args, call.toolCallId, denied, performance.now() - t0);\n      return { output: denied, durationMs: performance.now() - t0, denied, policyAudit };\n    }\n\n    // 4. Journal: tool_call\n    await emitToolCall(ctx, toolName, args, call.toolCallId);\n\n    // 5. 执行（取消感知）\n    let output: unknown;\n    try {\n      output = await Promise.resolve().then(() =>\n        tool.execute(args, ctx.commMessage, {\n          signal: ctx.signal,\n          sessionId: ctx.sessionId,\n          toolCallId: call.toolCallId,\n          toolName,\n        }),\n      );\n    } catch (err) {\n      if (ctx.signal.aborted) {\n        throw ctx.signal.reason instanceof Error\n          ? ctx.signal.reason\n          : new Error('Tool execution cancelled');\n      }\n      throw err;\n    }\n\n    // 6. 取消后检查\n    if (ctx.signal.aborted) {\n      throw ctx.signal.reason instanceof Error\n        ? ctx.signal.reason\n        : new Error('Tool execution cancelled');\n    }\n\n    const durationMs = performance.now() - t0;\n\n    // 7. Journal: tool_result\n    await emitToolResult(ctx, toolName, output, call.toolCallId, durationMs);\n\n    return { output, durationMs, policyAudit };\n  }\n}\n\n// ── Journal 事件辅助 ─────────────────────────────────────────────────\n\nasync function emitToolCall(\n  ctx: ToolRuntimeTurnContext,\n  toolName: string,\n  args: Record<string, unknown>,\n  toolUseId: string,\n): Promise<void> {\n  await ctx.journal?.append({ type: 'tool_call', toolName, args, toolUseId });\n}\n\nasync function emitToolResult(\n  ctx: ToolRuntimeTurnContext,\n  toolName: string,\n  output: unknown,\n  toolUseId: string,\n  durationMs: number,\n): Promise<void> {\n  await ctx.journal?.append({ type: 'tool_result', toolName, output, toolUseId, durationMs });\n}\n\nasync function emitToolEvents(\n  ctx: ToolRuntimeTurnContext,\n  toolName: string,\n  args: Record<string, unknown>,\n  toolUseId: string,\n  output: unknown,\n  durationMs: number,\n): Promise<void> {\n  await emitToolCall(ctx, toolName, args, toolUseId);\n  await emitToolResult(ctx, toolName, output, toolUseId, durationMs);\n}\n"]}

package/lib/tool/tool-system.d.ts

@@ -37,4 +37,3 @@ export declare function stampToolGeneration<T extends {
 }>(tools: T[], generation: number): T[];
 /** 无 per-turn 可变 state；并发 collectForTurn 安全。 */
 export declare const defaultToolSystem: ToolSystem;
-//# sourceMappingURL=tool-system.d.ts.map