niceeval 0.12.2-canary.31 → 0.13.1

package/dist/sandbox/prepare-commands.d.ts

@@ -2,7 +2,7 @@ import { type SandboxCommandIdentityValue, type StableSandboxCommand } from "./c
 export interface CheckoutOptions {
     /** Git remote;HTTP(S) URL 中的 userinfo / query / fragment 一律拒绝，凭据只走 Git 原生机制。 */
     readonly repo: string;
-    /** commit SHA 或 tag 等 Git revision；运行时解析出的 commit SHA 会作为事实记录。 */
+    /** commit SHA 或 tag 等 Git revision。 */
     readonly ref: string;
     /** 相对 workdir 的目标目录；省略或 `.` 就是 workdir 根。 */
     readonly into?: string;

package/dist/sandbox/record/attachment.cjs

@@ -1,35 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sandboxAttachmentFamily = exports.sandboxAttachmentDefinition = void 0;
-exports.createSandboxAttachmentWrite = createSandboxAttachmentWrite;
+exports.normalizeSandboxCapture = normalizeSandboxCapture;
 const effect_1 = require("effect");
-const index_ts_1 = require("../../record/attachment/index.cjs");
-const internal_ts_1 = require("../../record/attachment/internal.cjs");
 const codec_ts_1 = require("./codec.cjs");
-const SANDBOX_ATTACHMENT_NAME = "niceeval.sandbox";
-const SANDBOX_ATTACHMENT_SCHEMA_ID = "niceeval.sandbox/v1";
-const noSandboxAttachmentBlobDrafts = Object.freeze([]);
-const sandboxAttachmentInputInvalid = Object.freeze({
-    code: "sandbox-attachment-input-invalid",
+const invalid = Object.freeze({
+    code: "sandbox-capture-input-invalid",
 });
-function requireAttachmentCapability(result, message) {
-    if (effect_1.Either.isLeft(result))
-        throw new Error(message);
-    return result.right;
-}
-/** Package-owned definition for the sole Attempt-owned Sandbox fact. */
-exports.sandboxAttachmentDefinition = requireAttachmentCapability((0, internal_ts_1.defineBuiltinJsonRecordAttachment)({
-    owner: "attempt",
-    name: SANDBOX_ATTACHMENT_NAME,
-    schemaId: SANDBOX_ATTACHMENT_SCHEMA_ID,
-    schema: codec_ts_1.SandboxAttachmentPayloadV1Schema,
-    blobRefs: () => Object.freeze([]),
-}), "Sandbox RecordAttachment definition must be valid");
-/** The current family has no legacy compatibility or alternate durable schema. */
-exports.sandboxAttachmentFamily = requireAttachmentCapability((0, index_ts_1.defineRecordAttachmentFamily)({
-    current: exports.sandboxAttachmentDefinition,
-    migrations: [],
-}), "Sandbox RecordAttachment family must be valid");
 function freezeReuse(reuse) {
     return reuse.kind === "fresh"
         ? Object.freeze({ kind: "fresh" })
@@ -39,34 +15,21 @@ function freezeReuse(reuse) {
             ordinal: reuse.ordinal,
         });
 }
-/** Copy decoded fields into the package-owned shape before retaining a write. */
-function freezePayload(payload) {
-    return payload.state === "not-used"
+/** Validates a transient capture value without producing a Record write. */
+function normalizeSandboxCapture(input) {
+    const decoded = effect_1.Schema.decodeUnknownEither(codec_ts_1.SandboxAttachmentPayloadSchema, {
+        errors: "all",
+        onExcessProperty: "error",
+    })(input);
+    if (effect_1.Either.isLeft(decoded))
+        return effect_1.Either.left(invalid);
+    return effect_1.Either.right(decoded.right.state === "not-used"
         ? Object.freeze({ state: "not-used" })
         : Object.freeze({
             state: "assigned",
-            provider: payload.provider,
-            sandboxId: payload.sandboxId,
-            reuse: freezeReuse(payload.reuse),
-        });
-}
-/**
- * Creates the sole zero-blob write for one actual Attempt. Invalid, missing,
- * or extra input never becomes a durable `not-used` claim.
- */
-function createSandboxAttachmentWrite(input) {
-    const decoded = (0, index_ts_1.decodeJsonRecordAttachmentPayload)(exports.sandboxAttachmentDefinition, input);
-    if (effect_1.Either.isLeft(decoded))
-        return effect_1.Either.left(sandboxAttachmentInputInvalid);
-    const payload = freezePayload(decoded.right);
-    const write = (0, index_ts_1.makeRecordAttachmentWrite)(exports.sandboxAttachmentFamily, () => Object.freeze({
-        payload,
-        blobs: noSandboxAttachmentBlobDrafts,
-    }));
-    const closure = (0, index_ts_1.validateRecordAttachmentWrite)(write);
-    if (effect_1.Either.isLeft(closure)) {
-        throw new Error("Sandbox RecordAttachment write violated its zero-blob closure");
-    }
-    return effect_1.Either.right(write);
+            provider: decoded.right.provider,
+            sandboxId: decoded.right.sandboxId,
+            reuse: freezeReuse(decoded.right.reuse),
+        }));
 }
 //# sourceMappingURL=attachment.cjs.map

package/dist/sandbox/record/attachment.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"attachment.js","sourceRoot":"","sources":["attachment.ts"],"names":[],"mappings":";;;AAuEA,oEAcC;AArFD,mCAAgC;AAChC,+DAAuQ;AACvQ,qEAAwF;AACxF,yCAA8D;AAoB9D,MAAM,uBAAuB,GAAG,kBAA2B,CAAC;AAC5D,MAAM,4BAA4B,GAAG,qBAA8B,CAAC;AACpE,MAAM,6BAA6B,GAAuD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC5G,MAAM,6BAA6B,GAAgC,MAAM,CAAC,MAAM,CAAC;IAC7E,IAAI,EAAE,kCAA2C;CACpD,CAAC,CAAC;AACH,SAAS,2BAA2B,CAAkB,MAAsC,EAAE,OAAe;IACzG,IAAI,eAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,KAAK,CAAC;AACxB,CAAC;AACD,wEAAwE;AAC3D,QAAA,2BAA2B,GAAG,2BAA2B,CAAC,IAAA,+CAAiC,EAAC;IACrG,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,uBAAuB;IAC7B,QAAQ,EAAE,4BAA4B;IACtC,MAAM,EAAE,2CAAgC;IACxC,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;CACpC,CAAC,EAAE,mDAAmD,CAAC,CAAC;AACzD,kFAAkF;AACrE,QAAA,uBAAuB,GAAkE,2BAA2B,CAAC,IAAA,uCAA4B,EAAC;IAC3J,OAAO,EAAE,mCAA2B;IACpC,UAAU,EAAE,EAAE;CACjB,CAAC,EAAE,+CAA+C,CAAC,CAAC;AACrD,SAAS,WAAW,CAAC,KAAqB;IACtC,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO;QACzB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,CAAC;QAC3C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACZ,IAAI,EAAE,QAAiB;YACvB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;SACzB,CAAC,CAAC;AACX,CAAC;AACD,iFAAiF;AACjF,SAAS,aAAa,CAAC,OAAmC;IACtD,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU;QAC/B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,UAAmB,EAAE,CAAC;QAC/C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACZ,KAAK,EAAE,UAAmB;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;SACpC,CAAC,CAAC;AACX,CAAC;AACD;;;GAGG;AACH,SAAgB,4BAA4B,CAAC,KAA6B;IACtE,MAAM,OAAO,GAAG,IAAA,4CAAiC,EAAC,mCAA2B,EAAE,KAAK,CAAC,CAAC;IACtF,IAAI,eAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QACtB,OAAO,eAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAA,oCAAyB,EAAC,+BAAuB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;QACjF,OAAO;QACP,KAAK,EAAE,6BAA6B;KACvC,CAAC,CAAC,CAAC;IACJ,MAAM,OAAO,GAAG,IAAA,wCAA6B,EAAC,KAAK,CAAC,CAAC;IACrD,IAAI,eAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,eAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC","sourcesContent":["import { Either } from \"effect\";\nimport { decodeJsonRecordAttachmentPayload, defineRecordAttachmentFamily, makeRecordAttachmentWrite, validateRecordAttachmentWrite, type RecordAttachmentBlobDraft, type RecordAttachmentFamily, type RecordAttachmentWrite, } from \"../../record/attachment/index.ts\";\nimport { defineBuiltinJsonRecordAttachment } from \"../../record/attachment/internal.ts\";\nimport { SandboxAttachmentPayloadV1Schema } from \"./codec.ts\";\nimport type { SandboxAttachmentPayloadV1, SandboxReuseV1, } from \"./model.ts\";\n/** The public input is a domain fact, never a raw Record envelope or payload. */\nexport type SandboxAttachmentInput = {\n    readonly state: \"not-used\";\n} | {\n    readonly state: \"assigned\";\n    readonly provider: string;\n    readonly sandboxId: string;\n    readonly reuse: {\n        readonly kind: \"fresh\";\n    } | {\n        readonly kind: \"pooled\";\n        readonly sandbox: number;\n        readonly ordinal: number;\n    };\n};\nexport type SandboxAttachmentWriteError = {\n    readonly code: \"sandbox-attachment-input-invalid\";\n};\nconst SANDBOX_ATTACHMENT_NAME = \"niceeval.sandbox\" as const;\nconst SANDBOX_ATTACHMENT_SCHEMA_ID = \"niceeval.sandbox/v1\" as const;\nconst noSandboxAttachmentBlobDrafts: readonly RecordAttachmentBlobDraft<never, never>[] = Object.freeze([]);\nconst sandboxAttachmentInputInvalid: SandboxAttachmentWriteError = Object.freeze({\n    code: \"sandbox-attachment-input-invalid\" as const,\n});\nfunction requireAttachmentCapability<Result, Failure>(result: Either.Either<Result, Failure>, message: string): Result {\n    if (Either.isLeft(result))\n        throw new Error(message);\n    return result.right;\n}\n/** Package-owned definition for the sole Attempt-owned Sandbox fact. */\nexport const sandboxAttachmentDefinition = requireAttachmentCapability(defineBuiltinJsonRecordAttachment({\n    owner: \"attempt\",\n    name: SANDBOX_ATTACHMENT_NAME,\n    schemaId: SANDBOX_ATTACHMENT_SCHEMA_ID,\n    schema: SandboxAttachmentPayloadV1Schema,\n    blobRefs: () => Object.freeze([]),\n}), \"Sandbox RecordAttachment definition must be valid\");\n/** The current family has no legacy compatibility or alternate durable schema. */\nexport const sandboxAttachmentFamily: RecordAttachmentFamily<\"attempt\", SandboxAttachmentPayloadV1> = requireAttachmentCapability(defineRecordAttachmentFamily({\n    current: sandboxAttachmentDefinition,\n    migrations: [],\n}), \"Sandbox RecordAttachment family must be valid\");\nfunction freezeReuse(reuse: SandboxReuseV1): SandboxReuseV1 {\n    return reuse.kind === \"fresh\"\n        ? Object.freeze({ kind: \"fresh\" as const })\n        : Object.freeze({\n            kind: \"pooled\" as const,\n            sandbox: reuse.sandbox,\n            ordinal: reuse.ordinal,\n        });\n}\n/** Copy decoded fields into the package-owned shape before retaining a write. */\nfunction freezePayload(payload: SandboxAttachmentPayloadV1): SandboxAttachmentPayloadV1 {\n    return payload.state === \"not-used\"\n        ? Object.freeze({ state: \"not-used\" as const })\n        : Object.freeze({\n            state: \"assigned\" as const,\n            provider: payload.provider,\n            sandboxId: payload.sandboxId,\n            reuse: freezeReuse(payload.reuse),\n        });\n}\n/**\n * Creates the sole zero-blob write for one actual Attempt. Invalid, missing,\n * or extra input never becomes a durable `not-used` claim.\n */\nexport function createSandboxAttachmentWrite(input: SandboxAttachmentInput): Either.Either<RecordAttachmentWrite<\"attempt\", never, never>, SandboxAttachmentWriteError> {\n    const decoded = decodeJsonRecordAttachmentPayload(sandboxAttachmentDefinition, input);\n    if (Either.isLeft(decoded))\n        return Either.left(sandboxAttachmentInputInvalid);\n    const payload = freezePayload(decoded.right);\n    const write = makeRecordAttachmentWrite(sandboxAttachmentFamily, () => Object.freeze({\n        payload,\n        blobs: noSandboxAttachmentBlobDrafts,\n    }));\n    const closure = validateRecordAttachmentWrite(write);\n    if (Either.isLeft(closure)) {\n        throw new Error(\"Sandbox RecordAttachment write violated its zero-blob closure\");\n    }\n    return Either.right(write);\n}\n"]}
+{"version":3,"file":"attachment.js","sourceRoot":"","sources":["attachment.ts"],"names":[],"mappings":";;AAsCA,0DAeC;AArDD,mCAAwC;AACxC,yCAA4D;AAwB5D,MAAM,OAAO,GAA6B,MAAM,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,+BAAwC;CACjD,CAAC,CAAC;AACH,SAAS,WAAW,CAAC,KAAmB;IACpC,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO;QACzB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,CAAC;QAC3C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACZ,IAAI,EAAE,QAAiB;YACvB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;SACzB,CAAC,CAAC;AACX,CAAC;AACD,4EAA4E;AAC5E,SAAgB,uBAAuB,CAAC,KAA0B;IAC9D,MAAM,OAAO,GAAG,eAAM,CAAC,mBAAmB,CAAC,yCAA8B,EAAE;QACvE,MAAM,EAAE,KAAK;QACb,gBAAgB,EAAE,OAAO;KAC5B,CAAC,CAAC,KAAK,CAAC,CAAC;IACV,IAAI,eAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QACtB,OAAO,eAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,eAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,UAAU;QAClD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,UAAmB,EAAE,CAAC;QAC/C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACZ,KAAK,EAAE,UAAmB;YAC1B,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ;YAChC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS;YAClC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;SAC1C,CAAC,CAAC,CAAC;AACZ,CAAC","sourcesContent":["import { Either, Schema } from \"effect\";\nimport { SandboxAttachmentPayloadSchema } from \"./codec.ts\";\nimport type { SandboxAttachmentPayload, SandboxReuse } from \"./model.ts\";\n/**\n * Sandbox assignment is execution coordination, not a Record family. The\n * only durable sandbox-produced facts are File Changes captured by the fixed\n * `niceeval.file-changes` collector.\n */\nexport type SandboxCaptureInput = {\n    readonly state: \"not-used\";\n} | {\n    readonly state: \"assigned\";\n    readonly provider: string;\n    readonly sandboxId: string;\n    readonly reuse: {\n        readonly kind: \"fresh\";\n    } | {\n        readonly kind: \"pooled\";\n        readonly sandbox: number;\n        readonly ordinal: number;\n    };\n};\nexport type SandboxCaptureInputError = {\n    readonly code: \"sandbox-capture-input-invalid\";\n};\nconst invalid: SandboxCaptureInputError = Object.freeze({\n    code: \"sandbox-capture-input-invalid\" as const,\n});\nfunction freezeReuse(reuse: SandboxReuse): SandboxReuse {\n    return reuse.kind === \"fresh\"\n        ? Object.freeze({ kind: \"fresh\" as const })\n        : Object.freeze({\n            kind: \"pooled\" as const,\n            sandbox: reuse.sandbox,\n            ordinal: reuse.ordinal,\n        });\n}\n/** Validates a transient capture value without producing a Record write. */\nexport function normalizeSandboxCapture(input: SandboxCaptureInput): Either.Either<SandboxAttachmentPayload, SandboxCaptureInputError> {\n    const decoded = Schema.decodeUnknownEither(SandboxAttachmentPayloadSchema, {\n        errors: \"all\",\n        onExcessProperty: \"error\",\n    })(input);\n    if (Either.isLeft(decoded))\n        return Either.left(invalid);\n    return Either.right(decoded.right.state === \"not-used\"\n        ? Object.freeze({ state: \"not-used\" as const })\n        : Object.freeze({\n            state: \"assigned\" as const,\n            provider: decoded.right.provider,\n            sandboxId: decoded.right.sandboxId,\n            reuse: freezeReuse(decoded.right.reuse),\n        }));\n}\n"]}

