@playdrop/playdrop-cli 0.16.5 → 0.16.12

package/dist/commands/worker.d.ts

@@ -1,10 +1,13 @@
-import type { ApiClient } from '@playdrop/api-client';
-import { RELEASE_SMOKE_FILE_NAME, type AgentAvailabilityFailureReason, type AgentExecutionTarget, type AgentRuntime, type AgentTaskKind, type AgentTaskNextStepSuggestion, type AgentTaskResponse, type AppSurface, type AgentWorkerCapabilities, type AgentWorkerResponse, type AgentWorkerUpdatePolicyResponse, type JsonValue, type WorkerTaskAssignmentV2, type WorkerTaskPluginV2, type WorkerClaimAgentTaskResponse } from '@playdrop/types';
-import { loadConfig } from '../config';
-import { runShell } from '../shellProbe';
-import { type WorkerInstrumentSurface, type LoggedProcessResult, type LoggedProcessTranscriptChunk } from './worker/runtime';
-export { assertWorkerTokenUsageWithinCap, buildClaudeExecArgs, buildClaudePermissionSettings, buildCleanRoomChildEnv, buildCodexExecArgs, buildPlaywrightMcpCommand, buildWorkerChildEnv, DEFAULT_CODEX_TIMEOUT_MS, DEFAULT_CREATOR_AGENT_TIMEOUT_MS, DEFAULT_CREATOR_UPLOAD_RECOVERY_TIMEOUT_MS, DEFAULT_WORKER_TOKEN_CAP, extractAgentTokenUsage, extractCodexRolloutTokenUsage, extractClaudeSessionId, extractCodexThreadId, extractCodexTokensUsed, readCodexRolloutTokenUsageForThread, readCodexSandboxMode, readEnvBoolean, runLoggedProcess } from './worker/runtime';
-export type { AgentTokenUsage, LoggedProcessResult, LoggedProcessTranscriptChunk } from './worker/runtime';
+import type { ApiClient } from "@playdrop/api-client";
+import { RELEASE_SMOKE_FILE_NAME, type AgentAvailabilityFailureReason, type AgentExecutionTarget, type AgentRuntime, type AgentTaskKind, type AgentTaskNextStepSuggestion, type AgentTaskResponse, type AppSurface, type AgentWorkerCapabilities, type AgentWorkerResponse, type AgentWorkerUpdatePolicyResponse, type JsonValue, type WorkerTaskAssignmentV2, type WorkerTaskAssignmentV3, type WorkerTaskPluginV2, type WorkerClaimAgentTaskResponse, type WorkerClaimTaskResponseV3 } from "@playdrop/types";
+import { loadConfig } from "../config";
+import { runShell } from "../shellProbe";
+import { type WorkerInstrumentSurface, type LoggedProcessResult, type LoggedProcessTranscriptChunk } from "./worker/runtime";
+export { extractZipArchive } from "./worker/archive-staging";
+export { assertWorkerTokenUsageWithinCap, buildClaudeExecArgs, buildClaudePermissionSettings, buildCleanRoomChildEnv, buildCodexExecArgs, buildGrokExecArgs, buildPlaywrightMcpCommand, buildWorkerChildEnv, DEFAULT_CODEX_TIMEOUT_MS, DEFAULT_CREATOR_AGENT_TIMEOUT_MS, DEFAULT_CREATOR_UPLOAD_RECOVERY_TIMEOUT_MS, DEFAULT_WORKER_TOKEN_CAP, extractAgentTokenUsage, extractCodexRolloutTokenUsage, extractClaudeSessionId, extractCodexThreadId, extractGrokRunMetadata, extractCodexTokensUsed, readCodexRolloutTokenUsageForThread, readCodexSandboxMode, readEnvBoolean, runLoggedProcess, } from "./worker/runtime";
+export type { AgentTokenUsage, LoggedProcessResult, LoggedProcessTranscriptChunk } from "./worker/runtime";
+export declare const WORKSPACE_ARCHIVE_DOWNLOAD_TIMEOUT_MS: number;
+type WorkerTaskAssignment = WorkerTaskAssignmentV2 | WorkerTaskAssignmentV3;
 export declare function usesCreatorRecovery(kind: AgentTaskKind): boolean;
 export declare function buildDeterministicReleaseSmokeArtifact(): {
     fileName: typeof RELEASE_SMOKE_FILE_NAME;
@@ -17,7 +20,7 @@ export declare function buildCreatorRecoveryPrompt(input: {
 }): string;
 export declare function buildGameEvalRetryPrompt(prompt: string): string;
 export declare const WORKER_SESSION_EXPIRED_MESSAGE = "worker session expired: run \"playdrop auth login\" and start the worker again";
-export declare const WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE = "worker_context_command_not_allowed: inside a PlayDrop worker task only task progress, task claim-slug, task upload/done/fail, assigned app scaffolding, project build/dev/check/capture, read-only help/catalogue/documentation lookup, and PlayDrop AI generation are permitted.";
+export declare const WORKER_CONTEXT_COMMAND_NOT_ALLOWED_MESSAGE = "worker_context_command_not_allowed: inside a PlayDrop worker task only task progress, task asset-runtime, task claim-slug, task upload/done/fail, assigned app scaffolding, project build/dev/check/capture, read-only help/catalogue/documentation lookup, and PlayDrop AI generation are permitted.";
 export declare const WORKER_CONTEXT_PROJECT_VALIDATE_NOT_ALLOWED_MESSAGE = "worker_context_project_validate_not_allowed: \"playdrop project validate\" is not available inside a PlayDrop worker task. Run \"playdrop task upload --preflight-only\" as the sole pre-upload validation gate.";
 type WorkerStartOptions = {
     env?: string;
@@ -48,7 +51,7 @@ type WorkerLocalStatus = {
         chromiumInstalled?: boolean;
         executablePath?: string;
     } | null;
-    agents: AgentWorkerCapabilities['agents'];
+    agents: AgentWorkerCapabilities["agents"];
     capabilities: AgentWorkerCapabilities | null;
     setupActions: WorkerSetupAction[];
 };
@@ -168,7 +171,7 @@ type WorkerTaskContextFile = {
     env: string;
 };
 type WorkerQueuedEvent = {
-    kind: 'progress' | 'catalogue_preview';
+    kind: "progress" | "catalogue_preview";
     phase: string | null;
     message?: string | null;
     done?: string | null;
@@ -185,6 +188,10 @@ type WorkerClaudeModel = {
     model: string;
     effort: string | null;
 };
+type WorkerGrokModel = {
+    model: string;
+    reasoningEffort: string;
+};
 export declare function allocateWorkerDevPort(input: {
     activePorts: ReadonlySet<number>;
     basePort?: number;
@@ -194,8 +201,26 @@ export declare function isWorkerContextCommandAllowed(argv: string[]): boolean;
 export declare function resolveWorkerContextCommandBlockMessage(argv: string[]): string | null;
 export declare function resolveWorkerExecutionTargetFromRole(role: unknown): AgentExecutionTarget;
 export declare function normalizeWorkerTaskAssignmentV2(claim: WorkerClaimAgentTaskResponse): WorkerTaskAssignmentV2 | null;
+export declare function normalizeWorkerTaskAssignmentV3(claim: unknown): WorkerTaskAssignmentV3 | null;
+export declare function normalizeWorkerClaimResponseV3(value: unknown): WorkerClaimTaskResponseV3;
 export declare function nextClaimBackoffMs(currentMs: number): number;
 export declare function claimBackoffDelayMs(currentMs: number, random?: () => number): number;
+export declare function acknowledgeWorkerTaskClaim(input: {
+    client: Pick<ApiClient, "workerAcknowledgeAgentTaskClaim">;
+    taskId: number;
+    workerKey: string;
+    leaseToken: string;
+    sleepImpl?: (ms: number) => Promise<void>;
+    maxAttempts?: number;
+}): Promise<{
+    token: string;
+    expiresAt: string;
+}>;
+export declare function containWorkerTaskRun(input: {
+    taskId: number;
+    run: Promise<void>;
+    logError?: (message: string) => void;
+}): Promise<void>;
 export declare function resolveWorkerHomeDir(): string;
 export declare const WORKER_TASK_WORKSPACE_RETENTION = 20;
 export declare function pruneWorkerTaskWorkspaces(incomingWorkspaceDir: string, retention?: number): Promise<string[]>;
@@ -205,11 +230,11 @@ export declare function prepareClaimedTaskWorkspace(input: {
 }): Promise<{
     resumed: boolean;
 }>;
-export declare function buildWorkerTaskContextV2(assignment: WorkerTaskAssignmentV2): Omit<WorkerTaskContextFile, 'env' | 'devPort'>;
-export declare function resolveWorkerInstrumentSurface(taskContext: Pick<WorkerTaskContextFile, 'kind' | 'metadata'>): WorkerInstrumentSurface | null;
-export declare function hasAgentTaskUploadedArtifact(task: Pick<AgentTaskResponse, 'appId' | 'appVersionId'>): boolean;
+export declare function buildWorkerTaskContextV2(assignment: WorkerTaskAssignment): Omit<WorkerTaskContextFile, "env" | "devPort">;
+export declare function resolveWorkerInstrumentSurface(taskContext: Pick<WorkerTaskContextFile, "kind" | "metadata">): WorkerInstrumentSurface | null;
+export declare function hasAgentTaskUploadedArtifact(task: Pick<AgentTaskResponse, "appId" | "appVersionId">): boolean;
 export declare function appendWorkerTranscriptChunks(input: {
-    client: Pick<ApiClient, 'workerAppendAgentTaskTranscriptChunks'>;
+    client: Pick<ApiClient, "workerAppendAgentTaskTranscriptChunks">;
     taskId: number;
     workerKey: string;
     leaseToken: string;
@@ -231,7 +256,10 @@ export declare function assertTaskUploadResultMatchesContext(input: {
         creatorUsername: string;
     };
 }): void;
-export declare function stageAssignmentWorkspaceV2(workspaceDir: string, workspace: WorkerTaskAssignmentV2['workspace']): Promise<void>;
+export declare function stageAssignmentWorkspaceV2(workspaceDir: string, workspace: WorkerTaskAssignmentV2["workspace"]): Promise<void>;
+export declare function stageAssignmentWorkspaceV3(workspaceDir: string, workspace: WorkerTaskAssignmentV3["workspace"], options?: {
+    timeoutMs?: number;
+}): Promise<void>;
 export declare function assertAssignmentPluginBundleExtractionBounds(buffer: Buffer): void;
 export declare function stageDevPluginWorkingTree(input: {
     workingTree: string;
@@ -252,9 +280,9 @@ export declare function resolveDevPluginWorkingTree(input: {
 export declare function discoverWorkerProjectRoot(workspaceDir: string): string;
 export declare function readWorkerTaskState(): WorkerTaskState | null;
 export declare function isWorkerAuthFailureError(error: unknown): boolean;
-export declare function classifyWorkerEventDrainError(error: unknown): 'session_expired' | 'lease_invalid' | null;
+export declare function classifyWorkerEventDrainError(error: unknown): "session_expired" | "lease_invalid" | null;
 export declare function isWorkerTransientNetworkError(error: unknown): boolean;
-export declare function classifyWorkerHeartbeatError(error: unknown): 'session_expired' | 'lease_invalid' | 'transient_network' | null;
+export declare function classifyWorkerHeartbeatError(error: unknown): "session_expired" | "lease_invalid" | "transient_network" | null;
 export declare function assertWorkerClaimErrorRetryable(error: unknown): void;
 export declare function resolvePlaywrightBrowsersPathFromExecutable(executablePath: string): string;
 export declare function loadWorkerEnvFile(envName: string | undefined, cwd?: string): string | null;
@@ -265,6 +293,9 @@ export declare function buildWorkerCapabilities(input: {
     claudeVersion?: string | null;
     claudeAuthenticated?: boolean | null;
     claudeModels?: string[] | null;
+    grokVersion?: string | null;
+    grokAuthenticated?: boolean | null;
+    grokModels?: string[] | null;
     cursorVersion?: string | null;
     cursorAuthenticated?: boolean | null;
     npmVersion?: string | null;
@@ -280,15 +311,15 @@ export declare function buildWorkerClaimBody(input: {
     capabilities: AgentWorkerCapabilities;
     runningTaskCount?: number;
 }): {
-    protocolVersion: 2;
+    protocolVersion: 3;
     workerKey: string;
     capabilities: AgentWorkerCapabilities;
 };
-export declare function extractZipArchive(zipBuffer: Uint8Array, targetDir: string): string[];
 export declare function buildCataloguePreviewPayload(cataloguePath: string, workspaceDir?: string): Record<string, unknown>;
 export declare function removeStaleWorkerControlFiles(stagingDir: string): Promise<void>;
 export declare function resolveCodexModel(model: string, reasoningEffortOverride?: string | null): WorkerCodexModel;
 export declare function resolveClaudeModel(model: string, reasoningEffortOverride?: string | null): WorkerClaudeModel;
+export declare function resolveGrokModel(model: string, reasoningEffortOverride?: string | null): WorkerGrokModel;
 export declare function prepareCodexRunHomes(input: {
     workspaceDir: string;
     workerUsername: string;
@@ -309,8 +340,36 @@ export declare function prepareClaudeRunConfig(input: {
 }): Promise<{
     playdropConfigPath: string;
 }>;
+export declare function prepareGrokRunConfig(input: {
+    workspaceDir: string;
+    workerUsername: string;
+    envName: string;
+    playdropConfig?: ReturnType<typeof loadConfig>;
+    preserveExisting?: boolean;
+    stagePlaydropSession?: boolean;
+}): Promise<{
+    homeDir: string;
+    grokHomeDir: string;
+    playdropConfigPath: string | null;
+}>;
 export declare function removeAgentRunCredentials(workspaceDir: string): Promise<void>;
 export declare function removeStaleAgentRunCredentials(workerHomeDir?: string): Promise<void>;
+export declare function buildGrokHomeConfig(input: {
+    enablePlaydropPlugin: boolean;
+    playwrightServer?: {
+        command: string;
+        args: string[];
+    } | null;
+}): string;
+export declare function buildGrokPromptJson(input: {
+    prompt: string;
+    images: Array<{
+        contentType: string;
+        dataBase64: string;
+    }>;
+}): string;
+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 buildAgentFailureCode(agent: AgentRuntime, result: LoggedProcessResult, request?: {
     model: string;
@@ -327,6 +386,7 @@ export declare function createLocalPlaydropShim(input: {
 export declare function parseCodexModelCatalog(output: string): string[];
 export declare function parseClaudeModelCatalog(output: string): string[];
 export declare function claudeModelProbeReportsSelection(output: string, expectedDisplayName: string): boolean;
+export declare function parseGrokModelCatalog(output: string): string[];
 export declare function probeWorkerProviderIndependently<T>(probe: () => T, unavailable: T): T;
 export declare function describeWorkerPreflightReason(reason: string): string;
 export declare function buildWorkerSetupActions(input: {
@@ -347,7 +407,7 @@ type WorkerRuntimeState = {
     target: AgentExecutionTarget;
     startedAt: string;
 };
-export type WorkerSupervisorType = 'app' | 'launchagent' | 'terminal';
+export type WorkerSupervisorType = "app" | "launchagent" | "terminal";
 export type WorkerSupervisorLockOwner = {
     schemaVersion: 1;
     supervisorType: WorkerSupervisorType;
@@ -374,7 +434,7 @@ export declare function acquireWorkerSupervisorLock(input: {
 export declare function releaseWorkerSupervisorLock(lock: WorkerSupervisorLock): void;
 export type TaskUploadLockOwner = {
     schemaVersion: 1;
-    command: 'task upload';
+    command: "task upload";
     pid: number;
     processStartIdentity: string;
     createdAt: string;
@@ -405,10 +465,11 @@ export declare function launchManagedWorker(label: string, plistPath: string, op
 }): void;
 export declare function showWorkerStatus(options?: WorkerStatusOptions): Promise<WorkerStatusPayload>;
 export declare function setupWorker(options?: WorkerSetupOptions): Promise<void>;
-export declare function assignmentRequiresRegisteredBundle(assignment: WorkerTaskAssignmentV2): boolean;
+export declare function assignmentRequiresRegisteredBundle(assignment: WorkerTaskAssignment): boolean;
 export declare function startWorker(options?: WorkerStartOptions): Promise<void>;
 export declare function reportTask(options: TaskReportOptions): Promise<void>;
 export declare function showTaskContext(): void;
+export declare function prepareAssetRuntimeTask(): Promise<void>;
 export declare function assertTaskAssetMaterialIsTransparentPng(filePath: string): Promise<void>;
 export declare function materialTask(options: TaskMaterialOptions): Promise<void>;
 export declare function reportCatalogueTask(options: TaskCatalogueReportOptions): Promise<void>;