@playdrop/playdrop-cli 0.12.1 → 0.12.3

package/dist/commands/worker.d.ts

@@ -91,6 +91,16 @@ type TaskFailOptions = {
     env?: string;
     message?: string;
 };
+type TaskEvidenceOptions = {
+    evidenceDir?: string;
+    group?: string;
+    name?: string;
+    screenshotId?: string;
+};
+type TaskInstrumentErrorOptions = {
+    env?: string;
+    reason?: string;
+};
 type TaskSubmitReviewOptions = {
     env?: string;
     state?: string;
@@ -101,6 +111,7 @@ type TaskSubmitReviewOptions = {
 };
 type TaskSubmitEvalOptions = {
     env?: string;
+    evidenceDir?: string[];
     resultFile?: string;
 };
 export type WorkerHealthAlertInput = {
@@ -251,17 +262,31 @@ export declare function assertLaunchAgentPlistCompatible(input: {
 }): void;
 export declare function showWorkerStatus(options?: WorkerStatusOptions): Promise<WorkerStatusPayload>;
 export declare function setupWorker(options?: WorkerSetupOptions): Promise<void>;
+export declare function instrumentTaskChromeTitleMatchers(assignment: WorkerAgentTaskAssignmentResponse): string[];
+type InstrumentBrowserHygieneRunner = (command: string, args: string[]) => Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export declare function enforceInstrumentBrowserHygiene(assignment: WorkerAgentTaskAssignmentResponse, options?: {
+    platform?: NodeJS.Platform;
+    runner?: InstrumentBrowserHygieneRunner;
+}): Promise<{
+    remainingTaskTabs: number;
+    blankWindows: number;
+}>;
 export declare function startWorker(options?: WorkerStartOptions): Promise<void>;
 export declare function reportTask(options: TaskReportOptions): Promise<void>;
 export declare function reportCatalogueTask(options: TaskCatalogueReportOptions): Promise<void>;
 export declare function uploadTask(options?: TaskUploadOptions): Promise<void>;
 export declare function claimSlugTask(options: TaskClaimSlugOptions): Promise<void>;
 export declare function completeTask(options: TaskCompleteOptions): Promise<void>;
-export declare function readReviewEvidenceFiles(evidenceDir: string | undefined): Array<{
+export declare function readReviewEvidenceFiles(evidenceDir: string | undefined, workspaceDir?: string): Array<{
     name: string;
     contentType: string;
     contentBase64: string;
 }>;
 export declare function submitReviewTask(options: TaskSubmitReviewOptions): Promise<void>;
 export declare function submitEvalTask(options: TaskSubmitEvalOptions): Promise<void>;
+export declare function saveTaskEvidence(options: TaskEvidenceOptions): Promise<void>;
+export declare function instrumentErrorTask(options: TaskInstrumentErrorOptions): Promise<void>;
 export declare function failTask(options: TaskFailOptions): Promise<void>;

package/dist/commands/worker.js

@@ -45,6 +45,8 @@ exports.parseLaunchAgentProgramArguments = parseLaunchAgentProgramArguments;
 exports.assertLaunchAgentPlistCompatible = assertLaunchAgentPlistCompatible;
 exports.showWorkerStatus = showWorkerStatus;
 exports.setupWorker = setupWorker;
+exports.instrumentTaskChromeTitleMatchers = instrumentTaskChromeTitleMatchers;
+exports.enforceInstrumentBrowserHygiene = enforceInstrumentBrowserHygiene;
 exports.startWorker = startWorker;
 exports.reportTask = reportTask;
 exports.reportCatalogueTask = reportCatalogueTask;
@@ -54,9 +56,12 @@ exports.completeTask = completeTask;
 exports.readReviewEvidenceFiles = readReviewEvidenceFiles;
 exports.submitReviewTask = submitReviewTask;
 exports.submitEvalTask = submitEvalTask;
+exports.saveTaskEvidence = saveTaskEvidence;
+exports.instrumentErrorTask = instrumentErrorTask;
 exports.failTask = failTask;
 const types_1 = require("@playdrop/types");
 const fflate_1 = require("fflate");
+const node_child_process_1 = require("node:child_process");
 const node_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
 const promises_1 = require("node:fs/promises");
@@ -64,6 +69,7 @@ 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_util_1 = require("node:util");
 const clientInfo_1 = require("../clientInfo");
 const commandContext_1 = require("../commandContext");
 const config_1 = require("../config");
@@ -74,6 +80,7 @@ const agents_1 = require("./agents");
 const review_1 = require("./review");
 const upload_1 = require("./upload");
 const runtime_1 = require("./worker/runtime");
+const instrument_evidence_1 = require("./worker/instrument-evidence");
 var runtime_2 = require("./worker/runtime");
 Object.defineProperty(exports, "assertWorkerTokenUsageWithinCap", { enumerable: true, get: function () { return runtime_2.assertWorkerTokenUsageWithinCap; } });
 Object.defineProperty(exports, "buildClaudeExecArgs", { enumerable: true, get: function () { return runtime_2.buildClaudeExecArgs; } });
@@ -92,6 +99,7 @@ Object.defineProperty(exports, "readEnvBoolean", { enumerable: true, get: functi
 Object.defineProperty(exports, "runLoggedProcess", { enumerable: true, get: function () { return runtime_2.runLoggedProcess; } });
 const DEFAULT_POLL_INTERVAL_MS = 1000;
 const HEARTBEAT_INTERVAL_MS = 10000;
+const INSTRUMENT_HEARTBEAT_INTERVAL_MS = 1000;
 const TASK_HEARTBEAT_TRANSIENT_FAILURE_LIMIT = 6;
 const DEFAULT_WORKER_MAX_PARALLEL_TASKS = 5;
 const DEFAULT_WORKER_DEV_PORT_BASE = 8900;
@@ -109,6 +117,7 @@ const STAGED_PLAYDROP_PLUGIN_ROOT = '.playdrop/plugin';
 const PLAYDROP_PLUGIN_STAGING_MANIFEST_PATH = 'playdrop-worker-staging.json';
 const ASSIGNMENT_PLUGIN_BUNDLE_MAX_FILES = 1000;
 const ASSIGNMENT_PLUGIN_BUNDLE_MAX_UNCOMPRESSED_BYTES = 20 * 1024 * 1024;
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
 exports.WORKER_SESSION_EXPIRED_MESSAGE = 'worker session expired: run "playdrop auth login" and start the worker again';
 const WORKER_CONTEXT_ALLOWED_COMMANDS = [
     ['task', 'report'],
@@ -118,10 +127,10 @@ const WORKER_CONTEXT_ALLOWED_COMMANDS = [
     ['task', 'done'],
     ['task', 'submit-review'],
     ['task', 'submit-eval'],
+    ['task', 'evidence'],
+    ['task', 'instrument-error'],
     ['task', 'fail'],
     ['review', 'validate-result'],
-    ['review', 'list-windows'],
-    ['review', 'screenshot'],
     ['review', 'compose-evidence'],
     ['review', 'rating-card'],
     ['project', 'validate'],
@@ -1838,7 +1847,10 @@ async function runCodex(input) {
 }
 async function runClaude(input) {
     const denyReadRoots = resolveClaudeDenyReadRoots(input.workspaceDir);
-    return await (0, runtime_1.runLoggedProcess)({
+    const screenshotCollector = input.enableChrome
+        ? (0, instrument_evidence_1.createWorkerInstrumentScreenshotCollector)(input.workspaceDir)
+        : null;
+    const result = await (0, runtime_1.runLoggedProcess)({
         command: 'claude',
         args: (0, runtime_1.buildClaudeExecArgs)({
             ...input.claudeModel,
@@ -1860,9 +1872,14 @@ async function runClaude(input) {
         timeoutMs: (0, runtime_1.readPositiveEnvInt)('PLAYDROP_WORKER_CLAUDE_TIMEOUT_MS', runtime_1.DEFAULT_CODEX_TIMEOUT_MS),
         maxOutputChars: runtime_1.DEFAULT_CODEX_LOG_TAIL_CHARS,
         onTranscriptChunks: input.onTranscriptChunks,
+        ...(screenshotCollector
+            ? { onStdoutText: (text) => screenshotCollector.push(text) > 0 }
+            : {}),
         transcriptFlushIntervalMs: runtime_1.DEFAULT_TRANSCRIPT_FLUSH_INTERVAL_MS,
         onChild: input.onChild,
     });
+    screenshotCollector?.finish();
+    return result;
 }
 function isPathInside(parent, child) {
     const relative = node_path_1.default.relative(parent, child);
@@ -3077,6 +3094,138 @@ async function fetchTaskDetail(client, target, taskId) {
     }
     return await client.getAgentTask(taskId);
 }
+function instrumentTaskChromeTitleMatchers(assignment) {
+    const targets = assignment.kind === 'GAME_REVIEW'
+        ? [assignment.inputs.reviewTarget]
+        : assignment.kind === 'GAME_EVAL'
+            ? assignment.inputs.evalTarget?.targets ?? []
+            : [];
+    const matchers = new Set();
+    for (const target of targets) {
+        if (!target)
+            continue;
+        for (const value of [target.appDisplayName, target.appName]) {
+            const normalized = typeof value === 'string' ? value.trim() : '';
+            if (normalized.length >= 3) {
+                matchers.add(normalized);
+            }
+        }
+    }
+    return [...matchers].sort((left, right) => right.length - left.length);
+}
+const INSTRUMENT_BROWSER_HYGIENE_APPLESCRIPT = String.raw `
+on run matchers
+  tell application "Google Chrome"
+    repeat with windowIndex from (count of windows) to 1 by -1
+      try
+        set currentWindow to window windowIndex
+        repeat with tabIndex from (count of tabs of currentWindow) to 1 by -1
+          set currentTab to tab tabIndex of currentWindow
+          set currentTitle to title of currentTab
+          set shouldClose to false
+          repeat with matcher in matchers
+            if currentTitle contains (matcher as text) then
+              set shouldClose to true
+              exit repeat
+            end if
+          end repeat
+          if shouldClose then close currentTab
+        end repeat
+      end try
+    end repeat
+
+    set blankWindowCount to 0
+    repeat with currentWindow in windows
+      try
+        if (count of tabs of currentWindow) is 1 then
+          set currentUrl to URL of active tab of currentWindow
+          if currentUrl is "about:blank" or currentUrl starts with "chrome://newtab" then
+            set blankWindowCount to blankWindowCount + 1
+          end if
+        end if
+      end try
+    end repeat
+    if blankWindowCount is 0 then
+      set blankWindow to make new window
+      set URL of active tab of blankWindow to "about:blank"
+      delay 1
+    end if
+
+    set keptBlankWindow to false
+    repeat with windowIndex from (count of windows) to 1 by -1
+      try
+        set currentWindow to window windowIndex
+        if (count of tabs of currentWindow) is 1 then
+          set currentUrl to URL of active tab of currentWindow
+          if currentUrl is "about:blank" or currentUrl starts with "chrome://newtab" then
+            if keptBlankWindow then
+              close currentWindow
+            else
+              set keptBlankWindow to true
+            end if
+          end if
+        end if
+      end try
+    end repeat
+
+    set remainingCount to 0
+    set blankWindowCount to 0
+    repeat with currentWindow in windows
+      try
+        repeat with currentTab in tabs of currentWindow
+          set currentTitle to title of currentTab
+          repeat with matcher in matchers
+            if currentTitle contains (matcher as text) then
+              set remainingCount to remainingCount + 1
+              exit repeat
+            end if
+          end repeat
+        end repeat
+        if (count of tabs of currentWindow) is 1 then
+          set currentUrl to URL of active tab of currentWindow
+          if currentUrl is "about:blank" or currentUrl starts with "chrome://newtab" then
+            set blankWindowCount to blankWindowCount + 1
+          end if
+        end if
+      end try
+    end repeat
+  end tell
+  return "remaining=" & remainingCount & ";blank=" & blankWindowCount
+end run
+`;
+async function enforceInstrumentBrowserHygiene(assignment, options = {}) {
+    if (assignment.kind !== 'GAME_REVIEW' && assignment.kind !== 'GAME_EVAL') {
+        return { remainingTaskTabs: 0, blankWindows: 0 };
+    }
+    if ((options.platform ?? node_process_1.default.platform) !== 'darwin') {
+        throw new Error('worker_browser_hygiene_requires_macos');
+    }
+    const matchers = instrumentTaskChromeTitleMatchers(assignment);
+    if (matchers.length === 0) {
+        throw new Error('worker_browser_hygiene_missing_title_matchers');
+    }
+    const runner = options.runner ?? (async (command, args) => {
+        const result = await execFileAsync(command, args, { timeout: 15000, maxBuffer: 1024 * 1024 });
+        return { stdout: result.stdout, stderr: result.stderr };
+    });
+    let result;
+    try {
+        result = await runner('osascript', ['-e', INSTRUMENT_BROWSER_HYGIENE_APPLESCRIPT, ...matchers]);
+    }
+    catch (error) {
+        throw new Error(`worker_browser_hygiene_automation_failed:${error instanceof Error ? error.message : String(error)}`);
+    }
+    const match = /remaining=(\d+);blank=(\d+)/.exec(result.stdout.trim());
+    if (!match) {
+        throw new Error(`worker_browser_hygiene_invalid_result:${result.stdout.trim() || result.stderr.trim() || 'empty'}`);
+    }
+    const remainingTaskTabs = Number(match[1]);
+    const blankWindows = Number(match[2]);
+    if (remainingTaskTabs !== 0 || blankWindows !== 1) {
+        throw new Error(`worker_browser_hygiene_failed:remaining=${remainingTaskTabs}:blank=${blankWindows}`);
+    }
+    return { remainingTaskTabs, blankWindows };
+}
 function throwWorkerRuntimeError(error) {
     throw error;
 }
@@ -3443,7 +3592,9 @@ async function startWorker(options = {}) {
                         }
                         console.error(`Agent task heartbeat failed: ${error instanceof Error ? error.message : String(error)}`);
                     });
-                }, HEARTBEAT_INTERVAL_MS);
+                }, task.kind === 'GAME_REVIEW' || task.kind === 'GAME_EVAL'
+                    ? INSTRUMENT_HEARTBEAT_INTERVAL_MS
+                    : HEARTBEAT_INTERVAL_MS);
                 eventDrainTimer = setInterval(() => {
                     queueEventDrain().catch((error) => {
                         handleEventDrainFailure(error);
@@ -3620,7 +3771,7 @@ async function startWorker(options = {}) {
                         await client.workerCreateAgentTaskEvent(task.id, {
                             workerKey,
                             leaseToken,
-                            kind: 'system',
+                            kind: 'progress',
                             phase: 'failed',
                             message: describeAgentFailureForEvent(failureCode),
                             pct: null,
@@ -3738,6 +3889,20 @@ async function startWorker(options = {}) {
                 if (eventDrainTimer) {
                     clearInterval(eventDrainTimer);
                 }
+                if (assignment
+                    && agentStartedAt
+                    && (assignment.kind === 'GAME_REVIEW' || assignment.kind === 'GAME_EVAL')) {
+                    try {
+                        const hygiene = await enforceInstrumentBrowserHygiene(assignment);
+                        console.log(`Agent task ${task.id} browser hygiene passed: ${hygiene.remainingTaskTabs} task tabs, ${hygiene.blankWindows} blank window(s).`);
+                    }
+                    catch (hygieneError) {
+                        const error = hygieneError instanceof Error ? hygieneError : new Error(String(hygieneError));
+                        console.error(`Agent task ${task.id} browser hygiene failed: ${error.message}`);
+                        retainWorkspace = true;
+                        recordFatalTaskError(error);
+                    }
+                }
                 activeTerminators.delete(task.id);
                 if (retainWorkspace && (0, runtime_1.readEnvBoolean)('PLAYDROP_WORKER_RETAIN_FAILED_WORKSPACE', true)) {
                     console.error(`Retained failed task workspace for debugging: ${workspaceDir ?? '(not created)'}`);
@@ -4136,7 +4301,7 @@ function contentTypeForEvidenceFile(fileName) {
         return 'image/webp';
     return 'application/octet-stream';
 }
-function readReviewEvidenceFiles(evidenceDir) {
+function readReviewEvidenceFiles(evidenceDir, workspaceDir = resolveTaskWorkspaceDir()) {
     const normalizedDir = typeof evidenceDir === 'string' ? evidenceDir.trim() : '';
     if (!normalizedDir) {
         throw new Error('invalid_review_evidence_dir');
@@ -4145,6 +4310,7 @@ function readReviewEvidenceFiles(evidenceDir) {
     if (!(0, node_fs_1.existsSync)(resolvedDir)) {
         throw new Error('invalid_review_evidence_dir');
     }
+    (0, instrument_evidence_1.readAndValidateInstrumentEvidenceManifest)({ workspaceDir, evidenceDir: resolvedDir });
     const existingFiles = new Set((0, node_fs_1.readdirSync)(resolvedDir, { withFileTypes: true })
         .filter((entry) => entry.isFile())
         .map((entry) => entry.name));
@@ -4209,7 +4375,9 @@ async function submitReviewTask(options) {
         creatorFeedback: creatorFeedback ?? '',
         evidenceDir,
     });
-    const evidenceFiles = readReviewEvidenceFiles(evidenceDir);
+    const workspaceDir = resolveTaskWorkspaceDir();
+    const instrumentEvidence = (0, instrument_evidence_1.readAndValidateInstrumentEvidenceManifest)({ workspaceDir, evidenceDir });
+    const evidenceFiles = readReviewEvidenceFiles(evidenceDir, workspaceDir);
     const ctx = await resolveTaskCommandContext('task submit-review', options.env, taskContext);
     if (!ctx) {
         throw new Error('task_submit_review_auth_required');
@@ -4231,8 +4399,9 @@ async function submitReviewTask(options) {
         creatorFeedback,
         ...(nextSteps !== undefined ? { nextSteps } : {}),
         evidenceFiles,
+        instrumentEvidence,
     });
-    (0, output_1.printSuccess)('Review submitted. Send one short final status sentence now, then stop.');
+    (0, output_1.printSuccess)('Review submitted. This was the final operation; send one short final status sentence and stop immediately.');
 }
 async function submitEvalTask(options) {
     const taskContext = readTaskContextFile();
@@ -4247,6 +4416,37 @@ async function submitEvalTask(options) {
     catch (error) {
         throw new Error(`invalid_eval_result_json:${error instanceof Error ? error.message : String(error)}`);
     }
+    const evidenceDirs = Array.isArray(options.evidenceDir)
+        ? options.evidenceDir.map((entry) => entry.trim()).filter(Boolean)
+        : [];
+    if (evidenceDirs.length <= 0) {
+        throw new Error('task_submit_eval_evidence_required');
+    }
+    const workspaceDir = resolveTaskWorkspaceDir();
+    const instrumentEvidence = [];
+    const evidenceFiles = [];
+    const groupIds = new Set();
+    for (const evidenceDir of evidenceDirs) {
+        const manifest = (0, instrument_evidence_1.readAndValidateInstrumentEvidenceManifest)({ workspaceDir, evidenceDir });
+        if (groupIds.has(manifest.groupId)) {
+            throw new Error(`duplicate_instrument_evidence_group:${manifest.groupId}`);
+        }
+        groupIds.add(manifest.groupId);
+        instrumentEvidence.push(manifest);
+        for (const name of ['first-frame', 'core', 'win', 'loss']) {
+            const capture = manifest.captures[name];
+            if (!capture) {
+                throw new Error(`missing_instrument_evidence_capture:${manifest.groupId}:${name}`);
+            }
+            const filePath = node_path_1.default.join(node_path_1.default.resolve(evidenceDir), capture.fileName);
+            evidenceFiles.push({
+                groupId: manifest.groupId,
+                name: capture.fileName,
+                contentType: contentTypeForEvidenceFile(capture.fileName),
+                contentBase64: (0, node_fs_1.readFileSync)(filePath).toString('base64'),
+            });
+        }
+    }
     const ctx = await resolveTaskCommandContext('task submit-eval', options.env, taskContext);
     if (!ctx) {
         throw new Error('task_submit_eval_auth_required');
@@ -4254,8 +4454,61 @@ async function submitEvalTask(options) {
     await ctx.client.workerSubmitAgentTaskEval(taskContext.taskId, {
         taskToken: taskContext.taskToken,
         result: result,
+        instrumentEvidence,
+        evidenceFiles,
+    });
+    (0, output_1.printSuccess)('Eval submitted. This was the final operation; send one short final status sentence and stop immediately.');
+}
+async function saveTaskEvidence(options) {
+    const taskContext = readTaskContextFile();
+    if (taskContext.kind !== 'GAME_REVIEW' && taskContext.kind !== 'GAME_EVAL') {
+        throw new Error('task_evidence_requires_instrument_task');
+    }
+    const evidenceDir = options.evidenceDir?.trim();
+    const name = options.name?.trim();
+    const screenshotId = options.screenshotId?.trim();
+    const groupId = options.group?.trim() || (taskContext.kind === 'GAME_REVIEW' ? 'review' : '');
+    if (!evidenceDir || !name || !screenshotId || !groupId) {
+        throw new Error('task_evidence_options_required');
+    }
+    const capture = await (0, instrument_evidence_1.saveInstrumentEvidenceCapture)({
+        workspaceDir: resolveTaskWorkspaceDir(),
+        evidenceDir,
+        groupId,
+        name,
+        screenshotId,
+    });
+    (0, output_1.printSuccess)(`Saved ${capture.name} evidence from Chrome screenshot ${capture.screenshotId} on controlled tab ${capture.tabId} to ${capture.fileName}.`);
+}
+const INSTRUMENT_ERROR_REASONS = new Set([
+    'auth_state',
+    'browser_control',
+    'renderer',
+    'screenshot',
+]);
+async function instrumentErrorTask(options) {
+    const reason = options.reason?.trim();
+    if (!reason || !INSTRUMENT_ERROR_REASONS.has(reason)) {
+        throw new Error(`invalid_instrument_error_reason:${reason ?? ''}`);
+    }
+    const taskContext = readTaskContextFile();
+    if (taskContext.kind !== 'GAME_REVIEW' && taskContext.kind !== 'GAME_EVAL') {
+        throw new Error('task_instrument_error_requires_instrument_task');
+    }
+    const ctx = await resolveTaskCommandContext('task instrument-error', options.env, taskContext);
+    if (!ctx) {
+        throw new Error('task_instrument_error_auth_required');
+    }
+    await ctx.client.workerFailAgentTask(taskContext.taskId, {
+        taskToken: taskContext.taskToken,
+        error: `instrument_error:${reason}`,
+        result: {
+            outcome: 'instrument_error',
+            reason,
+            reportedBy: 'agent',
+        },
     });
-    (0, output_1.printSuccess)('Eval submitted. Send one short final status sentence now, then stop.');
+    (0, output_1.printSuccess)(`Instrument error submitted (${reason}). This was the final operation; stop immediately.`);
 }
 async function failTask(options) {
     const message = options.message?.trim();
@@ -4274,5 +4527,5 @@ async function failTask(options) {
         error: message,
         result: { failedBy: 'agent' },
     });
-    (0, output_1.printSuccess)('Task marked failed. Send one short final status sentence now, then stop.');
+    (0, output_1.printSuccess)('Task marked failed. This was the final operation; send one short final status sentence and stop immediately.');
 }

package/dist/index.js

@@ -120,6 +120,7 @@ function registerLoginCommand(parent) {
         .option('--password <password>', 'Password for direct login')
         .option('--key <apiKey>', 'API key for direct login')
         .option('--handoff-token <token>', 'Native app handoff token for direct login')
+        .option('--handoff-token-stdin', 'Read a native app handoff token from stdin')
         .option('--json', 'Output JSON')
         .action(async (opts) => {
         await (0, login_1.login)(opts.env, {
@@ -127,6 +128,7 @@ function registerLoginCommand(parent) {
             password: opts.password,
             key: opts.key,
             handoffToken: opts.handoffToken,
+            handoffTokenStdin: opts.handoffTokenStdin,
             json: opts.json,
         });
     });
@@ -276,10 +278,29 @@ task
     .command('submit-eval')
     .description('Submit the active game eval task result')
     .requiredOption('--result-file <path>', 'Strict GAME_EVAL JSON result file')
+    .requiredOption('--evidence-dir <paths...>', 'One instrument evidence directory per eval target')
     .option('--env <env>', 'Environment override')
     .action(async (opts) => {
     await (0, worker_1.submitEvalTask)(opts);
 });
+task
+    .command('evidence')
+    .description('Persist a Claude Chrome screenshot as task evidence')
+    .requiredOption('--name <name>', 'Evidence state: first-frame, core, win, or loss')
+    .requiredOption('--screenshot-id <id>', 'Claude Chrome screenshot id')
+    .requiredOption('--evidence-dir <path>', 'Evidence output directory')
+    .option('--group <id>', 'Evidence group id; required for GAME_EVAL')
+    .action(async (opts) => {
+    await (0, worker_1.saveTaskEvidence)(opts);
+});
+task
+    .command('instrument-error')
+    .description('Terminate a review or eval task with a structured instrument error')
+    .requiredOption('--reason <reason>', 'auth_state, browser_control, renderer, or screenshot')
+    .option('--env <env>', 'Environment override')
+    .action(async (opts) => {
+    await (0, worker_1.instrumentErrorTask)(opts);
+});
 task
     .command('fail')
     .description('Fail the active agent task')
@@ -289,23 +310,6 @@ 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')

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

@@ -0,0 +1,46 @@
+import type { CreateGameIdeaRequest, CreateGameIdeaResponse, GameIdeaDetailResponse, GameIdeaStatusResponse, GameIdeasListRequest, GameIdeasListResponse, RemixCandidatesResponse, ShipGameIdeaRequest, ShipGameIdeaResponse, StartGameIdeaRequest, StartGameIdeaResponse, UpdateGameIdeaRequest, UpdateGameIdeaResponse } from '@playdrop/types';
+type ApiResponseLike<T> = {
+    status: number;
+    body: T;
+    headers: Headers;
+};
+type RequestExecutor = <T>(input: {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}) => Promise<ApiResponseLike<T>>;
+type ErrorHandler = (response: ApiResponseLike<unknown>, defaultMessage: string) => never;
+type ParseResponseBody = <T>(response: Response) => Promise<T>;
+export type CreateGameIdeaOptions = {
+    payload: CreateGameIdeaRequest;
+    image?: File | Blob;
+    filename?: string;
+};
+export declare function buildGameIdeasApiClientMethods(input: {
+    request: RequestExecutor;
+    handleApiError: ErrorHandler;
+    fetchImpl: typeof fetch;
+    includeBrowserCredentials: boolean;
+    resolveBaseUrl: () => string;
+    resolveUrl: (base: string, path: string) => string;
+    parseResponseBody: ParseResponseBody;
+    resolveToken: () => Promise<string | null>;
+    getClientHeaders: () => Record<string, string>;
+}): {
+    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>;
+};
+export {};
+//# sourceMappingURL=game-ideas.d.ts.map

package/node_modules/@playdrop/api-client/dist/domains/game-ideas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-ideas.d.ts","sourceRoot":"","sources":["../../src/domains/game-ideas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAGzB,KAAK,eAAe,CAAC,CAAC,IAAI;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,KAAK,eAAe,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE;IAChC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAElC,KAAK,YAAY,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,KAAK,KAAK,CAAC;AAE1F,KAAK,iBAAiB,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAE/D,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAqCF,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,EAAE,YAAY,CAAC;IAC7B,SAAS,EAAE,OAAO,KAAK,CAAC;IACxB,yBAAyB,EAAE,OAAO,CAAC;IACnC,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACnD,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3C,gBAAgB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD;4BAciC,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;4BAyBxD,oBAAoB,GAAQ,OAAO,CAAC,qBAAqB,CAAC;0BAiB3D,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;gCAYlC,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;6BAY3C,MAAM,QAAQ,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;4BAatE,MAAM,SAAQ,oBAAoB,GAAQ,OAAO,CAAC,qBAAqB,CAAC;2BAczE,MAAM,QAAQ,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;mCAiB1D;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAQ,OAAO,CAAC,uBAAuB,CAAC;EAiB9H"}