@playdrop/playdrop-cli 0.13.17 → 0.14.0

package/config/client-meta.json

@@ -1,7 +1,7 @@
 {
-  "version": "0.13.17",
+  "version": "0.14.0",
   "build": 1,
-  "runtimeSdkVersion": "0.13.17",
+  "runtimeSdkVersion": "0.14.0",
   "runtimeSdkBuild": 1,
   "clients": {
     "all": {

package/dist/commands/captureListing.d.ts

@@ -44,6 +44,10 @@ type HostedGameMeasurement = {
     devicePixelRatio: number;
     iframeRect: CaptureRect;
 };
+type BrowserWindowBounds = {
+    width: number;
+    height: number;
+};
 type CropRect = {
     x: number;
     y: number;
@@ -141,8 +145,13 @@ export declare function resolveListingCaptureBrowserContextOptions(surface: AppS
     height: number;
 }): BrowserContextOptions;
 export declare function assertExportedListingAudio(value: unknown): ExportedListingAudio;
+export declare function assertListingCaptureWindowCanContainViewport(measurement: HostedGameMeasurement, windowBounds: BrowserWindowBounds): void;
 export declare function computeRecordedCrop(measurement: HostedGameMeasurement, recorder: ListingRecorderMetadata, rawWidth: number, rawHeight: number): CropRect;
 export declare function runListingRecorder(recorderPath: string, pid: number, durationSeconds: number, rawOutputPath: string, metadataPath: string, audio: boolean, deadlineAt: number): Promise<ListingRecorderMetadata>;
+export declare function formatCommandError(error: Error): {
+    message: string;
+    suggestions: string[];
+};
 export declare function captureCommandMatchesExceptPoster(capture: ListingCaptureSurfaceReport, surface: AppSurface, parsedOptions: ParsedCaptureListingOptions): boolean;
 export declare function resolveCurrentCaptureReuseAction(captures: ListingCaptureSurfaceReport[], surfaces: AppSurface[], parsedOptions: ParsedCaptureListingOptions): 'reuse' | 'refresh_poster';
 export declare function captureListing(targetArg: string | undefined, options?: CaptureListingOptions): Promise<void>;

package/dist/commands/captureListing.js

@@ -47,8 +47,10 @@ exports.resolveWorkerCaptureOutputDir = resolveWorkerCaptureOutputDir;
 exports.resolveCaptureDimensions = resolveCaptureDimensions;
 exports.resolveListingCaptureBrowserContextOptions = resolveListingCaptureBrowserContextOptions;
 exports.assertExportedListingAudio = assertExportedListingAudio;
+exports.assertListingCaptureWindowCanContainViewport = assertListingCaptureWindowCanContainViewport;
 exports.computeRecordedCrop = computeRecordedCrop;
 exports.runListingRecorder = runListingRecorder;
+exports.formatCommandError = formatCommandError;
 exports.captureCommandMatchesExceptPoster = captureCommandMatchesExceptPoster;
 exports.resolveCurrentCaptureReuseAction = resolveCurrentCaptureReuseAction;
 exports.captureListing = captureListing;
@@ -501,11 +503,6 @@ async function fitWindowToRequestedGameplay(page, requestedWidth, requestedHeigh
     const cdpSession = await page.context().newCDPSession(page);
     let measurement = await waitForHostedGameMeasurement(page, 15000);
     for (let attempt = 0; attempt < 5; attempt += 1) {
-        const deltaWidth = requestedWidth - Math.round(measurement.iframeRect.width);
-        const deltaHeight = requestedHeight - Math.round(measurement.iframeRect.height);
-        if (Math.abs(deltaWidth) <= 1 && Math.abs(deltaHeight) <= 1) {
-            return measurement;
-        }
         const windowState = await cdpSession.send('Browser.getWindowForTarget');
         const currentWidth = typeof windowState.bounds.width === 'number'
             ? windowState.bounds.width
@@ -513,6 +510,15 @@ async function fitWindowToRequestedGameplay(page, requestedWidth, requestedHeigh
         const currentHeight = typeof windowState.bounds.height === 'number'
             ? windowState.bounds.height
             : Math.round(measurement.outerHeight);
+        const deltaWidth = requestedWidth - Math.round(measurement.iframeRect.width);
+        const deltaHeight = requestedHeight - Math.round(measurement.iframeRect.height);
+        if (Math.abs(deltaWidth) <= 1 && Math.abs(deltaHeight) <= 1) {
+            assertListingCaptureWindowCanContainViewport(measurement, {
+                width: currentWidth,
+                height: currentHeight,
+            });
+            return measurement;
+        }
         const nextWidth = Math.max(400, currentWidth + deltaWidth);
         const nextHeight = Math.max(300, currentHeight + deltaHeight);
         await cdpSession.send('Browser.setWindowBounds', {
@@ -527,6 +533,15 @@ async function fitWindowToRequestedGameplay(page, requestedWidth, requestedHeigh
     }
     throw new Error('hosted_game_resize_failed');
 }
+function assertListingCaptureWindowCanContainViewport(measurement, windowBounds) {
+    const requiredWidth = Math.ceil(measurement.innerWidth);
+    const requiredHeight = Math.ceil(measurement.innerHeight);
+    const availableWidth = Math.floor(windowBounds.width);
+    const availableHeight = Math.floor(windowBounds.height);
+    if (availableWidth + 1 < requiredWidth || availableHeight + 1 < requiredHeight) {
+        throw new Error(`listing_capture_dimensions_exceed_display:${requiredWidth}x${requiredHeight}:${availableWidth}x${availableHeight}`);
+    }
+}
 function roundCropValue(value) {
     return Math.round(value);
 }
@@ -726,6 +741,13 @@ function formatCommandError(error) {
             suggestions: ['Fix or remove the incomplete canonical capture directory, then record the runtime once.'],
         };
     }
+    if (error.message.startsWith('listing_capture_dimensions_exceed_display:')) {
+        const [, requested = 'unknown', available = 'unknown'] = error.message.split(':');
+        return {
+            message: `Requested capture size ${requested} cannot fit in this worker's ${available} browser window.`,
+            suggestions: ['Omit --width and --height to use the safe surface defaults, or request dimensions that fit this display.'],
+        };
+    }
     if (error.message.startsWith('listing_recorder_failed:')) {
         return {
             message: error.message.slice('listing_recorder_failed:'.length),
@@ -1195,14 +1217,14 @@ async function captureListing(targetArg, options = {}) {
                         await prepareHostedListingScene(browserHandle.page, captureSceneId);
                         await browserHandle.page.waitForTimeout(1000);
                     }
+                    const measurement = await fitWindowToRequestedGameplay(browserHandle.page, dimensions.width, dimensions.height);
+                    console.log(`[listing] Gameplay frame ${Math.round(measurement.iframeRect.width)}x${Math.round(measurement.iframeRect.height)} in window ${Math.round(measurement.outerWidth)}x${Math.round(measurement.outerHeight)}.`);
                     if (shouldExportPreviewAudio) {
                         console.log('[listing] Checking the in-app preview audio export contract.');
                         await assertHostedListingAudioCaptureContract(browserHandle.page, outputPaths.outputDir);
                         console.log('[listing] Starting in-app preview audio capture.');
                         await startHostedListingAudioCapture(browserHandle.page);
                     }
-                    const measurement = await fitWindowToRequestedGameplay(browserHandle.page, dimensions.width, dimensions.height);
-                    console.log(`[listing] Gameplay frame ${Math.round(measurement.iframeRect.width)}x${Math.round(measurement.iframeRect.height)} in window ${Math.round(measurement.outerWidth)}x${Math.round(measurement.outerHeight)}.`);
                     await browserHandle.page.waitForTimeout(750);
                     console.log('[listing] Waiting for the machine capture lease.');
                     const captureLease = await (0, listingCaptureLease_1.acquireListingCaptureLease)({

package/dist/commands/worker.js

@@ -2584,7 +2584,8 @@ function buildAgentFailureCode(agent, result, request) {
     if (providerStatus === 529 || (/\b529\b/.test(combinedOutput) && /\boverloaded?\b/i.test(combinedOutput))) {
         return `agent_provider_overloaded:${provider}:529`;
     }
-    if (/\boverloaded?\b/i.test(combinedOutput)) {
+    if (/\boverloaded?\b/i.test(combinedOutput)
+        || /\b(?:selected\s+)?model\s+is\s+at\s+capacity\b/i.test(combinedOutput)) {
         return `agent_provider_overloaded:${provider}`;
     }
     if (providerStatus === 429
@@ -5427,7 +5428,10 @@ async function materialTask(options) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        console.warn(`Warning: task material was not shared: ${message}`);
+        const suggestion = message.startsWith('task_material_asset_background_not_removed:')
+            ? ' Remove the background and retry with --asset, or omit --asset if the image is honestly useful as a full frame.'
+            : '';
+        console.warn(`Warning: task material was not shared: ${message}.${suggestion}`);
         node_process_1.default.exitCode = 0;
     }
 }

package/dist/listingPreflight.js

@@ -117,13 +117,13 @@ function assertListingScreenshots(task) {
     const portraitPaths = task.listing?.screenshotPortraitPaths ?? [];
     const landscapePaths = task.listing?.screenshotLandscapePaths ?? [];
     if (portraitPaths.length === 0 && landscapePaths.length === 0) {
-        throw new Error('agent_task_listing_screenshots_missing: new game tasks must include listing.screenshotsPortrait and/or listing.screenshotsLandscape PNG captures.');
+        throw new Error('agent_task_listing_screenshots_missing: new game tasks must include listing.screenshotsPortrait and/or listing.screenshotsLandscape PNG marketing images.');
     }
     if (task.surfaceTargets.includes('MOBILE_PORTRAIT') && portraitPaths.length === 0) {
-        throw new Error('agent_task_listing_screenshots_missing: mobile portrait games must include at least one listing.screenshotsPortrait PNG capture.');
+        throw new Error('agent_task_listing_screenshots_missing: mobile portrait games must include at least one listing.screenshotsPortrait PNG marketing image.');
     }
     if ((task.surfaceTargets.includes('DESKTOP') || task.surfaceTargets.includes('MOBILE_LANDSCAPE')) && landscapePaths.length === 0) {
-        throw new Error('agent_task_listing_screenshots_missing: desktop or landscape games must include at least one listing.screenshotsLandscape PNG capture.');
+        throw new Error('agent_task_listing_screenshots_missing: desktop or landscape games must include at least one listing.screenshotsLandscape PNG marketing image.');
     }
     for (const filePath of portraitPaths) {
         assertScreenshotPath(task, filePath, 'listing.screenshotsPortrait');
@@ -137,10 +137,8 @@ function assertListingScreenshots(task) {
 function isSha256Hex(value) {
     return typeof value === 'string' && /^[a-f0-9]{64}$/i.test(value.trim());
 }
-function isCaptureMediaFileKey(fileKey) {
-    return fileKey.startsWith('screenshotsPortrait:')
-        || fileKey.startsWith('screenshotsLandscape:')
-        || fileKey.startsWith('videosPortrait:')
+function isCaptureVideoFileKey(fileKey) {
+    return fileKey.startsWith('videosPortrait:')
         || fileKey.startsWith('videosLandscape:');
 }
 function readMediaCaptureProof(input) {
@@ -175,20 +173,21 @@ function readMediaCaptureProof(input) {
     if (!rawArtifactHashes || typeof rawArtifactHashes !== 'object' || Array.isArray(rawArtifactHashes)) {
         throw new Error(`agent_task_media_capture_report_invalid: ${reportPath} binding.artifactHashes must be an object.`);
     }
-    const captureArtifactHashEntries = Object.values(rawArtifactHashes)
-        .map((value) => typeof value === 'string' ? value.trim().toLowerCase() : '')
+    const captureArtifactHashEntries = Object.entries(rawArtifactHashes)
+        .filter(([artifactKey]) => (0, node_path_1.extname)(artifactKey).toLowerCase() === '.mp4')
+        .map(([, value]) => typeof value === 'string' ? value.trim().toLowerCase() : '')
         .filter((value) => isSha256Hex(value));
     const captureArtifactHashes = new Set(captureArtifactHashEntries);
     if (captureArtifactHashEntries.length === 0) {
-        throw new Error(`agent_task_media_capture_report_invalid: ${reportPath} binding.artifactHashes is empty.`);
+        throw new Error(`agent_task_media_capture_report_invalid: ${reportPath} binding.artifactHashes must include at least one MP4 gameplay video.`);
     }
     const captureArtifactHashCounts = new Map();
     for (const hash of captureArtifactHashEntries) {
         captureArtifactHashCounts.set(hash, (captureArtifactHashCounts.get(hash) ?? 0) + 1);
     }
-    const mediaFiles = input.preparedSessionFiles.filter((file) => isCaptureMediaFileKey(file.fileKey));
+    const mediaFiles = input.preparedSessionFiles.filter((file) => isCaptureVideoFileKey(file.fileKey));
     if (mediaFiles.length === 0) {
-        throw new Error(`agent_task_media_capture_artifacts_missing: ${input.task.name} must upload recorder stills and video in listing.screenshots* and listing.videos*.`);
+        throw new Error(`agent_task_media_capture_artifacts_missing: ${input.task.name} must upload recorder gameplay video in listing.videos*.`);
     }
     const uploadedMediaHashCounts = new Map();
     for (const file of mediaFiles) {
@@ -197,21 +196,19 @@ function readMediaCaptureProof(input) {
     const missingUploadedCaptureArtifacts = [...captureArtifactHashCounts.entries()]
         .filter(([hash, expectedCount]) => (uploadedMediaHashCounts.get(hash) ?? 0) < expectedCount);
     if (missingUploadedCaptureArtifacts.length > 0) {
-        throw new Error(`agent_task_media_capture_artifact_missing_from_listing: ${input.task.name} must list every recorder poster and video from listing.captureReport in catalogue.json.`);
+        throw new Error(`agent_task_media_capture_artifact_missing_from_listing: ${input.task.name} must list every recorder gameplay video from listing.captureReport in catalogue.json.`);
     }
-    let hasStill = false;
     let hasVideo = false;
     const artifactHashes = {};
     for (const file of mediaFiles) {
         if (!captureArtifactHashes.has(file.sha256)) {
             throw new Error(`agent_task_media_capture_artifact_mismatch: ${file.fileKey} was not produced by listing.captureReport for ${input.task.name}.`);
         }
-        hasStill = hasStill || file.fileKey.startsWith('screenshots');
         hasVideo = hasVideo || file.fileKey.startsWith('videos');
         artifactHashes[file.fileKey] = file.sha256;
     }
-    if (!hasStill || !hasVideo) {
-        throw new Error(`agent_task_media_capture_artifacts_missing: ${input.task.name} must upload at least one recorder still and one recorder video.`);
+    if (!hasVideo) {
+        throw new Error(`agent_task_media_capture_artifacts_missing: ${input.task.name} must upload at least one recorder gameplay video.`);
     }
     const capturedSurfaces = Array.isArray(binding.capturedSurfaces)
         ? Array.from(new Set(binding.capturedSurfaces

package/node_modules/@playdrop/config/client-meta.json

@@ -1,7 +1,7 @@
 {
-  "version": "0.13.17",
+  "version": "0.14.0",
   "build": 1,
-  "runtimeSdkVersion": "0.13.17",
+  "runtimeSdkVersion": "0.14.0",
   "runtimeSdkBuild": 1,
   "clients": {
     "all": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playdrop/playdrop-cli",
-  "version": "0.13.17",
+  "version": "0.14.0",
   "description": "Official Playdrop CLI for publishing browser games, creator apps, and AI-generated game assets on playdrop.ai",
   "homepage": "https://www.playdrop.ai",
   "repository": {