@devicecloud.dev/dcd 5.8.0-beta.1 → 5.8.0-beta.3

package/dist/commands/cloud.d.ts

@@ -129,6 +129,11 @@ export declare const cloudCommand: import("citty").CommandDef<{
         readonly alias: ["maestroVersion"];
         readonly description: "Maestro version to run your flow against. Use \"latest\" for the most recent version. See https://docs.devicecloud.dev/configuration/maestro-versions for supported versions.";
     };
+    readonly priority: {
+        readonly type: "string";
+        readonly default: "normal";
+        readonly description: "Run priority within your organization (options: low, normal, high). Reorders only your own queued runs across your concurrency pool, for every flow in this upload; it never moves them ahead of other customers. Runs queued longer than 6 hours are promoted first, so low runs are never starved. Retries keep the same priority.";
+    };
     readonly retry: {
         readonly type: "string";
         readonly description: "Automatically retry the run up to the number of times specified (same as pressing retry in the UI) - this is free of charge";

package/dist/commands/cloud.js

@@ -3,10 +3,11 @@ import { defineCommand } from 'citty';
 import { existsSync } from 'node:fs';
 import * as path from 'node:path';
 import { flags as allFlags } from '../constants.js';
-import { ApiError, ApiGateway } from '../gateways/api-gateway.js';
+import { ApiGateway } from '../gateways/api-gateway.js';
 import { uploadBinary, uploadFlowZip, verifyAppZip, writeJSONFile, } from '../methods.js';
 import { DeviceValidationService } from '../services/device-validation.service.js';
 import { plan } from '../services/execution-plan.service.js';
+import { isSubmitEndpointMissing, submitWithRetry, } from '../services/flow-submit.service.js';
 import { buildTestMetadataMap, computeCommonRoot, } from '../services/flow-paths.js';
 import { MoropoService } from '../services/moropo.service.js';
 import { ReportDownloadService } from '../services/report-download.service.js';
@@ -15,7 +16,7 @@ import { telemetry } from '../services/telemetry.service.js';
 import { TestSubmissionService } from '../services/test-submission.service.js';
 import { VersionService } from '../services/version.service.js';
 import { isIosMatrixConfig } from '../types/domain/device.types.js';
-import { resolveAuth } from '../utils/auth.js';
+import { refreshAuth, resolveAuth } from '../utils/auth.js';
 import { assertMatrixSupported, matrixIsIos, parseDeviceMatrix, } from '../utils/device-matrix.js';
 import { checkKekForEncryption, resolveEncryption } from '../utils/envelope.js';
 import { detectCiContext, isCI } from '../utils/ci.js';
@@ -42,6 +43,7 @@ const DOWNLOAD_OPTIONS = ['ALL', 'FAILED'];
 const REPORT_OPTIONS = ['allure', 'html', 'html-detailed', 'junit'];
 const ORIENTATION_OPTIONS = ['0', '90'];
 const RUNNER_TYPE_OPTIONS = ['default', 'm4', 'm1', 'gpu1', 'cpu1'];
+const PRIORITY_OPTIONS = ['low', 'normal', 'high'];
 const RENDER_ENGINE_OPTIONS = ['lavapipe', 'swiftshader'];
 /**
  * Primary CLI command for executing tests on DeviceCloud.
@@ -162,6 +164,7 @@ export const cloudCommand = defineCommand({
             const moropoApiKey = args['moropo-v1-api-key'];
             const name = args.name;
             const orientation = validateEnum(args.orientation, ORIENTATION_OPTIONS, 'orientation');
+            const priority = validateEnum(args.priority, PRIORITY_OPTIONS, 'priority') ?? 'normal';
             let quiet = Boolean(args.quiet);
             const report = validateEnum(args.report, REPORT_OPTIONS, 'report');
             let retry = parseIntFlag(args.retry, 'retry');
@@ -600,6 +603,7 @@ export const cloudCommand = defineCommand({
                 metadata: mergedMetadata,
                 name,
                 orientation,
+                priority,
                 raw: [],
                 report,
                 retry,
@@ -653,31 +657,46 @@ export const cloudCommand = defineCommand({
             // 404s (route undefined), some proxies 405 (path/method not allowed); in
             // either case fall back to the legacy multipart POST /uploads/flow, which
             // is byte-identical bar the storage reference.
-            let response;
-            try {
-                const storageRef = await uploadFlowZip({ apiUrl, auth, buffer, debug });
+            const submitMultipart = (status) => {
+                if (debug) {
+                    out(`[DEBUG] Client-direct flow upload unavailable (HTTP ${status}); falling back to multipart ${apiUrl}/uploads/flow`);
+                }
+                const testFormData = testSubmissionService.buildFormData(fields, buffer);
+                return ApiGateway.uploadFlow(apiUrl, auth, testFormData);
+            };
+            const submitFlows = async () => {
+                let storageRef;
+                try {
+                    storageRef = await uploadFlowZip({ apiUrl, auth, buffer, debug });
+                }
+                catch (error) {
+                    if (!isSubmitEndpointMissing(error))
+                        throw error;
+                    return submitMultipart(error.status);
+                }
                 if (debug) {
                     out(`[DEBUG] Flow zip uploaded (id=${storageRef.id}, supabase=${storageRef.supabaseSuccess}, backblaze=${storageRef.backblazeSuccess})`);
                     out(`[DEBUG] Submitting flow test to ${apiUrl}/uploads/submitFlowTest`);
                 }
-                response = await ApiGateway.submitFlowTest(apiUrl, auth, {
-                    ...fields,
-                    ...storageRef,
+                // The same body on every attempt: its upload id is what lets the API
+                // answer a repeat with the run it already created (dcd#1617 follow-up).
+                const submitBody = { ...fields, ...storageRef };
+                // The retries can outlast a `dcd login` access token, so each attempt
+                // re-checks it, as the poll loop does.
+                let submitAuth = auth;
+                const submitted = await submitWithRetry({
+                    fallback: (error) => submitMultipart(error.status),
+                    // Recorded before each attempt, so `command failed` carries it too.
+                    onAttempt: (attempt) => telemetry.recordSubmitAttempts(attempt),
+                    onRetry: ({ attempt, attempts, delayMs, reason }) => warnOut(`Could not confirm the test submission (${reason}); sending it again in ${delayMs / 1000}s (attempt ${attempt}/${attempts}). It will not run twice.`),
+                    async submit() {
+                        submitAuth = await refreshAuth(submitAuth);
+                        return ApiGateway.submitFlowTest(apiUrl, submitAuth, submitBody);
+                    },
                 });
-            }
-            catch (error) {
-                if (error instanceof ApiError &&
-                    (error.status === 404 || error.status === 405)) {
-                    if (debug) {
-                        out(`[DEBUG] Client-direct flow upload unavailable (HTTP ${error.status}); falling back to multipart ${apiUrl}/uploads/flow`);
-                    }
-                    const testFormData = testSubmissionService.buildFormData(fields, buffer);
-                    response = await ApiGateway.uploadFlow(apiUrl, auth, testFormData);
-                }
-                else {
-                    throw error;
-                }
-            }
+                return submitted.response;
+            };
+            const response = await submitFlows();
             const { message, results } = response;
             if (debug) {
                 out(`[DEBUG] Flow submission response received`);

package/dist/config/flags/execution.flags.d.ts

@@ -33,6 +33,11 @@ export declare const executionFlags: {
         readonly alias: ["maestroVersion"];
         readonly description: "Maestro version to run your flow against. Use \"latest\" for the most recent version. See https://docs.devicecloud.dev/configuration/maestro-versions for supported versions.";
     };
+    readonly priority: {
+        readonly type: "string";
+        readonly default: "normal";
+        readonly description: "Run priority within your organization (options: low, normal, high). Reorders only your own queued runs across your concurrency pool, for every flow in this upload; it never moves them ahead of other customers. Runs queued longer than 6 hours are promoted first, so low runs are never starved. Retries keep the same priority.";
+    };
     readonly retry: {
         readonly type: "string";
         readonly description: "Automatically retry the run up to the number of times specified (same as pressing retry in the UI) - this is free of charge";

package/dist/config/flags/execution.flags.js

@@ -33,6 +33,11 @@ export const executionFlags = {
         alias: ['maestroVersion'],
         description: 'Maestro version to run your flow against. Use "latest" for the most recent version. See https://docs.devicecloud.dev/configuration/maestro-versions for supported versions.',
     },
+    priority: {
+        type: 'string',
+        default: 'normal',
+        description: 'Run priority within your organization (options: low, normal, high). Reorders only your own queued runs across your concurrency pool, for every flow in this upload; it never moves them ahead of other customers. Runs queued longer than 6 hours are promoted first, so low runs are never starved. Retries keep the same priority.',
+    },
     retry: {
         type: 'string',
         description: 'Automatically retry the run up to the number of times specified (same as pressing retry in the UI) - this is free of charge',

package/dist/constants.d.ts

@@ -115,6 +115,11 @@ export declare const flags: {
         readonly alias: ["maestroVersion"];
         readonly description: "Maestro version to run your flow against. Use \"latest\" for the most recent version. See https://docs.devicecloud.dev/configuration/maestro-versions for supported versions.";
     };
+    readonly priority: {
+        readonly type: "string";
+        readonly default: "normal";
+        readonly description: "Run priority within your organization (options: low, normal, high). Reorders only your own queued runs across your concurrency pool, for every flow in this upload; it never moves them ahead of other customers. Runs queued longer than 6 hours are promoted first, so low runs are never starved. Retries keep the same priority.";
+    };
     readonly retry: {
         readonly type: "string";
         readonly description: "Automatically retry the run up to the number of times specified (same as pressing retry in the UI) - this is free of charge";

package/dist/gateways/api-gateway.d.ts

@@ -189,6 +189,15 @@ export declare const ApiGateway: {
         message?: string;
         results?: components["schemas"]["IDBResult"][];
     }>;
+    /**
+     * How long one submit attempt may take (dcd#1617 follow-up). A submit
+     * normally answers in a second or two; one held by a Supabase stall is
+     * abandoned and re-sent by `submitWithRetry`, which is safe because the API
+     * answers a repeat with the run it already created. Well under the 300s at
+     * which Railway's edge would cut it with a 502. Settable so tests can
+     * shorten it.
+     */
+    submitAttemptTimeoutMs: number;
     /**
      * Dry-run cost + cell-count estimate for a (possibly device-matrix)
      * submission. Runs the same resolve → validate → fan-out → price core as the

package/dist/gateways/api-gateway.js

@@ -51,8 +51,13 @@ export const ApiGateway = {
         message += `  • Verify API URL is correct: ${origin}\n`;
         message += `  • Check for proxy/VPN interference\n`;
         message += `  • Try again in a few moments if server is temporarily down\n\n`;
-        message += `Original error: ${error.message}`;
-        const enhancedError = new Error(message);
+        // undici puts the real reason on `cause` (UND_ERR_HEADERS_TIMEOUT,
+        // ECONNRESET, ENOTFOUND, …); without it a timeout, a reset and a DNS
+        // failure all read as the same "fetch failed".
+        const cause = error.cause;
+        const code = cause?.code;
+        message += `Original error: ${error.message}${typeof code === 'string' ? ` (${code})` : ''}`;
+        const enhancedError = new Error(message, { cause: cause ?? error });
         enhancedError.name = 'NetworkError';
         enhancedError.stack = error.stack;
         return enhancedError;
@@ -545,6 +550,7 @@ export const ApiGateway = {
                     ...auth.headers,
                 },
                 method: 'POST',
+                signal: AbortSignal.timeout(this.submitAttemptTimeoutMs),
             });
             if (!res.ok) {
                 await this.handleApiError(res, 'Failed to submit test flows');
@@ -556,9 +562,23 @@ export const ApiGateway = {
             if (error instanceof TypeError && error.message === 'fetch failed') {
                 throw this.enhanceFetchError(error, `${baseUrl}/uploads/submitFlowTest`);
             }
+            if (error instanceof Error && error.name === 'TimeoutError') {
+                const timeout = new Error(`Failed to submit test flows: no response from the API within ${this.submitAttemptTimeoutMs / 1000}s`, { cause: error });
+                timeout.name = 'SubmitTimeoutError';
+                throw timeout;
+            }
             throw error;
         }
     },
+    /**
+     * How long one submit attempt may take (dcd#1617 follow-up). A submit
+     * normally answers in a second or two; one held by a Supabase stall is
+     * abandoned and re-sent by `submitWithRetry`, which is safe because the API
+     * answers a repeat with the run it already created. Well under the 300s at
+     * which Railway's edge would cut it with a 502. Settable so tests can
+     * shorten it.
+     */
+    submitAttemptTimeoutMs: 90_000,
     /**
      * Dry-run cost + cell-count estimate for a (possibly device-matrix)
      * submission. Runs the same resolve → validate → fan-out → price core as the

package/dist/mcp/tools/run-cloud-test.js

@@ -1,7 +1,8 @@
 import * as path from 'node:path';
 import { z } from 'zod';
-import { ApiError, ApiGateway } from '../../gateways/api-gateway.js';
+import { ApiGateway } from '../../gateways/api-gateway.js';
 import { plan } from '../../services/execution-plan.service.js';
+import { isSubmitEndpointMissing, submitWithRetry, } from '../../services/flow-submit.service.js';
 import { computeCommonRoot, buildTestMetadataMap } from '../../services/flow-paths.js';
 import { DeviceValidationService } from '../../services/device-validation.service.js';
 import { platformFromAppFile } from '../../services/notices.service.js';
@@ -70,6 +71,10 @@ export function registerRunCloudTest(server) {
                 .enum(['default', 'm4', 'm1', 'gpu1', 'cpu1'])
                 .optional()
                 .describe('Runner type (default "default"). gpu1 is deprecated and will be removed on 9 November 2026; prefer cpu1.'),
+            priority: z
+                .enum(['low', 'normal', 'high'])
+                .optional()
+                .describe('Run priority within the organization (default "normal"). Reorders only the queued runs of this organization, for every flow in this upload; it never moves them ahead of other customers. Runs queued over 6 hours are promoted first, so low runs are never starved.'),
             configFile: z.string().optional().describe('Path to a workspace config.yaml'),
             ignoreShaCheck: z
                 .boolean()
@@ -208,6 +213,7 @@ export function registerRunCloudTest(server) {
             iOSDevice: args.iosDevice,
             iOSVersion: args.iosVersion,
             name: args.name,
+            priority: args.priority,
             runnerType: args.runnerType ?? 'default',
             maestroVersion: resolvedMaestroVersion,
             retry: args.retry,
@@ -219,24 +225,38 @@ export function registerRunCloudTest(server) {
         // referencing it. Older API deployments lack these endpoints (404/405);
         // fall back to the legacy multipart POST /uploads/flow. Mirrors
         // `dcd cloud`.
-        let response;
-        try {
-            const storageRef = await uploadFlowZip({ apiUrl, auth, buffer });
-            response = await ApiGateway.submitFlowTest(apiUrl, auth, {
-                ...fields,
-                ...storageRef,
-            });
-        }
-        catch (error) {
-            if (error instanceof ApiError &&
-                (error.status === 404 || error.status === 405)) {
-                const testFormData = testSubmissionService.buildFormData(fields, buffer);
-                response = await ApiGateway.uploadFlow(apiUrl, auth, testFormData);
+        const submitMultipart = () => ApiGateway.uploadFlow(apiUrl, auth, testSubmissionService.buildFormData(fields, buffer));
+        const submitFlows = async () => {
+            let storageRef;
+            try {
+                storageRef = await uploadFlowZip({ apiUrl, auth, buffer });
             }
-            else {
-                throw error;
+            catch (error) {
+                if (!isSubmitEndpointMissing(error))
+                    throw error;
+                return submitMultipart();
             }
-        }
+            // Re-sent while its outcome is unknown, always with the same body;
+            // see submitWithRetry (dcd#1617 follow-up).
+            const submitBody = { ...fields, ...storageRef };
+            // The retries can outlast a `dcd login` access token, so each
+            // attempt re-checks it, as the wait loop below does.
+            let submitAuth = auth;
+            const submitted = await submitWithRetry({
+                fallback: submitMultipart,
+                // Recorded before each attempt, so a failed tool call carries it.
+                onAttempt: (attempt) => {
+                    telemetryExtra.submitAttempts = attempt;
+                },
+                onRetry: ({ attempt, attempts, delayMs, reason }) => logStderr(`Could not confirm the test submission (${reason}); sending it again in ${delayMs / 1000}s (attempt ${attempt}/${attempts}). It will not run twice.`),
+                async submit() {
+                    submitAuth = await refreshAuth(submitAuth);
+                    return ApiGateway.submitFlowTest(apiUrl, submitAuth, submitBody);
+                },
+            });
+            return submitted.response;
+        };
+        const response = await submitFlows();
         const { message, results } = response;
         if (!results?.length) {
             throw new Error(`No tests were created: ${message}`);

package/dist/services/device-validation.service.js

@@ -47,6 +47,20 @@ export class DeviceValidationService {
             ? compatibilityData.androidPlay
             : compatibilityData.android;
         const argNames = options.argNames ?? CLI_ARG_NAMES;
+        // With Google Play the API does not give an omitted half the global
+        // default (no longer a Play cell): it picks one that makes the pair a Play
+        // cell, and only rejects when none exists (resolveAndroidTarget in
+        // compatibility.service.ts). Fill it the same way so a pair the API will
+        // run is not refused here.
+        let device = androidDevice;
+        let apiLevel = androidApiLevel;
+        if (googlePlay && device && !apiLevel) {
+            apiLevel = versionsFor(lookup, device)[0];
+        }
+        else if (googlePlay && apiLevel && !device) {
+            const level = apiLevel;
+            device = offeredDevices(lookup).find((d) => versionsFor(lookup, d).includes(level));
+        }
         this.validateDevice({
             debugLines: (deviceID, version, supportedVersions) => [
                 `[DEBUG] Android device: ${deviceID}`,
@@ -55,11 +69,11 @@ export class DeviceValidationService {
                 `[DEBUG] Supported Android versions: ${supportedVersions.join(', ')}`,
             ],
             // Mirrors the API, which applies these same global defaults to a
-            // request that omits either half (test-request-validator.service.ts)
+            // request that omits either half (execution-planner.service.ts)
             // and then rejects an incompatible pair.
             defaultDevice: 'pixel-7',
-            defaultVersion: '34',
-            device: androidDevice,
+            defaultVersion: '36',
+            device,
             deviceArg: argNames.androidDevice,
             deviceKind: googlePlay ? 'Google Play' : 'Android',
             formatVersion: (version) => `API level ${version}`,
@@ -72,7 +86,7 @@ export class DeviceValidationService {
                 ? `Android device "${deviceID}" is not available with Google Play. Google Play devices: ${offeredDevices(lookup).join(', ')}. See ${DEVICES_DOCS_URL}`
                 : undefined,
             unsupportedVersionMessage: (deviceID, supportedVersions) => `${deviceID} ${googlePlay ? '(Play Store) ' : ''}only supports these Android API levels: ${supportedVersions.join(', ')}`,
-            version: androidApiLevel,
+            version: apiLevel,
             versionArg: argNames.androidApiLevel,
             versionName: 'Android API level',
         });

package/dist/services/flow-submit.service.d.ts

@@ -0,0 +1,71 @@
+import { ApiError } from '../gateways/api-gateway.js';
+/**
+ * Submitting a flow test when the response may be lost (dcd#1617 follow-up).
+ *
+ * Supabase's ingress sometimes holds a request for minutes before answering,
+ * and Railway's edge cuts a request that is silent for 300s with a 502. Either
+ * way the CLI cannot tell whether its run was created. The API makes that safe
+ * to find out: it answers a repeat of the same submission (same body, same
+ * upload id from getFlowUploadUrl) with the run it already created, or a 409
+ * while that run is still being created. It never creates a second run or a
+ * second charge. So a submit whose outcome is unknown is simply sent again.
+ */
+/**
+ * Waits before each re-send: 2s, then up to 30s apart, about three minutes in
+ * all. That is long enough for a write held in a stall to land, after which the
+ * repeat is answered with the run.
+ */
+export declare const SUBMIT_RETRY_DELAYS_MS: readonly number[];
+/**
+ * No attempt starts more than this long after the first. Each attempt can take
+ * up to its 90s timeout, so without a cap every attempt timing out would hold
+ * the command for about 16 minutes; with it, the worst case is about 6.5.
+ */
+export declare const SUBMIT_RETRY_BUDGET_MS: number;
+/**
+ * Whether a failed attempt is worth sending again. Anything that is not an API
+ * answer is a transport failure: a network error, the attempt timeout, or a
+ * body that died mid-read after a 2xx. In every case the run may already exist,
+ * which a repeat finds out. The npm build throws undici's errors and the bun
+ * binaries their own; neither is an ApiError, so both retry.
+ */
+export declare function isRetryableSubmitError(error: unknown): boolean;
+/** A one-line reason for the retry notice. Network errors carry a long help text. */
+export declare function describeSubmitError(error: unknown): string;
+/** The API predates the client-direct submit: a real API 404s, some proxies 405. */
+export declare function isSubmitEndpointMissing(error: unknown): boolean;
+export interface SubmitRetryNotice {
+    /** The attempt about to be sent, counting from 1. */
+    attempt: number;
+    attempts: number;
+    delayMs: number;
+    reason: string;
+}
+/**
+ * Send a submission, sending it again while its outcome is unknown.
+ *
+ * `fallback` is the legacy multipart submit for an API that predates this
+ * endpoint. It is used only when the *first* attempt says the endpoint is
+ * missing. A 404 on a later attempt comes from an API that took the earlier
+ * attempt, so a multipart submit then would create a second run.
+ *
+ * Resolves with the response and how many attempts it took. Throws the last
+ * error when it is not retryable or the attempts run out.
+ */
+export declare function submitWithRetry<T>(opts: {
+    budgetMs?: number;
+    delaysMs?: readonly number[];
+    fallback: (error: ApiError) => Promise<T>;
+    now?: () => number;
+    /**
+     * Called before each attempt with its number, counting from 1, so a caller
+     * can record how many were made whether the submit succeeds or not.
+     */
+    onAttempt?: (attempt: number) => void;
+    onRetry?: (notice: SubmitRetryNotice) => void;
+    sleep?: (ms: number) => Promise<void>;
+    submit: () => Promise<T>;
+}): Promise<{
+    attempts: number;
+    response: T;
+}>;

package/dist/services/flow-submit.service.js

@@ -0,0 +1,117 @@
+import { ApiError } from '../gateways/api-gateway.js';
+import { isDefinitiveAuthFailure } from '../utils/auth.js';
+/**
+ * Submitting a flow test when the response may be lost (dcd#1617 follow-up).
+ *
+ * Supabase's ingress sometimes holds a request for minutes before answering,
+ * and Railway's edge cuts a request that is silent for 300s with a 502. Either
+ * way the CLI cannot tell whether its run was created. The API makes that safe
+ * to find out: it answers a repeat of the same submission (same body, same
+ * upload id from getFlowUploadUrl) with the run it already created, or a 409
+ * while that run is still being created. It never creates a second run or a
+ * second charge. So a submit whose outcome is unknown is simply sent again.
+ */
+/**
+ * Waits before each re-send: 2s, then up to 30s apart, about three minutes in
+ * all. That is long enough for a write held in a stall to land, after which the
+ * repeat is answered with the run.
+ */
+export const SUBMIT_RETRY_DELAYS_MS = [
+    2000, 5000, 10_000, 20_000, 30_000, 30_000, 30_000, 30_000,
+];
+/**
+ * No attempt starts more than this long after the first. Each attempt can take
+ * up to its 90s timeout, so without a cap every attempt timing out would hold
+ * the command for about 16 minutes; with it, the worst case is about 6.5.
+ */
+export const SUBMIT_RETRY_BUDGET_MS = 5 * 60_000;
+/**
+ * Statuses that leave the outcome unknown (502/503/504 from the edge or the
+ * API), say the API could not finish (500), or say the first attempt is still
+ * creating the run (409 SUBMISSION_IN_PROGRESS). Re-sending is only safe
+ * because the API dedupes on the upload id.
+ */
+const RETRYABLE_STATUSES = new Set([409, 500, 502, 503, 504]);
+/**
+ * Whether a failed attempt is worth sending again. Anything that is not an API
+ * answer is a transport failure: a network error, the attempt timeout, or a
+ * body that died mid-read after a 2xx. In every case the run may already exist,
+ * which a repeat finds out. The npm build throws undici's errors and the bun
+ * binaries their own; neither is an ApiError, so both retry.
+ */
+export function isRetryableSubmitError(error) {
+    if (error instanceof ApiError)
+        return RETRYABLE_STATUSES.has(error.status);
+    // The session can't be refreshed (refused, or logged out): only `dcd login`
+    // fixes that, so another attempt would fail the same way.
+    if (isDefinitiveAuthFailure(error))
+        return false;
+    return true;
+}
+/** A one-line reason for the retry notice. Network errors carry a long help text. */
+export function describeSubmitError(error) {
+    if (error instanceof ApiError)
+        return `HTTP ${error.status}`;
+    if (error instanceof Error) {
+        if (error.name === 'SubmitTimeoutError')
+            return 'no response in time';
+        const code = error.cause?.code;
+        if (typeof code === 'string')
+            return code;
+        return error.name === 'NetworkError' ? 'network error' : error.name;
+    }
+    return String(error);
+}
+/** The API predates the client-direct submit: a real API 404s, some proxies 405. */
+export function isSubmitEndpointMissing(error) {
+    return (error instanceof ApiError && (error.status === 404 || error.status === 405));
+}
+/**
+ * Send a submission, sending it again while its outcome is unknown.
+ *
+ * `fallback` is the legacy multipart submit for an API that predates this
+ * endpoint. It is used only when the *first* attempt says the endpoint is
+ * missing. A 404 on a later attempt comes from an API that took the earlier
+ * attempt, so a multipart submit then would create a second run.
+ *
+ * Resolves with the response and how many attempts it took. Throws the last
+ * error when it is not retryable or the attempts run out.
+ */
+export async function submitWithRetry(opts) {
+    const delaysMs = opts.delaysMs ?? SUBMIT_RETRY_DELAYS_MS;
+    const budgetMs = opts.budgetMs ?? SUBMIT_RETRY_BUDGET_MS;
+    const now = opts.now ?? Date.now;
+    const startedAt = now();
+    const sleep = opts.sleep ??
+        ((ms) => new Promise((resolve) => {
+            setTimeout(resolve, ms);
+        }));
+    const attempts = delaysMs.length + 1;
+    for (let attempt = 1;; attempt++) {
+        opts.onAttempt?.(attempt);
+        try {
+            return { attempts: attempt, response: await opts.submit() };
+        }
+        catch (error) {
+            if (attempt === 1 && isSubmitEndpointMissing(error)) {
+                return {
+                    attempts: attempt,
+                    response: await opts.fallback(error),
+                };
+            }
+            const delayMs = delaysMs[attempt - 1];
+            if (delayMs === undefined ||
+                !isRetryableSubmitError(error) ||
+                now() - startedAt + delayMs > budgetMs) {
+                throw error;
+            }
+            opts.onRetry?.({
+                attempt: attempt + 1,
+                attempts,
+                delayMs,
+                reason: describeSubmitError(error),
+            });
+            await sleep(delayMs);
+        }
+    }
+}

package/dist/services/telemetry.service.d.ts

@@ -13,6 +13,7 @@ declare class Telemetry {
     private config;
     private command;
     private encryption;
+    private submitAttempts;
     private sessionId;
     private startedAt;
     private readonly disabled;
@@ -46,12 +47,20 @@ declare class Telemetry {
      * the meta fields it knows, but forwards every event's `extra`.
      */
     recordEncryption(update: Partial<EncryptionTelemetry>): void;
+    /**
+     * Record how many attempts the flow submit took (dcd#1617 follow-up), sent
+     * as `submit_attempts` on `command completed` / `command failed`. Anything
+     * above 1 means a response was lost and the submit was sent again, which is
+     * what to count when judging how often the API stalls under the CLI.
+     */
+    recordSubmitAttempts(attempts: number): void;
     recordCommandSuccess(): void;
     recordCommandFailure(opts: {
         error: Error | string;
         exitCode: number;
     }): void;
     private encryptionExtra;
+    private submitExtra;
     private enqueue;
     flush(): Promise<void>;
     /**

package/dist/services/telemetry.service.js

@@ -24,6 +24,7 @@ class Telemetry {
     config = null;
     command = inferCommandFromArgv();
     encryption = null;
+    submitAttempts;
     sessionId = randomUUID();
     startedAt = Date.now();
     disabled = !!process.env.DCD_TELEMETRY_DISABLED;
@@ -94,11 +95,21 @@ class Telemetry {
             ...update,
         };
     }
+    /**
+     * Record how many attempts the flow submit took (dcd#1617 follow-up), sent
+     * as `submit_attempts` on `command completed` / `command failed`. Anything
+     * above 1 means a response was lost and the submit was sent again, which is
+     * what to count when judging how often the API stalls under the CLI.
+     */
+    recordSubmitAttempts(attempts) {
+        this.submitAttempts = attempts;
+    }
     recordCommandSuccess() {
         this.enqueue('info', 'cli.lifecycle', 'command completed', {
             duration_ms: Date.now() - this.startedAt,
             exit_code: 0,
             ...this.encryptionExtra(),
+            ...this.submitExtra(),
         });
     }
     recordCommandFailure(opts) {
@@ -110,11 +121,17 @@ class Telemetry {
             error_name: opts.error instanceof Error ? opts.error.name : 'CliError',
             error_stack: opts.error instanceof Error ? opts.error.stack : undefined,
             ...this.encryptionExtra(),
+            ...this.submitExtra(),
         });
     }
     encryptionExtra() {
         return this.encryption ? { encrypt: this.encryption } : {};
     }
+    submitExtra() {
+        return this.submitAttempts === undefined
+            ? {}
+            : { submit_attempts: this.submitAttempts };
+    }
     enqueue(level, context, message, extra) {
         if (this.disabled)
             return;

package/dist/services/test-submission.service.d.ts

@@ -50,6 +50,13 @@ export interface TestSubmissionConfig {
     metadata?: string[];
     name?: string;
     orientation?: string;
+    /**
+     * Where this upload sits among the org's own queued runs. Like
+     * `cancelPrevious`, sent as its own field rather than inside `config`: it is
+     * a scheduling directive for the whole upload, not run configuration. Only
+     * reorders the org's own queue; it never moves the org ahead of others.
+     */
+    priority?: 'low' | 'normal' | 'high';
     raw?: unknown;
     /**
      * Which emulator software renderer to boot with (Android only). Omitted

package/dist/services/test-submission.service.js

@@ -20,7 +20,7 @@ export class TestSubmissionService {
      * @returns The flow zip buffer, its SHA-256, and the string-encoded fields
      */
     async buildTestPayload(config) {
-        const { apiUrl, appBinaryId, appPlatform, encrypt, flowFile, executionPlan, commonRoot, cliVersion, env = [], metadata = [], cancelPrevious = false, googlePlay = false, androidApiLevel, androidDevice, androidNoSnapshot, iOSVersion, iOSDevice, name, runnerType, maestroVersion, deviceLocale, orientation, retry, continueOnFailure = true, renderEngine, report, showCrosshairs, maestroChromeOnboarding, raw, disableAnimations, deviceMatrix, debug = false, logger, } = config;
+        const { apiUrl, appBinaryId, appPlatform, encrypt, flowFile, executionPlan, commonRoot, cliVersion, env = [], metadata = [], cancelPrevious = false, googlePlay = false, androidApiLevel, androidDevice, androidNoSnapshot, iOSVersion, iOSDevice, name, runnerType, maestroVersion, deviceLocale, orientation, priority, retry, continueOnFailure = true, renderEngine, report, showCrosshairs, maestroChromeOnboarding, raw, disableAnimations, deviceMatrix, debug = false, logger, } = config;
         const { allExcludeTags, allIncludeTags, flowMetadata, flowOverrides, flowsToRun: testFileNames, includedFiles = [], referencedFiles, sequence, workspaceConfig, } = executionPlan;
         const { flows: sequentialFlows = [] } = sequence ?? {};
         const envObject = this.parseKeyValuePairs(env);
@@ -168,6 +168,11 @@ export class TestSubmissionService {
         if (cancelPrevious) {
             fields.cancelPrevious = 'true';
         }
+        // Same reasoning: 'normal' is the default and is never sent, so the
+        // default path's wire shape is unchanged and an older API never sees it.
+        if (priority && priority !== 'normal') {
+            fields.priority = priority;
+        }
         this.setOptionalFields(fields, {
             androidApiLevel,
             androidDevice,

package/package.json

@@ -30,7 +30,7 @@
     "chai": "^6.2.2",
     "eslint": "^10.5.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-unicorn": "^76.0.0",
+    "eslint-plugin-unicorn": "^77.0.0",
     "husky": "^9.1.7",
     "mocha": "^12.0.0",
     "prettier": "^3.8.4",
@@ -68,7 +68,7 @@
     "test:unit": "node scripts/test-runner.mjs --unit",
     "typecheck": "tsc --noEmit -p tsconfig.test.json"
   },
-  "version": "5.8.0-beta.1",
+  "version": "5.8.0-beta.3",
   "bugs": {
     "url": "https://discord.gg/gm3mJwcNw8"
   },