@webskill/sdk 0.0.6 → 0.1.0

package/dist/types-CgNC-oQu-DCklnS0h.d.ts

@@ -0,0 +1,539 @@
+//#region ../core/dist/index.d.ts
+//#region src/errors.d.ts
+type WebSkillErrorCode = 'FS_NOT_FOUND' | 'FS_PATH_OUTSIDE_ROOT' | 'SKILL_NOT_FOUND' | 'SKILL_INVALID_METADATA' | 'SKILL_INVALID_NAME' | 'SKILL_DUPLICATE_NAME' | 'SKILL_UNSUPPORTED_SCRIPT' | 'VALIDATION_FAILED' | 'TOOL_NOT_FOUND' | 'TOOL_EXECUTION_FAILED' | 'NETWORK_BLOCKED' | 'TOOL_UNSUPPORTED' | 'TOOL_SCHEMA_UNAVAILABLE' | 'RUN_TIMEOUT' | 'RUN_MAX_TURNS_EXCEEDED' | 'RUN_FAILED' | 'RUN_CANCELLED' | 'RUN_INTERACTION_TIMEOUT' | 'UI_UNAVAILABLE' | 'LLM_UNAVAILABLE' | 'LLM_REQUEST_FAILED' | 'INSTALL_FAILED' | 'UNINSTALL_FAILED' | 'EXPORT_FAILED' | 'INTEGRITY_FAILED' | 'FS_PERMISSION_DENIED' | 'MCP_ENDPOINT_UNAVAILABLE' | 'MCP_TOOL_NOT_FOUND' | 'CANDIDATE_INVALID' | 'APPROVAL_REQUIRED' | 'SKILL_QUARANTINED' | 'SKILL_DISABLED' | 'GOVERNANCE_FAILED' | 'RUN_SNAPSHOT_NOT_FOUND' | 'RUN_SNAPSHOT_EXPIRED' | 'RUN_SNAPSHOT_INCOMPATIBLE';
+/**
+ * 所有公开 API 抛出的结构化错误，code 供上层可编程处理
+ * @stable
+ */
+declare class WebSkillError extends Error {
+  readonly code: WebSkillErrorCode;
+  readonly details?: unknown;
+  constructor(code: WebSkillErrorCode, message: string, details?: unknown);
+}
+//#endregion
+//#region src/contracts/jsonSchema.d.ts
+/**
+ * 宽松 JSON Schema：覆盖工具 inputSchema 的常见字段，
+ * 索引签名允许透传规范内的其他关键字。供 tools 与后续 UI 复用。
+ */
+interface JsonSchema {
+  type?: string;
+  properties?: Record<string, JsonSchema>;
+  required?: string[];
+  items?: JsonSchema;
+  enum?: unknown[];
+  description?: string;
+  default?: unknown;
+  [key: string]: unknown;
+}
+//#endregion
+//#region src/skill/manifest.d.ts
+type SkillInstallSource = {
+  type: 'local';
+  path: string;
+} | {
+  type: 'http';
+  url: string;
+} | {
+  type: 'archive';
+  data: ArrayBuffer;
+} | {
+  type: 'git';
+  url: string;
+  ref?: string;
+  commit?: string;
+} | {
+  type: 'npm';
+  packageName: string;
+  version?: string;
+};
+/** @stable */
+interface SkillManifest {
+  schemaVersion: 1;
+  name: string;
+  version?: string;
+  source: SkillInstallSource;
+  installedAt: string;
+  integrity: {
+    algorithm: 'sha256';
+    digest: string;
+  };
+  files: Array<{
+    path: string;
+    size: number;
+    sha256: string;
+  }>;
+}
+interface SkillsLockfile {
+  schemaVersion: 1;
+  skills: Record<string, {
+    digest: string;
+    installedAt: string;
+    source: SkillInstallSource;
+  }>;
+}
+interface VerifyResult {
+  ok: boolean;
+  mismatches: string[];
+}
+/** 技能目录内的安装清单文件名（不参与 files 列表与 digest） */
+declare const SKILL_MANIFEST_FILE = "webskill.skill-manifest.json";
+/** managed root 下的锁定文件名（不参与 files 列表与 digest） */
+declare const SKILLS_LOCKFILE = "skills.lock.json";
+type Sha256Fn = (data: Uint8Array | string) => string | Promise<string>;
+/** 整体 digest：逐文件 "<path>:<sha256>\n" 拼接串（文件按 path 排序）的 sha256（hash 由调用方提供，可为 WebCrypto 异步实现） */
+declare function computeDigest(files: Array<{
+  path: string;
+  sha256: string;
+}>, sha256: Sha256Fn): Promise<string>;
+/** 由逐文件清单构建 manifest（digest 由 computeDigest 计算） */
+declare function buildManifest(input: {
+  name: string;
+  version?: string;
+  source: SkillInstallSource;
+  installedAt: string;
+  files: SkillManifest['files'];
+  sha256: Sha256Fn;
+}): Promise<SkillManifest>;
+/** 按 manifest.files 比对实际 hash（调用方负责计算 actualHashes） */
+declare function verifyManifest(manifest: SkillManifest, actualHashes: Map<string, string>): VerifyResult;
+//#endregion
+//#region src/fs/types.d.ts
+interface FileStat {
+  path: string;
+  type: 'file' | 'directory';
+  size?: number;
+  mtimeMs?: number;
+}
+/**
+ * 文件系统抽象：core 只依赖此接口，Node/浏览器各自提供实现。
+ * 路径一律使用 `/` 分隔的 POSIX 风格。
+ */
+interface FileSystemProvider {
+  readonly kind: string;
+  readText(path: string): Promise<string>;
+  writeText(path: string, content: string): Promise<void>;
+  readBinary(path: string): Promise<Uint8Array>;
+  writeBinary(path: string, content: Uint8Array): Promise<void>;
+  exists(path: string): Promise<boolean>;
+  stat(path: string): Promise<FileStat>;
+  list(path: string): Promise<FileStat[]>;
+  mkdir(path: string): Promise<void>;
+  remove(path: string, options?: {
+    recursive?: boolean;
+  }): Promise<void>;
+}
+//#endregion
+//#region src/fs/memoryFs.d.ts
+/** 内存文件系统：路径一律规范化为 `/` 分隔，写入自动创建父目录 */
+declare class MemoryFS implements FileSystemProvider {
+  #private;
+  readonly kind = "memory";
+  constructor();
+  readText(path: string): Promise<string>;
+  writeText(path: string, content: string): Promise<void>;
+  readBinary(path: string): Promise<Uint8Array>;
+  writeBinary(path: string, content: Uint8Array): Promise<void>;
+  exists(path: string): Promise<boolean>;
+  stat(path: string): Promise<FileStat>;
+  list(path: string): Promise<FileStat[]>;
+  mkdir(path: string): Promise<void>;
+  remove(path: string, options?: {
+    recursive?: boolean;
+  }): Promise<void>;
+}
+//#endregion
+//#region src/fs/pathSecurity.d.ts
+/** 统一分隔符为 `/`，去除 `.` 段与重复分隔符（不解析 `..`） */
+declare function normalizePath(path: string): string;
+/**
+ * 将相对路径安全地解析到 root 之内。
+ * 拒绝空路径、绝对路径（`/`、`\\`、`C:\` 形式）与任何 `..` 段。
+ */
+declare function resolveInsideRoot(root: string, relativePath: string): string;
+//#endregion
+//#region src/skill/types.d.ts
+type SkillSource = 'local' | 'mcp' | 'generated' | 'installed';
+/**
+ * SKILL.md frontmatter 元数据；未知字段原样透传
+ * @stable
+ */
+interface SkillMetadata {
+  name: string;
+  description: string;
+  license?: string;
+  version?: string;
+  /** 声明式依赖：精确技能名列表（无版本约束）；缺依赖/循环依赖 → error 级校验 */
+  dependencies?: string[];
+  [key: string]: unknown;
+}
+interface SkillLocation {
+  skillRoot: string;
+  skillMdPath: string;
+  source: SkillSource;
+}
+/** @stable */
+interface SkillDocument {
+  metadata: SkillMetadata;
+  body: string;
+  location: SkillLocation;
+}
+/** Catalog 条目：渐进披露第一层，只含元数据摘要与标记位 */
+interface SkillCatalogEntry {
+  name: string;
+  description: string;
+  version?: string;
+  license?: string;
+  root: string;
+  source: SkillSource;
+  hasScripts: boolean;
+  hasReferences: boolean;
+  hasAssets: boolean;
+}
+/** @stable */
+interface SkillCatalog {
+  entries: SkillCatalogEntry[];
+}
+//#endregion
+//#region src/skill/parser.d.ts
+declare function parseSkillMarkdown(raw: string): {
+  metadata: SkillMetadata;
+  body: string;
+};
+//#endregion
+//#region src/skill/naming.d.ts
+declare const SKILL_NAME_MAX_LENGTH = 64;
+/** Agent Skills 官方命名规范：小写字母/数字/连字符，不允许首尾或连续连字符 */
+declare const SKILL_NAME_PATTERN: RegExp;
+declare function isValidSkillName(name: string): boolean;
+//#endregion
+//#region src/skill/rules.d.ts
+interface SkillIssue {
+  /** 与 WebSkillErrorCode 对齐 */
+  code: string;
+  severity: 'info' | 'warning' | 'error';
+  message: string;
+  path?: string;
+}
+/**
+ * 技能合规规则的唯一实现。SkillDiscovery 与 validateSkills 都必须调用本函数，
+ * 禁止各自重复实现规则（避免两套规则漂移）。
+ */
+declare function checkSkillRules(input: {
+  dirName: string;
+  hasSkillMd: boolean;
+  metadata?: SkillMetadata;
+  parseError?: WebSkillError;
+  scriptFileNames?: string[];
+  existingNames?: Set<string>;
+  /** 全库技能名集合（两趟扫描提供）；提供时启用 dependencies 存在性校验 */
+  knownSkillNames?: Set<string>;
+}): SkillIssue[];
+/**
+ * 循环依赖检测（全量邻接表，discovery 两趟扫描第二趟调用）。
+ * 每个环只报一次（error 级，阻断进 Catalog）；自引用视为长度 1 的环。
+ */
+declare function checkDependencyCycles(adjacency: Map<string, string[]>): {
+  issues: SkillIssue[];
+  /** 处于环上的技能名（调用方将其排除出 Catalog） */
+  involved: Set<string>;
+};
+//#endregion
+//#region src/skill/skillPack.d.ts
+/**
+ * 技能包集（skill pack）格式与打包逻辑（node/browser 共用单一来源）：
+ *   webskill.skill-pack.json   { schemaVersion: 1, skills: [{ name, digest }] }
+ *   <skill-a>/SKILL.md … webskill.skill-manifest.json
+ *   <skill-b>/SKILL.md …
+ * fflate 环境无关；文件读取经 FileSystemProvider 抽象。
+ */
+/** 包级清单文件名（位于 zip 根，不参与各技能 digest） */
+declare const SKILL_PACK_FILE = "webskill.skill-pack.json";
+/** @stable */
+interface SkillPackManifest {
+  schemaVersion: 1;
+  skills: Array<{
+    name: string;
+    digest: string;
+  }>;
+}
+/**
+ * 多技能打包为单一 zip（包级清单 + 各技能目录含自身 manifest）。
+ * manifestBuilder 负责确保技能目录内 manifest 文件存在并返回之（digest 入包级清单）。
+ * @stable
+ */
+declare function exportSkills(fs: FileSystemProvider, input: {
+  roots: string[];
+  manifestBuilder: (skillRoot: string) => Promise<SkillManifest>;
+}): Promise<Uint8Array>;
+/** 包级清单解析 + 形状校验；损坏 → INSTALL_FAILED（安装侧保证零残留） */
+declare function parseSkillPackManifest(text: string): SkillPackManifest;
+//#endregion
+//#region src/skill/discovery.d.ts
+interface DiscoveryResult {
+  entries: SkillCatalogEntry[];
+  issues: SkillIssue[];
+}
+declare class SkillDiscovery {
+  #private;
+  constructor(fs: FileSystemProvider, roots: string[]);
+  discover(): Promise<DiscoveryResult>;
+  catalog(): Promise<{
+    catalog: SkillCatalog;
+    issues: SkillIssue[];
+  }>;
+  /** 按需加载技能完整文档；技能不存在时抛 SKILL_NOT_FOUND */
+  loadDocument(skillName: string): Promise<SkillDocument>;
+}
+//#endregion
+//#region src/skill/validator.d.ts
+interface ValidationReport {
+  /** 无 error 级 issue 即 true */
+  ok: boolean;
+  issues: SkillIssue[];
+}
+/**
+ * 合规校验。内部直接复用 SkillDiscovery 的扫描逻辑，
+ * 规则判定同样落在 checkSkillRules 单一来源上。
+ */
+declare function validateSkills(fs: FileSystemProvider, roots: string[]): Promise<ValidationReport>;
+//#endregion
+//#region src/skill/reader.d.ts
+/** 按技能名读取技能根目录内的文件，全部读取强制经过路径安全检查 */
+declare class SkillReader {
+  #private;
+  constructor(fs: FileSystemProvider, index: Map<string, string>);
+  readSkillMarkdown(skillName: string): Promise<string>;
+  readSkillFile(skillName: string, relativePath: string): Promise<string>;
+  readSkillBinary(skillName: string, relativePath: string): Promise<Uint8Array>;
+}
+//#endregion
+//#region src/skill/catalog.d.ts
+/** 由条目列表构建 Catalog，保证按名称排序 */
+declare function buildCatalog(entries: SkillCatalogEntry[]): SkillCatalog;
+//#endregion
+//#region src/render/types.d.ts
+/** 可插拔的 Catalog 渲染器 */
+interface CatalogRenderer {
+  readonly format: string;
+  render(catalog: SkillCatalog): string;
+}
+//#endregion
+//#region src/render/jsonRenderer.d.ts
+declare function renderCatalogJson(catalog: SkillCatalog): string;
+declare const jsonRenderer: CatalogRenderer;
+//#endregion
+//#region src/render/xmlRenderer.d.ts
+/** 转义 XML 五个特殊字符：& < > " ' */
+declare function escapeXml(text: string): string;
+declare function renderAvailableSkillsXml(catalog: SkillCatalog): string;
+declare const xmlRenderer: CatalogRenderer;
+//#endregion
+//#region ../runtime/dist/types-CgNC-oQu.d.ts
+//#region src/llm/streamTypes.d.ts
+/** 流式 LLM 事件（OpenAI SSE / Vercel fullStream 统一映射） */
+type LlmStreamEvent = {
+  type: 'text-delta';
+  delta: string;
+} | {
+  type: 'tool-calls';
+  toolCalls: LlmToolCall[];
+} | {
+  type: 'done';
+  content?: string;
+};
+//#endregion
+//#region src/llm/types.d.ts
+interface LlmMessage {
+  role: 'system' | 'user' | 'assistant' | 'tool';
+  content: string;
+  /** role=tool 时必填 */
+  toolCallId?: string;
+  /** role=assistant 发起工具调用时携带 */
+  toolCalls?: LlmToolCall[];
+}
+interface LlmToolSpec {
+  name: string;
+  description?: string;
+  inputSchema: JsonSchema;
+}
+interface LlmToolCall {
+  id: string;
+  name: string;
+  arguments: Record<string, unknown>;
+}
+interface LlmResponse {
+  content?: string;
+  toolCalls?: LlmToolCall[];
+  raw?: unknown;
+}
+interface LlmCompleteInput {
+  model?: string;
+  messages: LlmMessage[];
+  tools?: LlmToolSpec[];
+  temperature?: number;
+  signal?: AbortSignal;
+}
+interface LlmClient {
+  complete(input: LlmCompleteInput): Promise<LlmResponse>;
+  /** 可选流式接口；实现后 AgentLoop 默认走流式（text-delta 增量 + 最终组装） */
+  stream?(input: LlmCompleteInput): AsyncIterable<LlmStreamEvent>;
+}
+//#endregion
+//#region src/artifacts/types.d.ts
+interface Artifact {
+  id: string;
+  runId: string;
+  path: string;
+  type: 'text' | 'binary';
+  mimeType?: string;
+  size: number;
+  createdAt: string;
+  metadata?: Record<string, unknown>;
+}
+interface ArtifactStore {
+  createTextArtifact(input: {
+    runId: string;
+    path: string;
+    content: string;
+    mimeType?: string;
+    metadata?: Record<string, unknown>;
+  }): Promise<Artifact>;
+  createBinaryArtifact(input: {
+    runId: string;
+    path: string;
+    content: Uint8Array;
+    mimeType?: string;
+    metadata?: Record<string, unknown>;
+  }): Promise<Artifact>;
+  listArtifacts(runId: string): Promise<Artifact[]>;
+}
+//#endregion
+//#region src/interaction/types.d.ts
+type InteractionRequest = {
+  type: 'ask';
+  id: string;
+  message: string;
+  schema?: JsonSchema;
+} | {
+  type: 'confirm';
+  id: string;
+  message: string;
+  defaultValue?: boolean;
+} | {
+  type: 'form';
+  id: string;
+  title?: string;
+  fields: FormField[];
+} | {
+  type: 'select';
+  id: string;
+  message: string;
+  options: Array<{
+    label: string;
+    value: unknown;
+  }>;
+} | {
+  /**
+   * 能力强制授权（require-approval）：与脚本自发 confirm 区分，UI 渲染为授权样式
+   * @experimental
+   */
+  type: 'authorize';
+  id: string;
+  capability: 'readReference' | 'writeArtifact' | 'confirm';
+  message: string;
+  details?: unknown;
+};
+interface InteractionResponse {
+  id: string;
+  value?: unknown;
+  cancelled?: boolean;
+}
+/** 图表规格（$chart 约定的校验后形态；渲染单一来源在 ui/chart/miniChart） */
+interface ChartSpec {
+  kind: 'bar' | 'line' | 'pie';
+  title?: string;
+  labels: string[];
+  series: Array<{
+    name?: string;
+    data: number[];
+  }>;
+}
+type RenderBlock = {
+  type: 'markdown';
+  text: string;
+} | {
+  type: 'json';
+  data: unknown;
+} | {
+  type: 'table';
+  columns: string[];
+  rows: unknown[][];
+} | {
+  type: 'image';
+  url: string;
+  alt?: string;
+} | {
+  type: 'file';
+  path: string;
+  mimeType?: string;
+  size?: number;
+} | {
+  type: 'chart';
+  chart: ChartSpec;
+};
+interface RenderResultRequest {
+  runId: string;
+  title?: string;
+  summary?: string;
+  blocks: RenderBlock[];
+  artifacts?: Artifact[];
+}
+/** @stable */
+interface UiBridge {
+  request(input: InteractionRequest): Promise<InteractionResponse>;
+  progress?(input: {
+    runId: string;
+    message: string;
+    value?: number;
+  }): Promise<void>;
+  /** 定义即可，阶段 7 消费 */
+  renderResult?(input: RenderResultRequest): Promise<void>;
+  /** 流式文本增量（流式 LLM 路径下由 AgentLoop 转发） */
+  onTextDelta?(runId: string, delta: string): Promise<void> | void;
+}
+interface FormField {
+  name: string;
+  label: string;
+  type: 'text' | 'number' | 'boolean' | 'select' | 'textarea';
+  required?: boolean;
+  description?: string;
+  defaultValue?: unknown;
+  options?: Array<{
+    label: string;
+    value: unknown;
+  }>;
+}
+interface InteractionPolicy {
+  /** 缺必填参数策略：默认 'user'（表单问用户），'llm' 回喂自愈 */
+  missingParams?: 'user' | 'llm';
+  /** context.confirm 策略：默认 'required'（真实询问） */
+  confirmations?: 'required' | 'auto-approve';
+  /** 交互超时，默认 300_000ms */
+  interactionTimeoutMs?: number;
+}
+//#endregion
+//#region src/memory/types.d.ts
+/** scope/key 两级记忆存储；scope 约定：session:{id} / skill:{name} / user:{id} */
+interface MemoryStore {
+  get(scope: string, key: string): Promise<unknown>;
+  set(scope: string, key: string, value: unknown): Promise<void>;
+  delete(scope: string, key: string): Promise<void>;
+  list(scope: string): Promise<Array<{
+    key: string;
+    value: unknown;
+  }>>;
+  clear(scope?: string): Promise<void>;
+}
+//#endregion
+export { exportSkills as $, SkillCatalog as A, SkillReader as B, JsonSchema as C, SKILL_NAME_MAX_LENGTH as D, SKILL_MANIFEST_FILE as E, SkillIssue as F, WebSkillError as G, SkillsLockfile as H, SkillLocation as I, buildManifest as J, WebSkillErrorCode as K, SkillManifest as L, SkillDiscovery as M, SkillDocument as N, SKILL_NAME_PATTERN as O, SkillInstallSource as P, escapeXml as Q, SkillMetadata as R, FileSystemProvider as S, SKILLS_LOCKFILE as T, ValidationReport as U, SkillSource as V, VerifyResult as W, checkSkillRules as X, checkDependencyCycles as Y, computeDigest as Z, RenderResultRequest as _, InteractionPolicy as a, renderAvailableSkillsXml as at, DiscoveryResult as b, LlmClient as c, validateSkills as ct, LlmResponse as d, isValidSkillName as et, LlmStreamEvent as f, RenderBlock as g, MemoryStore as h, FormField as i, parseSkillPackManifest as it, SkillCatalogEntry as j, SKILL_PACK_FILE as k, LlmCompleteInput as l, verifyManifest as lt, LlmToolSpec as m, ArtifactStore as n, normalizePath as nt, InteractionRequest as o, renderCatalogJson as ot, LlmToolCall as p, buildCatalog as q, ChartSpec as r, parseSkillMarkdown as rt, InteractionResponse as s, resolveInsideRoot as st, Artifact as t, jsonRenderer as tt, LlmMessage as u, xmlRenderer as ut, UiBridge as v, MemoryFS as w, FileStat as x, CatalogRenderer as y, SkillPackManifest as z };

