@playdrop/playdrop-cli 0.18.0 → 0.18.9

package/config/client-meta.json

@@ -1,7 +1,7 @@
 {
-  "version": "0.18.0",
+  "version": "0.18.9",
   "build": 1,
-  "runtimeSdkVersion": "0.18.0",
+  "runtimeSdkVersion": "0.18.9",
   "runtimeSdkBuild": 1,
   "clients": {
     "all": {

package/dist/apps/upload.js

@@ -180,11 +180,24 @@ function pushPreparedArtifact(task, currentTotal, file, maxBytes, code, label) {
 }
 async function uploadSignedObject(client, creatorUsername, appName, sessionId, file, descriptor) {
     for (let attempt = 0; attempt < 2; attempt += 1) {
-        const response = await fetch(descriptor.url, {
-            method: descriptor.method,
-            headers: descriptor.headers,
-            body: file.file,
-        });
+        let response;
+        try {
+            response = await fetch(descriptor.url, {
+                method: descriptor.method,
+                headers: descriptor.headers,
+                body: file.file,
+            });
+        }
+        catch (error) {
+            const cause = error instanceof Error ? error.cause : null;
+            const code = cause && typeof cause === "object" && "code" in cause &&
+                typeof cause.code === "string" && /^[A-Z][A-Z0-9_]{0,63}$/.test(cause.code)
+                ? cause.code
+                : "UNKNOWN";
+            const annotated = new Error(`direct_object_upload_network_failed:${file.relativePath}:${code}`);
+            Object.defineProperty(annotated, "cause", { value: error, configurable: true, writable: true });
+            throw annotated;
+        }
         if (response.ok) {
             return;
         }

package/dist/commands/devServer.d.ts

@@ -44,7 +44,8 @@ export declare function buildLocalDevAppUrl(input: {
 }): string;
 export declare function terminateChildProcessTree(child: ChildProcess | null, timeoutMs?: number): Promise<void>;
 export declare function ensureDevRouterRunning(port?: number): Promise<void>;
-export declare function startOwnedDevRouter(port: number): Promise<ChildProcess>;
+export declare function stopLegacyWorkerDevRouters(ports: readonly number[]): Promise<number>;
+export declare function startOwnedDevRouter(port: number, ownerPid?: number): Promise<ChildProcess>;
 export declare function resolveDevRouterWorkingDirectory(cliEntrypoint: string): string;
 export declare function updateMountedDevRuntimeAssetManifest(input: {
     creatorUsername: string;

package/dist/commands/devServer.js

@@ -8,6 +8,7 @@ exports.parseMountConflictError = parseMountConflictError;
 exports.buildLocalDevAppUrl = buildLocalDevAppUrl;
 exports.terminateChildProcessTree = terminateChildProcessTree;
 exports.ensureDevRouterRunning = ensureDevRouterRunning;
+exports.stopLegacyWorkerDevRouters = stopLegacyWorkerDevRouters;
 exports.startOwnedDevRouter = startOwnedDevRouter;
 exports.resolveDevRouterWorkingDirectory = resolveDevRouterWorkingDirectory;
 exports.updateMountedDevRuntimeAssetManifest = updateMountedDevRuntimeAssetManifest;
@@ -546,9 +547,47 @@ async function ensureDevRouterRunning(port = exports.DEV_ROUTER_PORT) {
     }
     await startOwnedDevRouter(port);
 }
+// Managed Mac workers call this with their reserved slots before advertising
+// readiness. The previous supervisor has drained, so its detached routers can
+// be retired without touching another application's listener.
+async function stopLegacyWorkerDevRouters(ports) {
+    const routers = new Set();
+    for (const port of ports) {
+        const listeners = (0, node_child_process_1.spawnSync)("/usr/sbin/lsof", ["-nP", "-a", `-iTCP:${port}`, "-sTCP:LISTEN", "-Fp"], { encoding: "utf8" });
+        if (listeners.status === 1 && !listeners.stdout.trim() && !listeners.stderr.trim())
+            continue;
+        if (listeners.error || listeners.status !== 0)
+            throw new Error(`worker_dev_router_inspection_failed:port_${port}`);
+        for (const line of listeners.stdout.trim().split("\n")) {
+            if (!line.startsWith("p"))
+                continue;
+            const pid = Number(line.slice(1));
+            const processInfo = (0, node_child_process_1.spawnSync)("/bin/ps", ["-p", String(pid), "-o", "uid=,pgid=,command="], { encoding: "utf8" });
+            const match = /^\s*(\d+)\s+(\d+)\s+(.+)$/u.exec(processInfo.stdout.trim());
+            if (!Number.isSafeInteger(pid) || pid <= 0 || pid === process.pid || !match ||
+                Number(match[1]) !== process.getuid?.() ||
+                Number(match[2]) !== pid ||
+                !/\sproject\s+_dev-router\s+serve(?:\s|$)/u.test(match[3]))
+                throw new Error(`worker_dev_router_port_occupied:port_${port}`);
+            routers.add(pid);
+        }
+    }
+    await Promise.all([...routers].map(async (pid) => {
+        signalProcess(pid, "SIGTERM", true);
+        if (!await waitForProcessGroupExit(pid, 2000)) {
+            signalProcess(pid, "SIGKILL", true);
+            if (!await waitForProcessGroupExit(pid, 2000))
+                throw new Error(`worker_dev_router_stop_failed:pid_${pid}`);
+        }
+    }));
+    return routers.size;
+}
 // Publication checks retain this handle and stop only their own router.
 // Ordinary project dev intentionally keeps its shared router running.
-async function startOwnedDevRouter(port) {
+async function startOwnedDevRouter(port, ownerPid) {
+    if (ownerPid !== undefined && (!Number.isSafeInteger(ownerPid) || ownerPid <= 0)) {
+        throw new Error("invalid_dev_router_owner_pid");
+    }
     if (await fetchRouterHealth(port))
         throw new Error(`publishing_dev_router_port_in_use:${port}`);
     const cliEntrypoint = getCliEntrypointPath();
@@ -561,6 +600,7 @@ async function startOwnedDevRouter(port) {
         env: {
             ...childEnv,
             PLAYDROP_DEV_ROUTER_PORT: String(port),
+            ...(ownerPid === undefined ? {} : { PLAYDROP_DEV_ROUTER_OWNER_PID: String(ownerPid) }),
         },
     });
     child.unref();
@@ -1189,6 +1229,13 @@ async function listenDevRouterServer(server, port = exports.DEV_ROUTER_PORT) {
 async function runDevRouterServer(port = Number(process.env.PLAYDROP_DEV_ROUTER_PORT) || exports.DEV_ROUTER_PORT) {
     const server = createDevRouterServer(port);
     await listenDevRouterServer(server, port);
+    const ownerPid = Number(process.env.PLAYDROP_DEV_ROUTER_OWNER_PID);
+    if (Number.isSafeInteger(ownerPid) && ownerPid > 0) {
+        setInterval(() => {
+            if (!isPidAlive(ownerPid))
+                process.exit(0);
+        }, 1000).unref();
+    }
     await new Promise(() => {
         // Keep the router alive until the process exits.
     });

package/dist/commands/worker/game-source-git.d.ts

@@ -66,6 +66,7 @@ export declare function setupGameSourceWorkspace(input: {
     leaseToken: string;
 }): Promise<GameSourceWorkspace>;
 export declare function fingerprintGameSourcePublication(projectDir: string, includeServerOutput?: boolean): Promise<string>;
+export declare function preflightGameSourceWorkspace(projectDir: string): Promise<void>;
 export declare function checkpointFailedGameSourceWorkspace(input: {
     workspace: GameSourceWorkspace;
     taskId: number;

package/dist/commands/worker/game-source-git.js

@@ -7,6 +7,7 @@ exports.emitGameSourceWorkerEvent = emitGameSourceWorkerEvent;
 exports.materializeCurrentLock = materializeCurrentLock;
 exports.setupGameSourceWorkspace = setupGameSourceWorkspace;
 exports.fingerprintGameSourcePublication = fingerprintGameSourcePublication;
+exports.preflightGameSourceWorkspace = preflightGameSourceWorkspace;
 exports.checkpointFailedGameSourceWorkspace = checkpointFailedGameSourceWorkspace;
 exports.reconcileGameSourceWorkspace = reconcileGameSourceWorkspace;
 exports.finalizeGameSourceRepository = finalizeGameSourceRepository;
@@ -557,6 +558,37 @@ async function stageGameSourceCommit(input) {
     }
     return { lock, materials };
 }
+// Mirror the files left by staging without changing the index, source files,
+// managed ignore block, or task refs. In particular, tracked build directories
+// skipped by walkFiles survive `git add -u` and would fail the outgoing scan.
+async function preflightGameSourceWorkspace(projectDir) {
+    const candidates = new Map();
+    const tracked = (await git.run(["ls-files", "--stage", "-z"], projectDir)).toString("utf8");
+    for (const entry of tracked.split("\0").filter(Boolean)) {
+        const tab = entry.indexOf("\t");
+        const filePath = entry.slice(tab + 1);
+        if (entry.startsWith("160000 "))
+            throw new Error(`game_source_gitlink_rejected:${filePath}`);
+        const absolute = node_path_1.default.join(projectDir, filePath);
+        if ((0, node_fs_1.existsSync)(absolute))
+            candidates.set(filePath, await (0, promises_1.readFile)(absolute));
+    }
+    for (const absolute of await walkFiles(projectDir)) {
+        const relative = normalizeRelativePath(projectDir, absolute);
+        const content = await (0, promises_1.readFile)(absolute);
+        if ((0, game_source_git_1.classifyGameSourceFile)(relative, content) === "git")
+            candidates.set(relative, content);
+        else
+            candidates.delete(relative);
+    }
+    const ignorePath = node_path_1.default.join(projectDir, ".gitignore");
+    const existingIgnore = (0, node_fs_1.existsSync)(ignorePath) ? await (0, promises_1.readFile)(ignorePath, "utf8") : "";
+    candidates.set(".gitignore", Buffer.from((0, game_source_git_1.updateManagedGitignore)(existingIgnore)));
+    // Reconciliation regenerates this file from the material inventory.
+    candidates.delete(game_source_git_1.GAME_SOURCE_LOCK_PATH);
+    for (const [filePath, content] of candidates)
+        (0, game_source_git_1.validateGameSourceGitBlob)(filePath, content);
+}
 async function checkpointFailedGameSourceWorkspace(input) {
     const branch = (await git.run(["symbolic-ref", "--short", "HEAD"], input.workspace.projectDir))
         .toString("utf8")

package/dist/commands/worker/instrument-evidence.d.ts

@@ -4,6 +4,7 @@ export declare function createWorkerInstrumentScreenshotCollector(workspaceDir:
     push: (chunk: string) => number;
     finish: () => number;
 };
+export declare function resolveInstrumentEvidenceDir(workspaceDir: string, evidenceDir: string): string;
 export declare function saveInstrumentEvidenceCapture(input: {
     workspaceDir: string;
     evidenceDir: string;

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

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.INSTRUMENT_EVIDENCE_MANIFEST_FILE = void 0;
 exports.createWorkerInstrumentScreenshotCollector = createWorkerInstrumentScreenshotCollector;
+exports.resolveInstrumentEvidenceDir = resolveInstrumentEvidenceDir;
 exports.saveInstrumentEvidenceCapture = saveInstrumentEvidenceCapture;
 exports.readAndValidateInstrumentEvidenceManifest = readAndValidateInstrumentEvidenceManifest;
 const types_1 = require("@playdrop/types");
@@ -142,9 +143,9 @@ function normalizeGroupId(value) {
     }
     return normalized;
 }
-function resolveEvidenceDir(workspaceDir, evidenceDir) {
+function resolveInstrumentEvidenceDir(workspaceDir, evidenceDir) {
     const resolvedWorkspace = node_path_1.default.resolve(workspaceDir);
-    const resolvedEvidenceDir = node_path_1.default.resolve(evidenceDir);
+    const resolvedEvidenceDir = node_path_1.default.resolve(resolvedWorkspace, evidenceDir);
     if (!isPathInside(resolvedWorkspace, resolvedEvidenceDir)) {
         throw new Error("instrument_evidence_dir_outside_workspace");
     }
@@ -169,7 +170,7 @@ async function saveInstrumentEvidenceCapture(input) {
     if (!screenshot) {
         throw new Error(`instrument_screenshot_not_found:${screenshotId}`);
     }
-    const evidenceDir = resolveEvidenceDir(input.workspaceDir, input.evidenceDir);
+    const evidenceDir = resolveInstrumentEvidenceDir(input.workspaceDir, input.evidenceDir);
     (0, node_fs_1.mkdirSync)(evidenceDir, { recursive: true });
     const existing = readManifestIfPresent(evidenceDir);
     if (existing && existing.groupId !== groupId) {
@@ -242,7 +243,7 @@ function normalizeCapture(value, name) {
     };
 }
 function readAndValidateInstrumentEvidenceManifest(input) {
-    const evidenceDir = resolveEvidenceDir(input.workspaceDir, input.evidenceDir);
+    const evidenceDir = resolveInstrumentEvidenceDir(input.workspaceDir, input.evidenceDir);
     const parsed = readManifestIfPresent(evidenceDir);
     if (!parsed || parsed.version !== 1) {
         throw new Error("missing_instrument_evidence_manifest");

package/dist/commands/worker.d.ts

@@ -418,6 +418,25 @@ export declare function buildGrokIsolationEnv(): Record<string, string>;
 export declare function resolveHostGrokAuthPath(homeDir?: string): string;
 export declare function mergeCreatorRecoveryResults(runtime: AgentRuntime, initial: LoggedProcessResult, recovery: LoggedProcessResult): LoggedProcessResult;
 export declare function mergeMissingAgentOutcomeRecoveryResults(runtime: AgentRuntime, initial: LoggedProcessResult, recovery: LoggedProcessResult): LoggedProcessResult;
+export declare function recordAgentRunTelemetry(input: {
+    client: ApiClient;
+    task: {
+        id: number;
+        attempts: number;
+    };
+    assignment: WorkerTaskAssignment;
+    workerKey: string;
+    leaseToken: string;
+    result: LoggedProcessResult;
+    status: AgentTaskStatus;
+    resolvedRuntimeModel: string;
+    reasoningEffort: string | null;
+    availableSkillPaths: readonly string[];
+    observedSkillPaths?: readonly string[];
+    startedAt: Date;
+    completedAt: Date;
+    terminalReason?: AgentTaskTerminalReason;
+}): Promise<void>;
 export declare function buildAgentFailureCode(agent: AgentRuntime, result: LoggedProcessResult, request?: {
     model: string;
     reasoningEffort?: string | null;
@@ -515,6 +534,14 @@ export declare function assertLaunchAgentPlistCompatible(input: {
     wrapperPath: string;
     canonicalPlistPath: string;
 }): void;
+export declare function writeManagedWorkerWrapper(input: {
+    env: string;
+    workerName: string;
+    workerKey: string;
+}): Promise<{
+    wrapperPath: string;
+    policyFile: string;
+}>;
 export declare function launchManagedWorker(label: string, plistPath: string, options: {
     registrationChanged: boolean;
     runCommand?: typeof runShell;

package/dist/commands/worker.js

@@ -70,6 +70,7 @@ exports.buildGrokIsolationEnv = buildGrokIsolationEnv;
 exports.resolveHostGrokAuthPath = resolveHostGrokAuthPath;
 exports.mergeCreatorRecoveryResults = mergeCreatorRecoveryResults;
 exports.mergeMissingAgentOutcomeRecoveryResults = mergeMissingAgentOutcomeRecoveryResults;
+exports.recordAgentRunTelemetry = recordAgentRunTelemetry;
 exports.buildAgentFailureCode = buildAgentFailureCode;
 exports.classifyAgentAvailabilityFailureReason = classifyAgentAvailabilityFailureReason;
 exports.describeAgentFailureForEvent = describeAgentFailureForEvent;
@@ -100,6 +101,7 @@ exports.withTaskUploadLock = withTaskUploadLock;
 exports.readActivePersonalWorkerRuntimeState = readActivePersonalWorkerRuntimeState;
 exports.parseLaunchAgentProgramArguments = parseLaunchAgentProgramArguments;
 exports.assertLaunchAgentPlistCompatible = assertLaunchAgentPlistCompatible;
+exports.writeManagedWorkerWrapper = writeManagedWorkerWrapper;
 exports.launchManagedWorker = launchManagedWorker;
 exports.showWorkerStatus = showWorkerStatus;
 exports.setupWorker = setupWorker;
@@ -145,6 +147,7 @@ const taskSelection_1 = require("../taskSelection");
 const review_1 = require("./review");
 const upload_1 = require("./upload");
 const staticHtml_1 = require("../apps/staticHtml");
+const devServer_1 = require("./devServer");
 const runtime_1 = require("./worker/runtime");
 const instrument_evidence_1 = require("./worker/instrument-evidence");
 const provider_telemetry_1 = require("./worker/provider-telemetry");
@@ -190,7 +193,7 @@ const FAIL_REPORT_RETRY_DELAY_MS = 2000;
 const CLAIM_ACK_RETRY_DELAY_MS = 500;
 const CLAIM_ACK_MAX_ATTEMPTS = 4;
 exports.WORKSPACE_ARCHIVE_DOWNLOAD_TIMEOUT_MS = 5 * 60000;
-const WORKER_WRAPPER_CONTRACT_VERSION = 5;
+const WORKER_WRAPPER_CONTRACT_VERSION = 6;
 const WORKER_SUPPORTED_KINDS = [
     "NEW_GAME",
     "STATIC_GAME",
@@ -3596,12 +3599,6 @@ function buildAgentRunResult(result) {
         tokensUsed: result.tokensUsed,
     };
 }
-function agentFailureRawError(result) {
-    return ([result.stderr, result.stdout, result.outputTail]
-        .map((value) => value.trim())
-        .filter(Boolean)
-        .join("\n") || "agent_failure");
-}
 function buildSupervisorFailureRunResult(message) {
     return {
         exitCode: null,
@@ -3692,7 +3689,11 @@ async function recordAgentRunTelemetry(input) {
         completedAt: input.completedAt.toISOString(),
         ...(input.status === "FAILED"
             ? {
-                terminalReason: input.terminalReason ?? (0, types_1.classifyAgentTaskTerminalReason)(agentFailureRawError(input.result), "agent"),
+                terminalReason: input.terminalReason ??
+                    (0, types_1.classifyAgentTaskTerminalReason)(buildAgentFailureCode(input.assignment.agent.runtime, input.result, {
+                        model: input.assignment.agent.model,
+                        reasoningEffort: input.reasoningEffort,
+                    }), "agent"),
             }
             : {}),
     });
@@ -5168,6 +5169,29 @@ if [ -n "$MINIMUM_CLI_VERSION" ]; then
   version_meets "$CURRENT_CLI_VERSION" "$MINIMUM_CLI_VERSION" || fail_converge "$?" "worker_update_cli_below_minimum"
 fi
 
+PLAYDROP_EXECUTABLE="$(command -v playdrop)" || fail_converge "$?" "worker_update_playwright_resolve_failed"
+node - "$PLAYDROP_EXECUTABLE" <<'NODE' || fail_converge "$?" "worker_update_playwright_install_failed"
+const fs = require("fs");
+const path = require("path");
+const { createRequire } = require("module");
+const { spawnSync } = require("child_process");
+const cliRequire = createRequire(fs.realpathSync(process.argv[2]));
+const playwright = cliRequire("playwright-core");
+const executablePath = playwright.chromium.executablePath();
+if (!fs.existsSync(executablePath)) {
+  const packagePath = cliRequire.resolve("playwright-core/package.json");
+  const packageJson = cliRequire(packagePath);
+  const installerPath = path.resolve(path.dirname(packagePath), packageJson.bin["playwright-core"]);
+  const result = spawnSync(process.execPath, [installerPath, "install", "chromium"], {
+    stdio: "inherit",
+    env: { ...process.env, PLAYWRIGHT_SKIP_BROWSER_GC: "1" },
+  });
+  if (result.error) throw result.error;
+  if (result.status !== 0) process.exit(result.status || 1);
+  if (!fs.existsSync(executablePath)) throw new Error("worker_update_chromium_missing_after_install");
+}
+NODE
+
 if [ "$TARGET_UPDATE_FAILED" -eq 0 ]; then
   rm -f "$FAILURE_FILE"
 fi
@@ -5626,6 +5650,11 @@ async function startWorker(options = {}) {
             const activeTerminators = new Map();
             const activeDevPorts = new Set();
             const workerDevPortBase = (0, runtime_1.readPositiveEnvInt)("PLAYDROP_WORKER_DEV_PORT_BASE", DEFAULT_WORKER_DEV_PORT_BASE);
+            if (target === "FIRST_PARTY" && node_process_1.default.platform === "darwin" && node_process_1.default.env.PLAYDROP_WORKER_WRAPPER_CONTRACT_VERSION) {
+                const stopped = await (0, devServer_1.stopLegacyWorkerDevRouters)(Array.from({ length: maxParallelTasks }, (_, index) => workerDevPortBase + index));
+                if (stopped)
+                    console.log(`Stopped ${stopped} detached dev routers before worker readiness.`);
+            }
             let sessionExpired = false;
             let shuttingDown = false;
             let quiescingForUpdate = false;
@@ -5804,6 +5833,7 @@ async function startWorker(options = {}) {
                 let agentResult = null;
                 let telemetryReported = false;
                 let gameServerDevLease = null;
+                let devRouter = null;
                 let gameSourceWorkspace = null;
                 let gameSourceCommandServer = null;
                 let gameSourcePublication = null;
@@ -6282,6 +6312,9 @@ async function startWorker(options = {}) {
                     reasoningEffort = codexModel?.reasoningEffort ?? claudeModel?.effort ?? grokModel?.reasoningEffort ?? null;
                     const cleanRoom = task.kind === "STATIC_GAME";
                     if (task.kind === "NEW_GAME" || task.kind === "REMIX_GAME" || task.kind === "GAME_UPDATE") {
+                        // This port belongs to this task until cleanup. Keeping the router
+                        // in the supervisor lifecycle prevents an old CLI surviving upgrades.
+                        devRouter = await (0, devServer_1.startOwnedDevRouter)(devPort, node_process_1.default.pid);
                         const managedRedisAdminUrl = node_process_1.default.env.PLAYDROP_WORKER_GAME_SERVER_REDIS_ADMIN_URL?.trim() ?? "";
                         const managedMongoAdminUrl = node_process_1.default.env.PLAYDROP_WORKER_GAME_SERVER_MONGO_ADMIN_URL?.trim() ?? "";
                         const redisAdminUrl = managedRedisAdminUrl || node_process_1.default.env.PLAYDROP_DEV_REDIS_URL?.trim() || "";
@@ -6842,7 +6875,7 @@ async function startWorker(options = {}) {
                         if (refreshed && refreshed.task.status !== "RUNNING" && refreshed.task.status !== "QUEUED") {
                             retainWorkspace = refreshed.task.status === "FAILED";
                             console.error(`Agent task ${task.id} was finalized by the server as ${refreshed.task.status}.`);
-                            await reportTelemetry(refreshed.task.status);
+                            await reportTelemetry(refreshed.task.status, undefined, refreshed.task.terminalReason ?? undefined);
                         }
                         else {
                             console.error(`Agent task ${task.id} was aborted by the server; cleaning up without reporting failure.`);
@@ -6876,7 +6909,7 @@ async function startWorker(options = {}) {
                         if (refreshed.task.status !== "RUNNING") {
                             retainWorkspace = refreshed.task.status === "FAILED";
                             console.error(`Agent task ${task.id} was finalized by the agent as ${refreshed.task.status}.`);
-                            await reportTelemetry(refreshed.task.status);
+                            await reportTelemetry(refreshed.task.status, undefined, refreshed.task.terminalReason ?? undefined);
                         }
                         else if (hasAgentTaskUploadedArtifact(refreshed.task)) {
                             console.error(`Agent task ${task.id} uploaded an artifact but exited before task completion; failing it explicitly.`);
@@ -6899,6 +6932,7 @@ async function startWorker(options = {}) {
                                     model: assignment.agent.model,
                                     reasoningEffort,
                                 });
+                            const terminalReason = uploadFailure?.terminalReason ?? (0, types_1.classifyAgentTaskTerminalReason)(failureCode, "agent");
                             const availabilityReason = uploadFailure
                                 ? null
                                 : classifyAgentAvailabilityFailureReason(failureCode, task.kind === "GAME_REVIEW");
@@ -6913,7 +6947,7 @@ async function startWorker(options = {}) {
                             });
                             if (availabilityReason) {
                                 retainWorkspace = false;
-                                await reportTelemetry("FAILED").catch((error) => {
+                                await reportTelemetry("FAILED", undefined, terminalReason).catch((error) => {
                                     console.error(`Agent task ${task.id} telemetry failed before provider handoff: ${error instanceof Error ? error.message : String(error)}`);
                                 });
                                 const unavailable = await client.workerRecordAgentTaskAttemptUnavailable(task.id, {
@@ -6932,12 +6966,10 @@ async function startWorker(options = {}) {
                                     workerKey,
                                     leaseToken,
                                     error: failureCode,
-                                    terminalReason: uploadFailure
-                                        ? uploadFailure.terminalReason
-                                        : (0, types_1.classifyAgentTaskTerminalReason)(failureCode, "agent"),
+                                    terminalReason,
                                     result: agentRunResult,
                                 });
-                                await reportTelemetry("FAILED");
+                                await reportTelemetry("FAILED", undefined, terminalReason);
                             }
                         }
                     }
@@ -6946,7 +6978,7 @@ async function startWorker(options = {}) {
                         if (refreshed.task.status !== "RUNNING") {
                             retainWorkspace = refreshed.task.status === "FAILED";
                             console.error(`Agent task ${task.id} was finalized by the agent as ${refreshed.task.status}.`);
-                            await reportTelemetry(refreshed.task.status);
+                            await reportTelemetry(refreshed.task.status, undefined, refreshed.task.terminalReason ?? undefined);
                         }
                         else if (taskStillMissingAgentOutcome(refreshed) &&
                             hasAgentTaskUploadedArtifact(refreshed.task)) {
@@ -7123,6 +7155,7 @@ async function startWorker(options = {}) {
                         }
                         else {
                             const uploadFailure = readRecordedTaskUploadFailure();
+                            const terminalReason = uploadFailure?.terminalReason ?? (0, types_1.classifyAgentTaskTerminalReason)("agent_exited_without_task_done", "agent");
                             await client.workerCreateAgentTaskEvent(task.id, {
                                 workerKey,
                                 leaseToken,
@@ -7135,10 +7168,10 @@ async function startWorker(options = {}) {
                                 workerKey,
                                 leaseToken,
                                 error: uploadFailure?.terminalReason.code ?? "agent_exited_without_task_done",
-                                ...(uploadFailure ? { terminalReason: uploadFailure.terminalReason } : {}),
+                                terminalReason,
                                 result: agentRunResult,
                             });
-                            await reportTelemetry("FAILED");
+                            await reportTelemetry("FAILED", undefined, terminalReason);
                         }
                     }
                 }
@@ -7211,6 +7244,8 @@ async function startWorker(options = {}) {
                         clearInterval(eventDrainTimer);
                     }
                     activeTerminators.delete(task.id);
+                    if (devRouter)
+                        await (0, devServer_1.terminateChildProcessTree)(devRouter);
                     await gameServerDevLease?.cleanup();
                     if (completedGameSourceGeneration && gameSourcePublication && gameSourceWorkspace) {
                         const publication = gameSourcePublication;
@@ -7735,6 +7770,8 @@ async function uploadTask(options = {}) {
             token: ctx.token,
             user: ctx.user,
         });
+        if (taskContext.gameSourceGit)
+            await (0, game_source_git_1.preflightGameSourceWorkspace)(projectDir);
         for (const warning of result.warnings) {
             console.error(`Preflight warning: ${warning}`);
         }
@@ -8049,7 +8086,7 @@ function readReviewEvidenceFiles(evidenceDir, workspaceDir = resolveTaskWorkspac
     if (!normalizedDir) {
         throw new Error("invalid_review_evidence_dir");
     }
-    const resolvedDir = node_path_1.default.resolve(normalizedDir);
+    const resolvedDir = (0, instrument_evidence_1.resolveInstrumentEvidenceDir)(workspaceDir, normalizedDir);
     if (!(0, node_fs_1.existsSync)(resolvedDir)) {
         throw new Error("invalid_review_evidence_dir");
     }
@@ -8086,12 +8123,12 @@ function resolveReviewFilePath(filePath, code) {
     }
     return resolved;
 }
-function resolveReviewEvidenceDir(evidenceDir) {
+function resolveReviewEvidenceDir(evidenceDir, workspaceDir) {
     const normalizedDir = typeof evidenceDir === "string" ? evidenceDir.trim() : "";
     if (!normalizedDir) {
         throw new Error("invalid_review_evidence_dir");
     }
-    const resolved = node_path_1.default.resolve(normalizedDir);
+    const resolved = (0, instrument_evidence_1.resolveInstrumentEvidenceDir)(workspaceDir, normalizedDir);
     if (!(0, node_fs_1.existsSync)(resolved)) {
         throw new Error("invalid_review_evidence_dir");
     }
@@ -8106,7 +8143,7 @@ async function submitReviewTask(options) {
     const state = (0, review_1.normalizeTerminalReviewState)(options.state);
     const reviewMessageFile = resolveReviewFilePath(options.messageFile, "invalid_review_message_file");
     const creatorFeedbackFile = resolveReviewFilePath(options.creatorFeedbackFile, "invalid_creator_feedback_file");
-    const evidenceDir = resolveReviewEvidenceDir(options.evidenceDir);
+    const evidenceDir = resolveReviewEvidenceDir(options.evidenceDir, workspaceDir);
     const reviewMessage = readRequiredTextFile(reviewMessageFile, "invalid_review_message_file");
     const creatorFeedback = readOptionalTextFile(creatorFeedbackFile);
     const platformFeedback = readPlatformFeedbackFile(options.platformFeedbackFile, workspaceDir);
@@ -8169,7 +8206,8 @@ async function submitEvalTask(options) {
     const evidenceFiles = [];
     const groupIds = new Set();
     for (const evidenceDir of evidenceDirs) {
-        const manifest = (0, instrument_evidence_1.readAndValidateInstrumentEvidenceManifest)({ workspaceDir, evidenceDir });
+        const resolvedEvidenceDir = (0, instrument_evidence_1.resolveInstrumentEvidenceDir)(workspaceDir, evidenceDir);
+        const manifest = (0, instrument_evidence_1.readAndValidateInstrumentEvidenceManifest)({ workspaceDir, evidenceDir: resolvedEvidenceDir });
         if (groupIds.has(manifest.groupId)) {
             throw new Error(`duplicate_instrument_evidence_group:${manifest.groupId}`);
         }
@@ -8180,7 +8218,7 @@ async function submitEvalTask(options) {
             if (!capture) {
                 continue;
             }
-            const filePath = node_path_1.default.join(node_path_1.default.resolve(evidenceDir), capture.fileName);
+            const filePath = node_path_1.default.join(resolvedEvidenceDir, capture.fileName);
             evidenceFiles.push({
                 groupId: manifest.groupId,
                 name: capture.fileName,
@@ -8214,14 +8252,16 @@ async function saveTaskEvidence(options) {
     if (!evidenceDir || !name || !groupId) {
         throw new Error("task_evidence_options_required");
     }
+    const workspaceDir = resolveTaskWorkspaceDir();
+    const resolvedEvidenceDir = (0, instrument_evidence_1.resolveInstrumentEvidenceDir)(workspaceDir, evidenceDir);
     const capture = await (0, instrument_evidence_1.saveInstrumentEvidenceCapture)({
-        workspaceDir: resolveTaskWorkspaceDir(),
-        evidenceDir,
+        workspaceDir,
+        evidenceDir: resolvedEvidenceDir,
         groupId,
         name,
         ...(screenshotId ? { screenshotId } : {}),
     });
-    (0, output_1.printSuccess)(`Saved ${capture.name} evidence from screenshot ${capture.screenshotId} to ${capture.fileName}.`);
+    (0, output_1.printSuccess)(`Saved ${capture.name} evidence from screenshot ${capture.screenshotId} to ${node_path_1.default.join(resolvedEvidenceDir, capture.fileName)}.`);
 }
 const INSTRUMENT_ERROR_REASONS = new Set(["auth_state", "browser_control", "renderer", "screenshot"]);
 async function instrumentErrorTask(options) {

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

@@ -0,0 +1,56 @@
+import type { AgentTaskCreatorFeedbackStatus, AppAuthMode, AppDetailRequest, AppDetailResponse, AppVersionDetailResponse, AppVersionVisibility, ContentCommentsResponse, ContentLicense, ContentRemixRelationsResponse, CreateCommentReportRequest, CreateContentCommentRequest, CreateContentCommentResponse, CreateContentReportRequest, CreateCreatorReportRequest, CreatorBlockMutationResponse, CreatorFollowMutationResponse, CreatorGameCreatorFeedbackStatusResponse, CreatorGamesListResponse, CreatorGameStatusResponse, DeleteContentCommentResponse, DislikedItemMutationResponse, GetLeaderboardResponse, LeaderboardEntry, LikedItemMutationResponse, ListAchievementsResponse, ListLeaderboardsResponse, ModerationReportResponse, SavedItemKind, SavedItemMutationResponse, SocialFriend, TrackEngagementEventRequest, TrackEngagementEventResponse, UpdateVersionResponse } from "@playdrop/types";
+export declare function fetchAppDetail(creatorUsername: string, appName: string, options?: AppDetailRequest): Promise<AppDetailResponse>;
+export declare function fetchUserByUsername(username: string): Promise<import("@playdrop/types").PublicUser>;
+export declare function fetchAssetBySlug(creatorUsername: string, assetName: string): Promise<import("@playdrop/types").AssetResponse>;
+export declare function fetchAssetRelated(creatorUsername: string, assetName: string): Promise<ContentRemixRelationsResponse>;
+export declare function getPlatformGameFriends(appId: number): Promise<SocialFriend[]>;
+export declare function listAchievements(appId: number, options?: {
+    includeHiddenDefinitions?: boolean;
+    includeRetired?: boolean;
+}): Promise<ListAchievementsResponse>;
+export declare function listLeaderboards(appId: number, options?: {
+    includeRetired?: boolean;
+}): Promise<ListLeaderboardsResponse>;
+export declare function getLeaderboard(appId: number, key: string, options?: {
+    top?: number;
+    aroundMe?: number;
+    includeRetired?: boolean;
+}): Promise<GetLeaderboardResponse>;
+export declare function getFriendLeaderboardEntries(appId: number, key: string): Promise<LeaderboardEntry[]>;
+export declare function getAppVersion(creatorUsername: string, appName: string, version: string): Promise<AppVersionDetailResponse>;
+export declare function updateAppVersion(creatorUsername: string, appName: string, version: string, updates: {
+    releaseNotes?: string | null;
+    visibility?: AppVersionVisibility;
+    authMode?: AppAuthMode;
+    license?: ContentLicense;
+    setAsCurrent?: boolean;
+}): Promise<UpdateVersionResponse>;
+export declare function getCreatorGameStatus(gameRef: string): Promise<CreatorGameStatusResponse>;
+export declare function listCreatorGames(options?: {
+    limit?: number;
+    offset?: number;
+    signal?: AbortSignal;
+}): Promise<CreatorGamesListResponse>;
+export declare function updateCreatorGameFeedbackStatus(gameRef: string, appVersionId: number, creatorFeedbackStatus: AgentTaskCreatorFeedbackStatus, comment?: string): Promise<CreatorGameCreatorFeedbackStatusResponse>;
+export declare function trackEngagementEvent(payload: TrackEngagementEventRequest): Promise<TrackEngagementEventResponse>;
+export declare function saveItem(kind: SavedItemKind, creatorUsername: string, itemName: string): Promise<SavedItemMutationResponse>;
+export declare function unsaveItem(kind: SavedItemKind, creatorUsername: string, itemName: string): Promise<SavedItemMutationResponse>;
+export declare function likeItem(kind: SavedItemKind, creatorUsername: string, itemName: string): Promise<LikedItemMutationResponse>;
+export declare function unlikeItem(kind: SavedItemKind, creatorUsername: string, itemName: string): Promise<LikedItemMutationResponse>;
+export declare function dislikeItem(kind: SavedItemKind, creatorUsername: string, itemName: string): Promise<DislikedItemMutationResponse>;
+export declare function undislikeItem(kind: SavedItemKind, creatorUsername: string, itemName: string): Promise<DislikedItemMutationResponse>;
+export declare function reportContent(kind: SavedItemKind, creatorUsername: string, itemName: string, report: CreateContentReportRequest): Promise<ModerationReportResponse>;
+export declare function reportCreator(creatorUsername: string, report: CreateCreatorReportRequest): Promise<ModerationReportResponse>;
+export declare function followCreator(creatorUsername: string): Promise<CreatorFollowMutationResponse>;
+export declare function unfollowCreator(creatorUsername: string): Promise<CreatorFollowMutationResponse>;
+export declare function blockCreator(creatorUsername: string): Promise<CreatorBlockMutationResponse>;
+export declare function unblockCreator(creatorUsername: string): Promise<CreatorBlockMutationResponse>;
+export declare function fetchContentComments(kind: SavedItemKind, creatorUsername: string, itemName: string): Promise<ContentCommentsResponse>;
+export declare function createContentComment(kind: SavedItemKind, creatorUsername: string, itemName: string, body: CreateContentCommentRequest): Promise<CreateContentCommentResponse>;
+export declare function likeContentComment(commentId: number): Promise<LikedItemMutationResponse>;
+export declare function unlikeContentComment(commentId: number): Promise<LikedItemMutationResponse>;
+export declare function dislikeContentComment(commentId: number): Promise<DislikedItemMutationResponse>;
+export declare function undislikeContentComment(commentId: number): Promise<DislikedItemMutationResponse>;
+export declare function reportComment(commentId: number, report: CreateCommentReportRequest): Promise<ModerationReportResponse>;
+export declare function deleteContentComment(commentId: number): Promise<DeleteContentCommentResponse>;
+//# sourceMappingURL=acquisition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acquisition.d.ts","sourceRoot":"","sources":["../src/acquisition.ts"],"names":[],"mappings":"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"}