@uipath/orchestrator-tool 1.206.0-preview.283 → 1.206.0-preview.288

package/dist/index.js

@@ -6,7 +6,7 @@ import"./tool-bhbmn53g.js";
 import {
   metadata2,
   registerCommands2
-} from "./tool-xbjjd7dt.js";
+} from "./tool-ba7m0gyw.js";
 
 // src/index.ts
 var program = new Command;

package/dist/{tool-xbjjd7dt.js → tool-ba7m0gyw.js}

@@ -91,7 +91,7 @@ var package_default = {
   name: "@uipath/orchestrator-tool",
   author: "UiPath",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.206.0-preview.283",
+  version: "1.206.0-preview.288",
   description: "Manage Orchestrator folders, jobs, processes, and releases.",
   private: false,
   repository: {
@@ -166,6 +166,18 @@ async function resolveQueueByKey(api, key) {
   }
   return queue;
 }
+async function resolveQueueByKeyInFolder(api, key, folderLabel) {
+  validateUuid(key, "queue");
+  const result = await api.queueDefinitionsListQueues({
+    $filter: `QueueDefinitionKey eq ${key}`,
+    $top: 1
+  });
+  const id = result.value?.[0]?.queueDefinitionId;
+  if (id == null) {
+    throw Object.assign(new Error(`Queue not found for key: '${key}' in folder '${folderLabel}'.`), { errorCode: "not_found", retry: "RetryWillNotFix" });
+  }
+  return { id };
+}
 var QUEUE_NAME_PAGE_SIZE = 100;
 var QUEUE_NAME_MAX_PAGES = 20;
 async function collectQueuesNamed(api, name, folderId) {
@@ -1275,12 +1287,16 @@ function invalidArgument(message) {
     retry: "RetryWillNotFix"
   });
 }
+function bothFolderSelectorsError(scope) {
+  return scope.folderPath !== undefined && scope.folderKey !== undefined ? invalidArgument("Provide either --folder-path or --folder-key, not both.") : undefined;
+}
 async function assertEntityInFolder(kind, key, entityFolderIds, scope) {
   if (scope.folderPath === undefined && scope.folderKey === undefined) {
     return;
   }
-  if (scope.folderPath !== undefined && scope.folderKey !== undefined) {
-    throw invalidArgument("Provide either --folder-path or --folder-key, not both.");
+  const bothSelectors = bothFolderSelectorsError(scope);
+  if (bothSelectors) {
+    throw bothSelectors;
   }
   const folder = await resolveFolder({ folderPath: scope.folderPath, folderKey: scope.folderKey }, { tenant: scope.tenant });
   if (folder !== undefined && entityFolderIds.includes(folder.id)) {
@@ -10751,6 +10767,43 @@ function formatQueueStats(s) {
     QueueFoldersCount: s.queueFoldersCount ?? 0
   };
 }
+var CROSS_FOLDER_MISS_HINT = " If the queue was just created, pass its folder with --folder-path or --folder-key: the lookup without a folder can take a while to list a queue in a new folder.";
+async function resolveQueueTarget(queueKey, options, errorMessage) {
+  if (options.folderPath !== undefined || options.folderKey !== undefined) {
+    const bothSelectors = bothFolderSelectorsError(options);
+    if (bothSelectors) {
+      await reportFailure(errorMessage, bothSelectors);
+      return;
+    }
+    const scope = {
+      tenant: options.tenant,
+      folderPath: options.folderPath,
+      folderKey: options.folderKey
+    };
+    const folderLabel = options.folderPath ?? options.folderKey;
+    const resolved = await resolveEntityOrFail(QueueDefinitionsApi, scope, (api, key) => resolveQueueByKeyInFolder(api, key, folderLabel), queueKey, errorMessage);
+    return resolved ? { id: resolved.entity.id, scope } : undefined;
+  }
+  const resolved = await resolveEntityOrFail(QueueDefinitionsApi, { tenant: options.tenant }, resolveQueueByKey, queueKey, errorMessage, (instructions) => instructions.startsWith("Queue not found") ? instructions + CROSS_FOLDER_MISS_HINT : instructions);
+  if (!resolved)
+    return;
+  if (resolved.entity.organizationUnitId == null) {
+    OutputFormatter.error({
+      Result: RESULTS.Failure,
+      Message: errorMessage,
+      Instructions: `Queue '${queueKey}' is missing folder context.`
+    });
+    processContext.exit(1);
+    return;
+  }
+  return {
+    id: resolved.entity.id,
+    scope: {
+      tenant: options.tenant,
+      folderId: resolved.entity.organizationUnitId.toString()
+    }
+  };
+}
 var QUEUES_LIST_EXAMPLES = [
   {
     Description: "List queues in a folder",
@@ -10903,6 +10956,27 @@ var QUEUES_UPDATE_EXAMPLES = [
         id: 1206025
       }
     }
+  },
+  {
+    Description: "Update a queue just created in a new folder, looking the key up in that folder",
+    Command: "uip or queues update a1b2c3d4-0000-0000-0000-000000000001 --folder-path Finance --description 'Invoices to process'",
+    Output: {
+      Code: "QueueUpdated",
+      Data: {
+        key: "a1b2c3d4-0000-0000-0000-000000000001",
+        name: "Invoices",
+        description: "Invoices to process",
+        maxNumberOfRetries: 0,
+        acceptAutomaticallyRetry: true,
+        retryAbandonedItems: false,
+        enforceUniqueReference: false,
+        encrypted: false,
+        creationTime: "2026-01-15T10:00:00.000Z",
+        foldersCount: 1,
+        tags: [],
+        id: 1206025
+      }
+    }
   }
 ];
 var QUEUES_DELETE_EXAMPLES = [
@@ -11229,7 +11303,7 @@ var registerQueuesCommand = (program) => {
       Data: queue
     });
   });
