@x-otto/interchange 0.1.0-alpha.0 → 0.1.0-alpha.2

package/README.md

@@ -1,13 +1,13 @@
-# @otto/interchange
+# @x-otto/interchange
 
 > Provider-neutral protocol type single source of truth. Message, StreamEvent, Model, Tool, Session Event types — zero dependencies.
 
-`@otto/interchange` (formerly `@otto/protocol`, renamed/merged) is the zero-dependency pure type leaf package that defines the canonical protocol types shared across the entire monorepo: `Message`, `StreamEvent`, `Model`, `Usage`, `ToolCall`, `AgentSessionEvent`, `GrillQuestion`, sigil input types, and more. Every package that deals with LLM provider communication, session events, or user input contracts imports from here.
+`@x-otto/interchange` (formerly `@x-otto/protocol`, renamed/merged) is the zero-dependency pure type leaf package that defines the canonical protocol types shared across the entire monorepo: `Message`, `StreamEvent`, `Model`, `Usage`, `ToolCall`, `AgentSessionEvent`, `GrillQuestion`, sigil input types, and more. Every package that deals with LLM provider communication, session events, or user input contracts imports from here.
 
 ## Installation
 
 ```bash
-pnpm add @otto/interchange
+pnpm add @x-otto/interchange
 ```
 
 ## Usage
@@ -26,8 +26,8 @@ import type {
   NormalizedImage,
   SigilEntry,
   SigilKind,
-} from '@otto/interchange'
-import { hasToolCalls, normalizeImageData, sigilOf } from '@otto/interchange'
+} from '@x-otto/interchange'
+import { hasToolCalls, normalizeImageData, sigilOf } from '@x-otto/interchange'
 
 // Inspect a message for tool calls
 const msg: AssistantMessage = { role: 'assistant', content: [...] }
