@playdrop/playdrop-cli 0.9.6 → 0.10.1

package/dist/commands/worker.d.ts

@@ -0,0 +1,158 @@
+import type { ApiClient } from '@playdrop/api-client';
+import { type AgentExecutionTarget, type AgentRuntime, type AgentTaskKind, type AgentTaskResponse, type AgentWorkerCapabilities, type WorkerAgentTaskAssignmentResponse, type WorkerAgentTaskBaseSourceResponse, type WorkerAgentTaskWorkspaceFileResponse, type WorkerClaimAgentTaskResponse } from '@playdrop/types';
+import { type WorkerPlaydropAssetRequirement } from './upload';
+import { type LoggedProcessResult, type LoggedProcessTranscriptChunk } from './worker/runtime';
+export { DEFAULT_CODEX_TIMEOUT_MS, DEFAULT_WORKER_TOKEN_CAP, assertWorkerTokenUsageWithinCap, buildCodexExecArgs, buildClaudeExecArgs, buildClaudePermissionSettings, buildWorkerChildEnv, extractAgentTokenUsage, extractCodexTokensUsed, readEnvBoolean, readCodexSandboxMode, runLoggedProcess, } from './worker/runtime';
+export type { AgentTokenUsage, LoggedProcessResult, LoggedProcessTranscriptChunk, } from './worker/runtime';
+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 upload/done/fail, project validation/build/dev/capture, read-only catalogue/documentation lookup, and PlayDrop AI generation are permitted.";
+type WorkerStartOptions = {
+    env?: string;
+    once?: boolean;
+    name?: string;
+};
+type TaskReportOptions = {
+    env?: string;
+    phase?: string;
+    pct?: string | number;
+    message?: string;
+    kind?: string;
+};
+type TaskCatalogueReportOptions = {
+    env?: string;
+    file?: string;
+    message?: string;
+};
+type TaskCompleteOptions = {
+    env?: string;
+};
+type TaskUploadOptions = {
+    env?: string;
+};
+type TaskFailOptions = {
+    env?: string;
+    message?: string;
+};
+type TaskSubmitReviewOptions = {
+    env?: string;
+    state?: string;
+    messageFile?: string;
+    creatorFeedbackFile?: string;
+    evidenceDir?: string;
+};
+export type WorkerHealthAlertInput = {
+    state: 'started' | 'stopped' | 'crashed';
+    env: string;
+    workerName: string;
+    taskId?: number | null;
+    detail?: string | null;
+};
+type WorkerTaskState = {
+    taskId: number;
+    env: string;
+    target: AgentExecutionTarget;
+    leaseExpiresAt: string | null;
+    claimedAt: string;
+};
+export declare function allocateWorkerDevPort(input: {
+    activePorts: ReadonlySet<number>;
+    basePort?: number;
+    maxParallelTasks?: number;
+}): number;
+export declare function isWorkerContextCommandAllowed(argv: string[]): boolean;
+export declare function resolveWorkerExecutionTargetFromRole(role: unknown): AgentExecutionTarget;
+export declare function resolveWorkerClaimTaskAssignment(claim: WorkerClaimAgentTaskResponse): WorkerAgentTaskAssignmentResponse | null;
+export declare function nextClaimBackoffMs(currentMs: number): number;
+export declare function claimBackoffDelayMs(currentMs: number, random?: () => number): number;
+export declare function resolveWorkerHomeDir(): string;
+export declare function hasAgentTaskUploadedArtifact(task: Pick<AgentTaskResponse, 'appId' | 'appVersionId'>): boolean;
+export declare function appendWorkerTranscriptChunks(input: {
+    client: Pick<ApiClient, 'workerAppendAgentTaskTranscriptChunks'>;
+    taskId: number;
+    workerKey: string;
+    leaseToken: string;
+    chunks: LoggedProcessTranscriptChunk[];
+    batchSize?: number;
+}): Promise<void>;
+export declare function assertTaskUploadResultMatchesContext(input: {
+    taskContext: {
+        taskId: number;
+        creatorUsername: string;
+        outputAppName?: string | null;
+        outputVersion: string;
+    };
+    uploadResult: {
+        taskId: number;
+        appName: string;
+        version: string;
+        creatorUsername: string;
+    };
+}): void;
+export declare function stageAssignmentWorkspaceFiles(workspaceDir: string, files: readonly WorkerAgentTaskWorkspaceFileResponse[]): Promise<void>;
+export declare function resolvePlaydropPluginRoot(input?: {
+    homeDir?: string;
+    env?: NodeJS.ProcessEnv;
+}): string;
+export declare function stagePlaydropPluginReferences(input: {
+    workspaceDir: string;
+    pluginRoot: string;
+    kind: AgentTaskKind;
+}): Promise<string[]>;
+export declare function discoverWorkerProjectRoot(workspaceDir: string): string;
+export declare function readWorkerTaskState(): WorkerTaskState | null;
+export declare function buildWorkerHealthAlertText(input: WorkerHealthAlertInput): string;
+export declare function isWorkerAuthFailureError(error: unknown): boolean;
+export declare function classifyWorkerEventDrainError(error: unknown): 'session_expired' | 'lease_invalid' | null;
+export declare function assertWorkerClaimErrorRetryable(error: unknown): void;
+export declare function resolvePlaydropAssetRequirementFromText(value: unknown): WorkerPlaydropAssetRequirement | null;
+export declare function loadWorkerEnvFile(envName: string | undefined, cwd?: string): string | null;
+export declare function buildWorkerCapabilities(input: string | {
+    codexVersion?: string | null;
+    codexAuthenticated?: boolean | null;
+    claudeVersion?: string | null;
+    claudeAuthenticated?: boolean | null;
+    npmVersion?: string | null;
+    playwright?: {
+        version?: string;
+        chromiumInstalled?: boolean;
+    } | null;
+    maxParallelTasks?: number | null;
+    runningTaskCount?: number | null;
+}): AgentWorkerCapabilities;
+export declare function buildWorkerClaimBody(input: {
+    workerKey: string;
+    capabilities: AgentWorkerCapabilities;
+    runningTaskCount?: number;
+}): {
+    workerKey: string;
+    capabilities: AgentWorkerCapabilities;
+};
+export type WorkerBaseApp = {
+    appName: string;
+    version: string;
+    appId: number;
+    appVersionId: number;
+};
+export declare function resolveWorkerBaseSource(value: WorkerAgentTaskBaseSourceResponse | null | undefined): WorkerBaseApp;
+export declare function extractZipArchive(zipBuffer: Uint8Array, targetDir: string): string[];
+export declare function readWorkerProjectVersion(projectDir: string, appName: string): string;
+export declare function buildCataloguePreviewPayload(cataloguePath: string, workspaceDir?: string): Record<string, unknown>;
+export declare function assertWorkerProjectVersionBumped(input: {
+    baseVersion: string;
+    projectVersion: string;
+    appName: string;
+}): void;
+export declare function buildAgentFailureCode(agent: AgentRuntime, result: LoggedProcessResult): string;
+export declare function describeAgentFailureForEvent(errorCode: string): string;
+export declare function startWorker(options?: WorkerStartOptions): Promise<void>;
+export declare function reportTask(options: TaskReportOptions): Promise<void>;
+export declare function reportCatalogueTask(options: TaskCatalogueReportOptions): Promise<void>;
+export declare function uploadTask(options?: TaskUploadOptions): Promise<void>;
+export declare function completeTask(options: TaskCompleteOptions): Promise<void>;
+export declare function readReviewEvidenceFiles(evidenceDir: string | undefined): Array<{
+    name: string;
+    contentType: string;
+    contentBase64: string;
+}>;
+export declare function submitReviewTask(options: TaskSubmitReviewOptions): Promise<void>;
+export declare function failTask(options: TaskFailOptions): Promise<void>;