-  queues.command("update").description("Update queue properties by key (GUID). No folder needed -- resolves cross-folder. " + "Only provided fields are changed. " + "Archive retention needs a storage bucket (--retention-bucket / --stale-retention-bucket); the current bucket is kept while the action stays Archive and cleared when it changes. " + "Use 'queues list' to retrieve the key.").argument("<queue-key>", "Queue key (GUID)").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-n, --name <name>", "New queue name").option("-d, --description <text>", "Description of the queue").option("--max-retries <number>", "Maximum number of retry attempts for failed items").option("--sla-in-minutes <minutes>", "Queue item processing SLA in minutes").option("--risk-sla-in-minutes <minutes>", "Queue item processing risk SLA in minutes").option("--auto-retry", "Enable automatic retry of failed items").option("--no-auto-retry", "Disable automatic retry of failed items").option("--retry-abandoned-items", "Enable automatic retry of abandoned items").option("--no-retry-abandoned-items", "Disable automatic retry of abandoned items").option("--enforce-unique-reference", "Enforce unique reference values for queue items").option("--no-enforce-unique-reference", "Disable unique reference enforcement for queue items").option("--encrypted", "Store queue item data in encrypted format").option("--retention-action <action>", "Action for completed items, one of: Delete, Archive, None (e.g. --retention-action Archive). Switching to Archive requires --retention-bucket unless the queue already archives").option("--retention-period <days>", "Retention period in days for completed items").option("--retention-bucket <bucket-key>", "Storage bucket key (GUID) for archived completed items. Omit to keep the current bucket; it is cleared automatically when the action is no longer Archive. The bucket must be in, or shared to, the queue's folder. Use 'buckets list' to retrieve the key").option("--stale-retention-action <action>", "Action for uncompleted items, one of: Delete, Archive, None (e.g. --stale-retention-action Archive). Switching to Archive requires --stale-retention-bucket unless the queue already archives them").option("--stale-retention-period <days>", "Retention period in days for uncompleted items").option("--stale-retention-bucket <bucket-key>", "Storage bucket key (GUID) for archived uncompleted items. Omit to keep the current bucket; it is cleared automatically when the action is no longer Archive. The bucket must be in, or shared to, the queue's folder. Use 'buckets list' to retrieve the key").examples(QUEUES_UPDATE_EXAMPLES).trackedAction(processContext, async (queueKey, options) => {
+  queues.command("update").description("Update queue properties by key (GUID). No folder needed -- resolves cross-folder; pass --folder-path or --folder-key to look the key up in that folder instead. " + "Only provided fields are changed. " + "Archive retention needs a storage bucket (--retention-bucket / --stale-retention-bucket); the current bucket is kept while the action stays Archive and cleared when it changes. " + "Use 'queues list' to retrieve the key.").argument("<queue-key>", "Queue key (GUID)").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--folder-path <path>", "Path of the folder that holds the queue (e.g., 'Shared'). Looks the key up in that folder only").option("--folder-key <key>", "Key (GUID) of the folder that holds the queue. Looks the key up in that folder only").option("-n, --name <name>", "New queue name").option("-d, --description <text>", "Description of the queue").option("--max-retries <number>", "Maximum number of retry attempts for failed items").option("--sla-in-minutes <minutes>", "Queue item processing SLA in minutes").option("--risk-sla-in-minutes <minutes>", "Queue item processing risk SLA in minutes").option("--auto-retry", "Enable automatic retry of failed items").option("--no-auto-retry", "Disable automatic retry of failed items").option("--retry-abandoned-items", "Enable automatic retry of abandoned items").option("--no-retry-abandoned-items", "Disable automatic retry of abandoned items").option("--enforce-unique-reference", "Enforce unique reference values for queue items").option("--no-enforce-unique-reference", "Disable unique reference enforcement for queue items").option("--encrypted", "Store queue item data in encrypted format").option("--retention-action <action>", "Action for completed items, one of: Delete, Archive, None (e.g. --retention-action Archive). Switching to Archive requires --retention-bucket unless the queue already archives").option("--retention-period <days>", "Retention period in days for completed items").option("--retention-bucket <bucket-key>", "Storage bucket key (GUID) for archived completed items. Omit to keep the current bucket; it is cleared automatically when the action is no longer Archive. The bucket must be in, or shared to, the queue's folder. Use 'buckets list' to retrieve the key").option("--stale-retention-action <action>", "Action for uncompleted items, one of: Delete, Archive, None (e.g. --stale-retention-action Archive). Switching to Archive requires --stale-retention-bucket unless the queue already archives them").option("--stale-retention-period <days>", "Retention period in days for uncompleted items").option("--stale-retention-bucket <bucket-key>", "Storage bucket key (GUID) for archived uncompleted items. Omit to keep the current bucket; it is cleared automatically when the action is no longer Archive. The bucket must be in, or shared to, the queue's folder. Use 'buckets list' to retrieve the key").examples(QUEUES_UPDATE_EXAMPLES).trackedAction(processContext, async (queueKey, options) => {
     const slaInMinutes = parseOptionalMinutes(options.slaInMinutes, "--sla-in-minutes", "Error updating queue");
     if (options.slaInMinutes !== undefined && slaInMinutes === undefined) {
       return;
@@ -11264,23 +11338,10 @@ var registerQueuesCommand = (program) => {
       reportRetentionFailure(bucketPrecheck);
       return;
     }
-    const resolved = await resolveEntityOrFail(QueueDefinitionsApi, { tenant: options.tenant }, resolveQueueByKey, queueKey, "Error updating queue");
-    if (!resolved)
+    const existing = await resolveQueueTarget(queueKey, options, "Error updating queue");
+    if (!existing)
       return;
-    const { entity: existing } = resolved;
-    if (existing.organizationUnitId == null) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error updating queue",
-        Instructions: `Queue '${queueKey}' is missing folder context.`
-      });
-      processContext.exit(1);
-      return;
-    }
-    const [folderApiError, api] = await catchError(createApiClient(QueueDefinitionsApi, {
-      tenant: options.tenant,
-      folderId: existing.organizationUnitId.toString()
-    }));
+    const [folderApiError, api] = await catchError(createApiClient(QueueDefinitionsApi, existing.scope));
     if (folderApiError) {
       await reportFailure("Error updating queue", folderApiError);
       return;
@@ -11329,32 +11390,20 @@ var registerQueuesCommand = (program) => {
       Data: updated
     });
   });
