@playdrop/playdrop-cli 0.16.16 → 0.17.0

package/dist/config.d.ts

@@ -4,6 +4,7 @@ export interface CliAccountRef {
 }
 export interface CliStoredSession {
     token: string;
+    deviceApiKey?: string;
     updatedAt: string;
 }
 export interface CliAccountSession extends CliAccountRef, CliStoredSession {
@@ -31,6 +32,7 @@ export declare function saveAccountSession(input: {
     username: string;
     env: string;
     token: string;
+    deviceApiKey?: string;
     updatedAt?: string;
 }): CliConfig;
 export declare function getOrCreateWorkerKey(): string;

package/dist/config.js

@@ -20,7 +20,7 @@ const crypto_1 = require("crypto");
 const fs_1 = require("fs");
 const os_1 = __importDefault(require("os"));
 const path_1 = require("path");
-const CONFIG_VERSION = 2;
+const CONFIG_VERSION = 3;
 function getConfigPath() {
     const custom = process.env.PLAYDROP_CONFIG_PATH;
     if (custom)
@@ -77,8 +77,10 @@ function loadConfig() {
 }
 function saveConfig(cfg) {
     const file = getConfigPath();
-    (0, fs_1.mkdirSync)((0, path_1.dirname)(file), { recursive: true });
-    (0, fs_1.writeFileSync)(file, JSON.stringify(stripDerivedFields(cfg), null, 2));
+    (0, fs_1.mkdirSync)((0, path_1.dirname)(file), { recursive: true, mode: 0o700 });
+    (0, fs_1.chmodSync)((0, path_1.dirname)(file), 0o700);
+    (0, fs_1.writeFileSync)(file, JSON.stringify(stripDerivedFields(cfg), null, 2), { mode: 0o600 });
+    (0, fs_1.chmodSync)(file, 0o600);
 }
 function clearConfig() {
     const file = getConfigPath();
@@ -100,6 +102,9 @@ function listAccountSessions(cfg = loadConfig()) {
                 username,
                 env,
                 token: session.token,
+                ...(typeof session.deviceApiKey === "string" && session.deviceApiKey.trim()
+                    ? { deviceApiKey: session.deviceApiKey.trim() }
+                    : {}),
                 updatedAt: typeof session.updatedAt === "string" ? session.updatedAt : "",
             });
         }
@@ -137,6 +142,9 @@ function findAccountSession(username, env, cfg = loadConfig()) {
             username: normalizedUsername,
             env: env.trim(),
             token: session.token,
+            ...(typeof session.deviceApiKey === "string" && session.deviceApiKey.trim()
+                ? { deviceApiKey: session.deviceApiKey.trim() }
+                : {}),
             updatedAt: typeof session.updatedAt === "string" ? session.updatedAt : "",
         };
     }
@@ -151,6 +159,9 @@ function findAccountSession(username, env, cfg = loadConfig()) {
             username: normalizedUsername,
             env: selectedEnv,
             token: session.token,
+            ...(typeof session.deviceApiKey === "string" && session.deviceApiKey.trim()
+                ? { deviceApiKey: session.deviceApiKey.trim() }
+                : {}),
             updatedAt: typeof session.updatedAt === "string" ? session.updatedAt : "",
         };
     }
