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

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

@@ -42,6 +42,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 +163,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 +602,7 @@ export const cloudCommand = defineCommand({
                 metadata: mergedMetadata,
                 name,
                 orientation,
+                priority,
                 raw: [],
                 report,
                 retry,

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/mcp/tools/run-cloud-test.js

@@ -70,6 +70,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 +212,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,

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.2",
   "bugs": {
     "url": "https://discord.gg/gm3mJwcNw8"
   },