@webskill/sdk 0.0.5 → 0.1.0

package/dist/{index-BQDc-U1x.d.ts → index-S8uza3ld.d.ts}

@@ -1,353 +1,5 @@
-//#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 供上层可编程处理 */
-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;
-};
-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 元数据；未知字段原样透传 */
-interface SkillMetadata {
-  name: string;
-  description: string;
-  license?: string;
-  version?: string;
-  [key: string]: unknown;
-}
-interface SkillLocation {
-  skillRoot: string;
-  skillMdPath: string;
-  source: SkillSource;
-}
-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;
-}
-interface SkillCatalog {
-  skills: 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>;
-}): SkillIssue[];
-//#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
+import { A as SkillCatalog, C as JsonSchema, L as SkillManifest, M as SkillDiscovery, N as SkillDocument, P as SkillInstallSource, S as FileSystemProvider, U as ValidationReport, _ as RenderResultRequest, a as InteractionPolicy, b as DiscoveryResult, c as LlmClient, d as LlmResponse, f as LlmStreamEvent, g as RenderBlock, h as MemoryStore, i as FormField, j as SkillCatalogEntry, l as LlmCompleteInput, m as LlmToolSpec, n as ArtifactStore, o as InteractionRequest, r as ChartSpec, t as Artifact, u as LlmMessage, v as UiBridge } from "./types-CgNC-oQu-DCklnS0h.js";
 //#region ../runtime/dist/index.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/llm/mockLlmClient.d.ts
