@playcraft/common 0.1.36-beta1 → 0.1.38-beta

package/dist/cloud-workspace/runtime/remix-references.d.ts

@@ -0,0 +1,197 @@
+import { z } from 'zod';
+export declare const WORKSPACE_REMIX_REFERENCE_MAX_BYTES: number;
+export declare const WORKSPACE_REMIX_REFERENCE_MAX_FILES = 5000;
+export declare const WORKSPACE_REMIX_REFERENCE_MAX_COUNT = 5;
+/** Includes base64 expansion, file metadata, and the operation envelope. */
+export declare const WORKSPACE_REMIX_REFERENCE_BODY_MAX_BYTES: number;
+export declare const WORKSPACE_REMIX_REFERENCES_DIRECTORY = "references/remixes";
+export declare const WORKSPACE_REMIX_REFERENCES_MANIFEST = ".playcraft/remix-references.json";
+export declare const workspaceRemixReferenceCategorySchema: z.ZodEnum<{
+    recommended: "recommended";
+    community: "community";
+}>;
+export declare const workspaceRemixReferencePathSchema: z.ZodString;
+export declare const workspaceRemixReferenceCandidateSchema: z.ZodObject<{
+    projectUuid: z.ZodString;
+    branchName: z.ZodString;
+    name: z.ZodString;
+    source: z.ZodEnum<{
+        recommended: "recommended";
+        community: "community";
+    }>;
+    projectType: z.ZodEnum<{
+        external: "external";
+        playcanvas: "playcanvas";
+    }>;
+    engine: z.ZodOptional<z.ZodString>;
+    thumbnailUrl: z.ZodOptional<z.ZodString>;
+    previewUrl: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    importable: z.ZodBoolean;
+    unavailableReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type WorkspaceRemixReferenceCandidate = z.infer<typeof workspaceRemixReferenceCandidateSchema>;
+export declare const workspaceRemixReferenceSourceSchema: z.ZodObject<{
+    environment: z.ZodString;
+    projectUuid: z.ZodString;
+    branchName: z.ZodString;
+    commit: z.ZodString;
+    name: z.ZodString;
+    category: z.ZodEnum<{
+        recommended: "recommended";
+        community: "community";
+    }>;
+    projectType: z.ZodEnum<{
+        external: "external";
+        playcanvas: "playcanvas";
+    }>;
+    engine: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type WorkspaceRemixReferenceSource = z.infer<typeof workspaceRemixReferenceSourceSchema>;
+/** Hash input shared by the exporter and importer; file order never changes a snapshot identity. */
+export declare function remixReferenceContentHashInput(files: ReadonlyArray<{
+    path: string;
+    sha256: string;
+    size: number;
+}>): string;
+export declare const workspaceRemixReferenceExportSchema: z.ZodObject<{
+    source: z.ZodObject<{
+        environment: z.ZodString;
+        projectUuid: z.ZodString;
+        branchName: z.ZodString;
+        commit: z.ZodString;
+        name: z.ZodString;
+        category: z.ZodEnum<{
+            recommended: "recommended";
+            community: "community";
+        }>;
+        projectType: z.ZodEnum<{
+            external: "external";
+            playcanvas: "playcanvas";
+        }>;
+        engine: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+        sha256: z.ZodString;
+        size: z.ZodNumber;
+    }, z.core.$strict>>;
+    contentHash: z.ZodString;
+}, z.core.$strict>;
+export type WorkspaceRemixReferenceExport = z.infer<typeof workspaceRemixReferenceExportSchema>;
+export declare const workspaceRemixReferenceImportRequestSchema: z.ZodObject<{
+    source: z.ZodObject<{
+        branchName: z.ZodString;
+        projectUuid: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const workspaceRemixReferenceImportPayloadSchema: z.ZodObject<{
+    snapshot: z.ZodObject<{
+        source: z.ZodObject<{
+            environment: z.ZodString;
+            projectUuid: z.ZodString;
+            branchName: z.ZodString;
+            commit: z.ZodString;
+            name: z.ZodString;
+            category: z.ZodEnum<{
+                recommended: "recommended";
+                community: "community";
+            }>;
+            projectType: z.ZodEnum<{
+                external: "external";
+                playcanvas: "playcanvas";
+            }>;
+            engine: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+            sha256: z.ZodString;
+            size: z.ZodNumber;
+        }, z.core.$strict>>;
+        contentHash: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type WorkspaceRemixReferenceImportPayload = z.infer<typeof workspaceRemixReferenceImportPayloadSchema>;
+export declare const workspaceRemixReferenceSchema: z.ZodObject<{
+    referenceId: z.ZodString;
+    directoryName: z.ZodString;
+    path: z.ZodString;
+    name: z.ZodString;
+    source: z.ZodObject<{
+        environment: z.ZodString;
+        projectUuid: z.ZodString;
+        branchName: z.ZodString;
+        commit: z.ZodString;
+        name: z.ZodString;
+        category: z.ZodEnum<{
+            recommended: "recommended";
+            community: "community";
+        }>;
+        projectType: z.ZodEnum<{
+            external: "external";
+            playcanvas: "playcanvas";
+        }>;
+        engine: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    contentHash: z.ZodString;
+    importedAt: z.ZodString;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        sourcePath: z.ZodString;
+        sha256: z.ZodString;
+        size: z.ZodNumber;
+    }, z.core.$strict>>;
+    omittedFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+        size: z.ZodNumber;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type WorkspaceRemixReference = z.infer<typeof workspaceRemixReferenceSchema>;
+export declare const workspaceRemixReferencesSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        referenceId: z.ZodString;
+        directoryName: z.ZodString;
+        path: z.ZodString;
+        name: z.ZodString;
+        source: z.ZodObject<{
+            environment: z.ZodString;
+            projectUuid: z.ZodString;
+            branchName: z.ZodString;
+            commit: z.ZodString;
+            name: z.ZodString;
+            category: z.ZodEnum<{
+                recommended: "recommended";
+                community: "community";
+            }>;
+            projectType: z.ZodEnum<{
+                external: "external";
+                playcanvas: "playcanvas";
+            }>;
+            engine: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        contentHash: z.ZodString;
+        importedAt: z.ZodString;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            sourcePath: z.ZodString;
+            sha256: z.ZodString;
+            size: z.ZodNumber;
+        }, z.core.$strict>>;
+        omittedFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            sha256: z.ZodString;
+            size: z.ZodNumber;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const workspaceContextRemixReferenceSchema: z.ZodObject<{
+    referenceId: z.ZodString;
+    directoryName: z.ZodString;
+    snapshotHash: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type WorkspaceContextRemixReference = z.infer<typeof workspaceContextRemixReferenceSchema>;
+//# sourceMappingURL=remix-references.d.ts.map

package/dist/cloud-workspace/runtime/remix-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remix-references.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/remix-references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,mCAAmC,QAAmB,CAAC;AACpE,eAAO,MAAM,mCAAmC,OAAO,CAAC;AACxD,eAAO,MAAM,mCAAmC,IAAI,CAAC;AACrD,4EAA4E;AAC5E,eAAO,MAAM,wCAAwC,QAAmB,CAAC;AACzE,eAAO,MAAM,oCAAoC,uBAAuB,CAAC;AACzE,eAAO,MAAM,mCAAmC,qCAAqC,CAAC;AAItF,eAAO,MAAM,qCAAqC;;;EAAuC,CAAC;AAC1F,eAAO,MAAM,iCAAiC,aAEgE,CAAC;AAE/G,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;kBAMxC,CAAC;AACZ,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAEtG,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;kBAKrC,CAAC;AACZ,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAQhG,oGAAoG;AACpG,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAG3H;AAED,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;kBAa9C,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAChG,eAAO,MAAM,0CAA0C;;;;;kBAE5C,CAAC;AACZ,eAAO,MAAM,0CAA0C;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAuE,CAAC;AAC/H,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0CAA0C,CAAC,CAAC;AAE9G,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAW/B,CAAC;AACZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAuE,CAAC;AACnH,eAAO,MAAM,oCAAoC;;;;;kBAEtC,CAAC;AACZ,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC"}

package/dist/cloud-workspace/runtime/remix-references.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { workspaceDirectoryNameSchema } from './workspace-directories.js';
+import { isAttachmentBase64 } from './attachment-base64.js';
+export const WORKSPACE_REMIX_REFERENCE_MAX_BYTES = 32 * 1024 * 1024;
+export const WORKSPACE_REMIX_REFERENCE_MAX_FILES = 5000;
+export const WORKSPACE_REMIX_REFERENCE_MAX_COUNT = 5;
+/** Includes base64 expansion, file metadata, and the operation envelope. */
+export const WORKSPACE_REMIX_REFERENCE_BODY_MAX_BYTES = 52 * 1024 * 1024;
+export const WORKSPACE_REMIX_REFERENCES_DIRECTORY = 'references/remixes';
+export const WORKSPACE_REMIX_REFERENCES_MANIFEST = '.playcraft/remix-references.json';
+const digest = z.string().regex(/^[a-f0-9]{64}$/);
+const name = z.string().min(1).max(255);
+export const workspaceRemixReferenceCategorySchema = z.enum(['recommended', 'community']);
+export const workspaceRemixReferencePathSchema = z.string().min(1).max(1024).refine(path => new TextEncoder().encode(path).length <= 1024 && !/[\\:\x00-\x1f\x7f]/.test(path) && !path.startsWith('/') &&
+    path.split('/').every(part => part !== '' && part !== '.' && part !== '..'), 'invalid_remix_reference_path');
+export const workspaceRemixReferenceCandidateSchema = z.object({
+    projectUuid: z.string().uuid(), branchName: z.string().min(1).max(255), name,
+    source: workspaceRemixReferenceCategorySchema, projectType: z.enum(['external', 'playcanvas']),
+    engine: z.string().max(128).optional(), thumbnailUrl: z.string().max(4096).optional(),
+    previewUrl: z.string().max(4096).optional(), author: z.string().max(255).optional(),
+    importable: z.boolean(), unavailableReason: z.string().max(128).optional(),
+}).strict();
+export const workspaceRemixReferenceSourceSchema = z.object({
+    environment: z.string().min(1).max(64), projectUuid: z.string().uuid(),
+    branchName: z.string().min(1).max(255), commit: z.string().regex(/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/),
+    name, category: workspaceRemixReferenceCategorySchema, projectType: z.enum(['external', 'playcanvas']),
+    engine: z.string().max(128).optional(),
+}).strict();
+const sourceFileSchema = z.object({
+    path: workspaceRemixReferencePathSchema,
+    content: z.string().max(4 * Math.ceil(WORKSPACE_REMIX_REFERENCE_MAX_BYTES / 3)).refine(isAttachmentBase64, 'invalid_remix_reference_content'),
+    sha256: digest, size: z.number().int().nonnegative().max(WORKSPACE_REMIX_REFERENCE_MAX_BYTES),
+}).strict();
+/** Hash input shared by the exporter and importer; file order never changes a snapshot identity. */
+export function remixReferenceContentHashInput(files) {
+    return JSON.stringify([...files].sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0)
+        .map(file => [file.path, file.sha256, file.size]));
+}
+export const workspaceRemixReferenceExportSchema = z.object({
+    source: workspaceRemixReferenceSourceSchema,
+    files: z.array(sourceFileSchema).min(1).max(WORKSPACE_REMIX_REFERENCE_MAX_FILES),
+    contentHash: digest,
+}).strict().superRefine((value, ctx) => {
+    const paths = value.files.map(file => file.path.toLowerCase());
+    const unique = new Set(paths);
+    if (unique.size !== paths.length || paths.some(path => path.split('/').slice(0, -1)
+        .some((_, index, parts) => unique.has(parts.slice(0, index + 1).join('/')))))
+        ctx.addIssue({ code: 'custom', message: 'duplicate_remix_reference_path', path: ['files'] });
+    if (value.files.reduce((sum, file) => sum + file.size, 0) > WORKSPACE_REMIX_REFERENCE_MAX_BYTES ||
+        value.files.reduce((sum, file) => sum + file.content.length, 0) > 4 * Math.ceil(WORKSPACE_REMIX_REFERENCE_MAX_BYTES / 3) + 4 * value.files.length)
+        ctx.addIssue({ code: 'custom', message: 'remix_reference_too_large', path: ['files'] });
+});
+export const workspaceRemixReferenceImportRequestSchema = z.object({
+    source: workspaceRemixReferenceSourceSchema.pick({ projectUuid: true, branchName: true }),
+}).strict();
+export const workspaceRemixReferenceImportPayloadSchema = z.object({ snapshot: workspaceRemixReferenceExportSchema }).strict();
+export const workspaceRemixReferenceSchema = z.object({
+    referenceId: digest, directoryName: workspaceDirectoryNameSchema,
+    path: workspaceRemixReferencePathSchema, name, source: workspaceRemixReferenceSourceSchema,
+    contentHash: digest, importedAt: z.string().datetime(),
+    files: z.array(z.object({
+        path: workspaceRemixReferencePathSchema, sourcePath: workspaceRemixReferencePathSchema,
+        sha256: digest, size: z.number().int().nonnegative().max(WORKSPACE_REMIX_REFERENCE_MAX_BYTES),
+    }).strict()).min(1).max(WORKSPACE_REMIX_REFERENCE_MAX_FILES),
+    omittedFiles: z.array(z.object({ path: workspaceRemixReferencePathSchema, sha256: digest,
+        size: z.number().int().nonnegative().max(WORKSPACE_REMIX_REFERENCE_MAX_BYTES) }).strict())
+        .max(WORKSPACE_REMIX_REFERENCE_MAX_FILES).optional(),
+}).strict();
+export const workspaceRemixReferencesSchema = z.object({ items: z.array(workspaceRemixReferenceSchema) }).strict();
+export const workspaceContextRemixReferenceSchema = z.object({
+    referenceId: digest, directoryName: workspaceDirectoryNameSchema, snapshotHash: digest, name: name.optional(),
+}).strict();
+//# sourceMappingURL=remix-references.js.map

package/dist/cloud-workspace/runtime/remix-references.js.map

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

package/dist/cloud-workspace/runtime/resource-grant.d.ts

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+/**
+ * Resource actions. Excludes instance destruction, checkpoint restore, and wildcards.
+ * `workspace.save` commits the workspace to Git and, where the branch may be written, pushes it.
+ */
+export declare const RESOURCE_GRANT_ACTIONS: readonly ["runtime.ensure", "session.create", "session.turn", "session.interrupt", "session.approval.respond", "file.write", "git.commit", "git.push", "git.stage", "git.unstage", "git.discard", "terminal.create", "parameter.patch", "preview.publish", "workspace.save"];
+export declare const RESOURCE_GRANT_KIND: "workspace-resource";
+export declare const resourceGrantCommandSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    commandId: z.ZodString;
+    kind: z.ZodEnum<{
+        grant: "grant";
+        revoke: "revoke";
+        extend: "extend";
+    }>;
+    grantRequestId: z.ZodString;
+    grantId: z.ZodString;
+    environment: z.ZodString;
+    userId: z.ZodString;
+    workspaceId: z.ZodString;
+    authzRevision: z.ZodNumber;
+    requestPayloadHash: z.ZodString;
+    scope: z.ZodObject<{
+        workspaceId: z.ZodString;
+        actions: z.ZodArray<z.ZodEnum<{
+            "runtime.ensure": "runtime.ensure";
+            "session.create": "session.create";
+            "session.turn": "session.turn";
+            "session.interrupt": "session.interrupt";
+            "session.approval.respond": "session.approval.respond";
+            "file.write": "file.write";
+            "git.commit": "git.commit";
+            "git.push": "git.push";
+            "git.stage": "git.stage";
+            "git.unstage": "git.unstage";
+            "git.discard": "git.discard";
+            "workspace.save": "workspace.save";
+            "terminal.create": "terminal.create";
+            "parameter.patch": "parameter.patch";
+            "preview.publish": "preview.publish";
+        }>>;
+    }, z.core.$strict>;
+    hardExpiresAt: z.ZodString;
+    revokedAt: z.ZodOptional<z.ZodString>;
+    commandDigest: z.ZodString;
+}, z.core.$strict>;
+export type ResourceGrantCommand = z.infer<typeof resourceGrantCommandSchema>;
+export declare const resourceGrantReceiptSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    commandId: z.ZodString;
+    grantRequestId: z.ZodString;
+    grantId: z.ZodString;
+    environment: z.ZodString;
+    workspaceId: z.ZodString;
+    commandDigest: z.ZodString;
+    status: z.ZodLiteral<"persisted">;
+}, z.core.$strict>;
+export type ResourceGrantReceipt = z.infer<typeof resourceGrantReceiptSchema>;
+/** Stable across object key order. Array order stays significant. Matches Business command hashing. */
+export declare function resourceGrantDigest(value: unknown): string;
+export declare function resourceGrantBody(command: ResourceGrantCommand): Omit<ResourceGrantCommand, 'commandDigest'>;
+//# sourceMappingURL=resource-grant.d.ts.map

package/dist/cloud-workspace/runtime/resource-grant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-grant.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/resource-grant.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,sBAAsB,8QAgBzB,CAAC;AAEX,eAAO,MAAM,mBAAmB,EAAG,oBAA6B,CAAC;AASjE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAyBnC,CAAC;AAEL,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,0BAA0B;;;;;;;;;kBAW5B,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAa1D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,EAAE,eAAe,CAAC,CAG5G"}

package/dist/cloud-workspace/runtime/resource-grant.js

@@ -0,0 +1,87 @@
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+/**
+ * Resource actions. Excludes instance destruction, checkpoint restore, and wildcards.
+ * `workspace.save` commits the workspace to Git and, where the branch may be written, pushes it.
+ */
+export const RESOURCE_GRANT_ACTIONS = [
+    'runtime.ensure',
+    'session.create',
+    'session.turn',
+    'session.interrupt',
+    'session.approval.respond',
+    'file.write',
+    'git.commit',
+    'git.push',
+    'git.stage',
+    'git.unstage',
+    'git.discard',
+    'terminal.create',
+    'parameter.patch',
+    'preview.publish',
+    'workspace.save',
+];
+export const RESOURCE_GRANT_KIND = 'workspace-resource';
+const scopeSchema = z
+    .object({
+    workspaceId: z.string().min(1).max(128),
+    actions: z.array(z.enum(RESOURCE_GRANT_ACTIONS)).min(1).max(RESOURCE_GRANT_ACTIONS.length),
+})
+    .strict();
+export const resourceGrantCommandSchema = z
+    .object({
+    version: z.literal(1),
+    commandId: z.string().min(1).max(128),
+    kind: z.enum(['grant', 'revoke', 'extend']),
+    grantRequestId: z.string().min(1).max(128),
+    grantId: z.string().min(1).max(128),
+    environment: z.string().min(1).max(64),
+    userId: z.string().min(1).max(256),
+    workspaceId: z.string().min(1).max(128),
+    authzRevision: z.number().int().nonnegative(),
+    requestPayloadHash: z.string().regex(/^[a-f0-9]{64}$/),
+    scope: scopeSchema,
+    hardExpiresAt: z.string().min(1).max(64),
+    revokedAt: z.string().min(1).max(64).optional(),
+    commandDigest: z.string().regex(/^[a-f0-9]{64}$/),
+})
+    .strict()
+    .superRefine((command, context) => {
+    if (command.kind === 'revoke' && !command.revokedAt) {
+        context.addIssue({ code: 'custom', path: ['revokedAt'], message: 'revoke_time_required' });
+    }
+    if (command.kind !== 'revoke' && command.revokedAt) {
+        context.addIssue({ code: 'custom', path: ['revokedAt'], message: 'grant_has_revoke_time' });
+    }
+});
+export const resourceGrantReceiptSchema = z
+    .object({
+    version: z.literal(1),
+    commandId: z.string(),
+    grantRequestId: z.string(),
+    grantId: z.string(),
+    environment: z.string(),
+    workspaceId: z.string(),
+    commandDigest: z.string().regex(/^[a-f0-9]{64}$/),
+    status: z.literal('persisted'),
+})
+    .strict();
+/** Stable across object key order. Array order stays significant. Matches Business command hashing. */
+export function resourceGrantDigest(value) {
+    const canonical = (item) => {
+        if (Array.isArray(item))
+            return item.map(canonical);
+        if (item !== null && typeof item === 'object') {
+            return Object.fromEntries(Object.entries(item)
+                .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+                .map(([key, entry]) => [key, canonical(entry)]));
+        }
+        return item;
+    };
+    return createHash('sha256').update(JSON.stringify(canonical(value))).digest('hex');
+}
+export function resourceGrantBody(command) {
+    const { commandDigest: _digest, ...body } = command;
+    return body;
+}
+//# sourceMappingURL=resource-grant.js.map

package/dist/cloud-workspace/runtime/resource-grant.js.map

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

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

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import type { ProjectSkillDeclaration, ProjectSkillsLockV3 } from '../../project-skills/types.js';
+/** Original distributed bytes eligible for an explicit, reviewable platform-release migration. */
+export declare const LEGACY_VIDEO_SOURCE_HASHES: Readonly<Record<string, string>>;
+export type WorkspaceSkillsView = {
+    declaration: ProjectSkillDeclaration;
+    lock: ProjectSkillsLockV3;
+    lockHash: string;
+    skills: Array<{
+        entryKey: string;
+        name: string;
+        description: string;
+        content: string;
+    }>;
+};
+export declare const workspaceSkillsUpdatePayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"import-builtins">;
+    names: z.ZodArray<z.ZodEnum<{
+        "playcraft-video-understanding": "playcraft-video-understanding";
+        "playcraft-replica-validation": "playcraft-replica-validation";
+    }>>;
+    expectedDeclarationHash: z.ZodString;
+    expectedLockHash: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"migrate-platform">;
+    entryKeys: z.ZodArray<z.ZodString>;
+    expectedDeclarationHash: z.ZodString;
+    expectedLockHash: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"sync">;
+    expectedDeclarationHash: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"set-enabled">;
+    entryKey: z.ZodString;
+    enabled: z.ZodBoolean;
+    expectedDeclarationHash: z.ZodString;
+}, z.core.$strict>], "action">;
+export type WorkspaceSkillsUpdatePayload = z.infer<typeof workspaceSkillsUpdatePayloadSchema>;
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAElG,kGAAkG;AAClG,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGvE,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,uBAAuB,CAAC;IACrC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzF,CAAC;AAGF,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;8BAwB7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC"}

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

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+/** Original distributed bytes eligible for an explicit, reviewable platform-release migration. */
+export const LEGACY_VIDEO_SOURCE_HASHES = {
+    'playcraft-video-understanding': 'a46732c75bc5855f38679b5c0c93dc7aeb771f82499b11d3c907ad8a4eeb49a3',
+    'playcraft-replica-validation': '55be6b82989050eb0fda68c8aea0522b99a7cb85ffe2b6cb7c9f7035aba4c65e',
+};
+const declarationHash = z.string().regex(/^[a-f0-9]{64}$/);
+export const workspaceSkillsUpdatePayloadSchema = z.discriminatedUnion('action', [
+    z.object({
+        action: z.literal('import-builtins'),
+        names: z.array(z.enum(['playcraft-video-understanding', 'playcraft-replica-validation'])).min(1).max(2),
+        expectedDeclarationHash: declarationHash,
+        expectedLockHash: declarationHash,
+    }).strict(),
+    z.object({
+        action: z.literal('migrate-platform'),
+        entryKeys: z.array(z.string().min(1).max(128)).min(1).max(2)
+            .refine(keys => new Set(keys).size === keys.length),
+        expectedDeclarationHash: declarationHash,
+        expectedLockHash: declarationHash,
+    }).strict(),
+    z.object({
+        action: z.literal('sync'),
+        expectedDeclarationHash: declarationHash.optional(),
+    }).strict(),
+    z.object({
+        action: z.literal('set-enabled'),
+        entryKey: z.string().min(1).max(128),
+        enabled: z.boolean(),
+        expectedDeclarationHash: declarationHash,
+    }).strict(),
+]);
+//# sourceMappingURL=skills.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,kGAAkG;AAClG,MAAM,CAAC,MAAM,0BAA0B,GAAqC;IAC1E,+BAA+B,EAAE,kEAAkE;IACnG,8BAA8B,EAAE,kEAAkE;CACnG,CAAC;AASF,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;IAC/E,CAAC,CAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;QACpC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,+BAA+B,EAAE,8BAA8B,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACvG,uBAAuB,EAAE,eAAe;QACxC,gBAAgB,EAAE,eAAe;KAClC,CAAC,CAAC,MAAM,EAAE;IACX,CAAC,CAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;QACrC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;aACzD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC;QACrD,uBAAuB,EAAE,eAAe;QACxC,gBAAgB,EAAE,eAAe;KAClC,CAAC,CAAC,MAAM,EAAE;IACX,CAAC,CAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACzB,uBAAuB,EAAE,eAAe,CAAC,QAAQ,EAAE;KACpD,CAAC,CAAC,MAAM,EAAE;IACX,CAAC,CAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;QAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QACpC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,uBAAuB,EAAE,eAAe;KACzC,CAAC,CAAC,MAAM,EAAE;CACZ,CAAC,CAAC"}

package/dist/cloud-workspace/runtime/terminal-session.d.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+/** Retained PTY bytes. Older bytes are dropped; a reconnect must not invent them as new output. */
+export declare const TERMINAL_OUTPUT_RETAINED_BYTES: number;
+export declare function encodeTerminalBytes(bytes: Uint8Array): string;
+export declare function decodeTerminalBytes(value: string): Uint8Array;
+export declare const terminalClientFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"resume">;
+    streamId: z.ZodOptional<z.ZodString>;
+    offset: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"input">;
+    data: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"resize">;
+    cols: z.ZodNumber;
+    rows: z.ZodNumber;
+}, z.core.$strict>], "type">;
+export type TerminalClientFrame = z.infer<typeof terminalClientFrameSchema>;
+export declare const TERMINAL_REVOKE_REASONS: readonly ["terminal_destroyed", "runtime_destroyed", "grant_revoked", "pty_unavailable"];
+export declare const terminalServerFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"output">;
+    streamId: z.ZodString;
+    offset: z.ZodNumber;
+    data: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"gap">;
+    streamId: z.ZodString;
+    offset: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"reset">;
+    streamId: z.ZodString;
+    offset: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"exit">;
+    streamId: z.ZodString;
+    code: z.ZodNullable<z.ZodNumber>;
+    signal: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"revoked">;
+    reason: z.ZodEnum<{
+        runtime_destroyed: "runtime_destroyed";
+        terminal_destroyed: "terminal_destroyed";
+        grant_revoked: "grant_revoked";
+        pty_unavailable: "pty_unavailable";
+    }>;
+}, z.core.$strict>], "type">;
+export type TerminalServerFrame = z.infer<typeof terminalServerFrameSchema>;
+export type TerminalOutputLog = {
+    start: number;
+    end: number;
+    chunks: Array<{
+        offset: number;
+        data: string;
+    }>;
+};
+export declare function createTerminalOutputLog(): TerminalOutputLog;
+export declare function appendTerminalOutput(log: TerminalOutputLog, text: string, retain?: number): TerminalOutputLog;
+export declare function terminalOutputSince(log: TerminalOutputLog, offset: number): {
+    gap: boolean;
+    offset: number;
+    frames: Array<{
+        offset: number;
+        data: string;
+    }>;
+};
+export type TerminalView = {
+    streamId?: string;
+    text: string;
+    offset: number;
+    gap: boolean;
+    exitCode?: number | null;
+    exitSignal?: string;
+    revoked?: string;
+};
+export declare function createTerminalView(): TerminalView;
+/** Apply one server frame. Bytes at an offset already applied are ignored, not appended again. */
+export declare function reduceTerminalFrame(view: TerminalView, frame: TerminalServerFrame): TerminalView;
+//# sourceMappingURL=terminal-session.d.ts.map

package/dist/cloud-workspace/runtime/terminal-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-session.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/terminal-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mGAAmG;AACnG,eAAO,MAAM,8BAA8B,QAAa,CAAC;AAKzD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAI7D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAK7D;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;4BAqBpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,uBAAuB,0FAK1B,CAAC;AAEX,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;4BAqCpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD,CAAC;AAEF,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,SAAiC,GACtC,iBAAiB,CAWnB;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,GACb;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAmBnF;AAoBD,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAED,kGAAkG;AAClG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,mBAAmB,GAAG,YAAY,CA+BhG"}