@x-otto/interchange 0.1.0-alpha.4 → 0.1.0-alpha.6

package/dist/index.d.ts

@@ -1,217 +1,8 @@
-//#region src/message.d.ts
-/** Message: AgentMessage/UserMessage/SystemMessage interchange types. */
-type Timestamp = number;
-type KnownApi = 'openai-completions' | 'openai-responses' | 'azure-openai-responses' | 'openai-codex-responses' | 'anthropic-messages' | 'bedrock-converse-stream' | 'google-generative-ai' | 'google-gemini-cli' | 'google-vertex';
-type Api = KnownApi | (string & {});
-type KnownProvider = 'anthropic' | 'openai' | 'google' | 'amazon-bedrock' | 'github-copilot' | 'xai' | 'groq' | 'openrouter' | 'deepseek' | 'ollama' | 'moonshot' | 'custom';
-type Provider = KnownProvider | (string & {});
-type StopReason = 'end_turn' | 'max_tokens' | 'tool_use' | 'stop_sequence' | 'refusal';
-interface Usage {
-  inputTokens: number;
-  outputTokens: number;
-  cacheReadTokens: number;
-  cacheWriteTokens: number;
-}
-/**
- * 结构化的 zod 兼容垫片——协议层不直接依赖 zod，靠结构类型让 provider/工具定义喂入真 zod schema。
- */
-interface ZodType<T = unknown> {
-  parse(data: unknown): T;
-  safeParse(data: unknown): {
-    success: boolean;
-    data?: T;
-    error?: unknown;
-  };
-  toJSONSchema?: () => unknown;
-}
-interface TextContent {
-  type: 'text';
-  text: string;
-  signature?: string;
-}
-interface ImageContent {
-  type: 'image';
-  mime: string;
-  source: string;
-}
-interface ThinkingContent {
-  type: 'thinking';
-  text: string;
-  signature?: string;
-}
-interface ToolCall {
-  type: 'tool_call';
-  id: string;
-  name: string;
-  arguments: Record<string, unknown>;
-  /**
-   * 流式参数 JSON 解析失败标记（RFC-142 D4）——`stopReason: max_tokens` 截断半截
-   * JSON 时 `parseToolArguments` 置位，runtime 责任链据此把该调用转为明确错误
-   * tool_result 而非带空参数进入 zod 校验（与污染类错误分离错误通道）。
-   *
-   * **进程内标记，不进 wire**：各 provider 序列化发给模型时均为显式字段拾取
-   * （`{type, id, name, input: arguments}`，无 spread），本字段天然剥除——有测试钉住
-   * （RFC-142 重要事项规则4）。
-   */
-  argumentsParseFailed?: boolean;
-}
-/**
- * A2UI content block（RFC-105 D6/M105-5b）：agent 生成的声明式 UI payload。
- * 对齐 a2ui-project/a2ui（v0.9）的核心哲学——扁平组件列表 + ID 引用 + 受信组件 catalog、
- * 纯数据非代码、未知组件类型文本降级。
- *
- * 组件类型（TUI 终端安全子集，首阶段只读 display）：
- * - Text：纯文本（text 字段）。
- * - Card：带标题容器（title + children ID 引用）。
- * - List：条目列表（items ID 引用 + ordered 标志）。
- * - Progress：ASCII 进度条（value 0-100，label 可选）。
- * - Chip：内联彩色标签（text + color）。
- * - Button：交互按钮（RFC-105 D6 F5/M105-5c，数字键触发 a2ui action；只读 display 通过
- *   renderA2uiBlock 提取为 A2uiButtonInfo 元数据）。
- * - Form：交互式表单（RFC-211 M1：字段定义 + TUI 弹窗填写 + web-ui 原生表单）。
- *   字段类型 text/select/toggle，payload 原样回流，不可执行代码。
- * 未知 type → 文本摘要表示（不崩，fail-soft，R7）。
- */
-interface A2uiComponent {
-  id: string;
-  type: 'Text' | 'Card' | 'List' | 'Progress' | 'Chip' | 'Button' | 'Form' | (string & {});
-  text?: string;
-  title?: string;
-  children?: string[];
-  items?: string[];
-  ordered?: boolean;
-  value?: number;
-  max?: number;
-  label?: string;
-  color?: 'accent' | 'green' | 'amber' | 'red' | 'gray';
-  action?: string;
-  shortcut?: string;
-  /** 表单标题（弹窗标题 + 对话流摘要标题）。 */
-  formTitle?: string;
-  /** 表单字段定义。 */
-  fields?: A2uiFormField[];
-}
-/** 单个表单字段（`A2uiComponent.type === 'Form'` 时使用）。 */
-interface A2uiFormField {
-  /** 字段 id（Form 内唯一，submit payload 的 key）。 */
-  id: string;
-  /** 字段类型。 */
-  type: 'text' | 'select' | 'toggle';
-  /** 显示标签。 */
-  label: string;
-  /** 默认值（text=字符串, select=option id, toggle=boolean）。 */
-  defaultValue?: string | boolean;
-  /** 占位符（text 类型）。 */
-  placeholder?: string;
-  /** 选项列表（select 类型必填）。 */
-  options?: Array<{
-    id: string;
-    label: string;
-  }>;
-  /** 是否必填（渲染提示，不做前端校验——非目标）。 */
-  required?: boolean;
-}
-interface A2uiContent {
-  type: 'a2ui';
-  /** A2UI 协议版本（v0.9 snapshot），供未来版本迁移用。 */
-  version: string;
-  /** 扁平组件列表，ID 引用构建组件树，增量子集可追加/替换。 */
-  components: A2uiComponent[];
-}
-type ContentPart = TextContent | ImageContent | ThinkingContent | ToolCall | A2uiContent;
-interface UserMessage {
-  role: 'user';
-  content: string | ContentPart[];
-  timestamp: Timestamp;
-  uuid?: string;
-  /**
-   * RFC-050 REV-1：引擎注入的内部消息（如预算收尾 steering、截断续写提示），模型需要看到、
-   * 但**不应渲染给用户**（否则 resume 时显示成用户从未输入的发言）。provider 序列化忽略此字段。
-   */
-  internal?: boolean;
-}
-interface AssistantMessage {
-  role: 'assistant';
-  /**
-   * 消息内容。A2uiContent 是前向兼容新增（RFC-155 M2 结案后的协议层收口）：
-   * provider 序列化层仅消费 text/tool_call/thinking，a2ui 块被静默跳过不出进 LLM 请求体；
-   * 渲染层（message-lines.ts）经 `renderA2uiBlock` 渲染。
-   */
-  content: (TextContent | ThinkingContent | ToolCall | A2uiContent)[];
-  api: Api;
-  provider: Provider;
-  model: string;
-  usage: Usage;
-  stopReason: StopReason;
-  uuid?: string;
-}
-interface ToolResultMessage<T extends unknown = unknown> {
-  role: 'tool_result';
-  toolCallId: string;
-  toolName: string;
-  /**
-   * 工具结果内容。A2uiContent 是前向兼容新增（RFC-155 M2 结案后的协议层收口）：
-   * provider 序列化仅消费 text，a2ui 块被静默跳过；渲染层（message-lines.ts）经
-   * `renderA2uiBlock` 渲染为终端卡片。
-   */
-  content: (TextContent | ImageContent | A2uiContent)[];
-  details: T;
-  isError: boolean;
-  timestamp: Timestamp;
-  uuid?: string;
-  /** RFC-050 REV-1：引擎合成的内部 tool_result（如预算耗尽未执行的占位），不渲染给用户。 */
-  internal?: boolean;
-}
-/**
- * RFC-144 M1：mid-conversation system 通知消息——**真正进 provider 请求**的协议消息类型
- * （区别于 `@x-otto/hook-contracts` 的 `SystemAgentMessage`，后者是 hooks/UI 域、
- * convertToLLM 类型边界显式过滤、绝不进 provider 请求）。
- *
- * 用途：lifecycleAsync 工具（RFC-144）真正完成时，追加一条独立消息告知 LLM"运营方观察到
- * 的状态变化"（Anthropic mid-conversation system message 官方场景之一），不修改/替换任何
- * 历史消息（纯追加语义），LLM 在下一轮推理中作为权威事实处理。
- *
- * provider 序列化：
- * - Anthropic（原生支持，Claude Opus 4.8+）→ `{role: 'system', content}` 追加进 messages 数组，
- *   放置规则见 RFC-144 重要事项规则 5（必须紧跟携带 tool_result 的 user turn 之后）。
- * - 不支持该特性的模型/provider（如 OpenAI，或 Anthropic 旧模型）→ 降级为等价的
- *   `role: 'user'` 消息 + 显式文本前缀（牺牲"运营方权威"语义，保留基本可用性），
- *   降级逻辑归属 provider adapter 层（本类型定义不关心降级细节）。
- *
- * 不可变性（RFC-144 禁区）：一旦追加，绝不编辑或删除已发送的 system 通知——结果更新一律
- * 追加新消息，不改写旧消息（Anthropic 官方限制：编辑会使该点之后的 prompt cache 失效）。
- */
-interface SystemNotificationMessage {
-  role: 'system_notification';
-  /** 通知正文（如 "[Tool completion] pnpm build finished: exit 0"）。 */
-  content: string;
-  /**
-   * 该通知对应的工具执行是否失败——显式字段，供消费方（渲染层/审计）直接读取，不必解析
-   * `content` 文案判断状态（RFC-144 M2：文案格式可能演进，靠字符串匹配脆弱且易误判）。
-   */
-  isError?: boolean;
-  /** 关联的 lifecycleAsync 工具调用 id，供消费方（渲染层/审计）溯源。 */
-  relatedToolCallId?: string;
-  timestamp: Timestamp;
-  uuid?: string;
-}
-type Message = UserMessage | AssistantMessage | ToolResultMessage | SystemNotificationMessage;
-/**
- * 历史压缩摘要消息的标记前缀——单一真相源（跨包协议常量）。
- * 生产者 @x-otto/memory 注入摘要消息时用、压缩去重(isSummaryMessage)时识别；消费者
- * @x-otto/agent 的 ContextPipeline 从会话树恢复摘要时用同一前缀重建摘要消息。放在协议叶子，
- * 避免双份字面量漂移导致 isSummaryMessage 失配。
- */
-declare const CONVERSATION_SUMMARY_PREFIX = "[Conversation Summary]";
-/**
- * 从 assistant 消息的内容块中提取全部 tool_call 项（终局架构 review 2026-07-10 P0-3：
- * 从 @x-otto/ai 物理迁移——此前是 @x-otto/ai 唯一自己实现（非 re-export）的两个函数，只依赖
- * AssistantMessage/ToolCall，真源本就该在协议叶子而非模型注册中枢）。
- */
-declare function getToolCallsByAssistantMessage(message: AssistantMessage): ToolCall[];
-/** 该 assistant 消息是否含至少一个 tool_call。 */
-declare function hasToolCalls(message: AssistantMessage): boolean;
-//#endregion
+import { ContextFragment, ContextFragmentId, boundFragment, contextFragmentBytes } from "./context-fragment.js";
+import { AnthropicImageMime, CommonImageMime, NormalizedImage, normalizeImageData, toAnthropicImageMime } from "./image.js";
+import { A2uiComponent, A2uiContent, Api, AssistantMessage, CONVERSATION_SUMMARY_PREFIX, ContentPart, ImageContent, KnownApi, KnownProvider, Message, Provider, StopReason, SystemNotificationMessage, TextContent, ThinkingContent, ToolCall, ToolResultMessage, Usage, UserMessage, ZodType, getToolCallsByAssistantMessage, hasToolCalls } from "./message.js";
+import { DismissedSigil, PluginInputRegistry, SigilEntry, SigilKind, SigilPrefix, SigilProvider, SigilResolveContext, SigilResolver, SigilSource, SigilTrigger, SigilTriggerDecision, TextChangeSource, adjustDismissedSigil, applySigilCompletion, applySigilReplacement, evaluateSigilTrigger, extractSigilPrefix, isSigilDismissed, sigilOf } from "./input.js";
+
 //#region src/stream.d.ts
 /**
  * 供应商 usage 快照（状态栏「周/小时额度」展示，RFC 无编号临时功能——状态栏 provider usage）。
@@ -465,45 +256,137 @@ interface ModelCapabilityFacts {
 /** 收集某模型的能力事实快照（纯函数，无 I/O）。 */
 declare function collectModelCapabilityFacts(model: Pick<Model, 'input'>): ModelCapabilityFacts;
 //#endregion
