@webskill/sdk 0.2.7 → 0.3.0

package/dist/index-BHL5FWGw.d.ts

@@ -1,240 +0,0 @@
-import { K as SkillInstallSource, M as FileStat, N as FileSystemProvider, O as ArchiveLimits, P as JsonSchema, Y as SkillManifest, _ as RenderResultRequest, et as SkillsLockfile, nt as VerifyResult, o as InteractionRequest, s as InteractionResponse, v as UiBridge } from "./types-7fnqDVrf-BnRQjVU3.js";
-import { N as NetworkPolicy, Q as ScriptExecutor, X as SchemaInferer, Z as ScriptExecutionContext, b as FsArtifactStore, d as BridgeCapabilities, it as ToolResult, nt as ToolDefinition, u as ApprovalScope, x as FsMemoryStore } from "./index-BpIK7tJM.js";
-import { Readable, Writable } from "node:stream";
-//#region ../node/dist/index.d.ts
-//#region src/fs/nodeFs.d.ts
-/**
- * 基于 node:fs/promises 的 FileSystemProvider；接受 `/` 风格路径，写入自动创建父目录。
- * 可选 root 模式：构造传入 root 后，read/write 操作先做 realpath 包含校验
- * （root 与目标都 realpath 后前缀比对），经符号链接逃逸 root → FS_PATH_OUTSIDE_ROOT。
- */
-declare class NodeFS implements FileSystemProvider {
-  #private;
-  readonly kind = "node";
-  constructor(deps?: {
-    root?: string;
-  });
-  /** root 模式：全部方法（read/write/exists/stat/list/mkdir/remove/rename）目标 realpath 必须落在 root realpath 前缀内 */
-  withRoot(root: string): NodeFS;
-  readText(p: string): Promise<string>;
-  writeText(p: string, content: string): Promise<void>;
-  appendText(p: string, content: string): Promise<void>;
-  readBinary(p: string): Promise<Uint8Array>;
-  writeBinary(p: string, content: Uint8Array): Promise<void>;
-  exists(p: string): Promise<boolean>;
-  stat(p: string): Promise<FileStat>;
-  list(p: string): Promise<FileStat[]>;
-  mkdir(p: string): Promise<void>;
-  remove(p: string, options?: {
-    recursive?: boolean;
-  }): Promise<void>;
-  rename(from: string, to: string): Promise<void>;
-}
-//#endregion
-//#region src/executor/nodeScriptExecutor.d.ts
-/**
- * 进程内脚本执行器。接口按沙箱语义设计（context 无隐式宿主访问），
- * worker_threads 沙箱见 deferred-items D1。
- */
-declare class NodeScriptExecutor implements ScriptExecutor {
-  #private;
-  constructor(fs: FileSystemProvider);
-  loadDefinition(skillRoot: string, scriptName: string): Promise<ToolDefinition>;
-  execute(input: {
-    skillRoot: string;
-    scriptName: string;
-    args: Record<string, unknown>;
-    context: Parameters<ScriptExecutor['execute']>[0]['context'];
-    timeoutMs: number;
-  }): Promise<ToolResult>;
-}
-//#endregion
-//#region src/executor/sandboxedScriptExecutor.d.ts
-interface SandboxOptions {
-  /** 默认 { maxOldGenerationSizeMb: 64, maxYoungGenerationSizeMb: 16 } */
-  resourceLimits?: {
-    maxOldGenerationSizeMb?: number;
-    maxYoungGenerationSizeMb?: number;
-  };
-  /** env 白名单（仅这些变量传入 Worker；默认空） */
-  envWhitelist?: string[];
-  capabilities?: BridgeCapabilities;
-  /** 网络策略：默认 'deny-all'（白名单见 runtime/sandbox/networkPolicy） */
-  networkPolicy?: NetworkPolicy;
-  /** 裸模块 allowlist（默认 []：一切 node: 内置模块全禁；按需放行如 ['node:path']） */
-  allowedModules?: string[];
-  /** require-approval 模式的授权询问出口（缺失时 require-approval 一律拒绝） */
-  uiBridge?: UiBridge;
-  /** 授权粒度：默认 'once-per-run' */
-  approvalScope?: ApprovalScope;
-}
-/**
- * D1：worker_threads 沙箱脚本执行器。
- * 每次执行独立 Worker（resourceLimits + env 白名单），loadDefinition 同样在
- * Worker 内完成（禁止主进程 import 不可信脚本）；超时 terminate（可杀同步死循环）。
- * 能力桥协议与浏览器同一来源（runtime/sandbox/bridgeProtocol）。
- *
- * 诚实标注：本执行器做的是**能力面收敛**（网络策略、模块 allowlist、资源限额、
- * 超时强杀），**不是安全边界**——Worker 内脚本与宿主共享进程；
- * 已知主动逃逸面（process.binding/_linkedBinding/dlopen/openStdin/reallyExit/abort）
- * 已在入口删除（0.2.3），常规 import 拦截之外不承诺防御其它宿主共享面；
- * 禁止假定其可隔离不可信脚本（隔离级需求用 ProcessSandboxExecutor）。
- */
-declare class SandboxedScriptExecutor implements ScriptExecutor {
-  #private;
-  constructor(fs: FileSystemProvider, options?: SandboxOptions);
-  loadDefinition(skillRoot: string, scriptName: string): Promise<ToolDefinition>;
-  execute(input: {
-    skillRoot: string;
-    scriptName: string;
-    args: Record<string, unknown>;
-    context: ScriptExecutionContext;
-    timeoutMs: number;
-  }): Promise<ToolResult>;
-}
-//#endregion
-//#region src/executor/processSandboxExecutor.d.ts
-interface ProcessSandboxOptions {
-  /** 温池大小（并发上限；执行后 kill 并补位重生），默认 2 */
-  poolSize?: number;
-  /** 透传给子进程的环境变量白名单（默认 []：子进程 env 为空，防密钥泄露） */
-  envWhitelist?: string[];
-  capabilities?: BridgeCapabilities;
-  /** 网络策略：默认 'deny-all'（权限模型无网络维度，补丁兜底；node:net 裸模块为已知残余面） */
-  networkPolicy?: NetworkPolicy;
-  /** require-approval 模式的授权询问出口 */
-  uiBridge?: UiBridge;
-  /** 授权粒度：默认 'once-per-run' */
-  approvalScope?: ApprovalScope;
-  /** 池维护告警出口（recycle 重生失败等；默认 console.warn） */
-  onWarning?: (message: string) => void;
-}
-/**
- * child_process.fork + --permission 进程沙箱（真实进程隔离）。
- * 每个子进程以 `--permission --allow-fs-read=<入口目录> --allow-fs-read=<skillRoot>
- * --allow-fs-write=<artifactDir>` 启动：fs 维度由权限模型管控（experimental），
- * 子进程/Worker/addons 默认禁；网络无权限维度仍靠 fetch/WebSocket patch。
- * 能力桥协议与 worker_threads 沙箱同一形态（readReference/writeArtifact/confirm + 授权）。
- * 温池（默认 2）：同 skillRoot 复用子进程；执行后 kill 并补位重生；并发上限即池大小。
- * 超时 kill（同步死循环可杀）；非零退出码 → TOOL_EXECUTION_FAILED。
- */
-declare class ProcessSandboxExecutor implements ScriptExecutor {
-  #private;
-  constructor(fs: FileSystemProvider, options?: ProcessSandboxOptions);
-  get poolSize(): number;
-  /** 池全部子进程销毁（测试收尾/进程退出前调用）；排队中的 acquire 一律 reject（不悬挂） */
-  dispose(): Promise<void>;
-  loadDefinition(skillRoot: string, scriptName: string): Promise<ToolDefinition>;
-  execute(input: {
-    skillRoot: string;
-    scriptName: string;
-    args: Record<string, unknown>;
-    context: ScriptExecutionContext;
-    timeoutMs: number;
-  }): Promise<ToolResult>;
-}
-//#endregion
-//#region src/schema/oxcSchemaInferer.d.ts
-/**
- * D2 Schema 推导（OXC 静态文本分析，宿主侧执行，不进沙箱）。
- * TS 类型标注为主路径，JSDoc @param 为辅路径；不支持类型降级 string 并标 'x-inferred'。
- */
-declare class OxcSchemaInferer implements SchemaInferer {
-  inferSchemaFromSource(source: string, options?: {
-    fileName?: string;
-  }): JsonSchema | undefined;
-}
-//#endregion
-//#region src/artifacts/fileArtifactStore.d.ts
-/**
- * FileArtifactStore：兼容别名，语义同阶段 2-4。
- * 实现已上移到 runtime 的 FsArtifactStore；node 侧保留 NodeFS 默认值。
- */
-declare class FileArtifactStore extends FsArtifactStore {
-  constructor(deps: {
-    root: string;
-    fs?: FileSystemProvider;
-  });
-}
-//#endregion
-//#region src/memory/fileMemoryStore.d.ts
-/**
- * FileMemoryStore：兼容别名，语义同阶段 3。
- * 实现已上移到 runtime 的 FsMemoryStore；node 侧保留 NodeFS 默认值。
- */
-declare class FileMemoryStore extends FsMemoryStore {
-  constructor(deps: {
-    root: string;
-    fs?: FileSystemProvider;
-  });
-}
-//#endregion
-//#region src/ui/cliUiBridge.d.ts
-/**
- * 命令行 UiBridge：ask→问答，confirm→y/n（带默认值），
- * form→逐字段提示（显示默认值与必填标记），select→编号列表，
- * authorize→授权询问（默认拒绝，仅显式 y/yes 批准）。
- * 输入/输出流可注入（测试用 PassThrough）。
- */
-declare class CliUiBridge implements UiBridge {
-  #private;
-  constructor(deps?: {
-    input?: Readable;
-    output?: Writable;
-  });
-  request(input: InteractionRequest): Promise<InteractionResponse>;
-  progress(input: {
-    runId: string;
-    message: string;
-    value?: number;
-  }): Promise<void>;
-  renderResult(input: RenderResultRequest): Promise<void>;
-}
-//#endregion
-//#region src/skillManagement/skillManager.d.ts
-/**
- * 技能管理门面：统一安装管线（staging → 解析 name → 校验 → 拷贝 → manifest → lockfile），
- * 任何失败清理现场抛 INSTALL_FAILED。
- * @stable
- */
-declare class SkillManager {
-  #private;
-  constructor(deps: {
-    managedRoot: string;
-    fs?: FileSystemProvider;
-    fetchImpl?: typeof fetch;
-    /** D2 安装期 schema 预推导（默认 true，可关） */
-    schemaInference?: boolean;
-    /** 归档体积三重上限（缺省 DEFAULT_ARCHIVE_LIMITS） */
-    archiveLimits?: ArchiveLimits;
-    /** install/uninstall 成功后的变更回调（宿主接线缓存失效，如 WebSkillRuntime.invalidate） */
-    onChanged?: () => void;
-  });
-  /** 托管根目录（治理发布归档捕获等只读场景） */
-  get managedRoot(): string;
-  install(source: SkillInstallSource, options?: {
-    expectedSha256?: string;
-  }): Promise<SkillManifest>;
-  uninstall(name: string): Promise<void>;
-  verifyIntegrity(name: string): Promise<VerifyResult>;
-  listInstalled(): Promise<SkillsLockfile>;
-  exportArchive(name: string, options: {
-    format: 'zip' | 'tar';
-    outPath: string;
-  }): Promise<string>;
-  /** 多技能包集导出（webskill.skill-pack.json + 各技能目录含 manifest），写 outPath 并返回 */
-  exportPack(names: string[], options: {
-    outPath: string;
-  }): Promise<string>;
-}
-//#endregion
-//#region src/skillManagement/export/archiveExporter.d.ts
-/** 导出技能目录全部文件（含 manifest）为 zip/tar 归档，返回 outPath */
-declare function exportArchive(fs: FileSystemProvider, skillRoot: string, options: {
-  format: 'zip' | 'tar';
-  outPath: string;
-}): Promise<string>;
-/** 只解出归档中的 webskill.skill-manifest.json 条目（安装前预览） */
-declare function readArchiveManifest(fs: FileSystemProvider, archivePath: string): Promise<SkillManifest>;
-//#endregion
-export { NodeScriptExecutor as a, ProcessSandboxOptions as c, SkillManager as d, exportArchive as f, NodeFS as i, SandboxOptions as l, FileArtifactStore as n, OxcSchemaInferer as o, readArchiveManifest as p, FileMemoryStore as r, ProcessSandboxExecutor as s, CliUiBridge as t, SandboxedScriptExecutor as u };