@playdrop/playdrop-cli 0.9.6 → 0.10.1

package/dist/config.d.ts

@@ -15,6 +15,7 @@ export interface CliConfig {
     token?: string;
     env?: string;
     currentUsername?: string;
+    workerKey?: string;
 }
 export declare function loadConfig(): CliConfig;
 export declare function saveConfig(cfg: CliConfig): void;
@@ -32,6 +33,7 @@ export declare function saveAccountSession(input: {
     token: string;
     updatedAt?: string;
 }): CliConfig;
+export declare function getOrCreateWorkerKey(): string;
 export declare function migrateLegacySession(input: {
     username: string;
     env: string;

package/dist/config.js

@@ -12,9 +12,11 @@ exports.getCurrentAccountSession = getCurrentAccountSession;
 exports.findAccountSession = findAccountSession;
 exports.listAccountSessionsForUsername = listAccountSessionsForUsername;
 exports.saveAccountSession = saveAccountSession;
+exports.getOrCreateWorkerKey = getOrCreateWorkerKey;
 exports.migrateLegacySession = migrateLegacySession;
 exports.setCurrentAccount = setCurrentAccount;
 exports.removeAccountSession = removeAccountSession;
+const crypto_1 = require("crypto");
 const fs_1 = require("fs");
 const path_1 = require("path");
 const os_1 = __importDefault(require("os"));
@@ -52,11 +54,13 @@ function readRawConfig() {
         return {};
     }
 }
+const WORKER_KEY_PATTERN = /^wk_[0-9a-f]{16}$/;
 function stripDerivedFields(cfg) {
     const next = {
         version: typeof cfg.version === 'number' ? cfg.version : undefined,
         currentAccount: cfg.currentAccount ?? undefined,
         accounts: cfg.accounts ? clonePersistedConfig({ accounts: cfg.accounts }).accounts : undefined,
+        workerKey: typeof cfg.workerKey === 'string' && cfg.workerKey.trim().length > 0 ? cfg.workerKey.trim() : undefined,
     };
     if (!next.accounts || Object.keys(next.accounts).length === 0) {
         if (typeof cfg.token === 'string' && cfg.token.trim().length > 0) {
@@ -180,10 +184,27 @@ function saveAccountSession(input) {
                 },
             },
         },
+        workerKey: cfg.workerKey,
     };
     saveConfig(next);
     return loadConfig();
 }
+function assertValidWorkerKey(workerKey) {
+    if (!WORKER_KEY_PATTERN.test(workerKey)) {
+        throw new Error(`invalid_stored_worker_key:${workerKey}`);
+    }
+    return workerKey;
+}
+function getOrCreateWorkerKey() {
+    const cfg = loadConfig();
+    const legacyWorkerKey = typeof cfg.workerKey === 'string' ? cfg.workerKey.trim() : '';
+    if (legacyWorkerKey) {
+        return assertValidWorkerKey(legacyWorkerKey);
+    }
+    const workerKey = `wk_${(0, crypto_1.randomBytes)(8).toString('hex')}`;
+    saveConfig({ ...cfg, workerKey });
+    return workerKey;
+}
 function migrateLegacySession(input) {
     return saveAccountSession(input);
 }
@@ -199,6 +220,7 @@ function setCurrentAccount(input) {
         version: CONFIG_VERSION,
         currentAccount: { username: session.username, env: session.env },
         accounts: cfg.accounts ?? {},
+        workerKey: cfg.workerKey,
     };
     saveConfig(next);
     return loadConfig();