package/dist/ui-react.d.ts

@@ -1,4 +1,4 @@
-import { Et as UiBridge, M as InteractionResponse, j as InteractionRequest, ot as RenderResultRequest } from "./index-DCifjtJx.js";
+import { _ as RenderResultRequest, o as InteractionRequest, s as InteractionResponse, v as UiBridge } from "./types-CgNC-oQu-DCklnS0h.js";
 //#region ../ui-react/dist/index.d.ts
 //#region src/bridgeState.d.ts
 /**

package/dist/ui-react.js

@@ -1,4 +1,4 @@
-import { S as renderMiniMarkdown, m as collectValues, w as shapeInteractionValue, x as renderMiniChart, y as interactionToFormModel } from "./dist-BQruQ9Hv.js";
+import { S as renderMiniMarkdown, m as collectValues, w as shapeInteractionValue, x as renderMiniChart, y as interactionToFormModel } from "./dist-Dv4a1Jkm.js";
 import { useLayoutEffect, useRef, useState, useSyncExternalStore } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 

package/dist/ui-vue.d.ts

@@ -1,4 +1,4 @@
-import { Et as UiBridge, M as InteractionResponse, j as InteractionRequest, ot as RenderResultRequest } from "./index-DCifjtJx.js";
+import { _ as RenderResultRequest, o as InteractionRequest, s as InteractionResponse, v as UiBridge } from "./types-CgNC-oQu-DCklnS0h.js";
 import { PropType } from "vue";
 //#region ../ui-vue/dist/index.d.ts
 //#region src/bridgeState.d.ts

package/dist/ui-vue.js

@@ -1,4 +1,4 @@
-import { S as renderMiniMarkdown, m as collectValues, w as shapeInteractionValue, x as renderMiniChart, y as interactionToFormModel } from "./dist-BQruQ9Hv.js";
+import { S as renderMiniMarkdown, m as collectValues, w as shapeInteractionValue, x as renderMiniChart, y as interactionToFormModel } from "./dist-Dv4a1Jkm.js";
 import { defineComponent, h, reactive, ref } from "vue";
 
 //#region ../ui-vue/dist/index.js

package/dist/ui.d.ts

@@ -1,4 +1,5 @@
-import { Et as UiBridge, M as InteractionResponse, Mt as buildRenderResult, _ as ChartSpec, at as RenderBlock, j as InteractionRequest, ot as RenderResultRequest } from "./index-DCifjtJx.js";
+import { _ as RenderResultRequest, g as RenderBlock, o as InteractionRequest, r as ChartSpec, s as InteractionResponse, v as UiBridge } from "./types-CgNC-oQu-DCklnS0h.js";
+import { st as buildRenderResult } from "./index-S8uza3ld.js";
 //#region ../ui/dist/index.d.ts
 //#region src/model/formModel.d.ts
 interface FormModel {
@@ -50,7 +51,10 @@ declare function renderMiniMarkdown(text: string, doc: Document): HTMLElement;
 //#region src/chart/miniChart.d.ts
 /** 固定 8 色循环调色板 */
 declare const CHART_PALETTE: readonly ['#4e79a7', '#f28e2b', '#e15759', '#76b7b2', '#59a14f', '#edc948', '#b07aa1', '#ff9da7'];
