@webskill/chatbot 0.17.0 → 0.19.0

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { a as RuntimeRendererId, c as RuntimeQuickPrompt, d as TranslateFn, i as RuntimeLlmEntry, l as Locale, n as RuntimeConfig, o as QuickPrompt, r as RuntimeConfigStore, s as QuickPromptIconName, t as RuntimeAppearanceConfig, u as LocalizedText } from "./index-B25ux241.js";
-import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, DataSourceInfo, DocumentSurfaceHost, DocxTextExtractor, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, HookRunner, InteractionRequest, InteractionResponse, LifecycleEventInit, LinkedDocumentReader, LlmClient, NetworkPolicy, Page, PageQuery, PdfTextExtractor, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshotListEntry, RuntimePhase, RuntimeRun, ScriptExecutor, SessionStore, SkillCandidateMarker, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, UserProfileExport, WebSkillErrorCode, XlsxTextExtractor, diffUserProfile } from "@webskill/sdk";
-import { SandboxMode, TypeScriptSupportOptions } from "@webskill/sdk/browser";
-import { CustomSurfaceActionEvent, ReactBridgeState, SpecInteractionChannel, SurfaceRegistry, UiSurfaceActionEvent } from "@webskill/sdk/ui-react";
-import { DownloadedFileConsent, DownloadedFileReader, PageActionPolicy, PagePerceptionPolicy, PerceptionPagingBudget, PerceptionRecord, SkillCandidateSink, TabWorksetPolicy, TodoItem } from "@webskill/sdk/agent";
+import { a as RuntimeRendererId, c as RuntimeQuickPrompt, d as TranslateFn, i as RuntimeLlmEntry, l as Locale, n as RuntimeConfig, o as QuickPrompt, r as RuntimeConfigStore, s as QuickPromptIconName, t as RuntimeAppearanceConfig, u as LocalizedText } from "./index-DhXFYp0d.js";
 import "react";
+import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, DataSourceInfo, DocumentSurfaceHost, DocxTextExtractor, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, HookRunner, InteractionRequest, InteractionResponse, LifecycleEventInit, LinkedDocumentReader, LlmClient, NetworkPolicy, Page, PageQuery, PdfTextExtractor, PptxTextExtractor, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshotListEntry, RuntimePhase, RuntimeRun, ScriptExecutor, SessionStore, SkillCandidateMarker, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, UserProfileExport, VisionDelegate, VisionDelegateRequest, VisionDelegateResult, WebSkillErrorCode, XlsxTextExtractor, diffUserProfile } from "@webskill/sdk";
+import { PageImageHost, RemoteImageHost, SandboxMode, TypeScriptSupportOptions, WebOfficeConsent, WebOfficeHost } from "@webskill/sdk/browser";
+import { CustomSurfaceActionEvent, ReactBridgeState, SpecInteractionChannel, SurfaceRegistry, UiSurfaceActionEvent } from "@webskill/sdk/ui-react";
+import { ConsentUi, DocxDocumentReader, DocxTemplateEngine, DownloadedFileConsent, DownloadedFileReader, DwgDocumentContent, DwgProjection, PageActionPolicy, PagePerceptionPolicy, PdfDocumentReader, PerceptionPagingBudget, PerceptionRecord, PptxDocumentReader, SkillCandidateSink, TabWorksetPolicy, TemplateFileSource, TodoItem, XlsxDocumentReader, XlsxTemplateEngine } from "@webskill/sdk/agent";
 //#region ../core/src/attachment/kind.d.ts
 /**
  * 附件类型判据与文本形态。0.14.0 分册 20 从 `@webskill/chatbot` 迁入：
@@ -11,8 +11,14 @@ import "react";
  * 产出同一份文本（AC-20.6），而后者住在 `@webskill/agent`，chatbot 依赖 agent，
  * 判据只能落在两者共同的下游。纯字符串运算，无环境依赖。
  */
-/** 附件在模型侧的内容形态（0.6.0 FR-11.2） @experimental */
-type ChatAttachmentKind = 'text' | 'image' | 'file' | 'document-text';
+/**
+ * 附件在模型侧的内容形态（0.6.0 FR-11.2）。
+ *
+ * `binary` 的分界不是「是不是二进制」（`image` / `file` 也是），而是
+ * **一个字节都不进上下文**：模型只拿得到取件号，字节由工具在宿主侧读（0.22.0 FR-19.9）。
+ * @experimental
+ */
+type ChatAttachmentKind = 'text' | 'image' | 'file' | 'document-text' | 'binary';
 //#endregion
 //#region ../runtime/src/tools/types.d.ts
 /**
@@ -76,6 +82,71 @@ declare function createLocalStorageRuntimeConfigStore(options?: LocalStorageRunt
 /** 内存实现：测试、SSR、以及宿主明确不想持久化时使用。 @experimental */
 declare function createMemoryRuntimeConfigStore(initial?: Partial<RuntimeConfig>): RuntimeConfigStore;
 //#endregion
