@playdrop/playdrop-cli 0.15.5 → 0.15.9

package/config/client-meta.json

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

package/dist/apps/index.d.ts

@@ -25,7 +25,6 @@ export type AppPipelineOptions = {
     ensureRegisteredAppShell?: boolean;
     agentTaskId?: number;
     playtestProof?: AgentTaskPlaytestProof;
-    mediaCaptureRequired?: boolean;
     playtestSmokeCheckRequired?: boolean;
     captureSession?: TaskCaptureSession | null;
     artifacts?: AppBuildArtifacts;

package/dist/apps/index.js

@@ -66,7 +66,6 @@ async function runAppPipeline(client, task, options) {
         loadCheckTimeoutMs: options?.loadCheckTimeoutMs,
         agentTaskId: options?.agentTaskId,
         playtestProof: options?.playtestProof,
-        mediaCaptureRequired: options?.mediaCaptureRequired,
         playtestSmokeCheckRequired: options?.playtestSmokeCheckRequired,
         captureSession: options?.captureSession,
     };

package/dist/apps/loadCheck.d.ts

@@ -38,7 +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 formatHostedLoadCheckFailure(taskName: string, result: HostedLoadCheckResult, scope?: 'local' | 'staged' | 'final'): string;
+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: {
     client: ApiClient;
@@ -71,6 +71,7 @@ export declare function runUploadedHostedLoadCheck(input: {
     gameFrameScreenshotPath?: string | null;
     playtestTape?: AppPlaytestTape;
     postReadyWaitMs?: number;
+    phase?: 'play' | 'editor';
 }): Promise<HostedLoadCheckResult>;
 export declare function comparePlaytestFrames(firstPath: string, secondPath: string, thresholds?: {
     meanDeltaMin: number;

package/dist/apps/loadCheck.js

@@ -489,9 +489,11 @@ function normalizeLoadCheckFailure(error, artifactFingerprint) {
 function formatHostedLoadCheckFailure(taskName, result, scope = 'local') {
     const scopeLabel = scope === 'final'
         ? 'final owner play route'
-        : scope === 'staged'
-            ? 'staged upload preview'
-            : 'local hosted preview';
+        : scope === 'editor'
+            ? 'staged Editor phase'
+            : scope === 'staged'
+                ? 'staged upload preview'
+                : 'local hosted preview';
     const errorCode = result.errorCode?.trim() || 'startup_failure';
     const message = normalizeLoadCheckMessage(result.message);
     return `hosted_load_check_failed: ${taskName} failed the ${scopeLabel} check (${errorCode}). ${message}`;
@@ -917,6 +919,12 @@ function appendLoadCheckParams(targetUrl, devAuth) {
 }
 async function runUploadedHostedLoadCheck(input) {
     const preview = await input.client.fetchAppUploadLaunchCheckPreview(input.creatorUsername, input.task.name, input.sessionId);
+    const withRequestedPhase = (rawUrl) => {
+        const url = new URL(rawUrl);
+        if (input.phase === 'editor')
+            url.searchParams.set('hostPhase', 'editor');
+        return url.toString();
+    };
     const captureSurface = resolveLoadCheckSurface(preview.localAppMetadata.surfaceTargets, input.task.primarySurface);
     const contextOptions = cloneLoadCheckContextOptions(captureSurface);
     const anonymousExpectedState = resolveAnonymousHostedLaunchState({
@@ -925,7 +933,7 @@ async function runUploadedHostedLoadCheck(input) {
     });
     let result;
     if (input.captureSession) {
-        const targetUrl = new URL(preview.launchUrl);
+        const targetUrl = new URL(withRequestedPhase(preview.launchUrl));
         (0, appUrls_1.appendTaskCaptureSession)(targetUrl, input.captureSession);
         result = await runHostedLoadCheck({
             targetUrl: targetUrl.toString(),
@@ -947,7 +955,7 @@ async function runUploadedHostedLoadCheck(input) {
         }
         else {
             const anonymousGateResult = await runHostedLoadCheck({
-                targetUrl: appendLoadCheckParams(preview.launchUrl, 'anonymous'),
+                targetUrl: withRequestedPhase(appendLoadCheckParams(preview.launchUrl, 'anonymous')),
                 artifactFingerprint: preview.session.manifestHash,
                 timeoutMs: input.timeoutMs,
                 expectedHostedLaunchState: anonymousExpectedState,
@@ -958,7 +966,7 @@ async function runUploadedHostedLoadCheck(input) {
             }
             else {
                 result = await runHostedLoadCheck({
-                    targetUrl: appendLoadCheckParams(preview.launchUrl, 'viewer'),
+                    targetUrl: withRequestedPhase(appendLoadCheckParams(preview.launchUrl, 'viewer')),
                     artifactFingerprint: preview.session.manifestHash,
                     timeoutMs: input.timeoutMs,
                     expectedHostedLaunchState: resolvePostAuthHostedLaunchState(preview.localAppMetadata.controllerMode),
@@ -978,7 +986,7 @@ async function runUploadedHostedLoadCheck(input) {
     }
     else {
         result = await runHostedLoadCheck({
-            targetUrl: appendLoadCheckParams(preview.launchUrl, 'anonymous'),
+            targetUrl: withRequestedPhase(appendLoadCheckParams(preview.launchUrl, 'anonymous')),
             artifactFingerprint: preview.session.manifestHash,
             timeoutMs: input.timeoutMs,
             expectedHostedLaunchState: anonymousExpectedState,

package/dist/apps/staticHtml.js

@@ -257,6 +257,7 @@ function buildStaticAppTask(input) {
         hostingMode: 'HOSTED',
         authMode: 'NONE',
         previewable: true,
+        editorSupported: false,
         ...(buildListing(input.metadata.imagePath, input.primarySurface)
             ? { listing: buildListing(input.metadata.imagePath, input.primarySurface) }
             : {}),

package/dist/apps/upload.d.ts

@@ -22,7 +22,6 @@ export type AppUploadOptions = {
     loadCheckTimeoutMs?: number;
     agentTaskId?: number;
     playtestProof?: AgentTaskPlaytestProof;
-    mediaCaptureRequired?: boolean;
     playtestSmokeCheckRequired?: boolean;
     captureSession?: TaskCaptureSession | null;
 };

package/dist/apps/upload.js

@@ -8,7 +8,6 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const http_1 = require("../http");
 const loadCheck_1 = require("./loadCheck");
-const listingPreflight_1 = require("../listingPreflight");
 const EXTENSION_TO_MIME = {
     '.png': 'image/png',
     '.jpg': 'image/jpeg',
@@ -259,6 +258,7 @@ async function uploadAppVersion(client, task, artifacts, options) {
         authMode: task.authMode,
         controllerMode: task.controllerMode,
         previewable: task.previewable,
+        editorSupported: task.editorSupported,
         skipReview: options?.skipReview,
         displayName: task.displayName,
         subtitle: task.subtitle,
@@ -346,15 +346,6 @@ async function uploadAppVersion(client, task, artifacts, options) {
                     })),
                 });
             }
-            if (options?.mediaCaptureRequired === true
-                && task.hostingMode !== 'EXTERNAL'
-                && !task.externalUrl) {
-                const mediaCaptureProof = (0, listingPreflight_1.readMediaCaptureProof)({
-                    task,
-                    preparedSessionFiles,
-                });
-                await client.recordAppUploadMediaCapture(creatorUsername, task.name, sessionId, mediaCaptureProof);
-            }
             if (task.hostingMode !== 'EXTERNAL'
                 && !task.externalUrl
                 && options?.playtestSmokeCheckRequired) {
@@ -363,7 +354,7 @@ async function uploadAppVersion(client, task, artifacts, options) {
                     creatorUsername,
                     task,
                     sessionId,
-                    timeoutMs: options.loadCheckTimeoutMs,
+                    timeoutMs: options?.loadCheckTimeoutMs,
                     token: options?.token ?? null,
                     currentUser: options?.user ?? null,
                     captureSession: options?.captureSession,
@@ -377,7 +368,7 @@ async function uploadAppVersion(client, task, artifacts, options) {
                     creatorUsername,
                     task,
                     sessionId,
-                    timeoutMs: options.loadCheckTimeoutMs,
+                    timeoutMs: options?.loadCheckTimeoutMs,
                     token: options?.token ?? null,
                     currentUser: options?.user ?? null,
                     captureSession: options?.captureSession,
@@ -386,6 +377,22 @@ async function uploadAppVersion(client, task, artifacts, options) {
                     throw new Error((0, loadCheck_1.formatHostedLoadCheckFailure)(task.name, loadCheck, 'staged'));
                 }
             }
+            if (task.editorSupported && task.hostingMode !== 'EXTERNAL' && !task.externalUrl) {
+                const editorLoadCheck = await (0, loadCheck_1.runUploadedHostedLoadCheck)({
+                    client,
+                    creatorUsername,
+                    task,
+                    sessionId,
+                    timeoutMs: options?.loadCheckTimeoutMs,
+                    token: options?.token ?? null,
+                    currentUser: options?.user ?? null,
+                    captureSession: options?.captureSession,
+                    phase: 'editor',
+                });
+                if (editorLoadCheck.status !== 'PASSED') {
+                    throw new Error((0, loadCheck_1.formatHostedLoadCheckFailure)(task.name, editorLoadCheck, 'editor'));
+                }
+            }
         }
         const finalized = initialized.status === 'finalized'
             ? initialized.finalized

package/dist/catalogue.d.ts

@@ -63,6 +63,7 @@ export type AppCatalogueEntry = {
     authMode?: string;
     controllerMode?: string;
     previewable?: boolean;
+    editorSupported?: boolean;
     externalUrl?: string;
     listing?: AppListingConfig;
     username?: string;
@@ -210,6 +211,7 @@ export type AppTask = {
     authMode?: AppAuthMode;
     controllerMode?: AppControllerMode;
     previewable?: boolean;
+    editorSupported?: boolean;
     externalUrl?: string;
     listing?: ResolvedListingAssets;
     username?: string;
@@ -368,6 +370,7 @@ export type ValidatedAppMetadata = {
     surfaceTargetMap: SurfaceTargetsMap;
     primarySurface?: AppSurface;
     playtestTapes?: AppPlaytestTapes;
+    editorSupported?: boolean;
     missingFields: string[];
     warnings: string[];
     errors: string[];

package/dist/catalogue.js

@@ -948,6 +948,18 @@ function validateAppMetadata(entry) {
             warnings.push(`description is ${normalizedDescription.length} characters and ${wordCount} words. Aim for at least ${exports.APP_DESCRIPTION_RECOMMENDED_MIN_CHARACTERS} characters and ${exports.APP_DESCRIPTION_RECOMMENDED_MIN_WORDS} words describing what the player does, the objective, and the game's distinctive hook.`);
         }
     }
+    let editorSupported;
+    if (Object.prototype.hasOwnProperty.call(entry, 'editorSupported')) {
+        if (typeof entry.editorSupported !== 'boolean') {
+            errors.push('editorSupported must be true or false');
+        }
+        else {
+            editorSupported = entry.editorSupported;
+            if (editorSupported && entry.hostingMode === 'EXTERNAL') {
+                errors.push('editorSupported can only be true for HOSTED apps, not external apps');
+            }
+        }
+    }
     let surfaceTargetsList = [];
     let surfaceTargetsMap = { desktop: false, mobileLandscape: false, mobilePortrait: false };
     try {
@@ -992,6 +1004,7 @@ function validateAppMetadata(entry) {
         surfaceTargetMap: surfaceTargetsMap,
         primarySurface,
         playtestTapes,
+        editorSupported,
         missingFields,
         warnings,
         errors,
@@ -1204,6 +1217,14 @@ function buildAppTasks(rootDir, catalogues, options) {
                 }
                 previewable = Boolean(entry.previewable);
             }
+            let editorSupported;
+            if (Object.prototype.hasOwnProperty.call(entry, 'editorSupported')) {
+                if (typeof entry.editorSupported !== 'boolean') {
+                    errors.push(`[${label}] Skipping ${rawName}: editorSupported must be true or false.`);
+                    continue;
+                }
+                editorSupported = Boolean(entry.editorSupported);
+            }
             let externalUrl;
             const rawExternalUrl = typeof entry.externalUrl === 'string' ? entry.externalUrl.trim() : '';
             if (rawExternalUrl) {
@@ -1226,6 +1247,10 @@ function buildAppTasks(rootDir, catalogues, options) {
                 errors.push(`[${label}] Skipping ${rawName}: previewable can only be true for HOSTED apps.`);
                 continue;
             }
+            if ((hostingMode ?? 'HOSTED') === 'EXTERNAL' && editorSupported) {
+                errors.push(`[${label}] Skipping ${rawName}: editorSupported can only be true for HOSTED apps.`);
+                continue;
+            }
             const defaultLicense = (hostingMode ?? 'HOSTED') === 'EXTERNAL' ? 'CLOSED' : types_1.DEFAULT_CONTENT_LICENSE;
             const license = normalizeContentLicenseValue(entry.license, errors, `${label} app "${rawName}"`, APP_ALLOWED_LICENSES, defaultLicense);
             if (!license) {
@@ -1600,6 +1625,7 @@ function buildAppTasks(rootDir, catalogues, options) {
                 authMode,
                 controllerMode,
                 previewable,
+                editorSupported,
                 externalUrl,
                 listing,
                 // Admin-only field

package/dist/commands/create.js

@@ -20,6 +20,7 @@ const catalogue_utils_1 = require("../catalogue-utils");
 const clientInfo_1 = require("../clientInfo");
 const commandContext_1 = require("../commandContext");
 const http_1 = require("../http");
+const listingPreflight_1 = require("../listingPreflight");
 const messages_1 = require("../messages");
 const loadCheck_1 = require("../apps/loadCheck");
 const devShared_1 = require("./devShared");
@@ -252,6 +253,28 @@ function makeDefaultAssetSpecEntry(name) {
         visibility: 'PUBLIC',
     };
 }
+function resolveTaskScaffoldOutputVersion(startDir = process.cwd()) {
+    const context = (0, listingPreflight_1.readWorkerUploadPreflightContext)(startDir);
+    if (!context || (context.kind !== 'NEW_GAME' && context.kind !== 'REMIX_GAME')) {
+        return null;
+    }
+    if (!context.outputVersion) {
+        throw new Error('agent_task_output_version_missing: task.metadata.playdrop.output.version is required when scaffolding a game task.');
+    }
+    return context.outputVersion;
+}
+function forceScaffoldedCatalogueVersion(cataloguePath, appName, outputVersion) {
+    const parsed = readCatalogue(cataloguePath);
+    if (!parsed || !Array.isArray(parsed.apps)) {
+        throw new Error(`agent_task_scaffold_catalogue_invalid: ${cataloguePath} must contain an apps array.`);
+    }
+    const app = parsed.apps.find((entry) => entry?.name === appName);
+    if (!app) {
+        throw new Error(`agent_task_scaffold_app_missing: ${cataloguePath} must contain app "${appName}".`);
+    }
+    app.version = outputVersion;
+    (0, node_fs_1.writeFileSync)(cataloguePath, `${JSON.stringify(parsed, null, 2)}\n`);
+}
 function buildCatalogueEntry(name, metadata, sourceInfo, relativeFilePath) {
     const entry = makeDefaultAppEntry(name, relativeFilePath);
     if (!metadata) {
@@ -1133,8 +1156,10 @@ async function create(name, options = {}) {
     if (!ctx) {
         return;
     }
-    const envName = ctx.env;
     const currentDir = process.cwd();
+    const taskScaffoldOutputVersion = !reuseExistingApp
+        ? resolveTaskScaffoldOutputVersion(currentDir)
+        : null;
     const localCataloguePath = (0, node_path_1.resolve)(currentDir, CATALOGUE_FILENAME);
     let initSummary = null;
     let workspaceCatalogueResult = null;
@@ -1365,6 +1390,21 @@ async function create(name, options = {}) {
             return;
         }
     }
+    if (taskScaffoldOutputVersion) {
+        const scaffoldedCataloguePaths = new Set();
+        if (projectCatalogueResult?.updated) {
+            scaffoldedCataloguePaths.add((0, node_path_1.resolve)(projectCatalogueResult.path));
+        }
+        if (workspaceCatalogueResult && workspaceCatalogueUpdateSucceeded) {
+            scaffoldedCataloguePaths.add((0, node_path_1.resolve)(workspaceCatalogueResult.path));
+        }
+        if (scaffoldedCataloguePaths.size === 0) {
+            throw new Error('agent_task_scaffold_catalogue_missing: scaffolding did not produce a catalogue to version.');
+        }
+        for (const scaffoldedCataloguePath of scaffoldedCataloguePaths) {
+            forceScaffoldedCatalogueVersion(scaffoldedCataloguePath, name, taskScaffoldOutputVersion);
+        }
+    }
     let registrationTask = null;
     if (reuseExistingApp && existingTask) {
         registrationTask = existingTask;
@@ -1455,6 +1495,7 @@ async function create(name, options = {}) {
             name,
             displayName,
             ...(Number.isInteger(taskId) && Number(taskId) > 0 ? { agentTaskId: Number(taskId) } : {}),
+            ...(sourceInfo.remixRef ? { remixRef: sourceInfo.remixRef } : {}),
         };
         let creatorUsername = '';
         try {
@@ -1487,7 +1528,6 @@ async function create(name, options = {}) {
             }
             throw error;
         }
-        let createConflict = false;
         try {
             await client.createApp(creatorUsername, createPayload);
             console.log(`Registered ${displayName} with the Playdrop API.`);
@@ -1503,17 +1543,9 @@ async function create(name, options = {}) {
                 return;
             }
             if (error instanceof types_1.ApiError) {
-                if (error.status === 409) {
-                    createConflict = true;
-                    console.log(`ℹ️ App ${name} already exists on ${envName}. Updating metadata from the local catalogue.`);
-                }
-                else {
-                    (0, messages_1.printErrorWithHelp)(`Failed to register ${name} (status ${error.status}).`, [
-                        'Ensure your account has creator permissions and retry once the issue is resolved.'
-                    ], { command: 'project create app' });
-                    process.exitCode = 1;
-                    return;
-                }
+                (0, messages_1.printErrorWithHelp)(`Failed to register ${name} (status ${error.status}: ${error.code}).`, ['Resolve the API error, then retry the same project create command.'], { command: 'project create app' });
+                process.exitCode = 1;
+                return;
             }
             else if (error instanceof TypeError) {
                 (0, messages_1.printNetworkIssue)('Could not reach the Playdrop API to register the app.', 'project create app');
@@ -1535,9 +1567,6 @@ async function create(name, options = {}) {
         if (Object.keys(updatePayload).length > 0) {
             try {
                 await client.updateApp(creatorUsername, name, updatePayload);
-                if (createConflict) {
-                    console.log(`Updated ${name} metadata on the Playdrop API.`);
-                }
             }
             catch (error) {
                 if (error instanceof http_1.CLIUnsupportedClientError) {

package/dist/commands/devRuntimeAssets.d.ts

@@ -12,6 +12,7 @@ export type LocalDevAppMetadata = {
     authMode: AppAuthMode;
     controllerMode: AppControllerMode;
     previewable: boolean;
+    editorSupported: boolean;
     assetSpecSupport: AppMetadataAssetSpecSupport[];
     version: string | null;
     tweakValues?: TweakValues;

package/dist/commands/devRuntimeAssets.js

@@ -20,6 +20,7 @@ function createEmptyDevRuntimeAssetManifest() {
                 authMode: types_1.DEFAULT_APP_AUTH_MODE,
                 controllerMode: types_1.DEFAULT_APP_CONTROLLER_MODE,
                 previewable: types_1.DEFAULT_APP_PREVIEWABLE,
+                editorSupported: false,
                 assetSpecSupport: [],
                 version: null,
             },
@@ -118,6 +119,7 @@ function buildLocalAppMetadata(task) {
         authMode: task.authMode ?? types_1.DEFAULT_APP_AUTH_MODE,
         controllerMode: task.controllerMode ?? types_1.DEFAULT_APP_CONTROLLER_MODE,
         previewable: task.previewable ?? types_1.DEFAULT_APP_PREVIEWABLE,
+        editorSupported: task.editorSupported ?? false,
         assetSpecSupport: task.assetSpecSupport.map((entry) => ({
             assetSpecRef: entry.assetSpec,
             versionRange: entry.versionRange,

package/dist/commands/review.js

@@ -87,9 +87,6 @@ function normalizeReviewText(...values) {
         .trim();
 }
 function parseScores(reviewMessage) {
-    if (/\/5\b/.test(reviewMessage)) {
-        throw new Error('review_scores_must_use_10_point_scale');
-    }
     const scores = {};
     for (const criterion of exports.REVIEW_CRITERIA) {
         const escaped = criterion.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');

package/dist/commands/upload.d.ts

@@ -51,6 +51,7 @@ export type StaticHtmlPublishInput = {
     taskToken?: string;
     claimedAppName?: string | null;
     devRouterPort?: number;
+    skipReview?: boolean;
 };
 export type StaticHtmlPublishResult = WorkerAppPublishResult & {
     sourceHash: string;
@@ -62,12 +63,10 @@ export type StaticHtmlPublishResult = WorkerAppPublishResult & {
 };
 export declare function assertAgentPrimarySurfaceContract(task: AppTask, kind: 'NEW_GAME' | 'REMIX_GAME' | 'GAME_UPDATE'): void;
 export declare function assertAgentNewGamePlaytestContract(task: AppTask): void;
+export declare function assertAgentNewGameListingIdentity(task: AppTask): void;
 export declare function assertWorkerAppLocalUploadPreflight(input: {
     task: AppTask;
     kind: 'NEW_GAME' | 'REMIX_GAME' | 'GAME_UPDATE';
-    executionTarget?: AgentExecutionTarget;
-    stage?: 'PRE_CAPTURE' | 'COMPLETE';
-    expectedRuntimeBundleHash?: string;
 }): Promise<void>;
 export type WorkerAppPreflightResult = {
     appName: string;

package/dist/commands/upload.js

@@ -5,6 +5,7 @@ exports.resolveDefaultUploadCreator = resolveDefaultUploadCreator;
 exports.upload = upload;
 exports.assertAgentPrimarySurfaceContract = assertAgentPrimarySurfaceContract;
 exports.assertAgentNewGamePlaytestContract = assertAgentNewGamePlaytestContract;
+exports.assertAgentNewGameListingIdentity = assertAgentNewGameListingIdentity;
 exports.assertWorkerAppLocalUploadPreflight = assertWorkerAppLocalUploadPreflight;
 exports.preflightWorkerAppProject = preflightWorkerAppProject;
 exports.publishWorkerAppProject = publishWorkerAppProject;
@@ -28,7 +29,6 @@ const workerAppProject_1 = require("../workerAppProject");
 const upload_content_1 = require("./upload-content");
 const appUrls_1 = require("../appUrls");
 const ownedRuntimeImageValidation_1 = require("./ownedRuntimeImageValidation");
-const listingPreflight_1 = require("../listingPreflight");
 const upload_graph_1 = require("./upload-graph");
 function normalizeSavedItemKinds(kinds) {
     return [...new Set(Array.isArray(kinds) ? kinds : [])].sort();
@@ -841,7 +841,6 @@ function appendTaskRelations(graphState, fromNodeId, relations, contextLabel) {
     });
 }
 async function uploadAppTask(state, task, taskCreator, options) {
-    (0, listingPreflight_1.assertProjectListingPreflight)(task);
     const { upload, warnings } = await (0, apps_1.runAppPipeline)(state.client, task, {
         skipReview: options?.skipReview,
         clearTags: options?.clearTags,
@@ -1266,6 +1265,18 @@ function assertAgentNewGamePlaytestContract(task) {
         }
     }
 }
+function assertAgentNewGameListingIdentity(task) {
+    const missing = [];
+    if (!task.listing?.iconPath)
+        missing.push('listing.icon');
+    if (!task.listing?.heroPortraitPath)
+        missing.push('listing.hero.portrait');
+    if (!task.listing?.heroLandscapePath)
+        missing.push('listing.hero.landscape');
+    if (missing.length > 0) {
+        throw new Error(`agent_task_listing_identity_required: NEW_GAME catalogue.json must provide ${missing.join(', ')}.`);
+    }
+}
 async function collectUploadPreflightErrors(checks) {
     const errors = [];
     for (const check of checks) {
@@ -1291,42 +1302,15 @@ function assertAgentTaskReleaseNotes(task) {
     }
 }
 async function assertWorkerAppLocalUploadPreflight(input) {
-    const complete = input.stage !== 'PRE_CAPTURE';
-    const existingCaptureReport = input.task.listing?.captureReportPath;
-    const shouldCheckExistingCapture = !complete
-        && Boolean(existingCaptureReport)
-        && (0, node_fs_1.existsSync)(existingCaptureReport);
     const errors = await collectUploadPreflightErrors([
         () => assertAgentTaskReleaseNotes(input.task),
-        ...(complete
+        ...(input.kind === 'NEW_GAME'
             ? [
-                () => (0, listingPreflight_1.assertAgentGameIconListingPreflight)(input.task),
-                () => (0, listingPreflight_1.assertAgentGameHeroListingPreflight)(input.task),
-                () => (0, listingPreflight_1.assertAgentGamePreviewListingPreflight)(input.task),
-                () => (0, listingPreflight_1.assertAgentGameVideoListingPreflight)(input.task),
+                () => assertAgentNewGamePlaytestContract(input.task),
+                () => assertAgentNewGameListingIdentity(input.task),
             ]
-            : []),
-        ...(input.kind === 'NEW_GAME'
-            ? [() => assertAgentNewGamePlaytestContract(input.task)]
             : [() => assertAgentPrimarySurfaceContract(input.task, input.kind)]),
         () => (0, ownedRuntimeImageValidation_1.assertOwnedRuntimeImagesAreValid)(input.task),
-        ...(complete
-            ? [
-                () => (0, listingPreflight_1.assertAgentGameScreenshotListingPreflight)(input.task),
-                () => (0, listingPreflight_1.assertAgentGameCaptureReportPreflight)(input.task, {
-                    requireCaptureReport: input.executionTarget === 'FIRST_PARTY',
-                    expectedRuntimeBundleHash: input.expectedRuntimeBundleHash,
-                }),
-            ]
-            : []),
-        ...(shouldCheckExistingCapture
-            ? [
-                () => (0, listingPreflight_1.assertAgentGameCaptureReportPreflight)(input.task, {
-                    requireCaptureReport: false,
-                    expectedRuntimeBundleHash: input.expectedRuntimeBundleHash,
-                }),
-            ]
-            : []),
     ]);
     if (errors.length === 1) {
         throw new Error(errors[0]);
@@ -1335,7 +1319,7 @@ async function assertWorkerAppLocalUploadPreflight(input) {
         throw new Error(`agent_task_upload_preflight_failed:\n${errors.map((error, index) => `${index + 1}. ${error}`).join('\n')}`);
     }
 }
-async function prepareWorkerAppProject(input, stage) {
+async function prepareWorkerAppProject(input) {
     const creatorUsername = input.creatorUsername.trim();
     if (!creatorUsername) {
         throw new Error('agent_task_creator_username_missing');
@@ -1390,9 +1374,6 @@ async function prepareWorkerAppProject(input, stage) {
     await assertWorkerAppLocalUploadPreflight({
         task,
         kind: input.kind,
-        executionTarget: input.executionTarget,
-        stage,
-        expectedRuntimeBundleHash: artifacts?.bundleHash,
     });
     return {
         task,
@@ -1401,11 +1382,11 @@ async function prepareWorkerAppProject(input, stage) {
         creatorUsername,
     };
 }
-// Runs every worker upload check that can be proven before final recorder
-// output exists. It intentionally performs no app registration, metadata
+// Runs every worker upload check without publishing. It intentionally performs
+// no app registration, metadata
 // update, upload-session creation, file upload, or version creation.
 async function preflightWorkerAppProject(input) {
-    const prepared = await prepareWorkerAppProject(input, 'PRE_CAPTURE');
+    const prepared = await prepareWorkerAppProject(input);
     return {
         appName: prepared.task.name,
         creatorUsername: prepared.creatorUsername,
@@ -1416,7 +1397,7 @@ async function preflightWorkerAppProject(input) {
 // "playdrop project publish", but always as one PRIVATE draft version for the
 // task's creator, with browser launch checks on before the version is created.
 async function publishWorkerAppProject(input) {
-    const prepared = await prepareWorkerAppProject(input, 'COMPLETE');
+    const prepared = await prepareWorkerAppProject(input);
     const { task, artifacts, creatorUsername } = prepared;
     const { app } = await (0, registration_1.ensureRegisteredHostedAppShell)({
         client: input.client,
@@ -1446,7 +1427,6 @@ async function publishWorkerAppProject(input) {
         runStagedUploadLoadCheck: true,
         ensureRegisteredAppShell: true,
         agentTaskId: input.taskId,
-        mediaCaptureRequired: input.executionTarget === 'FIRST_PARTY',
         playtestSmokeCheckRequired: input.kind === 'NEW_GAME',
         captureSession,
         ...(artifacts ? { artifacts } : {}),
@@ -1536,8 +1516,8 @@ async function publishStaticHtmlProject(input) {
             runStagedUploadLoadCheck: true,
             ensureRegisteredAppShell: true,
             agentTaskId: input.taskId,
-            mediaCaptureRequired: false,
             playtestSmokeCheckRequired: false,
+            skipReview: input.skipReview,
             captureSession,
             artifacts: prepared.artifacts,
         });

package/dist/commands/validate.js

@@ -212,12 +212,8 @@ async function validate(pathOrName, options = {}) {
                     await (0, upload_1.assertWorkerAppLocalUploadPreflight)({
                         task,
                         kind: workerContext.kind,
-                        executionTarget: workerContext.target,
                     });
                 }
-                else {
-                    (0, listingPreflight_1.assertProjectListingPreflight)(task);
-                }
                 await (0, apps_1.validateAppTask)(task);
                 (0, apps_1.collectAppValidationWarnings)(task, 'source').forEach((warning) => warnings.add(warning));
             }

package/dist/commands/worker.d.ts

@@ -1,11 +1,16 @@
 import type { ApiClient } from '@playdrop/api-client';
-import { type AgentAvailabilityFailureReason, type AgentExecutionTarget, type AgentRuntime, type AgentTaskKind, type AgentTaskNextStepSuggestion, type AgentTaskResponse, type AppSurface, type AgentWorkerCapabilities, type AgentWorkerResponse, type AgentWorkerUpdatePolicyResponse, type JsonValue, type WorkerTaskAssignmentV2, type WorkerTaskPluginV2, type WorkerClaimAgentTaskResponse } from '@playdrop/types';
+import { RELEASE_SMOKE_FILE_NAME, type AgentAvailabilityFailureReason, type AgentExecutionTarget, type AgentRuntime, type AgentTaskKind, type AgentTaskNextStepSuggestion, type AgentTaskResponse, type AppSurface, type AgentWorkerCapabilities, type AgentWorkerResponse, type AgentWorkerUpdatePolicyResponse, type JsonValue, type WorkerTaskAssignmentV2, type WorkerTaskPluginV2, type WorkerClaimAgentTaskResponse } from '@playdrop/types';
 import { loadConfig } from '../config';
 import { runShell } from '../shellProbe';
 import { type WorkerInstrumentSurface, type LoggedProcessResult, type LoggedProcessTranscriptChunk } from './worker/runtime';
 export { assertWorkerTokenUsageWithinCap, buildClaudeExecArgs, buildClaudePermissionSettings, buildCleanRoomChildEnv, buildCodexExecArgs, buildPlaywrightMcpCommand, buildWorkerChildEnv, DEFAULT_CODEX_TIMEOUT_MS, DEFAULT_CREATOR_AGENT_TIMEOUT_MS, DEFAULT_CREATOR_UPLOAD_RECOVERY_TIMEOUT_MS, DEFAULT_WORKER_TOKEN_CAP, extractAgentTokenUsage, extractCodexRolloutTokenUsage, extractClaudeSessionId, extractCodexThreadId, extractCodexTokensUsed, readCodexRolloutTokenUsageForThread, readCodexSandboxMode, readEnvBoolean, runLoggedProcess } from './worker/runtime';
 export type { AgentTokenUsage, LoggedProcessResult, LoggedProcessTranscriptChunk } from './worker/runtime';
 export declare function usesCreatorRecovery(kind: AgentTaskKind): boolean;
+export declare function buildDeterministicReleaseSmokeArtifact(): {
+    fileName: typeof RELEASE_SMOKE_FILE_NAME;
+    content: Buffer;
+    sha256: string;
+};
 export declare function buildCreatorRecoveryPrompt(input: {
     prompt: string;
     kind: AgentTaskKind;
@@ -204,6 +209,7 @@ export declare function prepareClaimedTaskWorkspace(input: {
 }): Promise<{
     resumed: boolean;
 }>;
+export declare function buildWorkerTaskContextV2(assignment: WorkerTaskAssignmentV2): Omit<WorkerTaskContextFile, 'env' | 'devPort'>;
 export declare function resolveWorkerInstrumentSurface(taskContext: Pick<WorkerTaskContextFile, 'kind' | 'metadata'>): WorkerInstrumentSurface | null;
 export declare function hasAgentTaskUploadedArtifact(task: Pick<AgentTaskResponse, 'appId' | 'appVersionId'>): boolean;
 export declare function appendWorkerTranscriptChunks(input: {