@webskill/sdk 0.21.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-BvTV_05--BW8zDuEk.d.ts → types-CpDRZ0rA-BM5FI9oN.d.ts}

@@ -34,6 +34,18 @@ type WebSkillErrorCode = 'FS_NOT_FOUND' | 'FS_PATH_OUTSIDE_ROOT' | 'SKILL_NOT_FO
 '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';
 /**
@@ -473,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"];
 /**
@@ -485,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;
@@ -755,7 +792,7 @@ declare function escapeXml(text: string): string;
 declare function renderAvailableSkillsXml(catalog: SkillCatalog): string;
 declare const xmlRenderer: CatalogRenderer;
 //#endregion
-//#region ../runtime/dist/types-BvTV_05-.d.ts
+//#region ../runtime/dist/types-CpDRZ0rA.d.ts
 //#region src/llm/streamTypes.d.ts
 /** 流式 LLM 事件（OpenAI SSE / Vercel fullStream 统一映射） */
 type LlmStreamEvent = {
@@ -893,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
@@ -987,6 +1031,13 @@ type InteractionRequest = {
    * 分成三个能力会让宿主的能力开关变成三个，而用户心里它是一件事。
    */
   '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 家，
@@ -1210,4 +1261,4 @@ interface MemoryStore {
   transaction?<T>(scope: string, fn: (inner: MemoryStore) => Promise<T>): Promise<T>;
 }
 //#endregion
-export { SIGNATURE_SCHEMA_VERSION as $, keyIdOf as $t, extractSkillCandidate as A, UnsignedPolicy as At, DiscoveryResult as B, buildManifest as Bt, UiSpecActionCapability as C, SkillSource as Ct, UiSpecSnapshot as D, TrustedKeyStore as Dt, UiSpecPatch as E, TrustedKey as Et, CatalogRenderer as F, XLSX_MIME as Ft, FsTrustedKeyStore as G, detectSkillArchiveShape as Gt, FileStat as H, checkSkillRules as Ht, ChatAttachmentKind as I, assertRemoteUrlAllowed as It, MANIFEST_EXCLUDED_FILES as J, exportSkills as Jt, IMAGE_MIME_TYPES as K, detectSkillArchiveShapeFromFs as Kt, CryptoKeyLike as L, assertSafePathSegment as Lt, ATTACHMENT_TEXT_LIMIT as M, VerifyResult as Mt, ArchiveLimits as N, WebSkillError as Nt, UiSurfaceActionRequest as O, UNTRUSTED_LINE_LIMIT as Ot, AttachmentTextInput as P, WebSkillErrorCode as Pt, RemoteUrlPolicy as Q, jsonRenderer as Qt, DEFAULT_ARCHIVE_LIMITS as R, atomicWriteText as Rt, UiBridge as S, SkillSignature as St, UiSpecEvent as T, TEXT_EXTENSIONS as Tt, FileSystemProvider as U, classifyAttachment as Ut, FILE_MIME_TYPES as V, checkDependencyCycles as Vt, FileWriteStream as W, computeDigest as Wt, Page as X, isAtomicTempPath as Xt, MemoryFS as Y, formatAttachmentText as Yt, PageQuery as Z, isValidSkillName as Zt, LlmToolSpec as _, verifySkillSignature as _n, SkillManagerPort as _t, InteractionOrigin as a, readSkillSignature as an, SKILL_SIGNATURE_FILE as at, RenderResultRequest as b, SkillPackManifest as bt, InteractionResponse as c, resolveArchiveLimits as cn, SkillArchiveDetection as ct, LlmContentPart as d, signSkill as dn, SkillCatalogEntry as dt, messageOf as en, SKILLS_LOCKFILE as et, LlmMessage as f, signaturePayloadBytes as fn, SkillDiscovery as ft, LlmToolCall as g, verifyManifest as gn, SkillLocation as gt, LlmTokenUsage as h, validateSkills as hn, SkillIssue as ht, FormField as i, readResponseWithLimit as in, SKILL_PACK_FILE as it, ATOMIC_TMP_SUFFIX_PATTERN as j, ValidationReport as jt, UiSurfaceActionResponse as k, UiSpecNode as kt, LlmClient as l, resolveInsideRoot as ln, SkillArchiveShape as lt, LlmStreamEvent as m, unzipWithLimits as mn, SkillInstallSource as mt, ArtifactStore as n, parseSkillMarkdown as nn, SKILL_NAME_MAX_LENGTH as nt, InteractionPolicy as o, renderAvailableSkillsXml as on, SignatureAuditSink as ot, LlmResponse as p, stripArchiveRoot as pn, SkillDocument as pt, JsonSchema as q, escapeXml as qt, ChartSpec as r, parseSkillPackManifest as rn, SKILL_NAME_PATTERN as rt, InteractionRequest as s, renderCatalogJson as sn, SignatureVerdict as st, Artifact as t, normalizePath as tn, SKILL_MANIFEST_FILE as tt, LlmCompleteInput as u, sanitizeUntrustedLine as un, SkillCatalog as ut, MemoryStore as v, xmlRenderer as vn, SkillManifest as vt, UiSpecDrafts as w, SkillsLockfile as wt, SkillCandidateMarker as x, SkillReader as xt, RenderBlock as y, SkillMetadata as yt, DOCX_MIME as z, buildCatalog 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, S as UiBridge, T as UiSpecEvent, b as RenderResultRequest, c as InteractionResponse, k as UiSurfaceActionResponse, kt as UiSpecNode, s as InteractionRequest, w as UiSpecDrafts } from "./types-BvTV_05--BW8zDuEk.js";
-import { N as DocumentSurfacePort } from "./index-DHopiH_m.js";
-import { F as InteractionSpecLabels, J as SurfaceFormTexts, Y as SurfaceHostControlTexts, v as ChartFontSizes } from "./index-B8Tgmpwh.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";