@playdrop/playdrop-cli 0.9.6 → 0.10.1

package/dist/commands/creations.js

@@ -1,9 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.browseCreations = browseCreations;
-exports.browseCreationIdeas = browseCreationIdeas;
-exports.startCreationIdea = startCreationIdea;
-exports.shipCreationIdea = shipCreationIdea;
 exports.updateCreationApp = updateCreationApp;
 exports.deleteCreationApp = deleteCreationApp;
 exports.setCurrentCreationAppVersion = setCurrentCreationAppVersion;
@@ -29,7 +26,6 @@ const messages_1 = require("../messages");
 const output_1 = require("../output");
 const refs_1 = require("../refs");
 const MERGED_PAGE_SIZE = 100;
-const IDEA_STATE_VALUES = new Set(['idea', 'started', 'shipped', 'all']);
 function parseBrowseKind(raw) {
     if (!raw || raw.trim().length === 0) {
         return 'all';
@@ -53,19 +49,6 @@ function parsePositiveInteger(raw, label, fallback) {
     }
     return parsed;
 }
-function parseIdeaState(raw) {
-    if (!raw || raw.trim().length === 0) {
-        return 'IDEA';
-    }
-    const normalized = raw.trim().toLowerCase();
-    if (!IDEA_STATE_VALUES.has(normalized)) {
-        return null;
-    }
-    if (normalized === 'all') {
-        return 'ALL';
-    }
-    return normalized.toUpperCase();
-}
 async function resolveCreator(client, rawCreator, command) {
     let creator;
     try {
@@ -311,130 +294,6 @@ async function browseCreations(options = {}) {
         }
     });
 }
