niceeval 0.13.3 → 0.13.4-canary.39

package/dist/sandbox/build-coordinator.d.ts

@@ -4,8 +4,24 @@ import type { SandboxBuildRecord, TimingActivity } from "../runner/types.js";
 import type { BuildKey } from "./identity.js";
 /** Run 级开放 activity key;与 Record 契约同名。 */
 export declare const SANDBOX_BUILD_ACTIVITY: "sandbox.build";
+declare const MaterializationScopeIdBrand: unique symbol;
+export type MaterializationScopeId = string & {
+    readonly [MaterializationScopeIdBrand]: true;
+};
+declare const SandboxBuildRefBrand: unique symbol;
+export type SandboxBuildRef = string & {
+    readonly [SandboxBuildRefBrand]: true;
+};
+export declare function materializationScopeId(input: {
+    readonly providerFamily: string;
+    readonly authorityFingerprint: string;
+    readonly materializationProtocolVersion: number;
+}): MaterializationScopeId;
+export declare function sandboxBuildRef(scopeId: MaterializationScopeId, buildKey: BuildKey): SandboxBuildRef;
 /** 一条待协调的构建工作(同 BuildKey 只保留第一次出现的 inputs / provider)。 */
 export interface SandboxBuildWork {
+    readonly ref: SandboxBuildRef;
+    readonly scopeId: MaterializationScopeId;
     readonly buildKey: BuildKey;
     readonly provider: string;
     /** 解析后的构建输入投影;不含凭据值。 */
@@ -13,17 +29,36 @@ export interface SandboxBuildWork {
     /** 有界人读标签;省略时用 BuildKey 短前缀。 */
     readonly label?: string;
 }
+export interface SandboxBuildUseHandle {
+    readonly locator: JsonValue;
+    release(): Promise<void> | void;
+}
+export interface SandboxBuildArtifactSource {
+    readonly locator: JsonValue;
+    readonly source: "cache" | "build";
+    acquireUse(signal: AbortSignal): Promise<SandboxBuildUseHandle>;
+    release(): Promise<void> | void;
+}
+export type SandboxBuildLookup = {
+    readonly _tag: "Hit";
+    readonly source: SandboxBuildArtifactSource;
+} | {
+    readonly _tag: "Miss";
+} | {
+    readonly _tag: "Unsupported";
+};
 /** provider 侧 cache 查询与真实构建。 */
 export interface SandboxBuildProvider {
     /** 查 provider 原生 cache / 本地 build registry;命中返回 locator。 */
-    lookup(work: SandboxBuildWork, signal: AbortSignal): Promise<JsonValue | undefined>;
+    lookup(work: SandboxBuildWork, signal: AbortSignal): Promise<SandboxBuildLookup>;
     /** cache miss 时调用原生构建 API。 */
-    build(work: SandboxBuildWork, ctx: SandboxBuildExecutionContext): Promise<JsonValue>;
+    build(work: SandboxBuildWork, ctx: SandboxBuildExecutionContext): Promise<SandboxBuildArtifactSource>;
     /** 可选:Invocation abort / timeout 时取消远端 build。 */
     cancel?(work: SandboxBuildWork): Promise<void>;
 }
 /** 构建执行上下文:子 activity 挂在当前 sandbox.build 节点下。 */
 export interface SandboxBuildExecutionContext {
+    readonly operationId: string;
     readonly signal: AbortSignal;
     readonly timing: RunTimingRecorder;
     readonly parent: TimingActivity;
@@ -52,12 +87,15 @@ export interface PrepareSandboxBuildsOptions {
 /** 构建协调器对外的有界 activity 事件(与 Run feedback 的 run-activity 字段对齐)。 */
 export type SandboxBuildActivityEvent = {
     status: "started";
+    ref: SandboxBuildRef;
     buildKey: BuildKey;
     id: string;
     key: typeof SANDBOX_BUILD_ACTIVITY;
     label: string;
 } | {
     status: "done" | "failed";
+    outcome: SandboxBuildRecord["status"];
+    ref: SandboxBuildRef;
     buildKey: BuildKey;
     id: string;
     key: typeof SANDBOX_BUILD_ACTIVITY;
@@ -65,6 +103,7 @@ export type SandboxBuildActivityEvent = {
     durationMs: number;
 };
 export interface SandboxBuildFailure {
+    readonly ref: SandboxBuildRef;
     readonly buildKey: BuildKey;
     readonly timingNodeId: string;
     readonly status: "failed" | "cancelled";
@@ -72,20 +111,20 @@ export interface SandboxBuildFailure {
 }
 export interface SandboxBuildPreparation {
     /** 成功(hit / built)的 BuildKey → locator。 */
-    readonly locators: ReadonlyMap<BuildKey, JsonValue>;
+    readonly sources: ReadonlyMap<SandboxBuildRef, SandboxBuildArtifactSource>;
     /** 实际查询或构建过的每条 provenance(不含完全携带、从未过问的 key)。 */
     readonly records: readonly SandboxBuildRecord[];
     /** 失败或取消的 BuildKey → 共用同一 Run timing origin 的错误。 */
-    readonly failures: ReadonlyMap<BuildKey, SandboxBuildFailure>;
+    readonly failures: ReadonlyMap<SandboxBuildRef, SandboxBuildFailure>;
 }
 /** 进行中的 Run 级共享准备:逐 BuildKey 放行,依赖者只等自己引用的那几个 key。 */
 export interface RunningSandboxBuilds {
     /** 已结算 key 的实时视图(随构建推进增补,不等整批收工)。 */
-    readonly locators: ReadonlyMap<BuildKey, JsonValue>;
+    readonly sources: ReadonlyMap<SandboxBuildRef, SandboxBuildArtifactSource>;
     /** 已失败 / 已取消 key 的实时视图。 */
-    readonly failures: ReadonlyMap<BuildKey, SandboxBuildFailure>;
+    readonly failures: ReadonlyMap<SandboxBuildRef, SandboxBuildFailure>;
     /** 等某个 BuildKey 结算;不在本次协调范围内的 key 立即返回。 */
-    settled(buildKey: BuildKey): Promise<void>;
+    settled(ref: SandboxBuildRef): Promise<void>;
     /** 全部 key 结算后的汇总(provenance 在这里齐全)。 */
     readonly done: Promise<SandboxBuildPreparation>;
 }
@@ -109,3 +148,4 @@ export declare function buildFailureOrigin(failure: SandboxBuildFailure): {
     timingNodeId: string;
     cause?: SandboxBuildFailure["error"]["cause"];
 };
+export {};

package/dist/sandbox/build-coordinator.js

@@ -5,8 +5,12 @@ const __niceevalExport0 = __niceevalCanonical["SANDBOX_BUILD_ACTIVITY"];
 export { __niceevalExport0 as SANDBOX_BUILD_ACTIVITY };
 const __niceevalExport1 = __niceevalCanonical["buildFailureOrigin"];
 export { __niceevalExport1 as buildFailureOrigin };
-const __niceevalExport2 = __niceevalCanonical["prepareSandboxBuilds"];
-export { __niceevalExport2 as prepareSandboxBuilds };
-const __niceevalExport3 = __niceevalCanonical["startSandboxBuilds"];
-export { __niceevalExport3 as startSandboxBuilds };
+const __niceevalExport2 = __niceevalCanonical["materializationScopeId"];
+export { __niceevalExport2 as materializationScopeId };
+const __niceevalExport3 = __niceevalCanonical["prepareSandboxBuilds"];
+export { __niceevalExport3 as prepareSandboxBuilds };
+const __niceevalExport4 = __niceevalCanonical["sandboxBuildRef"];
+export { __niceevalExport4 as sandboxBuildRef };
+const __niceevalExport5 = __niceevalCanonical["startSandboxBuilds"];
+export { __niceevalExport5 as startSandboxBuilds };
 //# sourceMappingURL=build-coordinator.js.map

package/dist/sandbox/cli/contribution.cjs

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sandboxCliCommand = exports.SANDBOX_CLI_OPTIONS = void 0;
+const effect_1 = require("effect");
+const application_ts_1 = require("../../cli/application.cjs");
+const contribution_ts_1 = require("../../cli/contribution.cjs");
+const project_configuration_ts_1 = require("../../cli/project-configuration.cjs");
+const cli_commands_ts_1 = require("../cli-commands.cjs");
+/** Sandbox owns this schema: its flags never enter the core CLI parser. */
+exports.SANDBOX_CLI_OPTIONS = Object.freeze({
+    all: Object.freeze({ type: "boolean", help: Object.freeze({ summary: "Destroy every kept sandbox.", visibility: "public" }) }),
+    window: Object.freeze({ type: "string", help: Object.freeze({ summary: "Select one recorded change window.", visibility: "public" }) }),
+    path: Object.freeze({ type: "string", help: Object.freeze({ summary: "Select one path in a sandbox diff.", visibility: "public" }) }),
+    "leave-running": Object.freeze({ type: "boolean", help: Object.freeze({ summary: "Keep a sandbox alive after leaving its shell.", visibility: "public" }) }),
+    record: Object.freeze({ type: "string", help: Object.freeze({ summary: "Use a specific NiceEval record root.", visibility: "public" }) }),
+    orphans: Object.freeze({ type: "boolean", help: Object.freeze({ summary: "Inspect unregistered sandbox instances left by terminated runs.", visibility: "public" }) }),
+    force: Object.freeze({ type: "boolean", help: Object.freeze({ summary: "Prune unverified orphan candidates too.", visibility: "public" }) }),
+    help: Object.freeze({ type: "boolean", short: "h", help: Object.freeze({ summary: "Show Sandbox command help.", visibility: "public" }) }),
+});
+const SANDBOX_HELP = `niceeval sandbox — inspect and manage kept sandboxes
+
+Usage:
+  niceeval sandbox list [--orphans] [--record <record-root>]
+  niceeval sandbox enter <id> [--leave-running] [--record <record-root>]
+  niceeval sandbox history <id> [--record <record-root>]
+  niceeval sandbox diff <id> [--window <window>] [--path <file>] [--record <record-root>]
+  niceeval sandbox stop <id...> [--all] [--record <record-root>]
+  niceeval sandbox prune [--force] [--record <record-root>]
+
+Commands:
+  list       list kept sandboxes or inspect orphan candidates
+  enter      open a shell in a kept sandbox
+  history    show the kept sandbox's change windows
+  diff       print patches from one or all change windows
+  stop       destroy kept sandboxes and remove their registry entries
+  prune      destroy orphaned sandbox instances
+`;
+const SANDBOX_SUBCOMMANDS = ["list", "enter", "history", "diff", "stop", "prune"];
+function sandboxFailure(operation, cause, exitCode = 1) {
+    return new contribution_ts_1.CliFeatureError({ feature: "sandbox", operation, cause, exitCode });
+}
+function isSandboxSubcommand(value) {
+    return value !== undefined && SANDBOX_SUBCOMMANDS.includes(value);
+}
+function parseSandboxArgs(argv, parse) {
+    const parsed = parse(argv, exports.SANDBOX_CLI_OPTIONS);
+    return Object.freeze({
+        positionals: Object.freeze([...parsed.positionals]),
+        providedOptions: Object.freeze(parsed.tokens
+            .filter((token) => token.kind === "option")
+            .map((token) => token.name)),
+        help: parsed.values.help === true,
+        flags: Object.freeze({
+            all: parsed.values.all === true,
+            ...(typeof parsed.values.window === "string" ? { window: parsed.values.window } : {}),
+            ...(typeof parsed.values.path === "string" ? { path: parsed.values.path } : {}),
+            leaveRunning: parsed.values["leave-running"] === true,
+            ...(typeof parsed.values.record === "string" ? { record: parsed.values.record } : {}),
+            orphans: parsed.values.orphans === true,
+            force: parsed.values.force === true,
+        }),
+    });
+}
+const SANDBOX_SUBCOMMAND_OPTIONS = Object.freeze({
+    list: Object.freeze(["orphans", "record", "help"]),
+    enter: Object.freeze(["leave-running", "record", "help"]),
+    history: Object.freeze(["record", "help"]),
+    diff: Object.freeze(["window", "path", "record", "help"]),
+    stop: Object.freeze(["all", "record", "help"]),
+    prune: Object.freeze(["force", "record", "help"]),
+});
+function write(channel, text) {
+    return effect_1.Effect.flatMap(application_ts_1.CliOutput, (output) => channel === "stdout" ? output.writeStdout(text) : output.writeStderr(text)).pipe(effect_1.Effect.mapError((cause) => sandboxFailure(`write ${channel}`, cause)));
+}
+function unknownSandboxCommand(command) {
+    return command === undefined
+        ? `usage: niceeval sandbox <${SANDBOX_SUBCOMMANDS.join("|")}> …\n`
+        : `unknown sandbox command ${JSON.stringify(command)}\n${SANDBOX_HELP}`;
+}
+/**
+ * Feature-owned root contribution. Syntax outcomes deliberately finish before
+ * credential preparation, so help, version, empty input, and unknown input do
+ * not load .env, config, or a provider SDK.
+ */
+exports.sandboxCliCommand = Object.freeze({
+    name: "sandbox",
+    summary: "inspect, enter, and clean up kept sandboxes",
+    options: exports.SANDBOX_CLI_OPTIONS,
+    run: (argv) => effect_1.Effect.gen(function* () {
+        const argumentsService = yield* application_ts_1.CliArguments;
+        const parsed = yield* effect_1.Effect.try({
+            try: () => parseSandboxArgs(argv, argumentsService.parse),
+            catch: (cause) => sandboxFailure("parse sandbox command", cause, 1),
+        });
+        const subcommand = parsed.positionals[0];
+        if (subcommand === undefined && parsed.help) {
+            yield* write("stdout", SANDBOX_HELP);
+            return 0;
+        }
+        if (!isSandboxSubcommand(subcommand)) {
+            yield* write("stderr", unknownSandboxCommand(subcommand));
+            return 1;
+        }
+        const unsupportedOption = parsed.providedOptions.find((name) => !SANDBOX_SUBCOMMAND_OPTIONS[subcommand].includes(name));
+        if (unsupportedOption !== undefined) {
+            yield* write("stderr", `niceeval sandbox ${subcommand} does not accept --${unsupportedOption}.\n`);
+            return 1;
+        }
+        if (parsed.help) {
+            yield* write("stdout", SANDBOX_HELP);
+            return 0;
+        }
+        const invocation = yield* application_ts_1.CliInvocationFacts;
+        const facts = yield* invocation.facts.pipe(effect_1.Effect.mapError((cause) => sandboxFailure("read invocation facts", cause)));
+        const configuration = yield* project_configuration_ts_1.ProjectConfiguration;
+        yield* configuration.prepare(facts.cwd).pipe(effect_1.Effect.mapError((cause) => sandboxFailure("prepare project credentials", cause)));
+        const path = yield* application_ts_1.CliPath;
+        const record = parsed.flags.record === undefined ? undefined : path.resolve(facts.cwd, parsed.flags.record);
+        const commandFacts = Object.freeze({
+            leaseHolder: `${facts.pid}@${facts.hostname}`,
+            ...(facts.noColor === undefined ? {} : { noColor: facts.noColor }),
+            stdout: facts.stdout,
+        });
+        const output = yield* application_ts_1.CliOutput;
+        return yield* (0, cli_commands_ts_1.runSandboxCommandEffect)(facts.cwd, [...parsed.positionals], record === undefined ? parsed.flags : { ...parsed.flags, record }, { out: output.writeStdoutSync, err: output.writeStderrSync }, commandFacts).pipe(effect_1.Effect.mapError((cause) => sandboxFailure("run sandbox command", cause)));
+    }),
+});
+//# sourceMappingURL=contribution.cjs.map

package/dist/sandbox/cli/contribution.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution.js","sourceRoot":"","sources":["contribution.ts"],"names":[],"mappings":"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","sourcesContent":["import { Effect } from \"effect\";\nimport { CliArguments, CliInvocationFacts, CliOutput, CliPath, type CliOptionDefinition, type CliParsedTokens, } from \"../../cli/application.ts\";\nimport { CliFeatureError, type CliCommandContribution } from \"../../cli/contribution.ts\";\nimport { ProjectConfiguration } from \"../../cli/project-configuration.ts\";\nimport { runSandboxCommandEffect, type SandboxCommandFacts, type SandboxCommandFlags, } from \"../cli-commands.ts\";\n/** Sandbox owns this schema: its flags never enter the core CLI parser. */\nexport const SANDBOX_CLI_OPTIONS = Object.freeze({\n    all: Object.freeze({ type: \"boolean\", help: Object.freeze({ summary: \"Destroy every kept sandbox.\", visibility: \"public\" }) }),\n    window: Object.freeze({ type: \"string\", help: Object.freeze({ summary: \"Select one recorded change window.\", visibility: \"public\" }) }),\n    path: Object.freeze({ type: \"string\", help: Object.freeze({ summary: \"Select one path in a sandbox diff.\", visibility: \"public\" }) }),\n    \"leave-running\": Object.freeze({ type: \"boolean\", help: Object.freeze({ summary: \"Keep a sandbox alive after leaving its shell.\", visibility: \"public\" }) }),\n    record: Object.freeze({ type: \"string\", help: Object.freeze({ summary: \"Use a specific NiceEval record root.\", visibility: \"public\" }) }),\n    orphans: Object.freeze({ type: \"boolean\", help: Object.freeze({ summary: \"Inspect unregistered sandbox instances left by terminated runs.\", visibility: \"public\" }) }),\n    force: Object.freeze({ type: \"boolean\", help: Object.freeze({ summary: \"Prune unverified orphan candidates too.\", visibility: \"public\" }) }),\n    help: Object.freeze({ type: \"boolean\", short: \"h\", help: Object.freeze({ summary: \"Show Sandbox command help.\", visibility: \"public\" }) }),\n} satisfies Readonly<Record<string, CliOptionDefinition>>);\nconst SANDBOX_HELP = `niceeval sandbox — inspect and manage kept sandboxes\n\nUsage:\n  niceeval sandbox list [--orphans] [--record <record-root>]\n  niceeval sandbox enter <id> [--leave-running] [--record <record-root>]\n  niceeval sandbox history <id> [--record <record-root>]\n  niceeval sandbox diff <id> [--window <window>] [--path <file>] [--record <record-root>]\n  niceeval sandbox stop <id...> [--all] [--record <record-root>]\n  niceeval sandbox prune [--force] [--record <record-root>]\n\nCommands:\n  list       list kept sandboxes or inspect orphan candidates\n  enter      open a shell in a kept sandbox\n  history    show the kept sandbox's change windows\n  diff       print patches from one or all change windows\n  stop       destroy kept sandboxes and remove their registry entries\n  prune      destroy orphaned sandbox instances\n`;\nconst SANDBOX_SUBCOMMANDS = [\"list\", \"enter\", \"history\", \"diff\", \"stop\", \"prune\"] as const;\ntype SandboxSubcommand = (typeof SANDBOX_SUBCOMMANDS)[number];\ninterface ParsedSandboxArgs {\n    readonly positionals: readonly string[];\n    readonly providedOptions: readonly string[];\n    readonly flags: SandboxCommandFlags;\n    readonly help: boolean;\n}\ntype SandboxCliError = CliFeatureError;\nfunction sandboxFailure(operation: string, cause: unknown, exitCode = 1): SandboxCliError {\n    return new CliFeatureError({ feature: \"sandbox\", operation, cause, exitCode });\n}\nfunction isSandboxSubcommand(value: string | undefined): value is SandboxSubcommand {\n    return value !== undefined && (SANDBOX_SUBCOMMANDS as readonly string[]).includes(value);\n}\nfunction parseSandboxArgs(argv: readonly string[], parse: (argv: readonly string[], options: Readonly<Record<string, CliOptionDefinition>>) => CliParsedTokens): ParsedSandboxArgs {\n    const parsed = parse(argv, SANDBOX_CLI_OPTIONS);\n    return Object.freeze({\n        positionals: Object.freeze([...parsed.positionals]),\n        providedOptions: Object.freeze(parsed.tokens\n            .filter((token) => token.kind === \"option\")\n            .map((token) => token.name)),\n        help: parsed.values.help === true,\n        flags: Object.freeze({\n            all: parsed.values.all === true,\n            ...(typeof parsed.values.window === \"string\" ? { window: parsed.values.window } : {}),\n            ...(typeof parsed.values.path === \"string\" ? { path: parsed.values.path } : {}),\n            leaveRunning: parsed.values[\"leave-running\"] === true,\n            ...(typeof parsed.values.record === \"string\" ? { record: parsed.values.record } : {}),\n            orphans: parsed.values.orphans === true,\n            force: parsed.values.force === true,\n        }),\n    });\n}\nconst SANDBOX_SUBCOMMAND_OPTIONS: Readonly<Record<SandboxSubcommand, readonly string[]>> = Object.freeze({\n    list: Object.freeze([\"orphans\", \"record\", \"help\"]),\n    enter: Object.freeze([\"leave-running\", \"record\", \"help\"]),\n    history: Object.freeze([\"record\", \"help\"]),\n    diff: Object.freeze([\"window\", \"path\", \"record\", \"help\"]),\n    stop: Object.freeze([\"all\", \"record\", \"help\"]),\n    prune: Object.freeze([\"force\", \"record\", \"help\"]),\n});\nfunction write(channel: \"stdout\" | \"stderr\", text: string): Effect.Effect<void, SandboxCliError, CliOutput> {\n    return Effect.flatMap(CliOutput, (output) => channel === \"stdout\" ? output.writeStdout(text) : output.writeStderr(text)).pipe(Effect.mapError((cause) => sandboxFailure(`write ${channel}`, cause)));\n}\nfunction unknownSandboxCommand(command: string | undefined): string {\n    return command === undefined\n        ? `usage: niceeval sandbox <${SANDBOX_SUBCOMMANDS.join(\"|\")}> …\\n`\n        : `unknown sandbox command ${JSON.stringify(command)}\\n${SANDBOX_HELP}`;\n}\n/**\n * Feature-owned root contribution. Syntax outcomes deliberately finish before\n * credential preparation, so help, version, empty input, and unknown input do\n * not load .env, config, or a provider SDK.\n */\nexport const sandboxCliCommand: CliCommandContribution<CliArguments | CliInvocationFacts | CliOutput | CliPath | ProjectConfiguration, SandboxCliError> = Object.freeze({\n    name: \"sandbox\",\n    summary: \"inspect, enter, and clean up kept sandboxes\",\n    options: SANDBOX_CLI_OPTIONS,\n    run: (argv: readonly string[]) => Effect.gen(function* () {\n        const argumentsService = yield* CliArguments;\n        const parsed = yield* Effect.try({\n            try: () => parseSandboxArgs(argv, argumentsService.parse),\n            catch: (cause) => sandboxFailure(\"parse sandbox command\", cause, 1),\n        });\n        const subcommand = parsed.positionals[0];\n        if (subcommand === undefined && parsed.help) {\n            yield* write(\"stdout\", SANDBOX_HELP);\n            return 0;\n        }\n        if (!isSandboxSubcommand(subcommand)) {\n            yield* write(\"stderr\", unknownSandboxCommand(subcommand));\n            return 1;\n        }\n        const unsupportedOption = parsed.providedOptions.find((name) => !SANDBOX_SUBCOMMAND_OPTIONS[subcommand].includes(name));\n        if (unsupportedOption !== undefined) {\n            yield* write(\"stderr\", `niceeval sandbox ${subcommand} does not accept --${unsupportedOption}.\\n`);\n            return 1;\n        }\n        if (parsed.help) {\n            yield* write(\"stdout\", SANDBOX_HELP);\n            return 0;\n        }\n        const invocation = yield* CliInvocationFacts;\n        const facts = yield* invocation.facts.pipe(Effect.mapError((cause) => sandboxFailure(\"read invocation facts\", cause)));\n        const configuration = yield* ProjectConfiguration;\n        yield* configuration.prepare(facts.cwd).pipe(Effect.mapError((cause) => sandboxFailure(\"prepare project credentials\", cause)));\n        const path = yield* CliPath;\n        const record = parsed.flags.record === undefined ? undefined : path.resolve(facts.cwd, parsed.flags.record);\n        const commandFacts: SandboxCommandFacts = Object.freeze({\n            leaseHolder: `${facts.pid}@${facts.hostname}`,\n            ...(facts.noColor === undefined ? {} : { noColor: facts.noColor }),\n            stdout: facts.stdout,\n        });\n        const output = yield* CliOutput;\n        return yield* runSandboxCommandEffect(facts.cwd, [...parsed.positionals], record === undefined ? parsed.flags : { ...parsed.flags, record }, { out: output.writeStdoutSync, err: output.writeStderrSync }, commandFacts).pipe(Effect.mapError((cause) => sandboxFailure(\"run sandbox command\", cause)));\n    }),\n});\n"]}

package/dist/sandbox/cli/contribution.d.cts

@@ -0,0 +1,71 @@
+import { CliArguments, CliInvocationFacts, CliOutput, CliPath } from "../../cli/application.cjs";
+import { CliFeatureError, type CliCommandContribution } from "../../cli/contribution.cjs";
+import { ProjectConfiguration } from "../../cli/project-configuration.cjs";
+/** Sandbox owns this schema: its flags never enter the core CLI parser. */
+export declare const SANDBOX_CLI_OPTIONS: Readonly<{
+    all: Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Destroy every kept sandbox.";
+            visibility: "public";
+        }>;
+    }>;
+    window: Readonly<{
+        type: "string";
+        help: Readonly<{
+            summary: "Select one recorded change window.";
+            visibility: "public";
+        }>;
+    }>;
+    path: Readonly<{
+        type: "string";
+        help: Readonly<{
+            summary: "Select one path in a sandbox diff.";
+            visibility: "public";
+        }>;
+    }>;
+    "leave-running": Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Keep a sandbox alive after leaving its shell.";
+            visibility: "public";
+        }>;
+    }>;
+    record: Readonly<{
+        type: "string";
+        help: Readonly<{
+            summary: "Use a specific NiceEval record root.";
+            visibility: "public";
+        }>;
+    }>;
+    orphans: Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Inspect unregistered sandbox instances left by terminated runs.";
+            visibility: "public";
+        }>;
+    }>;
+    force: Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Prune unverified orphan candidates too.";
+            visibility: "public";
+        }>;
+    }>;
+    help: Readonly<{
+        type: "boolean";
+        short: "h";
+        help: Readonly<{
+            summary: "Show Sandbox command help.";
+            visibility: "public";
+        }>;
+    }>;
+}>;
+type SandboxCliError = CliFeatureError;
+/**
+ * Feature-owned root contribution. Syntax outcomes deliberately finish before
+ * credential preparation, so help, version, empty input, and unknown input do
+ * not load .env, config, or a provider SDK.
+ */
+export declare const sandboxCliCommand: CliCommandContribution<CliArguments | CliInvocationFacts | CliOutput | CliPath | ProjectConfiguration, SandboxCliError>;
+export {};

