@webskill/sdk 0.20.0 → 0.22.0

package/dist/treeView-Q6P3EWNA-C1by-Gzc.js

@@ -0,0 +1,4 @@
+import "./chunk-FOHPRMQF-Dkbp819z.js";
+import { c as createTreeViewServices, s as TreeViewModule } from "./mermaid-parser.core-pYR5siSx.js";
+
+export { createTreeViewServices };

package/dist/treemap-WGGIJYW6-mC2NZ6ad.js

@@ -0,0 +1,4 @@
+import "./chunk-FOHPRMQF-Dkbp819z.js";
+import { a as TreemapModule, o as createTreemapServices } from "./mermaid-parser.core-pYR5siSx.js";
+
+export { createTreemapServices };

package/dist/{types-Btpdd1y--BcxQ10Fa.d.ts → types-CpDRZ0rA-BM5FI9oN.d.ts}

@@ -28,6 +28,24 @@ type WebSkillErrorCode = 'FS_NOT_FOUND' | 'FS_PATH_OUTSIDE_ROOT' | 'SKILL_NOT_FO
 'UPLOAD_FILE_NOT_FOUND' |
 /** 上传文件超预算。与 DATA_SOURCE_TOO_LARGE 同口径：拒绝而不截断 */
 'UPLOAD_FILE_TOO_LARGE' |
+/** 页面上没有可读的 WebOffice 实例，或指定的 handle 已失效（0.21.0 分册 11） */
+'WEBOFFICE_UNAVAILABLE' |
+/** 认出来的不是我们支持的 WebOffice SDK 版本；不降级去猜（0.21.0 FR-11.6b） */
+'WEBOFFICE_UNSUPPORTED_VERSION' |
+/** `api.ready` 描述符里没有这个方法。与「调用失败」分开：用户的下一步不同 */
+'WEBOFFICE_CAPABILITY_ABSENT' | 'WEBOFFICE_CALL_FAILED' | 'WEBOFFICE_CALL_TIMEOUT' |
+/** 0.22.0 分册 42：模板不是 xlsx / docx，或包内某个部件不是合法 XML */
+'TEMPLATE_UNSUPPORTED' |
+/** 地址语法不合法（`A0`、缺列号），与「语法对但模板里没有」分开：模型的下一步不同 */
+'TEMPLATE_ADDRESS_INVALID' |
+/** 地址语法合法，但模板里没有该工作表 / 表格 / 行 / 列（FR-42.6，不得静默丢弃） */
+'TEMPLATE_TARGET_MISSING' |
+/** 图片引用解析不到 */
+'TEMPLATE_IMAGE_UNRESOLVED' |
+/** 插行位置落在表头之前或文件末尾之后 */
+'TEMPLATE_ROW_INSERT_RANGE' |
+/** 目标格由模板的公式算出，写值会把它摧毁（FR-42.28） */
+'TEMPLATE_CELL_IS_FORMULA' |
 /** 用户拒绝了这次工具调用（0.14.0 分册 20） */
 'TOOL_DENIED';
 /**
@@ -189,6 +207,20 @@ interface FileStat {
   size?: number;
   mtimeMs?: number;
 }
+/**
+ * 分块写入的句柄（0.21.0 分册 18 · FR-18.2）。
+ *
+ * 语义与 `writeBinary` 对齐：`close()` 之前这份内容不得被当成完整文件读到；
+ * 中途失败调 `abort()`，实现必须保证不留下会被误当成完整文件的残件（FR-18.2e）。
+ */
+interface FileWriteStream {
+  /** 追加一块。`close()`/`abort()` 之后再调即为错误。 */
+  write(chunk: Uint8Array): Promise<void>;
+  /** 提交。此后文件才对 `readBinary` / `exists` 可见为完整内容。 */
+  close(): Promise<void>;
+  /** 放弃。已写入的部分必须被丢弃。 */
+  abort(): Promise<void>;
+}
 /**
  * 文件系统抽象：core 只依赖此接口，Node/浏览器各自提供实现。
  * 路径一律使用 `/` 分隔的 POSIX 风格。
@@ -201,6 +233,14 @@ interface FileSystemProvider {
   appendText(path: string, content: string): Promise<void>;
   readBinary(path: string): Promise<Uint8Array>;
   writeBinary(path: string, content: Uint8Array): Promise<void>;
+  /**
+   * 可选：分块写入，避免整份文件进内存（0.21.0 分册 18 · FR-18.2）。
+   *
+   * **必须是可选的**：`FileSystemProvider` 有宿主自己的实现，加必选成员等于让它们
+   * 一夜之间不满足接口。缺省时调用方回落到 `writeBinary`——功能不降级，
+   * 只是内存峰值回到全量读取的水平（FR-18.2b）。
+   */
+  createWriteStream?(path: string): Promise<FileWriteStream>;
   exists(path: string): Promise<boolean>;
   stat(path: string): Promise<FileStat>;
   list(path: string): Promise<FileStat[]>;
