niceeval 0.13.1 → 0.13.2

package/dist/sandbox/keep-registry.cjs

@@ -56,77 +56,39 @@ function readTextIfPresentEffect(path, operation) {
 function readDirectoryIfPresentEffect(path, operation) {
     return nodeIo(operation, (signal) => (0, promises_1.readdir)(path)).pipe(effect_1.Effect.catchAll((cause) => isAbsent(cause) ? effect_1.Effect.succeed(undefined) : effect_1.Effect.fail(cause)));
 }
-function recordOf(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value)
-        ? value
-        : undefined;
-}
-function isNonNegativeInteger(value) {
-    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
-}
-function isPositiveInteger(value) {
-    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
-}
-function isTimestamp(value) {
-    return typeof value === "string" && Number.isFinite(Date.parse(value));
-}
-function isVerdict(value) {
-    return value === "passed" || value === "failed" || value === "errored" || value === "skipped";
-}
-function isKeptSandboxState(value) {
-    return value === "alive" || value === "dormant" || value === "expired" || value === "unknown";
-}
+const NonNegativeSafeIntegerSchema = effect_1.Schema.Number.pipe(effect_1.Schema.filter((value) => Number.isSafeInteger(value) && value >= 0, { identifier: "NonNegativeSafeInteger" }));
+const PositiveSafeIntegerSchema = effect_1.Schema.Number.pipe(effect_1.Schema.filter((value) => Number.isSafeInteger(value) && value > 0, { identifier: "PositiveSafeInteger" }));
+const TimestampSchema = effect_1.Schema.String.pipe(effect_1.Schema.filter((value) => Number.isFinite(Date.parse(value)), { identifier: "Timestamp" }));
+const KeptSandboxEntrySchema = effect_1.Schema.Struct({
+    sandboxId: effect_1.Schema.String,
+    provider: effect_1.Schema.String,
+    evalId: effect_1.Schema.String,
+    attempt: NonNegativeSafeIntegerSchema,
+    experimentId: effect_1.Schema.optional(effect_1.Schema.String),
+    locator: effect_1.Schema.String,
+    verdict: effect_1.Schema.Literal("passed", "failed", "errored", "skipped"),
+    keptAt: TimestampSchema,
+    workdir: effect_1.Schema.String,
+    enter: effect_1.Schema.optional(effect_1.Schema.String),
+    expiresAt: effect_1.Schema.optional(TimestampSchema),
+    state: effect_1.Schema.Literal("alive", "dormant", "expired", "unknown"),
+});
+const PersistedKeptSandboxLeaseSchema = effect_1.Schema.Struct({
+    holder: effect_1.Schema.String,
+    op: effect_1.Schema.String,
+    acquiredAt: TimestampSchema,
+    ttlMs: PositiveSafeIntegerSchema,
+    token: effect_1.Schema.optional(effect_1.Schema.String),
+});
 /** 留存条目的全部字段均在磁盘边界验证，特别是两个字符串联合与可选时间字段。 */
 function decodeKeptSandboxEntry(value) {
-    const record = recordOf(value);
-    if (record === undefined ||
-        typeof record.sandboxId !== "string" ||
-        typeof record.provider !== "string" ||
-        typeof record.evalId !== "string" ||
-        !isNonNegativeInteger(record.attempt) ||
-        (record.experimentId !== undefined && typeof record.experimentId !== "string") ||
-        typeof record.locator !== "string" ||
-        !isVerdict(record.verdict) ||
-        !isTimestamp(record.keptAt) ||
-        typeof record.workdir !== "string" ||
-        (record.enter !== undefined && typeof record.enter !== "string") ||
-        (record.expiresAt !== undefined && !isTimestamp(record.expiresAt)) ||
-        !isKeptSandboxState(record.state)) {
-        return undefined;
-    }
-    return {
-        sandboxId: record.sandboxId,
-        provider: record.provider,
-        evalId: record.evalId,
-        attempt: record.attempt,
-        ...(record.experimentId === undefined ? {} : { experimentId: record.experimentId }),
-        locator: record.locator,
-        verdict: record.verdict,
-        keptAt: record.keptAt,
-        workdir: record.workdir,
-        ...(record.enter === undefined ? {} : { enter: record.enter }),
-        ...(record.expiresAt === undefined ? {} : { expiresAt: record.expiresAt }),
-        state: record.state,
-    };
+    const decoded = effect_1.Schema.decodeUnknownEither(KeptSandboxEntrySchema)(value);
+    return effect_1.Either.isRight(decoded) ? decoded.right : undefined;
 }
 /** lease 同样来自持久 JSON；token 是内部互斥凭据，可选但类型必须正确。 */
 function decodeKeptSandboxLease(value) {
-    const record = recordOf(value);
-    if (record === undefined ||
-        typeof record.holder !== "string" ||
-        typeof record.op !== "string" ||
-        !isTimestamp(record.acquiredAt) ||
-        !isPositiveInteger(record.ttlMs) ||
-        (record.token !== undefined && typeof record.token !== "string")) {
-        return undefined;
-    }
-    return {
-        holder: record.holder,
-        op: record.op,
-        acquiredAt: record.acquiredAt,
-        ttlMs: record.ttlMs,
-        ...(record.token === undefined ? {} : { token: record.token }),
-    };
+    const decoded = effect_1.Schema.decodeUnknownEither(PersistedKeptSandboxLeaseSchema)(value);
+    return effect_1.Either.isRight(decoded) ? decoded.right : undefined;
 }
 /** entry id:provider + sandboxId 的稳定散列(条目文件名)。 */
 function keptEntryId(provider, sandboxId) {

package/dist/sandbox/keep-registry.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"keep-registry.js","sourceRoot":"","sources":["keep-registry.ts"],"names":[],"mappings":"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","sourcesContent":["// 留存沙箱的持久注册表:`.niceeval/sandboxes/` 下的逐条目文件(不是多个 attempt 竞争改写的\n// 一份 JSON)。entry id 由 provider + sandboxId 做稳定散列;每条走 shared/entry-file-store.ts\n// 的原子写纪律(临时文件 → fsync 文件 → rename → fsync 目录)——不同 attempt 与不同 niceeval\n// 进程不会覆盖彼此。\n// 契约见 docs/feature/sandbox/architecture.md「留存(keep)与注册表」。\n//\n// 条目旁独立的 `.lease` 文件是另一套机制(短命的操作互斥,见 acquireKeptLease 一节),不走\n// entry-file-store 的原子写纪律——lease 的持有点是 `wx` 独占创建本身,不需要 tmp+rename。\nimport { mkdir, open, readdir, readFile, rm, type FileHandle } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { Data, Effect } from \"effect\";\nimport { fsyncDirEffect, hashEntryId, readEntryFileEffect, writeEntryFileEffect, } from \"../shared/entry-file-store.ts\";\nimport type { Verdict } from \"../types.ts\";\n/** 一条留存登记项(逐条目文件的 JSON 形状)。 */\nexport interface KeptSandboxEntry {\n    sandboxId: string;\n    provider: string;\n    evalId: string;\n    attempt: number;\n    experimentId?: string;\n    locator: string;\n    verdict: Verdict;\n    keptAt: string;\n    workdir: string;\n    /** provider 原生的进入命令(直连与审计用);日常入口是 `niceeval sandbox enter`。 */\n    enter?: string;\n    /** 现场可找回的截止时刻——provider 声明了保留期限才写(vercel 写,e2b pause 无限期保留则不写)。 */\n    expiresAt?: string;\n    /** alive = 实例在跑;dormant = 可唤醒;expired = 确认不存在;unknown = 探测失败。 */\n    state: \"alive\" | \"dormant\" | \"expired\" | \"unknown\";\n}\n/** 条目旁独立 lease 文件的内容。注册表条目本体不承载短暂互斥状态。 */\nexport interface KeptSandboxLease {\n    holder: string;\n    op: string;\n    acquiredAt: string;\n    ttlMs: number;\n}\ninterface PersistedKeptSandboxLease extends KeptSandboxLease {\n    token?: string;\n}\n/** 注册表自己的可恢复 I/O 失败；损坏或缺失的逐条目数据仍是成功 ADT。 */\nexport class KeptSandboxRegistryError extends Data.TaggedError(\"KeptSandboxRegistryError\")<{\n    readonly operation: string;\n    readonly cause: unknown;\n}> {\n}\nexport type KeptSandboxRegistryEffect<A> = Effect.Effect<A, KeptSandboxRegistryError>;\ntype RegistryEffect<A> = KeptSandboxRegistryEffect<A>;\nfunction registryError(operation: string, cause: unknown): KeptSandboxRegistryError {\n    return new KeptSandboxRegistryError({ operation, cause });\n}\n/** Node Promise 边界：传入 Effect 的 signal，因而 fiber interruption 能传给支持 AbortSignal 的调用。 */\nfunction nodeIo<A>(operation: string, run: (signal: AbortSignal) => Promise<A>): RegistryEffect<A> {\n    return Effect.tryPromise({\n        try: run,\n        catch: (cause) => registryError(operation, cause),\n    });\n}\nfunction errnoCode(cause: unknown): string | undefined {\n    const original = cause instanceof KeptSandboxRegistryError ? cause.cause : cause;\n    return typeof original === \"object\" && original !== null && \"code\" in original && typeof original.code === \"string\"\n        ? original.code\n        : undefined;\n}\nfunction isAbsent(cause: unknown): boolean {\n    const code = errnoCode(cause);\n    return code === \"ENOENT\" || code === \"ENOTDIR\";\n}\nfunction withOpenFile<A>(operation: string, path: string, flags: string, use: (handle: FileHandle) => RegistryEffect<A>): RegistryEffect<A> {\n    return Effect.scoped(Effect.acquireRelease(nodeIo(`${operation}: open`, (signal) => open(path, flags)), (handle) => nodeIo(`${operation}: close`, () => handle.close()).pipe(Effect.orDie)).pipe(Effect.flatMap(use)));\n}\nfunction readTextIfPresentEffect(path: string, operation: string): RegistryEffect<string | undefined> {\n    return nodeIo(operation, (signal) => readFile(path, { encoding: \"utf-8\", signal })).pipe(Effect.catchAll((cause) => isAbsent(cause) ? Effect.succeed(undefined) : Effect.fail(cause)));\n}\nfunction readDirectoryIfPresentEffect(path: string, operation: string): RegistryEffect<string[] | undefined> {\n    return nodeIo(operation, (signal) => readdir(path)).pipe(Effect.catchAll((cause) => isAbsent(cause) ? Effect.succeed(undefined) : Effect.fail(cause)));\n}\nfunction recordOf(value: unknown): globalThis.Record<string, unknown> | undefined {\n    return typeof value === \"object\" && value !== null && !Array.isArray(value)\n        ? value as globalThis.Record<string, unknown>\n        : undefined;\n}\nfunction isNonNegativeInteger(value: unknown): value is number {\n    return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\nfunction isPositiveInteger(value: unknown): value is number {\n    return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\nfunction isTimestamp(value: unknown): value is string {\n    return typeof value === \"string\" && Number.isFinite(Date.parse(value));\n}\nfunction isVerdict(value: unknown): value is Verdict {\n    return value === \"passed\" || value === \"failed\" || value === \"errored\" || value === \"skipped\";\n}\nfunction isKeptSandboxState(value: unknown): value is KeptSandboxEntry[\"state\"] {\n    return value === \"alive\" || value === \"dormant\" || value === \"expired\" || value === \"unknown\";\n}\n/** 留存条目的全部字段均在磁盘边界验证，特别是两个字符串联合与可选时间字段。 */\nfunction decodeKeptSandboxEntry(value: unknown): KeptSandboxEntry | undefined {\n    const record = recordOf(value);\n    if (record === undefined ||\n        typeof record.sandboxId !== \"string\" ||\n        typeof record.provider !== \"string\" ||\n        typeof record.evalId !== \"string\" ||\n        !isNonNegativeInteger(record.attempt) ||\n        (record.experimentId !== undefined && typeof record.experimentId !== \"string\") ||\n        typeof record.locator !== \"string\" ||\n        !isVerdict(record.verdict) ||\n        !isTimestamp(record.keptAt) ||\n        typeof record.workdir !== \"string\" ||\n        (record.enter !== undefined && typeof record.enter !== \"string\") ||\n        (record.expiresAt !== undefined && !isTimestamp(record.expiresAt)) ||\n        !isKeptSandboxState(record.state)) {\n        return undefined;\n    }\n    return {\n        sandboxId: record.sandboxId,\n        provider: record.provider,\n        evalId: record.evalId,\n        attempt: record.attempt,\n        ...(record.experimentId === undefined ? {} : { experimentId: record.experimentId }),\n        locator: record.locator,\n        verdict: record.verdict,\n        keptAt: record.keptAt,\n        workdir: record.workdir,\n        ...(record.enter === undefined ? {} : { enter: record.enter }),\n        ...(record.expiresAt === undefined ? {} : { expiresAt: record.expiresAt }),\n        state: record.state,\n    };\n}\n/** lease 同样来自持久 JSON；token 是内部互斥凭据，可选但类型必须正确。 */\nfunction decodeKeptSandboxLease(value: unknown): PersistedKeptSandboxLease | undefined {\n    const record = recordOf(value);\n    if (record === undefined ||\n        typeof record.holder !== \"string\" ||\n        typeof record.op !== \"string\" ||\n        !isTimestamp(record.acquiredAt) ||\n        !isPositiveInteger(record.ttlMs) ||\n        (record.token !== undefined && typeof record.token !== \"string\")) {\n        return undefined;\n    }\n    return {\n        holder: record.holder,\n        op: record.op,\n        acquiredAt: record.acquiredAt,\n        ttlMs: record.ttlMs,\n        ...(record.token === undefined ? {} : { token: record.token }),\n    };\n}\n/** entry id:provider + sandboxId 的稳定散列(条目文件名)。 */\nexport function keptEntryId(provider: string, sandboxId: string): string {\n    return hashEntryId([provider, sandboxId]);\n}\nexport function sandboxesDirOf(niceevalRoot: string): string {\n    return join(niceevalRoot, \"sandboxes\");\n}\nfunction leasePath(niceevalRoot: string, id: string): string {\n    return join(sandboxesDirOf(niceevalRoot), `${id}.lease`);\n}\n/** 读取当前 lease；坏文件也视为占坑，避免在不明状态下并发操作现场。 */\nfunction readPersistedKeptLeaseEffect(niceevalRoot: string, id: string): RegistryEffect<PersistedKeptSandboxLease | undefined> {\n    return readTextIfPresentEffect(leasePath(niceevalRoot, id), \"read kept sandbox lease\").pipe(Effect.map((raw) => {\n        if (raw === undefined)\n            return undefined;\n        try {\n            return decodeKeptSandboxLease(JSON.parse(raw));\n        }\n        catch {\n            return undefined;\n        }\n    }));\n}\nexport function readKeptLeaseEffect(niceevalRoot: string, id: string): RegistryEffect<KeptSandboxLease | undefined> {\n    return readPersistedKeptLeaseEffect(niceevalRoot, id).pipe(Effect.map((lease) => lease === undefined\n        ? undefined\n        : {\n            holder: lease.holder,\n            op: lease.op,\n            acquiredAt: lease.acquiredAt,\n            ttlMs: lease.ttlMs,\n        }));\n}\nfunction createKeptLeaseExclusiveEffect(dir: string, id: string, payload: PersistedKeptSandboxLease): RegistryEffect<boolean> {\n    const path = leasePathFromDir(dir, id);\n    return nodeIo(\"create kept sandbox lease directory\", () => mkdir(dir, { recursive: true })).pipe(Effect.zipRight(withOpenFile(\"create kept sandbox lease\", path, \"wx\", (handle) => nodeIo(\"write kept sandbox lease\", (signal) => handle.writeFile(JSON.stringify(payload), { encoding: \"utf-8\", signal })).pipe(Effect.zipRight(nodeIo(\"sync kept sandbox lease\", () => handle.sync()))))), Effect.as(true), Effect.catchAll((cause) => errnoCode(cause) === \"EEXIST\" ? Effect.succeed(false) : Effect.fail(cause)));\n}\nfunction leasePathFromDir(dir: string, id: string): string {\n    return join(dir, `${id}.lease`);\n}\n/**\n * 原子占坑：`wx` 是唯一持有点。TTL 到期时先移除旧文件、再重新竞争；因此旧持有者 finally\n * 只会尝试删除带自己 token 的文件，绝不剥离后来者。\n */\nexport function acquireKeptLeaseEffect(niceevalRoot: string, id: string, lease: KeptSandboxLease): RegistryEffect<{\n    acquired: true;\n    token: string;\n} | {\n    acquired: false;\n    lease: KeptSandboxLease;\n}> {\n    const dir = sandboxesDirOf(niceevalRoot);\n    const path = leasePathFromDir(dir, id);\n    return Effect.gen(function* () {\n        const token = `${lease.holder}:${lease.acquiredAt}:${Math.random().toString(36).slice(2)}`;\n        const payload = { ...lease, token };\n        for (let attempt = 0; attempt < 2; attempt += 1) {\n            if (yield* createKeptLeaseExclusiveEffect(dir, id, payload))\n                return { acquired: true, token };\n            const current = yield* readKeptLeaseEffect(niceevalRoot, id);\n            if (current && Date.now() - Date.parse(current.acquiredAt) < current.ttlMs) {\n                return { acquired: false, lease: current };\n            }\n            // 过期或损坏的 lease 可以被接管；unlink 后所有竞争者重新 wx，不能覆盖彼此。\n            yield* nodeIo(\"remove expired kept sandbox lease\", () => rm(path, { force: true }));\n        }\n        const current = yield* readKeptLeaseEffect(niceevalRoot, id);\n        return { acquired: false, lease: current ?? lease };\n    });\n}\nexport function releaseKeptLeaseEffect(niceevalRoot: string, id: string, token: string): RegistryEffect<void> {\n    const path = leasePath(niceevalRoot, id);\n    return readPersistedKeptLeaseEffect(niceevalRoot, id).pipe(Effect.flatMap((current) => current?.token === token\n        ? nodeIo(\"release kept sandbox lease\", () => rm(path, { force: true }))\n        : Effect.void));\n}\n/**\n * 注册表发现:从 cwd 向上找最近的 `.niceeval/`(与结果根发现同一规则)。\n * 找不到返回 undefined,调用方报错并提示 `--run <结果根>`。\n */\nexport function findNiceevalRootEffect(cwd: string): RegistryEffect<string | undefined> {\n    return Effect.gen(function* () {\n        let current = resolve(cwd);\n        for (;;) {\n            const candidate = join(current, \".niceeval\");\n            const entries = yield* readDirectoryIfPresentEffect(candidate, \"find .niceeval directory\");\n            if (entries !== undefined)\n                return candidate;\n            const parent = dirname(current);\n            if (parent === current)\n                return undefined;\n            current = parent;\n        }\n    });\n}\n/** 原子写入一条登记项(委托给共享层的 write-tmp-then-rename 纪律)。 */\nexport function writeKeptEntryEffect(niceevalRoot: string, entry: KeptSandboxEntry): RegistryEffect<void> {\n    const id = keptEntryId(entry.provider, entry.sandboxId);\n    return writeEntryFileEffect(sandboxesDirOf(niceevalRoot), id, entry).pipe(Effect.mapError((cause) => registryError(\"write kept sandbox entry\", cause)));\n}\n/**\n * 读全部登记项(坏条目跳过并记名,不整体失败)。逐条目解析走共享层的 `readEntryFile`(损坏\n * 返回 undefined、不抛错);目录扫描与 malformed 文件名收集是留存注册表自己的诊断需求\n * (`readAllEntryFiles` 只做静默跳过,不回传坏文件名),因此这里保留自己的扫描循环。\n */\nexport function readKeptEntriesEffect(niceevalRoot: string): RegistryEffect<{\n    entries: {\n        id: string;\n        entry: KeptSandboxEntry;\n    }[];\n    malformed: string[];\n}> {\n    const dir = sandboxesDirOf(niceevalRoot);\n    return Effect.gen(function* () {\n        const files = (yield* readDirectoryIfPresentEffect(dir, \"read kept sandbox registry directory\")) ?? [];\n        const decoded = yield* Effect.forEach(files, (file) => {\n            if (!file.endsWith(\".json\") || file.startsWith(\".\"))\n                return Effect.succeed(undefined);\n            const id = file.slice(0, -\".json\".length);\n            return readEntryFileEffect(dir, id, decodeKeptSandboxEntry).pipe(Effect.mapError((cause) => registryError(\"read kept sandbox entry\", cause)), Effect.map((entry) => ({ file, id, entry })));\n        });\n        const entries: {\n            id: string;\n            entry: KeptSandboxEntry;\n        }[] = [];\n        const malformed: string[] = [];\n        for (const decodedEntry of decoded) {\n            if (decodedEntry === undefined)\n                continue;\n            if (decodedEntry.entry === undefined)\n                malformed.push(decodedEntry.file);\n            else\n                entries.push({ id: decodedEntry.id, entry: decodedEntry.entry });\n        }\n        entries.sort((a, b) => a.entry.keptAt.localeCompare(b.entry.keptAt));\n        return { entries, malformed };\n    });\n}\n/** 更新一条登记项(读-改-原子写;字段浅合并)。条目不存在时静默返回 false。 */\nexport function updateKeptEntryEffect(niceevalRoot: string, id: string, patch: Partial<KeptSandboxEntry> | ((entry: KeptSandboxEntry) => KeptSandboxEntry)): RegistryEffect<boolean> {\n    const dir = sandboxesDirOf(niceevalRoot);\n    return readEntryFileEffect(dir, id, decodeKeptSandboxEntry).pipe(Effect.mapError((cause) => registryError(\"read kept sandbox entry for update\", cause)), Effect.flatMap((entry) => {\n        if (entry === undefined)\n            return Effect.succeed(false);\n        const next = typeof patch === \"function\" ? patch(entry) : { ...entry, ...patch };\n        return writeKeptEntryEffect(niceevalRoot, next).pipe(Effect.as(true));\n    }));\n}\n/** 删除一条登记项并同步目录(只在实例成功销毁或确认已不存在后调用)。 */\nexport function removeKeptEntryEffect(niceevalRoot: string, id: string): RegistryEffect<void> {\n    const dir = sandboxesDirOf(niceevalRoot);\n    return nodeIo(\"remove kept sandbox entry\", () => rm(join(dir, `${id}.json`), { force: true })).pipe(Effect.zipRight(fsyncDirEffect(dir).pipe(Effect.mapError((cause) => registryError(\"sync kept sandbox registry directory\", cause)))));\n}\n"]}
+{"version":3,"file":"keep-registry.js","sourceRoot":"","sources":["keep-registry.ts"],"names":[],"mappings":"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","sourcesContent":["// 留存沙箱的持久注册表:`.niceeval/sandboxes/` 下的逐条目文件(不是多个 attempt 竞争改写的\n// 一份 JSON)。entry id 由 provider + sandboxId 做稳定散列;每条走 shared/entry-file-store.ts\n// 的原子写纪律(临时文件 → fsync 文件 → rename → fsync 目录)——不同 attempt 与不同 niceeval\n// 进程不会覆盖彼此。\n// 契约见 docs/feature/sandbox/architecture.md「留存(keep)与注册表」。\n//\n// 条目旁独立的 `.lease` 文件是另一套机制(短命的操作互斥,见 acquireKeptLease 一节),不走\n// entry-file-store 的原子写纪律——lease 的持有点是 `wx` 独占创建本身,不需要 tmp+rename。\nimport { mkdir, open, readdir, readFile, rm, type FileHandle } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { Data, Effect, Either, Schema } from \"effect\";\nimport { fsyncDirEffect, hashEntryId, readEntryFileEffect, writeEntryFileEffect, } from \"../shared/entry-file-store.ts\";\nimport type { Verdict } from \"../types.ts\";\n/** 一条留存登记项(逐条目文件的 JSON 形状)。 */\nexport interface KeptSandboxEntry {\n    sandboxId: string;\n    provider: string;\n    evalId: string;\n    attempt: number;\n    experimentId?: string;\n    locator: string;\n    verdict: Verdict;\n    keptAt: string;\n    workdir: string;\n    /** provider 原生的进入命令(直连与审计用);日常入口是 `niceeval sandbox enter`。 */\n    enter?: string;\n    /** 现场可找回的截止时刻——provider 声明了保留期限才写(vercel 写,e2b pause 无限期保留则不写)。 */\n    expiresAt?: string;\n    /** alive = 实例在跑;dormant = 可唤醒;expired = 确认不存在;unknown = 探测失败。 */\n    state: \"alive\" | \"dormant\" | \"expired\" | \"unknown\";\n}\n/** 条目旁独立 lease 文件的内容。注册表条目本体不承载短暂互斥状态。 */\nexport interface KeptSandboxLease {\n    holder: string;\n    op: string;\n    acquiredAt: string;\n    ttlMs: number;\n}\ninterface PersistedKeptSandboxLease extends KeptSandboxLease {\n    token?: string;\n}\n/** 注册表自己的可恢复 I/O 失败；损坏或缺失的逐条目数据仍是成功 ADT。 */\nexport class KeptSandboxRegistryError extends Data.TaggedError(\"KeptSandboxRegistryError\")<{\n    readonly operation: string;\n    readonly cause: unknown;\n}> {\n}\nexport type KeptSandboxRegistryEffect<A> = Effect.Effect<A, KeptSandboxRegistryError>;\ntype RegistryEffect<A> = KeptSandboxRegistryEffect<A>;\nfunction registryError(operation: string, cause: unknown): KeptSandboxRegistryError {\n    return new KeptSandboxRegistryError({ operation, cause });\n}\n/** Node Promise 边界：传入 Effect 的 signal，因而 fiber interruption 能传给支持 AbortSignal 的调用。 */\nfunction nodeIo<A>(operation: string, run: (signal: AbortSignal) => Promise<A>): RegistryEffect<A> {\n    return Effect.tryPromise({\n        try: run,\n        catch: (cause) => registryError(operation, cause),\n    });\n}\nfunction errnoCode(cause: unknown): string | undefined {\n    const original = cause instanceof KeptSandboxRegistryError ? cause.cause : cause;\n    return typeof original === \"object\" && original !== null && \"code\" in original && typeof original.code === \"string\"\n        ? original.code\n        : undefined;\n}\nfunction isAbsent(cause: unknown): boolean {\n    const code = errnoCode(cause);\n    return code === \"ENOENT\" || code === \"ENOTDIR\";\n}\nfunction withOpenFile<A>(operation: string, path: string, flags: string, use: (handle: FileHandle) => RegistryEffect<A>): RegistryEffect<A> {\n    return Effect.scoped(Effect.acquireRelease(nodeIo(`${operation}: open`, (signal) => open(path, flags)), (handle) => nodeIo(`${operation}: close`, () => handle.close()).pipe(Effect.orDie)).pipe(Effect.flatMap(use)));\n}\nfunction readTextIfPresentEffect(path: string, operation: string): RegistryEffect<string | undefined> {\n    return nodeIo(operation, (signal) => readFile(path, { encoding: \"utf-8\", signal })).pipe(Effect.catchAll((cause) => isAbsent(cause) ? Effect.succeed(undefined) : Effect.fail(cause)));\n}\nfunction readDirectoryIfPresentEffect(path: string, operation: string): RegistryEffect<string[] | undefined> {\n    return nodeIo(operation, (signal) => readdir(path)).pipe(Effect.catchAll((cause) => isAbsent(cause) ? Effect.succeed(undefined) : Effect.fail(cause)));\n}\nconst NonNegativeSafeIntegerSchema = Schema.Number.pipe(Schema.filter((value) => Number.isSafeInteger(value) && value >= 0, { identifier: \"NonNegativeSafeInteger\" }));\nconst PositiveSafeIntegerSchema = Schema.Number.pipe(Schema.filter((value) => Number.isSafeInteger(value) && value > 0, { identifier: \"PositiveSafeInteger\" }));\nconst TimestampSchema = Schema.String.pipe(Schema.filter((value) => Number.isFinite(Date.parse(value)), { identifier: \"Timestamp\" }));\nconst KeptSandboxEntrySchema = Schema.Struct({\n    sandboxId: Schema.String,\n    provider: Schema.String,\n    evalId: Schema.String,\n    attempt: NonNegativeSafeIntegerSchema,\n    experimentId: Schema.optional(Schema.String),\n    locator: Schema.String,\n    verdict: Schema.Literal(\"passed\", \"failed\", \"errored\", \"skipped\"),\n    keptAt: TimestampSchema,\n    workdir: Schema.String,\n    enter: Schema.optional(Schema.String),\n    expiresAt: Schema.optional(TimestampSchema),\n    state: Schema.Literal(\"alive\", \"dormant\", \"expired\", \"unknown\"),\n});\nconst PersistedKeptSandboxLeaseSchema = Schema.Struct({\n    holder: Schema.String,\n    op: Schema.String,\n    acquiredAt: TimestampSchema,\n    ttlMs: PositiveSafeIntegerSchema,\n    token: Schema.optional(Schema.String),\n});\n/** 留存条目的全部字段均在磁盘边界验证，特别是两个字符串联合与可选时间字段。 */\nfunction decodeKeptSandboxEntry(value: unknown): KeptSandboxEntry | undefined {\n    const decoded = Schema.decodeUnknownEither(KeptSandboxEntrySchema)(value);\n    return Either.isRight(decoded) ? decoded.right : undefined;\n}\n/** lease 同样来自持久 JSON；token 是内部互斥凭据，可选但类型必须正确。 */\nfunction decodeKeptSandboxLease(value: unknown): PersistedKeptSandboxLease | undefined {\n    const decoded = Schema.decodeUnknownEither(PersistedKeptSandboxLeaseSchema)(value);\n    return Either.isRight(decoded) ? decoded.right : undefined;\n}\n/** entry id:provider + sandboxId 的稳定散列(条目文件名)。 */\nexport function keptEntryId(provider: string, sandboxId: string): string {\n    return hashEntryId([provider, sandboxId]);\n}\nexport function sandboxesDirOf(niceevalRoot: string): string {\n    return join(niceevalRoot, \"sandboxes\");\n}\nfunction leasePath(niceevalRoot: string, id: string): string {\n    return join(sandboxesDirOf(niceevalRoot), `${id}.lease`);\n}\n/** 读取当前 lease；坏文件也视为占坑，避免在不明状态下并发操作现场。 */\nfunction readPersistedKeptLeaseEffect(niceevalRoot: string, id: string): RegistryEffect<PersistedKeptSandboxLease | undefined> {\n    return readTextIfPresentEffect(leasePath(niceevalRoot, id), \"read kept sandbox lease\").pipe(Effect.map((raw) => {\n        if (raw === undefined)\n            return undefined;\n        try {\n            return decodeKeptSandboxLease(JSON.parse(raw));\n        }\n        catch {\n            return undefined;\n        }\n    }));\n}\nexport function readKeptLeaseEffect(niceevalRoot: string, id: string): RegistryEffect<KeptSandboxLease | undefined> {\n    return readPersistedKeptLeaseEffect(niceevalRoot, id).pipe(Effect.map((lease) => lease === undefined\n        ? undefined\n        : {\n            holder: lease.holder,\n            op: lease.op,\n            acquiredAt: lease.acquiredAt,\n            ttlMs: lease.ttlMs,\n        }));\n}\nfunction createKeptLeaseExclusiveEffect(dir: string, id: string, payload: PersistedKeptSandboxLease): RegistryEffect<boolean> {\n    const path = leasePathFromDir(dir, id);\n    return nodeIo(\"create kept sandbox lease directory\", () => mkdir(dir, { recursive: true })).pipe(Effect.zipRight(withOpenFile(\"create kept sandbox lease\", path, \"wx\", (handle) => nodeIo(\"write kept sandbox lease\", (signal) => handle.writeFile(JSON.stringify(payload), { encoding: \"utf-8\", signal })).pipe(Effect.zipRight(nodeIo(\"sync kept sandbox lease\", () => handle.sync()))))), Effect.as(true), Effect.catchAll((cause) => errnoCode(cause) === \"EEXIST\" ? Effect.succeed(false) : Effect.fail(cause)));\n}\nfunction leasePathFromDir(dir: string, id: string): string {\n    return join(dir, `${id}.lease`);\n}\n/**\n * 原子占坑：`wx` 是唯一持有点。TTL 到期时先移除旧文件、再重新竞争；因此旧持有者 finally\n * 只会尝试删除带自己 token 的文件，绝不剥离后来者。\n */\nexport function acquireKeptLeaseEffect(niceevalRoot: string, id: string, lease: KeptSandboxLease): RegistryEffect<{\n    acquired: true;\n    token: string;\n} | {\n    acquired: false;\n    lease: KeptSandboxLease;\n}> {\n    const dir = sandboxesDirOf(niceevalRoot);\n    const path = leasePathFromDir(dir, id);\n    return Effect.gen(function* () {\n        const token = `${lease.holder}:${lease.acquiredAt}:${Math.random().toString(36).slice(2)}`;\n        const payload = { ...lease, token };\n        for (let attempt = 0; attempt < 2; attempt += 1) {\n            if (yield* createKeptLeaseExclusiveEffect(dir, id, payload))\n                return { acquired: true, token };\n            const current = yield* readKeptLeaseEffect(niceevalRoot, id);\n            if (current && Date.now() - Date.parse(current.acquiredAt) < current.ttlMs) {\n                return { acquired: false, lease: current };\n            }\n            // 过期或损坏的 lease 可以被接管；unlink 后所有竞争者重新 wx，不能覆盖彼此。\n            yield* nodeIo(\"remove expired kept sandbox lease\", () => rm(path, { force: true }));\n        }\n        const current = yield* readKeptLeaseEffect(niceevalRoot, id);\n        return { acquired: false, lease: current ?? lease };\n    });\n}\nexport function releaseKeptLeaseEffect(niceevalRoot: string, id: string, token: string): RegistryEffect<void> {\n    const path = leasePath(niceevalRoot, id);\n    return readPersistedKeptLeaseEffect(niceevalRoot, id).pipe(Effect.flatMap((current) => current?.token === token\n        ? nodeIo(\"release kept sandbox lease\", () => rm(path, { force: true }))\n        : Effect.void));\n}\n/**\n * 注册表发现:从 cwd 向上找最近的 `.niceeval/`(与结果根发现同一规则)。\n * 找不到返回 undefined,调用方报错并提示 `--run <结果根>`。\n */\nexport function findNiceevalRootEffect(cwd: string): RegistryEffect<string | undefined> {\n    return Effect.gen(function* () {\n        let current = resolve(cwd);\n        for (;;) {\n            const candidate = join(current, \".niceeval\");\n            const entries = yield* readDirectoryIfPresentEffect(candidate, \"find .niceeval directory\");\n            if (entries !== undefined)\n                return candidate;\n            const parent = dirname(current);\n            if (parent === current)\n                return undefined;\n            current = parent;\n        }\n    });\n}\n/** 原子写入一条登记项(委托给共享层的 write-tmp-then-rename 纪律)。 */\nexport function writeKeptEntryEffect(niceevalRoot: string, entry: KeptSandboxEntry): RegistryEffect<void> {\n    const id = keptEntryId(entry.provider, entry.sandboxId);\n    return writeEntryFileEffect(sandboxesDirOf(niceevalRoot), id, entry).pipe(Effect.mapError((cause) => registryError(\"write kept sandbox entry\", cause)));\n}\n/**\n * 读全部登记项(坏条目跳过并记名,不整体失败)。逐条目解析走共享层的 `readEntryFile`(损坏\n * 返回 undefined、不抛错);目录扫描与 malformed 文件名收集是留存注册表自己的诊断需求\n * (`readAllEntryFiles` 只做静默跳过,不回传坏文件名),因此这里保留自己的扫描循环。\n */\nexport function readKeptEntriesEffect(niceevalRoot: string): RegistryEffect<{\n    entries: {\n        id: string;\n        entry: KeptSandboxEntry;\n    }[];\n    malformed: string[];\n}> {\n    const dir = sandboxesDirOf(niceevalRoot);\n    return Effect.gen(function* () {\n        const files = (yield* readDirectoryIfPresentEffect(dir, \"read kept sandbox registry directory\")) ?? [];\n        const decoded = yield* Effect.forEach(files, (file) => {\n            if (!file.endsWith(\".json\") || file.startsWith(\".\"))\n                return Effect.succeed(undefined);\n            const id = file.slice(0, -\".json\".length);\n            return readEntryFileEffect(dir, id, decodeKeptSandboxEntry).pipe(Effect.mapError((cause) => registryError(\"read kept sandbox entry\", cause)), Effect.map((entry) => ({ file, id, entry })));\n        });\n        const entries: {\n            id: string;\n            entry: KeptSandboxEntry;\n        }[] = [];\n        const malformed: string[] = [];\n        for (const decodedEntry of decoded) {\n            if (decodedEntry === undefined)\n                continue;\n            if (decodedEntry.entry === undefined)\n                malformed.push(decodedEntry.file);\n            else\n                entries.push({ id: decodedEntry.id, entry: decodedEntry.entry });\n        }\n        entries.sort((a, b) => a.entry.keptAt.localeCompare(b.entry.keptAt));\n        return { entries, malformed };\n    });\n}\n/** 更新一条登记项(读-改-原子写;字段浅合并)。条目不存在时静默返回 false。 */\nexport function updateKeptEntryEffect(niceevalRoot: string, id: string, patch: Partial<KeptSandboxEntry> | ((entry: KeptSandboxEntry) => KeptSandboxEntry)): RegistryEffect<boolean> {\n    const dir = sandboxesDirOf(niceevalRoot);\n    return readEntryFileEffect(dir, id, decodeKeptSandboxEntry).pipe(Effect.mapError((cause) => registryError(\"read kept sandbox entry for update\", cause)), Effect.flatMap((entry) => {\n        if (entry === undefined)\n            return Effect.succeed(false);\n        const next = typeof patch === \"function\" ? patch(entry) : { ...entry, ...patch };\n        return writeKeptEntryEffect(niceevalRoot, next).pipe(Effect.as(true));\n    }));\n}\n/** 删除一条登记项并同步目录(只在实例成功销毁或确认已不存在后调用)。 */\nexport function removeKeptEntryEffect(niceevalRoot: string, id: string): RegistryEffect<void> {\n    const dir = sandboxesDirOf(niceevalRoot);\n    return nodeIo(\"remove kept sandbox entry\", () => rm(join(dir, `${id}.json`), { force: true })).pipe(Effect.zipRight(fsyncDirEffect(dir).pipe(Effect.mapError((cause) => registryError(\"sync kept sandbox registry directory\", cause)))));\n}\n"]}

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}\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\" | \"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}\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

