@playdrop/playdrop-cli 0.11.8 → 0.12.0

package/dist/commands/worker.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE = exports.WORKER_SESSION_EXPIRED_MESSAGE = exports.runLoggedProcess = exports.readCodexRolloutTokenUsageForThread = exports.readCodexSandboxMode = exports.readEnvBoolean = exports.extractCodexTokensUsed = exports.extractCodexThreadId = exports.extractCodexRolloutTokenUsage = exports.extractAgentTokenUsage = exports.buildWorkerChildEnv = exports.buildClaudePermissionSettings = exports.buildClaudeExecArgs = exports.buildCodexExecArgs = exports.assertWorkerTokenUsageWithinCap = exports.DEFAULT_WORKER_TOKEN_CAP = exports.DEFAULT_CODEX_TIMEOUT_MS = void 0;
+exports.WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE = exports.WORKER_SESSION_EXPIRED_MESSAGE = exports.runLoggedProcess = exports.readEnvBoolean = exports.readCodexSandboxMode = exports.readCodexRolloutTokenUsageForThread = exports.extractCodexTokensUsed = exports.extractCodexThreadId = exports.extractCodexRolloutTokenUsage = exports.extractAgentTokenUsage = exports.DEFAULT_WORKER_TOKEN_CAP = exports.DEFAULT_CODEX_TIMEOUT_MS = exports.buildWorkerChildEnv = exports.buildCodexExecArgs = exports.buildClaudePermissionSettings = exports.buildClaudeExecArgs = exports.assertWorkerTokenUsageWithinCap = void 0;
 exports.allocateWorkerDevPort = allocateWorkerDevPort;
 exports.isWorkerContextCommandAllowed = isWorkerContextCommandAllowed;
 exports.resolveWorkerExecutionTargetFromRole = resolveWorkerExecutionTargetFromRole;
@@ -55,40 +55,40 @@ exports.readReviewEvidenceFiles = readReviewEvidenceFiles;
 exports.submitReviewTask = submitReviewTask;
 exports.submitEvalTask = submitEvalTask;
 exports.failTask = failTask;
-const promises_1 = require("node:fs/promises");
+const types_1 = require("@playdrop/types");
+const fflate_1 = require("fflate");
+const node_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_module_1 = require("node:module");
 const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_process_1 = __importDefault(require("node:process"));
-const node_module_1 = require("node:module");
-const node_crypto_1 = require("node:crypto");
-const fflate_1 = require("fflate");
-const types_1 = require("@playdrop/types");
+const clientInfo_1 = require("../clientInfo");
 const commandContext_1 = require("../commandContext");
 const config_1 = require("../config");
-const clientInfo_1 = require("../clientInfo");
 const messages_1 = require("../messages");
 const output_1 = require("../output");
 const shellProbe_1 = require("../shellProbe");
-const upload_1 = require("./upload");
-const review_1 = require("./review");
 const agents_1 = require("./agents");
+const review_1 = require("./review");
+const upload_1 = require("./upload");
 const runtime_1 = require("./worker/runtime");
 var runtime_2 = require("./worker/runtime");
-Object.defineProperty(exports, "DEFAULT_CODEX_TIMEOUT_MS", { enumerable: true, get: function () { return runtime_2.DEFAULT_CODEX_TIMEOUT_MS; } });
-Object.defineProperty(exports, "DEFAULT_WORKER_TOKEN_CAP", { enumerable: true, get: function () { return runtime_2.DEFAULT_WORKER_TOKEN_CAP; } });
 Object.defineProperty(exports, "assertWorkerTokenUsageWithinCap", { enumerable: true, get: function () { return runtime_2.assertWorkerTokenUsageWithinCap; } });
-Object.defineProperty(exports, "buildCodexExecArgs", { enumerable: true, get: function () { return runtime_2.buildCodexExecArgs; } });
 Object.defineProperty(exports, "buildClaudeExecArgs", { enumerable: true, get: function () { return runtime_2.buildClaudeExecArgs; } });
 Object.defineProperty(exports, "buildClaudePermissionSettings", { enumerable: true, get: function () { return runtime_2.buildClaudePermissionSettings; } });
