@playdrop/playdrop-cli 0.12.40 → 0.12.42

package/config/client-meta.json

@@ -1,7 +1,7 @@
 {
-  "version": "0.12.40",
+  "version": "0.12.42",
   "build": 1,
-  "runtimeSdkVersion": "0.12.40",
+  "runtimeSdkVersion": "0.12.42",
   "runtimeSdkBuild": 1,
   "clients": {
     "all": {

package/dist/apps/index.d.ts

@@ -25,6 +25,7 @@ export type AppPipelineOptions = {
     agentTaskId?: number;
     playtestProof?: AgentTaskPlaytestProof;
     mediaCaptureRequired?: boolean;
+    machineCausalGateRequired?: boolean;
     captureSession?: TaskCaptureSession | null;
 };
 export declare function runAppPipeline(client: ApiClient, task: AppTask, options?: AppPipelineOptions): Promise<AppPipelineResult>;

package/dist/apps/index.js

@@ -66,6 +66,7 @@ async function runAppPipeline(client, task, options) {
         agentTaskId: options?.agentTaskId,
         playtestProof: options?.playtestProof,
         mediaCaptureRequired: options?.mediaCaptureRequired,
+        machineCausalGateRequired: options?.machineCausalGateRequired,
         captureSession: options?.captureSession,
     };
     const upload = await (0, upload_1.uploadApp)(client, task, artifacts, uploadOptions);

package/dist/apps/loadCheck.d.ts

@@ -1,5 +1,5 @@
 import type { ApiClient } from '@playdrop/api-client';
-import { type AppPlaytestTape, type AppSurface, type UserResponse } from '@playdrop/types';
+import { type AppPlaytestTape, type AppSurface, type AppUploadCausalComparison, type AppUploadMachineCausalEvidence, type UserResponse } from '@playdrop/types';
 import type { BrowserContextOptions, Frame, Page } from 'playwright-core';
 import type { AppTask } from '../catalogue';
 import { type TaskCaptureSession } from '../appUrls';
@@ -84,4 +84,21 @@ export declare function runUploadedHostedLoadCheck(input: {
     currentUser?: UserResponse | null;
     captureSession?: TaskCaptureSession | null;
     screenshotPath?: string | null;
+    readyGameFrameScreenshotPath?: string | null;
+    gameFrameScreenshotPath?: string | null;
+    playtestTape?: AppPlaytestTape;
+    postReadyWaitMs?: number;
 }): Promise<HostedLoadCheckResult>;
+export declare function sliceFirstPrimaryVerbAction(tape: AppPlaytestTape): AppPlaytestTape;
+export declare function compareCausalFrames(firstPath: string, secondPath: string): Promise<AppUploadCausalComparison>;
+export declare function runUploadedHostedCausalCheck(input: {
+    client: ApiClient;
+    creatorUsername: string;
+    task: AppTask;
+    sessionId: string;
+    teachingText: string;
+    timeoutMs?: number;
+    token?: string | null;
+    currentUser?: UserResponse | null;
+    captureSession?: TaskCaptureSession | null;
+}): Promise<AppUploadMachineCausalEvidence>;

package/dist/apps/loadCheck.js

@@ -1,4 +1,7 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PLAYDROP_SURFACE_CONTEXT_OPTIONS = void 0;
 exports.resolveLoadCheckSurface = resolveLoadCheckSurface;
@@ -12,9 +15,15 @@ exports.formatHostedLoadCheckFailure = formatHostedLoadCheckFailure;
 exports.redactHostedLoadCheckSecrets = redactHostedLoadCheckSecrets;
 exports.runLocalHostedLoadCheck = runLocalHostedLoadCheck;
 exports.runUploadedHostedLoadCheck = runUploadedHostedLoadCheck;
+exports.sliceFirstPrimaryVerbAction = sliceFirstPrimaryVerbAction;
+exports.compareCausalFrames = compareCausalFrames;
+exports.runUploadedHostedCausalCheck = runUploadedHostedCausalCheck;
 const types_1 = require("@playdrop/types");
+const node_crypto_1 = require("node:crypto");
 const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
+const sharp_1 = __importDefault(require("sharp"));
 const appUrls_1 = require("../appUrls");
 const devShared_1 = require("../commands/devShared");
 const dev_1 = require("../commands/dev");
@@ -30,6 +39,8 @@ Object.defineProperty(exports, "PLAYDROP_SURFACE_CONTEXT_OPTIONS", { enumerable:
 const FRAME_SELECTOR = 'iframe[title="Game"]';
 const DEFAULT_HOSTED_LOAD_TIMEOUT_MS = 15000;
 const POST_READY_SETTLE_MS = 750;
+const CAUSAL_FRAME_MEAN_DELTA_MIN = 0.025;
+const CAUSAL_FRAME_CHANGED_PIXEL_RATIO_MIN = 0.12;
 const LOAD_CHECK_SURFACE_ORDER = ['DESKTOP', 'MOBILE_LANDSCAPE', 'MOBILE_PORTRAIT'];
 const GOOGLE_TELEMETRY_HOSTS = [
     'analytics.google.com',
@@ -499,6 +510,14 @@ async function saveScreenshot(page, screenshotPath) {
     console.log(`[check] Saved screenshot to ${(0, node_path_1.relative)(process.cwd(), normalizedPath) || normalizedPath}`);
     return normalizedPath;
 }
+async function saveGameFrameScreenshot(page, screenshotPath) {
+    const normalizedPath = typeof screenshotPath === 'string' ? screenshotPath.trim() : '';
+    if (!normalizedPath)
+        return null;
+    await (0, promises_1.mkdir)((0, node_path_1.dirname)(normalizedPath), { recursive: true });
+    await page.locator(FRAME_SELECTOR).screenshot({ path: normalizedPath, type: 'png' });
+    return normalizedPath;
+}
 function normalizeLoadCheckFailure(error, artifactFingerprint) {
     const rawMessage = error instanceof Error ? error.message : String(error);
     const message = normalizeLoadCheckMessage(rawMessage);
@@ -716,7 +735,7 @@ async function runHostedLoadCheck(options) {
                 hostedLaunchWaiter,
                 page.waitForTimeout(timeoutMs).then(() => {
                     throw new Error(expectedHostedLaunchState === 'ready'
-                        ? 'hosted_app_missing_ready: Hosted app did not report ready before the load-check timeout.'
+                        ? 'hosted_app_missing_ready: instrument_error:game_ready_timeout: Hosted app did not report sdk.host.ready() before the instrument timeout.'
                         : `hosted_app_gate_missing: Hosted app did not report ${expectedHostedLaunchState} before the load-check timeout.`);
                 }),
             ]);
@@ -737,6 +756,7 @@ async function runHostedLoadCheck(options) {
             if (isSoftwareWebGlRenderer(webglRenderer)) {
                 throw new Error(`project_check_webgl_renderer_software: WebGL renderer is "${webglRenderer}". Real hardware acceleration is required.`);
             }
+            await saveGameFrameScreenshot(page, options.readyGameFrameScreenshotPath);
             if (options.playtestTape && options.actions?.length) {
                 throw new Error('project_check_input_mode_conflict: playtest tape and legacy actions cannot run together.');
             }
@@ -753,6 +773,7 @@ async function runHostedLoadCheck(options) {
             else if (options.postReadyWaitMs && options.postReadyWaitMs > 0) {
                 await page.waitForTimeout(options.postReadyWaitMs);
             }
+            await saveGameFrameScreenshot(page, options.gameFrameScreenshotPath);
             screenshotPath = await saveScreenshot(page, options.screenshotPath);
         }, {
             ...options.contextOptions,
@@ -981,6 +1002,11 @@ async function runUploadedHostedLoadCheck(input) {
             expectedHostedLaunchState: resolvePostAuthHostedLaunchState(preview.localAppMetadata.controllerMode),
             contextOptions,
             screenshotPath: input.screenshotPath,
+            readyGameFrameScreenshotPath: input.readyGameFrameScreenshotPath,
+            gameFrameScreenshotPath: input.gameFrameScreenshotPath,
+            playtestTape: input.playtestTape,
+            playtestSurface: captureSurface,
+            postReadyWaitMs: input.postReadyWaitMs,
         });
     }
     else if (anonymousExpectedState === 'login_required') {
@@ -1009,6 +1035,11 @@ async function runUploadedHostedLoadCheck(input) {
                     savedSessionBootstrap: true,
                     contextOptions,
                     screenshotPath: input.screenshotPath,
+                    readyGameFrameScreenshotPath: input.readyGameFrameScreenshotPath,
+                    gameFrameScreenshotPath: input.gameFrameScreenshotPath,
+                    playtestTape: input.playtestTape,
+                    playtestSurface: captureSurface,
+                    postReadyWaitMs: input.postReadyWaitMs,
                 });
             }
         }
@@ -1021,6 +1052,11 @@ async function runUploadedHostedLoadCheck(input) {
             expectedHostedLaunchState: anonymousExpectedState,
             contextOptions,
             screenshotPath: input.screenshotPath,
+            readyGameFrameScreenshotPath: input.readyGameFrameScreenshotPath,
+            gameFrameScreenshotPath: input.gameFrameScreenshotPath,
+            playtestTape: input.playtestTape,
+            playtestSurface: captureSurface,
+            postReadyWaitMs: input.postReadyWaitMs,
         });
     }
     const recorded = await input.client.recordAppUploadLaunchCheck(input.creatorUsername, input.task.name, input.sessionId, {
@@ -1042,3 +1078,189 @@ async function runUploadedHostedLoadCheck(input) {
         artifactFingerprint: recordedLaunchCheck.artifactFingerprint,
     };
 }
+function sliceFirstPrimaryVerbAction(tape) {
+    const prefix = tape.events.slice(0, tape.startOnlyEventCount);
+    const postStartEvents = tape.events.slice(tape.startOnlyEventCount);
+    let actionEventCount = 0;
+    if (tape.primaryVerb === 'tap') {
+        actionEventCount = 1;
+    }
+    else if (tape.primaryVerb === 'key') {
+        const activeKeys = new Set();
+        for (let index = 0; index < postStartEvents.length; index += 1) {
+            const event = postStartEvents[index];
+            if (event.type === 'keyDown')
+                activeKeys.add(event.key);
+            if (event.type === 'keyUp')
+                activeKeys.delete(event.key);
+            if (activeKeys.size === 0 && index > 0) {
+                actionEventCount = index + 1;
+                break;
+            }
+        }
+    }
+    else {
+        const activePointers = new Set();
+        for (let index = 0; index < postStartEvents.length; index += 1) {
+            const event = postStartEvents[index];
+            if (event.type === 'pointerDown')
+                activePointers.add(event.pointerId ?? 0);
+            if (event.type === 'pointerUp')
+                activePointers.delete(event.pointerId ?? 0);
+            if (activePointers.size === 0 && index > 0) {
+                actionEventCount = index + 1;
+                break;
+            }
+        }
+    }
+    if (actionEventCount <= 0) {
+        throw new Error(`agent_task_machine_causal_gate_invalid_tape:first_${tape.primaryVerb}_action_incomplete`);
+    }
+    return {
+        ...tape,
+        events: [...prefix, ...postStartEvents.slice(0, actionEventCount)],
+    };
+}
+async function hashFile(path) {
+    return (0, node_crypto_1.createHash)('sha256').update(await (0, promises_1.readFile)(path)).digest('hex');
+}
+async function compareCausalFrames(firstPath, secondPath) {
+    const readPixels = async (path) => {
+        return await (0, sharp_1.default)(path)
+            .resize(64, 64, { fit: 'fill' })
+            .greyscale()
+            .raw()
+            .toBuffer();
+    };
+    const [first, second] = await Promise.all([readPixels(firstPath), readPixels(secondPath)]);
+    if (first.length !== second.length || first.length === 0) {
+        throw new Error('agent_task_machine_causal_gate_frame_shape_mismatch');
+    }
+    let deltaTotal = 0;
+    let changedPixels = 0;
+    for (let index = 0; index < first.length; index += 1) {
+        const delta = Math.abs(first[index] - second[index]);
+        deltaTotal += delta;
+        if (delta >= 16)
+            changedPixels += 1;
+    }
+    const meanDelta = deltaTotal / first.length / 255;
+    const changedPixelRatio = changedPixels / first.length;
+    return {
+        meanDelta,
+        changedPixelRatio,
+        passed: meanDelta >= CAUSAL_FRAME_MEAN_DELTA_MIN || changedPixelRatio >= CAUSAL_FRAME_CHANGED_PIXEL_RATIO_MIN,
+    };
+}
+async function runUploadedHostedCausalCheck(input) {
+    const primarySurface = input.task.primarySurface;
+    const fullTape = primarySurface ? input.task.playtestTapes?.[primarySurface] : null;
+    if (!primarySurface || !fullTape) {
+        throw new Error('agent_task_machine_causal_gate_primary_tape_required');
+    }
+    if (fullTape.startOnlyEventCount <= 0) {
+        throw new Error('agent_task_machine_causal_gate_start_only_required');
+    }
+    const startOnlyTape = {
+        ...fullTape,
+        events: fullTape.events.slice(0, fullTape.startOnlyEventCount),
+    };
+    const firstActionTape = sliceFirstPrimaryVerbAction(fullTape);
+    const tempDir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'playdrop-causal-gate-'));
+    const paths = {
+        zeroInput: (0, node_path_1.join)(tempDir, 'zero-input.png'),
+        startOnlyReady: (0, node_path_1.join)(tempDir, 'start-only-ready.png'),
+        startOnly: (0, node_path_1.join)(tempDir, 'start-only.png'),
+        firstAction: (0, node_path_1.join)(tempDir, 'first-action.png'),
+        fullTape: (0, node_path_1.join)(tempDir, 'full-tape.png'),
+    };
+    const run = async (label, options) => {
+        console.log(`[upload] Machine causal gate: ${label} from sdk.host.ready().`);
+        const result = await runUploadedHostedLoadCheck({
+            client: input.client,
+            creatorUsername: input.creatorUsername,
+            task: input.task,
+            sessionId: input.sessionId,
+            timeoutMs: input.timeoutMs,
+            token: input.token,
+            currentUser: input.currentUser,
+            captureSession: input.captureSession,
+            ...options,
+        });
+        if (result.status !== 'PASSED') {
+            throw new Error(`Machine causal ${label} run failed. ${formatHostedLoadCheckFailure(input.task.name, result, 'staged')}`);
+        }
+        if (!result.artifactFingerprint) {
+            throw new Error('agent_task_machine_causal_gate_artifact_fingerprint_missing');
+        }
+        return result;
+    };
+    try {
+        const zeroInput = await run('zero-input', {
+            postReadyWaitMs: fullTape.durationMs,
+            gameFrameScreenshotPath: paths.zeroInput,
+        });
+        const startOnly = await run('start-only', {
+            playtestTape: startOnlyTape,
+            readyGameFrameScreenshotPath: paths.startOnlyReady,
+            gameFrameScreenshotPath: paths.startOnly,
+        });
+        const firstAction = await run('first-action', {
+            playtestTape: firstActionTape,
+            gameFrameScreenshotPath: paths.firstAction,
+        });
+        const full = await run('full-tape', {
+            playtestTape: fullTape,
+            gameFrameScreenshotPath: paths.fullTape,
+        });
+        const artifactFingerprint = full.artifactFingerprint;
+        if ([zeroInput, startOnly, firstAction].some((result) => result.artifactFingerprint !== artifactFingerprint)) {
+            throw new Error('agent_task_machine_causal_gate_artifact_changed_during_check');
+        }
+        const comparisons = {
+            startOnlyVsReady: await compareCausalFrames(paths.startOnlyReady, paths.startOnly),
+            startOnlyVsZeroInput: await compareCausalFrames(paths.zeroInput, paths.startOnly),
+            fullTapeVsZeroInput: await compareCausalFrames(paths.zeroInput, paths.fullTape),
+            fullTapeVsStartOnly: await compareCausalFrames(paths.startOnly, paths.fullTape),
+            fullTapeVsFirstAction: await compareCausalFrames(paths.firstAction, paths.fullTape),
+        };
+        if (!comparisons.startOnlyVsReady.passed || !comparisons.startOnlyVsZeroInput.passed) {
+            throw new Error('agent_task_machine_causal_gate_failed:start-only did not provably leave the title state. Fix the start action or ready-relative timing.');
+        }
+        if (!comparisons.fullTapeVsZeroInput.passed || !comparisons.fullTapeVsStartOnly.passed) {
+            throw new Error('agent_task_machine_causal_gate_failed:full tape did not meaningfully beat zero-input and start-only controls. Fix the game or tape before upload.');
+        }
+        if (!comparisons.fullTapeVsFirstAction.passed) {
+            throw new Error('agent_task_machine_causal_gate_failed:first primary action trivially reached the full-tape outcome. Add a sustained causal loop before upload.');
+        }
+        const teachingText = input.teachingText.trim();
+        const evidence = {
+            version: 1,
+            source: 'CLI_MACHINE',
+            artifactFingerprint,
+            primarySurface,
+            primaryVerb: fullTape.primaryVerb,
+            runs: {
+                zeroInput: { finalFrameSha256: await hashFile(paths.zeroInput) },
+                startOnly: {
+                    readyFrameSha256: await hashFile(paths.startOnlyReady),
+                    finalFrameSha256: await hashFile(paths.startOnly),
+                },
+                firstAction: { finalFrameSha256: await hashFile(paths.firstAction) },
+                fullTape: { finalFrameSha256: await hashFile(paths.fullTape) },
+            },
+            comparisons,
+            teachingText,
+            teachingTextSha256: (0, node_crypto_1.createHash)('sha256').update(teachingText).digest('hex'),
+        };
+        const recorded = await input.client.recordAppUploadCausalCheck(input.creatorUsername, input.task.name, input.sessionId, { evidence });
+        if (recorded.session.causalCheck.status !== 'PASSED') {
+            throw new Error('agent_task_machine_causal_gate_not_recorded');
+        }
+        console.log(`[upload] Machine causal gate passed for ${input.creatorUsername}/${input.task.name}.`);
+        return evidence;
+    }
+    finally {
+        await (0, promises_1.rm)(tempDir, { recursive: true, force: true });
+    }
+}

package/dist/apps/playtestContract.d.ts

@@ -0,0 +1,2 @@
+import type { AppTask } from '../catalogue';
+export declare function assertPrimaryVerbTeachingParity(task: AppTask): string;

package/dist/apps/playtestContract.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertPrimaryVerbTeachingParity = assertPrimaryVerbTeachingParity;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const types_1 = require("@playdrop/types");
+function extractPotentialPlayerText(source, extension) {
+    const candidates = new Set();
+    if (extension === '.html') {
+        const visibleText = source
+            .replace(/<!--[\s\S]*?-->/g, ' ')
+            .replace(/<(?:script|style)\b[^>]*>[\s\S]*?<\/(?:script|style)>/gi, ' ')
+            .replace(/<[^>]+>/g, ' ')
+            .replace(/\s+/g, ' ')
+            .trim();
+        if (visibleText)
+            candidates.add(visibleText.slice(0, 300));
+    }
+    const stringLiteral = /"((?:\\.|[^"\\]){1,300})"|'((?:\\.|[^'\\]){1,300})'|`((?:\\.|[^`\\]){1,300})`/g;
+    for (const match of source.matchAll(stringLiteral)) {
+        const text = (match[1] ?? match[2] ?? match[3] ?? '')
+            .replace(/\\[nrt]/g, ' ')
+            .replace(/\s+/g, ' ')
+            .trim();
+        if (text)
+            candidates.add(text);
+    }
+    return Array.from(candidates);
+}
+function readPrimaryVerbTeachingText(task) {
+    const runtimeRoot = (0, node_path_1.dirname)(task.filePath);
+    const matches = new Set();
+    const walk = (dir) => {
+        for (const entry of (0, node_fs_1.readdirSync)(dir, { withFileTypes: true })) {
+            const absolute = (0, node_path_1.join)(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!['node_modules', '.git', 'assets'].includes(entry.name))
+                    walk(absolute);
+                continue;
+            }
+            if (!entry.isFile() || !['.html', '.js', '.mjs', '.cjs'].includes((0, node_path_1.extname)(entry.name).toLowerCase()))
+                continue;
+            const extension = (0, node_path_1.extname)(entry.name).toLowerCase();
+            const source = (0, node_fs_1.readFileSync)(absolute, 'utf8');
+            for (const text of extractPotentialPlayerText(source, extension)) {
+                if (types_1.APP_PLAYTEST_PRIMARY_VERB_VALUES.some((verb) => (0, types_1.appPlaytestTeachingTextMatchesVerb)(text, verb))) {
+                    matches.add(text);
+                }
+            }
+        }
+    };
+    walk(runtimeRoot);
+    return Array.from(matches);
+}
+function assertPrimaryVerbTeachingParity(task) {
+    const primarySurface = task.primarySurface;
+    const tape = primarySurface ? task.playtestTapes?.[primarySurface] : null;
+    if (!primarySurface || !tape) {
+        throw new Error('agent_task_primary_verb_tape_required');
+    }
+    const teachingTexts = readPrimaryVerbTeachingText(task);
+    const matchingText = teachingTexts.find((text) => (0, types_1.appPlaytestTeachingTextMatchesVerb)(text, tape.primaryVerb));
+    if (!matchingText) {
+        throw new Error(`agent_task_primary_verb_not_taught:${tape.primaryVerb}: show the player a concise instruction using the declared primary verb.`);
+    }
+    const competingVerbs = types_1.APP_PLAYTEST_PRIMARY_VERB_VALUES
+        .filter((verb) => verb !== tape.primaryVerb)
+        .filter((verb) => teachingTexts.some((text) => {
+        if (!(0, types_1.appPlaytestTeachingTextMatchesVerb)(text, verb))
+            return false;
+        return verb !== 'tap' || !/\btap\b[^\n]{0,30}\b(?:start|play|begin|continue|retry)\b/i.test(text);
+    }));
+    if (competingVerbs.length > 0) {
+        throw new Error(`agent_task_primary_verb_teaching_mismatch:${tape.primaryVerb}:${competingVerbs.join(',')}`);
+    }
+    return matchingText;
+}