-type MockLlmHandler = (input: LlmCompleteInput) => LlmResponse | Promise<LlmResponse>;
-type MockLlmQueueItem = LlmResponse | MockLlmHandler | {
-  stream: LlmStreamEvent[] | ((input: LlmCompleteInput) => LlmStreamEvent[]);
-};
-/**
- * 预设响应序列的确定性 LlmClient；handler 形式可按会话状态动态应答。
- * 默认不含 stream（存量行为）；构造传 { streaming: true } 启用流式：
- * 队列项 { stream: [...] } 按预设 delta 序列产出，LlmResponse 项自动合成增量。
- */
-declare class MockLlmClient implements LlmClient {
-  #private;
-  readonly calls: LlmCompleteInput[];
-  readonly stream?: (input: LlmCompleteInput) => AsyncIterable<LlmStreamEvent>;
-  constructor(responses: MockLlmQueueItem[], options?: {
-    streaming?: boolean;
-  });
-  complete(input: LlmCompleteInput): Promise<LlmResponse>;
-}
-//#endregion
 //#region src/llm/openAiCompatibleClient.d.ts
 interface OpenAiCompatibleClientConfig {
   baseUrl?: string;
@@ -411,35 +63,6 @@ declare class FullDisclosureRouter implements SkillRouter {
   route(catalog: SkillCatalog): Promise<RouteResult>;
 }
 //#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/tools/types.d.ts
 interface ToolDefinition {
   /** LLM 可见名：脚本工具为 `${skillName}__${scriptName}` */
@@ -553,103 +176,6 @@ declare function createScriptContext(deps: {
   onWarning?: (message: string) => void;
 }): ScriptExecutionContext;
 //#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 渲染为授权样式 */
-  type: 'authorize';
-  id: string;
-  capability: 'readReference' | 'writeArtifact' | 'confirm';
-  message: string;
-  details?: unknown;
-};
-interface InteractionResponse {
-  id: string;
-  value?: unknown;
-  cancelled?: boolean;
-}
-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;
-};
-interface RenderResultRequest {
-  runId: string;
-  title?: string;
-  summary?: string;
-  blocks: RenderBlock[];
-  artifacts?: Artifact[];
-}
-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/lifecycle/types.d.ts
 type RuntimePhase = 'discover' | 'route' | 'activate' | 'prepare' | 'execute' | 'observe' | 'interact' | 'complete' | 'fail';
 interface LifecycleEvent {
@@ -717,10 +243,15 @@ interface RunResult {
 //#endregion
 //#region src/interaction/renderResult.d.ts
 /**
- * 默认的结果渲染构造：LLM 最终输出 → markdown block，
- * run.artifacts → file blocks；summary 取 terminationReason。
+ * $chart 约定的形状校验：JSON content 的 data 含 $chart 键且形状合法 → ChartSpec；
+ * 任何畸形（kind 非法 / labels 非字符串数组 / series 项缺数值 data）→ undefined（忽略不炸）。
  */
-declare function buildRenderResult(run: RuntimeRun, output: string): RenderResultRequest;
+declare function extractChartSpec(data: unknown): ChartSpec | undefined;
+/**
+ * 默认的结果渲染构造：run 内收集的 renderBlocks（chart 等）在前，
+ * LLM 最终输出 → markdown block，run.artifacts → file blocks 在后；summary 取 terminationReason。
+ */
+declare function buildRenderResult(run: RuntimeRun, output: string, renderBlocks?: RenderBlock[]): RenderResultRequest;
 //#endregion
 //#region src/interaction/schemaToForm.d.ts
 /**
@@ -730,21 +261,52 @@ declare function buildRenderResult(run: RuntimeRun, output: string): RenderResul
  */
 declare function schemaToForm(schema: JsonSchema, providedArgs?: Record<string, unknown>): FormField[];
 //#endregion
-//#region src/interaction/mockUiBridge.d.ts
-type MockUiAnswer = InteractionResponse | ((request: InteractionRequest) => InteractionResponse | Promise<InteractionResponse>);
+//#region src/facade/types.d.ts
 /**
- * 测试用 UiBridge：按请求 id 或类型预设应答（永不 resolve 的 handler 可模拟超时）；
- * 记录全部请求供断言。
+ * 安装结果清单（对齐 README IDL 命名；SkillManifest 的精简投影）
+ * @stable
  */
-declare class MockUiBridge implements UiBridge {
-  #private;
-  readonly requests: InteractionRequest[];
-  /** key 为请求 id 或请求类型（'ask' | 'confirm' | 'form' | 'select'） */
-  respondTo(key: string, answer: MockUiAnswer): this;
-  setFallback(answer: MockUiAnswer): this;
-  request(input: InteractionRequest): Promise<InteractionResponse>;
+interface InstalledSkillManifest {
+  name: string;
+  version?: string;
+  installedAt: string;
+  integrity: {
+    algorithm: 'sha256';
+    digest: string;
+  };
+}
+/** navigator.webskill 统一门面（环境无关；浏览器挂载见 browser/navigator.ts） */
+interface WebSkillApi {
+  discover(path: string): Promise<SkillCatalog>;
+  read(name: string): Promise<SkillDocument>;
+  validate(path: string): Promise<ValidationReport>;
+  run(prompt: string): Promise<RuntimeRun>;
+  install(url: string): Promise<InstalledSkillManifest>;
+  uninstall(name: string): Promise<void>;
 }
 //#endregion
+//#region src/facade/webSkillApi.d.ts
+/**
+ * navigator.webskill 门面装配层：零新业务逻辑，全部直转
+ * SkillDiscovery / validateSkills / WebSkillRuntime / SkillManager。
+ * @stable
+ */
+declare function createWebSkillApi(deps: {
+  fs: FileSystemProvider;
+  roots: string[];
+  llm: LlmClient;
+  executor?: ScriptExecutor;
+  artifactStore?: ArtifactStore;
+  /** 技能安装门面（Node SkillManager / BrowserSkillManager 均结构兼容）；缺失时 install/uninstall 抛 TOOL_UNSUPPORTED */
+  skillManager?: {
+    install(source: SkillInstallSource, options?: {
+      expectedSha256?: string;
+    }): Promise<SkillManifest>;
+    uninstall(name: string): Promise<void>;
+  };
+  loopConfig?: AgentLoopConfig;
+}): WebSkillApi;
+//#endregion
 //#region src/lifecycle/eventBus.d.ts
 type LifecycleListener = (event: LifecycleEvent) => void;
 /** 生命周期事件总线：只读观测，支持按阶段或通配订阅 */
@@ -777,33 +339,6 @@ declare class HookRunner {
   run(phase: RuntimePhase, ctx: LifecycleHookContext): Promise<void>;
 }
 //#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
-//#region src/memory/inMemoryStore.d.ts
-/** 内存 MemoryStore：测试与浏览器降级用 */
-declare class InMemoryStore implements MemoryStore {
-  #private;
-  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
 //#region src/memory/fsMemoryStore.d.ts
 /**
  * 基于 FileSystemProvider 的 MemoryStore：
@@ -826,27 +361,6 @@ declare class FsMemoryStore implements MemoryStore {
   clear(scope?: string): Promise<void>;
 }
 //#endregion
-//#region src/artifacts/memoryArtifactStore.d.ts
-/** 内存 ArtifactStore：测试与浏览器降级用；索引随进程生命周期存在 */
-declare class MemoryArtifactStore implements ArtifactStore {
-  #private;
-  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/artifacts/fsArtifactStore.d.ts
 /**
  * 基于 FileSystemProvider 的 ArtifactStore：产物落盘 <root>/<runId>/<path>，
@@ -938,6 +452,7 @@ type NetworkPolicy = 'deny-all' | 'allow-all' | {
  *   - 通配 '*.example.com'（含 apex 与任意深度子域）
  *   - 源 'http://localhost:3000'（协议 + host + port 全等）
  * - URL 解析失败一律拒绝
+ * @stable
  */
 declare function isNetworkAllowed(policy: NetworkPolicy, url: string): boolean;
 /** 阻断 trace 用的脱敏 host（解析失败返回占位，不记录完整 URL） */
@@ -952,6 +467,7 @@ type ApprovalDecision = 'allowed' | 'denied' | 'disabled';
  * Per-capability 强制授权判定（宿主侧，browser/node 执行器共用单一来源）。
  * 'require-approval' 模式下经注入的 UiBridge 发 authorize 交互；
  * once-per-run（默认）在 run 内记忆已批准能力，every-call 每次调用都问。
+ * @stable
  */
 declare class CapabilityApproval {
   #private;
@@ -1009,7 +525,10 @@ declare function mergeCatalogEntries(localEntries: SkillCatalogEntry[], provider
 //#endregion
 //#region src/engine/snapshot.d.ts
 declare const RUN_SNAPSHOT_SCHEMA_VERSION = 1;
-/** interrupted（等待用户）状态点的可恢复快照（D3 收窄版） */
+/**
+ * interrupted（等待用户）状态点的可恢复快照（D3 收窄版）
+ * @experimental
+ */
 interface RunSnapshot {
   schemaVersion: 1;
   runId: string;
@@ -1035,6 +554,7 @@ interface RunSnapshot {
   };
   snapshotAt: string;
 }
+/** @experimental */
 interface RunSnapshotStore {
   save(snapshot: RunSnapshot): Promise<void>;
   load(runId: string): Promise<RunSnapshot | undefined>;
@@ -1044,6 +564,7 @@ interface RunSnapshotStore {
 /**
  * FileSystemProvider 后端的快照存储：<root>/<runId>.snapshot.json。
  * 坏 JSON → RUN_SNAPSHOT_INCOMPATIBLE 并自动清理坏文件；runId 过路径安全校验。
+ * @experimental
  */
 declare class FsRunSnapshotStore implements RunSnapshotStore {
   #private;
@@ -1151,7 +672,10 @@ interface WebSkillRuntimeDeps {
   /** D3：interrupt 点快照存储（配置后 interrupted run 可 resumeRun 恢复） */
   snapshotStore?: RunSnapshotStore;
 }
-/** runtime 门面：组合 discovery / router / agent loop / lifecycle */
+/**
+ * runtime 门面：组合 discovery / router / agent loop / lifecycle
+ * @stable
+ */
 declare class WebSkillRuntime {
   #private;
   constructor(deps: WebSkillRuntimeDeps);
@@ -1166,8 +690,9 @@ declare class WebSkillRuntime {
    * D3 恢复 interrupted run：
    * 不存在 → RUN_SNAPSHOT_NOT_FOUND；schemaVersion 不匹配 → 删除 + RUN_SNAPSHOT_INCOMPATIBLE；
    * 已过期 → interaction-timeout 终态并删快照；否则重建 LoopState 重新发起交互续跑。
+   * @experimental
    */
   resumeRun(runId: string): Promise<RunResult>;
 }
 //#endregion
-export { READ_SKILL_FILE_INPUT_SCHEMA as $, SkillCatalogEntry as $t, InteractionResponse as A, createScriptContext as At, LlmToolCall as B, toLlmToolSpec as Bt, FsRunSnapshotStore as C, renderAvailableSkillsXml as Cn, TraceRecorder as Ct, InMemoryStore as D, verifyManifest as Dn, WebSkillRuntimeDeps as Dt, HookRunnerOptions as E, validateSkills as En, WebSkillRuntime as Et, LlmClient as F, networkUrlHost as Ft, MockLlmHandler as G, FileSystemProvider as Gt, MemoryArtifactStore as H, CatalogRenderer as Ht, LlmCompleteInput as I, normalizeToolContent as It, MockUiBridge as J, SKILLS_LOCKFILE as Jt, MockLlmQueueItem as K, JsonSchema as Kt, LlmMessage as L, parseBridgeRequest as Lt, LifecycleHook as M, fromVercelStreamPart as Mt, LifecycleHookContext as N, isNetworkAllowed as Nt, InteractionPolicy as O, xmlRenderer as On, bridgeError as Ot, LifecycleListener as P, mergeCatalogEntries as Pt, ProgressiveRouter as Q, SkillCatalog as Qt, LlmResponse as R, resolveToolName as Rt, FsMemoryStore as S, parseSkillMarkdown as Sn, TraceEventType as St, HookRunner as T, resolveInsideRoot as Tn, VercelToolSpec as Tt, MemoryStore as U, DiscoveryResult as Ut, LlmToolSpec as V, toVercelToolSpecs as Vt, MockLlmClient as W, FileStat as Wt, OpenAiCompatibleClient as X, SKILL_NAME_MAX_LENGTH as Xt, NetworkPolicy as Y, SKILL_MANIFEST_FILE as Yt, OpenAiCompatibleClientConfig as Z, SKILL_NAME_PATTERN as Zt, EventBus as _, computeDigest as _n, ToolDefinition as _t, AgentLoopConfig as a, SkillManifest as an, RouteResult as at, FormField as b, jsonRenderer as bn, TraceClock as bt, ApprovalScope as c, SkillSource as cn, RunSnapshotStore as ct, BridgeCapabilities as d, VerifyResult as dn, RuntimeRun as dt, SkillDiscovery as en, READ_SKILL_FILE_TOOL as et, BridgeCapability as f, WebSkillError as fn, RuntimeSession as ft, CapabilityMode as g, checkSkillRules as gn, SkillRouter as gt, CapabilityApproval as h, buildManifest as hn, ScriptExecutor as ht, AgentLoop as i, SkillLocation as in, RenderResultRequest as it, LifecycleEvent as j, fromVercelResult as jt, InteractionRequest as k, buildRenderResult as kt, Artifact as l, SkillsLockfile as ln, RunTerminationReason as lt, BridgeResponse as m, buildCatalog as mn, ScriptExecutionContext as mt, ASK_USER_TOOL as n, SkillInstallSource as nn, RUN_SNAPSHOT_SCHEMA_VERSION as nt, AgentLoopDeps as o, SkillMetadata as on, RunResult as ot, BridgeRequest as p, WebSkillErrorCode as pn, SchemaInferer as pt, MockUiAnswer as q, MemoryFS as qt, ASK_USER_TOOL_NAME as r, SkillIssue as rn, RenderBlock as rt, ApprovalDecision as s, SkillReader as sn, RunSnapshot as st, ASK_USER_INPUT_SCHEMA as t, SkillDocument as tn, READ_SKILL_FILE_TOOL_NAME as tt, ArtifactStore as u, ValidationReport as un, RuntimePhase as ut, ExternalSkillProvider as v, escapeXml as vn, ToolResolution as vt, FullDisclosureRouter as w, renderCatalogJson as wn, UiBridge as wt, FsArtifactStore as x, normalizePath as xn, TraceEvent as xt, ExternalToolSource as y, isValidSkillName as yn, ToolResult as yt, LlmStreamEvent as z, schemaToForm as zt };
+export { TraceEvent as $, OpenAiCompatibleClient as A, RunSnapshotStore as B, HookRunnerOptions as C, LifecycleHookContext as D, LifecycleHook as E, READ_SKILL_FILE_TOOL_NAME as F, SchemaInferer as G, RuntimePhase as H, RUN_SNAPSHOT_SCHEMA_VERSION as I, SkillRouter as J, ScriptExecutionContext as K, RouteResult as L, ProgressiveRouter as M, READ_SKILL_FILE_INPUT_SCHEMA as N, LifecycleListener as O, READ_SKILL_FILE_TOOL as P, TraceClock as Q, RunResult as R, HookRunner as S, LifecycleEvent as T, RuntimeRun as U, RunTerminationReason as V, RuntimeSession as W, ToolResolution as X, ToolDefinition as Y, ToolResult as Z, ExternalToolSource as _, parseBridgeRequest as _t, AgentLoopConfig as a, WebSkillRuntimeDeps as at, FsRunSnapshotStore as b, toLlmToolSpec as bt, ApprovalScope as c, createScriptContext as ct, BridgeRequest as d, fromVercelResult as dt, TraceEventType as et, BridgeResponse as f, fromVercelStreamPart as ft, ExternalSkillProvider as g, normalizeToolContent as gt, EventBus as h, networkUrlHost as ht, AgentLoop as i, WebSkillRuntime as it, OpenAiCompatibleClientConfig as j, NetworkPolicy as k, BridgeCapabilities as l, createWebSkillApi as lt, CapabilityMode as m, mergeCatalogEntries as mt, ASK_USER_TOOL as n, VercelToolSpec as nt, AgentLoopDeps as o, bridgeError as ot, CapabilityApproval as p, isNetworkAllowed as pt, ScriptExecutor as q, ASK_USER_TOOL_NAME as r, WebSkillApi as rt, ApprovalDecision as s, buildRenderResult as st, ASK_USER_INPUT_SCHEMA as t, TraceRecorder as tt, BridgeCapability as u, extractChartSpec as ut, FsArtifactStore as v, resolveToolName as vt, InstalledSkillManifest as w, FullDisclosureRouter as x, toVercelToolSpecs as xt, FsMemoryStore as y, schemaToForm as yt, RunSnapshot as z };