-//#region src/context-fragment.d.ts
+//#region src/prompt-sections.d.ts
 /**
- * context-fragment.ts —— 有界上下文片段类型层（RFC-374 M3）。
+ * prompt-sections.ts —— system-prompt 注入 section 的**唯一有序声明**（RFC-429 从
+ * `@x-otto/runtime` 下沉至 interchange 叶包）。
  *
- * 借鉴 DeepSeek-TUI `fragments`（crates/core/src/fragments.rs:1-40）：每一类注入
- * system prompt 的上下文片段都有 typed id + 字节硬顶 + 截断语义，杜绝各注入点
- * 局部常量的漂移。otto 侧的排序权威在 `@x-otto/runtime` 的 SYSTEM_PROMPT_SECTIONS
- * （priority + stable/volatile lane + 本类型的 budgetBytes），本文件只提供
- * 「片段形状 + 截断原语」的纯类型/纯函数叶。
+ * 下沉动机（RFC-429）：本表的姊妹类型 `ContextFragmentId`（`context-fragment.ts`）已在
+ * interchange，但值层（`SYSTEM_PROMPT_SECTIONS`）此前留在 runtime，导致 tui 等 UI 应用层
+ * 为读 section 元数据不得不**值 import `@x-otto/runtime`**（而 runtime 值依赖 agent/ai/hooks
+ * 全家桶，且不在 tui 的 package.json 依赖里，独立发布即 MODULE_NOT_FOUND）。下沉后 id/section/
+ * 预算三者同住 interchange 叶包，tui/coding hooks 均从叶包取，消除跨层值依赖。
  *
- * 截断语义（安全红线，与 RFC-142 互补）：截断产物是**纯文本**（截断点 + 简短后缀），
- * 绝不发明结构化 JSON 元数据键（模型会误学模仿引发上下文自我污染，见 docs/
- * CODE-STYLE.md §6b）。片段内容被截断只损失尾部信息，不改变已注入部分的可读性。
+ * 治病灶（原 RFC-020 Phase 3 M54 P3-04）——此前各 section 的 priority 数字散在 coding hooks
+ * 与 runtime context-sources 两包里，"system prompt 各段什么顺序"得捞齐多处数字才能拼出。
+ * 现收敛为此处一张表：
+ *   - 数组/字段顺序即 priority 升序 = 实际 `system.prompt.transform` hook 的执行/拼接顺序；
+ *   - `lane` 标明该段落 **stable 前缀**（systemPrompt，进 prompt cache）还是 **volatile 尾段**
+ *     （systemTail，落在 cache 断点之后，逐轮可变不击穿缓存）；
+ *   - runtime context-sources（environment/memory-index/memory-delta）与 coding hooks
+ *     （tool-guidance/lesson/skill-catalog）均从此处取 priority —— 单一真相源，改序只此一处。
+ *
+ * 注：本表是**排序权威**（方案 H：section 仍由各自 hook 自注册，priority 数字降级为对本表的引用）；
+ * 不强行把 `SYSTEM_PROMPT_SECTIONS` 各 section 物理并入单一 registry（那超出外科尺度、非目标）。
+ * section 数量以该常量的字段数为准，不在本段注释里重复写死具体数字（history: 建表时 7 个，
+ * 后追加 docSyncReminder 成 8 个，又补 skillLoopGuidance 成 9 个——写死数字会重犯本次发现的漂移）。
  */
