@playdrop/playdrop-cli 0.15.9 → 0.15.14

package/config/client-meta.json

@@ -1,7 +1,7 @@
 {
-  "version": "0.15.9",
+  "version": "0.15.14",
   "build": 1,
-  "runtimeSdkVersion": "0.15.9",
+  "runtimeSdkVersion": "0.15.14",
   "runtimeSdkBuild": 1,
   "clients": {
     "all": {

package/dist/apps/index.d.ts

@@ -4,7 +4,7 @@ import type { AppTask } from '../catalogue';
 import type { TaskCaptureSession } from '../appUrls';
 import { collectAppValidationWarnings, validateAppTask, runFormatScript } from './validate';
 import { buildApp, type AppBuildArtifacts } from './build';
-import { uploadApp, type AppUploadResult } from './upload';
+import { prepareAppUploadFiles, uploadApp, type AppUploadResult } from './upload';
 export type AppPipelineResult = {
     artifacts: AppBuildArtifacts | null;
     upload: AppUploadResult;
@@ -30,4 +30,4 @@ export type AppPipelineOptions = {
     artifacts?: AppBuildArtifacts;
 };
 export declare function runAppPipeline(client: ApiClient, task: AppTask, options?: AppPipelineOptions): Promise<AppPipelineResult>;
-export { collectAppValidationWarnings, validateAppTask, buildApp, uploadApp, runFormatScript };
+export { collectAppValidationWarnings, validateAppTask, buildApp, prepareAppUploadFiles, uploadApp, runFormatScript };

package/dist/apps/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runFormatScript = exports.uploadApp = exports.buildApp = exports.validateAppTask = exports.collectAppValidationWarnings = void 0;
+exports.runFormatScript = exports.uploadApp = exports.prepareAppUploadFiles = exports.buildApp = exports.validateAppTask = exports.collectAppValidationWarnings = void 0;
 exports.runAppPipeline = runAppPipeline;
 const validate_1 = require("./validate");
 Object.defineProperty(exports, "collectAppValidationWarnings", { enumerable: true, get: function () { return validate_1.collectAppValidationWarnings; } });
@@ -9,6 +9,7 @@ Object.defineProperty(exports, "runFormatScript", { enumerable: true, get: funct
 const build_1 = require("./build");
 Object.defineProperty(exports, "buildApp", { enumerable: true, get: function () { return build_1.buildApp; } });
 const upload_1 = require("./upload");
+Object.defineProperty(exports, "prepareAppUploadFiles", { enumerable: true, get: function () { return upload_1.prepareAppUploadFiles; } });
 Object.defineProperty(exports, "uploadApp", { enumerable: true, get: function () { return upload_1.uploadApp; } });
 const registration_1 = require("./registration");
 const loadCheck_1 = require("./loadCheck");

package/dist/apps/loadCheck.d.ts

@@ -38,6 +38,7 @@ export declare function isSoftwareWebGlRenderer(renderer: string | null | undefi
 export declare function dispatchPlaytestTapeToFrame(page: Page, frame: Frame, surface: AppSurface, tape: AppPlaytestTape, hooks?: {
     onBeforeEvent?: (eventIndex: number, event: AppPlaytestTapeEvent) => void;
 }): Promise<void>;
+export declare function verifyHostedEditorPhaseRoundTrip(page: Pick<Page, 'evaluate'>, frame: Pick<Frame, 'evaluate' | 'waitForFunction'>, timeoutMs: number): Promise<void>;
 export declare function formatHostedLoadCheckFailure(taskName: string, result: HostedLoadCheckResult, scope?: 'local' | 'staged' | 'editor' | 'final'): string;
 export declare function redactHostedLoadCheckSecrets(text: string, sourceUrl: string): string;
 export declare function runLocalHostedLoadCheck(input: {
@@ -72,6 +73,7 @@ export declare function runUploadedHostedLoadCheck(input: {
     playtestTape?: AppPlaytestTape;
     postReadyWaitMs?: number;
     phase?: 'play' | 'editor';
+    verifyEditorPhaseRoundTrip?: boolean;
 }): Promise<HostedLoadCheckResult>;
 export declare function comparePlaytestFrames(firstPath: string, secondPath: string, thresholds?: {
     meanDeltaMin: number;

package/dist/apps/loadCheck.js

@@ -10,6 +10,7 @@ exports.resolveLoadCheckSurface = resolveLoadCheckSurface;
 exports.cloneLoadCheckContextOptions = cloneLoadCheckContextOptions;
 exports.isSoftwareWebGlRenderer = isSoftwareWebGlRenderer;
 exports.dispatchPlaytestTapeToFrame = dispatchPlaytestTapeToFrame;
+exports.verifyHostedEditorPhaseRoundTrip = verifyHostedEditorPhaseRoundTrip;
 exports.formatHostedLoadCheckFailure = formatHostedLoadCheckFailure;
 exports.redactHostedLoadCheckSecrets = redactHostedLoadCheckSecrets;
 exports.runLocalHostedLoadCheck = runLocalHostedLoadCheck;
@@ -417,6 +418,48 @@ async function findGameFrame(page, timeoutMs) {
     }
     return frame;
 }
+async function verifyHostedEditorPhaseRoundTrip(page, frame, timeoutMs) {
+    const armReadySignal = async () => {
+        await frame.evaluate(() => {
+            const runtimeWindow = window;
+            const state = runtimeWindow.__playdropEditorPhaseCheck ?? {
+                installed: false,
+                signals: [],
+            };
+            state.signals = [];
+            runtimeWindow.__playdropEditorPhaseCheck = state;
+            if (state.installed) {
+                return;
+            }
+            state.installed = true;
+            window.addEventListener('playdrop:loading-state', (event) => {
+                const detail = event.detail;
+                if (detail?.status === 'ready') {
+                    state.signals.push({ editor: detail.editor === true });
+                }
+            });
+        });
+    };
+    const changePhaseAndWait = async (phase, editor) => {
+        await armReadySignal();
+        await page.evaluate((nextPhase) => {
+            window.postMessage({ type: 'playdrop-studio-runtime-state', active: true, phase: nextPhase }, window.location.origin);
+        }, phase);
+        await frame.waitForFunction((expectedEditor) => {
+            const runtimeWindow = window;
+            return runtimeWindow.__playdropEditorPhaseCheck?.signals?.some((signal) => signal.editor === expectedEditor) === true;
+        }, editor, { timeout: timeoutMs });
+    };
+    try {
+        await changePhaseAndWait('play', false);
+        await changePhaseAndWait('editor', true);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error('project_check_editor_phase_switch_failed: The hosted bundle must switch Editor to Playtest and back '
+            + `inside the existing runtime frame. ${detail}`);
+    }
+}
 async function readWebGlRenderer(frame) {
     const renderer = await frame.evaluate(() => {
         const canvas = document.createElement('canvas');
@@ -696,6 +739,9 @@ async function runHostedLoadCheck(options) {
             if (isSoftwareWebGlRenderer(webglRenderer)) {
                 throw new Error(`project_check_webgl_renderer_software: WebGL renderer is "${webglRenderer}". Real hardware acceleration is required.`);
             }
+            if (options.verifyEditorPhaseRoundTrip) {
+                await verifyHostedEditorPhaseRoundTrip(page, frame, readinessTimeoutMs);
+            }
             await saveGameFrameScreenshot(page, options.readyGameFrameScreenshotPath);
             if (options.playtestTape) {
                 if (!options.playtestSurface) {
@@ -947,6 +993,7 @@ async function runUploadedHostedLoadCheck(input) {
             playtestTape: input.playtestTape,
             playtestSurface: captureSurface,
             postReadyWaitMs: input.postReadyWaitMs,
+            verifyEditorPhaseRoundTrip: input.verifyEditorPhaseRoundTrip,
         });
     }
     else if (anonymousExpectedState === 'login_required') {
@@ -980,6 +1027,7 @@ async function runUploadedHostedLoadCheck(input) {
                     playtestTape: input.playtestTape,
                     playtestSurface: captureSurface,
                     postReadyWaitMs: input.postReadyWaitMs,
+                    verifyEditorPhaseRoundTrip: input.verifyEditorPhaseRoundTrip,
                 });
             }
         }
@@ -997,6 +1045,7 @@ async function runUploadedHostedLoadCheck(input) {
             playtestTape: input.playtestTape,
             playtestSurface: captureSurface,
             postReadyWaitMs: input.postReadyWaitMs,
+            verifyEditorPhaseRoundTrip: input.verifyEditorPhaseRoundTrip,
         });
     }
     const recorded = await input.client.recordAppUploadLaunchCheck(input.creatorUsername, input.task.name, input.sessionId, {

package/dist/apps/upload.d.ts

@@ -25,4 +25,42 @@ export type AppUploadOptions = {
     playtestSmokeCheckRequired?: boolean;
     captureSession?: TaskCaptureSession | null;
 };
+type PreparedSessionFile = {
+    fileKey: string;
+    file: File;
+    filename: string;
+    contentType: string;
+    sizeBytes: number;
+    sha256: string;
+};
+type PreparedOwnedAssetUpload = {
+    uploadKey: string;
+    runtimeKey?: string;
+    name: string;
+    displayName?: string;
+    description?: string;
+    category: string;
+    subcategory: string | null;
+    format: string;
+    visibility?: string;
+    license: string;
+    assetSpec?: string;
+    tags: string[];
+    shopListed?: boolean;
+    shopPriceCredits?: number;
+    files: Array<{
+        role: string;
+        file: File;
+        filename: string;
+        contentType: string;
+        sizeBytes: number;
+        sha256: string;
+    }>;
+};
+type PreparedAppUploadFiles = {
+    sessionFiles: PreparedSessionFile[];
+    ownedAssets: PreparedOwnedAssetUpload[];
+};
+export declare function prepareAppUploadFiles(task: AppTask, artifacts: AppBuildArtifacts | null): Promise<PreparedAppUploadFiles>;
 export declare function uploadApp(client: ApiClient, task: AppTask, artifacts: AppBuildArtifacts | null, options?: AppUploadOptions): Promise<AppUploadResult>;
+export {};

package/dist/apps/upload.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareAppUploadFiles = prepareAppUploadFiles;
 exports.uploadApp = uploadApp;
 const config_1 = require("@playdrop/config");
 const types_1 = require("@playdrop/types");
@@ -148,37 +149,20 @@ function pushPreparedArtifact(task, currentTotal, file, maxBytes, code, label) {
     const bytes = ensurePreparedArtifactSize(file, maxBytes, code, label);
     return accumulateUploadBytes(task.name, currentTotal, bytes);
 }
-async function uploadApp(client, task, artifacts, options) {
-    // Version is required - no legacy fallback
-    if (!task.version) {
-        throw new Error(`Missing "version" field in catalogue.json for app "${task.name}".\n` +
-            `Add a version field like "version": "1.0.0" to upload your app.`);
-    }
-    return uploadAppVersion(client, task, artifacts, options);
-}
-/**
- * Upload an app version using the versioned API.
- */
-async function uploadAppVersion(client, task, artifacts, options) {
-    const creatorUsername = typeof options?.creatorUsername === 'string' ? options.creatorUsername.trim() : '';
-    if (!creatorUsername) {
-        throw new Error(`Missing creator username for app "${task.name}" upload.`);
-    }
+async function prepareAppUploadFiles(task, artifacts) {
     let totalUploadBytes = 0;
-    const achievements = task.achievements ?? [];
-    const leaderboards = task.leaderboards ?? [];
     const listing = task.listing;
-    const preparedSessionFiles = [];
-    const preparedOwnedAssets = await Promise.all(task.ownedAssets.map((ownedAsset) => prepareOwnedAssetUpload(ownedAsset)));
-    for (const ownedAsset of preparedOwnedAssets) {
+    const sessionFiles = [];
+    const ownedAssets = await Promise.all(task.ownedAssets.map((ownedAsset) => prepareOwnedAssetUpload(ownedAsset)));
+    for (const ownedAsset of ownedAssets) {
         for (const file of ownedAsset.files) {
             totalUploadBytes = accumulateUploadBytes(task.name, totalUploadBytes, file.sizeBytes);
         }
     }
-    for (const definition of achievements) {
+    for (const definition of task.achievements ?? []) {
         const prepared = createFileFromPath(definition.iconPath, 'image/png', config_1.MAX_VERSION_ICON_BYTES, 'achievement_icon_too_large', 'invalid_achievement_icon_content_type', `Achievement icon "${definition.key}"`, isPngSignature);
         totalUploadBytes = pushPreparedFile(task.name, totalUploadBytes, prepared);
-        preparedSessionFiles.push(await buildPreparedSessionFile(`achievementIcon:${definition.key}`, prepared.file));
+        sessionFiles.push(await buildPreparedSessionFile(`achievementIcon:${definition.key}`, prepared.file));
     }
     if (task.hostingMode === 'EXTERNAL') {
         // no hosted files
@@ -186,48 +170,70 @@ async function uploadAppVersion(client, task, artifacts, options) {
     else if (artifacts) {
         totalUploadBytes = pushPreparedArtifact(task, totalUploadBytes, artifacts.bundleFile, config_1.MAX_VERSION_BUNDLE_BYTES, 'bundle_too_large', 'Bundle');
         totalUploadBytes = pushPreparedArtifact(task, totalUploadBytes, artifacts.sourceFile, config_1.MAX_APP_SOURCE_BYTES, 'source_too_large', 'Source archive');
-        preparedSessionFiles.push(await buildPreparedSessionFile('bundle', artifacts.bundleFile));
-        preparedSessionFiles.push(await buildPreparedSessionFile('source', artifacts.sourceFile));
+        sessionFiles.push(await buildPreparedSessionFile('bundle', artifacts.bundleFile));
+        sessionFiles.push(await buildPreparedSessionFile('source', artifacts.sourceFile));
     }
     if (listing?.iconPath) {
         const prepared = createFileFromPath(listing.iconPath, 'image/png', config_1.MAX_VERSION_ICON_BYTES, 'icon_too_large', 'invalid_icon_content_type', 'Icon', isPngSignature);
         totalUploadBytes = pushPreparedFile(task.name, totalUploadBytes, prepared);
-        preparedSessionFiles.push(await buildPreparedSessionFile('icon', prepared.file));
+        sessionFiles.push(await buildPreparedSessionFile('icon', prepared.file));
     }
     if (listing?.heroPortraitPath) {
         const prepared = createFileFromPath(listing.heroPortraitPath, 'image/png', config_1.MAX_VERSION_HERO_BYTES, 'hero_portrait_too_large', 'invalid_hero_portrait_content_type', 'Hero portrait', isPngSignature);
         totalUploadBytes = pushPreparedFile(task.name, totalUploadBytes, prepared);
-        preparedSessionFiles.push(await buildPreparedSessionFile('heroPortrait', prepared.file));
+        sessionFiles.push(await buildPreparedSessionFile('heroPortrait', prepared.file));
     }
     if (listing?.heroLandscapePath) {
         const prepared = createFileFromPath(listing.heroLandscapePath, 'image/png', config_1.MAX_VERSION_HERO_BYTES, 'hero_landscape_too_large', 'invalid_hero_landscape_content_type', 'Hero landscape', isPngSignature);
         totalUploadBytes = pushPreparedFile(task.name, totalUploadBytes, prepared);
-        preparedSessionFiles.push(await buildPreparedSessionFile('heroLandscape', prepared.file));
+        sessionFiles.push(await buildPreparedSessionFile('heroLandscape', prepared.file));
     }
     for (let index = 0; index < (listing?.screenshotPortraitPaths ?? []).length; index += 1) {
         const filePath = listing.screenshotPortraitPaths[index];
         const prepared = createFileFromPath(filePath, 'image/png', config_1.MAX_VERSION_SCREENSHOT_BYTES, 'screenshot_portrait_too_large', 'invalid_screenshot_portrait_content_type', `Portrait screenshot ${index + 1}`, isPngSignature);
         totalUploadBytes = pushPreparedFile(task.name, totalUploadBytes, prepared);
-        preparedSessionFiles.push(await buildPreparedSessionFile(`screenshotsPortrait:${index}`, prepared.file));
+        sessionFiles.push(await buildPreparedSessionFile(`screenshotsPortrait:${index}`, prepared.file));
     }
     for (let index = 0; index < (listing?.screenshotLandscapePaths ?? []).length; index += 1) {
         const filePath = listing.screenshotLandscapePaths[index];
         const prepared = createFileFromPath(filePath, 'image/png', config_1.MAX_VERSION_SCREENSHOT_BYTES, 'screenshot_landscape_too_large', 'invalid_screenshot_landscape_content_type', `Landscape screenshot ${index + 1}`, isPngSignature);
         totalUploadBytes = pushPreparedFile(task.name, totalUploadBytes, prepared);
-        preparedSessionFiles.push(await buildPreparedSessionFile(`screenshotsLandscape:${index}`, prepared.file));
+        sessionFiles.push(await buildPreparedSessionFile(`screenshotsLandscape:${index}`, prepared.file));
     }
     for (let index = 0; index < (listing?.videoPortraitPaths ?? []).length; index += 1) {
         const filePath = listing.videoPortraitPaths[index];
         const prepared = createFileFromPath(filePath, 'video/mp4', config_1.MAX_VERSION_VIDEO_BYTES, 'video_portrait_too_large', 'invalid_video_portrait_content_type', `Portrait video ${index + 1}`, isMp4Signature);
         totalUploadBytes = pushPreparedFile(task.name, totalUploadBytes, prepared);
-        preparedSessionFiles.push(await buildPreparedSessionFile(`videosPortrait:${index}`, prepared.file));
+        sessionFiles.push(await buildPreparedSessionFile(`videosPortrait:${index}`, prepared.file));
     }
     for (let index = 0; index < (listing?.videoLandscapePaths ?? []).length; index += 1) {
         const filePath = listing.videoLandscapePaths[index];
         const prepared = createFileFromPath(filePath, 'video/mp4', config_1.MAX_VERSION_VIDEO_BYTES, 'video_landscape_too_large', 'invalid_video_landscape_content_type', `Landscape video ${index + 1}`, isMp4Signature);
         totalUploadBytes = pushPreparedFile(task.name, totalUploadBytes, prepared);
-        preparedSessionFiles.push(await buildPreparedSessionFile(`videosLandscape:${index}`, prepared.file));
+        sessionFiles.push(await buildPreparedSessionFile(`videosLandscape:${index}`, prepared.file));
+    }
+    return { sessionFiles, ownedAssets };
+}
+async function uploadApp(client, task, artifacts, options) {
+    // Version is required - no legacy fallback
+    if (!task.version) {
+        throw new Error(`Missing "version" field in catalogue.json for app "${task.name}".\n` +
+            `Add a version field like "version": "1.0.0" to upload your app.`);
     }
+    return uploadAppVersion(client, task, artifacts, options);
+}
+/**
+ * Upload an app version using the versioned API.
+ */
+async function uploadAppVersion(client, task, artifacts, options) {
+    const creatorUsername = typeof options?.creatorUsername === 'string' ? options.creatorUsername.trim() : '';
+    if (!creatorUsername) {
+        throw new Error(`Missing creator username for app "${task.name}" upload.`);
+    }
+    const achievements = task.achievements ?? [];
+    const leaderboards = task.leaderboards ?? [];
+    const listing = task.listing;
+    const { sessionFiles: preparedSessionFiles, ownedAssets: preparedOwnedAssets, } = await prepareAppUploadFiles(task, artifacts);
     const initializeRequest = {
         version: task.version,
         agentTaskId: options?.agentTaskId,
@@ -388,6 +394,7 @@ async function uploadAppVersion(client, task, artifacts, options) {
                     currentUser: options?.user ?? null,
                     captureSession: options?.captureSession,
                     phase: 'editor',
+                    verifyEditorPhaseRoundTrip: true,
                 });
                 if (editorLoadCheck.status !== 'PASSED') {
                     throw new Error((0, loadCheck_1.formatHostedLoadCheckFailure)(task.name, editorLoadCheck, 'editor'));

package/dist/commands/upload.js

@@ -1387,6 +1387,7 @@ async function prepareWorkerAppProject(input) {
 // update, upload-session creation, file upload, or version creation.
 async function preflightWorkerAppProject(input) {
     const prepared = await prepareWorkerAppProject(input);
+    await (0, apps_1.prepareAppUploadFiles)(prepared.task, prepared.artifacts);
     return {
         appName: prepared.task.name,
         creatorUsername: prepared.creatorUsername,

package/dist/commands/worker.d.ts

@@ -17,7 +17,8 @@ export declare function buildCreatorRecoveryPrompt(input: {
 }): string;
 export declare function buildGameEvalRetryPrompt(prompt: string): string;
 export declare const WORKER_SESSION_EXPIRED_MESSAGE = "worker session expired: run \"playdrop auth login\" and start the worker again";
-export declare const WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE = "worker_context_command_not_allowed: inside a PlayDrop worker task only task progress, task claim-slug, task upload/done/fail, assigned app scaffolding, project validation/build/dev/check/capture, read-only help/catalogue/documentation lookup, and PlayDrop AI generation are permitted.";
+export declare const WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE = "worker_context_command_not_allowed: inside a PlayDrop worker task only task progress, task claim-slug, task upload/done/fail, assigned app scaffolding, project build/dev/check/capture, read-only help/catalogue/documentation lookup, and PlayDrop AI generation are permitted.";
+export declare const WORKER_CONTEXT_PROJECT_VALIDATE_NOT_ALLOWED_MESSAGE = "worker_context_project_validate_not_allowed: \"playdrop project validate\" is not available inside a PlayDrop worker task. Run \"playdrop task upload --preflight-only\" as the sole pre-upload validation gate.";
 type WorkerStartOptions = {
     env?: string;
     once?: boolean;
@@ -196,6 +197,7 @@ export declare function allocateWorkerDevPort(input: {
     maxParallelTasks?: number;
 }): number;
 export declare function isWorkerContextCommandAllowed(argv: string[]): boolean;
+export declare function resolveWorkerContextCommandBlockMessage(argv: string[]): string | null;
 export declare function resolveWorkerExecutionTargetFromRole(role: unknown): AgentExecutionTarget;
 export declare function normalizeWorkerTaskAssignmentV2(claim: WorkerClaimAgentTaskResponse): WorkerTaskAssignmentV2 | null;
 export declare function nextClaimBackoffMs(currentMs: number): number;

package/dist/commands/worker.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WORKER_TASK_WORKSPACE_RETENTION = exports.WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE = exports.WORKER_SESSION_EXPIRED_MESSAGE = exports.runLoggedProcess = exports.readEnvBoolean = exports.readCodexSandboxMode = exports.readCodexRolloutTokenUsageForThread = exports.extractCodexTokensUsed = exports.extractCodexThreadId = exports.extractClaudeSessionId = exports.extractCodexRolloutTokenUsage = exports.extractAgentTokenUsage = exports.DEFAULT_WORKER_TOKEN_CAP = exports.DEFAULT_CREATOR_UPLOAD_RECOVERY_TIMEOUT_MS = exports.DEFAULT_CREATOR_AGENT_TIMEOUT_MS = exports.DEFAULT_CODEX_TIMEOUT_MS = exports.buildWorkerChildEnv = exports.buildPlaywrightMcpCommand = exports.buildCodexExecArgs = exports.buildCleanRoomChildEnv = exports.buildClaudePermissionSettings = exports.buildClaudeExecArgs = exports.assertWorkerTokenUsageWithinCap = void 0;
+exports.WORKER_TASK_WORKSPACE_RETENTION = exports.WORKER_CONTEXT_PROJECT_VALIDATE_NOT_ALLOWED_MESSAGE = exports.WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE = exports.WORKER_SESSION_EXPIRED_MESSAGE = exports.runLoggedProcess = exports.readEnvBoolean = exports.readCodexSandboxMode = exports.readCodexRolloutTokenUsageForThread = exports.extractCodexTokensUsed = exports.extractCodexThreadId = exports.extractClaudeSessionId = exports.extractCodexRolloutTokenUsage = exports.extractAgentTokenUsage = exports.DEFAULT_WORKER_TOKEN_CAP = exports.DEFAULT_CREATOR_UPLOAD_RECOVERY_TIMEOUT_MS = exports.DEFAULT_CREATOR_AGENT_TIMEOUT_MS = exports.DEFAULT_CODEX_TIMEOUT_MS = exports.buildWorkerChildEnv = exports.buildPlaywrightMcpCommand = exports.buildCodexExecArgs = exports.buildCleanRoomChildEnv = exports.buildClaudePermissionSettings = exports.buildClaudeExecArgs = exports.assertWorkerTokenUsageWithinCap = void 0;
 exports.usesCreatorRecovery = usesCreatorRecovery;
 exports.buildDeterministicReleaseSmokeArtifact = buildDeterministicReleaseSmokeArtifact;
 exports.buildCreatorRecoveryPrompt = buildCreatorRecoveryPrompt;
@@ -11,6 +11,7 @@ exports.buildGameEvalRetryPrompt = buildGameEvalRetryPrompt;
 exports.resolveInitialCreatorProgress = resolveInitialCreatorProgress;
 exports.allocateWorkerDevPort = allocateWorkerDevPort;
 exports.isWorkerContextCommandAllowed = isWorkerContextCommandAllowed;
+exports.resolveWorkerContextCommandBlockMessage = resolveWorkerContextCommandBlockMessage;
 exports.resolveWorkerExecutionTargetFromRole = resolveWorkerExecutionTargetFromRole;
 exports.normalizeWorkerTaskAssignmentV2 = normalizeWorkerTaskAssignmentV2;
 exports.nextClaimBackoffMs = nextClaimBackoffMs;
@@ -222,7 +223,6 @@ const WORKER_CONTEXT_ALLOWED_COMMANDS = [
     ['review', 'validate-result'],
     ['review', 'compose-evidence'],
     ['review', 'rating-card'],
-    ['project', 'validate'],
     ['project', 'build'],
     ['project', 'dev'],
     ['project', 'check'],
@@ -240,7 +240,8 @@ const WORKER_CONTEXT_ALLOWED_COMMANDS = [
     ['ai', 'jobs', 'detail'],
     ['ai', 'generations'],
 ];
-exports.WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE = 'worker_context_command_not_allowed: inside a PlayDrop worker task only task progress, task claim-slug, task upload/done/fail, assigned app scaffolding, project validation/build/dev/check/capture, read-only help/catalogue/documentation lookup, and PlayDrop AI generation are permitted.';
+exports.WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE = 'worker_context_command_not_allowed: inside a PlayDrop worker task only task progress, task claim-slug, task upload/done/fail, assigned app scaffolding, project build/dev/check/capture, read-only help/catalogue/documentation lookup, and PlayDrop AI generation are permitted.';
+exports.WORKER_CONTEXT_PROJECT_VALIDATE_NOT_ALLOWED_MESSAGE = 'worker_context_project_validate_not_allowed: "playdrop project validate" is not available inside a PlayDrop worker task. Run "playdrop task upload --preflight-only" as the sole pre-upload validation gate.';
 function resolveInitialCreatorProgress(kind, creationRecovery = false) {
     if (creationRecovery) {
         return null;
@@ -297,6 +298,14 @@ function isWorkerContextCommandAllowed(argv) {
     }
     return isAssignedAppScaffoldCommandAllowed(argv);
 }
+function resolveWorkerContextCommandBlockMessage(argv) {
+    if (argv[0] === 'project' && argv[1] === 'validate') {
+        return exports.WORKER_CONTEXT_PROJECT_VALIDATE_NOT_ALLOWED_MESSAGE;
+    }
+    return isWorkerContextCommandAllowed(argv)
+        ? null
+        : exports.WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE;
+}
 function readWorkerContextForPolicy() {
     try {
         return readTaskContextFile();

package/dist/index.js

@@ -49,11 +49,14 @@ const notes_1 = require("./commands/notes");
 const worker_1 = require("./commands/worker");
 const messages_1 = require("./messages");
 // Restricted shim: inside a worker task workspace only task-scoped commands,
-// local validation/run helpers, safe read-only lookups, and AI generation are
+// local build/run helpers, safe read-only lookups, and AI generation are
 // permitted. Worker lease credentials are never exposed to the agent process.
-if (process.env.PLAYDROP_WORKER_CONTEXT === '1' && !(0, worker_1.isWorkerContextCommandAllowed)(process.argv.slice(2))) {
-    console.error(worker_1.WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE);
-    process.exit(1);
+if (process.env.PLAYDROP_WORKER_CONTEXT === '1') {
+    const workerContextBlockMessage = (0, worker_1.resolveWorkerContextCommandBlockMessage)(process.argv.slice(2));
+    if (workerContextBlockMessage) {
+        console.error(workerContextBlockMessage);
+        process.exit(1);
+    }
 }
 function printRemovedCommandHint(command) {
     const replacements = {

package/node_modules/@playdrop/api-client/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { AcquisitionAttributionRequest, AcquisitionAttributionResponse, AbortAppUploadResponse, AbortAssetPackUploadResponse, AdInterstitialShowResponse, AdLoadRequest, AdLoadResponse, AdRewardedShowResponse, AdShowRequest, AdminAgentTaskDetailResponse, AdminAgentTaskTranscriptResponse, AdminAgentTasksResponse, AdminAgentWorkersStatusResponse, AdminAppPlayerMetaResponse, AdminAppPlayerMetaUserResponse, AdminAppVersionReviewsListResponse, AdminAppsListResponse, AdminCreatorEngagementExecutionsResponse, AdminCreatorEngagementRulePreviewRequest, AdminCreatorEngagementRulePreviewResponse, AdminCreatorEngagementRulesResponse, AdminCreatorEngagementUserResponse, AdminCreatorSubscriptionsResponse, AdminCreditTransactionsResponse, AdminCreatorAcquisitionAnalyticsRequest, AdminPaidAcquisitionAnalyticsRequest, AdminEnqueueNextAppVersionReviewTaskResponse, AdminFeedbackListResponse, AdminFeedbackResponse, AdminGameCollectionCandidatesResponse, AdminGameCollectionResponse, AdminGameCollectionsResponse, AdminMutateAchievementStateRequest, AdminMutateAchievementStateResponse, AdminMutateLeaderboardScoreRequest, AdminMutateLeaderboardScoreResponse, AdminPaymentDetailResponse, AdminPaymentsListResponse, AdminPlatformAnalyticsRequest, AdminPlatformAnalyticsResponse, AdminTractionAnalyticsRequest, AdminRefundPaymentRequest, AdminRetirePlayerMetaDefinitionResponse, AdminTagGroupResponse, AdminTagGroupsResponse, AdminTagResponse, AdminUpdateAppRequest, AdminUpdateAppResponse, AdminUpdateAppVersionReviewRequest, AdminUpdateAppVersionReviewResponse, AdminUserResponse, AgentTaskAttachmentUploadResponse, AgentTaskAvailabilityResponse, AgentTaskCreatorFeedbackStatus, AgentTaskDetailResponse, AgentTaskEventsResponse, AgentTaskKind, AgentTaskNewGameSuggestionsResponse, AgentTasksResponse, AiGenerationDetailResponse, AiGenerationsResponse, ApiKeyLoginRequest, AppAccessTokenResponse, AppAgentTaskResponse, AppBrowseRequest, AppDetailRequest, AppDetailResponse, AppLogEntryRequest, AppLogEntryResponse, AppListingDraftMediaSlot, AppListingDraftResponse, AppMoreCollectionKey, AppMoreCollectionPage, AppMoreCollectionRequest, AppMoreCollectionsRequest, AppMoreCollectionsResponse, AppRuntimeAssetsResponse, AppAuthMode, AppSourceBundleResponse, AppType, AppUploadLaunchCheckPreviewResponse, AppVersionDetailResponse, AppVersionVisibility, PublishAppListingDraftResponse, AppTweaksSnapshot, CreatorNotesClearResponse, CreatorNotesResponse, CreateCreatorPlanGrantRequest, CreatorPlanGrantMutationResponse, TweakValues, UpdateAppListingDraftRequest, AppVersionsListResponse, AppleCreditPackFulfillmentRequest, AppleLinkRequest, AppleLinkResponse, AppleNativeChallengeResponse, AppleOAuthHandoffExchangeRequest, AppleOAuthHandoffExchangeResponse, AppleOAuthLinkStartRequest, AppleOAuthLinkStartResponse, ApplePendingSignupResponse, ApplePushDeviceRequest, ApplePushDeviceStatusResponse, AppleSignInRequest, AppleSignInResponse, AppsListResponse, AssetBrowseKind, AssetCategoriesResponse, AssetCategory, AssetDetailResponse, AssetFormat, AssetListResponse, AssetListSort, AssetPackDetailResponse, AssetPackListResponse, AssetPackListSort, AssetPackSourceBundleResponse, AssetPackVersionsListResponse, AssetPurchaseRequest, AssetSourceBundleResponse, AssetSourceKind, AssetSpecAppsListResponse, AssetSpecAssetsListResponse, AssetSpecDetailResponse, AssetSpecListResponse, AssetSpecListSort, AssetSpecVersionResponseEnvelope, AssetSpecVersionsListResponse, AssetVersionsListResponse, AssetVisibility, BatchCreateUsersResponse, BatchUpsertNodeRelationsRequest, BatchUpsertNodeRelationsResponse, BoostActivationRequest, BoostBalanceResponse, BoostHistoryResponse, BoostPurchaseRequest, BoostPurchaseResponse, BoostReportQuery, BoostReportResponse, BoostStatusResponse, BootstrapResponse, CancelAgentTaskResponse, ChangePasswordRequest, ChangePasswordResponse, ClaimFreeCreditRewardResponse, ClearAgentTaskResponse, CliApiKeyStatusResponse, CliApiTokenSecretResponse, CliApiTokensResponse, CliLoginApproveRequest, CliLoginApproveResponse, CliLoginPollRequest, CliLoginPollResponse, CliLoginStartResponse, CliLoginStatusResponse, CliWebLaunchStartRequest, CliWebLaunchStartResponse, CompleteAppleSignupRequest, CompleteAppleSignupResponse, CompleteGoogleSignupRequest, CompleteGoogleSignupResponse, CompleteXSignupRequest, CompleteXSignupResponse, NativeOAuthHandoffExchangeRequest, NativeOAuthHandoffExchangeResponse, NativeOAuthLinkStartRequest, NativeOAuthLinkStartResponse, ContentCommentsResponse, ContentLicense, ContentRemixRelationsResponse, CreateAdminGameCollectionRequest, CreateAppAgentTaskRequest, CreateAppAgentTaskResponse, CreateAppRequest, CreateAppResponse, CreateAssetSpecVersionResponse, CreateAssetVersionResponse, CreateCliApiKeyResponse, CreateCliApiTokenRequest, CreateCommentReportRequest, CreateContentCommentRequest, CreateContentCommentResponse, CreateContentReportRequest, CreateCreatorReportRequest, CreateGameEvalAgentTaskRequest, CreateGameEvalAgentTaskResponse, CreateNewGameAgentTaskRequest, CreateNewGameAgentTaskResponse, CreateStaticGameAgentTaskRequest, CreateStaticGameAgentTaskResponse, CreateRemixGameAgentTaskRequest, CreateRemixGameAgentTaskResponse, CreateTagGroupRequest, CreateTagRequest, CreateUserRequest, CreateUserResponse, CreatorAppsBrowseRequest, CreatorBlockMutationResponse, CreatorEarningsResponse, CreatorEngagementRuleExecutionStatus, CreatorAcquisitionAnalyticsResponse, PaidAcquisitionAnalyticsResponse, CreatorFollowMutationResponse, CreatorGameCreatorFeedbackStatusResponse, CreatorGameShareResponse, CreatorGameStatusResponse, CreatorGameVersionsResponse, CreatorGamesListResponse, CreationConversationResponse, CreditPackCheckoutSessionRequest, CreditPackCheckoutSessionResponse, CreditPackCheckoutStatusResponse, CreatorPlanCheckoutSessionResponse, CreatorPlanCheckoutSessionStatusResponse, CreatorPlanPortalSessionResponse, CreatorPlanState, CreatorPlanTier, CreditPackResponse, CreditPacksResponse, DeleteAdminGameCollectionResponse, DeleteAdminUserResponse, DeleteAppResponse, DeleteAssetPackResponse, DeleteAssetPackVersionResponse, DeleteAssetResponse, DeleteAssetSpecResponse, DeleteAssetSpecVersionResponse, DeleteAssetVersionResponse, DeleteCliApiTokenResponse, DeleteContentCommentResponse, DeleteFeedbackResponse, DeleteMyAccountRequest, DeleteMyAccountResponse, DeleteOwnedCustomAssetResponse, DeleteVersionResponse, DevAppAccessTokenResponse, DevPlayerResetResponse, DislikedItemMutationResponse, EmailPreferencesResponse, EmailUnsubscribeResponse, FeedbackCategory, FeedbackClient, FeedbackListResponse, FeedbackStatus, FetchHomeOptions, FinalizeAppUploadResponse, FinalizeAppUploadRequest, FinalizeAssetPackUploadResponse, FirebasePushDeviceRequest, FirebasePushDeviceStatusResponse, GameplaySessionResponse, GameplaySessionActivityRequest, GameplaySessionStartRequest, FollowingCreatorsResponse, FollowingFeedResponse, FollowingFeedSection, FollowingSort, FreeCreditsResponse, GetAchievementResponse, GetLeaderboardResponse, GoogleAppleLinkRequest, GoogleAppleLinkResponse, GoogleAppleSignInRequest, GoogleAppleSignInResponse, GoogleCreditPackFulfillmentRequest, GoogleOneTapExchangeRequest, GoogleOneTapExchangeResponse, GooglePendingSignupResponse, HomeCollectionPageResponse, HomeResponse, IapPurchaseRequest, IapPurchaseResponse, IapReceiptListParams, IapReceiptResponse, IapReceiptsResponse, InitializeAppUploadRequest, InitializeAppUploadResponse, InitializeAssetPackUploadRequest, InitializeAssetPackUploadResponse, InvitePreviewResponse, LibraryCategory, LibraryResponse, LibrarySort, LikedItemMutationResponse, ListAchievementsResponse, ListLeaderboardsResponse, ListOwnedCustomAssetsResponse, LoadOwnedCustomAssetResponse, LoginRequest, LoginResponse, LogoutResponse, MeAgentWorkersResponse, MeResponse, MobileCreditPackFulfillmentResponse, ModerationReportResponse, MutateOwnedCustomAssetRequest, MutateOwnedCustomAssetResponse, MyAchievementsResponse, MyAppsResponse, MyInviteCodeResponse, MyLeaderboardsResponse, NotificationReadResponse, NotificationStatus, NotificationsResponse, OwnedProfileAssetsResponse, PaymentProvider, PaymentStatus, PrivacyExportResponse, PublicEmailPreferencesResponse, PublicEmailPreferencesUpdateRequest, PurchaseResponse, PushSubscriptionMutationResponse, RecordAppUploadLaunchCheckRequest, RecordAppUploadLaunchCheckResponse, RecordAppUploadCausalCheckRequest, RecordAppUploadCausalCheckResponse, RecordAppUploadMediaCaptureRequest, RecordAppUploadMediaCaptureResponse, RegisterRequest, RegisterResponse, RemixScaffoldResponse, ResolveRuntimeAssetsRequest, ResolveRuntimeAssetsResponse, RetryAgentTaskResponse, ReviewState, SavedItemKind, SavedItemMutationResponse, SearchRequest, SearchResponse, SearchSuggestRequest, SearchSuggestResponse, SetAchievementProgressRequest, SetAchievementProgressResponse, SetProfileAssetRequest, SetProfileAssetResponse, ShopResponse, StarterProfileAssetsResponse, SubmitFeedbackRequest, SubmitFeedbackResponse, SubmitLeaderboardScoreRequest, SubmitLeaderboardScoreResponse, TagDetailResponse, TagDirectoryResponse, TagGroupDetailResponse, TagGroupSort, TagListResponse, TemplateScaffoldResponse, TrackEngagementEventRequest, TrackEngagementEventResponse, TractionAnalyticsResponse, TransactionsResponse, UnlinkGoogleResponse, UnlinkXResponse, UnlockAchievementResponse, UpdateAdminFeedbackRequest, UpdateAdminFeedbackResponse, UpdateAdminGameCollectionGamesRequest, UpdateAdminGameCollectionRequest, UpdateAdminUserRequest, UpdateAppRequest, UpdateAppResponse, UpdateAssetPackRequest, UpdateAssetPackResponse, UpdateAssetPackVersionRequest, UpdateAssetPackVersionResponse, UpdateAssetRequest, UpdateAssetResponse, UpdateAssetSpecVersionResponse, UpdateAssetVersionRequest, UpdateAssetVersionResponse, UpdateProfileRequest, UpdateProfileResponse, UpdateTagGroupRequest, UpdateTagRequest, UpdateUserCommunicationPreferencesRequest, UpdateVersionResponse, UploadAppSessionFileResponse, UploadAppSessionOwnedAssetResponse, UploadAssetPackSessionAssetResponse, UploadAssetPackSessionMediaResponse, UpsertWebPushSubscriptionRequest, UserDetailResponse, UsernameAvailableResponse, UsersListResponse, WebPushConfigResponse, WebPushSubscriptionStatusResponse, WorkerAgentTaskAttemptUnavailableRequest, WorkerAgentTaskAttemptUnavailableResponse, WorkerClaimAgentTaskRequest, WorkerClaimAgentTaskResponse, WorkerClaimAgentTaskSlugRequest, WorkerClaimAgentTaskSlugResponse, WorkerCompleteAgentTaskRequest, WorkerCompleteReleaseSmokeRequest, WorkerCreateAgentTaskEventRequest, WorkerCreateAgentTaskEventResponse, WorkerCreateAgentTaskTranscriptChunkRequest, WorkerCreateAgentTaskTranscriptChunkResponse, WorkerFailAgentTaskRequest, WorkerHeartbeatAgentTaskRequest, WorkerHeartbeatAgentTaskResponse, WorkerPresenceRequest, WorkerPresenceResponse, RegisterAgentBundleRequest, RegisterAgentBundleResponse, WorkerRecordAgentTaskRunTelemetryRequest, WorkerRecordAgentTaskRunTelemetryResponse, WorkerSubmitAgentTaskEvalRequest, WorkerSubmitAgentTaskEvalResponse, WorkerSubmitAgentTaskReviewRequest, WorkerSubmitAgentTaskReviewResponse, WorkerAgentTaskMaterialResponse, WorkerUpdateIntentRequest, WorkerUpdateIntentResponse, XPendingSignupResponse } from '@playdrop/types';
+import type { AcquisitionAttributionRequest, AcquisitionAttributionResponse, AbortAppUploadResponse, AbortAssetPackUploadResponse, AdInterstitialShowResponse, AdLoadRequest, AdLoadResponse, AdRewardedShowResponse, AdShowRequest, AdminAgentTaskDetailResponse, AdminAgentTaskTranscriptResponse, AdminAgentTasksResponse, AdminAgentWorkersStatusResponse, AdminAppPlayerMetaResponse, AdminAppPlayerMetaUserResponse, AdminAppVersionReviewsListResponse, AdminAppsListResponse, AdminCreatorEngagementExecutionsResponse, AdminCreatorEngagementRulePreviewRequest, AdminCreatorEngagementRulePreviewResponse, AdminCreatorEngagementRulesResponse, AdminCreatorEngagementUserResponse, AdminCreatorSubscriptionsResponse, AdminCreditTransactionsResponse, AdminCreatorAcquisitionAnalyticsRequest, AdminPaidAcquisitionAnalyticsRequest, AdminEnqueueNextAppVersionReviewTaskResponse, AdminFeedbackListResponse, AdminFeedbackResponse, AdminGameCollectionCandidatesResponse, AdminGameCollectionResponse, AdminGameCollectionsResponse, AdminMutateAchievementStateRequest, AdminMutateAchievementStateResponse, AdminMutateLeaderboardScoreRequest, AdminMutateLeaderboardScoreResponse, AdminPaymentDetailResponse, AdminPaymentsListResponse, AdminPlatformAnalyticsRequest, AdminPlatformAnalyticsResponse, AdminTractionAnalyticsRequest, AdminRefundPaymentRequest, AdminRetirePlayerMetaDefinitionResponse, AdminTagGroupResponse, AdminTagGroupsResponse, AdminTagResponse, AdminUpdateAppRequest, AdminUpdateAppResponse, AdminUpdateAppVersionReviewRequest, AdminUpdateAppVersionReviewResponse, AdminUserResponse, AgentTaskAttachmentUploadResponse, AgentTaskAvailabilityResponse, AgentTaskCreatorFeedbackStatus, AgentTaskDetailResponse, AgentTaskEventsResponse, AgentTaskKind, AgentTaskNewGameSuggestionsResponse, AgentTasksResponse, AiGenerationDetailResponse, AiGenerationsResponse, ApiKeyLoginRequest, AppAccessTokenResponse, AppAgentTaskResponse, AppBrowseRequest, AppDetailRequest, AppDetailResponse, AppLogEntryRequest, AppLogEntryResponse, AppListingDraftMediaSlot, AppListingDraftResponse, AppMoreCollectionKey, AppMoreCollectionPage, AppMoreCollectionRequest, AppMoreCollectionsRequest, AppMoreCollectionsResponse, AppRuntimeAssetsResponse, AppAuthMode, AppSourceBundleResponse, AppType, AppUploadLaunchCheckPreviewResponse, AppVersionDetailResponse, AppVersionVisibility, PublishAppListingDraftResponse, AppTweaksSnapshot, CreatorNotesClearResponse, CreatorNotesResponse, CreateCreatorPlanGrantRequest, CreatorPlanGrantMutationResponse, TweakValues, UpdateAppListingDraftRequest, AppVersionsListResponse, AppleCreditPackFulfillmentRequest, AppleLinkRequest, AppleLinkResponse, AppleNativeChallengeResponse, AppleOAuthHandoffExchangeRequest, AppleOAuthHandoffExchangeResponse, AppleOAuthLinkStartRequest, AppleOAuthLinkStartResponse, ApplePendingSignupResponse, ApplePushDeviceRequest, ApplePushDeviceStatusResponse, AppleSignInRequest, AppleSignInResponse, AppsListResponse, AssetBrowseKind, AssetCategoriesResponse, AssetCategory, AssetDetailResponse, AssetFormat, AssetListResponse, AssetListSort, AssetPackDetailResponse, AssetPackListResponse, AssetPackListSort, AssetPackSourceBundleResponse, AssetPackVersionsListResponse, AssetPurchaseRequest, AssetSourceBundleResponse, AssetSourceKind, AssetSpecAppsListResponse, AssetSpecAssetsListResponse, AssetSpecDetailResponse, AssetSpecListResponse, AssetSpecListSort, AssetSpecVersionResponseEnvelope, AssetSpecVersionsListResponse, AssetVersionsListResponse, AssetVisibility, BatchCreateUsersResponse, BatchUpsertNodeRelationsRequest, BatchUpsertNodeRelationsResponse, BoostActivationRequest, BoostBalanceResponse, BoostHistoryResponse, BoostPurchaseRequest, BoostPurchaseResponse, BoostReportQuery, BoostReportResponse, BoostStatusResponse, BootstrapResponse, CancelAgentTaskResponse, ChangePasswordRequest, ChangePasswordResponse, ClaimFreeCreditRewardResponse, ClearAgentTaskResponse, CliApiKeyStatusResponse, CliApiTokenSecretResponse, CliApiTokensResponse, CliLoginApproveRequest, CliLoginApproveResponse, CliLoginPollRequest, CliLoginPollResponse, CliLoginStartResponse, CliLoginStatusResponse, CliWebLaunchStartRequest, CliWebLaunchStartResponse, CompleteAppleSignupRequest, CompleteAppleSignupResponse, CompleteGoogleSignupRequest, CompleteGoogleSignupResponse, CompleteXSignupRequest, CompleteXSignupResponse, NativeOAuthHandoffExchangeRequest, NativeOAuthHandoffExchangeResponse, NativeOAuthLinkStartRequest, NativeOAuthLinkStartResponse, ContentCommentsResponse, ContentLicense, ContentRemixRelationsResponse, CreateAdminGameCollectionRequest, CreateAppAgentTaskRequest, CreateAppAgentTaskResponse, CreateAppRequest, CreateAppResponse, CreateAssetSpecVersionResponse, CreateAssetVersionResponse, CreateCliApiKeyResponse, CreateCliApiTokenRequest, CreateCommentReportRequest, CreateContentCommentRequest, CreateContentCommentResponse, CreateContentReportRequest, CreateCreatorReportRequest, CreateGameEvalAgentTaskRequest, CreateGameEvalAgentTaskResponse, CreateNewGameAgentTaskRequest, CreateNewGameAgentTaskResponse, CreateStaticGameAgentTaskRequest, CreateStaticGameAgentTaskResponse, CreateRemixGameAgentTaskRequest, CreateRemixGameAgentTaskResponse, CreateTagGroupRequest, CreateTagRequest, CreateUserRequest, CreateUserResponse, CreatorAppsBrowseRequest, CreatorBlockMutationResponse, CreatorEarningsResponse, CreatorEngagementRuleExecutionStatus, CreatorAcquisitionAnalyticsResponse, PaidAcquisitionAnalyticsResponse, CreatorFollowMutationResponse, CreatorGameCreatorFeedbackStatusResponse, CreatorGameShareResponse, CreatorGameStatusResponse, CreatorGameVersionsResponse, CreatorGamesListResponse, CreationConversationResponse, CreditPackCheckoutSessionRequest, CreditPackCheckoutSessionResponse, CreditPackCheckoutStatusResponse, CreatorPlanCheckoutSessionResponse, CreatorPlanCheckoutSessionStatusResponse, CreatorPlanPortalSessionResponse, CreatorPlanSessionRequest, CreatorPlanState, CreatorPlanTier, CreditPackResponse, CreditPacksResponse, DeleteAdminGameCollectionResponse, DeleteAdminUserResponse, DeleteAppResponse, DeleteAssetPackResponse, DeleteAssetPackVersionResponse, DeleteAssetResponse, DeleteAssetSpecResponse, DeleteAssetSpecVersionResponse, DeleteAssetVersionResponse, DeleteCliApiTokenResponse, DeleteContentCommentResponse, DeleteFeedbackResponse, DeleteMyAccountRequest, DeleteMyAccountResponse, DeleteOwnedCustomAssetResponse, DeleteVersionResponse, DevAppAccessTokenResponse, DevPlayerResetResponse, DislikedItemMutationResponse, EmailPreferencesResponse, EmailUnsubscribeResponse, FeedbackCategory, FeedbackClient, FeedbackListResponse, FeedbackStatus, FetchAdminUsersOptions, FetchHomeOptions, FinalizeAppUploadResponse, FinalizeAppUploadRequest, FinalizeAssetPackUploadResponse, FirebasePushDeviceRequest, FirebasePushDeviceStatusResponse, GameplaySessionResponse, GameplaySessionActivityRequest, GameplaySessionStartRequest, FollowingCreatorsResponse, FollowingFeedResponse, FollowingFeedSection, FollowingSort, FreeCreditsResponse, GetAchievementResponse, GetLeaderboardResponse, GoogleAppleLinkRequest, GoogleAppleLinkResponse, GoogleAppleSignInRequest, GoogleAppleSignInResponse, GoogleCreditPackFulfillmentRequest, GoogleOneTapExchangeRequest, GoogleOneTapExchangeResponse, GooglePendingSignupResponse, HomeCollectionPageResponse, HomeResponse, IapPurchaseRequest, IapPurchaseResponse, IapReceiptListParams, IapReceiptResponse, IapReceiptsResponse, InitializeAppUploadRequest, InitializeAppUploadResponse, InitializeAssetPackUploadRequest, InitializeAssetPackUploadResponse, InvitePreviewResponse, LibraryCategory, LibraryResponse, LibrarySort, LikedItemMutationResponse, ListAchievementsResponse, ListLeaderboardsResponse, ListOwnedCustomAssetsResponse, LoadOwnedCustomAssetResponse, LoginRequest, LoginResponse, LogoutResponse, MeAgentWorkersResponse, MeResponse, MobileCreditPackFulfillmentResponse, ModerationReportResponse, MutateOwnedCustomAssetRequest, MutateOwnedCustomAssetResponse, MyAchievementsResponse, MyAppsResponse, MyInviteCodeResponse, MyLeaderboardsResponse, NotificationReadResponse, NotificationStatus, NotificationsResponse, OwnedProfileAssetsResponse, PaymentProvider, PaymentStatus, PrivacyExportResponse, PublicEmailPreferencesResponse, PublicEmailPreferencesUpdateRequest, PurchaseResponse, PushSubscriptionMutationResponse, RecordAppUploadLaunchCheckRequest, RecordAppUploadLaunchCheckResponse, RecordAppUploadCausalCheckRequest, RecordAppUploadCausalCheckResponse, RecordAppUploadMediaCaptureRequest, RecordAppUploadMediaCaptureResponse, RegisterRequest, RegisterResponse, RemixScaffoldResponse, ResolveRuntimeAssetsRequest, ResolveRuntimeAssetsResponse, RetryAgentTaskResponse, ReviewState, SavedItemKind, SavedItemMutationResponse, SearchRequest, SearchResponse, SearchSuggestRequest, SearchSuggestResponse, SetAchievementProgressRequest, SetAchievementProgressResponse, SetProfileAssetRequest, SetProfileAssetResponse, ShopResponse, StarterProfileAssetsResponse, SubmitFeedbackRequest, SubmitFeedbackResponse, SubmitLeaderboardScoreRequest, SubmitLeaderboardScoreResponse, TagDetailResponse, TagDirectoryResponse, TagGroupDetailResponse, TagGroupSort, TagListResponse, TemplateScaffoldResponse, TrackEngagementEventRequest, TrackEngagementEventResponse, TractionAnalyticsResponse, TransactionsResponse, UnlinkGoogleResponse, UnlinkXResponse, UnlockAchievementResponse, UpdateAdminFeedbackRequest, UpdateAdminFeedbackResponse, UpdateAdminGameCollectionGamesRequest, UpdateAdminGameCollectionRequest, UpdateAdminUserRequest, UpdateAppRequest, UpdateAppResponse, UpdateAssetPackRequest, UpdateAssetPackResponse, UpdateAssetPackVersionRequest, UpdateAssetPackVersionResponse, UpdateAssetRequest, UpdateAssetResponse, UpdateAssetSpecVersionResponse, UpdateAssetVersionRequest, UpdateAssetVersionResponse, UpdateProfileRequest, UpdateProfileResponse, UpdatePreferredLocaleRequest, UpdatePreferredLocaleResponse, UpdateTagGroupRequest, UpdateTagRequest, UpdateUserCommunicationPreferencesRequest, UpdateVersionResponse, UploadAppSessionFileResponse, UploadAppSessionOwnedAssetResponse, UploadAssetPackSessionAssetResponse, UploadAssetPackSessionMediaResponse, UpsertWebPushSubscriptionRequest, UserDetailResponse, UsernameAvailableResponse, UsersListResponse, WebPushConfigResponse, WebPushSubscriptionStatusResponse, WorkerAgentTaskAttemptUnavailableRequest, WorkerAgentTaskAttemptUnavailableResponse, WorkerClaimAgentTaskRequest, WorkerClaimAgentTaskResponse, WorkerClaimAgentTaskSlugRequest, WorkerClaimAgentTaskSlugResponse, WorkerCompleteAgentTaskRequest, WorkerCompleteReleaseSmokeRequest, WorkerCreateAgentTaskEventRequest, WorkerCreateAgentTaskEventResponse, WorkerCreateAgentTaskTranscriptChunkRequest, WorkerCreateAgentTaskTranscriptChunkResponse, WorkerFailAgentTaskRequest, WorkerHeartbeatAgentTaskRequest, WorkerHeartbeatAgentTaskResponse, WorkerPresenceRequest, WorkerPresenceResponse, RegisterAgentBundleRequest, RegisterAgentBundleResponse, WorkerRecordAgentTaskRunTelemetryRequest, WorkerRecordAgentTaskRunTelemetryResponse, WorkerSubmitAgentTaskEvalRequest, WorkerSubmitAgentTaskEvalResponse, WorkerSubmitAgentTaskReviewRequest, WorkerSubmitAgentTaskReviewResponse, WorkerAgentTaskMaterialResponse, WorkerUpdateIntentRequest, WorkerUpdateIntentResponse, XPendingSignupResponse } from '@playdrop/types';
 import { type AdminAgentTaskTranscriptOptions, type CreationGamesFetchResult, type GetCreationConversationOptions, type ListAgentTasksOptions, type ListCreatorGamesOptions, type UploadWorkerAgentTaskMaterialOptions } from './domains/agent-tasks.js';
 export interface HttpMethod {
     GET: 'GET';
@@ -112,6 +112,7 @@ export interface ApiClient {
     logout(): Promise<LogoutResponse>;
     me(): Promise<MeResponse>;
     updateProfile(request: UpdateProfileRequest): Promise<UpdateProfileResponse>;
+    updatePreferredLocale(request: UpdatePreferredLocaleRequest): Promise<UpdatePreferredLocaleResponse>;
     changePassword(request: ChangePasswordRequest): Promise<ChangePasswordResponse>;
     exportPrivacyData(): Promise<PrivacyExportResponse>;
     deleteAccount(request: DeleteMyAccountRequest): Promise<DeleteMyAccountResponse>;
@@ -519,18 +520,12 @@ export interface ApiClient {
     deleteAppVersion(creatorUsername: string, appName: string, version: string): Promise<DeleteVersionResponse>;
     fetchPublicCreditShop(): Promise<ShopResponse>;
     fetchCreditShop(): Promise<ShopResponse>;
-    createCreditPackCheckoutSession(sku: string, request?: CreditPackCheckoutSessionRequest): Promise<CreditPackCheckoutSessionResponse>;
+    createCreditPackCheckoutSession(sku: string, request: CreditPackCheckoutSessionRequest): Promise<CreditPackCheckoutSessionResponse>;
     fetchCreditPackCheckoutStatus(sessionId: string): Promise<CreditPackCheckoutStatusResponse>;
-    createCreatorPlanCheckoutSession(tier: Exclude<CreatorPlanTier, 'BASIC'>, requestKey: string, request?: {
-        nextPath?: string;
-    }): Promise<CreatorPlanCheckoutSessionResponse>;
+    createCreatorPlanCheckoutSession(tier: Exclude<CreatorPlanTier, 'BASIC'>, requestKey: string, request: CreatorPlanSessionRequest): Promise<CreatorPlanCheckoutSessionResponse>;
     fetchCreatorPlanCheckoutStatus(sessionId: string): Promise<CreatorPlanCheckoutSessionStatusResponse>;
-    createCreatorPlanChangeSession(tier: Exclude<CreatorPlanTier, 'BASIC'>, request?: {
-        nextPath?: string;
-    }): Promise<CreatorPlanPortalSessionResponse>;
-    createCreatorPlanPortalSession(request?: {
-        nextPath?: string;
-    }): Promise<CreatorPlanPortalSessionResponse>;
+    createCreatorPlanChangeSession(tier: Exclude<CreatorPlanTier, 'BASIC'>, request: CreatorPlanSessionRequest): Promise<CreatorPlanPortalSessionResponse>;
+    createCreatorPlanPortalSession(request: CreatorPlanSessionRequest): Promise<CreatorPlanPortalSessionResponse>;
     reconcileCreatorPlanSubscription(): Promise<{
         creatorPlan: CreatorPlanState;
     }>;
@@ -574,7 +569,7 @@ export interface ApiClient {
     setSelectedProfileAsset(request: SetProfileAssetRequest): Promise<SetProfileAssetResponse>;
     fetchHome(options?: FetchHomeOptions): Promise<HomeResponse>;
     fetchHomeGamesCollectionPage(collectionId: string, options?: Pick<AppBrowseRequest, 'limit' | 'offset' | 'auth' | 'controller' | 'controllerCompatible' | 'surface'>): Promise<HomeCollectionPageResponse>;
-    fetchUsers(): Promise<UsersListResponse>;
+    fetchUsers(options?: FetchAdminUsersOptions): Promise<UsersListResponse>;
     fetchAdminCreatorSubscriptions(): Promise<AdminCreatorSubscriptionsResponse>;
     createAdminCreatorPlanGrant(userId: number, request: CreateCreatorPlanGrantRequest): Promise<CreatorPlanGrantMutationResponse>;
     revokeAdminCreatorPlanGrant(userId: number, grantId: number): Promise<CreatorPlanGrantMutationResponse>;