package/dist/sandbox/record/attachment.d.cts

@@ -1,8 +1,11 @@
 import { Either } from "effect";
-import { type RecordAttachmentFamily, type RecordAttachmentWrite } from "../../record/attachment/index.cjs";
-import type { SandboxAttachmentPayloadV1 } from "./model.cjs";
-/** The public input is a domain fact, never a raw Record envelope or payload. */
-export type SandboxAttachmentInput = {
+import type { SandboxAttachmentPayload } from "./model.cjs";
+/**
+ * Sandbox assignment is execution coordination, not a Record family. The
+ * only durable sandbox-produced facts are File Changes captured by the fixed
+ * `niceeval.file-changes` collector.
+ */
+export type SandboxCaptureInput = {
     readonly state: "not-used";
 } | {
     readonly state: "assigned";
@@ -16,15 +19,8 @@ export type SandboxAttachmentInput = {
         readonly ordinal: number;
     };
 };
-export type SandboxAttachmentWriteError = {
-    readonly code: "sandbox-attachment-input-invalid";
+export type SandboxCaptureInputError = {
+    readonly code: "sandbox-capture-input-invalid";
 };
-/** Package-owned definition for the sole Attempt-owned Sandbox fact. */
-export declare const sandboxAttachmentDefinition: import("../../record/attachment/types.cjs").JsonRecordAttachmentDefinition<"attempt", SandboxAttachmentPayloadV1>;
-/** The current family has no legacy compatibility or alternate durable schema. */
-export declare const sandboxAttachmentFamily: RecordAttachmentFamily<"attempt", SandboxAttachmentPayloadV1>;
-/**
- * Creates the sole zero-blob write for one actual Attempt. Invalid, missing,
- * or extra input never becomes a durable `not-used` claim.
- */
-export declare function createSandboxAttachmentWrite(input: SandboxAttachmentInput): Either.Either<RecordAttachmentWrite<"attempt", never, never>, SandboxAttachmentWriteError>;
+/** Validates a transient capture value without producing a Record write. */
+export declare function normalizeSandboxCapture(input: SandboxCaptureInput): Either.Either<SandboxAttachmentPayload, SandboxCaptureInputError>;

package/dist/sandbox/record/attachment.d.mts

@@ -1,8 +1,11 @@
 import { Either } from "effect";
-import { type RecordAttachmentFamily, type RecordAttachmentWrite } from "../../record/attachment/index.mjs";
-import type { SandboxAttachmentPayloadV1 } from "./model.mjs";
-/** The public input is a domain fact, never a raw Record envelope or payload. */
-export type SandboxAttachmentInput = {
+import type { SandboxAttachmentPayload } from "./model.mjs";
+/**
+ * Sandbox assignment is execution coordination, not a Record family. The
+ * only durable sandbox-produced facts are File Changes captured by the fixed
+ * `niceeval.file-changes` collector.
+ */
+export type SandboxCaptureInput = {
     readonly state: "not-used";
 } | {
     readonly state: "assigned";
@@ -16,15 +19,8 @@ export type SandboxAttachmentInput = {
         readonly ordinal: number;
     };
 };
-export type SandboxAttachmentWriteError = {
-    readonly code: "sandbox-attachment-input-invalid";
+export type SandboxCaptureInputError = {
+    readonly code: "sandbox-capture-input-invalid";
 };
-/** Package-owned definition for the sole Attempt-owned Sandbox fact. */
-export declare const sandboxAttachmentDefinition: import("../../record/attachment/types.mjs").JsonRecordAttachmentDefinition<"attempt", SandboxAttachmentPayloadV1>;
-/** The current family has no legacy compatibility or alternate durable schema. */
-export declare const sandboxAttachmentFamily: RecordAttachmentFamily<"attempt", SandboxAttachmentPayloadV1>;
-/**
- * Creates the sole zero-blob write for one actual Attempt. Invalid, missing,
- * or extra input never becomes a durable `not-used` claim.
- */
-export declare function createSandboxAttachmentWrite(input: SandboxAttachmentInput): Either.Either<RecordAttachmentWrite<"attempt", never, never>, SandboxAttachmentWriteError>;
+/** Validates a transient capture value without producing a Record write. */
+export declare function normalizeSandboxCapture(input: SandboxCaptureInput): Either.Either<SandboxAttachmentPayload, SandboxCaptureInputError>;

package/dist/sandbox/record/attachment.d.ts

@@ -1,8 +1,11 @@
 import { Either } from "effect";
-import { type RecordAttachmentFamily, type RecordAttachmentWrite } from "../../record/attachment/index.js";
-import type { SandboxAttachmentPayloadV1 } from "./model.js";
-/** The public input is a domain fact, never a raw Record envelope or payload. */
-export type SandboxAttachmentInput = {
+import type { SandboxAttachmentPayload } from "./model.js";
+/**
+ * Sandbox assignment is execution coordination, not a Record family. The
+ * only durable sandbox-produced facts are File Changes captured by the fixed
+ * `niceeval.file-changes` collector.
+ */
+export type SandboxCaptureInput = {
     readonly state: "not-used";
 } | {
     readonly state: "assigned";
@@ -16,15 +19,8 @@ export type SandboxAttachmentInput = {
         readonly ordinal: number;
     };
 };
-export type SandboxAttachmentWriteError = {
-    readonly code: "sandbox-attachment-input-invalid";
+export type SandboxCaptureInputError = {
+    readonly code: "sandbox-capture-input-invalid";
 };
-/** Package-owned definition for the sole Attempt-owned Sandbox fact. */
-export declare const sandboxAttachmentDefinition: import("../../record/attachment/types.js").JsonRecordAttachmentDefinition<"attempt", SandboxAttachmentPayloadV1>;
-/** The current family has no legacy compatibility or alternate durable schema. */
-export declare const sandboxAttachmentFamily: RecordAttachmentFamily<"attempt", SandboxAttachmentPayloadV1>;
-/**
- * Creates the sole zero-blob write for one actual Attempt. Invalid, missing,
- * or extra input never becomes a durable `not-used` claim.
- */
-export declare function createSandboxAttachmentWrite(input: SandboxAttachmentInput): Either.Either<RecordAttachmentWrite<"attempt", never, never>, SandboxAttachmentWriteError>;
+/** Validates a transient capture value without producing a Record write. */
+export declare function normalizeSandboxCapture(input: SandboxCaptureInput): Either.Either<SandboxAttachmentPayload, SandboxCaptureInputError>;

package/dist/sandbox/record/attachment.js

@@ -1,10 +1,6 @@
 import { createRequire as __niceevalCreateRequire } from "node:module";
 const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
 const __niceevalCanonical = __niceevalRequire("./attachment.cjs");
-const __niceevalExport0 = __niceevalCanonical["createSandboxAttachmentWrite"];
-export { __niceevalExport0 as createSandboxAttachmentWrite };
-const __niceevalExport1 = __niceevalCanonical["sandboxAttachmentDefinition"];
-export { __niceevalExport1 as sandboxAttachmentDefinition };
-const __niceevalExport2 = __niceevalCanonical["sandboxAttachmentFamily"];
-export { __niceevalExport2 as sandboxAttachmentFamily };
+const __niceevalExport0 = __niceevalCanonical["normalizeSandboxCapture"];
+export { __niceevalExport0 as normalizeSandboxCapture };
 //# sourceMappingURL=attachment.js.map

package/dist/sandbox/record/codec.cjs

@@ -1,36 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SandboxAttachmentPayloadV1Schema = exports.SourceNativeSandboxIdV1Schema = exports.SandboxAttachmentExactParseOptions = void 0;
+exports.SandboxAttachmentPayloadSchema = exports.SourceNativeSandboxIdSchema = exports.SandboxAttachmentExactParseOptions = void 0;
 const effect_1 = require("effect");
 const codec_ts_1 = require("../../o11y/record/codec.cjs");
 const model_ts_1 = require("./model.cjs");
-/** All Sandbox Attachment payloads aggregate errors and reject extra fields. */
+/** Sandbox capture values aggregate errors and reject extra fields. */
 exports.SandboxAttachmentExactParseOptions = Object.freeze({
     errors: "all",
     onExcessProperty: "error",
 });
-exports.SourceNativeSandboxIdV1Schema = effect_1.Schema.String.pipe(effect_1.Schema.filter(model_ts_1.isSourceNativeSandboxIdV1, {
-    identifier: "SourceNativeSandboxIdV1",
+exports.SourceNativeSandboxIdSchema = effect_1.Schema.String.pipe(effect_1.Schema.filter(model_ts_1.isSourceNativeSandboxId, {
+    identifier: "SourceNativeSandboxId",
     description: "a non-empty source-native safe UTF-8 sandbox id no longer than 256 bytes",
-}), effect_1.Schema.brand("@niceeval/sandbox/SourceNativeSandboxIdV1"));
-const SandboxFreshReuseV1Schema = effect_1.Schema.Struct({
+}), effect_1.Schema.brand("@niceeval/sandbox/SourceNativeSandboxId"));
+const SandboxFreshReuseSchema = effect_1.Schema.Struct({
     kind: effect_1.Schema.Literal("fresh"),
 });
-const SandboxPooledReuseV1Schema = effect_1.Schema.Struct({
+const SandboxPooledReuseSchema = effect_1.Schema.Struct({
     kind: effect_1.Schema.Literal("pooled"),
-    sandbox: codec_ts_1.PositiveSafeIntegerV1Schema,
-    ordinal: codec_ts_1.PositiveSafeIntegerV1Schema,
+    sandbox: codec_ts_1.PositiveSafeIntegerSchema,
+    ordinal: codec_ts_1.PositiveSafeIntegerSchema,
 });
-const SandboxReuseV1Schema = effect_1.Schema.Union(SandboxFreshReuseV1Schema, SandboxPooledReuseV1Schema);
-const SandboxNotUsedPayloadV1Schema = effect_1.Schema.Struct({
+const SandboxReuseSchema = effect_1.Schema.Union(SandboxFreshReuseSchema, SandboxPooledReuseSchema);
+const SandboxNotUsedPayloadSchema = effect_1.Schema.Struct({
     state: effect_1.Schema.Literal("not-used"),
 });
-const SandboxAssignedPayloadV1Schema = effect_1.Schema.Struct({
+const SandboxAssignedPayloadSchema = effect_1.Schema.Struct({
     state: effect_1.Schema.Literal("assigned"),
-    provider: codec_ts_1.SafeIdentifierV1Schema,
-    sandboxId: exports.SourceNativeSandboxIdV1Schema,
-    reuse: SandboxReuseV1Schema,
+    provider: codec_ts_1.SafeIdentifierSchema,
+    sandboxId: exports.SourceNativeSandboxIdSchema,
+    reuse: SandboxReuseSchema,
 });
-/** Exact durable schema for `niceeval.sandbox/v1`. */
-exports.SandboxAttachmentPayloadV1Schema = effect_1.Schema.Union(SandboxNotUsedPayloadV1Schema, SandboxAssignedPayloadV1Schema);
+/** Exact transient capture schema; it is never a Record Attachment payload. */
+exports.SandboxAttachmentPayloadSchema = effect_1.Schema.Union(SandboxNotUsedPayloadSchema, SandboxAssignedPayloadSchema);
 //# sourceMappingURL=codec.cjs.map

package/dist/sandbox/record/codec.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"codec.js","sourceRoot":"","sources":["codec.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAChC,yDAAkG;AAClG,yCAA8P;AAC9P,gFAAgF;AACnE,QAAA,kCAAkC,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5D,MAAM,EAAE,KAAc;IACtB,gBAAgB,EAAE,OAAgB;CACrC,CAAC,CAAC;AACU,QAAA,6BAA6B,GAAmD,eAAM,CAAC,MAAM,CAAC,IAAI,CAAC,eAAM,CAAC,MAAM,CAAC,oCAAyB,EAAE;IACrJ,UAAU,EAAE,yBAAyB;IACrC,WAAW,EAAE,0EAA0E;CAC1F,CAAC,EAAE,eAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC,CAAC;AAoB/D,MAAM,yBAAyB,GAAmE,eAAM,CAAC,MAAM,CAAC;IAC5G,IAAI,EAAE,eAAM,CAAC,OAAO,CAAC,OAAO,CAAC;CAChC,CAAC,CAAC;AACH,MAAM,0BAA0B,GAAqE,eAAM,CAAC,MAAM,CAAC;IAC/G,IAAI,EAAE,eAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC9B,OAAO,EAAE,sCAA2B;IACpC,OAAO,EAAE,sCAA2B;CACvC,CAAC,CAAC;AACH,MAAM,oBAAoB,GAAyD,eAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,0BAA0B,CAAC,CAAC;AACvJ,MAAM,6BAA6B,GAA2E,eAAM,CAAC,MAAM,CAAC;IACxH,KAAK,EAAE,eAAM,CAAC,OAAO,CAAC,UAAU,CAAC;CACpC,CAAC,CAAC;AACH,MAAM,8BAA8B,GAA6E,eAAM,CAAC,MAAM,CAAC;IAC3H,KAAK,EAAE,eAAM,CAAC,OAAO,CAAC,UAAU,CAAC;IACjC,QAAQ,EAAE,iCAAsB;IAChC,SAAS,EAAE,qCAA6B;IACxC,KAAK,EAAE,oBAAoB;CAC9B,CAAC,CAAC;AACH,sDAAsD;AACzC,QAAA,gCAAgC,GAAiF,eAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,8BAA8B,CAAC,CAAC","sourcesContent":["import { Schema } from \"effect\";\nimport { PositiveSafeIntegerV1Schema, SafeIdentifierV1Schema, } from \"../../o11y/record/codec.ts\";\nimport { isSourceNativeSandboxIdV1, type SandboxAssignedPayloadV1, type SandboxAttachmentPayloadV1, type SandboxFreshReuseV1, type SandboxNotUsedPayloadV1, type SandboxPooledReuseV1, type SandboxReuseV1, type SourceNativeSandboxIdV1, } from \"./model.ts\";\n/** All Sandbox Attachment payloads aggregate errors and reject extra fields. */\nexport const SandboxAttachmentExactParseOptions = Object.freeze({\n    errors: \"all\" as const,\n    onExcessProperty: \"error\" as const,\n});\nexport const SourceNativeSandboxIdV1Schema: Schema.Schema<SourceNativeSandboxIdV1, string> = Schema.String.pipe(Schema.filter(isSourceNativeSandboxIdV1, {\n    identifier: \"SourceNativeSandboxIdV1\",\n    description: \"a non-empty source-native safe UTF-8 sandbox id no longer than 256 bytes\",\n}), Schema.brand(\"@niceeval/sandbox/SourceNativeSandboxIdV1\"));\ntype SandboxFreshReuseV1Encoded = {\n    readonly kind: \"fresh\";\n};\ntype SandboxPooledReuseV1Encoded = {\n    readonly kind: \"pooled\";\n    readonly sandbox: number;\n    readonly ordinal: number;\n};\ntype SandboxReuseV1Encoded = SandboxFreshReuseV1Encoded | SandboxPooledReuseV1Encoded;\ntype SandboxNotUsedPayloadV1Encoded = {\n    readonly state: \"not-used\";\n};\ntype SandboxAssignedPayloadV1Encoded = {\n    readonly state: \"assigned\";\n    readonly provider: string;\n    readonly sandboxId: string;\n    readonly reuse: SandboxReuseV1Encoded;\n};\ntype SandboxAttachmentPayloadV1Encoded = SandboxNotUsedPayloadV1Encoded | SandboxAssignedPayloadV1Encoded;\nconst SandboxFreshReuseV1Schema: Schema.Schema<SandboxFreshReuseV1, SandboxFreshReuseV1Encoded> = Schema.Struct({\n    kind: Schema.Literal(\"fresh\"),\n});\nconst SandboxPooledReuseV1Schema: Schema.Schema<SandboxPooledReuseV1, SandboxPooledReuseV1Encoded> = Schema.Struct({\n    kind: Schema.Literal(\"pooled\"),\n    sandbox: PositiveSafeIntegerV1Schema,\n    ordinal: PositiveSafeIntegerV1Schema,\n});\nconst SandboxReuseV1Schema: Schema.Schema<SandboxReuseV1, SandboxReuseV1Encoded> = Schema.Union(SandboxFreshReuseV1Schema, SandboxPooledReuseV1Schema);\nconst SandboxNotUsedPayloadV1Schema: Schema.Schema<SandboxNotUsedPayloadV1, SandboxNotUsedPayloadV1Encoded> = Schema.Struct({\n    state: Schema.Literal(\"not-used\"),\n});\nconst SandboxAssignedPayloadV1Schema: Schema.Schema<SandboxAssignedPayloadV1, SandboxAssignedPayloadV1Encoded> = Schema.Struct({\n    state: Schema.Literal(\"assigned\"),\n    provider: SafeIdentifierV1Schema,\n    sandboxId: SourceNativeSandboxIdV1Schema,\n    reuse: SandboxReuseV1Schema,\n});\n/** Exact durable schema for `niceeval.sandbox/v1`. */\nexport const SandboxAttachmentPayloadV1Schema: Schema.Schema<SandboxAttachmentPayloadV1, SandboxAttachmentPayloadV1Encoded> = Schema.Union(SandboxNotUsedPayloadV1Schema, SandboxAssignedPayloadV1Schema);\n"]}
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["codec.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAChC,yDAA8F;AAC9F,yCAA8O;AAC9O,uEAAuE;AAC1D,QAAA,kCAAkC,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5D,MAAM,EAAE,KAAc;IACtB,gBAAgB,EAAE,OAAgB;CACrC,CAAC,CAAC;AACU,QAAA,2BAA2B,GAAiD,eAAM,CAAC,MAAM,CAAC,IAAI,CAAC,eAAM,CAAC,MAAM,CAAC,kCAAuB,EAAE;IAC/I,UAAU,EAAE,uBAAuB;IACnC,WAAW,EAAE,0EAA0E;CAC1F,CAAC,EAAE,eAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC,CAAC;AAoB7D,MAAM,uBAAuB,GAA+D,eAAM,CAAC,MAAM,CAAC;IACtG,IAAI,EAAE,eAAM,CAAC,OAAO,CAAC,OAAO,CAAC;CAChC,CAAC,CAAC;AACH,MAAM,wBAAwB,GAAiE,eAAM,CAAC,MAAM,CAAC;IACzG,IAAI,EAAE,eAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC9B,OAAO,EAAE,oCAAyB;IAClC,OAAO,EAAE,oCAAyB;CACrC,CAAC,CAAC;AACH,MAAM,kBAAkB,GAAqD,eAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,wBAAwB,CAAC,CAAC;AAC7I,MAAM,2BAA2B,GAAuE,eAAM,CAAC,MAAM,CAAC;IAClH,KAAK,EAAE,eAAM,CAAC,OAAO,CAAC,UAAU,CAAC;CACpC,CAAC,CAAC;AACH,MAAM,4BAA4B,GAAyE,eAAM,CAAC,MAAM,CAAC;IACrH,KAAK,EAAE,eAAM,CAAC,OAAO,CAAC,UAAU,CAAC;IACjC,QAAQ,EAAE,+BAAoB;IAC9B,SAAS,EAAE,mCAA2B;IACtC,KAAK,EAAE,kBAAkB;CAC5B,CAAC,CAAC;AACH,+EAA+E;AAClE,QAAA,8BAA8B,GAA6E,eAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,4BAA4B,CAAC,CAAC","sourcesContent":["import { Schema } from \"effect\";\nimport { PositiveSafeIntegerSchema, SafeIdentifierSchema, } from \"../../o11y/record/codec.ts\";\nimport { isSourceNativeSandboxId, type SandboxAssignedPayload, type SandboxAttachmentPayload, type SandboxFreshReuse, type SandboxNotUsedPayload, type SandboxPooledReuse, type SandboxReuse, type SourceNativeSandboxId, } from \"./model.ts\";\n/** Sandbox capture values aggregate errors and reject extra fields. */\nexport const SandboxAttachmentExactParseOptions = Object.freeze({\n    errors: \"all\" as const,\n    onExcessProperty: \"error\" as const,\n});\nexport const SourceNativeSandboxIdSchema: Schema.Schema<SourceNativeSandboxId, string> = Schema.String.pipe(Schema.filter(isSourceNativeSandboxId, {\n    identifier: \"SourceNativeSandboxId\",\n    description: \"a non-empty source-native safe UTF-8 sandbox id no longer than 256 bytes\",\n}), Schema.brand(\"@niceeval/sandbox/SourceNativeSandboxId\"));\ntype SandboxFreshReuseEncoded = {\n    readonly kind: \"fresh\";\n};\ntype SandboxPooledReuseEncoded = {\n    readonly kind: \"pooled\";\n    readonly sandbox: number;\n    readonly ordinal: number;\n};\ntype SandboxReuseEncoded = SandboxFreshReuseEncoded | SandboxPooledReuseEncoded;\ntype SandboxNotUsedPayloadEncoded = {\n    readonly state: \"not-used\";\n};\ntype SandboxAssignedPayloadEncoded = {\n    readonly state: \"assigned\";\n    readonly provider: string;\n    readonly sandboxId: string;\n    readonly reuse: SandboxReuseEncoded;\n};\ntype SandboxAttachmentPayloadEncoded = SandboxNotUsedPayloadEncoded | SandboxAssignedPayloadEncoded;\nconst SandboxFreshReuseSchema: Schema.Schema<SandboxFreshReuse, SandboxFreshReuseEncoded> = Schema.Struct({\n    kind: Schema.Literal(\"fresh\"),\n});\nconst SandboxPooledReuseSchema: Schema.Schema<SandboxPooledReuse, SandboxPooledReuseEncoded> = Schema.Struct({\n    kind: Schema.Literal(\"pooled\"),\n    sandbox: PositiveSafeIntegerSchema,\n    ordinal: PositiveSafeIntegerSchema,\n});\nconst SandboxReuseSchema: Schema.Schema<SandboxReuse, SandboxReuseEncoded> = Schema.Union(SandboxFreshReuseSchema, SandboxPooledReuseSchema);\nconst SandboxNotUsedPayloadSchema: Schema.Schema<SandboxNotUsedPayload, SandboxNotUsedPayloadEncoded> = Schema.Struct({\n    state: Schema.Literal(\"not-used\"),\n});\nconst SandboxAssignedPayloadSchema: Schema.Schema<SandboxAssignedPayload, SandboxAssignedPayloadEncoded> = Schema.Struct({\n    state: Schema.Literal(\"assigned\"),\n    provider: SafeIdentifierSchema,\n    sandboxId: SourceNativeSandboxIdSchema,\n    reuse: SandboxReuseSchema,\n});\n/** Exact transient capture schema; it is never a Record Attachment payload. */\nexport const SandboxAttachmentPayloadSchema: Schema.Schema<SandboxAttachmentPayload, SandboxAttachmentPayloadEncoded> = Schema.Union(SandboxNotUsedPayloadSchema, SandboxAssignedPayloadSchema);\n"]}

package/dist/sandbox/record/codec.d.cts

@@ -1,30 +1,30 @@
 import { Schema } from "effect";
-import { type SandboxAttachmentPayloadV1, type SourceNativeSandboxIdV1 } from "./model.cjs";
-/** All Sandbox Attachment payloads aggregate errors and reject extra fields. */
+import { type SandboxAttachmentPayload, type SourceNativeSandboxId } from "./model.cjs";
+/** Sandbox capture values aggregate errors and reject extra fields. */
 export declare const SandboxAttachmentExactParseOptions: Readonly<{
     errors: "all";
     onExcessProperty: "error";
 }>;
-export declare const SourceNativeSandboxIdV1Schema: Schema.Schema<SourceNativeSandboxIdV1, string>;
-type SandboxFreshReuseV1Encoded = {
+export declare const SourceNativeSandboxIdSchema: Schema.Schema<SourceNativeSandboxId, string>;
+type SandboxFreshReuseEncoded = {
     readonly kind: "fresh";
 };
-type SandboxPooledReuseV1Encoded = {
+type SandboxPooledReuseEncoded = {
     readonly kind: "pooled";
     readonly sandbox: number;
     readonly ordinal: number;
 };
-type SandboxReuseV1Encoded = SandboxFreshReuseV1Encoded | SandboxPooledReuseV1Encoded;
-type SandboxNotUsedPayloadV1Encoded = {
+type SandboxReuseEncoded = SandboxFreshReuseEncoded | SandboxPooledReuseEncoded;
+type SandboxNotUsedPayloadEncoded = {
     readonly state: "not-used";
 };
-type SandboxAssignedPayloadV1Encoded = {
+type SandboxAssignedPayloadEncoded = {
     readonly state: "assigned";
     readonly provider: string;
     readonly sandboxId: string;
-    readonly reuse: SandboxReuseV1Encoded;
+    readonly reuse: SandboxReuseEncoded;
 };
-type SandboxAttachmentPayloadV1Encoded = SandboxNotUsedPayloadV1Encoded | SandboxAssignedPayloadV1Encoded;
-/** Exact durable schema for `niceeval.sandbox/v1`. */
-export declare const SandboxAttachmentPayloadV1Schema: Schema.Schema<SandboxAttachmentPayloadV1, SandboxAttachmentPayloadV1Encoded>;
+type SandboxAttachmentPayloadEncoded = SandboxNotUsedPayloadEncoded | SandboxAssignedPayloadEncoded;
+/** Exact transient capture schema; it is never a Record Attachment payload. */
+export declare const SandboxAttachmentPayloadSchema: Schema.Schema<SandboxAttachmentPayload, SandboxAttachmentPayloadEncoded>;
 export {};

package/dist/sandbox/record/codec.d.mts

@@ -1,30 +1,30 @@
 import { Schema } from "effect";
-import { type SandboxAttachmentPayloadV1, type SourceNativeSandboxIdV1 } from "./model.mjs";
-/** All Sandbox Attachment payloads aggregate errors and reject extra fields. */
+import { type SandboxAttachmentPayload, type SourceNativeSandboxId } from "./model.mjs";
+/** Sandbox capture values aggregate errors and reject extra fields. */
 export declare const SandboxAttachmentExactParseOptions: Readonly<{
     errors: "all";
     onExcessProperty: "error";
 }>;
-export declare const SourceNativeSandboxIdV1Schema: Schema.Schema<SourceNativeSandboxIdV1, string>;
-type SandboxFreshReuseV1Encoded = {
+export declare const SourceNativeSandboxIdSchema: Schema.Schema<SourceNativeSandboxId, string>;
+type SandboxFreshReuseEncoded = {
     readonly kind: "fresh";
 };
-type SandboxPooledReuseV1Encoded = {
+type SandboxPooledReuseEncoded = {
     readonly kind: "pooled";
     readonly sandbox: number;
     readonly ordinal: number;
 };
-type SandboxReuseV1Encoded = SandboxFreshReuseV1Encoded | SandboxPooledReuseV1Encoded;
-type SandboxNotUsedPayloadV1Encoded = {
+type SandboxReuseEncoded = SandboxFreshReuseEncoded | SandboxPooledReuseEncoded;
+type SandboxNotUsedPayloadEncoded = {
     readonly state: "not-used";
 };
-type SandboxAssignedPayloadV1Encoded = {
+type SandboxAssignedPayloadEncoded = {
     readonly state: "assigned";
     readonly provider: string;
     readonly sandboxId: string;
-    readonly reuse: SandboxReuseV1Encoded;
+    readonly reuse: SandboxReuseEncoded;
 };
-type SandboxAttachmentPayloadV1Encoded = SandboxNotUsedPayloadV1Encoded | SandboxAssignedPayloadV1Encoded;
-/** Exact durable schema for `niceeval.sandbox/v1`. */
-export declare const SandboxAttachmentPayloadV1Schema: Schema.Schema<SandboxAttachmentPayloadV1, SandboxAttachmentPayloadV1Encoded>;
+type SandboxAttachmentPayloadEncoded = SandboxNotUsedPayloadEncoded | SandboxAssignedPayloadEncoded;
+/** Exact transient capture schema; it is never a Record Attachment payload. */
+export declare const SandboxAttachmentPayloadSchema: Schema.Schema<SandboxAttachmentPayload, SandboxAttachmentPayloadEncoded>;
 export {};

package/dist/sandbox/record/codec.d.ts

@@ -1,30 +1,30 @@
 import { Schema } from "effect";
-import { type SandboxAttachmentPayloadV1, type SourceNativeSandboxIdV1 } from "./model.js";
-/** All Sandbox Attachment payloads aggregate errors and reject extra fields. */
+import { type SandboxAttachmentPayload, type SourceNativeSandboxId } from "./model.js";
+/** Sandbox capture values aggregate errors and reject extra fields. */
 export declare const SandboxAttachmentExactParseOptions: Readonly<{
     errors: "all";
     onExcessProperty: "error";
 }>;
-export declare const SourceNativeSandboxIdV1Schema: Schema.Schema<SourceNativeSandboxIdV1, string>;
-type SandboxFreshReuseV1Encoded = {
+export declare const SourceNativeSandboxIdSchema: Schema.Schema<SourceNativeSandboxId, string>;
+type SandboxFreshReuseEncoded = {
     readonly kind: "fresh";
 };
-type SandboxPooledReuseV1Encoded = {
+type SandboxPooledReuseEncoded = {
     readonly kind: "pooled";
     readonly sandbox: number;
     readonly ordinal: number;
 };
-type SandboxReuseV1Encoded = SandboxFreshReuseV1Encoded | SandboxPooledReuseV1Encoded;
-type SandboxNotUsedPayloadV1Encoded = {
+type SandboxReuseEncoded = SandboxFreshReuseEncoded | SandboxPooledReuseEncoded;
+type SandboxNotUsedPayloadEncoded = {
     readonly state: "not-used";
 };
-type SandboxAssignedPayloadV1Encoded = {
+type SandboxAssignedPayloadEncoded = {
     readonly state: "assigned";
     readonly provider: string;
     readonly sandboxId: string;
-    readonly reuse: SandboxReuseV1Encoded;
+    readonly reuse: SandboxReuseEncoded;
 };
-type SandboxAttachmentPayloadV1Encoded = SandboxNotUsedPayloadV1Encoded | SandboxAssignedPayloadV1Encoded;
-/** Exact durable schema for `niceeval.sandbox/v1`. */
-export declare const SandboxAttachmentPayloadV1Schema: Schema.Schema<SandboxAttachmentPayloadV1, SandboxAttachmentPayloadV1Encoded>;
+type SandboxAttachmentPayloadEncoded = SandboxNotUsedPayloadEncoded | SandboxAssignedPayloadEncoded;
+/** Exact transient capture schema; it is never a Record Attachment payload. */
+export declare const SandboxAttachmentPayloadSchema: Schema.Schema<SandboxAttachmentPayload, SandboxAttachmentPayloadEncoded>;
 export {};

package/dist/sandbox/record/codec.js

@@ -3,8 +3,8 @@ const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
 const __niceevalCanonical = __niceevalRequire("./codec.cjs");
 const __niceevalExport0 = __niceevalCanonical["SandboxAttachmentExactParseOptions"];
 export { __niceevalExport0 as SandboxAttachmentExactParseOptions };
-const __niceevalExport1 = __niceevalCanonical["SandboxAttachmentPayloadV1Schema"];
-export { __niceevalExport1 as SandboxAttachmentPayloadV1Schema };
-const __niceevalExport2 = __niceevalCanonical["SourceNativeSandboxIdV1Schema"];
-export { __niceevalExport2 as SourceNativeSandboxIdV1Schema };
+const __niceevalExport1 = __niceevalCanonical["SandboxAttachmentPayloadSchema"];
+export { __niceevalExport1 as SandboxAttachmentPayloadSchema };
+const __niceevalExport2 = __niceevalCanonical["SourceNativeSandboxIdSchema"];
+export { __niceevalExport2 as SourceNativeSandboxIdSchema };
 //# sourceMappingURL=codec.js.map

package/dist/sandbox/record/model.cjs

@@ -1,20 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SOURCE_NATIVE_SANDBOX_ID_V1_BRAND = exports.MAX_SOURCE_NATIVE_SANDBOX_ID_UTF8_BYTES_V1 = void 0;
-exports.isSourceNativeSandboxIdV1 = isSourceNativeSandboxIdV1;
+exports.SOURCE_NATIVE_SANDBOX_ID__BRAND = exports.MAX_SOURCE_NATIVE_SANDBOX_ID_UTF8_BYTES = void 0;
+exports.isSourceNativeSandboxId = isSourceNativeSandboxId;
 const model_ts_1 = require("../../o11y/record/model.cjs");
 /** The durable bound for a provider-native Sandbox identifier. */
-exports.MAX_SOURCE_NATIVE_SANDBOX_ID_UTF8_BYTES_V1 = 256;
-exports.SOURCE_NATIVE_SANDBOX_ID_V1_BRAND = "@niceeval/sandbox/SourceNativeSandboxIdV1";
+exports.MAX_SOURCE_NATIVE_SANDBOX_ID_UTF8_BYTES = 256;
+exports.SOURCE_NATIVE_SANDBOX_ID__BRAND = "@niceeval/sandbox/SourceNativeSandboxId";
 /**
  * Sandbox IDs are source-native, so their punctuation and case remain intact.
  * They cannot contain control characters or newlines that would reshape a
  * durable display, and they must round-trip through strict UTF-8.
  */
-function isSourceNativeSandboxIdV1(value) {
+function isSourceNativeSandboxId(value) {
     return (value.length > 0
         && !value.includes("\n")
-        && (0, model_ts_1.isSafeTextV1)(value)
-        && (0, model_ts_1.utf8ByteLengthV1)(value) <= exports.MAX_SOURCE_NATIVE_SANDBOX_ID_UTF8_BYTES_V1);
+        && (0, model_ts_1.isSafeText)(value)
+        && (0, model_ts_1.utf8ByteLength)(value) <= exports.MAX_SOURCE_NATIVE_SANDBOX_ID_UTF8_BYTES);
 }
 //# sourceMappingURL=model.cjs.map

package/dist/sandbox/record/model.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","sourceRoot":"","sources":["model.ts"],"names":[],"mappings":";;;AAgCA,8DAKC;AApCD,yDAA4H;AAC5H,kEAAkE;AACrD,QAAA,0CAA0C,GAAG,GAAG,CAAC;AACjD,QAAA,iCAAiC,GAAG,2CAAoD,CAAC;AAuBtG;;;;GAIG;AACH,SAAgB,yBAAyB,CAAC,KAAa;IACnD,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;WACjB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;WACrB,IAAA,uBAAY,EAAC,KAAK,CAAC;WACnB,IAAA,2BAAgB,EAAC,KAAK,CAAC,IAAI,kDAA0C,CAAC,CAAC;AAClF,CAAC","sourcesContent":["import type { Brand } from \"effect\";\nimport { isSafeTextV1, utf8ByteLengthV1, type PositiveSafeInteger, type SafeIdentifier, } from \"../../o11y/record/model.ts\";\n/** The durable bound for a provider-native Sandbox identifier. */\nexport const MAX_SOURCE_NATIVE_SANDBOX_ID_UTF8_BYTES_V1 = 256;\nexport const SOURCE_NATIVE_SANDBOX_ID_V1_BRAND = \"@niceeval/sandbox/SourceNativeSandboxIdV1\" as const;\n/** A provider-issued identifier preserved verbatim after safe UTF-8 validation. */\nexport type SourceNativeSandboxIdV1 = string & Brand.Brand<typeof SOURCE_NATIVE_SANDBOX_ID_V1_BRAND>;\nexport interface SandboxFreshReuseV1 {\n    readonly kind: \"fresh\";\n}\nexport interface SandboxPooledReuseV1 {\n    readonly kind: \"pooled\";\n    readonly sandbox: PositiveSafeInteger;\n    readonly ordinal: PositiveSafeInteger;\n}\nexport type SandboxReuseV1 = SandboxFreshReuseV1 | SandboxPooledReuseV1;\nexport interface SandboxNotUsedPayloadV1 {\n    readonly state: \"not-used\";\n}\nexport interface SandboxAssignedPayloadV1 {\n    readonly state: \"assigned\";\n    readonly provider: SafeIdentifier;\n    readonly sandboxId: SourceNativeSandboxIdV1;\n    readonly reuse: SandboxReuseV1;\n}\n/** The exact durable payload for the Attempt-owned `niceeval.sandbox/v1` family. */\nexport type SandboxAttachmentPayloadV1 = SandboxNotUsedPayloadV1 | SandboxAssignedPayloadV1;\n/**\n * Sandbox IDs are source-native, so their punctuation and case remain intact.\n * They cannot contain control characters or newlines that would reshape a\n * durable display, and they must round-trip through strict UTF-8.\n */\nexport function isSourceNativeSandboxIdV1(value: string): value is SourceNativeSandboxIdV1 {\n    return (value.length > 0\n        && !value.includes(\"\\n\")\n        && isSafeTextV1(value)\n        && utf8ByteLengthV1(value) <= MAX_SOURCE_NATIVE_SANDBOX_ID_UTF8_BYTES_V1);\n}\n"]}
+{"version":3,"file":"model.js","sourceRoot":"","sources":["model.ts"],"names":[],"mappings":";;;AAgCA,0DAKC;AApCD,yDAAwH;AACxH,kEAAkE;AACrD,QAAA,uCAAuC,GAAG,GAAG,CAAC;AAC9C,QAAA,+BAA+B,GAAG,yCAAkD,CAAC;AAuBlG;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,KAAa;IACjD,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;WACjB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;WACrB,IAAA,qBAAU,EAAC,KAAK,CAAC;WACjB,IAAA,yBAAc,EAAC,KAAK,CAAC,IAAI,+CAAuC,CAAC,CAAC;AAC7E,CAAC","sourcesContent":["import type { Brand } from \"effect\";\nimport { isSafeText, utf8ByteLength, type PositiveSafeInteger, type SafeIdentifier, } from \"../../o11y/record/model.ts\";\n/** The durable bound for a provider-native Sandbox identifier. */\nexport const MAX_SOURCE_NATIVE_SANDBOX_ID_UTF8_BYTES = 256;\nexport const SOURCE_NATIVE_SANDBOX_ID__BRAND = \"@niceeval/sandbox/SourceNativeSandboxId\" as const;\n/** A provider-issued identifier preserved verbatim after safe UTF-8 validation. */\nexport type SourceNativeSandboxId = string & Brand.Brand<typeof SOURCE_NATIVE_SANDBOX_ID__BRAND>;\nexport interface SandboxFreshReuse {\n    readonly kind: \"fresh\";\n}\nexport interface SandboxPooledReuse {\n    readonly kind: \"pooled\";\n    readonly sandbox: PositiveSafeInteger;\n    readonly ordinal: PositiveSafeInteger;\n}\nexport type SandboxReuse = SandboxFreshReuse | SandboxPooledReuse;\nexport interface SandboxNotUsedPayload {\n    readonly state: \"not-used\";\n}\nexport interface SandboxAssignedPayload {\n    readonly state: \"assigned\";\n    readonly provider: SafeIdentifier;\n    readonly sandboxId: SourceNativeSandboxId;\n    readonly reuse: SandboxReuse;\n}\n/** Transient sandbox assignment facts used while producing File Changes. */\nexport type SandboxAttachmentPayload = SandboxNotUsedPayload | SandboxAssignedPayload;\n/**\n * Sandbox IDs are source-native, so their punctuation and case remain intact.\n * They cannot contain control characters or newlines that would reshape a\n * durable display, and they must round-trip through strict UTF-8.\n */\nexport function isSourceNativeSandboxId(value: string): value is SourceNativeSandboxId {\n    return (value.length > 0\n        && !value.includes(\"\\n\")\n        && isSafeText(value)\n        && utf8ByteLength(value) <= MAX_SOURCE_NATIVE_SANDBOX_ID_UTF8_BYTES);\n}\n"]}

package/dist/sandbox/record/model.d.cts

@@ -1,33 +1,33 @@
 import type { Brand } from "effect";
 import { type PositiveSafeInteger, type SafeIdentifier } from "../../o11y/record/model.cjs";
 /** The durable bound for a provider-native Sandbox identifier. */
-export declare const MAX_SOURCE_NATIVE_SANDBOX_ID_UTF8_BYTES_V1 = 256;
-export declare const SOURCE_NATIVE_SANDBOX_ID_V1_BRAND: "@niceeval/sandbox/SourceNativeSandboxIdV1";
+export declare const MAX_SOURCE_NATIVE_SANDBOX_ID_UTF8_BYTES = 256;
+export declare const SOURCE_NATIVE_SANDBOX_ID__BRAND: "@niceeval/sandbox/SourceNativeSandboxId";
 /** A provider-issued identifier preserved verbatim after safe UTF-8 validation. */
-export type SourceNativeSandboxIdV1 = string & Brand.Brand<typeof SOURCE_NATIVE_SANDBOX_ID_V1_BRAND>;
-export interface SandboxFreshReuseV1 {
+export type SourceNativeSandboxId = string & Brand.Brand<typeof SOURCE_NATIVE_SANDBOX_ID__BRAND>;
+export interface SandboxFreshReuse {
     readonly kind: "fresh";
 }
-export interface SandboxPooledReuseV1 {
+export interface SandboxPooledReuse {
     readonly kind: "pooled";
     readonly sandbox: PositiveSafeInteger;
     readonly ordinal: PositiveSafeInteger;
 }
-export type SandboxReuseV1 = SandboxFreshReuseV1 | SandboxPooledReuseV1;
-export interface SandboxNotUsedPayloadV1 {
+export type SandboxReuse = SandboxFreshReuse | SandboxPooledReuse;
+export interface SandboxNotUsedPayload {
     readonly state: "not-used";
 }
-export interface SandboxAssignedPayloadV1 {
+export interface SandboxAssignedPayload {
     readonly state: "assigned";
     readonly provider: SafeIdentifier;
-    readonly sandboxId: SourceNativeSandboxIdV1;
-    readonly reuse: SandboxReuseV1;
+    readonly sandboxId: SourceNativeSandboxId;
+    readonly reuse: SandboxReuse;
 }
-/** The exact durable payload for the Attempt-owned `niceeval.sandbox/v1` family. */
-export type SandboxAttachmentPayloadV1 = SandboxNotUsedPayloadV1 | SandboxAssignedPayloadV1;
+/** Transient sandbox assignment facts used while producing File Changes. */
+export type SandboxAttachmentPayload = SandboxNotUsedPayload | SandboxAssignedPayload;
 /**
  * Sandbox IDs are source-native, so their punctuation and case remain intact.
  * They cannot contain control characters or newlines that would reshape a
  * durable display, and they must round-trip through strict UTF-8.
  */
-export declare function isSourceNativeSandboxIdV1(value: string): value is SourceNativeSandboxIdV1;
+export declare function isSourceNativeSandboxId(value: string): value is SourceNativeSandboxId;