@playdrop/playdrop-cli 0.12.32 → 0.12.33

package/node_modules/@playdrop/types/dist/agent-task-terminal.js

@@ -0,0 +1,117 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var agent_task_terminal_exports = {};
+__export(agent_task_terminal_exports, {
+  cancelledTerminalReason: () => cancelledTerminalReason,
+  classifyAgentTaskTerminalReason: () => classifyAgentTaskTerminalReason,
+  queueExpiredTerminalReason: () => queueExpiredTerminalReason
+});
+module.exports = __toCommonJS(agent_task_terminal_exports);
+function classifyAgentTaskTerminalReason(rawError, source) {
+  const raw = rawError.trim() || "agent_failure";
+  const lower = raw.toLowerCase();
+  const candidates = [
+    matchFailure(lower, /(upload_validation(?::[a-z0-9_.-]+)?|upload[^\n.!?]{0,80}validat|validat(?:e|ion)[^\n.!?]{0,80}upload|invalid[^\n.!?]{0,80}archive|invalid[^\n.!?]{0,80}catalogue)/, {
+      category: "upload_validation",
+      retryable: false,
+      source,
+      message: "The uploaded result did not pass validation."
+    }),
+    matchFailure(lower, /(instrument_error(?::[a-z0-9_.-]+)?|browser_control|renderer|screenshot|playwright|chrome instrument|waitforselector|(?:native )?listing recorder)/, {
+      category: "instrument_error",
+      retryable: true,
+      source: "instrument",
+      message: "The required browser or capture instrument failed."
+    }),
+    matchFailure(lower, /(capacity|overloaded|rate.?limit|too many requests|quota|(?:^|\D)429(?:\D|$))/, {
+      category: "provider_capacity",
+      retryable: true,
+      source: "provider",
+      message: "The agent provider had no available capacity."
+    }),
+    matchFailure(lower, /(econnreset|econnrefused|connection|network|socket|disconnected|dns|fetch failed)/, {
+      category: "provider_connection",
+      retryable: true,
+      source: "provider",
+      message: "The connection to the agent provider was lost."
+    }),
+    matchFailure(lower, /(timed? ?out|timeout|deadline exceeded)/, {
+      category: "provider_timeout",
+      retryable: true,
+      source: "provider",
+      message: "The agent provider did not finish before the timeout."
+    })
+  ].filter((candidate) => candidate !== null).sort((a, b) => a.index - b.index);
+  const firstSpecificFailure = candidates[0];
+  if (firstSpecificFailure) {
+    return terminal(firstSpecificFailure.category, raw, firstSpecificFailure.retryable, firstSpecificFailure.source, firstSpecificFailure.message, firstSpecificFailure.code);
+  }
+  const interrupted = /(worker_shutdown|worker_session_expired|agent_task_stale_running_reaped|lease_expired|signal_|sigterm|sigkill|interrupted)/.test(lower);
+  return terminal("agent_failure", raw, interrupted, source, interrupted ? "The agent process was interrupted." : "The agent failed to complete the task.", interrupted ? "interrupted_worker_process" : "agent_failure");
+}
+function matchFailure(raw, pattern, failure) {
+  const match = pattern.exec(raw);
+  if (!match) {
+    return null;
+  }
+  const specificCode = /^(?:instrument_error|upload_validation):[a-z0-9_.-]+$/.test(match[0]) ? match[0] : failure.category;
+  return {
+    ...failure,
+    index: match.index,
+    code: specificCode
+  };
+}
+function queueExpiredTerminalReason(rawError) {
+  return {
+    kind: "expiration",
+    category: "queue_expired",
+    code: rawError.trim() || "queue_expired",
+    message: "The task expired before a compatible worker could start it.",
+    retryable: true,
+    rawError: rawError.trim() || null,
+    source: "server"
+  };
+}
+function cancelledTerminalReason(code = "cancelled") {
+  return {
+    kind: "cancellation",
+    category: "cancelled",
+    code,
+    message: "The task was cancelled.",
+    retryable: false,
+    rawError: null,
+    source: "server"
+  };
+}
+function terminal(category, rawError, retryable, source, message, code = category) {
+  return {
+    kind: "failure",
+    category,
+    code,
+    message,
+    retryable,
+    rawError,
+    source
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cancelledTerminalReason,
+  classifyAgentTaskTerminalReason,
+  queueExpiredTerminalReason
+});

package/node_modules/@playdrop/types/dist/api.d.ts

@@ -130,8 +130,11 @@ export interface ContentTagSummary {
     slug: string;
     displayName: string;
 }