package/dist/sandbox/cli/contribution.d.mts

@@ -0,0 +1,71 @@
+import { CliArguments, CliInvocationFacts, CliOutput, CliPath } from "../../cli/application.mjs";
+import { CliFeatureError, type CliCommandContribution } from "../../cli/contribution.mjs";
+import { ProjectConfiguration } from "../../cli/project-configuration.mjs";
+/** Sandbox owns this schema: its flags never enter the core CLI parser. */
+export declare const SANDBOX_CLI_OPTIONS: Readonly<{
+    all: Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Destroy every kept sandbox.";
+            visibility: "public";
+        }>;
+    }>;
+    window: Readonly<{
+        type: "string";
+        help: Readonly<{
+            summary: "Select one recorded change window.";
+            visibility: "public";
+        }>;
+    }>;
+    path: Readonly<{
+        type: "string";
+        help: Readonly<{
+            summary: "Select one path in a sandbox diff.";
+            visibility: "public";
+        }>;
+    }>;
+    "leave-running": Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Keep a sandbox alive after leaving its shell.";
+            visibility: "public";
+        }>;
+    }>;
+    record: Readonly<{
+        type: "string";
+        help: Readonly<{
+            summary: "Use a specific NiceEval record root.";
+            visibility: "public";
+        }>;
+    }>;
+    orphans: Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Inspect unregistered sandbox instances left by terminated runs.";
+            visibility: "public";
+        }>;
+    }>;
+    force: Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Prune unverified orphan candidates too.";
+            visibility: "public";
+        }>;
+    }>;
+    help: Readonly<{
+        type: "boolean";
+        short: "h";
+        help: Readonly<{
+            summary: "Show Sandbox command help.";
+            visibility: "public";
+        }>;
+    }>;
+}>;
+type SandboxCliError = CliFeatureError;
+/**
+ * Feature-owned root contribution. Syntax outcomes deliberately finish before
+ * credential preparation, so help, version, empty input, and unknown input do
+ * not load .env, config, or a provider SDK.
+ */
+export declare const sandboxCliCommand: CliCommandContribution<CliArguments | CliInvocationFacts | CliOutput | CliPath | ProjectConfiguration, SandboxCliError>;
+export {};

