@icen.ai/ui 0.8.0 → 0.8.1

package/dist/behaviors/ai-tools.d.mts

@@ -13,24 +13,27 @@ interface AiToolDef<TInput = unknown> {
 }
 interface AiToolRecord {
     def: AiToolDef;
-    /** 挂载元素（present='mount' 时有值） */
+    /** 挂载元素（present='mount' 时有值；'data' 模式不占挂载位、无 el） */
     el?: HTMLElement;
-    /** render_chart 等返回的句柄（可 update/destroy） */
-    handle?: unknown;
     ts: number;
     input: unknown;
     result: unknown;
 }
 /** 注册（或覆盖同名）一个工具；第三方扩展入口 */
 declare function registerAiTool(def: AiToolDef): void;
-/** 全局下架一个工具（所有区域随即不可再调用它） */
+/**
+ * 全局下架一个工具（所有区域随即不可再调用它）；各区域已挂载的卡同步收尾移除
+ * （record.el 存在则出 DOM + 出 records，照移除钮路径）。
+ */
 declare function unregisterAiTool(name: string): void;
+/** 按名查已注册工具（call/can 内部同走此口；未注册返回 undefined） */
 declare function getAiTool(name: string): AiToolDef | undefined;
+/** 全部已注册工具的快照数组（aiToolsToOpenAI / aiToolsToMcp / aiToolsManifest 的底座） */
 declare function listAiTools(): AiToolDef[];
 interface AiToolAreaOptions {
     /** 工具白名单（精确名或 'chart-*' 通配；缺省 = 全部已注册工具） */
     tools?: string[];
-    /** 最多同时挂载数（超出 LRU 淘汰最旧；缺省不限） */
+    /** 最多同时挂载数（超出 FIFO 淘汰最旧挂载；缺省不限） */
     max?: number;
     /** 挂载项的最小高度提示（px，默认 240） */
     itemMinHeight?: number;
@@ -53,7 +56,7 @@ interface AiToolArea {
 }
 /**
  * 创建 AI 工具挂载区：宿主声明「这块区域归 AI 用」——可白名单工具、限数量
- * （LRU 淘汰）。每次 call 渲染为一个 .ai-tools-item 卡（标题行 = 工具名 +
+ * （超出上限 FIFO 淘汰最旧挂载）。每次 call 渲染为一个 .ai-tools-item 卡（标题行 = 工具名 +
  * 时间 + 移除钮，体 = 工具自己的渲染）。事件 icen:ai-tool-call / -result /
  * -evict（bubbles），area 上也可原生 addEventListener。
  */