-/** system prompt 注入片段的类型化 id（与 SYSTEM_PROMPT_SECTIONS 的字段一一对应）。 */
-type ContextFragmentId = 'toolGuidance' | 'skillLoopGuidance' | 'environment' | 'memoryIndex' | 'skillCatalog' | 'lesson' | 'lessonRelevantHints' | 'memoryDelta' | 'todoReminder' | 'docSyncReminder';
-/** 有界上下文片段：id + 内容。预算声明在 SYSTEM_PROMPT_SECTIONS（runtime 包）。 */
-interface ContextFragment {
-  id: ContextFragmentId;
-  content: string;
+type SystemPromptLane = 'stable' | 'volatile';
+interface SystemPromptSectionSpec {
+  /** 对应 hook / ContextSource 的 name/id（与注册名一致，供 drift guard 比对）。 */
+  readonly name: string;
+  readonly priority: number;
+  readonly lane: SystemPromptLane;
+  /**
+   * RFC-374 M3：本 section 的注入字节硬顶（UTF-8）。注入点经
+   * `applySectionBudget` 统一裁剪——预算只此一处声明，各注入点不持局部常量。
+   * 取值原则：明显高于常态内容（防御失控注入而非改变正常行为），
+   * 需要收紧时只改本表。
+   */
+  readonly budgetBytes: number;
 }
-/** UTF-8 字节长度（预算口径——字节硬顶，与 DeepSeek-TUI MAX_FRAGMENT_BYTES 同语义）。 */
-declare function contextFragmentBytes(content: string): number;
+declare const SYSTEM_PROMPT_SECTIONS: {
+  readonly toolGuidance: {
+    readonly name: "tool-guidance-injection";
+    readonly priority: 20;
+    readonly lane: "stable";
+    readonly budgetBytes: 20000;
+  };
+  /**
+   * RFC-318 D7：三分流判别（缺工具 / 流程重复 / 其余）。紧跟 toolGuidance——它是对
+   * "现有工具够不够用"的元判断，语义上属工具指引的延伸；内容恒定故走 stable lane。
+   */
+  readonly skillLoopGuidance: {
+    readonly name: "skill-loop-guidance-injection";
+    readonly priority: 21;
+    readonly lane: "stable";
+    readonly budgetBytes: 2000;
+  };
+  readonly environment: {
+    readonly name: "runtime:environment";
+    readonly priority: 25;
+    readonly lane: "stable";
+    readonly budgetBytes: 8000;
+  };
+  readonly agentKnowledge: {
+    readonly name: "agent-knowledge-injection";
+    readonly priority: 35;
+    readonly lane: "stable";
+    readonly budgetBytes: 28000;
+  };
+  readonly skillCatalog: {
+    readonly name: "skill-catalog-injection";
+    readonly priority: 38;
+    readonly lane: "stable";
+    readonly budgetBytes: 12000;
+  }; /** RFC-318 R7 治理补全：lesson-relevant-hints 原为表外 hook，现纳入统一预算面（volatile 尾段）。 */
+  readonly lessonRelevantHints: {
+    readonly name: "lesson-relevant-hints";
+    readonly priority: 41;
+    readonly lane: "volatile";
+    readonly budgetBytes: 4000;
+  };
+  /**
+   * RFC-383 M2（§9 修订 6）：高频 skill 内化指令核心——引擎内部 hook
+   * `internalize-skill-injection` 的 volatile 尾段预算面。**必须注册**：不注册则
+   * applySectionBudget 原样放行、4KB 硬顶失效（决策器提炼不受控）。priority 42 排在
+   * lessonRelevantHints(41) 之后、memoryDelta(60) 之前。
+   */
+  readonly internalize: {
+    readonly name: "internalize-skill-injection";
+    readonly priority: 42;
+    readonly lane: "volatile";
+    readonly budgetBytes: 4000;
+  };
+  readonly memoryDelta: {
+    readonly name: "memory-delta-injection";
+    readonly priority: 60;
+    readonly lane: "volatile";
+    readonly budgetBytes: 8000;
+  };
+  readonly todoReminder: {
+    readonly name: "todo-reminder-injection";
+    readonly priority: 62;
+    readonly lane: "volatile";
+    readonly budgetBytes: 4000;
+  };
+  readonly docSyncReminder: {
+    readonly name: "doc-sync-reminder-injection";
+    readonly priority: 64;
+    readonly lane: "volatile";
+    readonly budgetBytes: 4000;
+  };
+};
+/** 按 priority 升序的 section 序列（= 实际组装顺序的显式视图）。 */
+declare const SYSTEM_PROMPT_SECTION_ORDER: readonly SystemPromptSectionSpec[];
 /**
- * 把片段内容裁剪到字节预算内。超预算时保留前缀（已注入部分完整可读）并追加纯文本
- * 截断后缀；未超预算原样返回。`budgetBytes <= 0` 时返回仅含后缀的片段（fail-closed
- * 而非静默放行）。返回新对象，不修改入参。
+ * RFC-374 M3：按 section name 应用注入预算。内容超预算时裁剪（boundFragment，
+ * 纯文本截断后缀，RFC-142 红线兼容）；name 不在表中时原样返回（插件自定义
+ * context source 不受本表预算约束——它不进表就不进预算面，是显式而非默认）。
  *
- * 实现：Buffer 按字节截断后回退到完整 UTF-8 字符边界（continuation byte 0b10xxxxxx
- * 不回切），避免多字节字符（CJK 等）被劈成乱码。
+ * 截断诊断（08-14 lesson 字节顶事故跟进）：超预算裁剪是静默丢信息——内容里的
+ * 截断后缀模型能看见但宿主日志看不见，预算配置漂移（如 pack 内容长大超过
+ * budgetBytes）只表现为「注入内容莫名缺尾」。此处 warn（每进程每 section 一次）
+ * 把截断升级为可诊断事件，触发即提示检查 budgetBytes 与内容常态体积是否匹配。
  */
-declare function boundFragment(fragment: ContextFragment, budgetBytes: number): ContextFragment;
+declare function applySectionBudget(name: string, content: string): string;
 //#endregion
 //#region src/tool.d.ts
 /**
  * 工具错误的类型化类别——在**产生处**定型，取代下游对错误文本的英文子串猜测
  * （agent work-loop 旧 categoriseToolError）。未设时下游回退启发式匹配（向后兼容未迁移的工具）。
  */
-type ToolErrorKind = 'validation' | 'permission' | 'not_found' | 'timeout' | 'network' | 'io' | 'runtime' | 'aborted' | 'unknown';
+type ToolErrorKind = 'validation' | 'permission' | 'not_found' | 'timeout' | 'network' | 'io' | 'runtime' | 'aborted' | 'sandbox-denied' | 'unknown';
 interface ToolResult {
   content: (TextContent | ImageContent)[];
   isError?: boolean;
@@ -546,14 +429,44 @@ interface ToolCallEvent {
 interface ToolDescriptionContext {
   projectRoot: string;
 }
+/**
+ * 工具的**协议核心**契约（RFC-399 M1）——只保留「模型可见的工具是什么」这一协议语义：
+ * 工具名、描述、参数 schema、执行函数。**不含任何引擎执行策略字段**（并发/暴露/
+ * 生命周期/路径守卫等），那些属 `ToolExecutionPolicy`。
+ *
+ * 工具定义方与消费方（agent 循环）实际使用的运行时对象形状是 `AgentToolDefinition`
+ * （= 本类型 & Partial<ToolExecutionPolicy>）：运行时字段仍在同一对象上，
+ * 拆分只发生在**类型职责层面**（协议 vs 执行策略），不改变运行时形状。
+ */
 interface AgentTool<Params = unknown> {
   name: string;
   description: string | ((ctx: ToolDescriptionContext) => string);
   parameters: ZodType<Params>;
+  execute: (ctx: ToolCallContext<Params>) => Promise<ToolResult>;
+}
+/**
+ * 工具的**引擎执行策略**（RFC-399 M1：从 `AgentTool` 剥离）——描述 agent 循环该如何
+ * 调度/暴露/守卫本工具，全部可选。由工具定义方声明、agent 执行路径按 toolName 查表消费
+ * （tool-executor / tool-turn-runner / turn-loop / progress-window / stall-detector）。
+ *
+ * 与协议核心 `AgentTool` 的边界：本类型的字段**不进模型可见的工具 schema**，只影响引擎
+ * 内部的执行决策。两者在运行时合并为同一对象（`AgentToolDefinition`），类型层面分离
+ * 以保持协议层 `AgentTool` 的纯净（RFC-399 D3）。
+ */
+interface ToolExecutionPolicy<Params = unknown> {
   /** 工具对模型的暴露策略，替换旧 visibility。缺省 'direct'。 */
   exposure?: 'direct' | 'deferred' | 'hidden';
   /** 标记为只读工具，可与其他只读工具并发执行 */
   readonly?: boolean;
+  /**
+   * RFC review D5：steering（用户新指令）到达时对**正在执行**的本工具的处置语义。
+   * - 'block'（缺省，= 改动前行为）：工具跑完，steering 只拦未执行工具；
+   * - 'cancel'：声明「可安全中止」——steering 到达即 abort 本工具（per-tool abort
+   *   signal，执行方快速终止、结果 errorKind='aborted'），用户指令立刻接管。
+   * 约束：取消语义只对「副作用可安全中止」的工具声明（如搜索/分析类）；写类工具
+   * （bash/edit）不得声明 cancel（其副作用不可回滚）。
+   */
+  interruptBehavior?: 'cancel' | 'block';
   /**
    * RFC-093：本工具结果的上下文预算（chars）。超预算时结果落盘、上下文留 preview+路径占位符。
    * 缺省用引擎全局 maxToolResultChars（100K）。声明更小值（如 30K）促使大输出工具更早落盘。
@@ -616,8 +529,27 @@ interface AgentTool<Params = unknown> {
    * 主代理在收到完成通知前不应读写可能冲突的路径。声明后追加到 placeholder 文本末尾。
    */
   lifecycleAsyncNote?: string;
-  execute: (ctx: ToolCallContext<Params>) => Promise<ToolResult>;
+  /**
+   * RFC-437：声明本工具的输出是**可再生的**——prune 可安全将其剪为占位符
+   * （`[output pruned — N tokens]`），模型需要时可重跑工具获得。缺省 undefined =
+   * 不声明 = 不可再生（fail-closed，与 prune 对未知工具默认保留一致）。
+   *
+   * 适用：无副作用的查询/检索类（read/grep/find/web_search 等）。**写类工具不得声明**
+   * （write/edit 的输出是用户意图落点，剪掉即丢信息）——作者判断纪律，同
+   * `interruptBehavior: 'cancel'` 的约束（副作用不可回滚的不得声明）。
+   *
+   * 消费方：`@x-otto/memory` prune 经装配注入的 `regenerableToolNames` 惰性 getter
+   * 收集全部已注册工具的声明（RFC-437 D2/D3）。此字段不进模型可见的工具 schema。
+   */
+  regenerableOutput?: boolean;
 }
+/**
+ * 工具定义方与 agent 消费方实际使用的**运行时对象形状**（RFC-399 M1）：协议核心
+ * `AgentTool` 与可选执行策略 `ToolExecutionPolicy` 的交叉。类型层面职责分离，运行时
+ * 所有字段合并在同一对象上——工具定义字面量与 agent 的 `toolByName.get(name)?.<字段>`
+ * 消费点因此无需任何改动。
+ */
+type AgentToolDefinition<Params = unknown> = AgentTool<Params> & Partial<ToolExecutionPolicy<Params>>;
 //#endregion
 //#region src/session-event.d.ts
 interface AskUserQuestion {
@@ -687,6 +619,7 @@ type AgentSessionEvent = {
   model?: string;
   thinkingLevel?: string;
   stopReason?: PromptStopReason;
+  errorMessage?: string;
 } /** RFC-094 D3：todo 闸门自动续跑的中间轮信号（一个用户 prompt 恰好一对 start/end，中间每次续跑发一次）。 */ | {
   type: 'prompt.continued';
   sessionId: string;
@@ -988,6 +921,15 @@ type AgentSessionEvent = {
   arguments: Record<string, unknown>;
   description: string; /** HITL 显示风险等级（权限层派生，仅显示提示；缺省下游回退 medium）。 */
   risk?: 'low' | 'medium' | 'high';
+  /**
+   * RFC-380 T4：LLM 语义审批层（opt-in）的自动裁决标记。仅宿主配置了 semanticReviewer
+   * 且命中升级审批（description 含 [sandbox-escalation]）时出现：
+   * - 'allow'：runtime 已自动放行（approvalGate 已 resolve true），宿主只需记命令 bypass、
+   *   不得再弹窗/再 resolve（PendingGate.resolve 对已 settle 幂等返回 false，安全）；
+   * - 'deny'：runtime 已自动拒绝（已 resolve false），宿主不得弹窗。
+   * 缺省（未配置 reviewer / abstain）不出现 → 宿主走既有弹窗流程。
+   */
+  semanticVerdict?: 'allow' | 'deny';
 } | {
   type: 'approval.resolved';
   sessionId: string;
@@ -1039,6 +981,63 @@ type AgentSessionEvent = {
 };
 type AgentSessionSubscriber = (event: AgentSessionEvent) => void;
 type AgentSessionEventMap = { [E in AgentSessionEvent as E['type']]: (event: E) => void };
+/**
+ * RFC-394 D4/R3：事件三域标记——每个事件归属一个域：
+ * - `durable`：可从日志重建、必须存活重载（prompt/turn/tool 生命周期、消息持久化、
+ *   会话生命周期、压缩、清除）。
+ * - `live`：活体运行时状态、不可重放（流式、状态变更、steer、运行暂停/恢复）。
+ * - `capability`：能力缝/交互请求（审批、ask user、plan approval、预算通知、
+ *   工具不匹配/图像降级/进度停滞/压缩反应通知）。
+ *
+ * 消费方按域订阅——durable 事件可重放/可落盘，live 事件不可重放，
+ * capability 事件是交互请求需宿主响应。新增事件必须在此映射中声明 domain（R3）。
+ */
+declare const EVENT_DOMAIN: {
+  readonly 'session.start': "durable";
+  readonly 'session.end': "durable";
+  readonly 'session.cleared': "durable";
+  readonly 'prompt.start': "durable";
+  readonly 'prompt.end': "durable";
+  readonly 'prompt.continued': "durable";
+  readonly 'turn.start': "durable";
+  readonly 'turn.end': "durable";
+  readonly 'tool.call.start': "durable";
+  readonly 'tool.call.end': "durable";
+  readonly 'messages.persist': "durable";
+  readonly 'compaction.start': "durable";
+  readonly 'compaction.end': "durable";
+  readonly 'memory.pruned': "durable";
+  readonly error: "durable";
+  readonly 'stream.event': "live";
+  readonly 'streaming.start': "live";
+  readonly 'streaming.end': "live";
+  readonly 'agent.status': "live";
+  readonly 'steer.consumed': "live";
+  readonly 'run.paused': "live";
+  readonly 'run.resumed': "live";
+  readonly 'run.pause_requested': "live";
+  readonly 'run.pause_cancelled': "live";
+  readonly 'approval.required': "capability";
+  readonly 'approval.resolved': "capability";
+  readonly 'ask.user.required': "capability";
+  readonly 'ask.user.resolved': "capability";
+  readonly 'plan.approval.required': "capability";
+  readonly 'plan.approval.resolved': "capability";
+  readonly 'budget.notice': "capability";
+  readonly 'prompt.budget.notice': "capability";
+  readonly 'tool.call.mismatch.notice': "capability";
+  readonly 'image.degradation.notice': "capability";
+  readonly 'progress.stall.notice': "capability";
+  readonly 'compaction.reactive.notice': "capability";
+  readonly 'session.cost-budget-exceeded': "capability";
+  readonly 'session.crash-gap-detected': "capability";
+  readonly 'session.history-capped': "capability";
+  readonly 'session.write-lease-denied': "capability";
+  readonly 'session.write-lease-restored': "capability";
+};
+type EventDomain = 'durable' | 'live' | 'capability';
+/** 查询某事件类型的域归属。未登记的事件返回 undefined。 */
+declare function getEventDomain(eventType: string): EventDomain | undefined;
 //#endregion
 //#region src/engine-command.d.ts
 /**
@@ -1107,6 +1106,36 @@ type EngineCommand = {
   count: number;
 };
 //#endregion
+//#region src/file-command.d.ts
+/**
+ * file-command.ts — 文件式 slash 命令协议类型（RFC-421 D1）.
+ *
+ * `FileCommand` 是"文件式命令"的跨包协议类型：`.claude/commands`、`.otto/commands`
+ * 与插件 `commands/` 目录发现的 markdown 命令，经解析后统一为本类型。
+ *
+ * 归属本包（`@x-otto/interchange`）：原定义在 `@x-otto/claude-compat`（兼容层包），
+ * 但该类型是宿主核心公共 API 的地基（coding/types.ts、app.ts、ports.ts 等多处 import），
+ * 宿主核心类型不应以可选兼容层为真源。RFC-421 D1 将其上移到零依赖协议类型域，
+ * claude-compat 与 coding 都从本包取，消除依赖倒置。
+ *
+ * 语义不变：字段与迁移前逐字段一致（RFC-421 规则 1：只动归属不动语义）。
+ */
+interface FileCommand {
+  /** 命名空间名（子目录 `/` → `:`），如 `frontend:component` 或 `review`。 */
+  name: string;
+  description?: string;
+  argumentHint?: string;
+  /** §3.0 归一后的工具名（仅提示/将来收敛用，D2 不强制收敛回合工具集——见 RFC §10 C8）。 */
+  allowedTools?: string[];
+  model?: string;
+  body: string;
+  source: 'claude' | 'otto' | 'plugin';
+  scope: 'project' | 'repository' | 'user';
+  /** 贡献来源插件 id（`source==='plugin'` 时存在）= unregister key（RFC-044 R6）。 */
+  pluginId?: string;
+  filePath: string;
+}
+//#endregion
 //#region src/todo.d.ts
 /**
  * Todo 状态与条目 — 单一真源，供 write_todos 等工具跨层消费。
@@ -1163,43 +1192,6 @@ interface ProcessTracker {
   };
 }
 //#endregion
-//#region src/image.d.ts
-/** Image: base64/mime/url model for image payloads (unified image type). */
-interface NormalizedImage {
-  /** 裸 base64（已去空白），不含 `data:...;base64,` 前缀。 */
-  base64: string;
-  /** 尽力得到的 MIME（小写），如 `image/png`；无法判定时为 ''。 */
-  mediaType: string;
-  /**
-   * base64 是否可解码：非空 + 合法 charset + 长度 %4≠1 + 不是字面量 "undefined"。
-   * 为 false 时调用方应**降级为文本占位**而非把坏数据发往 API（否则整请求 400）。
-   */
-  valid: boolean;
-}
-/**
- * 把图片来源归一为 { 裸 base64, mediaType, valid }。
- * 接受两种形态：完整 data URI 或裸 base64。
- * mediaType 优先取 data URI 内声明的 mime，其次回退到显式传入的 mime。
- */
-declare function normalizeImageData(source: string, mime?: string): NormalizedImage;
-/**
- * 终局架构 review 建议优化项：类型名从 AnthropicImageMime 改为 CommonImageMime——这 4 种
- * 格式（jpeg/png/gif/webp）是业界广泛支持的通用图片格式，非 Anthropic 独有（OpenAI 等
- * provider 同样接受这 4 种）。保留 `toAnthropicImageMime` 函数名不变——该名字准确描述了
- * 它的真实用途（"归一到 Anthropic API 要求的枚举值"，函数体内的兜底逻辑与 400 错误规避
- * 都是针对 Anthropic API 的具体行为），改类型名不改函数名两者互不矛盾：类型是通用值域，
- * 函数是该值域到 Anthropic 特定契约的映射。
- */
-type CommonImageMime = 'image/jpeg' | 'image/png' | 'image/gif' | 'image/webp';
-/** @deprecated 改名为 CommonImageMime（类型语义修正，非厂商专属）。保留别名过渡，下个大版本移除。 */
-type AnthropicImageMime = CommonImageMime;
-/**
- * 归一到 Anthropic 接受的 4 种图片 MIME 之一。
- * 未知 mediaType 时按 base64 魔数嗅探，仍无法判定回退 image/png。
- * **永不返回空**——避免 media_type 字段缺失被 Anthropic API 以 "Field required" 拒绝。
- */
-declare function toAnthropicImageMime(mediaType: string, base64: string): CommonImageMime;
-//#endregion
 //#region src/plugin-perf.d.ts
 /**
  * plugin-perf.ts — 插件性能采集器结果的共享契约（RFC-118 小修，review S10）。
@@ -1216,233 +1208,5 @@ interface PluginPerfMetricResult {
   error?: string;
 }
 //#endregion
-//#region src/input.d.ts
-/** Input: mentions, sigils, content providers — user input enrichment types. */
-/** sigil 子类型：`hashtag` 属 `#`，其余属 `@`。`resource` = 插件自定义资源（RFC-210 D2）；
- * `shortcut` = 用户在本仓库自定义的文本快捷方式（RFC-233）；`effort` = 推理投入档
- * （low/medium/high/xhigh/max，RFC-360 D3——不复用 `model`，两者在 `@` 面板需独立
- * 分类展示，复用会导致 effort 档位被误标"模型"分类）。 */
-type SigilKind = 'hashtag' | 'file' | 'person' | 'agent' | 'skill' | 'mcp' | 'plugin' | 'model' | 'resource' | 'shortcut' | 'effort';
-/** 触发前缀。 */
-type SigilPrefix = '#' | '@';
-/** 条目来源标识（unregisterBySource 据此批量注销，防僵尸条目）。 */
-type SigilSource = 'builtin' | 'plugin' | 'skill' | 'mcp' | (string & {});
-/**
- * 动态供给函数（pull 模型）：按 query 懒查候选，服务 @file 等大候选集——
- * 不全量 register()。可同步或异步（文件系统遍历走异步）。
- */
-type SigilProvider = (query: string, sigil: SigilPrefix) => SigilEntry[] | Promise<SigilEntry[]>;
-/** sigil 面板条目：label（展示）与 value（替换内容）严格分离（R2）。 */
-interface SigilEntry {
-  /** 面板中展示的名称（简短、人类可读）。绝不进入 prompt 文本。 */
-  label: string;
-  /** 选中后替换 #trigger/@trigger 的实质内容。绝不在面板中完整展示。 */
-  value: string;
-  /** 面板中展示的描述（可选，列表副标题）。 */
-  description?: string;
-  /** 条目类型（影响面板分组/着色，并决定属于 # 还是 @）。 */
-  kind: SigilKind;
-  /** 来源标识（builtin | plugin | skill | mcp | 自定义 pluginId）。 */
-  source?: SigilSource;
-  /**
-   * RFC-210 D2：resolve 引用。非空 = "提交时展开"型资源——展开管线（app.expandSigilChips）
-   * 用此 id 查 SigilResolverRegistry 拿 resolve 函数，把该条目的 chip 替换为其返回值。
-   * 空 = 透传型（chip 原样给 LLM）或纯文本型（value 即内容），行为与现状完全一致。
-   */
-  resolverId?: string;
-}
-/**
- * RFC-210 D2：@ 资源提交时展开函数（代码契约——不可序列化，归 coding 层
- * SigilResolverRegistry，与纯数据的 PluginInputRegistry 平行；D9 两类契约纪律）。
- */
-interface SigilResolver {
-  /** resolver id，命名空间 `<pluginId>:<name>`（内置无前缀）。 */
-  id: string;
-  /** 提交时展开：输入 chip 参数（`[@kind:param]` 的 param 段），返回发给 LLM 的内容。 */
-  resolve: (param: string, ctx: SigilResolveContext) => string | Promise<string>;
-  /** 超时（ms，缺省 10_000，对齐既有 CONTEXT_CHIPS 约束）。 */
-  timeoutMs?: number;
-  /**
-   * uiHostOnly（RFC-210 评审 B11）：true = 读取"UI 所在机器"的本地资源（非 workspaceDir
-   * 内容），只应在与用户同机的宿主进程（TUI/cli）执行；service expand 端点跳过执行。
-   * @clipboard = true（读桌面剪贴板）；@changes/@git = false（读 workspaceDir git 状态，
-   * service 为远程 workspace 服务时服务器上的状态正是用户要的内容）。
-   */
-  uiHostOnly?: boolean;
-}
-/** SigilResolver.resolve 的执行上下文。 */
-interface SigilResolveContext {
-  workspaceDir: string;
-  /** 输出上限（字符，缺省 20_000，超限截断——对齐既有 MAX_OUTPUT）。 */
-  maxOutput: number;
-}
-/**
- * 插件输入注册表（UI 无关，由 createApp() 创建单例，实现留 @x-otto/coding）。
- *
- * 静态 push 供给（register）+ 动态 pull 供给（registerProvider，服务 @file
- * 大候选集懒查，RFC §1.3.1 F-domain / RFC-044 M044-07）。
- */
-interface PluginInputRegistry {
-  /** 注册一批条目（last-write-wins，按 (label, kind) 复合键去重）。 */
-  register(entries: SigilEntry[]): void;
-  /**
-   * 注册某 sigil 的动态供给器（pull 模型，按 query 懒查，如 @file）。
-   * 返回注销函数。其结果在 searchAsync 中与静态条目合并。
-   */
-  registerProvider(sigil: SigilPrefix, provider: SigilProvider): () => void;
-  /**
-   * 按 query + sigil 过滤匹配条目。过滤在此完成（R4），UI 只渲染结果。
-   * 命中数达 maxResults 立即返回，不全量遍历（F-domain 性能）。
-   * 仅静态条目；动态 provider 结果见 searchAsync。
-   */
-  search(query: string, sigil?: SigilPrefix, maxResults?: number): SigilEntry[];
-  /**
-   * 异步搜索：静态条目（即时）+ 动态 provider 结果（await）合并去重。
-   * UI 应优先用此方法以纳入 @file 等懒查候选；无 provider 时等价 search。
-   */
-  searchAsync(query: string, sigil?: SigilPrefix, maxResults?: number): Promise<SigilEntry[]>;
-  /** 返回某 sigil（或全部）的全量条目（只读快照）。 */
-  getAll(sigil?: SigilPrefix): readonly SigilEntry[];
-  /** 按 label 查首个匹配条目。 */
-  findByLabel(label: string): SigilEntry | undefined;
-  /** 注销某 label 的所有条目，返回是否删除过。 */
-  unregister(label: string): boolean;
-  /** 注销某 source 的所有条目（插件 unload 必调，防僵尸——R5）。 */
-  unregisterBySource(source: string): void;
-}
-/** 根据 kind 推断其归属的 sigil 前缀。 */
-declare function sigilOf(kind: SigilKind): SigilPrefix;
-/** sigil 触发信息：检测到的 sigil 字符 + 查询串 + 锚点位置。 */
-interface SigilTrigger {
-  /** 触发的 sigil 字符。 */
-  sigil: SigilPrefix;
-  /** sigil 后的查询串（不含 sigil 字符本身）。 */
-  query: string;
-  /** sigil 字符在文本中的起始偏移（替换时从此处删到 cursorOffset）。 */
-  anchor: number;
-}
-/**
- * 从光标前文本提取 sigil 触发。无触发返回 null。
- * anchor 指向 sigil 字符位置（替换区间 = [anchor, cursorOffset)）。
- */
-declare function extractSigilPrefix(input: string, cursorOffset: number): SigilTrigger | null;
-/**
- * 设计问题 #5 / RFC-212 D1：判断当前触发是否落在「已被 Esc 驳回」的同一 sigil token 上。
- * 为真则不应弹回面板——用户 Esc 关掉后继续在同一 `@`/`#` 上输入，不再打扰。
- * 比较只看 sigil + anchor（token 身份）——anchor 由 `adjustDismissedSigil` 随编辑动态位移，
- * 不是原始触发时的绝对位置，故本函数无需再关心"位置是否漂移"。
- */
-declare function isSigilDismissed(trig: Pick<SigilTrigger, 'sigil' | 'anchor'>, dismissed: Pick<SigilTrigger, 'sigil' | 'anchor'> | null): boolean;
-/**
- * RFC-212 D1：token 身份绑定的驳回记录。`tokenLength` 锚定在驳回快照时刻
- * （= `cursorOffset - anchor`，即 1 + query.length），后续编辑不动态重算，
- * 语义见 `adjustDismissedSigil` 的四类区间判定。
- */
-interface DismissedSigil {
-  sigil: SigilPrefix;
-  anchor: number;
-  tokenLength: number;
-}
-/**
- * RFC-212 D1 状态机核心：给定旧驳回记录与本次文本编辑（oldText → newText），
- * 计算编辑后应生效的驳回记录（`null` = 清态回 IDLE，编辑摧毁了 token 或与其无关）。
- * 纯函数，不依赖 React state/ref，可独立单测。
- *
- * 判定依据编辑区间 `[start, end)`（old 坐标系）与 token 范围 `[anchor, anchor+tokenLength)`
- * 的相对关系，四类穷举（`anchor < tokenEnd` 恒成立，`start <= end` 恒成立）：
- *
- *  1. `end <= anchor`（编辑完全在 token 之前）→ 锚点位移：`anchor += delta`，tokenLength 不变。
- *  2. `start >= tokenEnd`（编辑完全在 token 之后，"离开"场景）→ anchor/tokenLength 不变；
- *     是否真的维持驳回态，由调用方比较新触发的 anchor 是否等于此处的 anchor 决定
- *     （`isSigilDismissed`）——本函数只负责"token 本身未被触碰"这一半的判定。
- *  3. `start > anchor && start < tokenEnd`（编辑落在 token 内部、不含 `@`/`#` 字符本身）
- *     → 维持驳回态，anchor/tokenLength 均不变（不因编辑扩大 tokenLength——用户打字越过
- *     快照边界即落入情形 2，交由新触发比较决定去留，而非线性扩张判定区间）。
- *  4. 其余（`start <= anchor` 且与 token 有重叠，即编辑波及了 sigil 字符本身）
- *     → 清态回 IDLE（token 身份已被破坏）。
- */
-declare function adjustDismissedSigil(dismissed: DismissedSigil | null, oldText: string, newText: string): DismissedSigil | null;
-/**
- * 用选中条目的 value 替换 [anchor, cursorOffset) 区间（即 `#query`/`@query`）。
- * 返回新文本与新光标偏移（落在替换内容末尾）。
- *
- * 注意：value 原样注入（含换行/markdown 不校验，R2）。
- * 调用方应走 PromptInput.update() 应用结果，以重算 detectMode（D7：# 替换后 mode 通常变 'send'）。
- */
-declare function applySigilCompletion(input: string, cursorOffset: number, anchor: number, entry: SigilEntry): {
-  text: string;
-  offset: number;
-};
-/**
- * RFC-212 D3：用选中条目的 value 替换一个**已存在 chip**的 `[chipStart, chipEnd)` 区间
- * ——与 `applySigilCompletion`（从 anchor 插入，输入是"用户刚打的 @query"）语义不同：
- * 这里输入是"光标停靠在一个已展开的 chip 上，用户按 Enter 重新选择替换它"，替换区间是
- * chip 的实际边界，不涉及 anchor/query 概念。返回新文本与新光标偏移（落在替换内容末尾）。
- *
- * 注意：与 `applySigilCompletion` 不同，本函数不追加尾随空格——chip 替换场景两侧通常
- * 已有边界（chip 本身的方括号，或前后文本），追加空格会破坏原有间距，交由调用方决定
- * 是否需要额外分隔符。
- */
-declare function applySigilReplacement(input: string, chipStart: number, chipEnd: number, entry: SigilEntry): {
-  text: string;
-  offset: number;
-};
-/**
- * RFC-215 D1：文本变更来源。每个修改输入框文本的路径必须声明自己是谁——
- * 取代旧 `detectSigil: boolean`（普查发现 16 类调用点中 10 类语义错误，布尔无法
- * 强迫调用方思考来源语义，见 RFC-215 §0.4）。
- *
- * sigil 触发准入的唯一判定：仅 `'typing'` 允许进入检测（`evaluateSigilTrigger`）。
- * 新增来源归类不确定时选 `'programmatic'`（最保守：不触发任何检测）。
- */
-type TextChangeSource = /** 用户逐字键入/删除（editKey 路径、IME 多字符 chunk）。 */'typing' /** 历史导航召回、搜索回填、/history 面板回填、外部编辑器写回、undo 回退、提交阻断跳转。 */ | 'programmatic' /** 粘贴插入（含短粘贴直插与大段折叠后插入）——RFC-215 D2：不触发 sigil 面板。 */ | 'paste'
-/**
- * ghost/typeahead/shell 补全接受、sigil 补全/删除/chip 替换回写。
- * 当前对 sigil 检测的行为等价 `'programmatic'`（都不触发），预留语义位——
- * 补全接受保留 typeahead 上下文语义、程序回填重置一切瞬态，未来分叉时不需改签名
- * （RFC-215 D1，评审 F2：勿因"有值无独立消费"误删）。
- */
-| 'completion';
-/** `evaluateSigilTrigger` 的判定结果（RFC-215 D3）。 */
-interface SigilTriggerDecision {
-  /**
-   * - `'open'`：产生新触发，调用方应设触发上下文并打开面板。
-   * - `'suppress'`：本次变更不产生新触发，也不主动关闭已开面板——调用方仅清触发上下文，
-   *   面板关闭交由既有失焦/Esc 机制（与旧 `!detectSigil` 分支行为一致）。
-   * - `'close'`：触发条件已消失（原 `@query` 被编辑破坏），调用方应清触发上下文并
-   *   通知宿主关闭面板（宿主未接线关闭回调时退化为 suppress 行为，向后兼容）。
-   */
-  action: 'open' | 'suppress' | 'close';
-  /** action='open' 时的触发信息。 */
-  trigger?: SigilTrigger;
-  /** 经 `adjustDismissedSigil` 位移后的驳回态（任何来源都执行位移；open 时已清为 null）。 */
-  dismissed: DismissedSigil | null;
-}
-/**
- * RFC-215 D3：sigil 触发准入状态机（纯函数）。与 `adjustDismissedSigil`（RFC-212 D1，
- * 驳回态维护）合并为完整的一台触发机器——本函数管"是否触发"，后者管"已驳回状态下
- * 是否重新触发"，调用顺序内聚在此，外部只消费 decision。
- *
- * 判定顺序（RFC-215 D3，六步）：
- *  ① 位移驳回态（任何来源都执行——粘贴/回填同样会移动被驳回 token 的位置，
- *     跳过位移会复发 RFC-212 缺陷 1；重要事项规则 3）；
- *  ② 非 `'typing'` 来源 → suppress（历史导航/粘贴/补全接受不触发面板——本 RFC 的 bug 修复本体）；
- *  ③ 文本非增长 → suppress（保留既有 `grew` 优化语义：删除/替换不产生新触发）；
- *  ④ 无 sigil 触发命中（或被 `sigilFilter` 过滤）→ close（原触发被编辑破坏，面板应关闭）；
- *  ⑤ 触发命中但落在已驳回 token 上 → suppress（Esc 驳回后继续输入不再打扰）；
- *  ⑥ 触发命中且未被驳回 → open + 清驳回态。
- *
- * `sigilFilter` 缺省 `(sigil) => sigil === '@'`——与 TUI 现状的 @-only 硬过滤一致
- * （`#` 走 memory 模式检测，不在本函数管辖；评审 F4-2）。
- */
-declare function evaluateSigilTrigger(input: {
-  source: TextChangeSource;
-  oldText: string;
-  newText: string;
-  cursorOffset: number;
-  dismissed: DismissedSigil | null;
-  sigilFilter?: (sigil: SigilPrefix) => boolean;
-}): SigilTriggerDecision;
-//#endregion
-export { type A2uiComponent, type A2uiContent, type AgentSessionEvent, type AgentSessionEventMap, type AgentSessionEventType, type AgentSessionSubscriber, type AgentTool, type AnthropicImageMime, type Api, type AskUserQuestion, type AssistantMessage, CONVERSATION_SUMMARY_PREFIX, type CapabilityFact, type ChildProcessConfig, type CommonImageMime, type ContentPart, type ContextFragment, type ContextFragmentId, type Cost, type DismissedSigil, type EngineCommand, type GrillAnswer, type GrillOption, type GrillQuestion, type GrillRequest, type ImageContent, type KnownApi, type KnownProvider, type Message, type Model, type ModelCapabilityFacts, type ModelSpec, type ModelStrength, type NormalizedImage, type PluginInputRegistry, type PluginPerfMetricResult, type ProcessTracker, type PromptStopReason, type Provider, type ProviderUsageSnapshot, type SigilEntry, type SigilKind, type SigilPrefix, type SigilProvider, type SigilResolveContext, type SigilResolver, type SigilSource, type SigilTrigger, type SigilTriggerDecision, type StopReason, type StreamEvent, type SystemNotificationMessage, type TextChangeSource, type TextContent, type ThinkingContent, type ThinkingLevel, type TodoItem, type TodoStatus, type ToolCall, type ToolCallContext, type ToolCallEvent, type ToolDescriptionContext, type ToolErrorKind, type ToolResult, type ToolResultMessage, type Usage, type UserMessage, type ZodType, adjustDismissedSigil, applySigilCompletion, applySigilReplacement, boundFragment, collectModelCapabilityFacts, contextFragmentBytes, evaluateSigilTrigger, extractSigilPrefix, extractToolResultText, getToolCallsByAssistantMessage, hasToolCalls, isSigilDismissed, modelImageCapability, modelSupportsImages, normalizeImageData, sigilOf, toAnthropicImageMime };
+export { type A2uiComponent, type A2uiContent, type AgentSessionEvent, type AgentSessionEventMap, type AgentSessionEventType, type AgentSessionSubscriber, type AgentTool, type AgentToolDefinition, type AnthropicImageMime, type Api, type AskUserQuestion, type AssistantMessage, CONVERSATION_SUMMARY_PREFIX, type CapabilityFact, type ChildProcessConfig, type CommonImageMime, type ContentPart, type ContextFragment, type ContextFragmentId, type Cost, type DismissedSigil, EVENT_DOMAIN, type EngineCommand, type EventDomain, type FileCommand, type GrillAnswer, type GrillOption, type GrillQuestion, type GrillRequest, type ImageContent, type KnownApi, type KnownProvider, type Message, type Model, type ModelCapabilityFacts, type ModelSpec, type ModelStrength, type NormalizedImage, type PluginInputRegistry, type PluginPerfMetricResult, type ProcessTracker, type PromptStopReason, type Provider, type ProviderUsageSnapshot, SYSTEM_PROMPT_SECTIONS, SYSTEM_PROMPT_SECTION_ORDER, type SigilEntry, type SigilKind, type SigilPrefix, type SigilProvider, type SigilResolveContext, type SigilResolver, type SigilSource, type SigilTrigger, type SigilTriggerDecision, type StopReason, type StreamEvent, type SystemNotificationMessage, type SystemPromptLane, type SystemPromptSectionSpec, type TextChangeSource, type TextContent, type ThinkingContent, type ThinkingLevel, type TodoItem, type TodoStatus, type ToolCall, type ToolCallContext, type ToolCallEvent, type ToolDescriptionContext, type ToolErrorKind, type ToolExecutionPolicy, type ToolResult, type ToolResultMessage, type Usage, type UserMessage, type ZodType, adjustDismissedSigil, applySectionBudget, applySigilCompletion, applySigilReplacement, boundFragment, collectModelCapabilityFacts, contextFragmentBytes, evaluateSigilTrigger, extractSigilPrefix, extractToolResultText, getEventDomain, getToolCallsByAssistantMessage, hasToolCalls, isSigilDismissed, modelImageCapability, modelSupportsImages, normalizeImageData, sigilOf, toAnthropicImageMime };
 //# sourceMappingURL=index.d.ts.map