package/dist/sandbox/cli/contribution.d.ts

@@ -0,0 +1,71 @@
+import { CliArguments, CliInvocationFacts, CliOutput, CliPath } from "../../cli/application.js";
+import { CliFeatureError, type CliCommandContribution } from "../../cli/contribution.js";
+import { ProjectConfiguration } from "../../cli/project-configuration.js";
+/** Sandbox owns this schema: its flags never enter the core CLI parser. */
+export declare const SANDBOX_CLI_OPTIONS: Readonly<{
+    all: Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Destroy every kept sandbox.";
+            visibility: "public";
+        }>;
+    }>;
+    window: Readonly<{
+        type: "string";
+        help: Readonly<{
+            summary: "Select one recorded change window.";
+            visibility: "public";
+        }>;
+    }>;
+    path: Readonly<{
+        type: "string";
+        help: Readonly<{
+            summary: "Select one path in a sandbox diff.";
+            visibility: "public";
+        }>;
+    }>;
+    "leave-running": Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Keep a sandbox alive after leaving its shell.";
+            visibility: "public";
+        }>;
+    }>;
+    record: Readonly<{
+        type: "string";
+        help: Readonly<{
+            summary: "Use a specific NiceEval record root.";
+            visibility: "public";
+        }>;
+    }>;
+    orphans: Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Inspect unregistered sandbox instances left by terminated runs.";
+            visibility: "public";
+        }>;
+    }>;
+    force: Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Prune unverified orphan candidates too.";
+            visibility: "public";
+        }>;
+    }>;
+    help: Readonly<{
+        type: "boolean";
+        short: "h";
+        help: Readonly<{
+            summary: "Show Sandbox command help.";
+            visibility: "public";
+        }>;
+    }>;
+}>;
+type SandboxCliError = CliFeatureError;
+/**
+ * Feature-owned root contribution. Syntax outcomes deliberately finish before
+ * credential preparation, so help, version, empty input, and unknown input do
+ * not load .env, config, or a provider SDK.
+ */
+export declare const sandboxCliCommand: CliCommandContribution<CliArguments | CliInvocationFacts | CliOutput | CliPath | ProjectConfiguration, SandboxCliError>;
+export {};