@@ -168,6 +179,7 @@ function saveAccountSession(input) {
     const username = normalizeKey(input.username);
     const env = normalizeKey(input.env);
     const token = input.token.trim();
+    const deviceApiKey = input.deviceApiKey?.trim() || cfg.accounts?.[username]?.[env]?.deviceApiKey?.trim();
     if (!username || !env || !token) {
         throw new Error("invalid_account_session");
     }
@@ -180,6 +192,7 @@ function saveAccountSession(input) {
                 ...(cfg.accounts?.[username] ?? {}),
                 [env]: {
                     token,
+                    ...(deviceApiKey ? { deviceApiKey } : {}),
                     updatedAt: input.updatedAt ?? new Date().toISOString(),
                 },
             },

package/dist/environment.d.ts

@@ -4,7 +4,6 @@ export interface EnvironmentConfig {
     apiBase: string;
     webBase?: string;
     cdnBase?: string;
-    aiBase: string;
     allowInsecureRequests: boolean;
 }
 export declare function resolveEnvironmentConfig(env: string | undefined): EnvironmentConfig | undefined;

package/dist/environment.js

@@ -7,37 +7,31 @@ const DEFAULT_ENVIRONMENTS = {
         apiBase: "http://localhost:4000",
         webBase: "http://localhost:8080",
         cdnBase: "http://localhost:8082",
-        aiBase: "http://localhost:8083",
     },
     local: {
         apiBase: "http://localhost:4000",
         webBase: "https://www.localhost",
         cdnBase: "https://assets-local.playdrop.ai",
-        aiBase: "https://ai.localhost",
     },
     prod: {
         apiBase: "https://api.playdrop.ai",
         webBase: "https://www.playdrop.ai",
         cdnBase: "https://assets.playdrop.ai",
-        aiBase: "https://ai.playdrop.ai",
     },
     preview: {
         apiBase: "https://api.preview.playdrop.ai",
         webBase: "https://preview.playdrop.ai",
         cdnBase: "https://assets.playdrop.ai",
-        aiBase: "https://ai.preview.playdrop.ai",
     },
     blue: {
         apiBase: "https://api.blue.playdrop.ai",
         webBase: "https://blue.playdrop.ai",
         cdnBase: "https://assets.playdrop.ai",
-        aiBase: "https://ai.blue.playdrop.ai",
     },
     green: {
         apiBase: "https://api.green.playdrop.ai",
         webBase: "https://green.playdrop.ai",
         cdnBase: "https://assets.playdrop.ai",
-        aiBase: "https://ai.green.playdrop.ai",
     },
 };
 function normalizeEnvironment(env) {
@@ -71,7 +65,6 @@ function resolveEnvironmentConfig(env) {
     const upper = normalized.toUpperCase();
     const apiOverride = process.env[`PLAYDROP_API_BASE_${upper}`] || process.env.PLAYDROP_API_BASE;
     const webOverride = process.env[`PLAYDROP_WEB_BASE_${upper}`] || process.env.PLAYDROP_WEB_BASE;
-    const aiOverride = process.env[`PLAYDROP_AI_BASE_${upper}`] || process.env.PLAYDROP_AI_BASE;
     const insecureOverride = process.env[`PLAYDROP_INSECURE_${upper}`];
     const cdnOverride = process.env[`PLAYDROP_CDN_BASE_${upper}`] || process.env.PLAYDROP_CDN_BASE;
     const allowInsecure = insecureOverride === "1" || process.env.PLAYDROP_INSECURE === "1";
@@ -80,7 +73,6 @@ function resolveEnvironmentConfig(env) {
         apiBase: trimTrailingSlash(apiOverride || defaults.apiBase),
         webBase: trimTrailingSlash(webOverride || defaults.webBase),
         cdnBase: trimTrailingSlash(cdnOverride || defaults.cdnBase),
-        aiBase: trimTrailingSlash(aiOverride || defaults.aiBase),
         allowInsecureRequests: allowInsecure,
     };
 }

package/dist/index.js

@@ -17,6 +17,7 @@ const browse_1 = require("./commands/browse");
 const search_1 = require("./commands/search");
 const tags_1 = require("./commands/tags");
 const detail_1 = require("./commands/detail");
+const source_1 = require("./commands/source");
 const play_1 = require("./commands/play");
 const ads_1 = require("./commands/ads");
 const comments_1 = require("./commands/comments");
@@ -63,7 +64,7 @@ function printRemovedCommandHint(command) {
     const replacements = {
         list: "playdrop browse",
         generate: "playdrop ai create",
-        generations: "playdrop ai jobs browse",
+        generations: "playdrop ai tasks browse",
         init: "playdrop workspaces init",
         create: "playdrop project create app",
         dev: "playdrop project dev",
@@ -207,6 +208,14 @@ worker
         json: opts.json,
     });
 });
+worker
+    .command("fal")
+    .description("Configure Fal for generated media tasks")
+    .command("configure")
+    .description("Store the Fal API key in this worker's local credential file")
+    .action(async () => {
+    await (0, worker_1.configureWorkerFal)();
+});
 worker
     .command("setup")
     .description("Prepare this machine for PlayDrop worker execution")
@@ -396,17 +405,24 @@ function addChatWriteOptions(command, allowClientKey = true) {
         .option("--text-file <path>", "Read message text from a file")
         .option("--event-type <type>", "Structured event type")
         .option("--event-data-file <path>", "Read structured event JSON from a file")
-        .option("--as-system", "Publish as playdrop-system (admin only)");
+        .option("--as-system", "Publish as playdrop-system (admin only)")
+        .option("--attachment <path>", "Attach a supported file (repeatable)", (value, previous = []) => [
+        ...previous,
+        value,
+    ], []);
     if (allowClientKey)
         command.option("--client-key <key>", "Idempotency key within the channel");
     return addChatReadOptions(command);
 }
 const chat = program.command("chat").description("Read and write PlayDrop Chat");
 addChatReadOptions(chat.command("channels").description("List accessible channels")).action(chat_1.listChatChannels);
