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

package/README.md

@@ -98,6 +98,7 @@ const entry: SigilEntry = { label: 'File', value: '/path/to/file', kind: 'file',
 - `ChildProcessConfig` / `ProcessTracker` — child process management
 - `PluginPerfMetricResult` — plugin performance metric contract
 - `A2uiComponent` / `A2uiContent` — rich component types
+- `ContextFragment` / `ContextFragmentId` / `boundFragment` / `contextFragmentBytes` — bounded context fragment shapes + truncation primitives (RFC-374 M3)
 
 ## Dependencies
 

package/dist/index.d.ts

@@ -480,7 +480,7 @@ declare function collectModelCapabilityFacts(model: Pick<Model, 'input'>): Model
  * CODE-STYLE.md §6b）。片段内容被截断只损失尾部信息，不改变已注入部分的可读性。
  */
 /** system prompt 注入片段的类型化 id（与 SYSTEM_PROMPT_SECTIONS 的字段一一对应）。 */
-type ContextFragmentId = 'toolGuidance' | 'skillLoopGuidance' | 'environment' | 'memoryIndex' | 'skillCatalog' | 'lesson' | 'lessonRelevantHints' | 'memoryDelta' | 'todoReminder' | 'docSyncReminder';
+type ContextFragmentId = 'toolGuidance' | 'skillLoopGuidance' | 'environment' | 'memoryIndex' | 'skillCatalog' | 'lesson' | 'lessonRelevantHints' | 'memoryDelta' | 'todoReminder' | 'docSyncReminder' | 'internalize';
 /** 有界上下文片段：id + 内容。预算声明在 SYSTEM_PROMPT_SECTIONS（runtime 包）。 */
 interface ContextFragment {
   id: ContextFragmentId;
@@ -503,7 +503,7 @@ declare function boundFragment(fragment: ContextFragment, budgetBytes: number):
  * 工具错误的类型化类别——在**产生处**定型，取代下游对错误文本的英文子串猜测
  * （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;
@@ -554,6 +554,15 @@ interface AgentTool<Params = unknown> {
   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）促使大输出工具更早落盘。
@@ -687,6 +696,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 +998,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x-otto/interchange",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.5",
   "files": [
     "dist"
   ],