@playdrop/playdrop-cli 0.3.1-build.1

package/dist/commands/generation.js

@@ -0,0 +1,509 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generate = generate;
+exports.generations = generations;
+const types_1 = require("@playdrop/types");
+const commandContext_1 = require("../commandContext");
+const messages_1 = require("../messages");
+const IMAGE_ASPECT_RATIO_SET = new Set(['1:1', '3:4', '9:16', '4:3', '16:9']);
+const VIDEO_ASPECT_RATIO_SET = new Set(['16:9', '9:16']);
+const DEFAULT_SUBCATEGORY_BY_MODALITY = {
+    IMAGE: 'generic',
+    MUSIC: 'music',
+    SFX: 'sfx',
+    VIDEO: 'generic',
+    MODEL_3D: 'generic',
+};
+const DEFAULT_IMAGE_ASPECT_RATIO = '1:1';
+const DEFAULT_VIDEO_ASPECT_RATIO = '16:9';
+const DEFAULT_VIDEO_DURATION_SECONDS = 4;
+const VIDEO_FIRST_LAST_FRAME_DURATION_SECONDS = 8;
+const DEFAULT_MODEL3D_TOPOLOGY = 'triangle';
+const DEFAULT_MODEL3D_TARGET_POLYCOUNT = 30000;
+const DEFAULT_MODEL3D_SHOULD_REMESH = true;
+const DEFAULT_MODEL3D_SHOULD_TEXTURE = true;
+const GENERATE_DEFAULT_TIMEOUT_SECONDS = 900;
+const GENERATE_DEFAULT_POLL_INTERVAL_MS = 1000;
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+function normalizeModality(value) {
+    const normalized = value.trim().toUpperCase().replace(/[-\s]+/g, '_');
+    if (normalized === 'IMAGE')
+        return 'IMAGE';
+    if (normalized === 'MUSIC')
+        return 'MUSIC';
+    if (normalized === 'SFX')
+        return 'SFX';
+    if (normalized === 'VIDEO')
+        return 'VIDEO';
+    if (normalized === 'MODEL3D' || normalized === 'MODEL_3D')
+        return 'MODEL_3D';
+    return null;
+}
+function normalizeVisibility(value) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        return undefined;
+    }
+    const normalized = value.trim().toUpperCase();
+    if (normalized === 'PRIVATE' || normalized === 'PUBLIC') {
+        return normalized;
+    }
+    return undefined;
+}
+function parseAssetSubcategory(value) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        return undefined;
+    }
+    const normalized = (0, types_1.normalizeAssetSubcategory)(value);
+    if (!(0, types_1.isValidAssetSubcategorySlug)(normalized)) {
+        throw new Error('invalid_asset_subcategory');
+    }
+    return normalized;
+}
+function parseOptionalPositiveInt(value, field) {
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    const raw = String(value).trim();
+    if (!raw.length) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new Error(`invalid_${field}`);
+    }
+    return parsed;
+}
+function parseOptionalNonNegativeInt(value, field) {
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    const raw = String(value).trim();
+    if (!raw.length) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isInteger(parsed) || parsed < 0) {
+        throw new Error(`invalid_${field}`);
+    }
+    return parsed;
+}
+function parseOptionalDuration(value) {
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    const raw = String(value).trim().toLowerCase();
+    if (!raw.length) {
+        return undefined;
+    }
+    if (raw.endsWith('ms')) {
+        const parsed = Number(raw.slice(0, -2).trim());
+        if (!Number.isFinite(parsed) || parsed <= 0) {
+            throw new Error('invalid_duration');
+        }
+        return { value: parsed, unit: 'ms' };
+    }
+    if (raw.endsWith('s')) {
+        const parsed = Number(raw.slice(0, -1).trim());
+        if (!Number.isFinite(parsed) || parsed <= 0) {
+            throw new Error('invalid_duration');
+        }
+        return { value: parsed, unit: 's' };
+    }
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error('invalid_duration');
+    }
+    return { value: parsed, unit: 'plain' };
+}
+function parseMusicDurationMs(duration) {
+    if (!duration) {
+        return undefined;
+    }
+    const milliseconds = duration.unit === 's' ? duration.value * 1000 : duration.value;
+    if (!Number.isInteger(milliseconds) || milliseconds <= 0) {
+        throw new Error('invalid_duration');
+    }
+    return milliseconds;
+}
+function parseSecondsDuration(duration) {
+    if (!duration) {
+        return undefined;
+    }
+    const seconds = duration.unit === 'ms' ? duration.value / 1000 : duration.value;
+    if (!Number.isFinite(seconds) || seconds <= 0) {
+        throw new Error('invalid_duration');
+    }
+    return seconds;
+}
+function parseVideoDurationSeconds(duration) {
+    const seconds = parseSecondsDuration(duration);
+    if (seconds === undefined) {
+        return undefined;
+    }
+    if (!Number.isInteger(seconds) || (seconds !== 4 && seconds !== 8)) {
+        throw new Error('invalid_video_duration');
+    }
+    return seconds;
+}
+function parseInputAssetIds(raw) {
+    if (typeof raw !== 'string' || raw.trim().length === 0) {
+        return undefined;
+    }
+    const values = raw
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean)
+        .map((item) => {
+        const parsed = Number.parseInt(item, 10);
+        if (!Number.isInteger(parsed) || parsed <= 0) {
+            throw new Error('invalid_input_assets');
+        }
+        return parsed;
+    });
+    return values.length > 0 ? values : undefined;
+}
+function parseListFormat(raw) {
+    if (!raw || raw.trim().length === 0) {
+        return 'text';
+    }
+    const normalized = raw.trim().toLowerCase();
+    if (normalized === 'text' || normalized === 'json') {
+        return normalized;
+    }
+    return null;
+}
+function parseListType(raw) {
+    if (!raw || raw.trim().length === 0) {
+        return undefined;
+    }
+    const normalized = raw.trim().toLowerCase().replace(/[-\s]+/g, '_');
+    if (normalized === 'text'
+        || normalized === 'json'
+        || normalized === 'image'
+        || normalized === 'music'
+        || normalized === 'sfx'
+        || normalized === 'video'
+        || normalized === 'model_3d') {
+        return normalized;
+    }
+    return null;
+}
+function buildGenerateRequest(typeInput, promptInput, options) {
+    const type = typeof typeInput === 'string' ? typeInput.trim() : '';
+    if (!type.length) {
+        throw new Error('missing_type');
+    }
+    const modality = normalizeModality(type);
+    if (!modality) {
+        throw new Error('invalid_type');
+    }
+    const prompt = typeof promptInput === 'string' ? promptInput.trim() : '';
+    if (!prompt.length) {
+        throw new Error('missing_prompt');
+    }
+    const visibility = normalizeVisibility(options.visibility);
+    if (options.visibility && !visibility) {
+        throw new Error('invalid_visibility');
+    }
+    const timeoutSeconds = parseOptionalPositiveInt(options.timeoutSeconds, 'timeout_seconds') ?? GENERATE_DEFAULT_TIMEOUT_SECONDS;
+    const pollIntervalMs = parseOptionalPositiveInt(options.pollIntervalMs, 'poll_interval_ms') ?? GENERATE_DEFAULT_POLL_INTERVAL_MS;
+    if (pollIntervalMs < 250) {
+        throw new Error('invalid_poll_interval_ms');
+    }
+    const duration = parseOptionalDuration(options.duration);
+    const request = {
+        modality,
+        input: prompt,
+        assetSubcategory: parseAssetSubcategory(options.subcategory) ?? DEFAULT_SUBCATEGORY_BY_MODALITY[modality],
+        assetName: typeof options.assetName === 'string' && options.assetName.trim().length > 0 ? options.assetName.trim() : undefined,
+        assetDisplayName: typeof options.assetDisplayName === 'string' && options.assetDisplayName.trim().length > 0
+            ? options.assetDisplayName.trim()
+            : undefined,
+        assetDescription: typeof options.assetDescription === 'string' && options.assetDescription.trim().length > 0
+            ? options.assetDescription.trim()
+            : undefined,
+        assetVisibility: visibility ?? 'PUBLIC',
+        inputAssetVersionIds: parseInputAssetIds(options.inputAssets),
+        attachAppVersionId: parseOptionalPositiveInt(options.attachAppVersionId, 'attach_app_version_id'),
+    };
+    if (modality === 'IMAGE') {
+        request.image1 = options.image1 && options.image1.trim().length > 0 ? { url: options.image1.trim() } : undefined;
+        request.image2 = options.image2 && options.image2.trim().length > 0 ? { url: options.image2.trim() } : undefined;
+        if (typeof options.ratio === 'string' && options.ratio.trim().length > 0) {
+            const aspectRatio = options.ratio.trim();
+            if (!IMAGE_ASPECT_RATIO_SET.has(aspectRatio)) {
+                throw new Error('invalid_aspect_ratio');
+            }
+            request.aspectRatio = aspectRatio;
+        }
+        else {
+            request.aspectRatio = DEFAULT_IMAGE_ASPECT_RATIO;
+        }
+    }
+    if (modality === 'MUSIC') {
+        request.durationMs = parseMusicDurationMs(duration);
+        request.forceInstrumental = Boolean(options.instrumental);
+        request.coverPrompt = typeof options.coverPrompt === 'string' && options.coverPrompt.trim().length > 0 ? options.coverPrompt.trim() : undefined;
+    }
+    if (modality === 'SFX') {
+        request.durationSeconds = parseSecondsDuration(duration);
+        request.loop = Boolean(options.loop);
+        request.coverPrompt = typeof options.coverPrompt === 'string' && options.coverPrompt.trim().length > 0 ? options.coverPrompt.trim() : undefined;
+    }
+    if (modality === 'VIDEO') {
+        request.image1 = options.image1 && options.image1.trim().length > 0 ? { url: options.image1.trim() } : undefined;
+        request.image2 = options.image2 && options.image2.trim().length > 0 ? { url: options.image2.trim() } : undefined;
+        const durationSeconds = parseVideoDurationSeconds(duration);
+        const hasFirstAndLastFrame = Boolean(request.image1 && request.image2);
+        request.durationSeconds = hasFirstAndLastFrame
+            ? VIDEO_FIRST_LAST_FRAME_DURATION_SECONDS
+            : (durationSeconds ?? DEFAULT_VIDEO_DURATION_SECONDS);
+        if (typeof options.ratio === 'string' && options.ratio.trim().length > 0) {
+            const aspectRatio = options.ratio.trim();
+            if (!VIDEO_ASPECT_RATIO_SET.has(aspectRatio)) {
+                throw new Error('invalid_aspect_ratio');
+            }
+            request.aspectRatio = aspectRatio;
+        }
+        else {
+            request.aspectRatio = DEFAULT_VIDEO_ASPECT_RATIO;
+        }
+        if (options.resolution !== undefined && options.resolution !== '720p') {
+            throw new Error('invalid_resolution');
+        }
+        request.resolution = options.resolution;
+    }
+    if (modality === 'MODEL_3D') {
+        const sourceModeInput = typeof options.sourceMode === 'string' ? options.sourceMode.trim().toUpperCase() : '';
+        if (sourceModeInput.length > 0 && sourceModeInput !== 'TEXT' && sourceModeInput !== 'IMAGE') {
+            throw new Error('invalid_source_mode');
+        }
+        request.image1 = options.image1 && options.image1.trim().length > 0 ? { url: options.image1.trim() } : undefined;
+        request.image2 = options.image2 && options.image2.trim().length > 0 ? { url: options.image2.trim() } : undefined;
+        const hasInputImages = Boolean(request.image1 || request.image2);
+        request.sourceMode = sourceModeInput.length > 0
+            ? sourceModeInput
+            : (hasInputImages ? 'IMAGE' : 'TEXT');
+        if (request.sourceMode === 'IMAGE' && !hasInputImages) {
+            throw new Error('missing_model3d_images');
+        }
+        if (request.sourceMode === 'TEXT' && hasInputImages) {
+            throw new Error('model3d_text_mode_disallows_images');
+        }
+        const topology = typeof options.topology === 'string' ? options.topology.trim().toLowerCase() : '';
+        if (topology.length > 0 && topology !== 'triangle' && topology !== 'quad') {
+            throw new Error('invalid_topology');
+        }
+        request.topology = topology.length > 0 ? topology : DEFAULT_MODEL3D_TOPOLOGY;
+        request.targetPolycount = parseOptionalPositiveInt(options.polycount, 'polycount') ?? DEFAULT_MODEL3D_TARGET_POLYCOUNT;
+        request.shouldRemesh = typeof options.remesh === 'boolean' ? options.remesh : DEFAULT_MODEL3D_SHOULD_REMESH;
+        request.shouldTexture = typeof options.texture === 'boolean' ? options.texture : DEFAULT_MODEL3D_SHOULD_TEXTURE;
+    }
+    return { modality, request, timeoutSeconds, pollIntervalMs };
+}
+function generationPrompt(record) {
+    if ('inputPrompt' in record && typeof record.inputPrompt === 'string') {
+        return record.inputPrompt;
+    }
+    return '';
+}
+function generationAssetRef(record) {
+    const candidate = record.generatedAsset;
+    if (candidate && typeof candidate === 'object' && typeof candidate.ref === 'string' && candidate.ref.trim().length > 0) {
+        return candidate.ref.trim();
+    }
+    return null;
+}
+function generationAssetSubcategory(record) {
+    const candidate = record.generatedAsset;
+    if (candidate && typeof candidate === 'object' && typeof candidate.subcategory === 'string' && candidate.subcategory.trim().length > 0) {
+        return candidate.subcategory.trim();
+    }
+    return null;
+}
+function printGenerateResult(modality, payload) {
+    console.log(`Modality: ${modality}`);
+    if (payload?.billing?.generationId) {
+        console.log(`Generation ID: ${payload.billing.generationId}`);
+    }
+    if (typeof payload?.cost === 'number') {
+        console.log(`Cost: ${payload.cost}`);
+    }
+    if (typeof payload?.createdAt === 'string') {
+        console.log(`Created At: ${payload.createdAt}`);
+    }
+    const ref = typeof payload?.generatedAsset?.ref === 'string' ? payload.generatedAsset.ref : null;
+    const subcategory = typeof payload?.generatedAsset?.subcategory === 'string' ? payload.generatedAsset.subcategory : null;
+    if (ref) {
+        console.log(`Generated Asset: ${ref}`);
+        if (subcategory) {
+            console.log(`Generated Subcategory: ${subcategory}`);
+        }
+        console.log(`Download File Command: playdrop-cli assets download-file ${ref}`);
+        console.log(`Download Source Command: playdrop-cli assets download-source ${ref}`);
+    }
+    else {
+        console.log('Generated Asset: none');
+    }
+}
+function formatJobStatus(job) {
+    const progress = typeof job.progressPercent === 'number'
+        ? ` progress=${Math.max(0, Math.min(100, Math.round(job.progressPercent)))}%`
+        : '';
+    const eta = typeof job.etaSecondsRemaining === 'number'
+        ? ` eta=${Math.max(0, Math.round(job.etaSecondsRemaining))}s`
+        : '';
+    return `${job.status}${progress}${eta}`;
+}
+async function generate(typeInput, promptInput, options = {}) {
+    let parsed;
+    try {
+        parsed = buildGenerateRequest(typeInput, promptInput, options);
+    }
+    catch (error) {
+        const message = typeof error?.message === 'string' ? error.message : 'invalid_input';
+        if (message === 'missing_type') {
+            (0, messages_1.printErrorWithHelp)('A generation type is required.', ['Use one of: image, music, sfx, video, model_3d.'], { command: 'generate' });
+            process.exitCode = 1;
+            return;
+        }
+        if (message === 'missing_prompt') {
+            (0, messages_1.printErrorWithHelp)('A prompt is required.', ['Example: playdrop-cli generate image "A pixel art hero portrait"'], { command: 'generate' });
+            process.exitCode = 1;
+            return;
+        }
+        if (message === 'invalid_type') {
+            (0, messages_1.printErrorWithHelp)('The generation type is invalid.', ['Use one of: image, music, sfx, video, model_3d.'], { command: 'generate' });
+            process.exitCode = 1;
+            return;
+        }
+        if (message === 'invalid_duration') {
+            (0, messages_1.printErrorWithHelp)('The --duration value is invalid.', ['Use a positive value like 20000, 20s, or 20000ms.'], { command: 'generate' });
+            process.exitCode = 1;
+            return;
+        }
+        if (message === 'invalid_video_duration') {
+            (0, messages_1.printErrorWithHelp)('The --duration value for video is invalid.', ['Use 4s or 8s for video generation.'], { command: 'generate' });
+            process.exitCode = 1;
+            return;
+        }
+        if (message === 'invalid_aspect_ratio') {
+            (0, messages_1.printErrorWithHelp)('The --ratio value is invalid.', ['Image: 1:1, 3:4, 9:16, 4:3, 16:9. Video: 16:9, 9:16.'], { command: 'generate' });
+            process.exitCode = 1;
+            return;
+        }
+        if (message === 'missing_model3d_images') {
+            (0, messages_1.printErrorWithHelp)('Model 3D IMAGE source mode requires at least one reference image.', ['Provide --image1 <url> or --image2 <url>, or switch to --source-mode TEXT.'], { command: 'generate' });
+            process.exitCode = 1;
+            return;
+        }
+        if (message === 'model3d_text_mode_disallows_images') {
+            (0, messages_1.printErrorWithHelp)('Model 3D TEXT source mode cannot include reference images.', ['Remove --image1/--image2 or switch to --source-mode IMAGE.'], { command: 'generate' });
+            process.exitCode = 1;
+            return;
+        }
+        if (message === 'invalid_asset_subcategory') {
+            (0, messages_1.printErrorWithHelp)('The --subcategory value is invalid.', ['Use a lowercase slug such as generic, music, sfx, or avatar.'], { command: 'generate' });
+            process.exitCode = 1;
+            return;
+        }
+        (0, messages_1.printErrorWithHelp)(`Invalid generate input: ${message}.`, ['Run "playdrop-cli generate --help" for valid options.'], {
+            command: 'generate',
+        });
+        process.exitCode = 1;
+        return;
+    }
+    await (0, commandContext_1.withEnvironment)('generate', 'Generating AI assets', async ({ aiClient }) => {
+        const created = await aiClient.createGenerationJob(parsed.request);
+        let job = created.job;
+        const jobId = String(job.id || '').trim();
+        if (!jobId) {
+            throw new Error('ai_generation_job_missing_id');
+        }
+        console.log(`Job ID: ${jobId}`);
+        console.log(`Status: ${formatJobStatus(job)}`);
+        const deadlineMs = Date.now() + parsed.timeoutSeconds * 1000;
+        while (job.status === 'PENDING' || job.status === 'RUNNING') {
+            if (Date.now() >= deadlineMs) {
+                throw new Error(`ai_generation_job_timeout: Timed out waiting for job ${jobId}`);
+            }
+            await sleep(parsed.pollIntervalMs);
+            const latest = await aiClient.getGenerationJob(jobId);
+            job = latest.job;
+            console.log(`Status: ${formatJobStatus(job)}`);
+        }
+        if (job.status !== 'SUCCESS') {
+            const errorCode = typeof job.errorCode === 'string' && job.errorCode.length > 0 ? job.errorCode : 'ai_generation_failed';
+            const errorMessage = typeof job.errorMessage === 'string' && job.errorMessage.length > 0
+                ? job.errorMessage
+                : 'Generation failed.';
+            throw new Error(`${errorCode}: ${errorMessage}`);
+        }
+        const payload = (job.resultData && typeof job.resultData === 'object') ? job.resultData : {};
+        printGenerateResult(parsed.modality, payload);
+    });
+}
+async function generations(options = {}) {
+    const format = parseListFormat(options.format);
+    if (!format) {
+        (0, messages_1.printErrorWithHelp)('The --format value is invalid.', ['Use --format text or --format json.'], { command: 'generations' });
+        process.exitCode = 1;
+        return;
+    }
+    const type = parseListType(options.type);
+    if (type === null) {
+        (0, messages_1.printErrorWithHelp)('The --type value is invalid.', ['Use one of: text, json, image, music, sfx, video, model_3d.'], { command: 'generations' });
+        process.exitCode = 1;
+        return;
+    }
+    let limit;
+    let offset;
+    try {
+        limit = parseOptionalPositiveInt(options.limit, 'limit');
+        offset = parseOptionalNonNegativeInt(options.offset, 'offset');
+    }
+    catch (error) {
+        const message = typeof error?.message === 'string' ? error.message : 'invalid_pagination';
+        (0, messages_1.printErrorWithHelp)(`Invalid generations input: ${message}.`, ['Use positive integers for --limit and --offset.'], {
+            command: 'generations',
+        });
+        process.exitCode = 1;
+        return;
+    }
+    await (0, commandContext_1.withEnvironment)('generations', 'Listing AI generations', async ({ aiClient }) => {
+        const response = await aiClient.listGenerations({ type: type ?? undefined, limit, offset });
+        if (format === 'json') {
+            console.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        if (!Array.isArray(response.generations) || response.generations.length === 0) {
+            console.log('No AI generations found.');
+            return;
+        }
+        for (const generation of response.generations) {
+            const prompt = generationPrompt(generation);
+            const ref = generationAssetRef(generation);
+            const subcategory = generationAssetSubcategory(generation);
+            const parts = [
+                generation.id,
+                generation.type,
+                generation.createdAt,
+                `cost=${generation.cost}`,
+            ];
+            if (prompt.length > 0) {
+                parts.push(`prompt=${prompt}`);
+            }
+            if (ref) {
+                parts.push(`asset=${ref}`);
+            }
+            if (subcategory) {
+                parts.push(`subcategory=${subcategory}`);
+            }
+            console.log(parts.join(' | '));
+        }
+    });
+}

package/dist/commands/init.d.ts

@@ -0,0 +1,13 @@
+type InitOptions = {
+    quiet?: boolean;
+};
+export type InitSummary = {
+    directory: string;
+    cataloguePath: string;
+    readmeStatus: 'created' | 'updated';
+    agentsStatus: 'created' | 'updated';
+    catalogueStatus: 'created' | 'skipped';
+    gitStatus: 'initialized' | 'skipped' | 'declined';
+};
+export declare function init(targetPath: string, options?: InitOptions): Promise<InitSummary | null>;
+export {};