+addChatReadOptions(chat.command("inbox").description("List accessible conversations")).action(chat_1.listChatInbox);
+addChatReadOptions(chat.command("conversation <conversation-id>").description("Read a conversation")).action(chat_1.readChatConversation);
 addChatReadOptions(chat.command("read <channel>").description("Read channel messages")).action(chat_1.readChatChannel);
 addChatReadOptions(chat.command("thread <message-id>").description("Read a message thread")).action(chat_1.readChatThread);
 addChatWriteOptions(chat.command("send <channel>").description("Send a channel message")).action(chat_1.sendChatMessage);
 addChatWriteOptions(chat.command("reply <message-id>").description("Reply to a root message")).action(chat_1.replyChatMessage);
+addChatWriteOptions(chat.command("dm <username>").description("Send a direct message")).action(chat_1.sendChatDirectMessage);
 addChatWriteOptions(chat.command("edit <message-id>").description("Edit a message"), false).action(chat_1.editChatMessage);
 addChatReadOptions(chat.command("react <message-id> <emoji>").description("Add a reaction")).action(chat_1.reactChatMessage);
 addChatReadOptions(chat.command("unreact <message-id> <emoji>").description("Remove a reaction")).action(chat_1.unreactChatMessage);
@@ -571,6 +587,40 @@ program
     .action(async (ref, opts) => {
     await (0, detail_1.detail)(ref, opts);
 });
+const asset = program.command("asset").description("Inspect and download assets");
+asset
+    .command("detail <ref>")
+    .description("Show one exact asset")
+    .addOption(createEnvOption())
+    .option("--json", "Output JSON")
+    .action(async (ref, opts) => {
+    await (0, source_1.showExactContentDetail)("asset", ref, opts);
+});
+asset
+    .command("source <ref> [directory]")
+    .description("Download and extract one exact asset source revision")
+    .addOption(createEnvOption())
+    .option("--json", "Output JSON")
+    .action(async (ref, directory, opts) => {
+    await (0, source_1.downloadContentSource)("asset", ref, directory, opts);
+});
+const pack = program.command("pack").description("Inspect and download asset packs");
+pack
+    .command("detail <ref>")
+    .description("Show one exact asset pack")
+    .addOption(createEnvOption())
+    .option("--json", "Output JSON")
+    .action(async (ref, opts) => {
+    await (0, source_1.showExactContentDetail)("pack", ref, opts);
+});
+pack
+    .command("source <ref> [directory]")
+    .description("Download and extract one exact asset pack source version")
+    .addOption(createEnvOption())
+    .option("--json", "Output JSON")
+    .action(async (ref, directory, opts) => {
+    await (0, source_1.downloadContentSource)("pack", ref, directory, opts);
+});
 program
     .command("play <ref>")
     .description("Open one published app in your browser with your current session")
@@ -949,7 +999,10 @@ creationAssetPackVersions
 });
 const ai = program.command("ai").description("AI asset creation");
 ai.command("create <type> <prompt>")
-    .description("Create a new AI-generated asset")
+    .description("Create asynchronous AI text, JSON, or asset generation")
+    .option("--system <prompt>", "System instruction for text or JSON generation")
+    .option("--text-size <size>", "Text or JSON size: small, medium, or large")
+    .option("--schema <jsonOrPath>", "JSON response schema as inline JSON or a JSON file path")
     .option("--asset-name <slug>", "Generated asset slug")
     .option("--asset-display-name <text>", "Generated asset display name")
     .option("--asset-description <text>", "Generated asset description")
@@ -978,6 +1031,9 @@ ai.command("create <type> <prompt>")
     .option("--json", "Output JSON")
     .action(async (type, prompt, opts) => {
     await (0, generation_1.generate)(type, prompt, {
+        system: opts.system,
+        textSize: opts.textSize,
+        responseSchema: opts.schema,
         subcategory: opts.subcategory,
         assetName: opts.assetName,
         assetDisplayName: opts.assetDisplayName,
@@ -1006,16 +1062,16 @@ ai.command("create <type> <prompt>")
         json: opts.json,
     });
 });
-const aiJobs = ai.command("jobs").description("Browse AI generation jobs");
-aiJobs
+const aiTasks = ai.command("tasks").description("Browse AI generation tasks");
+aiTasks
     .command("browse")
-    .description("Browse AI jobs")
-    .option("--type <type>", "image, music, sfx, speech, video, model_3d, or all")
+    .description("Browse AI tasks")
+    .option("--type <type>", "text, json, image, music, sfx, speech, video, model_3d, or all")
     .option("--limit <number>", "Maximum number of results to return")
     .option("--offset <number>", "Result offset")
     .option("--json", "Output JSON")
     .action(async (opts) => {
-    await (0, generation_1.browseGenerationJobs)(opts);
+    await (0, generation_1.browseGenerationTasks)(opts);
 });
 ai.command("generations")
     .description("Browse AI generation history")