-/** ChartSpec → SVG（bar 等宽柱 + 值标签；line 折线 + 点；pie 扇形 + 图例；空数据容错） */
+/**
+ * ChartSpec → SVG（bar 等宽柱 + 值标签；line 折线 + 点；pie 扇形 + 图例；空数据容错）
+ * @stable
+ */
 declare function renderMiniChart(chart: ChartSpec, doc: Document): SVGSVGElement;
 /** A2UI/OpenUI 降级：chart → table（labels 为首列，series 各为一列） */
 declare function chartToTable(chart: ChartSpec): {
@@ -133,8 +137,12 @@ declare class VercelUiBridge implements UiBridge {
  */
 declare const OPENUI_SUBMIT_ACTION = "webskill:submit";
 declare const OPENUI_CANCEL_ACTION = "webskill:cancel";
+/** @experimental */
 declare function toOpenUiLang(request: InteractionRequest): string;
-/** OpenUI ActionEvent → InteractionResponse（formState 优先，取消单独分支） */
+/**
+ * OpenUI ActionEvent → InteractionResponse（formState 优先，取消单独分支）
+ * @experimental
+ */
 declare function fromOpenUiAction(action: unknown): InteractionResponse;
 //#endregion
 //#region src/adapters/a2ui/a2uiMessages.d.ts
@@ -157,8 +165,12 @@ interface A2uiMessage {
   version: string;
   [key: string]: unknown;
 }
+/** @experimental */
 declare function toA2uiMessages(request: InteractionRequest): A2uiMessage[];
-/** A2UI client→server action 事件 → InteractionResponse */
+/**
+ * A2UI client→server action 事件 → InteractionResponse
+ * @experimental
+ */
 declare function fromA2uiAction(event: unknown): InteractionResponse;
 //#endregion
 //#region src/a2uiRuntime/litRendererBridge.d.ts
@@ -170,6 +182,7 @@ declare function fromA2uiAction(event: unknown): InteractionResponse;
  *
  * 版本对齐：渲染器 @a2ui/lit@0.10.x 经 v0_9 入口同时接受 v0.9 / v0.9.1 消息
  * （schema 枚举 ['v0.9','v0.9.1']），与 7A v0.9.1 转换产物直接兼容。
+ * @experimental
  */
 declare class LitRendererBridge implements UiBridge {
   #private;

package/dist/ui.js

@@ -1,4 +1,4 @@
-import { T as buildRenderResult } from "./dist-nXiR40hi.js";
-import { C as renderRenderResult, D as toVercelToolInvocation, E as toOpenUiLang, S as renderMiniMarkdown, T as toA2uiMessages, _ as fromOpenUiAction, a as CHART_PALETTE, b as renderBlocks, c as OPENUI_SUBMIT_ACTION, d as WEBSKILL_STYLES_CSS, f as WebFormBridge, g as fromA2uiAction, h as ensureStyles, i as A2UI_VERSION, l as VERCEL_INTERACTION_TOOL_NAME, m as collectValues, n as A2UI_CANCEL_ACTION, o as LitRendererBridge, p as chartToTable, r as A2UI_SUBMIT_ACTION, s as OPENUI_CANCEL_ACTION, t as A2UI_BASIC_CATALOG_ID, u as VercelUiBridge, v as fromVercelToolResult, w as shapeInteractionValue, x as renderMiniChart, y as interactionToFormModel } from "./dist-BQruQ9Hv.js";
+import { x as buildRenderResult } from "./dist-CiYRkm71.js";
+import { C as renderRenderResult, D as toVercelToolInvocation, E as toOpenUiLang, S as renderMiniMarkdown, T as toA2uiMessages, _ as fromOpenUiAction, a as CHART_PALETTE, b as renderBlocks, c as OPENUI_SUBMIT_ACTION, d as WEBSKILL_STYLES_CSS, f as WebFormBridge, g as fromA2uiAction, h as ensureStyles, i as A2UI_VERSION, l as VERCEL_INTERACTION_TOOL_NAME, m as collectValues, n as A2UI_CANCEL_ACTION, o as LitRendererBridge, p as chartToTable, r as A2UI_SUBMIT_ACTION, s as OPENUI_CANCEL_ACTION, t as A2UI_BASIC_CATALOG_ID, u as VercelUiBridge, v as fromVercelToolResult, w as shapeInteractionValue, x as renderMiniChart, y as interactionToFormModel } from "./dist-Dv4a1Jkm.js";
 
 export { A2UI_BASIC_CATALOG_ID, A2UI_CANCEL_ACTION, A2UI_SUBMIT_ACTION, A2UI_VERSION, CHART_PALETTE, LitRendererBridge, OPENUI_CANCEL_ACTION, OPENUI_SUBMIT_ACTION, VERCEL_INTERACTION_TOOL_NAME, VercelUiBridge, WEBSKILL_STYLES_CSS, WebFormBridge, buildRenderResult, chartToTable, collectValues, ensureStyles, fromA2uiAction, fromOpenUiAction, fromVercelToolResult, interactionToFormModel, renderBlocks, renderMiniChart, renderMiniMarkdown, renderRenderResult, shapeInteractionValue, toA2uiMessages, toOpenUiLang, toVercelToolInvocation };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webskill/sdk",
-  "version": "0.0.6",
+  "version": "0.1.0",
   "description": "WebSkill — browser/Node agent skill runtime (skills, tools, MCP, governance, UI)",
   "license": "MIT",
   "type": "module",
@@ -40,6 +40,10 @@
       "types": "./dist/governance.d.ts",
       "import": "./dist/governance.js"
     },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [