@playdrop/playdrop-cli 0.12.42 → 0.13.1

package/dist/commands/worker.d.ts

@@ -4,8 +4,14 @@ import { loadConfig } from '../config';
 import { runShell } from '../shellProbe';
 import { type WorkerPlaydropAssetRequirement } from './upload';
 import { type WorkerInstrumentSurface, type LoggedProcessResult, type LoggedProcessTranscriptChunk } from './worker/runtime';
-export { assertWorkerTokenUsageWithinCap, buildClaudeExecArgs, buildClaudePermissionSettings, buildCodexExecArgs, buildPlaywrightMcpCommand, buildWorkerChildEnv, DEFAULT_CODEX_TIMEOUT_MS, DEFAULT_WORKER_TOKEN_CAP, extractAgentTokenUsage, extractCodexRolloutTokenUsage, extractCodexThreadId, extractCodexTokensUsed, readCodexRolloutTokenUsageForThread, readCodexSandboxMode, readEnvBoolean, runLoggedProcess } 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';
+export declare function usesCreatorRecovery(kind: AgentTaskKind): boolean;
+export declare function buildCreatorRecoveryPrompt(input: {
+    prompt: string;
+    kind: AgentTaskKind;
+}): 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 validation/build/dev/check/capture, read-only help/catalogue/documentation lookup, and PlayDrop AI generation are permitted.";
 type WorkerStartOptions = {
@@ -76,6 +82,7 @@ type TaskCatalogueReportOptions = {
 type TaskCompleteOptions = {
     env?: string;
     nextSteps?: string;
+    platformFeedbackFile?: string;
     summary?: string;
 };
 type TaskClaimSlugOptions = {
@@ -89,6 +96,7 @@ type TaskUploadOptions = {
 type TaskFailOptions = {
     env?: string;
     message?: string;
+    platformFeedbackFile?: string;
 };
 type TaskEvidenceOptions = {
     evidenceDir?: string;
@@ -105,6 +113,7 @@ type TaskSubmitReviewOptions = {
     state?: string;
     messageFile?: string;
     creatorFeedbackFile?: string;
+    platformFeedbackFile?: string;
     evidenceDir?: string;
     nextSteps?: string;
 };
@@ -166,6 +175,12 @@ export declare function claimBackoffDelayMs(currentMs: number, random?: () => nu
 export declare function resolveWorkerHomeDir(): string;
 export declare const WORKER_TASK_WORKSPACE_RETENTION = 20;
 export declare function pruneWorkerTaskWorkspaces(incomingWorkspaceDir: string, retention?: number): Promise<string[]>;
+export declare function prepareClaimedTaskWorkspace(input: {
+    workspaceDir: string;
+    attempt: number;
+}): Promise<{
+    resumed: boolean;
+}>;
 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: {
@@ -193,11 +208,17 @@ export declare function assertTaskUploadResultMatchesContext(input: {
 }): void;
 export declare function stageAssignmentWorkspaceV2(workspaceDir: string, workspace: WorkerTaskAssignmentV2['workspace']): Promise<void>;
 export declare function assertAssignmentPluginBundleExtractionBounds(buffer: Buffer): void;
+export declare function stageDevPluginWorkingTree(input: {
+    workingTree: string;
+    workspaceDir: string;
+    taskKind?: AgentTaskKind;
+}): Promise<string>;
 export declare function stageAssignmentPluginBundle(input: {
     workspaceDir: string;
+    extractionDir?: string;
     pluginBundle: WorkerTaskPluginV2;
     taskKind?: AgentTaskKind;
-}): Promise<string>;
+}): Promise<string | null>;
 export declare function resolveDevPluginWorkingTree(input: {
     workingTree?: string;
     env: string;
@@ -251,6 +272,8 @@ export declare function prepareCodexRunHomes(input: {
     envName: string;
     sourceCodexHome?: string;
     playdropConfig?: ReturnType<typeof loadConfig>;
+    stagePlaydropSession?: boolean;
+    preserveExisting?: boolean;
 }): Promise<{
     homeDir: string;
     codexHomeDir: string;
@@ -265,6 +288,7 @@ export declare function prepareClaudeRunConfig(input: {
 }>;
 export declare function removeAgentRunCredentials(workspaceDir: string): Promise<void>;
 export declare function removeStaleAgentRunCredentials(workerHomeDir?: string): Promise<void>;
+export declare function mergeCreatorRecoveryResults(runtime: AgentRuntime, initial: LoggedProcessResult, recovery: LoggedProcessResult): LoggedProcessResult;
 export declare function buildAgentFailureCode(agent: AgentRuntime, result: LoggedProcessResult, request?: {
     model: string;
     reasoningEffort?: string | null;
@@ -280,6 +304,7 @@ 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 probeWorkerProviderIndependently<T>(probe: () => T, unavailable: T): T;
+export declare function describeWorkerPreflightReason(reason: string): string;
 export declare function buildWorkerSetupActions(input: {
     degradedReasons: string[];
     playwright?: {
@@ -368,6 +393,7 @@ export declare function enforceInstrumentBrowserHygiene(assignment: WorkerTaskAs
     remainingTaskTabs: number;
     blankWindows: number;
 }>;
+export declare function assignmentRequiresRegisteredBundle(assignment: WorkerTaskAssignmentV2): boolean;
 export declare function startWorker(options?: WorkerStartOptions): Promise<void>;
 export declare function reportTask(options: TaskReportOptions): Promise<void>;
 export declare function showTaskContext(): void;