@@ -345,6 +385,11 @@ declare class MemoryFS implements FileSystemProvider {
   appendText(path: string, content: string): Promise<void>;
   readBinary(path: string): Promise<Uint8Array>;
   writeBinary(path: string, content: Uint8Array): Promise<void>;
+  /**
+   * 分块写入（FR-18.2c）。内存实现只能先攒着，`close()` 时才合并落表——
+   * 这样中途 `abort()` 或抛错都不会在表里留下半份内容（FR-18.2e）。
+   */
+  createWriteStream(path: string): Promise<FileWriteStream>;
   exists(path: string): Promise<boolean>;
   stat(path: string): Promise<FileStat>;
   list(path: string): Promise<FileStat[]>;
@@ -440,8 +485,14 @@ interface UiSpecNode {
  * 产出同一份文本（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';
 /** 可作为图片分片外发的 MIME 类型 @experimental */
 declare const IMAGE_MIME_TYPES: readonly ["image/png", "image/jpeg", "image/webp", "image/gif"];
 /**
@@ -452,15 +503,34 @@ declare const TEXT_EXTENSIONS: readonly ["txt", "md", "csv", "json", "log", "yam
 /** 非文本非图片但仍可整体外发的类型（provider 的 file 分片） @experimental */
 declare const FILE_MIME_TYPES: readonly ["application/pdf"];
 /**
- * 需要**客户端先抽取成文本**才能外发的类型（FR-23.9 / 0.13.0 FR-12.5）。
- * 不走直通的 `file`：docx / xlsx 发给 provider 会被当成二进制垃圾。
+ * 需要**客户端先抽取成文本**才能外发的类型（FR-23.9 / 0.13.0 FR-12.5 / 0.22.0 分册 18）。
+ * 不走直通的 `file`：docx / xlsx / pptx 发给 provider 会被当成二进制垃圾。
  */
 declare const DOCX_MIME = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
 declare const XLSX_MIME = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+declare const PPTX_MIME = "application/vnd.openxmlformats-officedocument.presentationml.presentation";
 /** 文本类附件进模型上下文的字符上限（0.6.0） @experimental */
 declare const ATTACHMENT_TEXT_LIMIT: number;
-/** 分类集中一处，不散落在各 UI 分支里 @experimental */
-declare function classifyAttachment(contentType: string, fileName: string): ChatAttachmentKind | undefined;
+/**
+ * DWG 图纸的 MIME。没有官方注册值，各家各发一套，浏览器上传时更常见的是空串。
+ * @experimental
+ */
+declare const DWG_MIME_TYPES: readonly ["image/vnd.dwg", "application/acad", "application/x-acad", "application/dwg", "application/x-dwg", "drawing/dwg"];
+/**
+ * 只存字节、不进上下文的扩展名。仍然是**白名单制**：
+ * 新增 `binary` 类别不等于任意二进制放行（AC-19.18）。
+ * @experimental
+ */
+declare const BINARY_EXTENSIONS: readonly ["dwg"];
+/** `document-text` 里的具体格式 @experimental */
+type ExtractedDocumentFormat = 'docx' | 'xlsx' | 'pptx';
+/**
+ * 三种待抽取格式共用 `document-text` 这一种 kind，选抽取器时要按格式再分一次。
+ * 下载列表与上传入口必须得出同一结论（AC-20.17），所以只能在这里一份。
+ * @experimental
+ */
+declare function extractedDocumentFormat(contentType: string, fileName: string): ExtractedDocumentFormat;
+/** 分类集中一处，不散落在各 UI 分支里 @experimental */ declare function classifyAttachment(contentType: string, fileName: string): ChatAttachmentKind | undefined;
 /** `formatAttachmentText` 的入参 @experimental */
 interface AttachmentTextInput {
   name: string;
@@ -469,6 +539,12 @@ interface AttachmentTextInput {
   kind: 'text' | 'document-text';
   /** 缺省即用户当场上传；`'download'` 时标签里额外标出本机下载目录（0.14.0 FR-20.5） */
   origin?: 'upload' | 'download';
+  /**
+   * 正文截断的字符上限，缺省 `ATTACHMENT_TEXT_LIMIT`。
+   * 调用方自己有预算、且**按预算拒绝而不是截断**时传自己的值——
+   * 不传就会被这里 32 KiB 的兜底静默切掉，长文档看起来完整、实则只剩开头。
+   */
+  limit?: number;
 }
 /**
  * 文本类附件进模型上下文的最终形态。两条入口共用，差别只有出处那一段（0.14.0 D-20-6）。
@@ -716,7 +792,7 @@ declare function escapeXml(text: string): string;
 declare function renderAvailableSkillsXml(catalog: SkillCatalog): string;
 declare const xmlRenderer: CatalogRenderer;
 //#endregion
-//#region ../runtime/dist/types-Btpdd1y-.d.ts
+//#region ../runtime/dist/types-CpDRZ0rA.d.ts
 //#region src/llm/streamTypes.d.ts
 /** 流式 LLM 事件（OpenAI SSE / Vercel fullStream 统一映射） */
 type LlmStreamEvent = {
@@ -854,6 +930,13 @@ interface ArtifactStore {
     metadata?: Record<string, unknown>;
   }): Promise<Artifact>;
   listArtifacts(runId: string): Promise<Artifact[]>;
+  /**
+   * 读回本 run 内一份产物的字节（0.22.0 分册 20 FR-20.8）。
+   *
+   * 可选：外部自定义 store 不实现也不算坏契约，只是脚本那边的 `artifact:` 图片引用
+   * 解析不到，按 FR-20.9 逐张归因拒绝——而不是悄悄产出一份缺图的表。
+   */
+  readArtifact?(runId: string, path: string): Promise<Uint8Array>;
 }
 //#endregion
 //#region src/skillGeneration/candidateMarker.d.ts
@@ -941,7 +1024,26 @@ type InteractionRequest = {
   /** 读取本机下载目录（0.14.0 分册 20） */
   'readDownloadedFile' |
   /** 读取本轮上传的文件（0.15.0 分册 17；0.17.0 分册 19 从 `confirm` 改到这里） */
-  'readUploadFile';
+  'readUploadFile' |
+  /**
+   * 读取页面里嵌的 WPS WebOffice 文档（0.21.0 分册 13）。
+   * 只有一个字面量，三种动作（列出 / 读取 / 截屏）靠 `details.action` 分——
+   * 分成三个能力会让宿主的能力开关变成三个，而用户心里它是一件事。
+   */
+  'readWebOfficeDocument' |
+  /**
+   * 把一张图放进将要产出的文档里（0.22.0 分册 11 §3.3 / 分册 12 FR-12.5）。
+   * 页面取像与外链抓取**共用一个能力名**，靠 `details.kind` 区分——
+   * 两个字面量会让宿主的允许清单变成两条各自可漏的判断（同 `readWebOfficeDocument`）。
+   * 上传图不在其中：`readUploadFile` 已经是每次都问（FR-11.11）。
+   */
+  'readImageSource' |
+  /**
+   * 把工具产出的图交给第二个模型端点认（0.21.0 分册 17）。
+   * 这是一次**数据出境**：用户选 A 家模型时并没有同意发给 B 家，
+   * 所以它必须是一个独立能力位，而不是并进任何一个「读」的授权里。
+   */
+  'delegateVision';
   message: string;
   /**
    * 结构化载荷。`message` 是无字典层的英文兜底，持有字典的宿主据本字段重写正文
@@ -1159,4 +1261,4 @@ interface MemoryStore {
   transaction?<T>(scope: string, fn: (inner: MemoryStore) => Promise<T>): Promise<T>;
 }
 //#endregion
-export { SKILLS_LOCKFILE as $, messageOf as $t, extractSkillCandidate as A, ValidationReport as At, DiscoveryResult as B, checkDependencyCycles as Bt, UiSpecActionCapability as C, SkillsLockfile as Ct, UiSpecSnapshot as D, UNTRUSTED_LINE_LIMIT as Dt, UiSpecPatch as E, TrustedKeyStore as Et, CatalogRenderer as F, assertRemoteUrlAllowed as Ft, IMAGE_MIME_TYPES as G, detectSkillArchiveShapeFromFs as Gt, FileStat as H, classifyAttachment as Ht, ChatAttachmentKind as I, assertSafePathSegment as It, MemoryFS as J, formatAttachmentText as Jt, JsonSchema as K, escapeXml as Kt, CryptoKeyLike as L, atomicWriteText as Lt, ATTACHMENT_TEXT_LIMIT as M, WebSkillError as Mt, ArchiveLimits as N, WebSkillErrorCode as Nt, UiSurfaceActionRequest as O, UiSpecNode as Ot, AttachmentTextInput as P, XLSX_MIME as Pt, SIGNATURE_SCHEMA_VERSION as Q, keyIdOf as Qt, DEFAULT_ARCHIVE_LIMITS as R, buildCatalog as Rt, UiBridge as S, SkillSource as St, UiSpecEvent as T, TrustedKey as Tt, FileSystemProvider as U, computeDigest as Ut, FILE_MIME_TYPES as V, checkSkillRules as Vt, FsTrustedKeyStore as W, detectSkillArchiveShape as Wt, PageQuery as X, isValidSkillName as Xt, Page as Y, isAtomicTempPath as Yt, RemoteUrlPolicy as Z, jsonRenderer as Zt, LlmToolSpec as _, xmlRenderer as _n, SkillManifest as _t, InteractionOrigin as a, renderAvailableSkillsXml as an, SignatureAuditSink as at, RenderResultRequest as b, SkillReader as bt, InteractionResponse as c, resolveInsideRoot as cn, SkillArchiveShape as ct, LlmContentPart as d, signaturePayloadBytes as dn, SkillDiscovery as dt, normalizePath as en, SKILL_MANIFEST_FILE as et, LlmMessage as f, stripArchiveRoot as fn, SkillDocument as ft, LlmToolCall as g, verifySkillSignature as gn, SkillManagerPort as gt, LlmTokenUsage as h, verifyManifest as hn, SkillLocation as ht, FormField as i, readSkillSignature as in, SKILL_SIGNATURE_FILE as it, ATOMIC_TMP_SUFFIX_PATTERN as j, VerifyResult as jt, UiSurfaceActionResponse as k, UnsignedPolicy as kt, LlmClient as l, sanitizeUntrustedLine as ln, SkillCatalog as lt, LlmStreamEvent as m, validateSkills as mn, SkillIssue as mt, ArtifactStore as n, parseSkillPackManifest as nn, SKILL_NAME_PATTERN as nt, InteractionPolicy as o, renderCatalogJson as on, SignatureVerdict as ot, LlmResponse as p, unzipWithLimits as pn, SkillInstallSource as pt, MANIFEST_EXCLUDED_FILES as q, exportSkills as qt, ChartSpec as r, readResponseWithLimit as rn, SKILL_PACK_FILE as rt, InteractionRequest as s, resolveArchiveLimits as sn, SkillArchiveDetection as st, Artifact as t, parseSkillMarkdown as tn, SKILL_NAME_MAX_LENGTH as tt, LlmCompleteInput as u, signSkill as un, SkillCatalogEntry as ut, MemoryStore as v, SkillMetadata as vt, UiSpecDrafts as w, TEXT_EXTENSIONS as wt, SkillCandidateMarker as x, SkillSignature as xt, RenderBlock as y, SkillPackManifest as yt, DOCX_MIME as z, buildManifest as zt };
+export { PPTX_MIME as $, extractedDocumentFormat as $t, extractSkillCandidate as A, TrustedKey as At, DOCX_MIME as B, assertRemoteUrlAllowed as Bt, UiSpecActionCapability as C, xmlRenderer as Cn, SkillMetadata as Ct, UiSpecSnapshot as D, SkillSource as Dt, UiSpecPatch as E, SkillSignature as Et, BINARY_EXTENSIONS as F, ValidationReport as Ft, FileStat as G, checkDependencyCycles as Gt, DiscoveryResult as H, atomicWriteText as Ht, CatalogRenderer as I, VerifyResult as It, FsTrustedKeyStore as J, computeDigest as Jt, FileSystemProvider as K, checkSkillRules as Kt, ChatAttachmentKind as L, WebSkillError as Lt, ATTACHMENT_TEXT_LIMIT as M, UNTRUSTED_LINE_LIMIT as Mt, ArchiveLimits as N, UiSpecNode as Nt, UiSurfaceActionRequest as O, SkillsLockfile as Ot, AttachmentTextInput as P, UnsignedPolicy as Pt, MemoryFS as Q, exportSkills as Qt, CryptoKeyLike as R, WebSkillErrorCode as Rt, UiBridge as S, verifySkillSignature as Sn, SkillManifest as St, UiSpecEvent as T, SkillReader as Tt, ExtractedDocumentFormat as U, buildCatalog as Ut, DWG_MIME_TYPES as V, assertSafePathSegment as Vt, FILE_MIME_TYPES as W, buildManifest as Wt, JsonSchema as X, detectSkillArchiveShapeFromFs as Xt, IMAGE_MIME_TYPES as Y, detectSkillArchiveShape as Yt, MANIFEST_EXCLUDED_FILES as Z, escapeXml as Zt, LlmToolSpec as _, signaturePayloadBytes as _n, SkillDocument as _t, InteractionOrigin as a, messageOf as an, SKILL_MANIFEST_FILE as at, RenderResultRequest as b, validateSkills as bn, SkillLocation as bt, InteractionResponse as c, parseSkillPackManifest as cn, SKILL_PACK_FILE as ct, LlmContentPart as d, renderAvailableSkillsXml as dn, SignatureVerdict as dt, formatAttachmentText as en, Page as et, LlmMessage as f, renderCatalogJson as fn, SkillArchiveDetection as ft, LlmToolCall as g, signSkill as gn, SkillDiscovery as gt, LlmTokenUsage as h, sanitizeUntrustedLine as hn, SkillCatalogEntry as ht, FormField as i, keyIdOf as in, SKILLS_LOCKFILE as it, ATOMIC_TMP_SUFFIX_PATTERN as j, TrustedKeyStore as jt, UiSurfaceActionResponse as k, TEXT_EXTENSIONS as kt, LlmClient as l, readResponseWithLimit as ln, SKILL_SIGNATURE_FILE as lt, LlmStreamEvent as m, resolveInsideRoot as mn, SkillCatalog as mt, ArtifactStore as n, isValidSkillName as nn, RemoteUrlPolicy as nt, InteractionPolicy as o, normalizePath as on, SKILL_NAME_MAX_LENGTH as ot, LlmResponse as p, resolveArchiveLimits as pn, SkillArchiveShape as pt, FileWriteStream as q, classifyAttachment as qt, ChartSpec as r, jsonRenderer as rn, SIGNATURE_SCHEMA_VERSION as rt, InteractionRequest as s, parseSkillMarkdown as sn, SKILL_NAME_PATTERN as st, Artifact as t, isAtomicTempPath as tn, PageQuery as tt, LlmCompleteInput as u, readSkillSignature as un, SignatureAuditSink as ut, MemoryStore as v, stripArchiveRoot as vn, SkillInstallSource as vt, UiSpecDrafts as w, SkillPackManifest as wt, SkillCandidateMarker as x, verifyManifest as xn, SkillManagerPort as xt, RenderBlock as y, unzipWithLimits as yn, SkillIssue as yt, DEFAULT_ARCHIVE_LIMITS as z, XLSX_MIME as zt };

package/dist/ui-react.d.ts

@@ -1,6 +1,6 @@
-import { C as UiSpecActionCapability, D as UiSpecSnapshot, O as UiSurfaceActionRequest, Ot as UiSpecNode, S as UiBridge, T as UiSpecEvent, b as RenderResultRequest, c as InteractionResponse, k as UiSurfaceActionResponse, s as InteractionRequest, w as UiSpecDrafts } from "./types-Btpdd1y--BcxQ10Fa.js";
-import { N as DocumentSurfacePort } from "./index-BDyXe-a5.js";
-import { F as InteractionSpecLabels, J as SurfaceFormTexts, Y as SurfaceHostControlTexts, v as ChartFontSizes } from "./index-ad11wflI.js";
+import { C as UiSpecActionCapability, D as UiSpecSnapshot, Nt as UiSpecNode, O as UiSurfaceActionRequest, S as UiBridge, T as UiSpecEvent, b as RenderResultRequest, c as InteractionResponse, k as UiSurfaceActionResponse, s as InteractionRequest, w as UiSpecDrafts } from "./types-CpDRZ0rA-BM5FI9oN.js";
+import { P as DocumentSurfacePort } from "./index-YPd8ZSEa.js";
+import { F as InteractionSpecLabels, J as SurfaceFormTexts, Y as SurfaceHostControlTexts, v as ChartFontSizes } from "./index-BiO9_XRk.js";
 import { z } from "zod";
 import React$1, { ComponentType, ReactNode } from "react";
 import "react/jsx-runtime";