-  queues.command("delete").description("Delete a queue by key (GUID). No folder needed -- resolves cross-folder. " + "Refuses to delete a queue that still has items unless you pass --force " + "(deleting the queue deletes its items too). " + "Use 'queues list' to retrieve the key.").argument("<queue-key>", "Queue key (GUID) to delete").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-y, --yes", "Confirm this irreversible operation (required; the CLI never prompts)").option("-f, --force", "Delete the queue even if it still has items (the items are deleted too; implies --yes)").examples(QUEUES_DELETE_EXAMPLES).trackedAction(processContext, async (queueKey, options) => {
+  queues.command("delete").description("Delete a queue by key (GUID). No folder needed -- resolves cross-folder; pass --folder-path or --folder-key to look the key up in that folder instead. " + "Refuses to delete a queue that still has items unless you pass --force " + "(deleting the queue deletes its items too). " + "Use 'queues list' to retrieve the key.").argument("<queue-key>", "Queue key (GUID) to delete").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--folder-path <path>", "Path of the folder that holds the queue (e.g., 'Shared'). Looks the key up in that folder only").option("--folder-key <key>", "Key (GUID) of the folder that holds the queue. Looks the key up in that folder only").option("-y, --yes", "Confirm this irreversible operation (required; the CLI never prompts)").option("-f, --force", "Delete the queue even if it still has items (the items are deleted too; implies --yes)").examples(QUEUES_DELETE_EXAMPLES).trackedAction(processContext, async (queueKey, options) => {
     if (!requireConfirmation(options, `delete queue '${queueKey}'`))
       return;