+Object.defineProperty(exports, "buildCodexExecArgs", { enumerable: true, get: function () { return runtime_2.buildCodexExecArgs; } });
 Object.defineProperty(exports, "buildWorkerChildEnv", { enumerable: true, get: function () { return runtime_2.buildWorkerChildEnv; } });
+Object.defineProperty(exports, "DEFAULT_CODEX_TIMEOUT_MS", { enumerable: true, get: function () { return runtime_2.DEFAULT_CODEX_TIMEOUT_MS; } });
+Object.defineProperty(exports, "DEFAULT_WORKER_TOKEN_CAP", { enumerable: true, get: function () { return runtime_2.DEFAULT_WORKER_TOKEN_CAP; } });
 Object.defineProperty(exports, "extractAgentTokenUsage", { enumerable: true, get: function () { return runtime_2.extractAgentTokenUsage; } });
 Object.defineProperty(exports, "extractCodexRolloutTokenUsage", { enumerable: true, get: function () { return runtime_2.extractCodexRolloutTokenUsage; } });
 Object.defineProperty(exports, "extractCodexThreadId", { enumerable: true, get: function () { return runtime_2.extractCodexThreadId; } });
 Object.defineProperty(exports, "extractCodexTokensUsed", { enumerable: true, get: function () { return runtime_2.extractCodexTokensUsed; } });
-Object.defineProperty(exports, "readEnvBoolean", { enumerable: true, get: function () { return runtime_2.readEnvBoolean; } });
-Object.defineProperty(exports, "readCodexSandboxMode", { enumerable: true, get: function () { return runtime_2.readCodexSandboxMode; } });
 Object.defineProperty(exports, "readCodexRolloutTokenUsageForThread", { enumerable: true, get: function () { return runtime_2.readCodexRolloutTokenUsageForThread; } });
+Object.defineProperty(exports, "readCodexSandboxMode", { enumerable: true, get: function () { return runtime_2.readCodexSandboxMode; } });
+Object.defineProperty(exports, "readEnvBoolean", { enumerable: true, get: function () { return runtime_2.readEnvBoolean; } });
 Object.defineProperty(exports, "runLoggedProcess", { enumerable: true, get: function () { return runtime_2.runLoggedProcess; } });
 const DEFAULT_POLL_INTERVAL_MS = 1000;
 const HEARTBEAT_INTERVAL_MS = 10000;