@@ -73,7 +73,7 @@ export interface CommandOptions {
      *
      * 语义跨 provider 一致,各 provider 映射到自己的原生机制(docker:`exec --user`;E2B:
      * `{ user }`;Vercel:只认 `"root"`,映射 `{ sudo: true }`,其它值报错;local:任何值都报错)。
-     * 本就全程 root 的 provider视作 no-op;完全无法换身份的 provider 可不支持(抛错)—— 但**省略与
+     * 本就全程 root 的 provider 视作 no-op；完全无法换身份的 provider 可不支持（抛错）——但**省略与
      * 显式值的语义保持一致**,不因 provider 而变。
      */
     readonly user?: string;

package/dist/sandbox/types.d.mts

@@ -73,7 +73,7 @@ export interface CommandOptions {
      *
      * 语义跨 provider 一致,各 provider 映射到自己的原生机制(docker:`exec --user`;E2B:
      * `{ user }`;Vercel:只认 `"root"`,映射 `{ sudo: true }`,其它值报错;local:任何值都报错)。
-     * 本就全程 root 的 provider视作 no-op;完全无法换身份的 provider 可不支持(抛错)—— 但**省略与
+     * 本就全程 root 的 provider 视作 no-op；完全无法换身份的 provider 可不支持（抛错）——但**省略与
      * 显式值的语义保持一致**,不因 provider 而变。
      */
     readonly user?: string;

package/dist/sandbox/types.d.ts

@@ -73,7 +73,7 @@ export interface CommandOptions {
      *
      * 语义跨 provider 一致,各 provider 映射到自己的原生机制(docker:`exec --user`;E2B:
      * `{ user }`;Vercel:只认 `"root"`,映射 `{ sudo: true }`,其它值报错;local:任何值都报错)。
-     * 本就全程 root 的 provider视作 no-op;完全无法换身份的 provider 可不支持(抛错)—— 但**省略与
+     * 本就全程 root 的 provider 视作 no-op；完全无法换身份的 provider 可不支持（抛错）——但**省略与
      * 显式值的语义保持一致**,不因 provider 而变。
      */
     readonly user?: string;

package/dist/shared/aggregate.cjs

@@ -35,14 +35,24 @@ function displayExperimentName(id) {
     return id.split("/").filter(Boolean).at(-1) ?? id;
 }
 /**
- * 实验 id 的组推导:去掉末段的目录前缀("compare/bub-low" → "compare");
- * 无 "/" 的顶层实验不属于任何组,返回 undefined。view 实验列表分组与自定义报告
- * 的分组用同一份,两边的「组」永远指同一个东西。
+ * The sole Experiment Group derivation. A named group is always the first
+ * ExperimentId segment; a root Experiment is its own singleton group.
  */
 function experimentGroupOf(experimentId) {
-    if (!experimentId.includes("/"))
-        return undefined;
-    return experimentId.split("/").slice(0, -1).join("/");
+    const slash = experimentId.indexOf("/");
+    if (slash === -1) {
+        return Object.freeze({
+            kind: "singleton",
+            experimentId,
+            key: `singleton/${experimentId}`,
+        });
+    }
+    const groupId = experimentId.slice(0, slash);
+    return Object.freeze({
+        kind: "named",
+        groupId,
+        key: `named/${groupId}`,
+    });
 }
 /**
  * eval id 前缀过滤,同 CLI 位置参数语义(docs/feature/reports/README.md「打开与收窄」):

package/dist/shared/aggregate.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate.js","sourceRoot":"","sources":["aggregate.ts"],"names":[],"mappings":"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","sourcesContent":["// report 聚合(report/aggregate.ts)与 view 实验列表(view/app/lib/rows.ts)共用的聚合小工具。\n// 实验标签推导、token/成本求和、verdict 排序各只有一份 —— 否则同一个实验在终端和网页上\n// 会显示成两个名字 / 两组数。保持环境无关(纯函数,只 type import)。\nimport type { Usage } from \"../o11y/types.ts\";\nimport type { EvalResult, ExperimentRunInfo } from \"../runner/types.ts\";\nimport type { Verdict } from \"./types.ts\";\n/** 明细行排序:失败最靠前(failed > errored > skipped > passed 的紧急程度)。 */\nexport const VERDICT_ORDER: globalThis.Record<Verdict, number> = {\n    failed: 0,\n    errored: 1,\n    skipped: 2,\n    passed: 3,\n};\nexport function totalTokens(items: Array<Usage | undefined>): number {\n    return items.reduce((n, u) => n + (u?.inputTokens ?? 0) + (u?.outputTokens ?? 0), 0);\n}\n/** 求和,但「全都没报」时返回 undefined(区别于真 0 成本)。 */\nexport function sumMaybe(items: Array<number | undefined>): number | undefined {\n    const known = items.filter((n): n is number => n !== undefined);\n    return known.length ? known.reduce((sum, n) => sum + n, 0) : undefined;\n}\nexport function avg(items: number[]): number {\n    return items.length ? items.reduce((sum, n) => sum + n, 0) / items.length : 0;\n}\n/** 实验 id 的展示名:取路径最后一段(exp 分组用目录表达)。 */\nexport function displayExperimentName(id: string | undefined): string | undefined {\n    if (!id)\n        return undefined;\n    return id.split(\"/\").filter(Boolean).at(-1) ?? id;\n}\n/**\n * 实验 id 的组推导:去掉末段的目录前缀(\"compare/bub-low\" → \"compare\");\n * 无 \"/\" 的顶层实验不属于任何组,返回 undefined。view 实验列表分组与自定义报告\n * 的分组用同一份,两边的「组」永远指同一个东西。\n */\nexport function experimentGroupOf(experimentId: string): string | undefined {\n    if (!experimentId.includes(\"/\"))\n        return undefined;\n    return experimentId.split(\"/\").slice(0, -1).join(\"/\");\n}\n/**\n * eval id 前缀过滤,同 CLI 位置参数语义(docs/feature/reports/README.md「打开与收窄」):\n * eval 位置参数是收窄过滤,按**裸前缀宽松匹配**——\"algebra\" 命中 \"algebra\"、\"algebra/...\"\n * 也命中 \"algebra2\",多命中正是它的用途(与 `--exp` 的按路径段匹配有意不同)。\n */\nexport function evalPrefixPredicate(evals?: string | string[]): (id: string) => boolean {\n    if (evals === undefined)\n        return () => true;\n    const prefixes = Array.isArray(evals) ? evals : [evals];\n    return (id) => prefixes.some((prefix) => id.startsWith(prefix));\n}\n/**\n * 实验选择器解析:`niceeval exp` 位置参数与 `--exp` 共用同一条规则(docs/feature/experiments/cli.md\n * 「实验选择器怎样解析」)。按序:①精确 id 优先,即使它同时是同目录内其它文件名的前缀;\n * ②目录段精确前缀(含更深层目录),选中该目录下全部实验;③以上都不命中且选择器形如\n * `目录/文件名前缀` 时,目录段精确匹配后按文件名段前缀选中一族配置——目录段永远精确,不跨目录\n * 误配,文件名段裸前缀,与 `evalPrefixPredicate` 同一条\"共享前缀即家族\"的逻辑。\n */\nexport function matchExperimentSelector(ids: readonly string[], selector: string): string[] {\n    const exact = ids.find((id) => id === selector);\n    if (exact !== undefined)\n        return [exact];\n    const dirMatches = ids.filter((id) => id.startsWith(selector + \"/\"));\n    if (dirMatches.length > 0)\n        return dirMatches;\n    const lastSlash = selector.lastIndexOf(\"/\");\n    if (lastSlash === -1)\n        return [];\n    const dir = selector.slice(0, lastSlash);\n    const namePrefix = selector.slice(lastSlash + 1);\n    if (namePrefix === \"\")\n        return [];\n    return ids.filter((id) => id.startsWith(dir + \"/\") && id.slice(dir.length + 1).startsWith(namePrefix));\n}\n/**\n * 零命中时展示的可浏览路径清单(docs/feature/experiments/cli.md「零命中」):按 id 的顶层目录段\n * 去重、排序,带尾斜杠;没有目录段的顶层 experiment id 原样列出(它本身就是一个可选择的目标,\n * 不是一段路径)。这是运行选择的展示投影,不是报告分组。\n */\nexport function browsableExperimentPaths(ids: readonly string[]): string[] {\n    return [...new Set(ids.map((id) => (id.includes(\"/\") ? `${id.split(\"/\")[0]}/` : id)))].sort();\n}\n/** 无 experimentId 时的兜底标签。 */\nexport function fallbackExperimentLabel(result: {\n    experimentId?: string;\n    experiment?: ExperimentRunInfo;\n    agent: string;\n    model?: string;\n}): string {\n    if (result.experimentId)\n        return displayExperimentName(result.experimentId) ?? result.experimentId;\n    if (result.model)\n        return `${result.agent}/${result.model}`;\n    return result.agent || \"ad hoc run\";\n}\nexport type { EvalResult };\n"]}
+{"version":3,"file":"aggregate.js","sourceRoot":"","sources":["aggregate.ts"],"names":[],"mappings":"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","sourcesContent":["// report 聚合(report/aggregate.ts)与 view 实验列表(view/app/lib/rows.ts)共用的聚合小工具。\n// 实验标签推导、token/成本求和、verdict 排序各只有一份 —— 否则同一个实验在终端和网页上\n// 会显示成两个名字 / 两组数。保持环境无关(纯函数,只 type import)。\nimport type { Usage } from \"../o11y/types.ts\";\nimport type { EvalResult, ExperimentRunInfo } from \"../runner/types.ts\";\nimport type { Verdict } from \"./types.ts\";\n/** 明细行排序:失败最靠前(failed > errored > skipped > passed 的紧急程度)。 */\nexport const VERDICT_ORDER: globalThis.Record<Verdict, number> = {\n    failed: 0,\n    errored: 1,\n    skipped: 2,\n    passed: 3,\n};\nexport function totalTokens(items: Array<Usage | undefined>): number {\n    return items.reduce((n, u) => n + (u?.inputTokens ?? 0) + (u?.outputTokens ?? 0), 0);\n}\n/** 求和,但「全都没报」时返回 undefined(区别于真 0 成本)。 */\nexport function sumMaybe(items: Array<number | undefined>): number | undefined {\n    const known = items.filter((n): n is number => n !== undefined);\n    return known.length ? known.reduce((sum, n) => sum + n, 0) : undefined;\n}\nexport function avg(items: number[]): number {\n    return items.length ? items.reduce((sum, n) => sum + n, 0) / items.length : 0;\n}\n/** 实验 id 的展示名:取路径最后一段(exp 分组用目录表达)。 */\nexport function displayExperimentName(id: string | undefined): string | undefined {\n    if (!id)\n        return undefined;\n    return id.split(\"/\").filter(Boolean).at(-1) ?? id;\n}\nexport type ExperimentGroupIdentityValue = {\n    readonly kind: \"named\";\n    readonly groupId: string;\n    readonly key: `named/${string}`;\n} | {\n    readonly kind: \"singleton\";\n    readonly experimentId: string;\n    readonly key: `singleton/${string}`;\n};\n/**\n * The sole Experiment Group derivation. A named group is always the first\n * ExperimentId segment; a root Experiment is its own singleton group.\n */\nexport function experimentGroupOf(experimentId: string): ExperimentGroupIdentityValue {\n    const slash = experimentId.indexOf(\"/\");\n    if (slash === -1) {\n        return Object.freeze({\n            kind: \"singleton\" as const,\n            experimentId,\n            key: `singleton/${experimentId}` as const,\n        });\n    }\n    const groupId = experimentId.slice(0, slash);\n    return Object.freeze({\n        kind: \"named\" as const,\n        groupId,\n        key: `named/${groupId}` as const,\n    });\n}\n/**\n * eval id 前缀过滤,同 CLI 位置参数语义(docs/feature/reports/README.md「打开与收窄」):\n * eval 位置参数是收窄过滤,按**裸前缀宽松匹配**——\"algebra\" 命中 \"algebra\"、\"algebra/...\"\n * 也命中 \"algebra2\",多命中正是它的用途(与 `--exp` 的按路径段匹配有意不同)。\n */\nexport function evalPrefixPredicate(evals?: string | string[]): (id: string) => boolean {\n    if (evals === undefined)\n        return () => true;\n    const prefixes = Array.isArray(evals) ? evals : [evals];\n    return (id) => prefixes.some((prefix) => id.startsWith(prefix));\n}\n/**\n * 实验选择器解析:`niceeval exp` 位置参数与 `--exp` 共用同一条规则(docs/feature/experiments/cli.md\n * 「实验选择器怎样解析」)。按序:①精确 id 优先,即使它同时是同目录内其它文件名的前缀;\n * ②目录段精确前缀(含更深层目录),选中该目录下全部实验;③以上都不命中且选择器形如\n * `目录/文件名前缀` 时,目录段精确匹配后按文件名段前缀选中一族配置——目录段永远精确,不跨目录\n * 误配,文件名段裸前缀,与 `evalPrefixPredicate` 同一条\"共享前缀即家族\"的逻辑。\n */\nexport function matchExperimentSelector(ids: readonly string[], selector: string): string[] {\n    const exact = ids.find((id) => id === selector);\n    if (exact !== undefined)\n        return [exact];\n    const dirMatches = ids.filter((id) => id.startsWith(selector + \"/\"));\n    if (dirMatches.length > 0)\n        return dirMatches;\n    const lastSlash = selector.lastIndexOf(\"/\");\n    if (lastSlash === -1)\n        return [];\n    const dir = selector.slice(0, lastSlash);\n    const namePrefix = selector.slice(lastSlash + 1);\n    if (namePrefix === \"\")\n        return [];\n    return ids.filter((id) => id.startsWith(dir + \"/\") && id.slice(dir.length + 1).startsWith(namePrefix));\n}\n/**\n * 零命中时展示的可浏览路径清单(docs/feature/experiments/cli.md「零命中」):按 id 的顶层目录段\n * 去重、排序,带尾斜杠;没有目录段的顶层 experiment id 原样列出(它本身就是一个可选择的目标,\n * 不是一段路径)。这是运行选择的展示投影,不是报告分组。\n */\nexport function browsableExperimentPaths(ids: readonly string[]): string[] {\n    return [...new Set(ids.map((id) => (id.includes(\"/\") ? `${id.split(\"/\")[0]}/` : id)))].sort();\n}\n/** 无 experimentId 时的兜底标签。 */\nexport function fallbackExperimentLabel(result: {\n    experimentId?: string;\n    experiment?: ExperimentRunInfo;\n    agent: string;\n    model?: string;\n}): string {\n    if (result.experimentId)\n        return displayExperimentName(result.experimentId) ?? result.experimentId;\n    if (result.model)\n        return `${result.agent}/${result.model}`;\n    return result.agent || \"ad hoc run\";\n}\nexport type { EvalResult };\n"]}

package/dist/shared/aggregate.d.cts

@@ -9,12 +9,20 @@ export declare function sumMaybe(items: Array<number | undefined>): number | und
 export declare function avg(items: number[]): number;
 /** 实验 id 的展示名:取路径最后一段(exp 分组用目录表达)。 */
 export declare function displayExperimentName(id: string | undefined): string | undefined;
+export type ExperimentGroupIdentityValue = {
+    readonly kind: "named";
+    readonly groupId: string;
+    readonly key: `named/${string}`;
+} | {
+    readonly kind: "singleton";
+    readonly experimentId: string;
+    readonly key: `singleton/${string}`;
+};
 /**
- * 实验 id 的组推导:去掉末段的目录前缀("compare/bub-low" → "compare");
- * 无 "/" 的顶层实验不属于任何组,返回 undefined。view 实验列表分组与自定义报告
- * 的分组用同一份,两边的「组」永远指同一个东西。
+ * The sole Experiment Group derivation. A named group is always the first
+ * ExperimentId segment; a root Experiment is its own singleton group.
  */
-export declare function experimentGroupOf(experimentId: string): string | undefined;
+export declare function experimentGroupOf(experimentId: string): ExperimentGroupIdentityValue;
 /**
  * eval id 前缀过滤,同 CLI 位置参数语义(docs/feature/reports/README.md「打开与收窄」):
  * eval 位置参数是收窄过滤,按**裸前缀宽松匹配**——"algebra" 命中 "algebra"、"algebra/..."

package/dist/shared/aggregate.d.mts

@@ -9,12 +9,20 @@ export declare function sumMaybe(items: Array<number | undefined>): number | und
 export declare function avg(items: number[]): number;
 /** 实验 id 的展示名:取路径最后一段(exp 分组用目录表达)。 */
 export declare function displayExperimentName(id: string | undefined): string | undefined;
+export type ExperimentGroupIdentityValue = {
+    readonly kind: "named";
+    readonly groupId: string;
+    readonly key: `named/${string}`;
+} | {
+    readonly kind: "singleton";
+    readonly experimentId: string;
+    readonly key: `singleton/${string}`;
+};
 /**
- * 实验 id 的组推导:去掉末段的目录前缀("compare/bub-low" → "compare");
- * 无 "/" 的顶层实验不属于任何组,返回 undefined。view 实验列表分组与自定义报告
- * 的分组用同一份,两边的「组」永远指同一个东西。
+ * The sole Experiment Group derivation. A named group is always the first
+ * ExperimentId segment; a root Experiment is its own singleton group.
  */
-export declare function experimentGroupOf(experimentId: string): string | undefined;
+export declare function experimentGroupOf(experimentId: string): ExperimentGroupIdentityValue;
 /**
  * eval id 前缀过滤,同 CLI 位置参数语义(docs/feature/reports/README.md「打开与收窄」):
  * eval 位置参数是收窄过滤,按**裸前缀宽松匹配**——"algebra" 命中 "algebra"、"algebra/..."

package/dist/shared/aggregate.d.ts

@@ -9,12 +9,20 @@ export declare function sumMaybe(items: Array<number | undefined>): number | und
 export declare function avg(items: number[]): number;
 /** 实验 id 的展示名:取路径最后一段(exp 分组用目录表达)。 */
 export declare function displayExperimentName(id: string | undefined): string | undefined;
+export type ExperimentGroupIdentityValue = {
+    readonly kind: "named";
+    readonly groupId: string;
+    readonly key: `named/${string}`;
+} | {
+    readonly kind: "singleton";
+    readonly experimentId: string;
+    readonly key: `singleton/${string}`;
+};
 /**
- * 实验 id 的组推导:去掉末段的目录前缀("compare/bub-low" → "compare");
- * 无 "/" 的顶层实验不属于任何组,返回 undefined。view 实验列表分组与自定义报告
- * 的分组用同一份,两边的「组」永远指同一个东西。
+ * The sole Experiment Group derivation. A named group is always the first
+ * ExperimentId segment; a root Experiment is its own singleton group.
  */
-export declare function experimentGroupOf(experimentId: string): string | undefined;
+export declare function experimentGroupOf(experimentId: string): ExperimentGroupIdentityValue;
 /**
  * eval id 前缀过滤,同 CLI 位置参数语义(docs/feature/reports/README.md「打开与收窄」):
  * eval 位置参数是收窄过滤,按**裸前缀宽松匹配**——"algebra" 命中 "algebra"、"algebra/..."

package/dist/shared/turn-label.cjs

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatTurnLabel = formatTurnLabel;
+exports.isCanonicalTurnLabel = isCanonicalTurnLabel;
 exports.normalizeTurnLabel = normalizeTurnLabel;
 /**
  * 生成 attempt 内跨 execution、timing、source 与 diff 的同一轮身份 token。
@@ -11,9 +12,26 @@ exports.normalizeTurnLabel = normalizeTurnLabel;
 function formatTurnLabel(sessionIndex, turnIndex) {
     return sessionIndex === 1 ? `turn${turnIndex}` : `session${sessionIndex}/turn${turnIndex}`;
 }
+/** Current durable turn identity: main session is implicit and every index is a positive safe integer. */
+function isCanonicalTurnLabel(label) {
+    const main = /^turn([1-9]\d*)$/.exec(label);
+    if (main !== null)
+        return Number.isSafeInteger(Number(main[1]));
+    const additional = /^session([1-9]\d*)\/turn([1-9]\d*)$/.exec(label);
+    if (additional === null)
+        return false;
+    const sessionIndex = Number(additional[1]);
+    const turnIndex = Number(additional[2]);
+    return sessionIndex >= 2 &&
+        Number.isSafeInteger(sessionIndex) &&
+        Number.isSafeInteger(turnIndex);
+}
 /** 把旧 artifact 的坐标标签归一成当前展示格式；其它 opaque label 原样保留。 */
 function normalizeTurnLabel(label) {
-    const match = /^s([1-9]\d*)\/t([1-9]\d*)$/.exec(label);
-    return match === null ? label : formatTurnLabel(Number(match[1]), Number(match[2]));
+    const legacyMatch = /^s([1-9]\d*)\/t([1-9]\d*)$/.exec(label);
+    if (legacyMatch !== null) {
+        return formatTurnLabel(Number(legacyMatch[1]), Number(legacyMatch[2]));
+    }
+    return label;
 }
 //# sourceMappingURL=turn-label.cjs.map

package/dist/shared/turn-label.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"turn-label.js","sourceRoot":"","sources":["turn-label.ts"],"names":[],"mappings":";;AAMA,0CAEC;AAED,gDAGC;AAbD;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,YAAoB,EAAE,SAAiB;IACnE,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,UAAU,YAAY,QAAQ,SAAS,EAAE,CAAC;AAC/F,CAAC;AACD,uDAAuD;AACvD,SAAgB,kBAAkB,CAAC,KAAa;IAC5C,MAAM,KAAK,GAAG,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxF,CAAC","sourcesContent":["/**\n * 生成 attempt 内跨 execution、timing、source 与 diff 的同一轮身份 token。\n *\n * 新写入只使用本函数；主会话使用 `turn<N>`，额外会话使用\n * `session<K>/turn<N>`。旧 artifact 在展示/读取边界使用 `normalizeTurnLabel`，不回写落盘值。\n */\nexport function formatTurnLabel(sessionIndex: number, turnIndex: number): string {\n    return sessionIndex === 1 ? `turn${turnIndex}` : `session${sessionIndex}/turn${turnIndex}`;\n}\n/** 把旧 artifact 的坐标标签归一成当前展示格式；其它 opaque label 原样保留。 */\nexport function normalizeTurnLabel(label: string): string {\n    const match = /^s([1-9]\\d*)\\/t([1-9]\\d*)$/.exec(label);\n    return match === null ? label : formatTurnLabel(Number(match[1]), Number(match[2]));\n}\n"]}
+{"version":3,"file":"turn-label.js","sourceRoot":"","sources":["turn-label.ts"],"names":[],"mappings":";;AAMA,0CAEC;AAED,oDAYC;AAED,gDAMC;AA9BD;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,YAAoB,EAAE,SAAiB;IACnE,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,UAAU,YAAY,QAAQ,SAAS,EAAE,CAAC;AAC/F,CAAC;AACD,0GAA0G;AAC1G,SAAgB,oBAAoB,CAAC,KAAa;IAC9C,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,IAAI,KAAK,IAAI;QACb,OAAO,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,qCAAqC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrE,IAAI,UAAU,KAAK,IAAI;QACnB,OAAO,KAAK,CAAC;IACjB,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,YAAY,IAAI,CAAC;QACpB,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC;QAClC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;AACxC,CAAC;AACD,uDAAuD;AACvD,SAAgB,kBAAkB,CAAC,KAAa;IAC5C,MAAM,WAAW,GAAG,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC","sourcesContent":["/**\n * 生成 attempt 内跨 execution、timing、source 与 diff 的同一轮身份 token。\n *\n * 新写入只使用本函数；主会话使用 `turn<N>`，额外会话使用\n * `session<K>/turn<N>`。旧 artifact 在展示/读取边界使用 `normalizeTurnLabel`，不回写落盘值。\n */\nexport function formatTurnLabel(sessionIndex: number, turnIndex: number): string {\n    return sessionIndex === 1 ? `turn${turnIndex}` : `session${sessionIndex}/turn${turnIndex}`;\n}\n/** Current durable turn identity: main session is implicit and every index is a positive safe integer. */\nexport function isCanonicalTurnLabel(label: string): boolean {\n    const main = /^turn([1-9]\\d*)$/.exec(label);\n    if (main !== null)\n        return Number.isSafeInteger(Number(main[1]));\n    const additional = /^session([1-9]\\d*)\\/turn([1-9]\\d*)$/.exec(label);\n    if (additional === null)\n        return false;\n    const sessionIndex = Number(additional[1]);\n    const turnIndex = Number(additional[2]);\n    return sessionIndex >= 2 &&\n        Number.isSafeInteger(sessionIndex) &&\n        Number.isSafeInteger(turnIndex);\n}\n/** 把旧 artifact 的坐标标签归一成当前展示格式；其它 opaque label 原样保留。 */\nexport function normalizeTurnLabel(label: string): string {\n    const legacyMatch = /^s([1-9]\\d*)\\/t([1-9]\\d*)$/.exec(label);\n    if (legacyMatch !== null) {\n        return formatTurnLabel(Number(legacyMatch[1]), Number(legacyMatch[2]));\n    }\n    return label;\n}\n"]}

package/dist/shared/turn-label.d.cts

@@ -5,5 +5,7 @@
  * `session<K>/turn<N>`。旧 artifact 在展示/读取边界使用 `normalizeTurnLabel`，不回写落盘值。
  */
 export declare function formatTurnLabel(sessionIndex: number, turnIndex: number): string;
+/** Current durable turn identity: main session is implicit and every index is a positive safe integer. */
+export declare function isCanonicalTurnLabel(label: string): boolean;
 /** 把旧 artifact 的坐标标签归一成当前展示格式；其它 opaque label 原样保留。 */
 export declare function normalizeTurnLabel(label: string): string;

package/dist/shared/turn-label.d.mts

@@ -5,5 +5,7 @@
  * `session<K>/turn<N>`。旧 artifact 在展示/读取边界使用 `normalizeTurnLabel`，不回写落盘值。
  */
 export declare function formatTurnLabel(sessionIndex: number, turnIndex: number): string;
+/** Current durable turn identity: main session is implicit and every index is a positive safe integer. */
+export declare function isCanonicalTurnLabel(label: string): boolean;
 /** 把旧 artifact 的坐标标签归一成当前展示格式；其它 opaque label 原样保留。 */
 export declare function normalizeTurnLabel(label: string): string;

package/dist/shared/turn-label.d.ts

@@ -5,5 +5,7 @@
  * `session<K>/turn<N>`。旧 artifact 在展示/读取边界使用 `normalizeTurnLabel`，不回写落盘值。
  */
 export declare function formatTurnLabel(sessionIndex: number, turnIndex: number): string;
+/** Current durable turn identity: main session is implicit and every index is a positive safe integer. */
+export declare function isCanonicalTurnLabel(label: string): boolean;
 /** 把旧 artifact 的坐标标签归一成当前展示格式；其它 opaque label 原样保留。 */
 export declare function normalizeTurnLabel(label: string): string;

package/dist/shared/turn-label.js

@@ -3,6 +3,8 @@ const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
 const __niceevalCanonical = __niceevalRequire("./turn-label.cjs");
 const __niceevalExport0 = __niceevalCanonical["formatTurnLabel"];
 export { __niceevalExport0 as formatTurnLabel };
-const __niceevalExport1 = __niceevalCanonical["normalizeTurnLabel"];
-export { __niceevalExport1 as normalizeTurnLabel };
+const __niceevalExport1 = __niceevalCanonical["isCanonicalTurnLabel"];
+export { __niceevalExport1 as isCanonicalTurnLabel };
+const __niceevalExport2 = __niceevalCanonical["normalizeTurnLabel"];
+export { __niceevalExport2 as normalizeTurnLabel };
 //# sourceMappingURL=turn-label.js.map