niceeval 0.13.3 → 0.13.4-canary.39

package/dist/sandbox/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"","sourcesContent":["// sandbox 域类型:运行中 Sandbox、生命周期 hook、命令与文件 IO 的形状。\n// 作者声明使用 layer.ts 的闭合 SandboxLayer；本文件不再保留旧 provider spec。\nimport type { ScopedFeedback } from \"../shared/types.ts\";\nexport interface CommandResult {\n    stdout: string;\n    stderr: string;\n    exitCode: number;\n    /**\n     * 这次执行的命令摘要(有界、已脱敏,与时间树 command 节点同一份文案)。由执行面在最外层\n     * 公开调用处附加;直接从 provider 拿到的裸结果可能没有。断言失败时用作 evidence\n     * (`commandSucceeded()` 的「命令行本身」),消费方按可选字段读。\n     */\n    command?: string;\n}\n/** 内置 provider 名；ProviderModule 的完成态计划使用普通 string 兼容自定义 provider。 */\nexport type SandboxProvider = \"docker\" | \"vercel\" | \"e2b\" | \"local\";\n/** 镜像/模板里的 Node 运行时版本。 */\nexport type SandboxRuntime = \"node20\" | \"node24\";\n/**\n * Sandbox hook 的窄上下文:只有 `experimentId`、`signal` 与作用域绑定的 `progress/diagnostic`,\n * 不借用包含 session / model / telemetry 的完整 `AgentContext`\n * (见 docs/feature/sandbox/library.md「环境层生命周期钩子」)。\n */\nexport interface SandboxHookContext extends ScopedFeedback {\n    /** 运行计划中已解析的实验 id；生命周期 hook 不在脱离 Experiment 的上下文执行。 */\n    readonly experimentId: string;\n    /** 当前物理 Sandbox 归属的 Eval Group；未分组 Sandbox 省略。 */\n    readonly evalGroup?: {\n        readonly id: string;\n        readonly definitionHash: string;\n    };\n    /** 当前 Invocation 的中止信号；物理 Sandbox 生命周期不从某条 Attempt 借用信号。 */\n    readonly signal: AbortSignal;\n}\n/** 沙箱级生命周期钩子(`SandboxLayer.setup()` / `.teardown()` 链式挂载)。 */\nexport type SandboxHook = (sandbox: Sandbox, ctx: SandboxHookContext) => void | Promise<void>;\nexport interface CommandOptions {\n    /**\n     * 这条命令已知会处理的敏感明文（例如 API key、token、HTTP header value）。Runner 仍把\n     * 原值交给 provider 执行，但在任何 timing / commands / execution / error 证据落盘前按\n     * 这些值做精确替换；本数组本身不落盘、不进指纹。空字符串被忽略。\n     *\n     * 这是显式 provenance，不是 secret 扫描器：没有登记的自由文本无法被可靠识别；值若先被\n     * 调用方编码或拆分，应把实际会出现在命令/输出里的编码形态一并登记。\n     */\n    readonly sensitiveValues?: readonly string[];\n    /**\n     * 追加/覆盖本命令的环境变量(与 Sandbox 默认环境叠加,不清空默认值)。`PATH` 是 Sandbox\n     * 受管变量,各 provider 保留自己算出的 `PATH`,不保证能被这里覆盖;需要扩展 PATH 用\n     * Sandbox factory 的 `pathPrepend`(见 docs/feature/sandbox/library.md「PATH:受管变量与\n     * pathPrepend」)。\n     */\n    readonly env?: Readonly<globalThis.Record<string, string>>;\n    /** 本命令的工作目录;省略时落到 `Sandbox.workdir`。相对路径按 workdir 解析,绝对路径原样使用。 */\n    readonly cwd?: string;\n    /**\n     * 把本命令的输出也送进 Sandbox 的「原生日志流」(于是 `docker logs` / Docker UI 的 Logs\n     * 标签页能实时看到它)。给 agent 命令(codex exec / bub run / claude)开它,就能在容器\n     * 日志里看到 agent 的【原始输出】。provider 各自实现(docker:tee 到 PID1 tail 的文件;\n     * 不支持的 provider 忽略)—— 日志怎么浮现是 provider 的事,adapter 只声明意图。\n     */\n    readonly stream?: boolean;\n    /**\n     * 命令 stdout 每到一块就调用一次。回调只用于运行中的短命反馈；完整 stdout 仍会原样\n     * 出现在返回的 `CommandResult` 里。provider 不支持真流时，至少会在命令结束后按完整\n     * stdout 调用一次，不能静默丢掉。\n     */\n    readonly onStdout?: (chunk: string) => void | Promise<void>;\n    /** `onStdout` 的 stderr 对应物；完整 stderr 仍保留在 `CommandResult`。 */\n    readonly onStderr?: (chunk: string) => void | Promise<void>;\n    /**\n     * 覆盖本条命令的执行身份;省略 = Sandbox 默认身份(沿用环境自己声明的身份——Docker 镜像 `USER`、\n     * Compose service `user:`、E2B template 默认用户、宿主当前用户,见\n     * docs/feature/sandbox/library.md「执行身份」)。\n     *\n     * 语义跨 provider 一致,各 provider 映射到自己的原生机制(docker:`exec --user`;E2B:\n     * `{ user }`;Vercel:只认 `\"root\"`,映射 `{ sudo: true }`,其它值报错;local:任何值都报错)。\n     * 本就全程 root 的 provider 视作 no-op；完全无法换身份的 provider 可不支持（抛错）——但**省略与\n     * 显式值的语义保持一致**,不因 provider 而变。\n     */\n    readonly user?: string;\n    /**\n     * 这条命令自己的上限(毫秒)。**省略才是常态**:省略时上限 = attempt deadline 的剩余量\n     * (见 docs/feature/sandbox/architecture.md「时限归属」),provider 层没有独立默认。\n     * 显式传一个更短的值是有意声明,照常生效;撞线时归属记成「命令显式 timeout」。\n     */\n    readonly timeoutMs?: number;\n    /**\n     * 取消本次受管命令树。Provider 必须在 Promise settle 前确认命令树已经终止；无法精确\n     * 终止时应退休整个 Sandbox，不能只关闭 transport 后把进程留在后台。\n     */\n    readonly signal?: AbortSignal;\n}\nexport interface SuccessfulCommandResult extends CommandResult {\n    readonly exitCode: 0;\n}\nexport interface ManagedProcessStart {\n    readonly argv: readonly [\n        string,\n        ...string[]\n    ];\n    readonly cwd?: string;\n    readonly env?: Readonly<globalThis.Record<string, string>>;\n}\nexport type ManagedProcessChunk = {\n    readonly _tag: \"Stdout\";\n    readonly bytes: Uint8Array;\n} | {\n    readonly _tag: \"Stderr\";\n    readonly bytes: Uint8Array;\n};\nexport interface ManagedProcessExit {\n    readonly exitCode: number | null;\n    readonly signal?: string;\n}\n/** Attempt-owned bidirectional process. `output` has exactly one consumer. */\nexport interface ManagedProcess {\n    readonly output: AsyncIterable<ManagedProcessChunk>;\n    writeStdin(bytes: Uint8Array): Promise<void>;\n    closeStdin(): Promise<void>;\n    wait(): Promise<ManagedProcessExit>;\n    terminate(): Promise<void>;\n}\n/** 三个运行中 Sandbox 视图共用的操作词汇；同名成员在不同视图中不得改变语义。 */\nexport interface SandboxOperations {\n    /** Sandbox 内项目/工作区根目录的绝对路径(agent 命令的默认 cwd,也是 git baseline 提交的位置)。各方法的相对路径都以此为基准解析,省略 `cwd`/`targetDir` 时也落到这里。 */\n    readonly workdir: string;\n    /**\n     * 执行单个命令,`args` 作为独立 argv 传递、不经 shell 解释(无 `&&`、管道、通配符展开)。\n     * 只想跑一个可执行文件、参数来自外部输入、担心注入时优先用它。\n     */\n    runCommand(cmd: string, args?: readonly string[], opts?: CommandOptions): Promise<CommandResult>;\n    /**\n     * 执行一整段脚本,经 shell(bash)解释,支持 `&&`、管道、`$()`、重定向等。\n     * 需要拼多条命令或做条件判断时用它。\n     */\n    runShell(script: string, opts?: CommandOptions): Promise<CommandResult>;\n    /**\n     * 像 `runCommand` 一样执行单个命令，但非零退出时抛出 `SandboxCommandExitError`。错误消息附带\n     * 有界、已清理和脱敏的 stderr 尾部；stderr 为空时回退 stdout。完整输出保留在异常的\n     * `result` 字段中。成功结果的 `exitCode` 在类型上固定为 `0`。\n     */\n    runCommandOrThrow(cmd: string, args?: readonly string[], opts?: CommandOptions): Promise<SuccessfulCommandResult>;\n    /**\n     * 像 `runShell` 一样执行 shell 脚本，但非零退出时抛出 `SandboxCommandExitError`。错误摘要、\n     * 完整输出和成功结果的语义与 `runCommandOrThrow` 相同。\n     */\n    runShellOrThrow(script: string, opts?: CommandOptions): Promise<SuccessfulCommandResult>;\n    /** 读取 Sandbox 内文件的文本内容(UTF-8)。文件不存在时抛错。 */\n    readText(path: string): Promise<string>;\n    /** 写入 Sandbox 内一个 UTF-8 文本文件；父目录不存在时自动创建。 */\n    writeText(path: string, content: string): Promise<void>;\n    /** 精确读取 Sandbox 内文件字节；公共契约不绑定 Node Buffer。 */\n    readBytes(path: string): Promise<Uint8Array>;\n    /** 精确写入 Sandbox 内文件字节；父目录不存在时自动创建。 */\n    writeBytes(path: string, content: Uint8Array): Promise<void>;\n    /** 检查 Sandbox 内文件或目录路径是否存在。 */\n    pathExists(path: string): Promise<boolean>;\n}\n/** 只用于宿主机与 Sandbox 之间真实传输；内存内容读写使用 read/writeText/Bytes。 */\nexport interface SandboxTransferOperations {\n    uploadFile(source: string | URL, targetPath: string): Promise<void>;\n    uploadDirectory(sourceDir: string | URL, targetDir?: string, options?: {\n        readonly ignore?: readonly string[];\n    }): Promise<void>;\n    downloadFile(sourcePath: string, target: string | URL): Promise<void>;\n    downloadDirectory(sourceDir: string, targetDir: string | URL, options?: {\n        readonly ignore?: readonly string[];\n    }): Promise<void>;\n}\nexport interface Sandbox extends SandboxOperations, SandboxTransferOperations {\n    /** 销毁 Sandbox 占用的计算资源(容器/microVM)。调用后 Sandbox 不可再用;是否可安全重复调用因 provider 而异,不要依赖这一点。 */\n    stop(): Promise<void>;\n    /** 本 Sandbox 的稳定标识(各 provider 原生 ID,如 Docker 容器 ID 前缀);用于跨调用关联同一 Sandbox 的会话状态,也用于日志展示。 */\n    readonly sandboxId: string;\n    /**\n     * OTLP receiver 的放置能力。\n     * - `string`:Sandbox 内可通过该 hostname 访问宿主 receiver。\n     * - `null`:provider 不承诺宿主回连；runner 尝试在 Sandbox 内启动 attempt-scope receiver。\n     *   这不保证 tracing 成功；镜像缺少 receiver 所需运行时时只记录 supplemental diagnostic。\n     * `defineConfig({ telemetry: { host } })` 可在作者已经提供受控 tunnel 时显式覆盖。\n     */\n    readonly otlpHost: string | null;\n    /**\n     * 可选:把一行写进容器的「主日志」(PID1 在 tail 它)——于是 `docker logs` /\n     * Docker UI 的 Logs 标签页能实时看到 agent 逐轮活动。docker provider 实现,其它可省略。\n     */\n    appendLog?(line: string): Promise<void>;\n}\n/** 复用调度需要的中立寿命确认能力。 */\nexport interface SandboxReuseCapability {\n    ensureLifetime(minRemainingMs: number): Promise<{\n        ready: true;\n        expiresAt?: string;\n    } | {\n        ready: false;\n        reason: string;\n    }>;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"","sourcesContent":["// sandbox 域类型:运行中 Sandbox、生命周期 hook、命令与文件 IO 的形状。\n// 作者声明使用 layer.ts 的闭合 SandboxLayer；本文件不再保留旧 provider spec。\nimport type { ScopedFeedback } from \"../shared/types.ts\";\nexport interface CommandResult {\n    stdout: string;\n    stderr: string;\n    exitCode: number;\n    /**\n     * 这次执行的命令摘要(有界、已脱敏,与时间树 command 节点同一份文案)。由执行面在最外层\n     * 公开调用处附加;直接从 provider 拿到的裸结果可能没有。断言失败时用作 evidence\n     * (`commandSucceeded()` 的「命令行本身」),消费方按可选字段读。\n     */\n    command?: string;\n}\n/** 内置 provider 名；ProviderModule 的完成态计划使用普通 string 兼容自定义 provider。 */\nexport type SandboxProvider = \"docker\" | \"vercel\" | \"e2b\";\n/** 镜像/模板里的 Node 运行时版本。 */\nexport type SandboxRuntime = \"node20\" | \"node24\";\n/**\n * Sandbox hook 的窄上下文:只有 `experimentId`、`signal` 与作用域绑定的 `progress/diagnostic`,\n * 不借用包含 session / model / telemetry 的完整 `AgentContext`\n * (见 docs/feature/sandbox/library.md「环境层生命周期钩子」)。\n */\nexport interface SandboxHookContext extends ScopedFeedback {\n    /** 运行计划中已解析的实验 id；生命周期 hook 不在脱离 Experiment 的上下文执行。 */\n    readonly experimentId: string;\n    /** 当前物理 Sandbox 归属的 Eval Group；未分组 Sandbox 省略。 */\n    readonly evalGroup?: {\n        readonly id: string;\n        readonly definitionHash: string;\n    };\n    /** 当前 Invocation 的中止信号；物理 Sandbox 生命周期不从某条 Attempt 借用信号。 */\n    readonly signal: AbortSignal;\n}\n/** 沙箱级生命周期钩子(`SandboxLayer.setup()` / `.teardown()` 链式挂载)。 */\nexport type SandboxHook = (sandbox: Sandbox, ctx: SandboxHookContext) => void | Promise<void>;\nexport interface CommandOptions {\n    /**\n     * 这条命令已知会处理的敏感明文（例如 API key、token、HTTP header value）。Runner 仍把\n     * 原值交给 provider 执行，但在任何 timing / commands / execution / error 证据落盘前按\n     * 这些值做精确替换；本数组本身不落盘、不进指纹。空字符串被忽略。\n     *\n     * 这是显式 provenance，不是 secret 扫描器：没有登记的自由文本无法被可靠识别；值若先被\n     * 调用方编码或拆分，应把实际会出现在命令/输出里的编码形态一并登记。\n     */\n    readonly sensitiveValues?: readonly string[];\n    /**\n     * 追加/覆盖本命令的环境变量(与 Sandbox 默认环境叠加,不清空默认值)。`PATH` 是 Sandbox\n     * 受管变量,各 provider 保留自己算出的 `PATH`,不保证能被这里覆盖;需要扩展 PATH 用\n     * Sandbox factory 的 `pathPrepend`(见 docs/feature/sandbox/library.md「PATH:受管变量与\n     * pathPrepend」)。\n     */\n    readonly env?: Readonly<globalThis.Record<string, string>>;\n    /** 本命令的工作目录;省略时落到 `Sandbox.workdir`。相对路径按 workdir 解析,绝对路径原样使用。 */\n    readonly cwd?: string;\n    /**\n     * 把本命令的输出也送进 Sandbox 的「原生日志流」(于是 `docker logs` / Docker UI 的 Logs\n     * 标签页能实时看到它)。给 agent 命令(codex exec / bub run / claude)开它,就能在容器\n     * 日志里看到 agent 的【原始输出】。provider 各自实现(docker:tee 到 PID1 tail 的文件;\n     * 不支持的 provider 忽略)—— 日志怎么浮现是 provider 的事,adapter 只声明意图。\n     */\n    readonly stream?: boolean;\n    /**\n     * 命令 stdout 每到一块就调用一次。回调只用于运行中的短命反馈；完整 stdout 仍会原样\n     * 出现在返回的 `CommandResult` 里。provider 不支持真流时，至少会在命令结束后按完整\n     * stdout 调用一次，不能静默丢掉。\n     */\n    readonly onStdout?: (chunk: string) => void | Promise<void>;\n    /** `onStdout` 的 stderr 对应物；完整 stderr 仍保留在 `CommandResult`。 */\n    readonly onStderr?: (chunk: string) => void | Promise<void>;\n    /**\n     * 覆盖本条命令的执行身份;省略 = Sandbox 默认身份(沿用环境自己声明的身份——Docker 镜像 `USER`、\n     * Compose service `user:`、E2B template 默认用户,见\n     * docs/feature/sandbox/library.md「执行身份」)。\n     *\n     * 语义跨 provider 一致,各 provider 映射到自己的原生机制(docker:`exec --user`;E2B:\n     * `{ user }`;Vercel:只认 `\"root\"`,映射 `{ sudo: true }`,其它值报错)。\n     * 本就全程 root 的 provider 视作 no-op；完全无法换身份的 provider 可不支持（抛错）——但**省略与\n     * 显式值的语义保持一致**,不因 provider 而变。\n     */\n    readonly user?: string;\n    /**\n     * 这条命令自己的上限(毫秒)。**省略才是常态**:省略时上限 = attempt deadline 的剩余量\n     * (见 docs/feature/sandbox/architecture.md「时限归属」),provider 层没有独立默认。\n     * 显式传一个更短的值是有意声明,照常生效;撞线时归属记成「命令显式 timeout」。\n     */\n    readonly timeoutMs?: number;\n    /**\n     * 取消本次受管命令树。Provider 必须在 Promise settle 前确认命令树已经终止；无法精确\n     * 终止时应退休整个 Sandbox，不能只关闭 transport 后把进程留在后台。\n     */\n    readonly signal?: AbortSignal;\n}\nexport interface SuccessfulCommandResult extends CommandResult {\n    readonly exitCode: 0;\n}\nexport interface ManagedProcessStart {\n    readonly argv: readonly [\n        string,\n        ...string[]\n    ];\n    readonly cwd?: string;\n    readonly env?: Readonly<globalThis.Record<string, string>>;\n}\nexport type ManagedProcessChunk = {\n    readonly _tag: \"Stdout\";\n    readonly bytes: Uint8Array;\n} | {\n    readonly _tag: \"Stderr\";\n    readonly bytes: Uint8Array;\n};\nexport interface ManagedProcessExit {\n    readonly exitCode: number | null;\n    readonly signal?: string;\n}\n/** Attempt-owned bidirectional process. `output` has exactly one consumer. */\nexport interface ManagedProcess {\n    readonly output: AsyncIterable<ManagedProcessChunk>;\n    writeStdin(bytes: Uint8Array): Promise<void>;\n    closeStdin(): Promise<void>;\n    wait(): Promise<ManagedProcessExit>;\n    terminate(): Promise<void>;\n}\n/** 三个运行中 Sandbox 视图共用的操作词汇；同名成员在不同视图中不得改变语义。 */\nexport interface SandboxOperations {\n    /** Sandbox 内项目/工作区根目录的绝对路径(agent 命令的默认 cwd,也是 git baseline 提交的位置)。各方法的相对路径都以此为基准解析,省略 `cwd`/`targetDir` 时也落到这里。 */\n    readonly workdir: string;\n    /**\n     * 执行单个命令,`args` 作为独立 argv 传递、不经 shell 解释(无 `&&`、管道、通配符展开)。\n     * 只想跑一个可执行文件、参数来自外部输入、担心注入时优先用它。\n     */\n    runCommand(cmd: string, args?: readonly string[], opts?: CommandOptions): Promise<CommandResult>;\n    /**\n     * 执行一整段脚本,经 shell(bash)解释,支持 `&&`、管道、`$()`、重定向等。\n     * 需要拼多条命令或做条件判断时用它。\n     */\n    runShell(script: string, opts?: CommandOptions): Promise<CommandResult>;\n    /**\n     * 像 `runCommand` 一样执行单个命令，但非零退出时抛出 `SandboxCommandExitError`。错误消息附带\n     * 有界、已清理和脱敏的 stderr 尾部；stderr 为空时回退 stdout。完整输出保留在异常的\n     * `result` 字段中。成功结果的 `exitCode` 在类型上固定为 `0`。\n     */\n    runCommandOrThrow(cmd: string, args?: readonly string[], opts?: CommandOptions): Promise<SuccessfulCommandResult>;\n    /**\n     * 像 `runShell` 一样执行 shell 脚本，但非零退出时抛出 `SandboxCommandExitError`。错误摘要、\n     * 完整输出和成功结果的语义与 `runCommandOrThrow` 相同。\n     */\n    runShellOrThrow(script: string, opts?: CommandOptions): Promise<SuccessfulCommandResult>;\n    /** 读取 Sandbox 内文件的文本内容(UTF-8)。文件不存在时抛错。 */\n    readText(path: string): Promise<string>;\n    /** 写入 Sandbox 内一个 UTF-8 文本文件；父目录不存在时自动创建。 */\n    writeText(path: string, content: string): Promise<void>;\n    /** 精确读取 Sandbox 内文件字节；公共契约不绑定 Node Buffer。 */\n    readBytes(path: string): Promise<Uint8Array>;\n    /** 精确写入 Sandbox 内文件字节；父目录不存在时自动创建。 */\n    writeBytes(path: string, content: Uint8Array): Promise<void>;\n    /** 检查 Sandbox 内文件或目录路径是否存在。 */\n    pathExists(path: string): Promise<boolean>;\n}\n/** 只用于宿主机与 Sandbox 之间真实传输；内存内容读写使用 read/writeText/Bytes。 */\nexport interface SandboxTransferOperations {\n    uploadFile(source: string | URL, targetPath: string): Promise<void>;\n    uploadDirectory(sourceDir: string | URL, targetDir?: string, options?: {\n        readonly ignore?: readonly string[];\n    }): Promise<void>;\n    downloadFile(sourcePath: string, target: string | URL): Promise<void>;\n    downloadDirectory(sourceDir: string, targetDir: string | URL, options?: {\n        readonly ignore?: readonly string[];\n    }): Promise<void>;\n}\nexport interface Sandbox extends SandboxOperations, SandboxTransferOperations {\n    /** 销毁 Sandbox 占用的计算资源(容器/microVM)。调用后 Sandbox 不可再用;是否可安全重复调用因 provider 而异,不要依赖这一点。 */\n    stop(): Promise<void>;\n    /** 本 Sandbox 的稳定标识(各 provider 原生 ID,如 Docker 容器 ID 前缀);用于跨调用关联同一 Sandbox 的会话状态,也用于日志展示。 */\n    readonly sandboxId: string;\n    /**\n     * OTLP receiver 的放置能力。\n     * - `string`:Sandbox 内可通过该 hostname 访问宿主 receiver。\n     * - `null`:provider 不承诺宿主回连；runner 尝试在 Sandbox 内启动 attempt-scope receiver。\n     *   这不保证 tracing 成功；镜像缺少 receiver 所需运行时时只记录 supplemental diagnostic。\n     * `defineConfig({ telemetry: { host } })` 可在作者已经提供受控 tunnel 时显式覆盖。\n     */\n    readonly otlpHost: string | null;\n    /**\n     * 可选:把一行写进容器的「主日志」(PID1 在 tail 它)——于是 `docker logs` /\n     * Docker UI 的 Logs 标签页能实时看到 agent 逐轮活动。docker provider 实现,其它可省略。\n     */\n    appendLog?(line: string): Promise<void>;\n}\n/** 复用调度需要的中立寿命确认能力。 */\nexport interface SandboxReuseCapability {\n    ensureLifetime(minRemainingMs: number): Promise<{\n        ready: true;\n        expiresAt?: string;\n    } | {\n        ready: false;\n        reason: string;\n    }>;\n}\n"]}

package/dist/sandbox/types.d.cts

@@ -11,7 +11,7 @@ export interface CommandResult {
     command?: string;
 }
 /** 内置 provider 名；ProviderModule 的完成态计划使用普通 string 兼容自定义 provider。 */
-export type SandboxProvider = "docker" | "vercel" | "e2b" | "local";
+export type SandboxProvider = "docker" | "vercel" | "e2b";
 /** 镜像/模板里的 Node 运行时版本。 */
 export type SandboxRuntime = "node20" | "node24";
 /**
@@ -68,11 +68,11 @@ export interface CommandOptions {
     readonly onStderr?: (chunk: string) => void | Promise<void>;
     /**
      * 覆盖本条命令的执行身份;省略 = Sandbox 默认身份(沿用环境自己声明的身份——Docker 镜像 `USER`、
-     * Compose service `user:`、E2B template 默认用户、宿主当前用户,见
+     * Compose service `user:`、E2B template 默认用户,见
      * docs/feature/sandbox/library.md「执行身份」)。
      *
      * 语义跨 provider 一致,各 provider 映射到自己的原生机制(docker:`exec --user`;E2B:
-     * `{ user }`;Vercel:只认 `"root"`,映射 `{ sudo: true }`,其它值报错;local:任何值都报错)。
+     * `{ user }`;Vercel:只认 `"root"`,映射 `{ sudo: true }`,其它值报错)。
      * 本就全程 root 的 provider 视作 no-op；完全无法换身份的 provider 可不支持（抛错）——但**省略与
      * 显式值的语义保持一致**,不因 provider 而变。
      */

package/dist/sandbox/types.d.mts

@@ -11,7 +11,7 @@ export interface CommandResult {
     command?: string;
 }
 /** 内置 provider 名；ProviderModule 的完成态计划使用普通 string 兼容自定义 provider。 */
-export type SandboxProvider = "docker" | "vercel" | "e2b" | "local";
+export type SandboxProvider = "docker" | "vercel" | "e2b";
 /** 镜像/模板里的 Node 运行时版本。 */
 export type SandboxRuntime = "node20" | "node24";
 /**
@@ -68,11 +68,11 @@ export interface CommandOptions {
     readonly onStderr?: (chunk: string) => void | Promise<void>;
     /**
      * 覆盖本条命令的执行身份;省略 = Sandbox 默认身份(沿用环境自己声明的身份——Docker 镜像 `USER`、
-     * Compose service `user:`、E2B template 默认用户、宿主当前用户,见
+     * Compose service `user:`、E2B template 默认用户,见
      * docs/feature/sandbox/library.md「执行身份」)。
      *
      * 语义跨 provider 一致,各 provider 映射到自己的原生机制(docker:`exec --user`;E2B:
-     * `{ user }`;Vercel:只认 `"root"`,映射 `{ sudo: true }`,其它值报错;local:任何值都报错)。
+     * `{ user }`;Vercel:只认 `"root"`,映射 `{ sudo: true }`,其它值报错)。
      * 本就全程 root 的 provider 视作 no-op；完全无法换身份的 provider 可不支持（抛错）——但**省略与
      * 显式值的语义保持一致**,不因 provider 而变。
      */

package/dist/sandbox/types.d.ts

@@ -11,7 +11,7 @@ export interface CommandResult {
     command?: string;
 }
 /** 内置 provider 名；ProviderModule 的完成态计划使用普通 string 兼容自定义 provider。 */
-export type SandboxProvider = "docker" | "vercel" | "e2b" | "local";
+export type SandboxProvider = "docker" | "vercel" | "e2b";
 /** 镜像/模板里的 Node 运行时版本。 */
 export type SandboxRuntime = "node20" | "node24";
 /**
@@ -68,11 +68,11 @@ export interface CommandOptions {
     readonly onStderr?: (chunk: string) => void | Promise<void>;
     /**
      * 覆盖本条命令的执行身份;省略 = Sandbox 默认身份(沿用环境自己声明的身份——Docker 镜像 `USER`、
-     * Compose service `user:`、E2B template 默认用户、宿主当前用户,见
+     * Compose service `user:`、E2B template 默认用户,见
      * docs/feature/sandbox/library.md「执行身份」)。
      *
      * 语义跨 provider 一致,各 provider 映射到自己的原生机制(docker:`exec --user`;E2B:
-     * `{ user }`;Vercel:只认 `"root"`,映射 `{ sudo: true }`,其它值报错;local:任何值都报错)。
+     * `{ user }`;Vercel:只认 `"root"`,映射 `{ sudo: true }`,其它值报错)。
      * 本就全程 root 的 provider 视作 no-op；完全无法换身份的 provider 可不支持（抛错）——但**省略与
      * 显式值的语义保持一致**,不因 provider 而变。
      */

package/dist/sources/project.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+  "name": "niceeval-domain-sources",
+  "root": "packages/niceeval/src/sources",
+  "tags": ["kind:source-domain", "domain:sources"]
+}