package/dist/sandbox/cli/contribution.js

@@ -0,0 +1,8 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./contribution.cjs");
+const __niceevalExport0 = __niceevalCanonical["SANDBOX_CLI_OPTIONS"];
+export { __niceevalExport0 as SANDBOX_CLI_OPTIONS };
+const __niceevalExport1 = __niceevalCanonical["sandboxCliCommand"];
+export { __niceevalExport1 as sandboxCliCommand };
+//# sourceMappingURL=contribution.js.map

package/dist/sandbox/cli/contribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution.js","sources":[],"names":[],"mappings":""}

package/dist/sandbox/cli-commands.cjs

@@ -7,8 +7,6 @@ exports.keptSandboxReminderEffect = keptSandboxReminderEffect;
 // `niceeval sandbox` 命令组:查看与销毁留存的沙箱(见 docs/feature/sandbox/cli.md)。
 // 不读 niceeval.config.ts、不发现 eval,只操作留存注册表(.niceeval/sandboxes/ 逐条目文件)
 // 与内置 provider 的 detached 能力;provider 名的路由发生在 CLI / 注册表边界(sandbox/ 域内)。
-const node_os_1 = require("node:os");
-const node_path_1 = require("node:path");
 const effect_1 = require("effect");
 const keep_ts_1 = require("./keep.cjs");
 const keep_registry_ts_1 = require("./keep-registry.cjs");