+//#region src/core/visionDelegate.d.ts
+/**
+ * 委派目标端点的可辨识标识；告知卡与审计都只用这三项（FR-17.6a / FR-17.7a）
+ * @experimental
+ */
+interface VisionDelegationEndpoint {
+  /** 模型条目 id */
+  readonly id: string;
+  /** 用户在 Console 里给这条起的名字 */
+  readonly label: string;
+  /** `baseUrl` 的主机名；内置档没有 baseUrl 时是 provider 名 */
+  readonly host: string;
+}
+/**
+ * 视觉委派的记忆端口（0.21.0 分册 17 · FR-17.9b）。形状照抄 `DownloadedFileConsent`：
+ * 存哪、记多久归宿主，SDK 只定接口。不注入即**每次都问**（FR-17.9c）。
+ * @experimental
+ */
+interface VisionDelegationConsent {
+  recall(endpoint: VisionDelegationEndpoint): boolean | Promise<boolean>;
+  remember(endpoint: VisionDelegationEndpoint): void | Promise<void>;
+  /**
+   * 复选框旁的文案。宿主不实现即用通用兜底串——
+   * SDK 无权替宿主宣称记住的是「这个端点」还是「所有端点」，写死会变成谎报授权范围。
+   */
+  describeScope?(endpoint: VisionDelegationEndpoint): string | undefined;
+}
+/** 装配参数；每一项都是「每次调用时重读」的取值函数，不是装配期快照 @experimental */
+interface ChatbotVisionDelegateOptions {
+  /** 每次调用时读的实时配置：选中模型与端点列表中途都可能变 */
+  config(): Promise<RuntimeConfig | undefined>;
+  /** 当前选中的模型条目 id（未选中即用默认项） */
+  selectedModelId(): string | undefined;
+  /** 选中条目的解析口径必须与主链路一致，否则「主模型看不看得了图」两处会打架 */
+  selectedEntry(config: RuntimeConfig | undefined): RuntimeLlmEntry | undefined;
+  /** 告知卡出口；引擎的 UI 桥天然满足 */
+  ui: ConsentUi;
+  consent?: VisionDelegationConsent;
+  /** 留痕出口。不注入仍然可以委派（FR-17.6b）：审计是宿主能力，不是同意条件 */
+  audit?: {
+    append(event: {
+      type: string;
+      target: string;
+      data?: Record<string, unknown>;
+    }): Promise<unknown>;
+  };
+  /** 按条目建客户端。缺省由调用方注入 `createLlmClient` */
+  createClient(entry: RuntimeLlmEntry): LlmClient;
+}
+/**
+ * 视觉委派的宿主侧实现（0.21.0 分册 17）。
+ *
+ * 三件事按顺序发生：挑端点（FR-17.2）→ 征得同意（FR-17.7）→ 一次调用认完所有图（FR-17.3a）。
+ * 在用户作出选择之前**不发出任何请求**：客户端是在同意之后才建的（FR-17.7b / AC-17.3）。
+ * @experimental
+ */
+declare class ChatbotVisionDelegate implements VisionDelegate {
+  #private;
+  constructor(options: ChatbotVisionDelegateOptions);
+  /** 新会话重新问（AC-17.4）。同意的记忆归宿主，这里不碰 */
+  forgetSessionDecision(): void;
+  applies(): Promise<boolean>;
+  describe(request: VisionDelegateRequest): Promise<VisionDelegateResult>;
+}
+//#endregion
 //#region src/core/hostAdapter.d.ts
 /**
  * 宿主装配口：chatbot 不感知环境（浏览器/Node），全部能力经此注入。
@@ -138,11 +209,72 @@ interface ChatbotHostAdapter {
   docxExtractor?: DocxTextExtractor;
   /** xlsx → 文本（`extractXlsxText`）；不注入即 Excel 工作簿明确报「本环境不支持」 */
   xlsxExtractor?: XlsxTextExtractor;
+  /** pptx → 文本（`extractPptxText`）；不注入即演示文稿明确报「本环境不支持」 @experimental */
+  pptxExtractor?: PptxTextExtractor;
   /**
    * PDF → 文本；**只用于直传被端点拒后的回退**（0.13.0 FR-22.1）。
    * PDF 仍然默认直传，能读的端点拿到的还是原件；不注入即没有回退能力。
    */
   pdfExtractor?: PdfTextExtractor;