@@ -120,11 +120,14 @@ const WORKER_CONTEXT_ALLOWED_COMMANDS = [
     ['task', 'submit-eval'],
     ['task', 'fail'],
     ['review', 'validate-result'],
+    ['review', 'list-windows'],
+    ['review', 'screenshot'],
     ['review', 'compose-evidence'],
     ['review', 'rating-card'],
     ['project', 'validate'],
     ['project', 'build'],
     ['project', 'dev'],
+    ['project', 'check'],
     ['project', 'capture'],
     ['browse'],
     ['search'],
@@ -138,7 +141,7 @@ const WORKER_CONTEXT_ALLOWED_COMMANDS = [
     ['ai', 'jobs', 'detail'],
     ['ai', 'generations'],
 ];
-exports.WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE = 'worker_context_command_not_allowed: inside a PlayDrop worker task only task progress, task claim-slug, task upload/done/fail, assigned app scaffolding, project validation/build/dev/capture, read-only help/catalogue/documentation lookup, and PlayDrop AI generation are permitted.';
+exports.WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE = 'worker_context_command_not_allowed: inside a PlayDrop worker task only task progress, task claim-slug, task upload/done/fail, assigned app scaffolding, project validation/build/dev/check/capture, read-only help/catalogue/documentation lookup, and PlayDrop AI generation are permitted.';
 function allocateWorkerDevPort(input) {
     const basePort = input.basePort ?? DEFAULT_WORKER_DEV_PORT_BASE;
     const maxParallelTasks = input.maxParallelTasks ?? DEFAULT_WORKER_MAX_PARALLEL_TASKS;
@@ -727,15 +730,6 @@ async function readTaskNextStepsFileForCommand(input) {
         return NEXT_STEPS_READ_FAILED;
     }
 }
-function isFinalOwnerRouteLaunchCheckFailure(error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return message.startsWith('hosted_launch_check_failed:')
-        && message.includes('final owner play route');
-}
-function formatTerminalFinalOwnerRouteFailure(error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return `agent_task_final_owner_route_failed: final owner play route validation failed after the task version was created. Task uploads have a fixed outputVersion and cannot be retried by bumping catalogue.json. ${message}`;
-}
 function assertTaskUploadResultMatchesContext(input) {
     if (input.uploadResult.taskId !== input.taskContext.taskId) {
         throw new Error('task_upload_result_task_mismatch');
@@ -1077,11 +1071,6 @@ function discoverWorkerProjectRoot(workspaceDir) {
     }
     return roots[0];
 }
-function writeWorkerTaskState(state) {
-    const file = workerStateFilePath();
-    (0, node_fs_1.mkdirSync)(node_path_1.default.dirname(file), { recursive: true });
-    (0, node_fs_1.writeFileSync)(file, JSON.stringify(state, null, 2));
-}
 function readWorkerTaskState() {
     const file = workerStateFilePath();
     let raw;
@@ -1097,9 +1086,6 @@ function readWorkerTaskState() {
     }
     return parsed;
 }
-function clearWorkerTaskState() {
-    (0, node_fs_1.rmSync)(workerStateFilePath(), { force: true });
-}
 function isWorkerSlackAlertEnabled() {
     const normalized = node_process_1.default.env.PLAYDROP_WORKER_SLACK_ALERTS?.trim().toLowerCase();
     return normalized === '1' || normalized === 'true' || normalized === 'yes' || normalized === 'on';
@@ -1408,7 +1394,6 @@ function buildWorkerCapabilities(input) {
         ? DEFAULT_WORKER_MAX_PARALLEL_TASKS
         : input.maxParallelTasks ?? DEFAULT_WORKER_MAX_PARALLEL_TASKS;
     const runningTaskCount = typeof input === 'string' ? 0 : input.runningTaskCount ?? 0;
-    const providerAccountLabel = typeof input === 'string' ? null : input.providerAccountLabel?.trim() || null;
     const degradedReasons = [];
     const agents = [];
     if (codexVersion) {
@@ -1461,7 +1446,6 @@ function buildWorkerCapabilities(input) {
         agents,
         ready: agents.some((agent) => agent.ready === true),
         degradedReasons,
-        ...(providerAccountLabel ? { providerAccountLabel } : {}),
         wrapperContractVersion: (0, runtime_1.readPositiveEnvInt)('PLAYDROP_WORKER_WRAPPER_CONTRACT_VERSION', WORKER_WRAPPER_CONTRACT_VERSION),
         ...(npmVersion ? { npmVersion } : {}),
         ...(playwright ? { playwright } : {}),
@@ -1861,6 +1845,7 @@ async function runClaude(input) {
             workspaceDir: input.workspaceDir,
             denyReadRoots,
             pluginDir: input.playdropPluginRoot,
+            chrome: input.enableChrome,
         }),
         cwd: input.workspaceDir,
         env: (0, runtime_1.buildWorkerChildEnv)({
@@ -1957,13 +1942,6 @@ function collectObservedPlaydropSkillPaths(output, availablePaths) {
     }
     return [...observed].sort();
 }
-function readProviderAccountLabel(target) {
-    const label = node_process_1.default.env.PLAYDROP_WORKER_AGENT_ACCOUNT_LABEL?.trim() || null;
-    if (target === 'FIRST_PARTY' && !label) {
-        throw new Error('missing_playdrop_worker_agent_account_label');
-    }
-    return label;
-}
 function resolveTelemetryStatus(value) {
     if (value === 'QUEUED') {
         throw new Error('invalid_agent_task_run_status');
@@ -1983,7 +1961,6 @@ async function recordAgentRunTelemetry(input) {
         requestedModel: input.assignment.model,
         resolvedRuntimeModel: input.resolvedRuntimeModel,
         reasoningEffort: input.reasoningEffort,
-        providerAccountLabel: input.providerAccountLabel,
         status: resolveTelemetryStatus(input.status),
         exitCode: input.result.exitCode,
         signal: input.result.signal,
@@ -2264,7 +2241,6 @@ function collectWorkerLocalStatus() {
             playwright,
             runningTaskCount: 0,
             maxParallelTasks: (0, runtime_1.readPositiveEnvInt)('PLAYDROP_WORKER_MAX_PARALLEL_TASKS', DEFAULT_WORKER_MAX_PARALLEL_TASKS),
-            providerAccountLabel: node_process_1.default.env.PLAYDROP_WORKER_AGENT_ACCOUNT_LABEL?.trim() || null,
         });
         if (pluginVersion) {
             capabilities.pluginVersion = pluginVersion;
@@ -2418,13 +2394,6 @@ function writeManagedWorkerUpdatePolicyFile(input) {
 function shellQuote(value) {
     return `'${value.replace(/'/g, `'\\''`)}'`;
 }
-function validatePackageVersion(value, label) {
-    const version = typeof value === 'string' ? value.trim() : '';
-    if (!/^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(version)) {
-        throw new Error(`${label}_invalid:${version || 'missing'}`);
-    }
-    return version;
-}
 function verifyNpmGlobalInstallPreconditions() {
     const prefixProbe = (0, shellProbe_1.runShell)('npm prefix -g');
     const prefix = prefixProbe.output.trim().split(/\r?\n/)[0]?.trim() ?? '';
@@ -3108,6 +3077,9 @@ async function fetchTaskDetail(client, target, taskId) {
     }
     return await client.getAgentTask(taskId);
 }
+function throwWorkerRuntimeError(error) {
+    throw error;
+}
 async function startWorker(options = {}) {
     loadWorkerEnvFile(options.env);
     await (0, commandContext_1.withEnvironment)('worker start', 'Starting the PlayDrop worker', async ({ client, env }) => {
@@ -3126,7 +3098,6 @@ async function startWorker(options = {}) {
             throw new Error('worker_session_invalid: the stored session did not resolve to a user. Run "playdrop auth login" and retry.');
         }
         const target = resolveWorkerExecutionTargetFromRole(me.user.role);
-        const providerAccountLabel = readProviderAccountLabel(target);
         const codexVersion = probeCodexInstallation()?.codexVersion ?? null;
         const claudeVersion = probeClaudeInstallation()?.claudeVersion ?? null;
         const cursorVersion = probeCursorInstallation()?.cursorVersion ?? null;
@@ -3151,7 +3122,6 @@ async function startWorker(options = {}) {
             playwright,
             maxParallelTasks,
             runningTaskCount: 0,
-            providerAccountLabel,
         });
         if (playdropPluginVersion) {
             capabilities.pluginVersion = playdropPluginVersion;
@@ -3305,7 +3275,6 @@ async function startWorker(options = {}) {
             let availableSkillPaths = [];
             const observedSkillPaths = new Set();
             let assignment = null;
-            let providerAccountLabel = null;
             let resolvedRuntimeModel = task.model;
             let reasoningEffort = null;
             let agentStartedAt = null;
@@ -3328,7 +3297,6 @@ async function startWorker(options = {}) {
                     status,
                     resolvedRuntimeModel,
                     reasoningEffort,
-                    providerAccountLabel,
                     availableSkillPaths,
                     observedSkillPaths: [...observedSkillPaths],
                     startedAt: agentStartedAt ?? completedAt,
@@ -3341,7 +3309,6 @@ async function startWorker(options = {}) {
                 if (!assignment) {
                     throw new Error('agent_task_claim_missing_task_assignment');
                 }
-                providerAccountLabel = readProviderAccountLabel(assignment.target);
                 const codexModel = assignment.agent === 'CODEX' ? resolveCodexModel(assignment.model) : null;
                 const claudeModel = assignment.agent === 'CLAUDE_CODE' ? resolveClaudeModel(assignment.model) : null;
                 resolvedRuntimeModel = codexModel?.model ?? claudeModel?.model ?? assignment.model;
@@ -3557,6 +3524,7 @@ async function startWorker(options = {}) {
                         binDir,
                         eventDir,
                         prompt,
+                        enableChrome: task.kind === 'GAME_REVIEW' || task.kind === 'GAME_EVAL',
                         envName: env,
                         taskId: task.id,
                         attempt: taskContext.attempt,
@@ -3786,7 +3754,7 @@ async function startWorker(options = {}) {
             let claimBackoffMs = CLAIM_BACKOFF_BASE_MS;
             while (!shuttingDown && !quiescingForUpdate) {
                 if (fatalTaskError) {
-                    throw fatalTaskError;
+                    throwWorkerRuntimeError(fatalTaskError);
                 }
                 if (sessionExpired) {
                     throw new Error(exports.WORKER_SESSION_EXPIRED_MESSAGE);
@@ -3845,7 +3813,7 @@ async function startWorker(options = {}) {
                 if (options.once) {
                     await taskRun;
                     if (fatalTaskError) {
-                        throw fatalTaskError;
+                        throwWorkerRuntimeError(fatalTaskError);
                     }
                     return;
                 }
@@ -3854,7 +3822,7 @@ async function startWorker(options = {}) {
                 await Promise.allSettled(Array.from(activeTaskRuns.values()));
             }
             if (fatalTaskError) {
-                throw fatalTaskError;
+                throwWorkerRuntimeError(fatalTaskError);
             }
             if (sessionExpired) {
                 throw new Error(exports.WORKER_SESSION_EXPIRED_MESSAGE);
@@ -3994,40 +3962,22 @@ async function uploadTask(options = {}) {
         return;
     }
     const projectDir = discoverWorkerProjectRoot(node_process_1.default.cwd());
-    let published;
-    try {
-        published = await (0, upload_1.publishWorkerAppProject)({
-            client: ctx.client,
-            taskId: taskContext.taskId,
-            kind: taskContext.kind,
-            expectedAppName: taskContext.outputAppName ?? undefined,
-            remixSourceRef: taskContext.remixSourceRef ?? null,
-            playdropAssetRequirement: resolvePlaydropAssetRequirementFromTaskRequest(taskContext.creatorRequest),
-            creatorRequest: taskContext.creatorRequest,
-            projectDir,
-            creatorUsername: taskContext.creatorUsername,
-            apiBase: ctx.envConfig.apiBase,
-            webBase: ctx.envConfig.webBase ?? null,
-            token: ctx.token,
-            user: ctx.user,
-        });
-    }
-    catch (error) {
-        if (isFinalOwnerRouteLaunchCheckFailure(error)) {
-            const terminalError = formatTerminalFinalOwnerRouteFailure(error);
-            await ctx.client.workerFailAgentTask(taskContext.taskId, {
-                taskToken: taskContext.taskToken,
-                error: terminalError,
-                result: {
-                    failedBy: 'worker_upload_final_owner_route',
-                    finalOwnerRouteFailure: true,
-                    originalError: error instanceof Error ? error.message : String(error),
-                },
-            });
-            throw new Error(terminalError);
-        }
-        throw error;
-    }
+    const published = await (0, upload_1.publishWorkerAppProject)({
+        client: ctx.client,
+        taskId: taskContext.taskId,
+        kind: taskContext.kind,
+        executionTarget: taskContext.target,
+        expectedAppName: taskContext.outputAppName ?? undefined,
+        remixSourceRef: taskContext.remixSourceRef ?? null,
+        playdropAssetRequirement: resolvePlaydropAssetRequirementFromTaskRequest(taskContext.creatorRequest),
+        creatorRequest: taskContext.creatorRequest,
+        projectDir,
+        creatorUsername: taskContext.creatorUsername,
+        apiBase: ctx.envConfig.apiBase,
+        webBase: ctx.envConfig.webBase ?? null,
+        token: ctx.token,
+        user: ctx.user,
+    });
     const result = {
         taskId: taskContext.taskId,
         appId: published.appId,

package/dist/config.js

@@ -18,8 +18,8 @@ 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"));
+const path_1 = require("path");
 const CONFIG_VERSION = 2;
 function getConfigPath() {
     const custom = process.env.PLAYDROP_CONFIG_PATH;
@@ -225,7 +225,6 @@ function setCurrentAccount(input) {
     saveConfig(next);
     return loadConfig();
 }
-// eslint-disable-next-line complexity
 function removeAccountSession(input = {}) {
     const cfg = loadConfig();
     const current = getCurrentAccountSession(cfg);

package/dist/index.js

@@ -30,10 +30,9 @@ const create_1 = require("./commands/create");
 const createRemixContent_1 = require("./commands/createRemixContent");
 const dev_1 = require("./commands/dev");
 const devBrowser_1 = require("./commands/devBrowser");
-const capture_1 = require("./commands/capture");
+const check_1 = require("./commands/check");
 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");
@@ -290,6 +289,23 @@ task
     await (0, worker_1.failTask)(opts);
 });
 const review = program.command('review').description('Review helper commands for PlayDrop worker tasks');
+review
+    .command('list-windows')
+    .description('List native capture windows for review evidence')
+    .requiredOption('--pid <pid>', 'Browser process id')
+    .action(async (opts) => {
+    await (0, review_1.listReviewCaptureWindows)(opts);
+});
+review
+    .command('screenshot')
+    .description('Capture a native screenshot for review evidence')
+    .requiredOption('--pid <pid>', 'Browser process id')
+    .option('--window-id <id>', 'Native capture window id')
+    .requiredOption('--out <path>', 'Output PNG path')
+    .option('--metadata <path>', 'Output metadata JSON path')
+    .action(async (opts) => {
+    await (0, review_1.captureReviewScreenshot)(opts);
+});
 review
     .command('validate-result')
     .description('Validate a canonical game review result')
@@ -986,37 +1002,24 @@ project
         player: opts.player,
     });
 });
-const projectCapture = project.command('capture').description('Run a Playwright capture');
-projectCapture
-    .argument('[target]')
+project
+    .command('check [target]')
+    .description('Run the deterministic hosted game load-check in installed Chrome')
     .option('--app <name>', 'App name when the target is a workspace')
-    .option('--timeout <seconds>', 'Capture timeout in seconds')
-    .option('--log-level <level>', 'debug, info, warn, or error')
+    .option('--timeout <seconds>', 'Load-check timeout in seconds')
     .option('--screenshot <path>', 'Screenshot output path')
-    .option('--surface <surface>', 'desktop, mobile-landscape, or mobile-portrait')
-    .option('--dev-auth <mode>', 'anonymous, viewer, or player')
-    .option('--player <slot>', '1, 2, 3, or 4 when --dev-auth player is selected')
-    .option('--reset-dev-player <mode>', 'before, after, before-and-after, or never')
-    .option('--username <username>', 'Override saved login username for this run')
-    .option('--password <password>', 'Override saved login password for this run')
-    .action(async (target, opts) => {
-    const timeoutSeconds = opts.timeout !== undefined ? Number.parseFloat(String(opts.timeout)) : undefined;
-    await (0, capture_1.capture)(target, {
-        timeoutSeconds,
-        appName: opts.app,
-        logLevel: opts.logLevel,
-        screenshotPath: opts.screenshot,
-        surfaceTarget: opts.surface,
-        devAuth: opts.devAuth,
-        player: opts.player,
-        resetDevPlayer: opts.resetDevPlayer,
-        username: opts.username,
-        password: opts.password,
+    .option('--actions <path>', 'JSON action script to dispatch after the game frame is ready')
+    .action(async (target, opts = {}) => {
+    await (0, check_1.check)(target, {
+        app: opts.app,
+        timeout: opts.timeout,
+        screenshot: opts.screenshot,
+        actions: opts.actions,
     });
 });
+const projectCapture = project.command('capture').description('Record game media with the native macOS recorder');
 projectCapture
-    .command('listing [target]', { hidden: true })
-    .description('Record private listing video for a hosted app')
+    .argument('[target]')
     .option('--app <name>', 'App name when the target is a workspace')
     .option('--duration <seconds>', 'Recording duration in seconds')
     .option('--width <pixels>', 'Final gameplay width in pixels')
@@ -1026,6 +1029,7 @@ projectCapture
     .option('--audio', 'Capture gameplay audio')
     .option('--output-dir <path>', 'Output directory for the capture artifacts')
     .option('--keep-raw', 'Keep the raw intermediate recording')
+    .option('--content-hash <sha256>', 'Uploaded build content hash to bind this capture to')
     .action(async (target, opts) => {
     await (0, captureListing_1.captureListing)(target, {
         app: opts.app,
@@ -1037,27 +1041,7 @@ projectCapture
         audio: opts.audio,
         outputDir: opts.outputDir,
         keepRaw: opts.keepRaw,
-    });
-});
-projectCapture
-    .command('remote <url>')
-    .description('Run a Playwright capture against a published URL')
-    .option('--timeout <seconds>', 'Readiness timeout in seconds')
-    .option('--settle <seconds>', 'Post-ready settle delay before screenshot in seconds')
-    .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('--surface <surface>', 'Browser surface preset: desktop, mobile-landscape, or mobile-portrait')
-    .option('--fps-sample-ms <milliseconds>', 'Sample frame rate for this many milliseconds after capture')
-    .option('--username <username>', 'Login username')
-    .option('--password <password>', 'Login password')
-    .option('--login-url <url>', 'Explicit login URL')
-    .action(async (url, _opts, command) => {
-    await (0, captureRemote_1.captureRemote)(url, {
-        ...(command.parent?.opts() ?? {}),
-        ...command.opts(),
+        contentHash: opts.contentHash,
     });
 });
 const projectMarketing = project.command('marketing').description('Prepare local marketing captures and assets');

package/dist/playwright.d.ts

@@ -1,6 +1,7 @@
 import type { Browser, BrowserContext, BrowserContextOptions, Page } from 'playwright-core';
 export declare const HEADLESS_CHROMIUM_ARGS: readonly ["--no-sandbox", "--disable-web-security", "--use-gl=angle", "--use-angle=swiftshader", "--enable-unsafe-swiftshader", "--ignore-gpu-blocklist"];
 export declare const INTERACTIVE_CHROMIUM_ARGS: readonly ["--no-sandbox", "--disable-web-security", "--ignore-gpu-blocklist"];
+export declare const INSTALLED_CHROME_ARGS: readonly ["--no-sandbox", "--disable-web-security", "--ignore-gpu-blocklist"];
 export declare const CHROMIUM_ARGS: readonly ["--no-sandbox", "--disable-web-security", "--use-gl=angle", "--use-angle=swiftshader", "--enable-unsafe-swiftshader", "--ignore-gpu-blocklist"];
 type PlaywrightModule = {
     chromium: {
@@ -8,11 +9,13 @@ type PlaywrightModule = {
             headless?: boolean;
             args?: readonly string[];
             chromiumSandbox?: boolean;
+            channel?: string;
         }): Promise<Browser>;
         launchPersistentContext?(userDataDir: string, options: BrowserContextOptions & {
             headless?: boolean;
             args?: readonly string[];
             chromiumSandbox?: boolean;
+            channel?: string;
         }): Promise<BrowserContext>;
     };
 };
@@ -21,11 +24,13 @@ type PlaydropBrowserContextOptions = BrowserContextOptions & {
 };
 export declare function setPlaywrightLoader(loader: (() => Promise<PlaywrightModule>) | null): void;
 export declare function createPlaywrightLaunchError(tool: string, error: unknown): Error;
+export declare function createInstalledChromeLaunchError(tool: string, error: unknown): Error;
 type PageCallback<T> = (context: {
     browser: Browser;
     context: BrowserContext;
     page: Page;
 }) => Promise<T>;
 export declare function withChromiumPage<T>(callback: PageCallback<T>, options?: PlaydropBrowserContextOptions): Promise<T>;
+export declare function withInstalledChromePage<T>(callback: PageCallback<T>, options?: PlaydropBrowserContextOptions): Promise<T>;
 export declare function launchPersistentChromiumContext(userDataDir: string, options?: PlaydropBrowserContextOptions): Promise<BrowserContext>;
 export {};

package/dist/playwright.js

@@ -33,13 +33,16 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CHROMIUM_ARGS = exports.INTERACTIVE_CHROMIUM_ARGS = exports.HEADLESS_CHROMIUM_ARGS = void 0;
+exports.CHROMIUM_ARGS = exports.INSTALLED_CHROME_ARGS = exports.INTERACTIVE_CHROMIUM_ARGS = exports.HEADLESS_CHROMIUM_ARGS = void 0;
 exports.setPlaywrightLoader = setPlaywrightLoader;
 exports.createPlaywrightLaunchError = createPlaywrightLaunchError;
+exports.createInstalledChromeLaunchError = createInstalledChromeLaunchError;
 exports.withChromiumPage = withChromiumPage;
+exports.withInstalledChromePage = withInstalledChromePage;
 exports.launchPersistentChromiumContext = launchPersistentChromiumContext;
 const node_url_1 = require("node:url");
 const TOOL_NAME = 'playdrop';
+const INSTALLED_CHROME_CHANNEL = 'chrome';
 const COMMON_CHROMIUM_ARGS = [
     '--no-sandbox',
     '--disable-web-security',
@@ -57,6 +60,8 @@ exports.INTERACTIVE_CHROMIUM_ARGS = [
     ...COMMON_CHROMIUM_ARGS,
     '--ignore-gpu-blocklist',
 ];
+// Deterministic project checks must exercise the installed Chrome GPU path.
+exports.INSTALLED_CHROME_ARGS = exports.INTERACTIVE_CHROMIUM_ARGS;
 // Backward-compatible alias for older imports.
 exports.CHROMIUM_ARGS = exports.HEADLESS_CHROMIUM_ARGS;
 let customLoader = null;
@@ -101,6 +106,19 @@ function createPlaywrightLaunchError(tool, error) {
     }
     return error instanceof Error ? error : new Error(message);
 }
+function createInstalledChromeLaunchError(tool, error) {
+    const message = error && typeof error === 'object' && 'message' in error ? String(error.message) : String(error);
+    return new Error([
+        `[${tool}] Failed to launch installed Google Chrome.`,
+        '',
+        'Required setup:',
+        '  1. Install Google Chrome for this macOS user.',
+        '  2. Run from a logged-in GUI session with WindowServer access.',
+        '  3. If invoked over SSH, keep keychain unlock and the command in the same SSH session.',
+        '',
+        `Original error: ${message}`,
+    ].join('\n'));
+}
 async function grantAutomationLocalNetworkAccess(context, origin) {
     if (!origin?.trim()) {
         return;
@@ -153,6 +171,47 @@ async function withChromiumPage(callback, options = {}) {
         }
     }
 }
+async function withInstalledChromePage(callback, options = {}) {
+    const { chromium } = await loadPlaywright();
+    let browser;
+    try {
+        browser = await chromium.launch({
+            channel: INSTALLED_CHROME_CHANNEL,
+            headless: false,
+            args: [...exports.INSTALLED_CHROME_ARGS],
+            chromiumSandbox: false,
+        });
+    }
+    catch (error) {
+        throw createInstalledChromeLaunchError(TOOL_NAME, error);
+    }
+    let context = null;
+    try {
+        const { automationOrigin, ...contextOptions } = options;
+        context = await browser.newContext(contextOptions);
+        await grantAutomationLocalNetworkAccess(context, automationOrigin);
+        const page = await context.newPage();
+        return await callback({ browser, context, page });
+    }
+    finally {
+        if (context) {
+            try {
+                await context.close();
+            }
+            catch (closeError) {
+                const message = closeError instanceof Error ? closeError.message : String(closeError);
+                console.warn(`[${TOOL_NAME}] Failed to close Playwright context: ${message}`);
+            }
+        }
+        try {
+            await browser.close();
+        }
+        catch (closeError) {
+            const message = closeError instanceof Error ? closeError.message : String(closeError);
+            console.warn(`[${TOOL_NAME}] Failed to close Playwright browser: ${message}`);
+        }
+    }
+}
 async function launchPersistentChromiumContext(userDataDir, options = {}) {
     const { chromium } = await loadPlaywright();
     if (typeof chromium.launchPersistentContext !== 'function') {