-async function browseCreationIdeas(options = {}) {
-    const state = parseIdeaState(options.state);
-    if (!state) {
-        (0, messages_1.printErrorWithHelp)('The --state value is invalid.', ['Use one of: idea, started, shipped, all.'], { command: 'creations ideas browse' });
-        process.exitCode = 1;
-        return;
-    }
-    const limit = parsePositiveInteger(options.limit, 'limit', 20);
-    if (limit === null) {
-        (0, messages_1.printErrorWithHelp)('The --limit value must be a positive integer.', ['Example: --limit 20'], { command: 'creations ideas browse' });
-        process.exitCode = 1;
-        return;
-    }
-    const offset = parsePositiveInteger(options.offset, 'offset', 0);
-    if (offset === null) {
-        (0, messages_1.printErrorWithHelp)('The --offset value must be zero or a positive integer.', ['Example: --offset 20'], { command: 'creations ideas browse' });
-        process.exitCode = 1;
-        return;
-    }
-    await (0, commandContext_1.withEnvironment)('creations ideas browse', 'Browsing your game ideas', async ({ client }) => {
-        try {
-            const response = await client.listGameIdeas({ state, limit, offset });
-            if (options.json) {
-                (0, output_1.printJson)(response);
-                return;
-            }
-            if (response.gameIdeas.length === 0) {
-                console.log('No game ideas found.');
-                console.log('Next: create one at https://playdrop.ai/create.');
-                return;
-            }
-            console.log('Game ideas:\n');
-            response.gameIdeas.forEach((idea, index) => {
-                const tags = idea.tagRefs.length > 0 ? ` | ${idea.tagRefs.join(', ')}` : '';
-                const app = idea.createdAppRef ? ` | app ${idea.createdAppRef}` : '';
-                console.log(`${index + 1}. ${idea.slug} | ${idea.displayName} | ${idea.state.toLowerCase()}${tags}${app}`);
-            });
-            if (response.pagination.hasMore) {
-                console.log(`\nNext page: playdrop creations ideas browse --state ${String(options.state ?? 'idea')} --offset ${response.pagination.offset + response.pagination.limit}`);
-            }
-        }
-        catch (error) {
-            const handled = (0, errors_1.handleCommandFailure)(error, 'creations ideas browse', 'Game idea lookup', {
-                apiMessage: (apiError) => ({
-                    problem: `Game idea lookup failed with status ${apiError.status}.`,
-                    suggestions: ['Run "playdrop auth login" and retry.'],
-                }),
-            });
-            if (!handled) {
-                throw error;
-            }
-        }
-    });
-}
-async function startCreationIdea(idOrSlug, options = {}) {
-    const ref = typeof idOrSlug === 'string' ? idOrSlug.trim() : '';
-    if (!ref) {
-        (0, messages_1.printErrorWithHelp)('Provide a game idea id or slug.', ['Example: playdrop creations ideas start foxfire-kitchen'], { command: 'creations ideas start' });
-        process.exitCode = 1;
-        return;
-    }
-    await (0, commandContext_1.withEnvironment)('creations ideas start', 'Marking game idea started', async ({ client }) => {
-        try {
-            const response = await client.startGameIdea(ref);
-            if (options.json) {
-                (0, output_1.printJson)(response);
-                return;
-            }
-            (0, output_1.printSuccess)(`Marked ${response.gameIdea.slug} as started.`, [
-                `Next: build and publish the app, then run "playdrop creations ideas ship ${response.gameIdea.slug} --app <creator>/<name>".`,
-            ]);
-        }
-        catch (error) {
-            const handled = (0, errors_1.handleCommandFailure)(error, 'creations ideas start', 'Game idea update', {
-                apiMessage: (apiError) => ({
-                    problem: `Game idea update failed with status ${apiError.status}.`,
-                    suggestions: ['Confirm the id or slug, then retry.'],
-                }),
-            });
-            if (!handled) {
-                throw error;
-            }
-        }
-    });
-}
-async function shipCreationIdea(idOrSlug, options = {}) {
-    const ref = typeof idOrSlug === 'string' ? idOrSlug.trim() : '';
-    const appRef = typeof options.app === 'string' ? options.app.trim() : '';
-    if (!ref) {
-        (0, messages_1.printErrorWithHelp)('Provide a game idea id or slug.', ['Example: playdrop creations ideas ship foxfire-kitchen --app olivier/foxfire-kitchen'], { command: 'creations ideas ship' });
-        process.exitCode = 1;
-        return;
-    }
-    if (!appRef) {
-        (0, messages_1.printErrorWithHelp)('Provide --app <creator>/<name>.', ['Example: --app olivier/foxfire-kitchen'], { command: 'creations ideas ship' });
-        process.exitCode = 1;
-        return;
-    }
-    await (0, commandContext_1.withEnvironment)('creations ideas ship', 'Marking game idea shipped', async ({ client }) => {
-        try {
-            const response = await client.shipGameIdea(ref, { app: appRef });
-            if (options.json) {
-                (0, output_1.printJson)(response);
-                return;
-            }
-            (0, output_1.printSuccess)(`Marked ${response.gameIdea.slug} as shipped.`, [
-                response.gameIdea.createdAppRef
-                    ? `Linked app: ${response.gameIdea.createdAppRef}.`
-                    : `Linked app: ${appRef}.`,
-            ]);
-        }
-        catch (error) {
-            const handled = (0, errors_1.handleCommandFailure)(error, 'creations ideas ship', 'Game idea update', {
-                apiMessage: (apiError) => ({
-                    problem: `Game idea update failed with status ${apiError.status}.`,
-                    suggestions: ['Confirm the id or slug and --app value, then retry.'],
-                }),
-            });
-            if (!handled) {
-                throw error;
-            }
-        }
-    });
-}
 async function updateCreationApp(nameArg, options = {}) {
     const name = parseManagedName(nameArg, 'creations apps update');
     if (!name) {

package/dist/commands/dev.d.ts

@@ -2,7 +2,8 @@ export declare function formatDevRuntimeAssetManifestFailure(error: unknown): {
     message: string;
     suggestions: string[];
 };
-export declare function dev(targetArg: string | undefined, _port?: number, appOption?: string, devOptions?: {
+export declare function dev(targetArg: string | undefined, port?: number | string, appOption?: string, devOptions?: {
     devAuth?: string;
     player?: string | number;
 }): Promise<void>;
+export declare function resolveDevRouterPort(value: number | string | null | undefined): number;

package/dist/commands/dev.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatDevRuntimeAssetManifestFailure = formatDevRuntimeAssetManifestFailure;
 exports.dev = dev;
+exports.resolveDevRouterPort = resolveDevRouterPort;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const types_1 = require("@playdrop/types");
@@ -133,7 +134,8 @@ function formatDevRuntimeAssetManifestFailure(error) {
         ],
     };
 }
-async function dev(targetArg, _port, appOption, devOptions = {}) {
+async function dev(targetArg, port, appOption, devOptions = {}) {
+    const devRouterPort = resolveDevRouterPort(port ?? process.env.PLAYDROP_DEV_ROUTER_PORT);
     let resolvedTarget;
     try {
         resolvedTarget = (0, devShared_1.resolveDevTarget)(targetArg, appOption);
@@ -298,7 +300,7 @@ async function dev(targetArg, _port, appOption, devOptions = {}) {
             creatorUsername: currentUsername,
             appType: appTypeSlug,
             appName,
-            port: devServer_1.DEV_ROUTER_PORT,
+            port: devRouterPort,
         });
         let runtimeAssetManifest = (0, devRuntimeAssets_1.createEmptyDevRuntimeAssetManifest)();
         if (taskLookup.task) {
@@ -367,7 +369,7 @@ async function dev(targetArg, _port, appOption, devOptions = {}) {
                 appType: appTypeSlug,
                 creatorUsername: currentUsername,
                 htmlPath: filePath,
-                port: devServer_1.DEV_ROUTER_PORT,
+                port: devRouterPort,
                 projectInfo,
                 runtimeAssetManifest,
             });
@@ -383,13 +385,13 @@ async function dev(targetArg, _port, appOption, devOptions = {}) {
                 ], { command: 'project dev' });
             }
             else if (message.startsWith('dev_router_incompatible:')) {
-                (0, messages_1.printErrorWithHelp)(`An incompatible shared dev router is already running on port ${devServer_1.DEV_ROUTER_PORT}.`, [
+                (0, messages_1.printErrorWithHelp)(`An incompatible shared dev router is already running on port ${devRouterPort}.`, [
                     'Stop the existing dev router process, then retry "playdrop project dev".',
                     `If needed, rebuild the local CLI first with "npm run build --workspace @playdrop/playdrop-cli" from /Users/oliviermichon/Documents/playdrop.`,
                 ], { command: 'project dev' });
             }
             else {
-                (0, messages_1.printErrorWithHelp)(error?.message || `Failed to start the shared dev router on port ${devServer_1.DEV_ROUTER_PORT}.`, [
+                (0, messages_1.printErrorWithHelp)(error?.message || `Failed to start the shared dev router on port ${devRouterPort}.`, [
                     'Close the conflicting process or wait for the stale mount to exit.',
                     'Ensure the app HTML file exists and is readable.',
                 ], { command: 'project dev' });
@@ -425,7 +427,12 @@ async function dev(targetArg, _port, appOption, devOptions = {}) {
             }
         }
         if (webUrl) {
-            const iframeUrl = (0, devAuth_1.applyHostedDevAuthSelectionToUrl)(`${webUrl}/creators/${encodeURIComponent(currentUsername)}/apps/${appTypeSlug}/${encodeURIComponent(appName)}/dev`, devAuthSelection);
+            const iframeUrl = (0, devAuth_1.applyHostedDevAuthSelectionToUrl)((0, appUrls_1.buildPlatformDevUrl)(webUrl, {
+                creatorUsername: currentUsername,
+                appType: appTypeSlug,
+                appName,
+                localDevPort: devRouterPort === devServer_1.DEV_ROUTER_PORT ? null : devRouterPort,
+            }), devAuthSelection);
             console.log('\nTest your app at:');
             console.log(`  ${iframeUrl}`);
             console.log('\nMake something fun then share it with');
@@ -436,3 +443,13 @@ async function dev(targetArg, _port, appOption, devOptions = {}) {
         }
     }, { workspacePath });
 }
+function resolveDevRouterPort(value) {
+    if (value === null || value === undefined || String(value).trim() === '') {
+        return devServer_1.DEV_ROUTER_PORT;
+    }
+    const parsed = typeof value === 'number' ? value : Number.parseInt(String(value), 10);
+    if (!Number.isInteger(parsed) || parsed <= 0 || parsed > 65535) {
+        throw new Error('invalid_dev_router_port');
+    }
+    return parsed;
+}

package/dist/commands/devServer.js

@@ -413,11 +413,13 @@ async function ensureDevRouterRunning(port = exports.DEV_ROUTER_PORT) {
         throw new Error(`dev_router_incompatible:port_${port}`);
     }
     const cliEntrypoint = getCliEntrypointPath();
+    const childEnv = { ...process.env };
+    delete childEnv.PLAYDROP_WORKER_CONTEXT;
     const child = (0, node_child_process_1.spawn)(process.execPath, [cliEntrypoint, 'project', '_dev-router', 'serve'], {
         detached: true,
         stdio: 'ignore',
         env: {
-            ...process.env,
+            ...childEnv,
             PLAYDROP_DEV_ROUTER_PORT: String(port),
         },
     });

package/dist/commands/generation.d.ts

@@ -24,6 +24,7 @@ type AiGenerateOptions = {
     texture?: boolean;
     timeoutSeconds?: string | number;
     pollIntervalMs?: string | number;
+    output?: string;
     json?: boolean;
 };
 type AiListOptions = {

package/dist/commands/generation.js

@@ -1,10 +1,44 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveImageAttachment = resolveImageAttachment;
 exports.generate = generate;
 exports.browseGenerationJobs = browseGenerationJobs;
 exports.showGenerationJob = showGenerationJob;
 exports.generations = generations;
+const config_1 = require("@playdrop/config");
 const types_1 = require("@playdrop/types");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
@@ -40,6 +74,8 @@ const LOCAL_IMAGE_MIME_BY_EXTENSION = {
     '.jpeg': 'image/jpeg',
     '.webp': 'image/webp',
 };
+const OUTPUT_IMAGE_MIME_BY_EXTENSION = LOCAL_IMAGE_MIME_BY_EXTENSION;
+const GENERATED_PNG_OUTPUT_MAX_BYTES = config_1.MAX_VERSION_HERO_BYTES;
 function isPlaydropSpeechVoiceId(value) {
     return types_1.PLAYDROP_SPEECH_VOICE_IDS.includes(value);
 }
@@ -596,6 +632,211 @@ function printGenerateResult(modality, payload) {
         console.log('Generated Asset: none');
     }
 }
+let pngOutputCrcTable = null;
+function getPngOutputCrcTable() {
+    if (pngOutputCrcTable) {
+        return pngOutputCrcTable;
+    }
+    const table = new Uint32Array(256);
+    for (let n = 0; n < 256; n++) {
+        let c = n;
+        for (let k = 0; k < 8; k++) {
+            c = (c & 1) ? (0xedb88320 ^ (c >>> 1)) : (c >>> 1);
+        }
+        table[n] = c >>> 0;
+    }
+    pngOutputCrcTable = table;
+    return table;
+}
+function pngOutputCrc32(buffer) {
+    const table = getPngOutputCrcTable();
+    let crc = 0xffffffff;
+    for (let index = 0; index < buffer.length; index++) {
+        const byte = buffer[index];
+        crc = table[(crc ^ byte) & 0xff] ^ (crc >>> 8);
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+function createPngOutputTextChunk(keyword, value) {
+    const keywordText = keyword.trim().slice(0, 79);
+    if (!/^[\x20-\x7e]+$/.test(keywordText) || keywordText.includes('\0')) {
+        throw new Error('ai_generation_image_output_metadata_failed');
+    }
+    const textValue = value.replace(/[^\x20-\xff]/g, ' ').slice(0, 4096);
+    const data = Buffer.concat([
+        Buffer.from(keywordText, 'latin1'),
+        Buffer.from([0]),
+        Buffer.from(textValue, 'latin1'),
+    ]);
+    const type = Buffer.from('tEXt', 'ascii');
+    const length = Buffer.alloc(4);
+    length.writeUInt32BE(data.length, 0);
+    const crc = Buffer.alloc(4);
+    crc.writeUInt32BE(pngOutputCrc32(Buffer.concat([type, data])), 0);
+    return Buffer.concat([length, type, data, crc]);
+}
+function extractGeneratedImageUrl(payload) {
+    if (typeof payload?.imageUrl === 'string' && payload.imageUrl.trim()) {
+        return payload.imageUrl.trim();
+    }
+    if (typeof payload?.outputImage === 'string' && payload.outputImage.trim()) {
+        return payload.outputImage.trim();
+    }
+    return null;
+}
+function embedGeneratedImageOutputMetadata(buffer, inputPrompt, payload) {
+    if (!isPngSignature(buffer)) {
+        return buffer;
+    }
+    const generationId = typeof payload?.billing?.generationId === 'string'
+        ? payload.billing.generationId
+        : typeof payload?.generationId === 'string'
+            ? payload.generationId
+            : '';
+    const chunks = [
+        createPngOutputTextChunk('playdrop:cliOutputTool', 'playdrop ai create image --output'),
+        createPngOutputTextChunk('playdrop:cliOutputPrompt', inputPrompt),
+        ...(generationId ? [createPngOutputTextChunk('playdrop:generationId', generationId)] : []),
+    ];
+    const signature = buffer.subarray(0, 8);
+    const parts = [signature];
+    let offset = 8;
+    let inserted = false;
+    while (offset + 12 <= buffer.length) {
+        const length = buffer.readUInt32BE(offset);
+        const chunkEnd = offset + 12 + length;
+        if (chunkEnd > buffer.length) {
+            throw new Error('ai_generation_image_output_metadata_failed');
+        }
+        const chunkType = buffer.toString('ascii', offset + 4, offset + 8);
+        if (chunkType === 'IEND' && !inserted) {
+            parts.push(...chunks);
+            inserted = true;
+        }
+        parts.push(buffer.subarray(offset, chunkEnd));
+        offset = chunkEnd;
+        if (chunkType === 'IEND') {
+            break;
+        }
+    }
+    if (!inserted) {
+        throw new Error('ai_generation_image_output_metadata_failed');
+    }
+    return Buffer.concat(parts);
+}
+async function writeGeneratedImageOutput(payload, outputPath, inputPrompt) {
+    const imageUrl = extractGeneratedImageUrl(payload);
+    if (!imageUrl) {
+        throw new Error('ai_generation_image_output_missing');
+    }
+    const response = await fetch(imageUrl);
+    if (!response.ok) {
+        throw new Error(`ai_generation_image_output_fetch_failed:${response.status}`);
+    }
+    const contentType = response.headers.get('content-type')?.toLowerCase() ?? '';
+    if (!contentType.startsWith('image/')) {
+        throw new Error(`ai_generation_image_output_invalid_content_type:${contentType || 'unknown'}`);
+    }
+    const buffer = Buffer.from(await response.arrayBuffer());
+    if (buffer.length === 0) {
+        throw new Error('ai_generation_image_output_empty');
+    }
+    const normalizedBuffer = await normalizeGeneratedImageOutputBuffer(buffer, outputPath);
+    const outputBuffer = embedGeneratedImageOutputMetadata(normalizedBuffer, inputPrompt, payload);
+    const resolvedPath = (0, node_path_1.resolve)(process.cwd(), outputPath);
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(resolvedPath), { recursive: true });
+    (0, node_fs_1.writeFileSync)(resolvedPath, outputBuffer);
+    console.log(`Saved Image: ${resolvedPath}`);
+}
+async function normalizeGeneratedImageOutputBuffer(buffer, outputPath) {
+    const extension = (0, node_path_1.extname)(outputPath).toLowerCase();
+    const targetMimeType = OUTPUT_IMAGE_MIME_BY_EXTENSION[extension];
+    if (!targetMimeType) {
+        return buffer;
+    }
+    const detectedMimeType = detectLocalImageMimeType(buffer);
+    if (!detectedMimeType) {
+        throw new Error('ai_generation_image_output_unsupported_type');
+    }
+    if (detectedMimeType === targetMimeType) {
+        if (targetMimeType === 'image/png' && buffer.length > GENERATED_PNG_OUTPUT_MAX_BYTES) {
+            return optimizeGeneratedPngOutputBuffer(buffer);
+        }
+        return buffer;
+    }
+    let sharp;
+    try {
+        const sharpModule = await Promise.resolve().then(() => __importStar(require('sharp')));
+        sharp = sharpModule.default ?? sharpModule;
+    }
+    catch {
+        throw new Error('ai_generation_image_output_conversion_unavailable');
+    }
+    try {
+        if (targetMimeType === 'image/png') {
+            return await optimizeGeneratedPngOutputBuffer(buffer, sharp);
+        }
+        const pipeline = sharp(buffer, { failOn: 'error' });
+        if (targetMimeType === 'image/jpeg') {
+            return await pipeline.jpeg({ quality: 92 }).toBuffer();
+        }
+        if (targetMimeType === 'image/webp') {
+            return await pipeline.webp({ quality: 92 }).toBuffer();
+        }
+    }
+    catch {
+        throw new Error('ai_generation_image_output_conversion_failed');
+    }
+    return buffer;
+}
+async function optimizeGeneratedPngOutputBuffer(buffer, loadedSharp) {
+    let sharp = loadedSharp;
+    if (!sharp) {
+        try {
+            const sharpModule = await Promise.resolve().then(() => __importStar(require('sharp')));
+            sharp = sharpModule.default ?? sharpModule;
+        }
+        catch {
+            throw new Error('ai_generation_image_output_conversion_unavailable');
+        }
+    }
+    const metadata = await sharp(buffer, { failOn: 'error' }).metadata();
+    const sourceWidth = typeof metadata.width === 'number' && metadata.width > 0 ? metadata.width : null;
+    const sourceHeight = typeof metadata.height === 'number' && metadata.height > 0 ? metadata.height : null;
+    const attempts = [
+        { scale: 1, palette: false, quality: 100 },
+        { scale: 1, palette: true, quality: 92 },
+        { scale: 0.9, palette: true, quality: 88 },
+        { scale: 0.8, palette: true, quality: 84 },
+        { scale: 0.7, palette: true, quality: 80 },
+        { scale: 0.6, palette: true, quality: 76 },
+        { scale: 0.5, palette: true, quality: 72 },
+    ];
+    let smallest = null;
+    for (const attempt of attempts) {
+        let pipeline = sharp(buffer, { failOn: 'error' }).rotate();
+        if (attempt.scale < 1 && sourceWidth && sourceHeight) {
+            pipeline = pipeline.resize({
+                width: Math.max(1, Math.round(sourceWidth * attempt.scale)),
+                height: Math.max(1, Math.round(sourceHeight * attempt.scale)),
+                fit: 'inside',
+                withoutEnlargement: true,
+            });
+        }
+        const output = await pipeline.png({
+            compressionLevel: 9,
+            adaptiveFiltering: true,
+            ...(attempt.palette ? { palette: true, quality: attempt.quality } : {}),
+        }).toBuffer();
+        if (!smallest || output.length < smallest.length) {
+            smallest = output;
+        }
+        if (output.length <= GENERATED_PNG_OUTPUT_MAX_BYTES) {
+            return output;
+        }
+    }
+    throw new Error(`ai_generation_image_output_too_large:${smallest?.length ?? buffer.length}:${GENERATED_PNG_OUTPUT_MAX_BYTES}`);
+}
 function formatJobStatus(job) {
     const progress = typeof job.progressPercent === 'number'
         ? ` progress=${Math.max(0, Math.min(100, Math.round(job.progressPercent)))}%`
@@ -624,6 +865,16 @@ async function generate(typeInput, promptInput, options = {}) {
         process.exitCode = 1;
         return;
     }
+    const outputPath = typeof options.output === 'string' && options.output.trim().length > 0
+        ? options.output.trim()
+        : null;
+    if (outputPath && parsed.modality !== 'IMAGE') {
+        (0, messages_1.printErrorWithHelp)('The --output option is only supported for image generation.', ['Use "playdrop ai create image ... --output <file>".'], {
+            command: 'ai create',
+        });
+        process.exitCode = 1;
+        return;
+    }
     await (0, commandContext_1.withEnvironment)('ai create', 'Generating AI assets', async ({ aiClient }) => {
         try {
             const created = await aiClient.createGenerationJob(parsed.request);
@@ -656,6 +907,9 @@ async function generate(typeInput, promptInput, options = {}) {
                 throw new Error(`${errorCode}: ${errorMessage}`);
             }
             const payload = (job.resultData && typeof job.resultData === 'object') ? job.resultData : {};
+            if (outputPath) {
+                await writeGeneratedImageOutput(payload, outputPath, parsed.request.input);
+            }
             if (options.json) {
                 (0, output_1.printJson)({ job, result: payload });
                 return;
@@ -711,6 +965,26 @@ function handleAiFailure(error, command, context) {
         process.exitCode = 1;
         return true;
     }
+    if (message === 'ai_generation_image_output_unsupported_type') {
+        (0, messages_1.printErrorWithHelp)('AI create returned an image format that Playdrop CLI could not identify.', ['Retry the command. If the problem persists, contact Playdrop support.'], { command });
+        process.exitCode = 1;
+        return true;
+    }
+    if (message === 'ai_generation_image_output_conversion_unavailable') {
+        (0, messages_1.printErrorWithHelp)('AI create could not convert the generated image to the requested output file type.', ['Install the Playdrop CLI dependencies again, then retry.'], { command });
+        process.exitCode = 1;
+        return true;
+    }
+    if (message === 'ai_generation_image_output_conversion_failed') {
+        (0, messages_1.printErrorWithHelp)('AI create failed while converting the generated image to the requested output file type.', ['Retry with a matching output extension such as .jpg, or retry the generation.'], { command });
+        process.exitCode = 1;
+        return true;
+    }
+    if (message === 'ai_generation_image_output_metadata_failed') {
+        (0, messages_1.printErrorWithHelp)('AI create failed while writing PlayDrop metadata to the generated image.', ['Retry the generation. The output image must keep prompt metadata for worker validation.'], { command });
+        process.exitCode = 1;
+        return true;
+    }
     if (message.startsWith('ai_generation_job_timeout:')) {
         const detail = message.split(':').slice(1).join(':').trim();
         (0, messages_1.printErrorWithHelp)(detail || 'AI create timed out while waiting for the job to finish.', ['Retry the command with a higher --timeout value if the job normally takes longer.'], { command });

package/dist/commands/review.d.ts

@@ -0,0 +1,46 @@
+export declare const REVIEW_CRITERIA: readonly ["Gameplay / Core Loop", "Depth / Replayability", "Controls / Input", "UX / Usability", "First Time User Experience", "Visuals / Art Direction", "Audio / Feedback", "Store Listing & Metadata Accuracy", "Safety / Age Rating / Compliance", "Performance / Stability"];
+export declare const REQUIRED_REVIEW_EVIDENCE_FILES: string[];
+export type ValidateGameReviewResultInput = {
+    creatorFeedback?: string;
+    evidenceDir: string;
+    reviewMessage: string;
+    reviewState: string;
+};
+export type ReviewValidationResult = {
+    average?: number;
+    evidenceDir?: string;
+    outcome?: string;
+    primarySurface?: string;
+    reason?: string;
+    scoreCount?: number;
+    skipped: boolean;
+};
+export type ReviewValidateResultOptions = {
+    creatorFeedbackFile?: string;
+    evidenceDir: string;
+    messageFile: string;
+    state: string;
+};
+export type ReviewComposeEvidenceOptions = {
+    core?: string;
+    win?: string;
+    loss?: string;
+    out: string;
+};
+export type ReviewRatingCardOptions = {
+    reviewMessageFile: string;
+    out: string;
+    punchline?: string;
+    title?: string;
+};
+export declare function validateGameReviewResult(input: ValidateGameReviewResultInput): Promise<ReviewValidationResult>;
+export declare function validateReviewResultCommand(options: ReviewValidateResultOptions): Promise<void>;
+export declare function composeReviewEvidence(options: ReviewComposeEvidenceOptions): Promise<{
+    outputPath: string;
+    imageCount: number;
+}>;
+export declare function createReviewRatingCard(options: ReviewRatingCardOptions): Promise<{
+    outputPath: string;
+    width: number;
+    height: number;
+}>;