@@ -59,18 +57,17 @@ function refreshedEntryState(entry, state, now) {
 /** `list`/`history` 一次性面板的传输能力:是 TTY 且没有要求朴素输出时才画框
  *  (docs/feature/sandbox/cli.md「输出体裁」)——`sandbox` 命令组只在启动时探测一次,
  *  不像 `exp` 的 live 面板那样需要随 resize 重新判断。 */
-function panelCapabilityForIo(io) {
+function panelCapabilityForFacts(facts) {
     return (0, panel_ts_1.panelCapabilityOf)({
-        isTTY: io.isTTY ?? process.stdout.isTTY,
-        noColor: process.env.NO_COLOR,
-        width: io.columns ?? process.stdout.columns,
+        isTTY: facts.stdout.isTTY,
+        noColor: facts.noColor,
+        width: facts.stdout.columns,
     });
 }
-/** Effect 主入口：CLI 可将它接进自己的唯一 runtime，不启动嵌套 Promise runtime。 */
-function runSandboxCommandEffect(cwd, positionals, flags, io = { out: (s) => process.stdout.write(s), err: (s) => process.stderr.write(s) }) {
+function runSandboxCommandEffect(cwd, positionals, flags, io, facts) {
     return effect_1.Effect.gen(function* () {
         const sub = positionals[0];
-        const root = yield* resolveRegistryRootEffect(cwd, flags.run);
+        const root = yield* resolveRegistryRootEffect(cwd, flags.record);
         if (root === undefined) {
             io.err(`No .niceeval directory found from ${cwd} upward. Run this inside the project, or pass --record <record-root> to point at it.\n`);
             return 1;
@@ -79,13 +76,13 @@ function runSandboxCommandEffect(cwd, positionals, flags, io = { out: (s) => pro
             case "list":
                 return yield* (flags.orphans
                     ? listOrphansCommandEffect(root, io)
-                    : listCommandEffect(root, io, panelCapabilityForIo(io)));
+                    : listCommandEffect(root, io, panelCapabilityForFacts(facts)));
             case "stop":
                 return yield* stopCommandEffect(root, positionals.slice(1), flags, io);
             case "enter":
-                return yield* enterCommandEffect(root, positionals.slice(1), flags, io);
+                return yield* enterCommandEffect(root, positionals.slice(1), flags, io, facts);
             case "history":
-                return yield* historyCommandEffect(root, positionals.slice(1), flags, io, panelCapabilityForIo(io));
+                return yield* historyCommandEffect(root, positionals.slice(1), flags, io, panelCapabilityForFacts(facts));
             case "diff":
                 return yield* diffCommandEffect(root, positionals.slice(1), flags, io);
             case "prune":
@@ -166,9 +163,8 @@ function orphanReminderEffect(cwd) {
 }
 function resolveRegistryRootEffect(cwd, runFlag) {
     if (runFlag !== undefined) {
-        const base = (0, node_path_1.resolve)(cwd, runFlag);
         // --record 可以指 .niceeval 本身或它的父目录。
-        return effect_1.Effect.succeed(base.endsWith(".niceeval") ? base : `${base}/.niceeval`);
+        return effect_1.Effect.succeed(runFlag.endsWith(".niceeval") ? runFlag : `${runFlag}/.niceeval`);
     }
     return (0, keep_registry_ts_1.findNiceevalRootEffect)(cwd);
 }
@@ -252,9 +248,6 @@ function resolveEntriesEffect(root, ids, io) {
         return resolved;
     }));
 }
-function leaseHolder() {
-    return `${process.pid}@${(0, node_os_1.hostname)()}`;
-}
 function stopCommandEffect(root, ids, flags, io) {
     return effect_1.Effect.gen(function* () {
         let targets;
@@ -294,8 +287,8 @@ function stopCommandEffect(root, ids, flags, io) {
         return code;
     });
 }
-function withLeaseEffect(root, id, entry, op, io, fn) {
-    const lease = { holder: leaseHolder(), op, acquiredAt: new Date().toISOString(), ttlMs: LEASE_TTL_MS };
+function withLeaseEffect(root, id, entry, op, io, facts, fn) {
+    const lease = { holder: facts.leaseHolder, op, acquiredAt: new Date().toISOString(), ttlMs: LEASE_TTL_MS };
     return (0, keep_registry_ts_1.acquireKeptLeaseEffect)(root, id, lease).pipe(effect_1.Effect.flatMap((acquired) => {
         if (!acquired.acquired) {
             io.err(`${entry.sandboxId} is in use by ${acquired.lease.holder} since ${acquired.lease.acquiredAt}\n`);
@@ -304,7 +297,7 @@ function withLeaseEffect(root, id, entry, op, io, fn) {
         return ensuringWithTypedFinalizer(fn(), (0, keep_registry_ts_1.releaseKeptLeaseEffect)(root, id, acquired.token));
     }));
 }
-function enterCommandEffect(root, ids, flags, io) {
+function enterCommandEffect(root, ids, flags, io, facts) {
     return resolveEntriesEffect(root, ids.slice(0, 1), io).pipe(effect_1.Effect.flatMap((resolved) => {
         if (!resolved || resolved.length === 0) {
             if (ids.length === 0)
@@ -326,7 +319,7 @@ function enterCommandEffect(root, ids, flags, io) {
                 io.err(`${entry.sandboxId} (${entry.provider}) could not be inspected — check credentials or retry later.\n`);
                 return effect_1.Effect.succeed(1);
             }
-            return withLeaseEffect(root, id, entry, "enter", io, () => effect_1.Effect.gen(function* () {
+            return withLeaseEffect(root, id, entry, "enter", io, facts, () => effect_1.Effect.gen(function* () {
                 yield* providerEffect("wake kept sandbox", () => (0, keep_ts_1.wakeDetached)(entry.provider, entry.sandboxId));
                 yield* (0, keep_registry_ts_1.updateKeptEntryEffect)(root, id, (current) => refreshedEntryState(current, "alive", new Date().toISOString()));
                 const code = yield* providerEffect("open kept sandbox shell", () => (0, keep_ts_1.openInteractiveShell)(entry.provider, entry.sandboxId, entry.workdir)).pipe(effect_1.Effect.catchAll((error) => effect_1.Effect.sync(() => {