@playcraft/common 0.1.41-prod → 0.1.43-beta

package/dist/cloud-workspace/runtime/asset-library-import.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+export declare const WORKSPACE_ASSET_LIBRARY_IMPORT_BODY_MAX_BYTES: number;
+export declare const workspaceAssetLibraryImportPayloadSchema: z.ZodObject<{
+    assetIds: z.ZodArray<z.ZodString>;
+    targetDirectory: z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodString]>;
+    collision: z.ZodEnum<{
+        replace: "replace";
+        rename: "rename";
+        skip: "skip";
+    }>;
+}, z.core.$strict>;
+export declare const workspaceAssetLibraryImportResultSchema: z.ZodObject<{
+    paths: z.ZodArray<z.ZodString>;
+    skippedPaths: z.ZodArray<z.ZodString>;
+    failures: z.ZodArray<z.ZodObject<{
+        assetId: z.ZodString;
+        error: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const workspaceAssetLibraryImportTransportSchema: z.ZodObject<{
+    assets: z.ZodArray<z.ZodObject<{
+        assetId: z.ZodString;
+        name: z.ZodString;
+        libraryPath: z.ZodString;
+        visibility: z.ZodEnum<{
+            public: "public";
+            team: "team";
+        }>;
+        teamId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodEnum<{
+            file: "file";
+            bundle: "bundle";
+        }>;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+            mimeType: z.ZodString;
+            sha256: z.ZodString;
+        }, z.core.$strict>>;
+        contentHash: z.ZodString;
+    }, z.core.$strict>>;
+    failures: z.ZodArray<z.ZodObject<{
+        assetId: z.ZodString;
+        error: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WorkspaceAssetLibraryImportPayload = z.infer<typeof workspaceAssetLibraryImportPayloadSchema>;
+export type WorkspaceAssetLibraryImportResult = z.infer<typeof workspaceAssetLibraryImportResultSchema>;
+export type WorkspaceAssetLibraryImportTransport = z.infer<typeof workspaceAssetLibraryImportTransportSchema>;
+//# sourceMappingURL=asset-library-import.d.ts.map

package/dist/cloud-workspace/runtime/asset-library-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-library-import.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/asset-library-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,6CAA6C,QAA+E,CAAC;AAG1I,eAAO,MAAM,wCAAwC;;;;;;;;kBAK1C,CAAC;AAEZ,eAAO,MAAM,uCAAuC;;;;;;;kBAIzC,CAAC;AAEZ,eAAO,MAAM,0CAA0C;;;;;;;;;;;;;;;;;;;;;;;;;;kBAUrD,CAAC;AAEH,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wCAAwC,CAAC,CAAC;AAC1G,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uCAAuC,CAAC,CAAC;AACxG,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0CAA0C,CAAC,CAAC"}

package/dist/cloud-workspace/runtime/asset-library-import.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { workspaceRelativePathSchema } from './files.js';
+import { WORKSPACE_ATTACHMENT_MAX_COUNT } from './attachments.js';
+import { WORKSPACE_LIBRARY_ATTACHMENT_MAX_BYTES, WORKSPACE_LIBRARY_ATTACHMENT_MAX_FILES, workspaceLibraryAssetExportSchema } from './library-attachments.js';
+export const WORKSPACE_ASSET_LIBRARY_IMPORT_BODY_MAX_BYTES = 4 * Math.ceil(WORKSPACE_LIBRARY_ATTACHMENT_MAX_BYTES / 3) + 32 * 1024 * 1024;
+const failureSchema = z.object({ assetId: z.string().min(1).max(128), error: z.string().min(1).max(256) }).strict();
+export const workspaceAssetLibraryImportPayloadSchema = z.object({
+    assetIds: z.array(z.string().min(1).max(128)).min(1).max(WORKSPACE_ATTACHMENT_MAX_COUNT)
+        .refine(ids => new Set(ids).size === ids.length, 'duplicate_library_asset'),
+    targetDirectory: z.union([z.literal(''), workspaceRelativePathSchema]),
+    collision: z.enum(['rename', 'skip', 'replace']),
+}).strict();
+export const workspaceAssetLibraryImportResultSchema = z.object({
+    paths: z.array(workspaceRelativePathSchema).max(WORKSPACE_ATTACHMENT_MAX_COUNT * WORKSPACE_LIBRARY_ATTACHMENT_MAX_FILES),
+    skippedPaths: z.array(workspaceRelativePathSchema).max(WORKSPACE_ATTACHMENT_MAX_COUNT),
+    failures: z.array(failureSchema).max(WORKSPACE_ATTACHMENT_MAX_COUNT),
+}).strict();
+export const workspaceAssetLibraryImportTransportSchema = z.object({
+    assets: z.array(workspaceLibraryAssetExportSchema).max(WORKSPACE_ATTACHMENT_MAX_COUNT),
+    failures: z.array(failureSchema).max(WORKSPACE_ATTACHMENT_MAX_COUNT),
+}).strict().superRefine((input, context) => {
+    const ids = [...input.assets.map(asset => asset.assetId), ...input.failures.map(failure => failure.assetId)];
+    if (ids.length > WORKSPACE_ATTACHMENT_MAX_COUNT || new Set(ids).size !== ids.length)
+        context.addIssue({ code: 'custom', message: 'duplicate_library_asset' });
+    if (input.assets.reduce((total, asset) => total + asset.files.reduce((size, file) => size + Buffer.byteLength(file.content, 'base64'), 0), 0) > WORKSPACE_LIBRARY_ATTACHMENT_MAX_BYTES)
+        context.addIssue({ code: 'custom', message: 'library_asset_too_large' });
+});
+//# sourceMappingURL=asset-library-import.js.map

package/dist/cloud-workspace/runtime/asset-library-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-library-import.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/asset-library-import.ts"],"names":[],"mappings":"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"}

package/dist/cloud-workspace/runtime/attachment-base64.d.ts

@@ -0,0 +1,3 @@
+/** Validate large payloads without repeated regular-expression groups exhausting the stack. */
+export declare function isAttachmentBase64(value: string): boolean;
+//# sourceMappingURL=attachment-base64.d.ts.map

package/dist/cloud-workspace/runtime/attachment-base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-base64.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/attachment-base64.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIzD"}

package/dist/cloud-workspace/runtime/attachment-base64.js

@@ -0,0 +1,8 @@
+/** Validate large payloads without repeated regular-expression groups exhausting the stack. */
+export function isAttachmentBase64(value) {
+    if (value.length % 4 !== 0)
+        return false;
+    const padding = value.endsWith('==') ? 2 : value.endsWith('=') ? 1 : 0;
+    return !/[^A-Za-z0-9+/]/.test(value.slice(0, value.length - padding));
+}
+//# sourceMappingURL=attachment-base64.js.map

package/dist/cloud-workspace/runtime/attachment-base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-base64.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/attachment-base64.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/dist/cloud-workspace/runtime/attachments.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import type { WorkspaceAttachmentOrigin, WorkspaceAttachmentFile } from './library-attachments.js';
+export declare const WORKSPACE_ATTACHMENT_MAX_BYTES: number;
+export declare const WORKSPACE_VIDEO_ATTACHMENT_MAX_BYTES: number;
+export declare const WORKSPACE_VIDEO_ATTACHMENT_MAX_DURATION_MS = 180000;
+export declare const WORKSPACE_ATTACHMENT_MAX_COUNT = 8;
+export declare const attachmentIdsSchema: z.ZodArray<z.ZodString>;
+export declare const attachmentUploadSchema: z.ZodObject<{
+    name: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+export declare const workspaceVideoAttachmentQuerySchema: z.ZodObject<{
+    name: z.ZodString;
+}, z.core.$strip>;
+export declare const WORKSPACE_VIDEO_ATTACHMENT_MIME_TYPES: readonly ["video/mp4", "video/webm", "video/quicktime"];
+export type WorkspaceAttachment = {
+    id: string;
+    name: string;
+    size: number;
+    mimeType: string;
+    sha256?: string;
+    durationMs?: number;
+    width?: number;
+    height?: number;
+    kind?: 'file' | 'bundle' | 'directory';
+    path?: string;
+    origin?: WorkspaceAttachmentOrigin;
+    files?: WorkspaceAttachmentFile[];
+};
+export declare const WORKSPACE_USER_UPLOADS_DIRECTORY = ".tmp/user_uploads";
+/** Only managed attachment files bypass the usual scratch-file backup exclusions. */
+export declare function isWorkspaceAttachmentPath(path: string): boolean;
+//# sourceMappingURL=attachments.d.ts.map

package/dist/cloud-workspace/runtime/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/attachments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGnG,eAAO,MAAM,8BAA8B,QAAoB,CAAC;AAChE,eAAO,MAAM,oCAAoC,QAAoB,CAAC;AACtE,eAAO,MAAM,0CAA0C,SAAU,CAAC;AAClE,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,mBAAmB,yBAAiE,CAAC;AAClG,eAAO,MAAM,sBAAsB;;;iBAUjC,CAAC;AACH,eAAO,MAAM,mCAAmC;;iBAE9C,CAAC;AACH,eAAO,MAAM,qCAAqC,yDAA0D,CAAC;AAC7G,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC,KAAK,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACnC,CAAC;AAEF,eAAO,MAAM,gCAAgC,sBAAsB,CAAC;AAEpE,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAY/D"}

package/dist/cloud-workspace/runtime/attachments.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { isAttachmentBase64 } from './attachment-base64.js';
+export const WORKSPACE_ATTACHMENT_MAX_BYTES = 100 * 1024 * 1024;
+export const WORKSPACE_VIDEO_ATTACHMENT_MAX_BYTES = 100 * 1024 * 1024;
+export const WORKSPACE_VIDEO_ATTACHMENT_MAX_DURATION_MS = 180_000;
+export const WORKSPACE_ATTACHMENT_MAX_COUNT = 8;
+export const attachmentIdsSchema = z.array(z.string().uuid()).max(WORKSPACE_ATTACHMENT_MAX_COUNT);
+export const attachmentUploadSchema = z.object({
+    name: z
+        .string()
+        .min(1)
+        .max(255)
+        .refine((name) => !/[\\/\x00-\x1f]/.test(name) && name !== '.' && name !== '..'),
+    content: z
+        .string()
+        .max(4 * Math.ceil(WORKSPACE_ATTACHMENT_MAX_BYTES / 3))
+        .refine(isAttachmentBase64, 'invalid_attachment_content'),
+});
+export const workspaceVideoAttachmentQuerySchema = z.object({
+    name: attachmentUploadSchema.shape.name,
+});
+export const WORKSPACE_VIDEO_ATTACHMENT_MIME_TYPES = ['video/mp4', 'video/webm', 'video/quicktime'];
+export const WORKSPACE_USER_UPLOADS_DIRECTORY = '.tmp/user_uploads';
+/** Only managed attachment files bypass the usual scratch-file backup exclusions. */
+export function isWorkspaceAttachmentPath(path) {
+    const parts = path.split('/');
+    if (parts.length < 4 || parts[0] !== '.tmp' || parts[1] !== 'user_uploads')
+        return false;
+    if (parts[2] === '.metadata') {
+        return (parts.length === 4 && parts[3].endsWith('.json') && z.string().uuid().safeParse(parts[3].slice(0, -5)).success);
+    }
+    return (z.string().uuid().safeParse(parts[2]).success &&
+        parts.slice(3).every(part => attachmentUploadSchema.shape.name.safeParse(part).success));
+}
+//# sourceMappingURL=attachments.js.map

package/dist/cloud-workspace/runtime/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/attachments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAChE,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AACtE,MAAM,CAAC,MAAM,0CAA0C,GAAG,OAAO,CAAC;AAClE,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AAClG,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC;IAClF,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,8BAA8B,GAAG,CAAC,CAAC,CAAC;SACtD,MAAM,CAAC,kBAAkB,EAAE,4BAA4B,CAAC;CAC5D,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1D,IAAI,EAAE,sBAAsB,CAAC,KAAK,CAAC,IAAI;CACxC,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,iBAAiB,CAAU,CAAC;AAgB7G,MAAM,CAAC,MAAM,gCAAgC,GAAG,mBAAmB,CAAC;AAEpE,qFAAqF;AACrF,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,cAAc;QAAE,OAAO,KAAK,CAAC;IACzF,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC;QAC7B,OAAO,CACL,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CACjH,CAAC;IACJ,CAAC;IACD,OAAO,CACL,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO;QAC7C,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CACxF,CAAC;AACJ,CAAC"}

package/dist/cloud-workspace/runtime/batch-generation.d.ts

@@ -0,0 +1,260 @@
+import { z } from 'zod';
+export declare const MAX_BATCH_VARIANTS = 10;
+export declare const MAX_BATCH_GENERATION_SLOTS = 3;
+export declare const batchVariantDifferenceSchema: z.ZodReadonly<z.ZodObject<{
+    variantId: z.ZodString;
+    name: z.ZodString;
+    changes: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    preserves: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+}, z.core.$strict>>;
+export type BatchVariantDifference = z.infer<typeof batchVariantDifferenceSchema>;
+/** Raw engineering input; capturing it does not claim a successful build or preview. */
+export declare const batchSourceSnapshotSchema: z.ZodReadonly<z.ZodObject<{
+    batchId: z.ZodString;
+    sourceWorkspaceId: z.ZodString;
+    sourceDirectoryName: z.ZodString;
+    snapshotId: z.ZodString;
+    commitHash: z.ZodString;
+    checksum: z.ZodString;
+    objectKey: z.ZodString;
+    archiveDigest: z.ZodString;
+    frozenAt: z.ZodString;
+}, z.core.$strict>>;
+export type BatchSourceSnapshot = z.infer<typeof batchSourceSnapshotSchema>;
+export declare const batchVariantManifestSchema: z.ZodReadonly<z.ZodObject<{
+    batchId: z.ZodString;
+    version: z.ZodNumber;
+    commonGoal: z.ZodString;
+    sourceDirectoryName: z.ZodOptional<z.ZodString>;
+    autoStart: z.ZodOptional<z.ZodBoolean>;
+    preflightCheck: z.ZodOptional<z.ZodBoolean>;
+    executionMode: z.ZodOptional<z.ZodLiteral<"direct-source">>;
+    sourceSnapshot: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        batchId: z.ZodString;
+        sourceWorkspaceId: z.ZodString;
+        sourceDirectoryName: z.ZodString;
+        snapshotId: z.ZodString;
+        commitHash: z.ZodString;
+        checksum: z.ZodString;
+        objectKey: z.ZodString;
+        archiveDigest: z.ZodString;
+        frozenAt: z.ZodString;
+    }, z.core.$strict>>>;
+    variants: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        variantId: z.ZodString;
+        name: z.ZodString;
+        changes: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        preserves: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+    }, z.core.$strict>>>>;
+}, z.core.$strict>>;
+export type BatchVariantManifest = z.infer<typeof batchVariantManifestSchema>;
+/** Uses SHA-256 (Secure Hash Algorithm 256-bit, 256 位安全散列算法) over the normalized manifest. */
+export declare function batchVariantManifestDigest(manifest: BatchVariantManifest): string;
+/**
+ * The baseline is a commit on the batch preparation remix that was saved and pushed. `checksum` is the SHA-256 of the
+ * commit's full tree listing, so equal engineering content always yields the same checksum.
+ */
+export declare const batchBaselineSnapshotSchema: z.ZodReadonly<z.ZodObject<{
+    batchId: z.ZodString;
+    projectId: z.ZodString;
+    snapshotId: z.ZodString;
+    sourceWorkspaceId: z.ZodString;
+    commitHash: z.ZodString;
+    checksum: z.ZodString;
+    sourceVersion: z.ZodString;
+    engine: z.ZodString;
+    skillLockDigest: z.ZodString;
+    frozenAt: z.ZodString;
+}, z.core.$strict>>;
+export type BatchBaselineSnapshot = z.infer<typeof batchBaselineSnapshotSchema>;
+export declare function batchCommitSourceVersion(commitHash: string): string;
+/** The baseline digest binds business ownership, the frozen commit and execution configuration together. */
+export declare function batchBaselineSnapshotDigest(baseline: BatchBaselineSnapshot): string;
+export declare function assertBatchBaselineUnchanged(existing: BatchBaselineSnapshot, candidate: BatchBaselineSnapshot): void;
+/** These facts must come from trusted Runtime receipts; a submitted boolean is not execution evidence. */
+export declare const batchBaselineValidationSchema: z.ZodReadonly<z.ZodObject<{
+    snapshotId: z.ZodString;
+    snapshotChecksum: z.ZodString;
+    buildId: z.ZodString;
+    previewId: z.ZodString;
+    previewUrl: z.ZodString;
+    buildSucceeded: z.ZodLiteral<true>;
+    previewOpened: z.ZodLiteral<true>;
+    writersStopped: z.ZodLiteral<true>;
+    validatedAt: z.ZodString;
+}, z.core.$strict>>;
+export type BatchBaselineValidation = z.infer<typeof batchBaselineValidationSchema>;
+export declare const batchApprovalSchema: z.ZodReadonly<z.ZodObject<{
+    batchId: z.ZodString;
+    projectId: z.ZodString;
+    snapshotId: z.ZodString;
+    snapshotChecksum: z.ZodString;
+    baselineDigest: z.ZodString;
+    manifestVersion: z.ZodNumber;
+    manifestDigest: z.ZodString;
+    approvedBy: z.ZodString;
+    approvedAt: z.ZodString;
+}, z.core.$strict>>;
+export type BatchApproval = z.infer<typeof batchApprovalSchema>;
+type BatchApprovalContext = {
+    baseline: BatchBaselineSnapshot;
+    manifest: BatchVariantManifest;
+    validation: BatchBaselineValidation;
+};
+/** Persist creation authorization or the explicit approval and queue admission in one transaction. */
+export declare function createBatchApproval(input: BatchApprovalContext & {
+    actorId: string;
+    approvedAt: string;
+}): BatchApproval;
+export declare function assertBatchApproval(input: BatchApprovalContext & {
+    approval: BatchApproval;
+}): void;
+export declare const BATCH_ATTEMPT_STATUSES: readonly ["queued", "preparing", "generating", "saving", "building", "publishing", "completed", "failed", "cancelling", "cancelled", "unknown"];
+export declare const batchAttemptStatusSchema: z.ZodEnum<{
+    unknown: "unknown";
+    completed: "completed";
+    failed: "failed";
+    cancelled: "cancelled";
+    queued: "queued";
+    generating: "generating";
+    preparing: "preparing";
+    saving: "saving";
+    building: "building";
+    publishing: "publishing";
+    cancelling: "cancelling";
+}>;
+export type BatchAttemptStatus = z.infer<typeof batchAttemptStatusSchema>;
+export declare const batchResultVersionSchema: z.ZodReadonly<z.ZodObject<{
+    createdAt: z.ZodString;
+    batchId: z.ZodString;
+    variantId: z.ZodString;
+    resultVersionId: z.ZodString;
+    projectId: z.ZodString;
+    remixId: z.ZodString;
+    workspaceId: z.ZodString;
+    snapshotId: z.ZodString;
+    snapshotChecksum: z.ZodString;
+    manifestVersion: z.ZodNumber;
+    manifestDigest: z.ZodString;
+}, z.core.$strict>>;
+export type BatchResultVersion = z.infer<typeof batchResultVersionSchema>;
+export declare const batchAttemptIdentitySchema: z.ZodReadonly<z.ZodObject<{
+    attemptId: z.ZodString;
+    batchId: z.ZodString;
+    variantId: z.ZodString;
+    resultVersionId: z.ZodString;
+    projectId: z.ZodString;
+    remixId: z.ZodString;
+    workspaceId: z.ZodString;
+    snapshotId: z.ZodString;
+    snapshotChecksum: z.ZodString;
+    manifestVersion: z.ZodNumber;
+    manifestDigest: z.ZodString;
+}, z.core.$strict>>;
+export type BatchAttemptIdentity = z.infer<typeof batchAttemptIdentitySchema>;
+/** Submission authorizes this manifest and immutable input, without claiming baseline validation. */
+export declare function assertDirectBatchAttemptAuthorized(input: {
+    manifest: BatchVariantManifest;
+    attempt: BatchAttemptIdentity;
+}): void;
+export declare function assertBatchAttemptApproved(input: BatchApprovalContext & {
+    approval: BatchApproval;
+    attempt: BatchAttemptIdentity;
+}): void;
+export declare const batchStoppedEvidenceSchema: z.ZodObject<{
+    executionStopped: z.ZodBoolean;
+    managedWritesStopped: z.ZodBoolean;
+}, z.core.$strict>;
+export type BatchStoppedEvidence = z.infer<typeof batchStoppedEvidenceSchema>;
+export declare function canReleaseBatchAttempt(status: BatchAttemptStatus, stopped: BatchStoppedEvidence): boolean;
+export declare const batchSavedEvidenceSchema: z.ZodObject<{
+    pushedCommitHash: z.ZodString;
+    attemptId: z.ZodString;
+    resultVersionId: z.ZodString;
+    workspaceId: z.ZodString;
+    sourceDigest: z.ZodString;
+    commitHash: z.ZodString;
+}, z.core.$strict>;
+export type BatchSavedEvidence = z.infer<typeof batchSavedEvidenceSchema>;
+export declare const batchBuildEvidenceSchema: z.ZodObject<{
+    buildId: z.ZodString;
+    succeeded: z.ZodBoolean;
+    attemptId: z.ZodString;
+    resultVersionId: z.ZodString;
+    workspaceId: z.ZodString;
+    sourceDigest: z.ZodString;
+    commitHash: z.ZodString;
+}, z.core.$strict>;
+export type BatchBuildEvidence = z.infer<typeof batchBuildEvidenceSchema>;
+export declare const batchPreviewEvidenceSchema: z.ZodObject<{
+    buildId: z.ZodString;
+    previewId: z.ZodString;
+    previewUrl: z.ZodString;
+    published: z.ZodBoolean;
+    opened: z.ZodBoolean;
+    attemptId: z.ZodString;
+    resultVersionId: z.ZodString;
+    workspaceId: z.ZodString;
+    sourceDigest: z.ZodString;
+    commitHash: z.ZodString;
+}, z.core.$strict>;
+export type BatchPreviewEvidence = z.infer<typeof batchPreviewEvidenceSchema>;
+export declare const batchCompletionEvidenceSchema: z.ZodObject<{
+    attempt: z.ZodReadonly<z.ZodObject<{
+        attemptId: z.ZodString;
+        batchId: z.ZodString;
+        variantId: z.ZodString;
+        resultVersionId: z.ZodString;
+        projectId: z.ZodString;
+        remixId: z.ZodString;
+        workspaceId: z.ZodString;
+        snapshotId: z.ZodString;
+        snapshotChecksum: z.ZodString;
+        manifestVersion: z.ZodNumber;
+        manifestDigest: z.ZodString;
+    }, z.core.$strict>>;
+    saved: z.ZodObject<{
+        pushedCommitHash: z.ZodString;
+        attemptId: z.ZodString;
+        resultVersionId: z.ZodString;
+        workspaceId: z.ZodString;
+        sourceDigest: z.ZodString;
+        commitHash: z.ZodString;
+    }, z.core.$strict>;
+    build: z.ZodObject<{
+        buildId: z.ZodString;
+        succeeded: z.ZodBoolean;
+        attemptId: z.ZodString;
+        resultVersionId: z.ZodString;
+        workspaceId: z.ZodString;
+        sourceDigest: z.ZodString;
+        commitHash: z.ZodString;
+    }, z.core.$strict>;
+    preview: z.ZodObject<{
+        buildId: z.ZodString;
+        previewId: z.ZodString;
+        previewUrl: z.ZodString;
+        published: z.ZodBoolean;
+        opened: z.ZodBoolean;
+        attemptId: z.ZodString;
+        resultVersionId: z.ZodString;
+        workspaceId: z.ZodString;
+        sourceDigest: z.ZodString;
+        commitHash: z.ZodString;
+    }, z.core.$strict>;
+    stopped: z.ZodObject<{
+        executionStopped: z.ZodBoolean;
+        managedWritesStopped: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type BatchCompletionEvidence = z.infer<typeof batchCompletionEvidenceSchema>;
+export type BatchCompletionDecision = {
+    complete: true;
+} | {
+    complete: false;
+    reason: 'invalid_evidence' | 'attempt_mismatch' | 'save_unpushed' | 'build_mismatch' | 'build_failed' | 'preview_mismatch' | 'preview_unavailable' | 'execution_not_stopped';
+};
+/** Only evidence from the current attempt and exact saved version can complete a result. */
+export declare function evaluateBatchCompletion(input: BatchCompletionEvidence): BatchCompletionDecision;
+export {};
+//# sourceMappingURL=batch-generation.d.ts.map

package/dist/cloud-workspace/runtime/batch-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-generation.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/batch-generation.ts"],"names":[],"mappings":"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"}