@@ -1026,12 +1082,33 @@ ai.command("generations")
     .action(async (opts) => {
     await (0, generation_1.generations)(opts);
 });
-aiJobs
+aiTasks
     .command("detail <id>")
-    .description("Show one AI job")
+    .description("Show one AI task")
+    .option("--json", "Output JSON")
+    .action(async (id, opts) => {
+    await (0, generation_1.showGenerationTask)(id, opts);
+});
+aiTasks
+    .command("events <id>")
+    .description("Show one AI task event stream")
+    .option("--json", "Output JSON")
+    .action(async (id, opts) => {
+    await (0, generation_1.showGenerationTaskEvents)(id, opts);
+});
+aiTasks
+    .command("cancel <id>")
+    .description("Cancel an unfinished AI task")
+    .option("--json", "Output JSON")
+    .action(async (id, opts) => {
+    await (0, generation_1.cancelGenerationTask)(id, opts);
+});
+aiTasks
+    .command("clear <id>")
+    .description("Clear a terminal AI task from the creator task list")
     .option("--json", "Output JSON")
     .action(async (id, opts) => {
-    await (0, generation_1.showGenerationJob)(id, opts);
+    await (0, generation_1.clearGenerationTask)(id, opts);
 });
 const project = program.command("project").description("Local workspace tooling");
 const internalDevRouter = project.command("_dev-router").description("Internal shared dev router");
@@ -1051,9 +1128,9 @@ project
 const projectCreate = project.command("create").description("Create project resources");
 projectCreate
     .command("app <name>")
-    .description("Create a new app from a template or exact remix version")
+    .description("Create a new app from a template")
     .option("--template <ref>", "Template ref")
-    .option("--remix <ref>", "Canonical app version ref")
+    .option("--remix <ref>", "Unsupported: app remixes run only through PlayDrop Cloud")
     .action(async (name, opts) => {
     await (0, create_1.create)(name, opts);
 });
@@ -1121,6 +1198,7 @@ const projectCapture = project.command("capture").description("Record game media
 projectCapture
     .argument("[target]")
     .option("--app <name>", "App name when the target is a workspace")
+    .option("--surface <surface>", "Capture one declared surface: desktop, mobile-landscape, or mobile-portrait")
     .option("--duration <seconds>", "Recording duration in seconds")
     .option("--width <pixels>", "Final gameplay width in pixels")
     .option("--height <pixels>", "Final gameplay height in pixels")
@@ -1132,6 +1210,7 @@ projectCapture
     .action(async (target, opts) => {
     await (0, captureListing_1.captureListing)(target, {
         app: opts.app,
+        surface: opts.surface,
         duration: opts.duration,
         width: opts.width,
         height: opts.height,

package/dist/workerAppProject.d.ts

@@ -1,2 +1,2 @@
 import type { AppTask } from "./catalogue";
-export declare function prepareWorkerAppTask(task: AppTask): AppTask;
+export declare function prepareWorkerAppTask(task: AppTask, gameSourceGit?: boolean): AppTask;

package/dist/workerAppProject.js

@@ -10,8 +10,20 @@ const WORKER_SOURCE_EXCLUDES = [
     ".playdrop-task-events/",
     "bin/playdrop",
 ];
+const GAME_SOURCE_GIT_SOURCE_EXCLUDES = [
+    "PLAYDROP_TASK.md",
+    "AGENTS.md",
+    "CLAUDE.md",
+    ".DS_Store",
+    ".playdrop.json",
+    "bin/playdrop",
+    "next-steps.json",
+    "player-feedback.md",
+    "platform-feedback.md",
+    "source.zip",
+];
 const WORKER_BUNDLE_EXCLUDES = [...WORKER_SOURCE_EXCLUDES, "assets/marketing/", "listing/"];
-function prepareWorkerAppTask(task) {
+function prepareWorkerAppTask(task, gameSourceGit = false) {
     const catalogueRelativePath = (0, node_path_1.relative)(task.projectDir, task.catalogueAbsolutePath).replace(/\\/g, "/");
     const bundleArchiveExcludeRelativeFiles = [
         ...WORKER_BUNDLE_EXCLUDES,
@@ -20,7 +32,8 @@ function prepareWorkerAppTask(task) {
     return {
         ...task,
         versionVisibility: "PRIVATE",
-        sourceArchiveExcludeRelativeFiles: WORKER_SOURCE_EXCLUDES,
+        sourceArchiveExcludeRelativeFiles: gameSourceGit ? GAME_SOURCE_GIT_SOURCE_EXCLUDES : WORKER_SOURCE_EXCLUDES,
+        sourceArchiveGameSourceGit: gameSourceGit,
         bundleArchiveExcludeRelativeFiles,
     };
 }