+  /**
+   * 逐页读 PDF（0.21.0 分册 22）：拿页数、逐页文本、逐页图、把整页渲成图。
+   *
+   * 与 `pdfExtractor` 分开给，是因为它们回答的是两个问题：那个问「整份的文本是什么」，
+   * 这个问「第 N 页是什么」。三个 `*DocumentReader` 各自独立，缺哪个就哪种格式
+   * 明确报「本环境不支持」，不互相兜底。
+   * @experimental
+   */
+  pdfDocumentReader?: PdfDocumentReader;
+  /** docx → 块序列（`createDocxBlockReader`）；不注入即 `read_document` 读不了 Word @experimental */
+  docxDocumentReader?: DocxDocumentReader;
+  /** xlsx → 行流（`createXlsxBlockReader`）；不注入即 `read_document` 读不了 Excel @experimental */
+  xlsxDocumentReader?: XlsxDocumentReader;
+  /**
+   * pptx → 逐页的块序列（`createPptxBlockReader`）；不注入即 `read_document` 读不了演示文稿。
+   * 给的是页上的字与图，**不是页面渲染图**——要版式只能退到截屏。
+   * @experimental
+   */
+  pptxDocumentReader?: PptxDocumentReader;
+  /**
+   * 照着 xlsx 模板出文件（0.22.0 分册 42）：读骨架 + 按坐标填值插图。
+   *
+   * 与 `xlsxDocumentReader` 分开给，是因为它们回答的是两个问题：那个问「这份表说了什么」，
+   * 这个问「这份表的哪个格子在哪儿、怎么往里写而不动其余任何东西」。
+   * 两个引擎都不注入时 `inspect_template` / `fill_template` 不注册。
+   * @experimental
+   */
+  xlsxTemplateEngine?: XlsxTemplateEngine;
+  /** 照着 docx 模板出文件（0.22.0 分册 42）；不注入即模板工具读不了 Word @experimental */
+  docxTemplateEngine?: DocxTemplateEngine;
+  /**
+   * 在线 WebOffice 文档的**原件字节**（0.22.0 分册 42 · FR-42.12 ～ FR-42.15）。
+   *
+   * 取件号是 `weboffice:<handle>`，handle 就是 `list_weboffice_documents` 已经给过模型的那一个。
+   * 单开一个端口而不是并进 `read_document` 的取件号，是因为这条路的字节来源与那三条都不同：
+   * 它来自页面自己握着的同源直链，而那条链接里带着 `requestkey`，**不出内容脚本那一帧**——
+   * 所以只能由宿主取回字节再交出来，模型永远看不到 URL。
+   *
+   * 不注入即 `weboffice:` 取件号读不到，工具会明说取不到原件并让用户下载后作为附件传入
+   * （FR-42.14：**不得**退成用文本骨架重排一份新文件）。
+   * @experimental
+   */
+  webOfficeTemplateSource?: TemplateFileSource;
+  /**
+   * DWG 图纸的解析与投放（0.22.0 分册 19）。两项缺一即 `view_dwg` 不注册。
+   *
+   * 解析实现住在宿主是因为它必须跑在 Worker 里——17 MB 图纸解析耗时近 4 秒，
+   * 放主线程会冻结侧栏（AC-19.11）。
+   * @experimental
+   */
+  dwg?: DwgHost;
+  /**
+   * 视觉委派的「不再询问」记忆端口（0.21.0 分册 17 · FR-17.9）。
+   *
+   * **不注入不等于关闭**：委派本身只要模型列表里有能看图的条目就成立，
+   * 只是每次都要弹告知卡（FR-17.9c）。本册刻意不加 Console 开关（FR-17.8）。
+   * @experimental
+   */
+  visionConsent?: VisionDelegationConsent;
   /** 文档读取留痕出口（FR-22.6）；分册 17 的 `upload.file.read` 也走这条 */
   documentAudit?: {
     append(event: {
@@ -164,6 +296,39 @@ interface ChatbotHostAdapter {
     /** 「不再询问」的记忆端口；不注入即每次都问 */
     consent?: DownloadedFileConsent;
   };
+  /**
+   * 读页内嵌的 WPS WebOffice 文档（0.21.0 分册 11~13）。
+   * **不注入即两个工具都不注册**——本册刻意不加设置开关（FR-13.8）：
+   * 能不能读取决于这一页有没有那样一份文档，那不是用户需要预先决定的事。
+   *
+   * 与 `downloads` 同一条装配规矩：宿主只交端口（枚举 / 读取 / 截屏），
+   * 授权卡出口与审计出口在引擎这一侧。
+   * @experimental
+   */
+  webOffice?: {
+    host: WebOfficeHost;
+    /** 「不再询问」的记忆端口；不注入即每次都问 */
+    consent?: WebOfficeConsent;
+  };
+  /**
+   * 把宿主页面上的图取进文档（0.22.0 分册 12）。**不注入即 `capture_page_image` 不注册**：
+   * 纯 Web 宿主拿不到宿主页面的 DOM，模型在那些宿主上应该**看不见**这个工具，
+   * 而不是看得见再次次失败。
+   *
+   * 同 `webOffice` 那条装配规矩：宿主只交端口，授权卡、会话内记忆、产物落盘
+   * 都在引擎这一侧——它们需要知道 run 目录布局与会话生灭，而那两件事只有引擎知道。
+   * @experimental
+   */
+  pageImage?: PageImageHost;
+  /**
+   * 把一张外链图取进文档（0.22.0 分册 13）。**不注入即 `fetch_remote_image` 不注册**：
+   * 普通网页宿主受同源策略拿不到跨域字节（设计 14 §1 实测），
+   * 在那些宿主上图只能以外链形态进文档，工具本身不该出现。
+   *
+   * 授权与 `pageImage` 共用同一个面（`readImageSource`），但记忆按来源类型分开。
+   * @experimental
+   */
+  remoteImage?: RemoteImageHost;
   /**
    * 文档投放面（0.15.0 分册 13）。宿主交出 viewer 页地址、投放前确认与审计出口，
    * 三件都在 `createDocumentSurfaceHost` 的选项里。
@@ -174,8 +339,27 @@ interface ChatbotHostAdapter {
    */
   documentSurface?: DocumentSurfaceHost;
 }
+/**
+ * DWG 图纸的宿主出口（0.22.0 分册 19）。
+ * @experimental
+ */
+interface DwgHost {
+  /** 解析字节。实现应跑在 Worker 里：17 MB 图纸解析近 4 秒 */
+  read(bytes: Uint8Array, name: string): Promise<DwgDocumentContent>;
+  /** 把图纸送进查看器 */
+  project(input: DwgProjection): Promise<void>;
+}
 //#endregion
 //#region src/core/chatEngine.d.ts
+/**
+ * 在线 WebOffice 文档作模板时的取件号前缀（0.22.0 分册 42 · FR-42.12）。
+ *
+ * 前缀是显式的，不靠猜：`inspect_template` 的取件号绝大多数是附件 id，
+ * 拿一个普通 id 去在线文档那边碰运气，猜中一次的收益远小于猜错一次的代价——
+ * 那是把另一份文档当成用户指的那一份填了出去。
+ * @experimental
+ */
+declare const WEB_OFFICE_TEMPLATE_PREFIX = "weboffice:";
 /**
  * 条目能否真的发请求：云端要有端点或密钥，浏览器内置两者都不需要。
  *
@@ -238,6 +422,12 @@ interface ChatEngineOptions {
   generativeUi?: boolean;
   /** 沙箱执行器替换点（测试注入 spy 断言构造参数；缺省 BrowserWorkerScriptExecutor） */
   executorFactory?: (deps: SandboxExecutorDeps) => ScriptExecutor;
+  /**
+   * 视觉委派用的客户端工厂（分册 17）。缺省 `createLlmClient`——
+   * 与主链路同一个工厂，被选中条目的 `baseUrl` / `apiKey` / `model` 原样生效（FR-17.2c）。
+   * 替换点存在只为让判据能断言「请求打到了哪个端点」（AC-17.8），不是配置项。
+   */
+  visionClientFactory?: (entry: RuntimeLlmEntry) => LlmClient;
   /**
    * 宿主声明的数据源取数入口（分册 16）。不注入即脚本上下文没有 `fetchData` 这个键。
    *
@@ -375,8 +565,14 @@ declare class ChatEngine {
   send(text: string, attachments?: readonly ChatAttachmentInput[]): Promise<void>;
   /** 附件落盘根目录（composer 附件适配器写入，send 时读回） */
   get attachmentsRoot(): string;
-  /** 取消进行中的 run（Composer Stop 按钮）；run 未找到/已结束返回 false */
-  cancel(runId: string): boolean;
+  /**
+   * 取消进行中的 run（Composer Stop 按钮）；run 未找到/已结束返回 false。
+   *
+   * 不传 runId 就取消引擎自己记着的那一个。UI 那边的 runId 是 `run-started` 事件携回去的，
+   * 而 `run-preparing` 到 `run-started` 之间是一整段无声区（队列/发现/路由）——
+   * 那段里面板已经是忙碌态、终止按钮已经在了，可 UI 手里还没 id，按下去是个空操作。
+   */
+  cancel(runId?: string): boolean;
   /**
    * 释放引擎：取消进行中的 run、退订全部事件、丢弃装配缓存。
    * 宿主重挂组件时用它收尾；只是换配置的话用 `reloadConfig()`，不要 dispose。
@@ -668,7 +864,19 @@ interface ChatSessionListResult {
   skipped: readonly string[];
 }
 /** @stable */
-type ChatEvent = {
+type ChatEvent =
+/**
+ * 请求已受理，正在交给 runtime（分册 20 FR-20.2）。
+ *
+ * `run-started` 是从 runtime 的 `route` 生命周期事件派生的，而 route 排在
+ * 队列 / discover / listSkills / catalogFilter 之后。那一整段里任何一处慢或挂，
+ * 界面上都是同一副画面：什么都没有。本事件把那段变成一个显式状态。
+ */
+{
+  type: 'run-preparing';
+  sessionId: string;
+  queued: boolean;
+} | {
   type: 'run-started';
   runId: string;
 } | {
@@ -725,6 +933,18 @@ type ChatEvent = {
   name: string;
   args?: string;
   errorCode?: string;
+} |
+/**
+ * 委派识图的逐张进度（分册 26 FR-26.9）。挂在 `source` 这个工具名上，
+ * 不带 callId——委派发生在工具**结果**回喂阶段，那时调用早已结束。
+ * @experimental
+ */
+{
+  type: 'vision-progress';
+  runId: string;
+  source: string;
+  done: number;
+  total: number;
 } | {
   type: 'run-completed';
   runId: string;
@@ -733,6 +953,21 @@ type ChatEvent = {
   activeSkillNames: string[];
   /** 终止原因对应的稳定错误码（仅非正常结束时）：UI 据此分类提示，不再压平为 RUN_FAILED */
   code?: WebSkillErrorCode;
+  /**
+   * 本 run 结束时的上下文水位线（末轮输入 token，分册 20 FR-20.5）。
+   * 上游不回报 usage 时缺省——不填 0冒充「已知为零」。
+   */
+  contextTokens?: number;
+} |
+/**
+ * 历史被压缩（分册 20 FR-20.8）：只描述运行时历史的变化，会话存储里的原文不动。
+ * @experimental
+ */
+{
+  type: 'context-compacted';
+  sessionId: string;
+  removed: number;
+  kept: number;
 } | {
   type: 'todo-changed';
   runId: string;
@@ -1040,6 +1275,7 @@ declare const chatbotDictionary: {
     'tool.status.completed': string;
     'tool.status.failed': string;
     'tool.status.denied': string;
+    'tool.vision.progress': string;
     'tool.duration': string;
     'tool.args': string;
     'tool.denied.reason': string;
@@ -1086,6 +1322,7 @@ declare const chatbotDictionary: {
     'todo.status.inProgress': string;
     'todo.status.completed': string;
     'todo.delegatedTo': string;
+    'todo.dismiss': string;
     'interaction.ask.title': string;
     'interaction.confirm.title': string;
     'interaction.form.title': string;
@@ -1107,6 +1344,8 @@ declare const chatbotDictionary: {
     'interaction.pageAction.attach': string;
     'interaction.pageAction.scroll.down': string;
     'interaction.pageAction.scroll.up': string;
+    'interaction.pageAction.hover': string;
+    'interaction.pageAction.drag': string;
     'interaction.pageAction.back': string;
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
@@ -1115,6 +1354,8 @@ declare const chatbotDictionary: {
     'interaction.pageAction.role.set': string;
     'interaction.pageAction.role.attach': string;
     'interaction.pageAction.role.scroll': string;
+    'interaction.pageAction.role.hover': string;
+    'interaction.pageAction.role.drag': string;
     'interaction.pageAction.role.back': string;
     'interaction.pageAction.remember': string;
     'interaction.pageAction.frame': string;
@@ -1123,6 +1364,30 @@ declare const chatbotDictionary: {
     'interaction.downloadedFile.read': string;
     'interaction.downloadedFile.file': string;
     'interaction.downloadedFile.remember': string;
+    'interaction.webOffice.listTitle': string;
+    'interaction.webOffice.listBody': string;
+    'interaction.webOffice.readTitle': string;
+    'interaction.webOffice.readBody': string;
+    'interaction.webOffice.captureTitle': string;
+    'interaction.webOffice.captureBody': string;
+    'interaction.webOffice.claimedTypeNote': string;
+    'interaction.webOffice.rememberFallback': string;
+    'interaction.visionDelegation.title': string;
+    'interaction.visionDelegation.reason': string;
+    'interaction.visionDelegation.endpoint': string;
+    'interaction.visionDelegation.declineNote': string;
+    'interaction.visionDelegation.rememberFallback': string;
+    'interaction.visionDelegation.rememberSession': string;
+    'interaction.visionDelegation.body': string;
+    'interaction.imageSource.title': string;
+    'interaction.imageSource.pageImageBody': string;
+    'interaction.imageSource.remoteImageBody': string;
+    'interaction.imageSource.remoteImageAnyBody': string;
+    'interaction.imageSource.insecure': string;
+    'interaction.imageSource.note': string;
+    'interaction.imageSource.rememberFallback': string;
+    'interaction.imageSource.rememberPageImage': string;
+    'interaction.imageSource.rememberRemoteImage': string;
     'interaction.uploadFile.read': string;
     'interaction.uploadFile.file': string;
     'interaction.sandbox.readReference': string;
@@ -1188,6 +1453,7 @@ declare const chatbotDictionary: {
     'composer.attachment.kind.image': string;
     'composer.attachment.kind.file': string;
     'composer.attachment.kind.document-text': string;
+    'composer.attachment.kind.binary': string;
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.unconfigured': string;
@@ -1199,6 +1465,13 @@ declare const chatbotDictionary: {
     'composer.addAttachment.imagesOff': string;
     'composer.addAttachment.modelNoImages': string;
     'attachment.imagesDropped': string;
+    'attachment.storeFailed.title': string;
+    'attachment.storeFailed': string;
+    'attachment.pdfAsText': string;
+    'attachment.pdfAsPagedRead': string;
+    'attachment.pdfRefused': string;
+    'attachment.pdfNoExtractor': string;
+    'attachment.textTooLong': string;
     'composer.dictate': string;
     'composer.dictate.stop': string;
     'composer.dictate.recording': string;
@@ -1431,6 +1704,7 @@ declare const chatbotDictionary: {
     'tool.status.completed': string;
     'tool.status.failed': string;
     'tool.status.denied': string;
+    'tool.vision.progress': string;
     'tool.duration': string;
     'tool.args': string;
     'tool.denied.reason': string;
@@ -1477,6 +1751,7 @@ declare const chatbotDictionary: {
     'todo.status.inProgress': string;
     'todo.status.completed': string;
     'todo.delegatedTo': string;
+    'todo.dismiss': string;
     'interaction.ask.title': string;
     'interaction.confirm.title': string;
     'interaction.form.title': string;
@@ -1498,6 +1773,8 @@ declare const chatbotDictionary: {
     'interaction.pageAction.attach': string;
     'interaction.pageAction.scroll.down': string;
     'interaction.pageAction.scroll.up': string;
+    'interaction.pageAction.hover': string;
+    'interaction.pageAction.drag': string;
     'interaction.pageAction.back': string;
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
@@ -1506,6 +1783,8 @@ declare const chatbotDictionary: {
     'interaction.pageAction.role.set': string;
     'interaction.pageAction.role.attach': string;
     'interaction.pageAction.role.scroll': string;
+    'interaction.pageAction.role.hover': string;
+    'interaction.pageAction.role.drag': string;
     'interaction.pageAction.role.back': string;
     'interaction.pageAction.remember': string;
     'interaction.pageAction.frame': string;
@@ -1514,6 +1793,30 @@ declare const chatbotDictionary: {
     'interaction.downloadedFile.read': string;
     'interaction.downloadedFile.file': string;
     'interaction.downloadedFile.remember': string;
+    'interaction.webOffice.listTitle': string;
+    'interaction.webOffice.listBody': string;
+    'interaction.webOffice.readTitle': string;
+    'interaction.webOffice.readBody': string;
+    'interaction.webOffice.captureTitle': string;
+    'interaction.webOffice.captureBody': string;
+    'interaction.webOffice.claimedTypeNote': string;
+    'interaction.webOffice.rememberFallback': string;
+    'interaction.visionDelegation.title': string;
+    'interaction.visionDelegation.reason': string;
+    'interaction.visionDelegation.endpoint': string;
+    'interaction.visionDelegation.declineNote': string;
+    'interaction.visionDelegation.rememberFallback': string;
+    'interaction.visionDelegation.rememberSession': string;
+    'interaction.visionDelegation.body': string;
+    'interaction.imageSource.title': string;
+    'interaction.imageSource.pageImageBody': string;
+    'interaction.imageSource.remoteImageBody': string;
+    'interaction.imageSource.remoteImageAnyBody': string;
+    'interaction.imageSource.insecure': string;
+    'interaction.imageSource.note': string;
+    'interaction.imageSource.rememberFallback': string;
+    'interaction.imageSource.rememberPageImage': string;
+    'interaction.imageSource.rememberRemoteImage': string;
     'interaction.uploadFile.read': string;
     'interaction.uploadFile.file': string;
     'interaction.sandbox.readReference': string;
@@ -1579,6 +1882,7 @@ declare const chatbotDictionary: {
     'composer.attachment.kind.image': string;
     'composer.attachment.kind.file': string;
     'composer.attachment.kind.document-text': string;
+    'composer.attachment.kind.binary': string;
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.unconfigured': string;
@@ -1590,6 +1894,13 @@ declare const chatbotDictionary: {
     'composer.addAttachment.imagesOff': string;
     'composer.addAttachment.modelNoImages': string;
     'attachment.imagesDropped': string;
+    'attachment.storeFailed.title': string;
+    'attachment.storeFailed': string;
+    'attachment.pdfAsText': string;
+    'attachment.pdfAsPagedRead': string;
+    'attachment.pdfRefused': string;
+    'attachment.pdfNoExtractor': string;
+    'attachment.textTooLong': string;
     'composer.dictate': string;
     'composer.dictate.stop': string;
     'composer.dictate.recording': string;
@@ -1825,6 +2136,7 @@ declare const useT: () => TranslateFn<{
     'tool.status.completed': string;
     'tool.status.failed': string;
     'tool.status.denied': string;
+    'tool.vision.progress': string;
     'tool.duration': string;
     'tool.args': string;
     'tool.denied.reason': string;
@@ -1871,6 +2183,7 @@ declare const useT: () => TranslateFn<{
     'todo.status.inProgress': string;
     'todo.status.completed': string;
     'todo.delegatedTo': string;
+    'todo.dismiss': string;
     'interaction.ask.title': string;
     'interaction.confirm.title': string;
     'interaction.form.title': string;
@@ -1892,6 +2205,8 @@ declare const useT: () => TranslateFn<{
     'interaction.pageAction.attach': string;
     'interaction.pageAction.scroll.down': string;
     'interaction.pageAction.scroll.up': string;
+    'interaction.pageAction.hover': string;
+    'interaction.pageAction.drag': string;
     'interaction.pageAction.back': string;
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
@@ -1900,6 +2215,8 @@ declare const useT: () => TranslateFn<{
     'interaction.pageAction.role.set': string;
     'interaction.pageAction.role.attach': string;
     'interaction.pageAction.role.scroll': string;
+    'interaction.pageAction.role.hover': string;
+    'interaction.pageAction.role.drag': string;
     'interaction.pageAction.role.back': string;
     'interaction.pageAction.remember': string;
     'interaction.pageAction.frame': string;
@@ -1908,6 +2225,30 @@ declare const useT: () => TranslateFn<{
     'interaction.downloadedFile.read': string;
     'interaction.downloadedFile.file': string;
     'interaction.downloadedFile.remember': string;
+    'interaction.webOffice.listTitle': string;
+    'interaction.webOffice.listBody': string;
+    'interaction.webOffice.readTitle': string;
+    'interaction.webOffice.readBody': string;
+    'interaction.webOffice.captureTitle': string;
+    'interaction.webOffice.captureBody': string;
+    'interaction.webOffice.claimedTypeNote': string;
+    'interaction.webOffice.rememberFallback': string;
+    'interaction.visionDelegation.title': string;
+    'interaction.visionDelegation.reason': string;
+    'interaction.visionDelegation.endpoint': string;
+    'interaction.visionDelegation.declineNote': string;
+    'interaction.visionDelegation.rememberFallback': string;
+    'interaction.visionDelegation.rememberSession': string;
+    'interaction.visionDelegation.body': string;
+    'interaction.imageSource.title': string;
+    'interaction.imageSource.pageImageBody': string;
+    'interaction.imageSource.remoteImageBody': string;
+    'interaction.imageSource.remoteImageAnyBody': string;
+    'interaction.imageSource.insecure': string;
+    'interaction.imageSource.note': string;
+    'interaction.imageSource.rememberFallback': string;
+    'interaction.imageSource.rememberPageImage': string;
+    'interaction.imageSource.rememberRemoteImage': string;
     'interaction.uploadFile.read': string;
     'interaction.uploadFile.file': string;
     'interaction.sandbox.readReference': string;
@@ -1973,6 +2314,7 @@ declare const useT: () => TranslateFn<{
     'composer.attachment.kind.image': string;
     'composer.attachment.kind.file': string;
     'composer.attachment.kind.document-text': string;
+    'composer.attachment.kind.binary': string;
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.unconfigured': string;
@@ -1984,6 +2326,13 @@ declare const useT: () => TranslateFn<{
     'composer.addAttachment.imagesOff': string;
     'composer.addAttachment.modelNoImages': string;
     'attachment.imagesDropped': string;
+    'attachment.storeFailed.title': string;
+    'attachment.storeFailed': string;
+    'attachment.pdfAsText': string;
+    'attachment.pdfAsPagedRead': string;
+    'attachment.pdfRefused': string;
+    'attachment.pdfNoExtractor': string;
+    'attachment.textTooLong': string;
     'composer.dictate': string;
     'composer.dictate.stop': string;
     'composer.dictate.recording': string;
@@ -2216,6 +2565,7 @@ declare const useT: () => TranslateFn<{
     'tool.status.completed': string;
     'tool.status.failed': string;
     'tool.status.denied': string;
+    'tool.vision.progress': string;
     'tool.duration': string;
     'tool.args': string;
     'tool.denied.reason': string;
@@ -2262,6 +2612,7 @@ declare const useT: () => TranslateFn<{
     'todo.status.inProgress': string;
     'todo.status.completed': string;
     'todo.delegatedTo': string;
+    'todo.dismiss': string;
     'interaction.ask.title': string;
     'interaction.confirm.title': string;
     'interaction.form.title': string;
@@ -2283,6 +2634,8 @@ declare const useT: () => TranslateFn<{
     'interaction.pageAction.attach': string;
     'interaction.pageAction.scroll.down': string;
     'interaction.pageAction.scroll.up': string;
+    'interaction.pageAction.hover': string;
+    'interaction.pageAction.drag': string;
     'interaction.pageAction.back': string;
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
@@ -2291,6 +2644,8 @@ declare const useT: () => TranslateFn<{
     'interaction.pageAction.role.set': string;
     'interaction.pageAction.role.attach': string;
     'interaction.pageAction.role.scroll': string;
+    'interaction.pageAction.role.hover': string;
+    'interaction.pageAction.role.drag': string;
     'interaction.pageAction.role.back': string;
     'interaction.pageAction.remember': string;
     'interaction.pageAction.frame': string;
@@ -2299,6 +2654,30 @@ declare const useT: () => TranslateFn<{
     'interaction.downloadedFile.read': string;
     'interaction.downloadedFile.file': string;
     'interaction.downloadedFile.remember': string;
+    'interaction.webOffice.listTitle': string;
+    'interaction.webOffice.listBody': string;
+    'interaction.webOffice.readTitle': string;
+    'interaction.webOffice.readBody': string;
+    'interaction.webOffice.captureTitle': string;
+    'interaction.webOffice.captureBody': string;
+    'interaction.webOffice.claimedTypeNote': string;
+    'interaction.webOffice.rememberFallback': string;
+    'interaction.visionDelegation.title': string;
+    'interaction.visionDelegation.reason': string;
+    'interaction.visionDelegation.endpoint': string;
+    'interaction.visionDelegation.declineNote': string;
+    'interaction.visionDelegation.rememberFallback': string;
+    'interaction.visionDelegation.rememberSession': string;
+    'interaction.visionDelegation.body': string;
+    'interaction.imageSource.title': string;
+    'interaction.imageSource.pageImageBody': string;
+    'interaction.imageSource.remoteImageBody': string;
+    'interaction.imageSource.remoteImageAnyBody': string;
+    'interaction.imageSource.insecure': string;
+    'interaction.imageSource.note': string;
+    'interaction.imageSource.rememberFallback': string;
+    'interaction.imageSource.rememberPageImage': string;
+    'interaction.imageSource.rememberRemoteImage': string;
     'interaction.uploadFile.read': string;
     'interaction.uploadFile.file': string;
     'interaction.sandbox.readReference': string;
@@ -2364,6 +2743,7 @@ declare const useT: () => TranslateFn<{
     'composer.attachment.kind.image': string;
     'composer.attachment.kind.file': string;
     'composer.attachment.kind.document-text': string;
+    'composer.attachment.kind.binary': string;
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.unconfigured': string;
@@ -2375,6 +2755,13 @@ declare const useT: () => TranslateFn<{
     'composer.addAttachment.imagesOff': string;
     'composer.addAttachment.modelNoImages': string;
     'attachment.imagesDropped': string;
+    'attachment.storeFailed.title': string;
+    'attachment.storeFailed': string;
+    'attachment.pdfAsText': string;
+    'attachment.pdfAsPagedRead': string;
+    'attachment.pdfRefused': string;
+    'attachment.pdfNoExtractor': string;
+    'attachment.textTooLong': string;
     'composer.dictate': string;
     'composer.dictate.stop': string;
     'composer.dictate.recording': string;
@@ -2821,6 +3208,6 @@ declare function ErrorCard({ code, message, loopLimits, onOpenSettings, onDismis
  * Version of the published `@webskill/chatbot` package, injected at build time.
  * @stable
  */
-declare const CHATBOT_VERSION = "0.17.0";
+declare const CHATBOT_VERSION = "0.19.0";
 //#endregion
-export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, CHATBOT_VERSION, type ChatAttachmentInput, type ChatAttachmentMeta, type ChatContentPart, ChatEngine, type ChatEngineOptions, type ChatEvent, type ChatInteractionRecord, type ChatLayout, type ChatMessage, type ChatRunPhase, type ChatSessionListResult, type ChatSessionMeta, type ChatTheme, type ChatThinking, type ChatTokenUsage, type ChatToolCall, Chatbot, type ChatbotConfig, type ChatbotGovernancePorts, type ChatbotHostAdapter, type ChatbotProps, CompositeUiBridge, type CompositeUiBridgeDeps, DEFAULT_RENDERER_CAPABILITIES, DEFAULT_RUNTIME_CONFIG_STORAGE_KEY, type DownloadableFile, ErrorCard, type ErrorCardProps, InteractionCard, type InteractionCardProps, InterruptedBanner, type InterruptedBannerProps, type Locale, type LocalizedText, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type QuickPrompt, type QuickPromptIconName, type RendererCapability, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type RuntimeAppearanceConfig, type RuntimeConfig, type RuntimeConfigStore, type RuntimeQuickPrompt, type RuntimeRendererId, type SandboxExecutorDeps, type SettingsSectionId, SkillBadges, SpecInteraction, type SpecInteractionProps, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, isLlmEntryUsable, pickUsableLlmEntry, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };
+export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, CHATBOT_VERSION, type ChatAttachmentInput, type ChatAttachmentMeta, type ChatContentPart, ChatEngine, type ChatEngineOptions, type ChatEvent, type ChatInteractionRecord, type ChatLayout, type ChatMessage, type ChatRunPhase, type ChatSessionListResult, type ChatSessionMeta, type ChatTheme, type ChatThinking, type ChatTokenUsage, type ChatToolCall, Chatbot, type ChatbotConfig, type ChatbotGovernancePorts, type ChatbotHostAdapter, type ChatbotProps, ChatbotVisionDelegate, type ChatbotVisionDelegateOptions, CompositeUiBridge, type CompositeUiBridgeDeps, DEFAULT_RENDERER_CAPABILITIES, DEFAULT_RUNTIME_CONFIG_STORAGE_KEY, type DownloadableFile, type DwgHost, ErrorCard, type ErrorCardProps, InteractionCard, type InteractionCardProps, InterruptedBanner, type InterruptedBannerProps, type Locale, type LocalizedText, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type QuickPrompt, type QuickPromptIconName, type RendererCapability, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type RuntimeAppearanceConfig, type RuntimeConfig, type RuntimeConfigStore, type RuntimeQuickPrompt, type RuntimeRendererId, type SandboxExecutorDeps, type SettingsSectionId, SkillBadges, SpecInteraction, type SpecInteractionProps, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, type VisionDelegationConsent, type VisionDelegationEndpoint, WEB_OFFICE_TEMPLATE_PREFIX, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, isLlmEntryUsable, pickUsableLlmEntry, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };