@webskill/sdk 0.0.6 → 0.1.0

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

@@ -1,394 +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;
-  /** 声明式依赖：精确技能名列表（无版本约束）；缺依赖/循环依赖 → error 级校验 */
-  dependencies?: 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>;
-  /** 全库技能名集合（两趟扫描提供）；提供时启用 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";
-interface SkillPackManifest {
-  schemaVersion: 1;
-  skills: Array<{
-    name: string;
-    digest: string;
-  }>;
-}
-/**
- * 多技能打包为单一 zip（包级清单 + 各技能目录含自身 manifest）。
- * manifestBuilder 负责确保技能目录内 manifest 文件存在并返回之（digest 入包级清单）。
- */
-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
+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;
@@ -452,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}` */
@@ -594,116 +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;
-}
-/** 图表规格（$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[];
-}
-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 {
@@ -789,23 +261,11 @@ declare function buildRenderResult(run: RuntimeRun, output: string, renderBlocks
  */
 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>;
-}
-//#endregion
-//#region src/facade/types.d.ts
-/** 安装结果清单（对齐 README IDL 命名；SkillManifest 的精简投影） */
 interface InstalledSkillManifest {
   name: string;
   version?: string;
@@ -829,6 +289,7 @@ interface WebSkillApi {
 /**
  * navigator.webskill 门面装配层：零新业务逻辑，全部直转
  * SkillDiscovery / validateSkills / WebSkillRuntime / SkillManager。
+ * @stable
  */
 declare function createWebSkillApi(deps: {
   fs: FileSystemProvider;
@@ -878,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：
@@ -927,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>，
@@ -1039,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） */
@@ -1053,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;
@@ -1110,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;
@@ -1136,6 +554,7 @@ interface RunSnapshot {
   };
   snapshotAt: string;
 }
+/** @experimental */
 interface RunSnapshotStore {
   save(snapshot: RunSnapshot): Promise<void>;
   load(runId: string): Promise<RunSnapshot | undefined>;
@@ -1145,6 +564,7 @@ interface RunSnapshotStore {
 /**
  * FileSystemProvider 后端的快照存储：<root>/<runId>.snapshot.json。
  * 坏 JSON → RUN_SNAPSHOT_INCOMPATIBLE 并自动清理坏文件；runId 过路径安全校验。
+ * @experimental
  */
 declare class FsRunSnapshotStore implements RunSnapshotStore {
   #private;
@@ -1252,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);
@@ -1267,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 { OpenAiCompatibleClientConfig as $, SKILLS_LOCKFILE as $t, InteractionPolicy as A, normalizePath as An, WebSkillRuntimeDeps as At, LlmResponse as B, networkUrlHost as Bt, FsMemoryStore as C, checkDependencyCycles as Cn, TraceEvent as Ct, HookRunnerOptions as D, exportSkills as Dn, VercelToolSpec as Dt, HookRunner as E, escapeXml as En, UiBridge as Et, LifecycleHookContext as F, resolveInsideRoot as Fn, extractChartSpec as Ft, MemoryStore as G, toLlmToolSpec as Gt, LlmToolCall as H, parseBridgeRequest as Ht, LifecycleListener as I, validateSkills as In, fromVercelResult as It, MockLlmQueueItem as J, DiscoveryResult as Jt, MockLlmClient as K, toVercelToolSpecs as Kt, LlmClient as L, verifyManifest as Ln, fromVercelStreamPart as Lt, InteractionResponse as M, parseSkillPackManifest as Mn, buildRenderResult as Mt, LifecycleEvent as N, renderAvailableSkillsXml as Nn, createScriptContext as Nt, InMemoryStore as O, isValidSkillName as On, WebSkillApi as Ot, LifecycleHook as P, renderCatalogJson as Pn, createWebSkillApi as Pt, OpenAiCompatibleClient as Q, MemoryFS as Qt, LlmCompleteInput as R, xmlRenderer as Rn, isNetworkAllowed as Rt, FsArtifactStore as S, buildManifest as Sn, TraceClock as St, FullDisclosureRouter as T, computeDigest as Tn, TraceRecorder as Tt, LlmToolSpec as U, resolveToolName as Ut, LlmStreamEvent as V, normalizeToolContent as Vt, MemoryArtifactStore as W, schemaToForm as Wt, MockUiBridge as X, FileSystemProvider as Xt, MockUiAnswer as Y, FileStat as Yt, NetworkPolicy as Z, JsonSchema as Zt, ChartSpec as _, ValidationReport as _n, ScriptExecutor as _t, AgentLoopConfig as a, SkillCatalogEntry as an, RenderBlock as at, ExternalToolSource as b, WebSkillErrorCode as bn, ToolResolution as bt, ApprovalScope as c, SkillInstallSource as cn, RunResult as ct, BridgeCapabilities as d, SkillManifest as dn, RunTerminationReason as dt, SKILL_MANIFEST_FILE as en, ProgressiveRouter as et, BridgeCapability as f, SkillMetadata as fn, RuntimePhase as ft, CapabilityMode as g, SkillsLockfile as gn, ScriptExecutionContext as gt, CapabilityApproval as h, SkillSource as hn, SchemaInferer as ht, AgentLoop as i, SkillCatalog as in, RUN_SNAPSHOT_SCHEMA_VERSION as it, InteractionRequest as j, parseSkillMarkdown as jn, bridgeError as jt, InstalledSkillManifest as k, jsonRenderer as kn, WebSkillRuntime as kt, Artifact as l, SkillIssue as ln, RunSnapshot as lt, BridgeResponse as m, SkillReader as mn, RuntimeSession as mt, ASK_USER_TOOL as n, SKILL_NAME_PATTERN as nn, READ_SKILL_FILE_TOOL as nt, AgentLoopDeps as o, SkillDiscovery as on, RenderResultRequest as ot, BridgeRequest as p, SkillPackManifest as pn, RuntimeRun as pt, MockLlmHandler as q, CatalogRenderer as qt, ASK_USER_TOOL_NAME as r, SKILL_PACK_FILE as rn, READ_SKILL_FILE_TOOL_NAME as rt, ApprovalDecision as s, SkillDocument as sn, RouteResult as st, ASK_USER_INPUT_SCHEMA as t, SKILL_NAME_MAX_LENGTH as tn, READ_SKILL_FILE_INPUT_SCHEMA as tt, ArtifactStore as u, SkillLocation as un, RunSnapshotStore as ut, EventBus as v, VerifyResult as vn, SkillRouter as vt, FsRunSnapshotStore as w, checkSkillRules as wn, TraceEventType as wt, FormField as x, buildCatalog as xn, ToolResult as xt, ExternalSkillProvider as y, WebSkillError as yn, ToolDefinition as yt, LlmMessage as z, mergeCatalogEntries 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 };