@@ -83,7 +83,7 @@ const entry: SigilEntry = { label: 'File', value: '/path/to/file', kind: 'file',
 ### Input Types (input.ts)
 - `SigilKind` / `SigilPrefix` — `'#'` and `'@'` trigger types
 - `SigilEntry` / `SigilSource` / `SigilProvider` — input enrichment entries
-- `SigilResolver` — resolve function for runtime chip expansion (RFC-210 D2)
+- `SigilResolver` — resolve function for runtime chip expansion
 - `SigilTrigger` / `DismissedSigil` — trigger detection state machine
 - `evaluateSigilTrigger` / `extractSigilPrefix` / `applySigilCompletion` — pure sigil logic functions
 

package/dist/index.d.ts

@@ -164,7 +164,7 @@ interface ToolResultMessage<T extends unknown = unknown> {
 }
 /**
  * RFC-144 M1：mid-conversation system 通知消息——**真正进 provider 请求**的协议消息类型
- * （区别于 `@otto/hook-contracts` 的 `SystemAgentMessage`，后者是 hooks/UI 域、
+ * （区别于 `@x-otto/hook-contracts` 的 `SystemAgentMessage`，后者是 hooks/UI 域、
  * convertToLLM 类型边界显式过滤、绝不进 provider 请求）。
  *
  * 用途：lifecycleAsync 工具（RFC-144）真正完成时，追加一条独立消息告知 LLM"运营方观察到
@@ -198,14 +198,14 @@ interface SystemNotificationMessage {
 type Message = UserMessage | AssistantMessage | ToolResultMessage | SystemNotificationMessage;
 /**
  * 历史压缩摘要消息的标记前缀——单一真相源（跨包协议常量）。
- * 生产者 @otto/memory 注入摘要消息时用、压缩去重(isSummaryMessage)时识别；消费者
- * @otto/agent 的 ContextPipeline 从会话树恢复摘要时用同一前缀重建摘要消息。放在协议叶子，
+ * 生产者 @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：
- * 从 @otto/ai 物理迁移——此前是 @otto/ai 唯一自己实现（非 re-export）的两个函数，只依赖
+ * 从 @x-otto/ai 物理迁移——此前是 @x-otto/ai 唯一自己实现（非 re-export）的两个函数，只依赖
  * AssistantMessage/ToolCall，真源本就该在协议叶子而非模型注册中枢）。
  */
 declare function getToolCallsByAssistantMessage(message: AssistantMessage): ToolCall[];
@@ -423,7 +423,29 @@ type ModelSpec = string | {
 //#endregion
 //#region src/model-capability.d.ts
 /**
- * 该模型是否支持图像输入。
+ * 能力事实三态（RFC-374 M2）。`supported` 携带证据值；`unsupported` = 声明了但不具备；
+ * `unknown` = 未声明/无数据——消费方必须显式选择 unknown 的处置策略
+ * （保守降级 or 乐观放行），禁止把 unknown 静默当 unsupported。
+ */
+type CapabilityFact<T> = {
+  state: 'supported';
+  value: T;
+} | {
+  state: 'unsupported';
+} | {
+  state: 'unknown';
+};
+/**
+ * 模型图像输入能力的三态事实。
+ * - `input` 明确包含 `'image'` → supported；
+ * - `input` 非空且不含 `'image'` → unsupported（manifest 声明了文本-only）；
+ * - `input` 为空数组（manifest 未声明 input）→ unknown——既有的 fail-safe 投影
+ *   把它当「不支持」（保守降级，见 modelSupportsImages），但事实层保留三态供
+ *   选型收据/诊断区分「这个模型确实没有视觉」与「声明缺失」。
+ */
+declare function modelImageCapability(model: Pick<Model, 'input'>): CapabilityFact<true>;
+/**
+ * 该模型是否支持图像输入（fail-safe 投影，RFC-181 语义保留）。
  *
  * 保守默认：仅当 `input` 数组**明确**包含 `'image'` 时返回 `true`；`input`
  * 缺失/为空数组时返回 `false`（RFC-181 §3 D1/§4 规则 2——第三方插件 manifest
@@ -432,6 +454,49 @@ type ModelSpec = string | {
  * 可通过补全 manifest 声明恢复）。
  */
 declare function modelSupportsImages(model: Pick<Model, 'input'>): boolean;
+/**
+ * 模型能力事实快照（RFC-374 M2 选型收据用）。字段按能力域扩展——
+ * 新增能力域（工具/推理/上下文）时在此加字段，消费方（选型收据/诊断面板）
+ * 共享同一快照形状，杜绝每处各自拼一份「这个模型能干什么」。
+ */
+interface ModelCapabilityFacts {
+  vision: CapabilityFact<true>;
+}
+/** 收集某模型的能力事实快照（纯函数，无 I/O）。 */
+declare function collectModelCapabilityFacts(model: Pick<Model, 'input'>): ModelCapabilityFacts;
+//#endregion
+//#region src/context-fragment.d.ts
+/**
+ * context-fragment.ts —— 有界上下文片段类型层（RFC-374 M3）。
+ *
+ * 借鉴 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-142 互补）：截断产物是**纯文本**（截断点 + 简短后缀），
+ * 绝不发明结构化 JSON 元数据键（模型会误学模仿引发上下文自我污染，见 docs/
+ * CODE-STYLE.md §6b）。片段内容被截断只损失尾部信息，不改变已注入部分的可读性。
+ */
+/** system prompt 注入片段的类型化 id（与 SYSTEM_PROMPT_SECTIONS 的字段一一对应）。 */
+type ContextFragmentId = 'toolGuidance' | 'skillLoopGuidance' | 'environment' | 'memoryIndex' | 'skillCatalog' | 'lesson' | 'memoryDelta' | 'todoReminder' | 'docSyncReminder';
+/** 有界上下文片段：id + 内容。预算声明在 SYSTEM_PROMPT_SECTIONS（runtime 包）。 */
+interface ContextFragment {
+  id: ContextFragmentId;
+  content: string;
+}
+/** UTF-8 字节长度（预算口径——字节硬顶，与 DeepSeek-TUI MAX_FRAGMENT_BYTES 同语义）。 */
+declare function contextFragmentBytes(content: string): number;
+/**
+ * 把片段内容裁剪到字节预算内。超预算时保留前缀（已注入部分完整可读）并追加纯文本
+ * 截断后缀；未超预算原样返回。`budgetBytes <= 0` 时返回仅含后缀的片段（fail-closed
+ * 而非静默放行）。返回新对象，不修改入参。
+ *
+ * 实现：Buffer 按字节截断后回退到完整 UTF-8 字符边界（continuation byte 0b10xxxxxx
+ * 不回切），避免多字节字符（CJK 等）被劈成乱码。
+ */
+declare function boundFragment(fragment: ContextFragment, budgetBytes: number): ContextFragment;
 //#endregion
 //#region src/tool.d.ts
 /**
@@ -465,6 +530,12 @@ interface ToolCallContext<Params = unknown> {
   agentName?: string;
   /** 当前会话委托深度（root=0）；委托工具据此回传 caller 深度给护栏。 */
   depth?: number;
+  /**
+   * RFC-371 S3：发起此工具调用的父任务 id（用于 per-parent 活跃扇出计数）。
+   * 缺省 undefined = root 层（无 per-parent 限制）。由 agent 的 ToolExecutor
+   * 从 turn 上下文注入；委托工具（task_delegate/agent_call）透传给 orchestrator。
+   */
+  parentTaskId?: string;
   onUpdate?: (update: string) => void;
 }
 interface ToolCallEvent {
@@ -806,7 +877,9 @@ type AgentSessionEvent = {
  * 修复（历史裁剪可观测性，2026-07-12；语义澄清 RFC-159 T6，2026-07-13）：会话内存态
  * 消息数超上限（`capStoredHistory`，纯条数防御上限，与 memory.pruned 的 token 维度裁剪
  * 是完全不同的机制，勿混）裁剪最早的消息条目时广播——此前该操作零 UI 反馈，长会话（内存
- * 消息数超上限，如默认 2000 条）resume 后用户发现前段历史消失却毫无线索。RFC-159 起持久
+ * 消息数超上限，见 `SESSION_MAX_HISTORY_MESSAGES`；RFC-321 D7 起为 50000 结构兜底闸，
+ * 早期注释写的"默认 2000 条"已过时，2026-08-12 复审订正）resume 后用户发现前段历史
+ * 消失却毫无线索。RFC-159 起持久
  * 层为 append-forever，被裁剪的条目仍完整保留在 DB（默认 SQLite 后端），本事件语义是
  * "内存视图收窄"而非数据删除。`removedCount` 为本次从内存视图移除的条目数。
  */
@@ -971,7 +1044,7 @@ type AgentSessionEventMap = { [E in AgentSessionEvent as E['type']]: (event: E)
 /**
  * engine-command.ts — RFC-090：renderer→engine 命令协议
  *
- * `EngineCommand` 是可序列化的联合类型，engine/renderer 共享于 @otto/interchange。
+ * `EngineCommand` 是可序列化的联合类型，engine/renderer 共享于 @x-otto/interchange。
  * 硬上限 15 种 command kind。同进程 transport 无需序列化（直接函数调用）；
  * 进程分离（RFC-091）后通过 stdin/stdout/WebSocket 传输。
  */
@@ -1007,7 +1080,7 @@ type EngineCommand = {
 }
 /**
  * RFC-303 D8 修正：`replacement` 运行时语义是 `AgentMessage[]`（会话压缩后的替换消息数组），
- * 但 `AgentMessage` 定义在 `@otto/hook-contracts`（依赖本包 type-only），本包不能反向引用其
+ * 但 `AgentMessage` 定义在 `@x-otto/hook-contracts`（依赖本包 type-only），本包不能反向引用其
  * 类型——故用 `unknown[]`（准确反映"数组"而非之前声明的 `string`）。此前声明为 `string` 是
  * 未被检查出的类型错误：发送侧靠 `as unknown as string` 双重断言掩盖真实值仍是数组；接收侧
  * `engine-main.ts` 曾用 `String(cmd.replacement)` 把数组转成 `"[object Object]"`，破坏数据
@@ -1037,9 +1110,9 @@ type EngineCommand = {
 //#region src/todo.d.ts
 /**
  * Todo 状态与条目 — 单一真源，供 write_todos 等工具跨层消费。
- * 原在 @otto/orchestration-contracts 与本包各有一份逐字相同的镜像定义
+ * 原在 @x-otto/orchestration-contracts 与本包各有一份逐字相同的镜像定义
  * （M-C 沉入 protocol 时未删旧副本，post-RFC-092 review F4 发现并归一）。
- * @otto/orchestration-contracts/src/primitives.ts 现从本文件 re-export，不再自行定义。
+ * @x-otto/orchestration-contracts/src/primitives.ts 现从本文件 re-export，不再自行定义。
  */
 type TodoStatus = 'pending' | 'in_progress' | 'done' | 'skipped' | 'failed';
 interface TodoItem {
@@ -1146,8 +1219,10 @@ interface PluginPerfMetricResult {
 //#region src/input.d.ts
 /** Input: mentions, sigils, content providers — user input enrichment types. */
 /** sigil 子类型：`hashtag` 属 `#`，其余属 `@`。`resource` = 插件自定义资源（RFC-210 D2）；
- * `shortcut` = 用户在本仓库自定义的文本快捷方式（RFC-233）。 */
-type SigilKind = 'hashtag' | 'file' | 'person' | 'agent' | 'skill' | 'mcp' | 'plugin' | 'model' | 'resource' | 'shortcut';
+ * `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 据此批量注销，防僵尸条目）。 */
@@ -1202,7 +1277,7 @@ interface SigilResolveContext {
   maxOutput: number;
 }
 /**
- * 插件输入注册表（UI 无关，由 createApp() 创建单例，实现留 @otto/coding）。
+ * 插件输入注册表（UI 无关，由 createApp() 创建单例，实现留 @x-otto/coding）。
  *
  * 静态 push 供给（register）+ 动态 pull 供给（registerProvider，服务 @file
  * 大候选集懒查，RFC §1.3.1 F-domain / RFC-044 M044-07）。
@@ -1369,5 +1444,5 @@ declare function evaluateSigilTrigger(input: {
   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 ChildProcessConfig, type CommonImageMime, type ContentPart, 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 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, evaluateSigilTrigger, extractSigilPrefix, extractToolResultText, getToolCallsByAssistantMessage, hasToolCalls, isSigilDismissed, modelSupportsImages, normalizeImageData, sigilOf, toAnthropicImageMime };
+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 };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,2 +1,3 @@
-const e=`[Conversation Summary]`;function t(e){return e.content.filter(e=>e.type===`tool_call`)}function n(e){return e.content.some(e=>e.type===`tool_call`)}function r(e){return Array.isArray(e.input)&&e.input.includes(`image`)}function i(e){return e.content.filter(e=>e.type===`text`).map(e=>e.text).join(`
-`)}const a=/^data:([^;,]*)(?:;[^,]*)?,(.*)$/s;function o(e,t){let n=a.exec(e),r=(n?n[2]??``:e).replace(/\s+/g,``);return{base64:r,mediaType:((n?n[1]:``)||t||``).toLowerCase(),valid:s(r)}}function s(e){return e.length===0||e===`undefined`||e.length%4==1?!1:/^[A-Za-z0-9+/]*={0,2}$/.test(e)}function c(e,t){switch(e.toLowerCase()){case`image/jpeg`:case`image/jpg`:return`image/jpeg`;case`image/png`:return`image/png`;case`image/gif`:return`image/gif`;case`image/webp`:return`image/webp`;default:return l(t)}}function l(e){return e.startsWith(`/9j/`)?`image/jpeg`:e.startsWith(`iVBOR`)?`image/png`:e.startsWith(`R0lGOD`)?`image/gif`:e.startsWith(`UklGR`)?`image/webp`:`image/png`}function u(e){return e===`hashtag`?`#`:`@`}const d=/(?:^|\s)([#@])(\S*)$/;function f(e,t){let n=e.slice(0,t).match(d);if(!n)return null;let r=n[1],i=n[2]??``;return{sigil:r,query:i,anchor:t-i.length-1}}function p(e,t){return!!t&&t.sigil===e.sigil&&t.anchor===e.anchor}function m(e,t){let n=Math.min(e.length,t.length),r=0;for(;r<n&&e[r]===t[r];)r++;let i=n-r,a=0;for(;a<i&&e[e.length-1-a]===t[t.length-1-a];)a++;return{start:r,end:e.length-a,delta:t.length-e.length}}function h(e,t,n){if(!e||t===n)return e;let{start:r,end:i,delta:a}=m(t,n),o=e.anchor+e.tokenLength;return i<=e.anchor?{...e,anchor:e.anchor+a}:r>=o||r>e.anchor&&r<o?e:null}function g(e,t,n,r){if(n<0||n>t)return{text:e,offset:t};let i=t>=e.length?` `:``;return{text:e.slice(0,n)+r.value+i+e.slice(t),offset:n+r.value.length+(i?1:0)}}function _(e,t,n,r){return t<0||t>n||n>e.length?{text:e,offset:n}:{text:e.slice(0,t)+r.value+e.slice(n),offset:t+r.value.length}}function v(e){let{source:t,oldText:n,newText:r,cursorOffset:i}=e,a=e.sigilFilter??(e=>e===`@`),o=h(e.dismissed,n,r);if(t!==`typing`||r.length<=n.length)return{action:`suppress`,dismissed:o};let s=f(r,i),c=s&&a(s.sigil)?s:null;return c?p(c,o)?{action:`suppress`,dismissed:o}:{action:`open`,trigger:c,dismissed:null}:{action:`close`,dismissed:o}}export{e as CONVERSATION_SUMMARY_PREFIX,h as adjustDismissedSigil,g as applySigilCompletion,_ as applySigilReplacement,v as evaluateSigilTrigger,f as extractSigilPrefix,i as extractToolResultText,t as getToolCallsByAssistantMessage,n as hasToolCalls,p as isSigilDismissed,r as modelSupportsImages,o as normalizeImageData,u as sigilOf,c as toAnthropicImageMime};
+const e=`[Conversation Summary]`;function t(e){return e.content.filter(e=>e.type===`tool_call`)}function n(e){return e.content.some(e=>e.type===`tool_call`)}function r(e){return!Array.isArray(e.input)||e.input.length===0?{state:`unknown`}:e.input.includes(`image`)?{state:`supported`,value:!0}:{state:`unsupported`}}function i(e){return r(e).state===`supported`}function a(e){return{vision:r(e)}}function o(e){return Buffer.byteLength(e,`utf8`)}function s(e,t){let n=Buffer.from(e.content,`utf8`);if(n.length<=t)return e;let r=Math.max(0,t);for(;r>0&&r<n.length&&(n[r]&192)==128;)r--;return{id:e.id,content:n.subarray(0,r).toString(`utf8`).trimEnd()+`
+[context truncated: budget exceeded]`}}function c(e){return e.content.filter(e=>e.type===`text`).map(e=>e.text).join(`
+`)}const l=/^data:([^;,]*)(?:;[^,]*)?,(.*)$/s;function u(e,t){let n=l.exec(e),r=(n?n[2]??``:e).replace(/\s+/g,``);return{base64:r,mediaType:((n?n[1]:``)||t||``).toLowerCase(),valid:d(r)}}function d(e){return e.length===0||e===`undefined`||e.length%4==1?!1:/^[A-Za-z0-9+/]*={0,2}$/.test(e)}function f(e,t){switch(e.toLowerCase()){case`image/jpeg`:case`image/jpg`:return`image/jpeg`;case`image/png`:return`image/png`;case`image/gif`:return`image/gif`;case`image/webp`:return`image/webp`;default:return p(t)}}function p(e){return e.startsWith(`/9j/`)?`image/jpeg`:e.startsWith(`iVBOR`)?`image/png`:e.startsWith(`R0lGOD`)?`image/gif`:e.startsWith(`UklGR`)?`image/webp`:`image/png`}function m(e){return e===`hashtag`?`#`:`@`}const h=/(?:^|\s)([#@])(\S*)$/;function g(e,t){let n=e.slice(0,t).match(h);if(!n)return null;let r=n[1],i=n[2]??``;return{sigil:r,query:i,anchor:t-i.length-1}}function _(e,t){return!!t&&t.sigil===e.sigil&&t.anchor===e.anchor}function v(e,t){let n=Math.min(e.length,t.length),r=0;for(;r<n&&e[r]===t[r];)r++;let i=n-r,a=0;for(;a<i&&e[e.length-1-a]===t[t.length-1-a];)a++;return{start:r,end:e.length-a,delta:t.length-e.length}}function y(e,t,n){if(!e||t===n)return e;let{start:r,end:i,delta:a}=v(t,n),o=e.anchor+e.tokenLength;return i<=e.anchor?{...e,anchor:e.anchor+a}:r>=o||r>e.anchor&&r<o?e:null}function b(e,t,n,r){if(n<0||n>t)return{text:e,offset:t};let i=t>=e.length?` `:``;return{text:e.slice(0,n)+r.value+i+e.slice(t),offset:n+r.value.length+(i?1:0)}}function x(e,t,n,r){return t<0||t>n||n>e.length?{text:e,offset:n}:{text:e.slice(0,t)+r.value+e.slice(n),offset:t+r.value.length}}function S(e){let{source:t,oldText:n,newText:r,cursorOffset:i}=e,a=e.sigilFilter??(e=>e===`@`),o=y(e.dismissed,n,r);if(t!==`typing`||r.length<=n.length)return{action:`suppress`,dismissed:o};let s=g(r,i),c=s&&a(s.sigil)?s:null;return c?_(c,o)?{action:`suppress`,dismissed:o}:{action:`open`,trigger:c,dismissed:null}:{action:`close`,dismissed:o}}export{e as CONVERSATION_SUMMARY_PREFIX,y as adjustDismissedSigil,b as applySigilCompletion,x as applySigilReplacement,s as boundFragment,a as collectModelCapabilityFacts,o as contextFragmentBytes,S as evaluateSigilTrigger,g as extractSigilPrefix,c as extractToolResultText,t as getToolCallsByAssistantMessage,n as hasToolCalls,_ as isSigilDismissed,r as modelImageCapability,i as modelSupportsImages,u as normalizeImageData,m as sigilOf,f as toAnthropicImageMime};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x-otto/interchange",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0-alpha.2",
   "files": [
     "dist"
   ],
@@ -25,4 +25,4 @@
     "test": "vitest run",
     "clean": "rm -rf dist"
   }
-}
+}