@@ -233,6 +255,7 @@ function removeAccountSession(input = {}) {
         version: CONFIG_VERSION,
         currentAccount: nextCurrent,
         accounts,
+        workerKey: cfg.workerKey,
     };
     if (!nextCurrent && typeof cfg.token === 'string' && typeof cfg.env === 'string' && (!cfg.accounts || Object.keys(cfg.accounts).length === 0)) {
         clearConfig();

package/dist/index.js

@@ -35,6 +35,7 @@ const devServer_1 = require("./commands/devServer");
 const captureListing_1 = require("./commands/captureListing");
 const captureRemote_1 = require("./commands/captureRemote");
 const marketing_1 = require("./commands/marketing");
+const review_1 = require("./commands/review");
 const validate_1 = require("./commands/validate");
 const build_1 = require("./commands/build");
 const format_1 = require("./commands/format");
@@ -44,7 +45,15 @@ const feedback_1 = require("./commands/feedback");
 const changelog_1 = require("./commands/changelog");
 const publicPages_1 = require("./commands/publicPages");
 const upgrade_1 = require("./commands/upgrade");
+const worker_1 = require("./commands/worker");
 const messages_1 = require("./messages");
+// Restricted shim: inside a worker task workspace only task-scoped commands,
+// local validation/run helpers, safe read-only lookups, and AI generation are
+// permitted. Worker lease credentials are never exposed to the agent process.
+if (process.env.PLAYDROP_WORKER_CONTEXT === '1' && !(0, worker_1.isWorkerContextCommandAllowed)(process.argv.slice(2))) {
+    console.error(worker_1.WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE);
+    process.exit(1);
+}
 function printRemovedCommandHint(command) {
     const replacements = {
         list: 'playdrop browse',
@@ -158,6 +167,105 @@ function registerUseAccountCommand(parent) {
 registerLoginCommand(program);
 registerLogoutCommand(program);
 registerWhoamiCommand(program);
+const worker = program.command('worker').description('Run a PlayDrop agent worker on this machine');
+worker
+    .command('start')
+    .description('Start the PlayDrop worker and poll for agent tasks')
+    .option('--env <env>', 'Resolve this command against one logged-in environment')
+    .option('--once', 'Process at most one task then exit')
+    .option('--name <name>', 'Worker display name override')
+    .action(async (opts) => {
+    await (0, worker_1.startWorker)({
+        env: opts.env,
+        once: opts.once,
+        name: opts.name,
+    });
+});
+const task = program.command('task').description('Report agent task progress from a worker workspace');
+task
+    .command('report')
+    .description('Post progress for the active agent task')
+    .option('--phase <phase>', 'Task phase')
+    .option('--pct <number>', 'Percent complete, 0 to 100')
+    .requiredOption('-m, --message <message>', 'Progress message')
+    .option('--env <env>', 'Environment override')
+    .option('--kind <kind>', 'progress')
+    .action(async (opts) => {
+    await (0, worker_1.reportTask)(opts);
+});
+task
+    .command('report-catalogue')
+    .description('Post a catalogue.json preview for the active agent task')
+    .requiredOption('--file <path>', 'Path to catalogue.json')
+    .requiredOption('-m, --message <message>', 'Preview message')
+    .option('--env <env>', 'Environment override')
+    .action(async (opts) => {
+    await (0, worker_1.reportCatalogueTask)(opts);
+});
+task
+    .command('upload')
+    .description('Upload the active agent task project as a private draft')
+    .option('--env <env>', 'Environment override')
+    .action(async (opts) => {
+    await (0, worker_1.uploadTask)(opts);
+});
+task
+    .command('done')
+    .description('Mark the active agent task done after upload')
+    .option('--env <env>', 'Environment override')
+    .action(async (opts) => {
+    await (0, worker_1.completeTask)(opts);
+});
+task
+    .command('submit-review')
+    .description('Submit the active game review task result')
+    .requiredOption('--state <state>', 'Terminal review state')
+    .requiredOption('--message-file <path>', 'Internal assessment file')
+    .option('--creator-feedback-file <path>', 'Creator feedback file')
+    .requiredOption('--evidence-dir <path>', 'Review evidence directory')
+    .option('--env <env>', 'Environment override')
+    .action(async (opts) => {
+    await (0, worker_1.submitReviewTask)(opts);
+});
+task
+    .command('fail')
+    .description('Fail the active agent task')
+    .requiredOption('-m, --message <message>', 'Failure message')
+    .option('--env <env>', 'Environment override')
+    .action(async (opts) => {
+    await (0, worker_1.failTask)(opts);
+});
+const review = program.command('review').description('Review helper commands for PlayDrop worker tasks');
+review
+    .command('validate-result')
+    .description('Validate a canonical game review result')
+    .requiredOption('--state <state>', 'Terminal review state')
+    .requiredOption('--message-file <path>', 'Internal assessment file')
+    .option('--creator-feedback-file <path>', 'Creator feedback file')
+    .requiredOption('--evidence-dir <path>', 'Review evidence directory')
+    .action(async (opts) => {
+    await (0, review_1.validateReviewResultCommand)(opts);
+});
+review
+    .command('compose-evidence')
+    .description('Compose review screenshots into one evidence image')
+    .requiredOption('--core <path>', 'Core gameplay screenshot')
+    .requiredOption('--win <path>', 'Win or progression screenshot')
+    .requiredOption('--loss <path>', 'Loss or failure screenshot')
+    .requiredOption('--out <path>', 'Output PNG path')
+    .action(async (opts) => {
+    await (0, review_1.composeReviewEvidence)(opts);
+});
+review
+    .command('rating-card')
+    .description('Render a review rating card PNG')
+    .requiredOption('--review-message-file <path>', 'Internal assessment file')
+    .requiredOption('--out <path>', 'Output PNG path')
+    .option('--punchline <text>', 'Override punchline text')
+    .option('--title <text>', 'Card title')
+    .action(async (opts) => {
+    await (0, review_1.createReviewRatingCard)(opts);
+});
 const auth = program.command('auth').description('Authentication commands');
 registerLoginCommand(auth);
 registerLogoutCommand(auth);
@@ -505,32 +613,6 @@ creations
     .action(async (opts) => {
     await (0, creations_1.browseCreations)(opts);
 });
-const creationIdeas = creations.command('ideas').description('Manage game ideas');
-creationIdeas
-    .command('browse')
-    .description('Browse your game ideas')
-    .option('--state <state>', 'idea, started, shipped, 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, creations_1.browseCreationIdeas)(opts);
-});
-creationIdeas
-    .command('start <idOrSlug>')
-    .description('Mark a game idea as started')
-    .option('--json', 'Output JSON')
-    .action(async (idOrSlug, opts) => {
-    await (0, creations_1.startCreationIdea)(idOrSlug, opts);
-});
-creationIdeas
-    .command('ship <idOrSlug>')
-    .description('Mark a game idea as shipped')
-    .requiredOption('--app <creator/name>', 'Created app ref')
-    .option('--json', 'Output JSON')
-    .action(async (idOrSlug, opts) => {
-    await (0, creations_1.shipCreationIdea)(idOrSlug, opts);
-});
 const creationApps = creations.command('apps').description('Manage app creations');
 creationApps
     .command('update <name>')
@@ -721,6 +803,7 @@ ai
     .option('--texture', 'Enable texturing')
     .option('--timeout <seconds>', 'Wait timeout in seconds')
     .option('--poll <milliseconds>', 'Polling interval in milliseconds')
+    .option('--output <path>', 'Write generated image bytes to a local file (image only)')
     .option('--json', 'Output JSON')
     .action(async (type, prompt, opts) => {
     await (0, generation_1.generate)(type, prompt, {
@@ -748,6 +831,7 @@ ai
         texture: opts.texture,
         timeoutSeconds: opts.timeout,
         pollIntervalMs: opts.poll,
+        output: opts.output,
         json: opts.json,
     });
 });
@@ -800,7 +884,6 @@ projectCreate
     .description('Create a new app from a template or exact remix version')
     .option('--template <ref>', 'Template ref')
     .option('--remix <ref>', 'Canonical app version ref')
-    .option('--game-idea <idOrSlug>', 'Game idea id or slug to infer the source and mark started')
     .action(async (name, opts) => {
     await (0, create_1.create)(name, opts);
 });
@@ -828,10 +911,11 @@ project
     .command('dev [target]')
     .description('Run an app locally')
     .option('--app <name>', 'App name when the target is a workspace')
+    .option('--port <number>', 'Local dev router port')
     .option('--dev-auth <mode>', 'prompt, anonymous, viewer, or player')
     .option('--player <slot>', '1, 2, 3, or 4 when --dev-auth player is selected')
     .action(async (target, opts = {}) => {
-    await (0, dev_1.dev)(target, undefined, opts.app, {
+    await (0, dev_1.dev)(target, opts.port, opts.app, {
         devAuth: opts.devAuth,
         player: opts.player,
     });
@@ -853,6 +937,7 @@ const projectCapture = project.command('capture').description('Run a Playwright
 projectCapture
     .argument('[target]')
     .option('--app <name>', 'App name when the target is a workspace')
+    .option('--port <number>', 'Local dev router port')
     .option('--timeout <seconds>', 'Capture timeout in seconds')
     .option('--log-level <level>', 'debug, info, warn, or error')
     .option('--screenshot <path>', 'Screenshot output path')
@@ -867,6 +952,7 @@ projectCapture
     await (0, capture_1.capture)(target, {
         timeoutSeconds,
         appName: opts.app,
+        port: opts.port,
         logLevel: opts.logLevel,
         screenshotPath: opts.screenshot,
         surfaceTarget: opts.surface,
@@ -909,6 +995,8 @@ projectCapture
     .option('--screenshot <path>', 'Screenshot output path')
     .option('--log <path>', 'Log output path')
     .option('--expected-url <url>', 'Expected final URL after redirects')
+    .option('--actions <path>', 'JSON action file with click, press, and wait steps before screenshot')
+    .option('--viewport <size>', 'Viewport size as WIDTHxHEIGHT')
     .option('--username <username>', 'Login username')
     .option('--password <password>', 'Login password')
     .option('--login-url <url>', 'Explicit login URL')
@@ -992,7 +1080,6 @@ project
     .option('--env <env>', 'Resolve this command against one logged-in environment')
     .option('--skip-ecs', 'Skip ecs.json and server.js during publish')
     .option('--clear-tags', 'Confirm clearing existing live tags when this publish removes them')
-    .option('--game-idea <idOrSlug>', 'Game idea id or slug to mark shipped')
     .addOption(new commander_1.Option('--skip-review', 'Mark uploaded app versions as NOT_REQUIRED review. Admin-only.').hideHelp())
     .action(async (target, opts) => {
     await (0, upload_1.upload)(target ?? '.', {
@@ -1000,7 +1087,6 @@ project
         skipEcs: opts.skipEcs,
         skipReview: opts.skipReview,
         clearTags: opts.clearTags,
-        gameIdea: opts.gameIdea,
     });
 });
 const documentation = program.command('documentation').description('Public Playdrop documentation');

package/dist/shellProbe.d.ts

@@ -3,4 +3,4 @@ export interface ShellProbeResult {
     output: string;
 }
 export declare function buildCommandPathProbe(command: string, platform?: NodeJS.Platform): string;
-export declare function runShell(command: string, platform?: NodeJS.Platform): ShellProbeResult;
+export declare function runShell(command: string, platform?: NodeJS.Platform, timeoutMs?: number): ShellProbeResult;

package/dist/shellProbe.js

@@ -6,10 +6,10 @@ const node_child_process_1 = require("node:child_process");
 function buildCommandPathProbe(command, platform = process.platform) {
     return platform === 'win32' ? `where ${command}` : `command -v ${command}`;
 }
-function runShell(command, platform = process.platform) {
+function runShell(command, platform = process.platform, timeoutMs = 30000) {
     const result = platform === 'win32'
-        ? (0, node_child_process_1.spawnSync)('cmd.exe', ['/d', '/s', '/c', command], { encoding: 'utf8', timeout: 10000 })
-        : (0, node_child_process_1.spawnSync)('/bin/zsh', ['-lc', command], { encoding: 'utf8', timeout: 10000 });
+        ? (0, node_child_process_1.spawnSync)('cmd.exe', ['/d', '/s', '/c', command], { encoding: 'utf8', timeout: timeoutMs })
+        : (0, node_child_process_1.spawnSync)('/bin/zsh', ['-lc', command], { encoding: 'utf8', timeout: timeoutMs });
     return {
         exitCode: result.status ?? 1,
         output: `${result.stdout ?? ''}${result.stderr ?? ''}`.trim(),

package/dist/workspaceAuth.d.ts

@@ -1,6 +1,9 @@
 export interface WorkspaceAuthConfig {
     ownerUsername: string;
     env?: string;
+    taskToken?: string;
+    taskId?: number;
+    taskAttempt?: number;
 }
 export interface ResolvedWorkspaceAuthConfig {
     path: string;

package/dist/workspaceAuth.js

@@ -27,6 +27,17 @@ function normalizeEnv(value) {
     const normalized = value.trim();
     return normalized.length > 0 ? normalized : undefined;
 }
+function normalizeTaskToken(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : undefined;
+}
+function normalizePositiveInteger(value) {
+    const parsed = typeof value === 'number' ? value : Number.parseInt(String(value ?? ''), 10);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined;
+}
 function readWorkspaceAuthConfig(filePath) {
     let parsed;
     try {
@@ -46,6 +57,9 @@ function readWorkspaceAuthConfig(filePath) {
     return {
         ownerUsername,
         env: normalizeEnv(parsed.env),
+        taskToken: normalizeTaskToken(parsed.taskToken),
+        taskId: normalizePositiveInteger(parsed.taskId),
+        taskAttempt: normalizePositiveInteger(parsed.taskAttempt),
     };
 }
 function findWorkspaceAuthConfig(startPath) {

package/node_modules/@playdrop/api-client/dist/client.d.ts

@@ -1,5 +1,5 @@
-import type { AppleOAuthHandoffExchangeRequest, AppleOAuthHandoffExchangeResponse, AppleOAuthLinkStartRequest, AppleOAuthLinkStartResponse, ApplePushDeviceRequest, ApplePushDeviceStatusResponse, FirebasePushDeviceRequest, FirebasePushDeviceStatusResponse, ApiKeyLoginRequest, CliApiKeyStatusResponse, CliLoginApproveRequest, CliLoginApproveResponse, CliLoginPollRequest, CliLoginPollResponse, CliLoginStartResponse, CliLoginStatusResponse, CliWebLaunchStartRequest, CliWebLaunchStartResponse, CompleteXSignupRequest, CompleteXSignupResponse, DeleteMyAccountRequest, DeleteMyAccountResponse, LoginRequest, LoginResponse, LogoutResponse, PrivacyExportResponse, RegisterRequest, RegisterResponse, StarterProfileAssetsResponse, CreateAppRequest, CreateAppResponse, UpdateAppRequest, AdminUpdateAppRequest, UpdateAppResponse, AppsListResponse, AppBrowseRequest, AppDetailRequest, AppDetailResponse, AppMoreCollectionKey, AppMoreCollectionPage, AppMoreCollectionRequest, AppMoreCollectionsRequest, AppMoreCollectionsResponse, CreatorAppsBrowseRequest, AppRuntimeAssetsResponse, ContentLicense, InitializeAppUploadRequest, InitializeAppUploadResponse, UploadAppSessionFileResponse, UploadAppSessionOwnedAssetResponse, FinalizeAppUploadResponse, AppUploadLaunchCheckPreviewResponse, AbortAppUploadResponse, RecordAppUploadLaunchCheckRequest, RecordAppUploadLaunchCheckResponse, MyAppsResponse, BootstrapResponse, SetProfileAssetRequest, SetProfileAssetResponse, MeResponse, UserDetailResponse, UsersListResponse, CreateUserRequest, CreateUserResponse, UpdateAdminUserRequest, RemixScaffoldResponse, TemplateScaffoldResponse, HomeResponse, HomeCollectionPageResponse, FetchHomeOptions, DeleteAppResponse, AppType, AppAccessTokenResponse, DevAppAccessTokenResponse, DevPlayerResetResponse, AppLogEntryRequest, AppLogEntryResponse, ClaimFreeCreditRewardResponse, SubmitFeedbackRequest, SubmitFeedbackResponse, FeedbackListResponse, AdminFeedbackListResponse, AdminFeedbackResponse, UpdateAdminFeedbackRequest, UpdateAdminFeedbackResponse, DeleteFeedbackResponse, FeedbackCategory, FeedbackClient, FeedbackStatus, ShopResponse, AppleCreditPackFulfillmentRequest, AdInterstitialShowResponse, AdLoadResponse, AdShowRequest, AdRewardedShowResponse, AssetPurchaseRequest, BoostActivationRequest, BoostBalanceResponse, BoostHistoryResponse, BoostPurchaseRequest, BoostPurchaseResponse, BoostReportQuery, BoostReportResponse, BoostStatusResponse, AdLoadRequest, CreditPackCheckoutSessionRequest, PurchaseResponse, CreditPackCheckoutSessionResponse, CreditPackCheckoutStatusResponse, CreatorEarningsResponse, GoogleCreditPackFulfillmentRequest, MobileCreditPackFulfillmentResponse, TransactionsResponse, CreditPacksResponse, CreditPackResponse, PaymentProvider, PaymentStatus, AdminPaymentsListResponse, AdminPaymentDetailResponse, AdminRefundPaymentRequest, IapPurchaseRequest, IapPurchaseResponse, IapReceiptsResponse, IapReceiptListParams, IapReceiptResponse, AdminCreditTransactionsResponse, AiGenerationsResponse, AiGenerationDetailResponse, OwnedProfileAssetsResponse, SavedItemKind, CreateContentReportRequest, CreateCreatorReportRequest, CreateCommentReportRequest, CreatorBlockMutationResponse, LikedItemMutationResponse, DislikedItemMutationResponse, ModerationReportResponse, SavedItemMutationResponse, LibraryCategory, LibrarySort, LibraryResponse, TrackEngagementEventRequest, TrackEngagementEventResponse, CreatorFollowMutationResponse, ContentCommentsResponse, CreateContentCommentRequest, CreateContentCommentResponse, FollowingSort, FollowingCreatorsResponse, FollowingFeedSection, FollowingFeedResponse, DeleteContentCommentResponse, NotificationStatus, NotificationsResponse, NotificationReadResponse, EmailPreferencesResponse, UpdateUserCommunicationPreferencesRequest, PublicEmailPreferencesResponse, PublicEmailPreferencesUpdateRequest, EmailUnsubscribeResponse, AdminCreatorEngagementRulesResponse, AdminCreatorEngagementExecutionsResponse, AdminCreatorEngagementUserResponse, AdminCreatorEngagementRulePreviewRequest, AdminCreatorEngagementRulePreviewResponse, CreatorEngagementRuleExecutionStatus, PushSubscriptionMutationResponse, AdminUserResponse, DeleteAdminUserResponse, BatchCreateUsersResponse, UpsertWebPushSubscriptionRequest, UpdateProfileRequest, UpdateProfileResponse, WebPushConfigResponse, WebPushSubscriptionStatusResponse, ChangePasswordRequest, ChangePasswordResponse, UpgradeToCreatorResponse, AppleLinkRequest, AppleLinkResponse, AppleNativeChallengeResponse, ApplePendingSignupResponse, AppleSignInRequest, AppleSignInResponse, UnlinkXResponse, UnlinkGoogleResponse, GooglePendingSignupResponse, XPendingSignupResponse, GoogleOneTapExchangeRequest, GoogleOneTapExchangeResponse, UsernameAvailableResponse, CompleteAppleSignupRequest, CompleteAppleSignupResponse, CompleteGoogleSignupRequest, CompleteGoogleSignupResponse, GoogleAppleLinkRequest, GoogleAppleLinkResponse, GoogleAppleSignInRequest, GoogleAppleSignInResponse, AdminAppPlayerMetaResponse, AdminAppPlayerMetaUserResponse, AdminAppVersionReviewsListResponse, AdminClaimNextAppVersionReviewResponse, AdminMutateAchievementStateRequest, AdminMutateAchievementStateResponse, AdminMutateLeaderboardScoreRequest, AdminMutateLeaderboardScoreResponse, AdminRetirePlayerMetaDefinitionResponse, AdminUpdateAppVersionReviewRequest, AdminUpdateAppVersionReviewResponse, CreateCliApiKeyResponse, GetAchievementResponse, GetLeaderboardResponse, ListAchievementsResponse, ListLeaderboardsResponse, MyAchievementsResponse, MyLeaderboardsResponse, SetAchievementProgressRequest, SetAchievementProgressResponse, SubmitLeaderboardScoreRequest, SubmitLeaderboardScoreResponse, UnlockAchievementResponse, ReviewState, AppVersionVisibility, AppVersionsListResponse, AppVersionDetailResponse, AppSourceBundleResponse, UpdateVersionResponse, DeleteVersionResponse, AdminAppsListResponse, AdminGameCollectionCandidatesResponse, AdminGameCollectionResponse, AdminGameCollectionsResponse, AdminUpdateAppResponse, CreateAdminGameCollectionRequest, DeleteAdminGameCollectionResponse, UpdateAdminGameCollectionGamesRequest, UpdateAdminGameCollectionRequest, AssetBrowseKind, AssetCategory, AssetFormat, AssetVisibility, AssetSourceKind, AssetListSort, AssetListResponse, AssetCategoriesResponse, AssetDetailResponse, AssetVersionsListResponse, CreateAssetVersionResponse, DeleteOwnedCustomAssetResponse, CreateAssetSpecVersionResponse, ListOwnedCustomAssetsResponse, LoadOwnedCustomAssetResponse, MutateOwnedCustomAssetRequest, MutateOwnedCustomAssetResponse, UpdateAssetRequest, UpdateAssetResponse, UpdateAssetVersionRequest, UpdateAssetVersionResponse, UpdateAssetSpecVersionResponse, DeleteAssetVersionResponse, DeleteAssetResponse, DeleteAssetSpecVersionResponse, DeleteAssetSpecResponse, AssetSourceBundleResponse, AssetPackListSort, AssetSpecAssetsListResponse, AssetSpecAppsListResponse, AssetSpecDetailResponse, AssetSpecListSort, AssetSpecListResponse, AssetSpecVersionResponseEnvelope, AssetSpecVersionsListResponse, AssetPackSourceBundleResponse, AssetPackListResponse, AssetPackDetailResponse, AssetPackVersionsListResponse, InitializeAssetPackUploadRequest, InitializeAssetPackUploadResponse, UploadAssetPackSessionAssetResponse, UploadAssetPackSessionMediaResponse, FinalizeAssetPackUploadResponse, AbortAssetPackUploadResponse, UpdateAssetPackRequest, UpdateAssetPackResponse, UpdateAssetPackVersionRequest, UpdateAssetPackVersionResponse, DeleteAssetPackVersionResponse, DeleteAssetPackResponse, BatchUpsertNodeRelationsRequest, BatchUpsertNodeRelationsResponse, ContentRemixRelationsResponse, SearchRequest, SearchResponse, SearchSuggestRequest, SearchSuggestResponse, AdminTagGroupResponse, AdminTagGroupsResponse, AdminTagResponse, CreateTagGroupRequest, CreateTagRequest, TagDirectoryResponse, TagDetailResponse, TagGroupDetailResponse, TagGroupSort, TagListResponse, UpdateTagGroupRequest, UpdateTagRequest, FreeCreditsResponse, InvitePreviewResponse, MyInviteCodeResponse, CreateGameIdeaResponse, GameIdeaDetailResponse, GameIdeaStatusResponse, GameIdeasListRequest, GameIdeasListResponse, RemixCandidatesResponse, ShipGameIdeaRequest, ShipGameIdeaResponse, StartGameIdeaRequest, StartGameIdeaResponse, UpdateGameIdeaRequest, UpdateGameIdeaResponse } from '@playdrop/types';
-import { type CreateGameIdeaOptions } from './domains/game-ideas.js';
+import type { AppleOAuthHandoffExchangeRequest, AppleOAuthHandoffExchangeResponse, AppleOAuthLinkStartRequest, AppleOAuthLinkStartResponse, ApplePushDeviceRequest, ApplePushDeviceStatusResponse, FirebasePushDeviceRequest, FirebasePushDeviceStatusResponse, ApiKeyLoginRequest, CliApiKeyStatusResponse, CliLoginApproveRequest, CliLoginApproveResponse, CliLoginPollRequest, CliLoginPollResponse, CliLoginStartResponse, CliLoginStatusResponse, CliWebLaunchStartRequest, CliWebLaunchStartResponse, CompleteXSignupRequest, CompleteXSignupResponse, DeleteMyAccountRequest, DeleteMyAccountResponse, LoginRequest, LoginResponse, LogoutResponse, PrivacyExportResponse, RegisterRequest, RegisterResponse, StarterProfileAssetsResponse, CreateAppRequest, CreateAppResponse, UpdateAppRequest, AdminUpdateAppRequest, UpdateAppResponse, AppsListResponse, AppBrowseRequest, AppDetailRequest, AppDetailResponse, AppMoreCollectionKey, AppMoreCollectionPage, AppMoreCollectionRequest, AppMoreCollectionsRequest, AppMoreCollectionsResponse, CreatorAppsBrowseRequest, AppRuntimeAssetsResponse, ContentLicense, InitializeAppUploadRequest, InitializeAppUploadResponse, UploadAppSessionFileResponse, UploadAppSessionOwnedAssetResponse, FinalizeAppUploadResponse, AppUploadLaunchCheckPreviewResponse, AbortAppUploadResponse, RecordAppUploadLaunchCheckRequest, RecordAppUploadLaunchCheckResponse, MyAppsResponse, BootstrapResponse, SetProfileAssetRequest, SetProfileAssetResponse, MeResponse, UserDetailResponse, UsersListResponse, CreateUserRequest, CreateUserResponse, UpdateAdminUserRequest, RemixScaffoldResponse, TemplateScaffoldResponse, HomeResponse, HomeCollectionPageResponse, FetchHomeOptions, DeleteAppResponse, AppType, AppAccessTokenResponse, DevAppAccessTokenResponse, DevPlayerResetResponse, AppLogEntryRequest, AppLogEntryResponse, ClaimFreeCreditRewardResponse, SubmitFeedbackRequest, SubmitFeedbackResponse, FeedbackListResponse, AdminFeedbackListResponse, AdminFeedbackResponse, UpdateAdminFeedbackRequest, UpdateAdminFeedbackResponse, DeleteFeedbackResponse, FeedbackCategory, FeedbackClient, FeedbackStatus, ShopResponse, AppleCreditPackFulfillmentRequest, AdInterstitialShowResponse, AdLoadResponse, AdShowRequest, AdRewardedShowResponse, AssetPurchaseRequest, BoostActivationRequest, BoostBalanceResponse, BoostHistoryResponse, BoostPurchaseRequest, BoostPurchaseResponse, BoostReportQuery, BoostReportResponse, BoostStatusResponse, AdLoadRequest, CreditPackCheckoutSessionRequest, PurchaseResponse, CreditPackCheckoutSessionResponse, CreditPackCheckoutStatusResponse, CreatorEarningsResponse, GoogleCreditPackFulfillmentRequest, MobileCreditPackFulfillmentResponse, TransactionsResponse, CreditPacksResponse, CreditPackResponse, PaymentProvider, PaymentStatus, AdminPaymentsListResponse, AdminPaymentDetailResponse, AdminPlatformAnalyticsRequest, AdminPlatformAnalyticsResponse, AdminRefundPaymentRequest, IapPurchaseRequest, IapPurchaseResponse, IapReceiptsResponse, IapReceiptListParams, IapReceiptResponse, AdminCreditTransactionsResponse, AiGenerationsResponse, AiGenerationDetailResponse, OwnedProfileAssetsResponse, SavedItemKind, CreateContentReportRequest, CreateCreatorReportRequest, CreateCommentReportRequest, CreatorBlockMutationResponse, LikedItemMutationResponse, DislikedItemMutationResponse, ModerationReportResponse, SavedItemMutationResponse, LibraryCategory, LibrarySort, LibraryResponse, TrackEngagementEventRequest, TrackEngagementEventResponse, CreatorFollowMutationResponse, ContentCommentsResponse, CreateContentCommentRequest, CreateContentCommentResponse, FollowingSort, FollowingCreatorsResponse, FollowingFeedSection, FollowingFeedResponse, DeleteContentCommentResponse, NotificationStatus, NotificationsResponse, NotificationReadResponse, EmailPreferencesResponse, UpdateUserCommunicationPreferencesRequest, PublicEmailPreferencesResponse, PublicEmailPreferencesUpdateRequest, EmailUnsubscribeResponse, AdminCreatorEngagementRulesResponse, AdminCreatorEngagementExecutionsResponse, AdminCreatorEngagementUserResponse, AdminCreatorEngagementRulePreviewRequest, AdminCreatorEngagementRulePreviewResponse, CreatorEngagementRuleExecutionStatus, PushSubscriptionMutationResponse, AdminUserResponse, DeleteAdminUserResponse, BatchCreateUsersResponse, UpsertWebPushSubscriptionRequest, UpdateProfileRequest, UpdateProfileResponse, WebPushConfigResponse, WebPushSubscriptionStatusResponse, ChangePasswordRequest, ChangePasswordResponse, UpgradeToCreatorResponse, AppleLinkRequest, AppleLinkResponse, AppleNativeChallengeResponse, ApplePendingSignupResponse, AppleSignInRequest, AppleSignInResponse, UnlinkXResponse, UnlinkGoogleResponse, GooglePendingSignupResponse, XPendingSignupResponse, GoogleOneTapExchangeRequest, GoogleOneTapExchangeResponse, UsernameAvailableResponse, CompleteAppleSignupRequest, CompleteAppleSignupResponse, CompleteGoogleSignupRequest, CompleteGoogleSignupResponse, GoogleAppleLinkRequest, GoogleAppleLinkResponse, GoogleAppleSignInRequest, GoogleAppleSignInResponse, AdminAppPlayerMetaResponse, AdminAppPlayerMetaUserResponse, AdminAppVersionReviewsListResponse, AdminEnqueueNextAppVersionReviewTaskResponse, AdminMutateAchievementStateRequest, AdminMutateAchievementStateResponse, AdminMutateLeaderboardScoreRequest, AdminMutateLeaderboardScoreResponse, AdminRetirePlayerMetaDefinitionResponse, AdminUpdateAppVersionReviewRequest, AdminUpdateAppVersionReviewResponse, CreateCliApiKeyResponse, GetAchievementResponse, GetLeaderboardResponse, ListAchievementsResponse, ListLeaderboardsResponse, MyAchievementsResponse, MyLeaderboardsResponse, SetAchievementProgressRequest, SetAchievementProgressResponse, SubmitLeaderboardScoreRequest, SubmitLeaderboardScoreResponse, UnlockAchievementResponse, ReviewState, AppVersionVisibility, AppVersionsListResponse, AppVersionDetailResponse, AppSourceBundleResponse, UpdateVersionResponse, DeleteVersionResponse, AdminAppsListResponse, AdminGameCollectionCandidatesResponse, AdminGameCollectionResponse, AdminGameCollectionsResponse, AdminUpdateAppResponse, CreateAdminGameCollectionRequest, DeleteAdminGameCollectionResponse, UpdateAdminGameCollectionGamesRequest, UpdateAdminGameCollectionRequest, AssetBrowseKind, AssetCategory, AssetFormat, AssetVisibility, AssetSourceKind, AssetListSort, AssetListResponse, AssetCategoriesResponse, AssetDetailResponse, AssetVersionsListResponse, CreateAssetVersionResponse, DeleteOwnedCustomAssetResponse, CreateAssetSpecVersionResponse, ListOwnedCustomAssetsResponse, LoadOwnedCustomAssetResponse, MutateOwnedCustomAssetRequest, MutateOwnedCustomAssetResponse, UpdateAssetRequest, UpdateAssetResponse, UpdateAssetVersionRequest, UpdateAssetVersionResponse, UpdateAssetSpecVersionResponse, DeleteAssetVersionResponse, DeleteAssetResponse, DeleteAssetSpecVersionResponse, DeleteAssetSpecResponse, AssetSourceBundleResponse, AssetPackListSort, AssetSpecAssetsListResponse, AssetSpecAppsListResponse, AssetSpecDetailResponse, AssetSpecListSort, AssetSpecListResponse, AssetSpecVersionResponseEnvelope, AssetSpecVersionsListResponse, AssetPackSourceBundleResponse, AssetPackListResponse, AssetPackDetailResponse, AssetPackVersionsListResponse, InitializeAssetPackUploadRequest, InitializeAssetPackUploadResponse, UploadAssetPackSessionAssetResponse, UploadAssetPackSessionMediaResponse, FinalizeAssetPackUploadResponse, AbortAssetPackUploadResponse, UpdateAssetPackRequest, UpdateAssetPackResponse, UpdateAssetPackVersionRequest, UpdateAssetPackVersionResponse, DeleteAssetPackVersionResponse, DeleteAssetPackResponse, BatchUpsertNodeRelationsRequest, BatchUpsertNodeRelationsResponse, ContentRemixRelationsResponse, SearchRequest, SearchResponse, SearchSuggestRequest, SearchSuggestResponse, AdminTagGroupResponse, AdminTagGroupsResponse, AdminTagResponse, CreateTagGroupRequest, CreateTagRequest, TagDirectoryResponse, TagDetailResponse, TagGroupDetailResponse, TagGroupSort, TagListResponse, UpdateTagGroupRequest, UpdateTagRequest, AdminAgentTaskDetailResponse, AdminAgentTaskTranscriptResponse, AdminAgentTasksResponse, AdminAgentWorkersStatusResponse, AgentTaskAvailabilityResponse, AgentTaskAttachmentUploadResponse, AgentTaskDetailResponse, AgentTaskEventsResponse, AgentTaskKind, AgentTaskNewGameSuggestionsResponse, AgentTasksResponse, AppAgentTaskResponse, CancelAgentTaskResponse, ClearAgentTaskResponse, CreateAppAgentTaskRequest, CreateAppAgentTaskResponse, CreateNewGameAgentTaskRequest, CreateNewGameAgentTaskResponse, CreatorGamesListResponse, CreatorGameStatusResponse, CreatorGameVersionsResponse, MeAgentWorkersResponse, RetryAgentTaskResponse, WorkerClaimAgentTaskRequest, WorkerClaimAgentTaskResponse, WorkerCompleteAgentTaskRequest, WorkerCreateAgentTaskEventRequest, WorkerCreateAgentTaskEventResponse, WorkerCreateAgentTaskTranscriptChunkRequest, WorkerCreateAgentTaskTranscriptChunkResponse, WorkerFailAgentTaskRequest, WorkerHeartbeatAgentTaskRequest, WorkerHeartbeatAgentTaskResponse, WorkerRecordAgentTaskRunTelemetryRequest, WorkerRecordAgentTaskRunTelemetryResponse, WorkerPresenceRequest, WorkerPresenceResponse, WorkerSubmitAgentTaskReviewRequest, WorkerSubmitAgentTaskReviewResponse, FreeCreditsResponse, InvitePreviewResponse, MyInviteCodeResponse } from '@playdrop/types';
+import { type AdminAgentTaskTranscriptOptions, type ListCreatorGamesOptions, type ListAgentTasksOptions } from './domains/agent-tasks.js';
 export interface HttpMethod {
     GET: 'GET';
     POST: 'POST';
@@ -132,18 +132,37 @@ export interface ApiClient {
     fetchInvitePreview(inviteCode: string): Promise<InvitePreviewResponse>;
     fetchMyInviteCode(): Promise<MyInviteCodeResponse>;
     submitMyInviteCode(inviteCode: string): Promise<MyInviteCodeResponse>;
-    createGameIdea(options: CreateGameIdeaOptions): Promise<CreateGameIdeaResponse>;
-    listGameIdeas(options?: GameIdeasListRequest): Promise<GameIdeasListResponse>;
-    getGameIdea(idOrSlug: string): Promise<GameIdeaDetailResponse>;
-    getGameIdeaStatus(idOrSlug: string): Promise<GameIdeaStatusResponse>;
-    updateGameIdea(idOrSlug: string, body: UpdateGameIdeaRequest): Promise<UpdateGameIdeaResponse>;
-    startGameIdea(idOrSlug: string, body?: StartGameIdeaRequest): Promise<StartGameIdeaResponse>;
-    shipGameIdea(idOrSlug: string, body: ShipGameIdeaRequest): Promise<ShipGameIdeaResponse>;
-    fetchRemixCandidates(options?: {
-        q?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<RemixCandidatesResponse>;
+    uploadAgentTaskAttachment(file: Blob, description?: string, filename?: string): Promise<AgentTaskAttachmentUploadResponse>;
+    createNewGameAgentTask(body: CreateNewGameAgentTaskRequest): Promise<CreateNewGameAgentTaskResponse>;
+    createAppAgentTask(appName: string, body: CreateAppAgentTaskRequest): Promise<CreateAppAgentTaskResponse>;
+    getAppAgentTask(appName: string): Promise<AppAgentTaskResponse>;
+    getAppAgentTaskAvailability(appName: string): Promise<AgentTaskAvailabilityResponse>;
+    getAgentTaskAvailability(kind: AgentTaskKind): Promise<AgentTaskAvailabilityResponse>;
+    listNewGameSuggestions(): Promise<AgentTaskNewGameSuggestionsResponse>;
+    listAgentTasks(options?: ListAgentTasksOptions): Promise<AgentTasksResponse>;
+    listCreatorGames(options?: ListCreatorGamesOptions): Promise<CreatorGamesListResponse>;
+    getCreatorGameStatus(gameRef: string): Promise<CreatorGameStatusResponse>;
+    listCreatorGameVersions(gameRef: string): Promise<CreatorGameVersionsResponse>;
+    getAgentTask(taskId: number): Promise<AgentTaskDetailResponse>;
+    listAgentTaskEvents(taskId: number): Promise<AgentTaskEventsResponse>;
+    enableAgentTaskReadyNotification(taskId: number): Promise<AgentTaskDetailResponse>;
+    cancelAgentTask(taskId: number): Promise<CancelAgentTaskResponse>;
+    clearAgentTask(taskId: number): Promise<ClearAgentTaskResponse>;
+    retryAgentTask(taskId: number): Promise<RetryAgentTaskResponse>;
+    listMyAgentWorkers(): Promise<MeAgentWorkersResponse>;
+    workerPresence(body: WorkerPresenceRequest): Promise<WorkerPresenceResponse>;
+    workerClaimAgentTask(body: WorkerClaimAgentTaskRequest): Promise<WorkerClaimAgentTaskResponse>;
+    workerHeartbeatAgentTask(taskId: number, body: WorkerHeartbeatAgentTaskRequest): Promise<WorkerHeartbeatAgentTaskResponse>;
+    workerCreateAgentTaskEvent(taskId: number, body: WorkerCreateAgentTaskEventRequest): Promise<WorkerCreateAgentTaskEventResponse>;
+    workerAppendAgentTaskTranscriptChunks(taskId: number, body: WorkerCreateAgentTaskTranscriptChunkRequest): Promise<WorkerCreateAgentTaskTranscriptChunkResponse>;
+    workerRecordAgentTaskRunTelemetry(taskId: number, body: WorkerRecordAgentTaskRunTelemetryRequest): Promise<WorkerRecordAgentTaskRunTelemetryResponse>;
+    workerCompleteAgentTask(taskId: number, body: WorkerCompleteAgentTaskRequest): Promise<AgentTaskDetailResponse>;
+    workerSubmitAgentTaskReview(taskId: number, body: WorkerSubmitAgentTaskReviewRequest): Promise<WorkerSubmitAgentTaskReviewResponse>;
+    workerFailAgentTask(taskId: number, body: WorkerFailAgentTaskRequest): Promise<AgentTaskDetailResponse>;
+    adminListAgentTasks(options?: ListAgentTasksOptions): Promise<AdminAgentTasksResponse>;
+    adminGetAgentTask(taskId: number): Promise<AdminAgentTaskDetailResponse>;
+    adminGetAgentTaskTranscript(taskId: number, options?: AdminAgentTaskTranscriptOptions): Promise<AdminAgentTaskTranscriptResponse>;
+    adminGetAgentWorkersStatus(): Promise<AdminAgentWorkersStatusResponse>;
     checkUsernameAvailable(username: string): Promise<UsernameAvailableResponse>;
     completeGoogleSignup(request: CompleteGoogleSignupRequest): Promise<CompleteGoogleSignupResponse>;
     completeXSignup(request: CompleteXSignupRequest): Promise<CompleteXSignupResponse>;
@@ -496,6 +515,7 @@ export interface ApiClient {
     updateAdminUser(userId: number, request: UpdateAdminUserRequest): Promise<AdminUserResponse>;
     deleteAdminUser(userId: number): Promise<DeleteAdminUserResponse>;
     fetchAdminApps(): Promise<AdminAppsListResponse>;
+    fetchAdminPlatformAnalytics(options?: AdminPlatformAnalyticsRequest): Promise<AdminPlatformAnalyticsResponse>;
     updateAdminApp(id: number, request: AdminUpdateAppRequest): Promise<AdminUpdateAppResponse>;
     deleteAdminApp(id: number): Promise<DeleteAppResponse>;
     fetchAdminGameCollections(): Promise<AdminGameCollectionsResponse>;
@@ -511,10 +531,11 @@ export interface ApiClient {
     deleteAdminGameCollection(id: number): Promise<DeleteAdminGameCollectionResponse>;
     fetchAdminAppVersionReviews(options?: {
         state?: ReviewState;
+        visibility?: AppVersionVisibility;
         limit?: number;
         offset?: number;
     }): Promise<AdminAppVersionReviewsListResponse>;
-    claimNextAdminAppVersionReview(): Promise<AdminClaimNextAppVersionReviewResponse>;
+    enqueueNextAdminAppVersionReviewTask(): Promise<AdminEnqueueNextAppVersionReviewTaskResponse>;
     updateAdminAppVersionReview(versionId: number, request: AdminUpdateAppVersionReviewRequest): Promise<AdminUpdateAppVersionReviewResponse>;
     fetchAdminAppPlayerMeta(appId: number): Promise<AdminAppPlayerMetaResponse>;
     fetchAdminAppPlayerMetaUser(appId: number, userId: number): Promise<AdminAppPlayerMetaUserResponse>;