-    const resolved = await resolveEntityOrFail(QueueDefinitionsApi, { tenant: options.tenant }, resolveQueueByKey, queueKey, "Error deleting queue");
-    if (!resolved)
-      return;
-    if (resolved.entity.organizationUnitId == null) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error deleting queue",
-        Instructions: `Queue '${queueKey}' is missing folder context.`
-      });
-      processContext.exit(1);
+    const target = await resolveQueueTarget(queueKey, options, "Error deleting queue");
+    if (!target)
       return;
-    }
     if (!options.force) {
-      const [itemsApiError, itemsApi] = await catchError(createApiClient(QueueItemsApi, {
-        tenant: options.tenant,
-        folderId: resolved.entity.organizationUnitId.toString()
-      }));
+      const [itemsApiError, itemsApi] = await catchError(createApiClient(QueueItemsApi, target.scope));
       if (itemsApiError) {
         await reportFailure("Error deleting queue", itemsApiError);
         return;
       }
       const [countError, itemsResult] = await catchError(itemsApi.queueItemsGet({
-        $filter: `QueueDefinitionId eq ${resolved.entity.id} and Status ne 'Deleted'`,
+        $filter: `QueueDefinitionId eq ${target.id} and Status ne 'Deleted'`,
         $top: 1
       }));
       if (countError) {
@@ -11371,16 +11420,13 @@ var registerQueuesCommand = (program) => {
         return;
       }
     }
-    const [folderApiError, folderApi] = await catchError(createApiClient(QueueDefinitionsApi, {
-      tenant: options.tenant,
-      folderId: resolved.entity.organizationUnitId.toString()
-    }));
+    const [folderApiError, folderApi] = await catchError(createApiClient(QueueDefinitionsApi, target.scope));
     if (folderApiError) {
       await reportFailure("Error deleting queue", folderApiError);
       return;
     }
     const [deleteError] = await catchError(folderApi.queueDefinitionsDeleteById({
-      key: resolved.entity.id
+      key: target.id
     }));
     if (deleteError) {
       await reportFailure("Error deleting queue", deleteError);
@@ -16371,4 +16417,4 @@ var registerCommands2 = async (program) => {
 
 export { metadata2, registerCommands2 };
 
-//# debugId=78CE4B8D1BEAA63E64756E2164756E21
+//# debugId=B36A38700B4D46D464756E2164756E21

package/dist/tool.js

@@ -1,7 +1,7 @@
 import {
   metadata2,
   registerCommands2
-} from "./tool-xbjjd7dt.js";
+} from "./tool-ba7m0gyw.js";
 import"./tool-da1sr496.js";
 import"./tool-bhbmn53g.js";
 export {

package/package.json

@@ -2,7 +2,7 @@
     "name": "@uipath/orchestrator-tool",
     "author": "UiPath",
     "license": "SEE LICENSE IN LICENSE.txt",
-    "version": "1.206.0-preview.283",
+    "version": "1.206.0-preview.288",
     "description": "Manage Orchestrator folders, jobs, processes, and releases.",
     "private": false,
     "repository": {
@@ -27,5 +27,5 @@
     "files": [
         "dist"
     ],
-    "gitHead": "d3ccc68dcd456e8acaafff765d1b87799b4bb8f0"
+    "gitHead": "6373f3d15398939c22598d1874a6df01e872bc0a"
 }