package/dist/apps/upload.d.ts

@@ -23,6 +23,7 @@ export type AppUploadOptions = {
     agentTaskId?: number;
     playtestProof?: AgentTaskPlaytestProof;
     mediaCaptureRequired?: boolean;
+    machineCausalGateRequired?: boolean;
     captureSession?: TaskCaptureSession | null;
 };
 export declare function uploadApp(client: ApiClient, task: AppTask, artifacts: AppBuildArtifacts | null, options?: AppUploadOptions): Promise<AppUploadResult>;

package/dist/apps/upload.js

@@ -9,6 +9,7 @@ const node_path_1 = require("node:path");
 const http_1 = require("../http");
 const loadCheck_1 = require("./loadCheck");
 const listingPreflight_1 = require("../listingPreflight");
+const playtestContract_1 = require("./playtestContract");
 const EXTENSION_TO_MIME = {
     '.png': 'image/png',
     '.jpg': 'image/jpeg',
@@ -353,6 +354,22 @@ async function uploadAppVersion(client, task, artifacts, options) {
                 await client.recordAppUploadMediaCapture(creatorUsername, task.name, sessionId, mediaCaptureProof);
             }
             if (task.hostingMode !== 'EXTERNAL'
+                && !task.externalUrl
+                && options?.machineCausalGateRequired) {
+                const teachingText = (0, playtestContract_1.assertPrimaryVerbTeachingParity)(task);
+                await (0, loadCheck_1.runUploadedHostedCausalCheck)({
+                    client,
+                    creatorUsername,
+                    task,
+                    sessionId,
+                    teachingText,
+                    timeoutMs: options.loadCheckTimeoutMs,
+                    token: options?.token ?? null,
+                    currentUser: options?.user ?? null,
+                    captureSession: options?.captureSession,
+                });
+            }
+            else if (task.hostingMode !== 'EXTERNAL'
                 && !task.externalUrl
                 && options?.runStagedUploadLoadCheck) {
                 const loadCheck = await (0, loadCheck_1.runUploadedHostedLoadCheck)({

package/dist/commands/check.js

@@ -222,6 +222,7 @@ async function check(targetArg, options = {}) {
         });
         if (tapeSurface && playtestTape) {
             const idleScreenshotPath = buildComparisonScreenshotPath(screenshotPath, 'idle');
+            const startOnlyScreenshotPath = buildComparisonScreenshotPath(screenshotPath, 'start-only');
             const tapeScreenshotPath = buildComparisonScreenshotPath(screenshotPath, 'tape');
             console.log(`[check] Running ${playtestTape.durationMs} ms zero-input baseline on ${tapeSurface}.`);
             const idleResult = await runCheck({
@@ -234,6 +235,22 @@ async function check(targetArg, options = {}) {
                 process.exitCode = 1;
                 return;
             }
+            console.log(`[check] Reopening a clean run and executing only the first ${playtestTape.startOnlyEventCount} startup event(s).`);
+            const startOnlyTape = playtestTape.startOnlyEventCount > 0
+                ? { ...playtestTape, events: playtestTape.events.slice(0, playtestTape.startOnlyEventCount) }
+                : null;
+            const startOnlyResult = await runCheck({
+                screenshotPath: startOnlyScreenshotPath,
+                surface: tapeSurface,
+                ...(startOnlyTape
+                    ? { tape: startOnlyTape }
+                    : { postReadyWaitMs: playtestTape.durationMs }),
+            });
+            if (startOnlyResult.status !== 'PASSED') {
+                (0, messages_1.printErrorWithHelp)((0, loadCheck_1.formatHostedLoadCheckFailure)(appName, startOnlyResult, 'local'), startOnlyResult.screenshotPath ? [`Start-only screenshot: ${startOnlyResult.screenshotPath}`] : [], { command: 'project check' });
+                process.exitCode = 1;
+                return;
+            }
             console.log(`[check] Reopening a clean run and executing the ${tapeSurface} tape.`);
             const tapeResult = await runCheck({
                 screenshotPath: tapeScreenshotPath,
@@ -245,10 +262,11 @@ async function check(targetArg, options = {}) {
                 process.exitCode = 1;
                 return;
             }
-            console.log(`[check] Captured matched idle and tape runs for ${currentUsername}/${appName}.`);
+            console.log(`[check] Captured matched idle, start-only, and tape runs for ${currentUsername}/${appName}.`);
             console.log(`[check] Idle: ${idleResult.screenshotPath ?? idleScreenshotPath}`);
+            console.log(`[check] Start-only: ${startOnlyResult.screenshotPath ?? startOnlyScreenshotPath}`);
             console.log(`[check] Tape: ${tapeResult.screenshotPath ?? tapeScreenshotPath}`);
-            console.log('[check] The tape passes only when visible evidence shows it meaningfully beats idle.');
+            console.log('[check] The tape passes only when visible evidence shows it meaningfully beats both controls.');
             for (const signal of playtestTape.successSignals) {
                 console.log(`[check] Success signal ${signal.kind}: ${signal.description}`);
             }

package/dist/commands/upload.js

@@ -1234,9 +1234,16 @@ function assertAgentNewGamePlaytestContract(task) {
         throw new Error('agent_task_playtest_tapes_required: NEW_GAME catalogue.json must declare one playtest tape per supported surface.');
     }
     for (const surface of task.surfaceTargets) {
-        if (!task.playtestTapes[surface]) {
+        const tape = task.playtestTapes[surface];
+        if (!tape) {
             throw new Error(`agent_task_playtest_tape_missing:${surface}`);
         }
+        if (tape.startOnlyEventCount <= 0) {
+            throw new Error(`agent_task_playtest_start_only_required:${surface}: the tape must include an explicit startup action.`);
+        }
+        if (tape.events[0]?.atMs !== 0) {
+            throw new Error(`agent_task_playtest_ready_relative_timing_required:${surface}: the first startup event must run at 0 ms after sdk.host.ready().`);
+        }
     }
 }
 const WORKER_SUPERVISOR_SOURCE_EXCLUDES = [
@@ -2025,6 +2032,7 @@ async function publishWorkerAppProject(input) {
         agentTaskId: input.taskId,
         playtestProof: playtestProof ?? undefined,
         mediaCaptureRequired: input.executionTarget === 'FIRST_PARTY',
+        machineCausalGateRequired: input.kind === 'NEW_GAME',
         captureSession,
     });
     if (!uploadResult.versionCreated || !uploadResult.version) {

package/dist/commands/worker/instrument-evidence.js

@@ -257,7 +257,14 @@ function readAndValidateInstrumentEvidenceManifest(input) {
     const captures = {};
     const screenshotIds = new Set();
     for (const name of types_1.INSTRUMENT_EVIDENCE_NAMES) {
-        const capture = normalizeCapture(parsed.captures?.[name], name);
+        const rawCapture = parsed.captures?.[name];
+        if (!rawCapture) {
+            if (types_1.REQUIRED_INSTRUMENT_EVIDENCE_NAMES.includes(name)) {
+                throw new Error(`invalid_instrument_evidence_capture:${name}`);
+            }
+            continue;
+        }
+        const capture = normalizeCapture(rawCapture, name);
         if (capture.tabId !== controlledTabId) {
             throw new Error(`instrument_evidence_tab_mismatch:${controlledTabId}:${capture.tabId}`);
         }

package/dist/commands/worker.js

@@ -5048,7 +5048,7 @@ async function submitEvalTask(options) {
         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}`);
+                continue;
             }
             const filePath = node_path_1.default.join(node_path_1.default.resolve(evidenceDir), capture.fileName);
             evidenceFiles.push({

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

@@ -1,4 +1,4 @@
-import type { AbortAppUploadResponse, AbortAssetPackUploadResponse, AdInterstitialShowResponse, AdLoadRequest, AdLoadResponse, AdRewardedShowResponse, AdShowRequest, AdminAgentTaskDetailResponse, AdminAgentTaskTranscriptResponse, AdminAgentTasksResponse, AdminAgentWorkersStatusResponse, AdminAppPlayerMetaResponse, AdminAppPlayerMetaUserResponse, AdminAppVersionReviewsListResponse, AdminAppsListResponse, AdminCreatorEngagementExecutionsResponse, AdminCreatorEngagementRulePreviewRequest, AdminCreatorEngagementRulePreviewResponse, AdminCreatorEngagementRulesResponse, AdminCreatorEngagementUserResponse, AdminCreditTransactionsResponse, AdminEnqueueNextAppVersionReviewTaskResponse, AdminFeedbackListResponse, AdminFeedbackResponse, AdminGameCollectionCandidatesResponse, AdminGameCollectionResponse, AdminGameCollectionsResponse, AdminMutateAchievementStateRequest, AdminMutateAchievementStateResponse, AdminMutateLeaderboardScoreRequest, AdminMutateLeaderboardScoreResponse, AdminPaymentDetailResponse, AdminPaymentsListResponse, AdminPlatformAnalyticsRequest, AdminPlatformAnalyticsResponse, AdminRefundPaymentRequest, AdminRetirePlayerMetaDefinitionResponse, AdminTagGroupResponse, AdminTagGroupsResponse, AdminTagResponse, AdminUpdateAppRequest, AdminUpdateAppResponse, AdminUpdateAppVersionReviewRequest, AdminUpdateAppVersionReviewResponse, AdminUserResponse, AgentTaskAttachmentUploadResponse, AgentTaskAvailabilityResponse, AgentTaskCreatorFeedbackStatus, AgentTaskDetailResponse, AgentTaskEventsResponse, AgentTaskKind, AgentTaskNewGameSuggestionsResponse, AgentTasksResponse, AiGenerationDetailResponse, AiGenerationsResponse, ApiKeyLoginRequest, AppAccessTokenResponse, AppAgentTaskResponse, AppBrowseRequest, AppDetailRequest, AppDetailResponse, AppLogEntryRequest, AppLogEntryResponse, AppMoreCollectionKey, AppMoreCollectionPage, AppMoreCollectionRequest, AppMoreCollectionsRequest, AppMoreCollectionsResponse, AppRuntimeAssetsResponse, AppSourceBundleResponse, AppType, AppUploadLaunchCheckPreviewResponse, AppVersionDetailResponse, AppVersionVisibility, AppVersionsListResponse, AppleCreditPackFulfillmentRequest, AppleLinkRequest, AppleLinkResponse, AppleNativeChallengeResponse, AppleOAuthHandoffExchangeRequest, AppleOAuthHandoffExchangeResponse, AppleOAuthLinkStartRequest, AppleOAuthLinkStartResponse, ApplePendingSignupResponse, ApplePushDeviceRequest, ApplePushDeviceStatusResponse, AppleSignInRequest, AppleSignInResponse, AppsListResponse, AssetBrowseKind, AssetCategoriesResponse, AssetCategory, AssetDetailResponse, AssetFormat, AssetListResponse, AssetListSort, AssetPackDetailResponse, AssetPackListResponse, AssetPackListSort, AssetPackSourceBundleResponse, AssetPackVersionsListResponse, AssetPurchaseRequest, AssetSourceBundleResponse, AssetSourceKind, AssetSpecAppsListResponse, AssetSpecAssetsListResponse, AssetSpecDetailResponse, AssetSpecListResponse, AssetSpecListSort, AssetSpecVersionResponseEnvelope, AssetSpecVersionsListResponse, AssetVersionsListResponse, AssetVisibility, BatchCreateUsersResponse, BatchUpsertNodeRelationsRequest, BatchUpsertNodeRelationsResponse, BoostActivationRequest, BoostBalanceResponse, BoostHistoryResponse, BoostPurchaseRequest, BoostPurchaseResponse, BoostReportQuery, BoostReportResponse, BoostStatusResponse, BootstrapResponse, CancelAgentTaskResponse, ChangePasswordRequest, ChangePasswordResponse, ClaimFreeCreditRewardResponse, ClearAgentTaskResponse, CliApiKeyStatusResponse, CliApiTokenSecretResponse, CliApiTokensResponse, CliLoginApproveRequest, CliLoginApproveResponse, CliLoginPollRequest, CliLoginPollResponse, CliLoginStartResponse, CliLoginStatusResponse, CliWebLaunchStartRequest, CliWebLaunchStartResponse, CompleteAppleSignupRequest, CompleteAppleSignupResponse, CompleteGoogleSignupRequest, CompleteGoogleSignupResponse, CompleteXSignupRequest, CompleteXSignupResponse, NativeOAuthHandoffExchangeRequest, NativeOAuthHandoffExchangeResponse, NativeOAuthLinkStartRequest, NativeOAuthLinkStartResponse, ContentCommentsResponse, ContentLicense, ContentRemixRelationsResponse, CreateAdminGameCollectionRequest, CreateAppAgentTaskRequest, CreateAppAgentTaskResponse, CreateAppRequest, CreateAppResponse, CreateAssetSpecVersionResponse, CreateAssetVersionResponse, CreateCliApiKeyResponse, CreateCliApiTokenRequest, CreateCommentReportRequest, CreateContentCommentRequest, CreateContentCommentResponse, CreateContentReportRequest, CreateCreatorReportRequest, CreateGameEvalAgentTaskRequest, CreateGameEvalAgentTaskResponse, CreateNewGameAgentTaskRequest, CreateNewGameAgentTaskResponse, CreateRemixGameAgentTaskRequest, CreateRemixGameAgentTaskResponse, CreateTagGroupRequest, CreateTagRequest, CreateUserRequest, CreateUserResponse, CreatorAppsBrowseRequest, CreatorBlockMutationResponse, CreatorEarningsResponse, CreatorEngagementRuleExecutionStatus, CreatorFollowMutationResponse, CreatorGameCreatorFeedbackStatusResponse, CreatorGameShareResponse, CreatorGameStatusResponse, CreatorGameVersionsResponse, CreatorGamesListResponse, CreditPackCheckoutSessionRequest, CreditPackCheckoutSessionResponse, CreditPackCheckoutStatusResponse, CreditPackResponse, CreditPacksResponse, DeleteAdminGameCollectionResponse, DeleteAdminUserResponse, DeleteAppResponse, DeleteAssetPackResponse, DeleteAssetPackVersionResponse, DeleteAssetResponse, DeleteAssetSpecResponse, DeleteAssetSpecVersionResponse, DeleteAssetVersionResponse, DeleteCliApiTokenResponse, DeleteContentCommentResponse, DeleteFeedbackResponse, DeleteMyAccountRequest, DeleteMyAccountResponse, DeleteOwnedCustomAssetResponse, DeleteVersionResponse, DevAppAccessTokenResponse, DevPlayerResetResponse, DislikedItemMutationResponse, EmailPreferencesResponse, EmailUnsubscribeResponse, FeedbackCategory, FeedbackClient, FeedbackListResponse, FeedbackStatus, FetchHomeOptions, FinalizeAppUploadResponse, FinalizeAssetPackUploadResponse, FirebasePushDeviceRequest, FirebasePushDeviceStatusResponse, FollowingCreatorsResponse, FollowingFeedResponse, FollowingFeedSection, FollowingSort, FreeCreditsResponse, GetAchievementResponse, GetLeaderboardResponse, GoogleAppleLinkRequest, GoogleAppleLinkResponse, GoogleAppleSignInRequest, GoogleAppleSignInResponse, GoogleCreditPackFulfillmentRequest, GoogleOneTapExchangeRequest, GoogleOneTapExchangeResponse, GooglePendingSignupResponse, HomeCollectionPageResponse, HomeResponse, IapPurchaseRequest, IapPurchaseResponse, IapReceiptListParams, IapReceiptResponse, IapReceiptsResponse, InitializeAppUploadRequest, InitializeAppUploadResponse, InitializeAssetPackUploadRequest, InitializeAssetPackUploadResponse, InvitePreviewResponse, LibraryCategory, LibraryResponse, LibrarySort, LikedItemMutationResponse, ListAchievementsResponse, ListLeaderboardsResponse, ListOwnedCustomAssetsResponse, LoadOwnedCustomAssetResponse, LoginRequest, LoginResponse, LogoutResponse, MeAgentWorkersResponse, MeResponse, MobileCreditPackFulfillmentResponse, ModerationReportResponse, MutateOwnedCustomAssetRequest, MutateOwnedCustomAssetResponse, MyAchievementsResponse, MyAppsResponse, MyInviteCodeResponse, MyLeaderboardsResponse, NotificationReadResponse, NotificationStatus, NotificationsResponse, OwnedProfileAssetsResponse, PaymentProvider, PaymentStatus, PrivacyExportResponse, PublicEmailPreferencesResponse, PublicEmailPreferencesUpdateRequest, PurchaseResponse, PushSubscriptionMutationResponse, RecordAppUploadLaunchCheckRequest, RecordAppUploadLaunchCheckResponse, RecordAppUploadMediaCaptureRequest, RecordAppUploadMediaCaptureResponse, RegisterRequest, RegisterResponse, RemixScaffoldResponse, ResolveRuntimeAssetsRequest, ResolveRuntimeAssetsResponse, RetryAgentTaskResponse, ReviewState, SavedItemKind, SavedItemMutationResponse, SearchRequest, SearchResponse, SearchSuggestRequest, SearchSuggestResponse, SetAchievementProgressRequest, SetAchievementProgressResponse, SetProfileAssetRequest, SetProfileAssetResponse, ShopResponse, StarterProfileAssetsResponse, SubmitFeedbackRequest, SubmitFeedbackResponse, SubmitLeaderboardScoreRequest, SubmitLeaderboardScoreResponse, TagDetailResponse, TagDirectoryResponse, TagGroupDetailResponse, TagGroupSort, TagListResponse, TemplateScaffoldResponse, TrackEngagementEventRequest, TrackEngagementEventResponse, TransactionsResponse, UnlinkGoogleResponse, UnlinkXResponse, UnlockAchievementResponse, UpdateAdminFeedbackRequest, UpdateAdminFeedbackResponse, UpdateAdminGameCollectionGamesRequest, UpdateAdminGameCollectionRequest, UpdateAdminUserRequest, UpdateAppRequest, UpdateAppResponse, UpdateAssetPackRequest, UpdateAssetPackResponse, UpdateAssetPackVersionRequest, UpdateAssetPackVersionResponse, UpdateAssetRequest, UpdateAssetResponse, UpdateAssetSpecVersionResponse, UpdateAssetVersionRequest, UpdateAssetVersionResponse, UpdateProfileRequest, UpdateProfileResponse, UpdateTagGroupRequest, UpdateTagRequest, UpdateUserCommunicationPreferencesRequest, UpdateVersionResponse, UploadAppSessionFileResponse, UploadAppSessionOwnedAssetResponse, UploadAssetPackSessionAssetResponse, UploadAssetPackSessionMediaResponse, UpsertWebPushSubscriptionRequest, UserDetailResponse, UsernameAvailableResponse, UsersListResponse, WebPushConfigResponse, WebPushSubscriptionStatusResponse, WorkerAgentTaskAttemptUnavailableRequest, WorkerAgentTaskAttemptUnavailableResponse, WorkerClaimAgentTaskRequest, WorkerClaimAgentTaskResponse, WorkerClaimAgentTaskSlugRequest, WorkerClaimAgentTaskSlugResponse, WorkerCompleteAgentTaskRequest, WorkerCreateAgentTaskEventRequest, WorkerCreateAgentTaskEventResponse, WorkerCreateAgentTaskTranscriptChunkRequest, WorkerCreateAgentTaskTranscriptChunkResponse, WorkerFailAgentTaskRequest, WorkerHeartbeatAgentTaskRequest, WorkerHeartbeatAgentTaskResponse, WorkerPresenceRequest, WorkerPresenceResponse, RegisterAgentBundleRequest, RegisterAgentBundleResponse, WorkerRecordAgentTaskRunTelemetryRequest, WorkerRecordAgentTaskRunTelemetryResponse, WorkerSubmitAgentTaskEvalRequest, WorkerSubmitAgentTaskEvalResponse, WorkerSubmitAgentTaskReviewRequest, WorkerSubmitAgentTaskReviewResponse, WorkerUpdateIntentRequest, WorkerUpdateIntentResponse, XPendingSignupResponse } from '@playdrop/types';
+import type { AbortAppUploadResponse, AbortAssetPackUploadResponse, AdInterstitialShowResponse, AdLoadRequest, AdLoadResponse, AdRewardedShowResponse, AdShowRequest, AdminAgentTaskDetailResponse, AdminAgentTaskTranscriptResponse, AdminAgentTasksResponse, AdminAgentWorkersStatusResponse, AdminAppPlayerMetaResponse, AdminAppPlayerMetaUserResponse, AdminAppVersionReviewsListResponse, AdminAppsListResponse, AdminCreatorEngagementExecutionsResponse, AdminCreatorEngagementRulePreviewRequest, AdminCreatorEngagementRulePreviewResponse, AdminCreatorEngagementRulesResponse, AdminCreatorEngagementUserResponse, AdminCreditTransactionsResponse, AdminEnqueueNextAppVersionReviewTaskResponse, AdminFeedbackListResponse, AdminFeedbackResponse, AdminGameCollectionCandidatesResponse, AdminGameCollectionResponse, AdminGameCollectionsResponse, AdminMutateAchievementStateRequest, AdminMutateAchievementStateResponse, AdminMutateLeaderboardScoreRequest, AdminMutateLeaderboardScoreResponse, AdminPaymentDetailResponse, AdminPaymentsListResponse, AdminPlatformAnalyticsRequest, AdminPlatformAnalyticsResponse, AdminRefundPaymentRequest, AdminRetirePlayerMetaDefinitionResponse, AdminTagGroupResponse, AdminTagGroupsResponse, AdminTagResponse, AdminUpdateAppRequest, AdminUpdateAppResponse, AdminUpdateAppVersionReviewRequest, AdminUpdateAppVersionReviewResponse, AdminUserResponse, AgentTaskAttachmentUploadResponse, AgentTaskAvailabilityResponse, AgentTaskCreatorFeedbackStatus, AgentTaskDetailResponse, AgentTaskEventsResponse, AgentTaskKind, AgentTaskNewGameSuggestionsResponse, AgentTasksResponse, AiGenerationDetailResponse, AiGenerationsResponse, ApiKeyLoginRequest, AppAccessTokenResponse, AppAgentTaskResponse, AppBrowseRequest, AppDetailRequest, AppDetailResponse, AppLogEntryRequest, AppLogEntryResponse, AppMoreCollectionKey, AppMoreCollectionPage, AppMoreCollectionRequest, AppMoreCollectionsRequest, AppMoreCollectionsResponse, AppRuntimeAssetsResponse, AppSourceBundleResponse, AppType, AppUploadLaunchCheckPreviewResponse, AppVersionDetailResponse, AppVersionVisibility, AppVersionsListResponse, AppleCreditPackFulfillmentRequest, AppleLinkRequest, AppleLinkResponse, AppleNativeChallengeResponse, AppleOAuthHandoffExchangeRequest, AppleOAuthHandoffExchangeResponse, AppleOAuthLinkStartRequest, AppleOAuthLinkStartResponse, ApplePendingSignupResponse, ApplePushDeviceRequest, ApplePushDeviceStatusResponse, AppleSignInRequest, AppleSignInResponse, AppsListResponse, AssetBrowseKind, AssetCategoriesResponse, AssetCategory, AssetDetailResponse, AssetFormat, AssetListResponse, AssetListSort, AssetPackDetailResponse, AssetPackListResponse, AssetPackListSort, AssetPackSourceBundleResponse, AssetPackVersionsListResponse, AssetPurchaseRequest, AssetSourceBundleResponse, AssetSourceKind, AssetSpecAppsListResponse, AssetSpecAssetsListResponse, AssetSpecDetailResponse, AssetSpecListResponse, AssetSpecListSort, AssetSpecVersionResponseEnvelope, AssetSpecVersionsListResponse, AssetVersionsListResponse, AssetVisibility, BatchCreateUsersResponse, BatchUpsertNodeRelationsRequest, BatchUpsertNodeRelationsResponse, BoostActivationRequest, BoostBalanceResponse, BoostHistoryResponse, BoostPurchaseRequest, BoostPurchaseResponse, BoostReportQuery, BoostReportResponse, BoostStatusResponse, BootstrapResponse, CancelAgentTaskResponse, ChangePasswordRequest, ChangePasswordResponse, ClaimFreeCreditRewardResponse, ClearAgentTaskResponse, CliApiKeyStatusResponse, CliApiTokenSecretResponse, CliApiTokensResponse, CliLoginApproveRequest, CliLoginApproveResponse, CliLoginPollRequest, CliLoginPollResponse, CliLoginStartResponse, CliLoginStatusResponse, CliWebLaunchStartRequest, CliWebLaunchStartResponse, CompleteAppleSignupRequest, CompleteAppleSignupResponse, CompleteGoogleSignupRequest, CompleteGoogleSignupResponse, CompleteXSignupRequest, CompleteXSignupResponse, NativeOAuthHandoffExchangeRequest, NativeOAuthHandoffExchangeResponse, NativeOAuthLinkStartRequest, NativeOAuthLinkStartResponse, ContentCommentsResponse, ContentLicense, ContentRemixRelationsResponse, CreateAdminGameCollectionRequest, CreateAppAgentTaskRequest, CreateAppAgentTaskResponse, CreateAppRequest, CreateAppResponse, CreateAssetSpecVersionResponse, CreateAssetVersionResponse, CreateCliApiKeyResponse, CreateCliApiTokenRequest, CreateCommentReportRequest, CreateContentCommentRequest, CreateContentCommentResponse, CreateContentReportRequest, CreateCreatorReportRequest, CreateGameEvalAgentTaskRequest, CreateGameEvalAgentTaskResponse, CreateNewGameAgentTaskRequest, CreateNewGameAgentTaskResponse, CreateRemixGameAgentTaskRequest, CreateRemixGameAgentTaskResponse, CreateTagGroupRequest, CreateTagRequest, CreateUserRequest, CreateUserResponse, CreatorAppsBrowseRequest, CreatorBlockMutationResponse, CreatorEarningsResponse, CreatorEngagementRuleExecutionStatus, CreatorFollowMutationResponse, CreatorGameCreatorFeedbackStatusResponse, CreatorGameShareResponse, CreatorGameStatusResponse, CreatorGameVersionsResponse, CreatorGamesListResponse, CreditPackCheckoutSessionRequest, CreditPackCheckoutSessionResponse, CreditPackCheckoutStatusResponse, CreditPackResponse, CreditPacksResponse, DeleteAdminGameCollectionResponse, DeleteAdminUserResponse, DeleteAppResponse, DeleteAssetPackResponse, DeleteAssetPackVersionResponse, DeleteAssetResponse, DeleteAssetSpecResponse, DeleteAssetSpecVersionResponse, DeleteAssetVersionResponse, DeleteCliApiTokenResponse, DeleteContentCommentResponse, DeleteFeedbackResponse, DeleteMyAccountRequest, DeleteMyAccountResponse, DeleteOwnedCustomAssetResponse, DeleteVersionResponse, DevAppAccessTokenResponse, DevPlayerResetResponse, DislikedItemMutationResponse, EmailPreferencesResponse, EmailUnsubscribeResponse, FeedbackCategory, FeedbackClient, FeedbackListResponse, FeedbackStatus, FetchHomeOptions, FinalizeAppUploadResponse, FinalizeAssetPackUploadResponse, FirebasePushDeviceRequest, FirebasePushDeviceStatusResponse, FollowingCreatorsResponse, FollowingFeedResponse, FollowingFeedSection, FollowingSort, FreeCreditsResponse, GetAchievementResponse, GetLeaderboardResponse, GoogleAppleLinkRequest, GoogleAppleLinkResponse, GoogleAppleSignInRequest, GoogleAppleSignInResponse, GoogleCreditPackFulfillmentRequest, GoogleOneTapExchangeRequest, GoogleOneTapExchangeResponse, GooglePendingSignupResponse, HomeCollectionPageResponse, HomeResponse, IapPurchaseRequest, IapPurchaseResponse, IapReceiptListParams, IapReceiptResponse, IapReceiptsResponse, InitializeAppUploadRequest, InitializeAppUploadResponse, InitializeAssetPackUploadRequest, InitializeAssetPackUploadResponse, InvitePreviewResponse, LibraryCategory, LibraryResponse, LibrarySort, LikedItemMutationResponse, ListAchievementsResponse, ListLeaderboardsResponse, ListOwnedCustomAssetsResponse, LoadOwnedCustomAssetResponse, LoginRequest, LoginResponse, LogoutResponse, MeAgentWorkersResponse, MeResponse, MobileCreditPackFulfillmentResponse, ModerationReportResponse, MutateOwnedCustomAssetRequest, MutateOwnedCustomAssetResponse, MyAchievementsResponse, MyAppsResponse, MyInviteCodeResponse, MyLeaderboardsResponse, NotificationReadResponse, NotificationStatus, NotificationsResponse, OwnedProfileAssetsResponse, PaymentProvider, PaymentStatus, PrivacyExportResponse, PublicEmailPreferencesResponse, PublicEmailPreferencesUpdateRequest, PurchaseResponse, PushSubscriptionMutationResponse, RecordAppUploadLaunchCheckRequest, RecordAppUploadLaunchCheckResponse, RecordAppUploadCausalCheckRequest, RecordAppUploadCausalCheckResponse, RecordAppUploadMediaCaptureRequest, RecordAppUploadMediaCaptureResponse, RegisterRequest, RegisterResponse, RemixScaffoldResponse, ResolveRuntimeAssetsRequest, ResolveRuntimeAssetsResponse, RetryAgentTaskResponse, ReviewState, SavedItemKind, SavedItemMutationResponse, SearchRequest, SearchResponse, SearchSuggestRequest, SearchSuggestResponse, SetAchievementProgressRequest, SetAchievementProgressResponse, SetProfileAssetRequest, SetProfileAssetResponse, ShopResponse, StarterProfileAssetsResponse, SubmitFeedbackRequest, SubmitFeedbackResponse, SubmitLeaderboardScoreRequest, SubmitLeaderboardScoreResponse, TagDetailResponse, TagDirectoryResponse, TagGroupDetailResponse, TagGroupSort, TagListResponse, TemplateScaffoldResponse, TrackEngagementEventRequest, TrackEngagementEventResponse, TransactionsResponse, UnlinkGoogleResponse, UnlinkXResponse, UnlockAchievementResponse, UpdateAdminFeedbackRequest, UpdateAdminFeedbackResponse, UpdateAdminGameCollectionGamesRequest, UpdateAdminGameCollectionRequest, UpdateAdminUserRequest, UpdateAppRequest, UpdateAppResponse, UpdateAssetPackRequest, UpdateAssetPackResponse, UpdateAssetPackVersionRequest, UpdateAssetPackVersionResponse, UpdateAssetRequest, UpdateAssetResponse, UpdateAssetSpecVersionResponse, UpdateAssetVersionRequest, UpdateAssetVersionResponse, UpdateProfileRequest, UpdateProfileResponse, UpdateTagGroupRequest, UpdateTagRequest, UpdateUserCommunicationPreferencesRequest, UpdateVersionResponse, UploadAppSessionFileResponse, UploadAppSessionOwnedAssetResponse, UploadAssetPackSessionAssetResponse, UploadAssetPackSessionMediaResponse, UpsertWebPushSubscriptionRequest, UserDetailResponse, UsernameAvailableResponse, UsersListResponse, WebPushConfigResponse, WebPushSubscriptionStatusResponse, WorkerAgentTaskAttemptUnavailableRequest, WorkerAgentTaskAttemptUnavailableResponse, WorkerClaimAgentTaskRequest, WorkerClaimAgentTaskResponse, WorkerClaimAgentTaskSlugRequest, WorkerClaimAgentTaskSlugResponse, WorkerCompleteAgentTaskRequest, WorkerCreateAgentTaskEventRequest, WorkerCreateAgentTaskEventResponse, WorkerCreateAgentTaskTranscriptChunkRequest, WorkerCreateAgentTaskTranscriptChunkResponse, WorkerFailAgentTaskRequest, WorkerHeartbeatAgentTaskRequest, WorkerHeartbeatAgentTaskResponse, WorkerPresenceRequest, WorkerPresenceResponse, RegisterAgentBundleRequest, RegisterAgentBundleResponse, WorkerRecordAgentTaskRunTelemetryRequest, WorkerRecordAgentTaskRunTelemetryResponse, WorkerSubmitAgentTaskEvalRequest, WorkerSubmitAgentTaskEvalResponse, WorkerSubmitAgentTaskReviewRequest, WorkerSubmitAgentTaskReviewResponse, WorkerUpdateIntentRequest, WorkerUpdateIntentResponse, XPendingSignupResponse } from '@playdrop/types';
 import { type AdminAgentTaskTranscriptOptions, type ListAgentTasksOptions, type ListCreatorGamesOptions } from './domains/agent-tasks.js';
 export interface HttpMethod {
     GET: 'GET';
@@ -464,6 +464,7 @@ export interface ApiClient {
     finalizeAppUpload(creatorUsername: string, appName: string, sessionId: string): Promise<FinalizeAppUploadResponse>;
     fetchAppUploadLaunchCheckPreview(creatorUsername: string, appName: string, sessionId: string): Promise<AppUploadLaunchCheckPreviewResponse>;
     recordAppUploadLaunchCheck(creatorUsername: string, appName: string, sessionId: string, request: RecordAppUploadLaunchCheckRequest): Promise<RecordAppUploadLaunchCheckResponse>;
+    recordAppUploadCausalCheck(creatorUsername: string, appName: string, sessionId: string, request: RecordAppUploadCausalCheckRequest): Promise<RecordAppUploadCausalCheckResponse>;
     recordAppUploadMediaCapture(creatorUsername: string, appName: string, sessionId: string, request: RecordAppUploadMediaCaptureRequest): Promise<RecordAppUploadMediaCaptureResponse>;
     abortAppUpload(creatorUsername: string, appName: string, sessionId: string): Promise<AbortAppUploadResponse>;
     listAppVersions(creatorUsername: string, appName: string): Promise<AppVersionsListResponse>;