-export declare const AGENT_TASK_STATUS_VALUES: readonly ["QUEUED", "RUNNING", "DONE", "FAILED", "CANCELLED"];
+export declare const AGENT_TASK_STATUS_VALUES: readonly ["QUEUED", "RUNNING", "DONE", "FAILED", "EXPIRED", "CANCELLED"];
 export type AgentTaskStatus = typeof AGENT_TASK_STATUS_VALUES[number];
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
 export declare const AGENT_TASK_CREATOR_FEEDBACK_STATUS_VALUES: readonly ["UNSEEN", "VIEWED", "PLAYED", "APPROVED", "DISAPPROVED"];
 export type AgentTaskCreatorFeedbackStatus = typeof AGENT_TASK_CREATOR_FEEDBACK_STATUS_VALUES[number];
 export declare const AGENT_TASK_KIND_VALUES: readonly ["NEW_GAME", "REMIX_GAME", "GAME_UPDATE", "GAME_REVIEW", "GAME_EVAL"];
@@ -272,6 +275,18 @@ export interface AgentTaskAgentModelSelection {
 export interface AgentTaskAgentModelOption extends AgentTaskAgentModelSelection {
     label: string;
     onlineWorkers: number;
+    totalSlots: number;
+    runningTasks: number;
+    availableSlots: number;
+}
+export interface AgentTaskTerminalReason {
+    kind: 'failure' | 'expiration' | 'cancellation';
+    category: 'provider_capacity' | 'provider_connection' | 'provider_timeout' | 'instrument_error' | 'upload_validation' | 'agent_failure' | 'queue_expired' | 'cancelled';
+    code: string;
+    message: string;
+    retryable: boolean;
+    rawError: string | null;
+    source: 'server' | 'worker' | 'agent' | 'provider' | 'instrument';
 }
 export interface AgentTaskRefundResponse {
     state: 'refunded' | 'withheld';
@@ -298,7 +313,7 @@ export interface AgentTaskNextStepSuggestion {
 }
 export interface AgentTaskResponse {
     id: number;
-    pluginBundleSha?: string | null;
+    agentBundleSha?: string | null;
     workerCliVersion: string | null;
     platformReleaseSha: string | null;
     kind: AgentTaskKind;
@@ -338,6 +353,7 @@ export interface AgentTaskResponse {
     nextSteps: AgentTaskNextStepSuggestion[];
     creatorFeedbackStatus: AgentTaskCreatorFeedbackStatus;
     error: string | null;
+    terminalReason: AgentTaskTerminalReason | null;
     workerId?: number | null;
     workerName?: string | null;
     lastHeartbeatAt: string | null;
@@ -385,7 +401,7 @@ export interface AgentTaskAttachmentInput {
 export interface AgentTaskAttachmentUploadResponse {
     attachment: AgentTaskAttachmentInput;
 }
-export type AgentTaskInputKind = 'prompt' | 'MEDIA' | 'GAME_PLAN' | 'REFERENCE_GAME' | 'REFERENCE_ASSET' | 'REFERENCE_PACK';
+export type AgentTaskInputKind = 'MEDIA' | 'GAME_PLAN' | 'REFERENCE_GAME' | 'REFERENCE_ASSET' | 'REFERENCE_PACK';
 export type GamePlanQuestionId = 'graphics' | 'surface_targets' | 'genre' | 'theme' | 'controls' | 'player_goal' | 'challenge' | 'first_version_scope' | 'notes';
 export type GamePlanQuestionKind = 'SINGLE_CHOICE' | 'MULTI_CHOICE' | 'TEXT';
 export interface GamePlanSelectedOption {
@@ -405,10 +421,6 @@ export interface AgentTaskInputBase {
     kind: AgentTaskInputKind;
     note?: string | null;
 }
-export interface AgentTaskPromptInput extends AgentTaskInputBase {
-    kind: 'prompt';
-    text?: string | null;
-}
 export interface AgentTaskMediaInput extends AgentTaskInputBase {
     kind: 'MEDIA';
     media: AgentTaskAttachmentInput;
@@ -429,7 +441,7 @@ export interface AgentTaskReferenceInput extends AgentTaskInputBase {
         displayName?: string | null;
     };
 }
-export type AgentTaskInput = AgentTaskPromptInput | AgentTaskMediaInput | AgentTaskGamePlanInput | AgentTaskReferenceInput;
+export type AgentTaskInput = AgentTaskMediaInput | AgentTaskGamePlanInput | AgentTaskReferenceInput;
 export interface CreateNewGameAgentTaskRequest {
     target: AgentExecutionTarget;
     agent?: AgentRuntime;
@@ -438,8 +450,7 @@ export interface CreateNewGameAgentTaskRequest {
     prompt: string;
     surfaceContext?: AgentTaskSurfaceContextRequest;
     inputs?: AgentTaskInput[];
-    pluginBundleBase64?: string;
-    pluginBundleFileName?: string;
+    agentBundleSha?: string;
 }
 export interface CreateNewGameAgentTaskResponse {
     task: AgentTaskResponse;
@@ -454,8 +465,7 @@ export interface CreateRemixGameAgentTaskRequest {
     sourceAppVersionRef: string;
     surfaceContext?: AgentTaskSurfaceContextRequest;
     inputs?: AgentTaskInput[];
-    pluginBundleBase64?: string;
-    pluginBundleFileName?: string;
+    agentBundleSha?: string;
 }
 export interface CreateRemixGameAgentTaskResponse {
     task: AgentTaskResponse;
@@ -474,8 +484,7 @@ export interface CreateGameEvalAgentTaskRequest {
     judgePromptVersion: string;
     tieBand?: number | null;
     targets: GameEvalTargetInput[];
-    pluginBundleBase64?: string;
-    pluginBundleFileName?: string;
+    agentBundleSha?: string;
 }
 export interface CreateGameEvalAgentTaskResponse {
     task: AgentTaskResponse;
@@ -533,115 +542,98 @@ export interface WorkerPresenceResponse {
     action?: 'continue' | 'quiesce_for_update';
     updatePolicy?: AgentWorkerUpdatePolicyResponse | null;
 }
-export interface WorkerClaimAgentTaskRequest {
+export interface WorkerClaimTaskRequestV2 {
+    protocolVersion: 2;
     workerKey: string;
     capabilities: AgentWorkerCapabilities;
 }
-export interface WorkerAgentTaskBaseSourceResponse {
-    creatorUsername: string;
-    appName: string;
-    version: string;
-    appId: number;
-    appVersionId: number;
-}
-export interface WorkerAgentTaskRemixSourceResponse extends WorkerAgentTaskBaseSourceResponse {
-    ref: string;
-    appDisplayName?: string | null;
-}
-export interface WorkerAgentTaskReviewTargetResponse {
-    creatorUsername: string;
-    appName: string;
-    appDisplayName: string | null;
-    version: string;
-    appId: number;
-    appVersionId: number;
-    reviewState: ReviewState;
-    surfaceTargets: AppSurface[];
-    launchUrl: string;
-}
-export interface WorkerAgentTaskEvalTargetResponse {
-    targetId: string;
-    creatorUsername: string;
-    appName: string;
-    appDisplayName: string | null;
-    version: string;
-    appId: number;
-    appVersionId: number;
-    appVersionRef: string;
-    creatorPrompt: string | null;
-    surfaceTargets: AppSurface[];
-    heroImageUrl: string | null;
-    iconImageUrl: string | null;
-    launchUrl: string;
-}
-export interface WorkerAgentTaskEvalResponse {
-    mode: GameEvalMode;
-    judgePromptVersion: string;
-    tieBand: number | null;
-    targets: WorkerAgentTaskEvalTargetResponse[];
-}
-export interface WorkerAgentTaskPluginBundleResponse {
+export interface WorkerTaskPluginV2 {
     sha256: string;
     fileName: string;
     sizeBytes: number;
     contentBase64: string;
 }
-export interface WorkerAgentTaskWorkspaceFileResponse {
-    relativePath: string;
+export interface WorkerTaskWorkspaceArchiveV2 {
+    path: string;
+    format: 'zip';
+    sha256: string;
+    sizeBytes: number;
+    contentBase64: string;
+}
+export interface WorkerTaskWorkspaceFileV2 {
+    path: string;
+    sha256: string;
+    sizeBytes: number;
+    contentType: string;
     contentBase64: string;
-    contentType?: string;
 }
-export interface WorkerAgentTaskAttachmentResponse {
+export interface WorkerTaskAttachmentV2 {
     id: string;
+    path: string;
     fileName: string;
     contentType: string;
     sizeBytes: number;
-    relativePath: string;
+    sha256: string;
     description?: string | null;
 }
-export interface WorkerAgentTaskAssignmentResponse {
-    taskId: number;
-    taskToken: string;
-    kind: AgentTaskKind;
-    target: AgentExecutionTarget;
-    agent: AgentRuntime;
-    model: string;
-    reasoningEffort?: string | null;
-    attemptPlan?: AgentAttemptPlan | null;
-    selectedAttempt?: AgentAttemptOption | null;
+export interface WorkerTaskAssignmentV2 {
+    task: {
+        id: number;
+        token: string;
+        type: string;
+        executionTarget: AgentExecutionTarget;
+        attempt: number;
+        metadata: Record<string, JsonValue>;
+    };
     workspace: {
         folderName: string;
-        files: WorkerAgentTaskWorkspaceFileResponse[];
+        archives: WorkerTaskWorkspaceArchiveV2[];
+        files: WorkerTaskWorkspaceFileV2[];
     };
-    inputs: {
-        request: {
-            prompt: string;
-            surfaceContext?: AgentTaskSurfaceContext;
-        };
-        taskInputs?: AgentTaskInput[];
-        attachments: WorkerAgentTaskAttachmentResponse[];
-        baseSource: WorkerAgentTaskBaseSourceResponse | null;
-        remixSource?: WorkerAgentTaskRemixSourceResponse | null;
-        reviewTarget?: WorkerAgentTaskReviewTargetResponse | null;
-        evalTarget?: WorkerAgentTaskEvalResponse | null;
-        allowedTemplateKeys?: string[];
+    plugin: WorkerTaskPluginV2 | null;
+    request: {
+        prompt: string;
+        attachments: WorkerTaskAttachmentV2[];
     };
-    pluginBundle: WorkerAgentTaskPluginBundleResponse;
-    output: {
-        appId: number | null;
-        appName: string | null;
-        version: string;
-        releaseNoteRequired: boolean;
+    agent: {
+        runtime: AgentRuntime;
+        model: string;
+        reasoningEffort: string | null;
+        browser: 'NONE' | 'CHROME' | 'PLAYWRIGHT';
     };
-    prompt: string;
 }
-export interface WorkerClaimAgentTaskResponse {
-    task: AgentTaskResponse | null;
-    action?: 'continue' | 'quiesce_for_update';
-    updatePolicy?: AgentWorkerUpdatePolicyResponse | null;
-    taskAssignment?: WorkerAgentTaskAssignmentResponse;
-    leaseToken?: string;
-    leaseExpiresAt?: string;
+export type WorkerClaimTaskResponseV2 = {
+    protocolVersion: 2;
+    action: 'idle' | 'quiesce_for_update';
+    assignment: null;
+    lease: null;
+    updatePolicy: AgentWorkerUpdatePolicyResponse | null;
+} | {
+    protocolVersion: 2;
+    action: 'run';
+    assignment: WorkerTaskAssignmentV2;
+    lease: {
+        token: string;
+        expiresAt: string;
+    };
+    updatePolicy: AgentWorkerUpdatePolicyResponse | null;
+};
+export type WorkerClaimAgentTaskRequest = WorkerClaimTaskRequestV2;
+export type WorkerClaimAgentTaskResponse = WorkerClaimTaskResponseV2;
+export interface RegisterAgentBundleRequest {
+    sha256: string;
+    fileName: string;
+    contentBase64: string;
+}
+export interface RegisterAgentBundleResponse {
+    created: boolean;
+    bundle: {
+        sha256: string;
+        fileName: string;
+        sizeBytes: number;
+        registrationSource: 'EVAL';
+        createdAt: string;
+    };
 }
 export interface WorkerClaimAgentTaskSlugRequest {
     appName: string;
@@ -750,6 +742,7 @@ export interface AgentTaskRunResponse {
     tokenUsage: AgentTaskRunTokenUsageResponse;
     availableSkillPaths: string[];
     observedSkillPaths: string[];
+    terminalReason: AgentTaskTerminalReason | null;
     startedAt: string | null;
     completedAt: string | null;
     createdAt: string;
@@ -793,6 +786,7 @@ export interface WorkerRecordAgentTaskRunTelemetryRequest {
     observedSkillPaths?: string[];
     startedAt?: string | null;
     completedAt?: string | null;
+    terminalReason?: AgentTaskTerminalReason | null;
 }
 export interface WorkerRecordAgentTaskRunTelemetryResponse {
     run: AgentTaskRunResponse;
@@ -873,6 +867,7 @@ export interface WorkerFailAgentTaskRequest {
     workerKey?: string;
     leaseToken?: string;
     error: string;
+    terminalReason: AgentTaskTerminalReason;
     result?: Record<string, unknown>;
 }
 export interface AdminAgentTasksResponse {
@@ -954,8 +949,7 @@ export interface CreateAppAgentTaskRequest {
     prompt: string;
     surfaceContext?: AgentTaskSurfaceContextRequest;
     inputs?: AgentTaskInput[];
-    pluginBundleBase64?: string;
-    pluginBundleFileName?: string;
+    agentBundleSha?: string;
 }
 export interface CreateAppAgentTaskResponse {
     task: AgentTaskResponse;