@uipath/ixp-tool 1.201.0-preview.115 → 1.201.0-preview.121

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   Command,
   package_default,
   registerCommands
-} from "./tool-jb4q26s4.js";
+} from "./tool-0fw76nep.js";
 import"./tool-9qecd4wb.js";
 import"./tool-7eva0peq.js";
 import"./tool-5arsyj36.js";

package/dist/{tool-jb4q26s4.js → tool-0fw76nep.js}

@@ -2112,7 +2112,7 @@ var require_commander = __commonJS((exports) => {
 var package_default = {
   name: "@uipath/ixp-tool",
   license: "MIT",
-  version: "1.201.0-preview.115",
+  version: "1.201.0-preview.121",
   description: "Manage UiPath IXP projects, prompts, predictions, and model publishing.",
   private: false,
   repository: {
@@ -2212,17 +2212,18 @@ var TLS_ERROR_CODES = new Set([
 ]);
 var TLS_INSTRUCTIONS = "The server's TLS certificate could not be verified. Most often a " + "corporate proxy/firewall re-signs HTTPS with a root CA that Node does " + "not trust — set NODE_EXTRA_CA_CERTS to that CA's PEM file (and HTTPS_PROXY " + "if you connect through a proxy). If the certificate is instead expired or " + "its hostname does not match, fix the endpoint URL or the system clock. " + "Then retry.";
 var NETWORK_INSTRUCTIONS = "Could not reach the UiPath service. Check your network connection and " + "VPN, confirm any HTTP_PROXY/HTTPS_PROXY/NO_PROXY settings are correct, " + "then retry.";
+var LOCAL_PERMISSION_ERROR_CODES = new Set(["EACCES", "EPERM", "EROFS"]);
+var LOCAL_PERMISSION_MESSAGE_PATTERN = /\b(EACCES|EPERM|EROFS)\b/;
+function localPermissionInstructions(code, path) {
+  const target = path !== undefined ? `'${path}'` : "a local file or resource";
+  if (code === "EROFS") {
+    return `The filesystem containing ${target} is read-only (EROFS), so the ` + "CLI could not write to it. This is a local environment problem, " + "not a UiPath service error — retrying will not help. Use a " + "writable location, or give this environment write access to the " + "path.";
+  }
+  const remedy = process.platform === "win32" ? "Re-run from an elevated terminal, close any program holding " + "the file open, or grant your user access to the path." : "Grant this user (or the sandbox the command runs in) access " + "to the path, or run the command outside the sandbox.";
+  return `The operating system denied access to ${target} (${code}). This is ` + "a local permission problem, not a UiPath service error — retrying " + `without a permission change will not help. ${remedy}`;
+}
 function describeConnectivityError(error) {
-  const queue = [error];
-  const seen = new Set;
-  for (let steps = 0;queue.length > 0 && steps < 32; steps++) {
-    const current = queue.shift();
-    if (current === null || typeof current !== "object")
-      continue;
-    if (seen.has(current))
-      continue;
-    seen.add(current);
-    const cur = current;
+  for (const cur of walkErrorGraph(error)) {
     const code = typeof cur.code === "string" ? cur.code : undefined;
     const message = typeof cur.message === "string" ? cur.message : undefined;
     if (code && TLS_ERROR_CODES.has(code)) {
@@ -2241,6 +2242,49 @@ function describeConnectivityError(error) {
         instructions: NETWORK_INSTRUCTIONS
       };
     }
+  }
+  return;
+}
+function describePermissionError(error) {
+  for (const cur of walkErrorGraph(error)) {
+    const message = typeof cur.message === "string" ? cur.message : undefined;
+    const code = matchLocalPermissionCode(cur.code, message);
+    if (!code)
+      continue;
+    const path = localPermissionPath(cur.path, message);
+    return {
+      code,
+      message: message ?? code,
+      ...path !== undefined ? { path } : {},
+      instructions: localPermissionInstructions(code, path)
+    };
+  }
+  return;
+}
+function matchLocalPermissionCode(code, message) {
+  if (typeof code === "string" && LOCAL_PERMISSION_ERROR_CODES.has(code)) {
+    return code;
+  }
+  const match = message ? LOCAL_PERMISSION_MESSAGE_PATTERN.exec(message) : null;
+  return match ? match[1] : undefined;
+}
+function localPermissionPath(path, message) {
+  if (typeof path === "string")
+    return path;
+  return message ? /'([^']+)'/.exec(message)?.[1] : undefined;
+}
+function* walkErrorGraph(error) {
+  const queue = [error];
+  const seen = new Set;
+  for (let steps = 0;queue.length > 0 && steps < 32; steps++) {
+    const current = queue.shift();
+    if (current === null || typeof current !== "object")
+      continue;
+    if (seen.has(current))
+      continue;
+    seen.add(current);
+    const cur = current;
+    yield cur;
     if (cur.cause !== undefined)
       queue.push(cur.cause);
     if (Array.isArray(cur.errors))
@@ -2301,6 +2345,12 @@ function classifyError(status, error) {
   if (status !== undefined && status >= 500 && status < 600) {
     return { errorCode: "server_error", retry: "RetryLater" };
   }
+  if (status === undefined && describePermissionError(error)) {
+    return {
+      errorCode: "local_permission_denied",
+      retry: "RetryWillNotFix"
+    };
+  }
   const connectivity = describeConnectivityError(error);
   if (connectivity) {
     return {
@@ -2403,6 +2453,16 @@ async function extractErrorDetails(error, options) {
       message = `${message}: ${connectivity.message}`;
     }
   }
+  const permission = status === undefined ? describePermissionError(error) : undefined;
+  if (permission) {
+    if (permission.message !== message && !message.includes(permission.message)) {
+      message = `${message}: ${permission.message}`;
+    }
+    if (!message.includes(permission.instructions)) {
+      const punctuated = message.endsWith(".") ? message : `${message}.`;
+      message = `${punctuated} ${permission.instructions}`;
+    }
+  }
   let details = rawMessage;
   if (rawBody) {
     if (parsedBody) {
@@ -2442,6 +2502,9 @@ async function extractErrorDetails(error, options) {
   if (parsedBody?.traceId && typeof parsedBody.traceId === "string") {
     context.traceId = parsedBody.traceId;
   }
+  if (permission?.path !== undefined) {
+    context.path = permission.path;
+  }
   if (status === 429) {
     const resp = response;
     const headersObj = resp?.headers;
@@ -3671,6 +3734,7 @@ var CLI_ERROR_CODES = [
   "invalid_argument",
   "authentication_required",
   "permission_denied",
+  "local_permission_denied",
   "not_found",
   "rate_limited",
   "network_error",
@@ -4106,12 +4170,16 @@ function defaultErrorCodeForHttpStatus(status) {
     return "server_error";
   return;
 }
+var LOCAL_PERMISSION_TEXT_PATTERN = /(?:\b|\()(?:EACCES|EPERM|EROFS)(?::\s|\))/;
 function defaultErrorCodeForFailure(data) {
   if (data.Result === RESULTS.Failure) {
     const status = data.Context?.httpStatus ?? parseHttpStatusFromMessage2(data.Message);
     const errorCode = defaultErrorCodeForHttpStatus(status);
     if (errorCode)
       return errorCode;
+    if (status === undefined && (LOCAL_PERMISSION_TEXT_PATTERN.test(data.Message) || LOCAL_PERMISSION_TEXT_PATTERN.test(data.Instructions))) {
+      return "local_permission_denied";
+    }
   }
   return defaultErrorCodeForResult(data.Result);
 }
@@ -4673,11 +4741,10 @@ function getSdkUserAgentToken(pkg) {
   const packageName = pkg.name.replace(/^@uipath\//, "");
   return getEffectiveUserAgent(`${packageName}/${pkg.version}`);
 }
-// ../common/src/tool-provider.ts
-var factorySlot = singleton("PackagerFactoryProvider");
-var moduleSlot = singleton("ToolModuleProvider");
 // ../common/src/telemetry/ship-succeeded.ts
 var shippedKeysSlot = singleton("ShipSucceededDedupeKeys");
+// ../common/src/tool-provider.ts
+var factorySlot = singleton("PackagerFactoryProvider");
 // ../auth/src/config.ts
 var DEFAULT_CLIENT_ID = "36dea5b8-e8bb-423d-8e7b-c808df8f1c00";
 var AUTH_FILE_CONFIG_KEY = Symbol.for("@uipath/auth/AuthFileConfig");
@@ -5918,6 +5985,9 @@ function normalizeTokenRefreshUnavailableFailure() {
 function errorMessage(error) {
   return error instanceof Error ? error.message : String(error);
 }
+// ../auth/src/tenantSelection.ts
+var IDENTIFIER_STATUSES = new Set([400, 403, 404]);
+
 // ../auth/src/selectTenant.ts
 var TENANT_SELECTION_REQUIRED_CODE = "TENANT_SELECTION_REQUIRED";
 var INVALID_TENANT_CODE = "INVALID_TENANT";
@@ -5929,7 +5999,7 @@ var TENANT_SELECTION_CODES = new Set([
 var package_default2 = {
   name: "@uipath/ixp-sdk",
   license: "MIT",
-  version: "1.201.0-preview.115",
+  version: "1.201.0-preview.121",
   description: "SDK for the UiPath IXP (Intelligent eXtraction Platform) API — projects, taxonomies, prompts, predictions, and model publishing.",
   repository: {
     type: "git",
@@ -6110,6 +6180,28 @@ async function getDeploymentTaxonomy(config, projectName, version) {
   }
   return designtimeGet(config, `/api/projects/${encodeURIComponent(projectName)}/models/${version}/taxonomy`, "Failed to get deployment taxonomy");
 }
+function deploymentsPath(projectName) {
+  return `/api/projects/${encodeURIComponent(projectName)}/deployments`;
+}
+async function deployModel(config, projectName, options) {
+  const body = {
+    ModelVersion: options.modelVersion,
+    FolderKey: options.folderKey
+  };
+  if (options.deploymentTitle !== undefined) {
+    body.DeploymentTitle = options.deploymentTitle;
+  }
+  return designtimePost(config, deploymentsPath(projectName), body, "Failed to deploy model");
+}
+async function upgradeDeployment(config, projectName, deploymentName, options) {
+  return designtimePut(config, `${deploymentsPath(projectName)}/${encodeURIComponent(deploymentName)}`, {
+    ModelVersion: options.modelVersion,
+    FolderKey: options.folderKey
+  }, "Failed to upgrade deployment");
+}
+async function listDeployments(config, projectName) {
+  return designtimeGet(config, deploymentsPath(projectName), "Failed to list deployments");
+}
 // ../ixp-sdk/src/documents-service.ts
 function documentsPath(projectName) {
   return `/api/projects/${encodeURIComponent(projectName)}/documents`;
@@ -6309,7 +6401,11 @@ async function parseResponseBody(error) {
   } catch {}
   return;
 }
-async function emitError(error, message) {
+function httpStatusOf(error) {
+  const status = error?.status;
+  return typeof status === "number" ? status : undefined;
+}
+async function emitError(error, message, hint) {
   const details = await extractErrorDetails(error);
   const body = await parseResponseBody(error);
   let instructions = details.message;
@@ -6326,7 +6422,7 @@ async function emitError(error, message) {
     Result: details.result,
     ErrorCode: details.errorCode,
     Message: message,
-    Instructions: instructions,
+    Instructions: hint ? `${instructions} ${hint}` : instructions,
     Retry: details.retry,
     ...context ? { Context: context } : {}
   });
@@ -6539,6 +6635,7 @@ var registerDataTypesCommand = (program2) => {
 };
 
 // src/commands/deployments.ts
+var DEPLOY_CONFLICT_HINT = "To change the version an existing deployment serves, use `uip ixp deployments upgrade <project-name> <deployment-name> --version <number> --folder-key <guid>`. Get <deployment-name> from the DeploymentName field of `uip ixp deployments list` — it is not the title you passed to --title.";
 var DEPLOYMENTS_GET_TAXONOMY_EXAMPLES = [
   {
     Description: "Inspect the project taxonomy pinned to a specific trained model version (the schema that powers the deployed model)",
@@ -6554,8 +6651,133 @@ var DEPLOYMENTS_GET_TAXONOMY_EXAMPLES = [
     }
   }
 ];
+var DEPLOYMENTS_CREATE_EXAMPLES = [
+  {
+    Description: "Deploy a trained model version to an Orchestrator folder",
+    Command: "uip ixp deployments create my-invoices-a1b2c3d4-ixp --version 13 --folder-key 3f0a91c7-1111-2222-3333-444455556666",
+    Output: {
+      Code: "IxpDeploymentsCreate",
+      Data: {
+        ProjectName: "my-invoices-a1b2c3d4-ixp",
+        ModelVersion: 13,
+        FolderKey: "3f0a91c7-1111-2222-3333-444455556666",
+        DeploymentName: "my-invoices-a1b2c3d4-7c3f21e8-ixp",
+        DeploymentTitle: "my-invoices-a1b2c3d4"
+      }
+    }
+  },
+  {
+    Description: "Deploy under a chosen title",
+    Command: "uip ixp deployments create my-invoices-a1b2c3d4-ixp --version 13 --folder-key 3f0a91c7-1111-2222-3333-444455556666 --title invoices",
+    Output: {
+      Code: "IxpDeploymentsCreate",
+      Data: {
+        ProjectName: "my-invoices-a1b2c3d4-ixp",
+        ModelVersion: 13,
+        FolderKey: "3f0a91c7-1111-2222-3333-444455556666",
+        DeploymentName: "invoices-08963f00-ixp",
+        DeploymentTitle: "invoices"
+      }
+    }
+  }
+];
+var DEPLOYMENTS_UPGRADE_EXAMPLES = [
+  {
+    Description: "Move an existing deployment to another trained model version",
+    Command: "uip ixp deployments upgrade my-invoices-a1b2c3d4-ixp invoices-08963f00-ixp --version 14 --folder-key 3f0a91c7-1111-2222-3333-444455556666",
+    Output: {
+      Code: "IxpDeploymentsUpgrade",
+      Data: {
+        ProjectName: "my-invoices-a1b2c3d4-ixp",
+        ModelVersion: 14,
+        FolderKey: "3f0a91c7-1111-2222-3333-444455556666",
+        DeploymentName: "invoices-08963f00-ixp",
+        DeploymentTitle: "invoices"
+      }
+    }
+  }
+];
+var DEPLOYMENTS_LIST_EXAMPLES = [
+  {
+    Description: "List every folder this project's model versions are deployed to",
+    Command: "uip ixp deployments list my-invoices-a1b2c3d4-ixp",
+    Output: {
+      Code: "IxpDeploymentsList",
+      Data: [
+        {
+          DeploymentName: "invoices-08963f00-ixp",
+          DeploymentTitle: "invoices",
+          ModelVersion: 13,
+          FolderKey: "3f0a91c7-1111-2222-3333-444455556666",
+          DeployedAt: "2026-08-18T11:26:25.367124+00:00"
+        }
+      ]
+    }
+  }
+];
 var registerDeploymentsCommand = (program2) => {
-  const deployments = program2.command("deployments").description("Inspect IXP deployments — project taxonomy pinned to a specific trained model version");
+  const deployments = program2.command("deployments").description("Manage IXP deployments — deploy trained model versions to Orchestrator folders, move a deployment to another version, and inspect the taxonomy pinned to a version");
+  deployments.command("create").description("Deploy a trained model version to an Orchestrator folder, making it callable at runtime by activities and Maestro Flow. Only ever adds a deployment — moving an existing one is `deployments upgrade`.").argument("<project-name>", "Project name").requiredOption("--version <number>", "Trained model version to deploy (non-negative integer). Get available versions from `uip ixp projects list-models <project-name> --output json`.", (raw) => parseBoundedInt(raw, "--version", { min: 0, max: 1e6 })).requiredOption("--folder-key <guid>", "Orchestrator folder key (GUID) to deploy into. Get it from `uip or folders list --output json`.").option("--title <title>", "Title to deploy under (defaults to the project name minus its '-ixp' suffix). Comes back verbatim as DeploymentTitle; the backend slugs and suffixes it into the name the runtime resolves, returned as DeploymentName.").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).examples(DEPLOYMENTS_CREATE_EXAMPLES).trackedAction(processContext, async (projectName, options) => {
+    const [err, deployment] = await catchError2((async () => {
+      const config = await createIxpConfig({
+        tenant: options.tenant
+      });
+      return await deployModel(config, projectName, {
+        modelVersion: options.version,
+        folderKey: options.folderKey,
+        deploymentTitle: options.title
+      });
+    })());
+    if (err) {
+      await emitError(err, "Failed to deploy model", httpStatusOf(err) === 409 ? DEPLOY_CONFLICT_HINT : undefined);
+      processContext.exit(1);
+      return;
+    }
+    OutputFormatter.success({
+      Result: "Success",
+      Code: "IxpDeploymentsCreate",
+      Data: deployment
+    });
+  });
+  deployments.command("upgrade").description("Move an existing deployment to another trained model version, changing which version every runtime caller of that folder and name gets").argument("<project-name>", "Project name").argument("<deployment-name>", "Deployment to move, addressed by the name the runtime resolves — the DeploymentName field of `uip ixp deployments list <project-name> --output json`, not the title it was created under.").requiredOption("--version <number>", "Trained model version to move the deployment to (non-negative integer). Get available versions from `uip ixp projects list-models <project-name> --output json`.", (raw) => parseBoundedInt(raw, "--version", { min: 0, max: 1e6 })).requiredOption("--folder-key <guid>", "Orchestrator folder key (GUID) hosting the deployment. The same name can be deployed in several folders, so the folder is part of the identity.").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).examples(DEPLOYMENTS_UPGRADE_EXAMPLES).trackedAction(processContext, async (projectName, deploymentName, options) => {
+    const [err, deployment] = await catchError2((async () => {
+      const config = await createIxpConfig({
+        tenant: options.tenant
+      });
+      return await upgradeDeployment(config, projectName, deploymentName, {
+        modelVersion: options.version,
+        folderKey: options.folderKey
+      });
+    })());
+    if (err) {
+      await emitError(err, "Failed to upgrade deployment");
+      processContext.exit(1);
+      return;
+    }
+    OutputFormatter.success({
+      Result: "Success",
+      Code: "IxpDeploymentsUpgrade",
+      Data: deployment
+    });
+  });
+  deployments.command("list").description("List the project's model deployments, across every version and folder it has been deployed to").argument("<project-name>", "Project name").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).examples(DEPLOYMENTS_LIST_EXAMPLES).trackedAction(processContext, async (projectName, options) => {
+    const [err, response] = await catchError2((async () => {
+      const config = await createIxpConfig({
+        tenant: options.tenant
+      });
+      return await listDeployments(config, projectName);
+    })());
+    if (err) {
+      await emitError(err, "Failed to list deployments");
+      processContext.exit(1);
+      return;
+    }
+    OutputFormatter.success({
+      Result: "Success",
+      Code: "IxpDeploymentsList",
+      Data: response.Deployments ?? []
+    });
+  });
   deployments.command("get-taxonomy").description("Get the project taxonomy (data types + field groups) at a specific trained model version").argument("<project-name>", "Project name").requiredOption("--version <number>", "Trained model version (non-negative integer). Get available versions from `uip ixp projects list-models <project-name> --output json`.", (raw) => parseBoundedInt(raw, "--version", { min: 0, max: 1e6 })).addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).examples(DEPLOYMENTS_GET_TAXONOMY_EXAMPLES).trackedAction(processContext, async (projectName, options) => {
     const [err, taxonomy] = await catchError2((async () => {
       const config = await createIxpConfig({
@@ -7290,6 +7512,10 @@ function buildSingleOccurrenceConfirm(group, options) {
   };
 }
 function buildConfirmBody(options) {
+  const body = buildConfirmTargeting(options);
+  return options.modelVersion === undefined ? body : { ...body, ModelVersion: options.modelVersion };
+}
+function buildConfirmTargeting(options) {
   if (options.updates && options.group) {
     return {
       Group: options.group,
@@ -7570,32 +7796,33 @@ var LABELLINGS_MARK_MISSING_EXAMPLES = [
 ];
 var LABELLINGS_GET_PREDICTIONS_EXAMPLES = [
   {
-    Description: "Get predictions for every document in the project as JSON",
-    Command: "uip ixp labellings get-predictions my-invoices --output json",
+    Description: "Get predictions for a single document",
+    Command: "uip ixp labellings get-predictions my-invoices 5f3a9c21-7e4b-4d8a-9f12-6c0b8e3d2a14.7f3c8a21",
     Output: {
       Code: "IxpLabellingsGetPredictions",
       Data: {
         ProjectName: "my-invoices",
-        TotalDocuments: 12,
-        DocumentsWithPredictions: 10,
+        TotalDocuments: 1,
+        DocumentsWithPredictions: 1,
         Predictions: []
       }
     }
   },
   {
-    Description: "Get predictions for a single document",
-    Command: "uip ixp labellings get-predictions my-invoices 5f3a9c21-7e4b-4d8a-9f12-6c0b8e3d2a14.7f3c8a21",
+    Description: "Deprecated: omit the document id to fetch every document in the project. Removed in the next release — pass a document id instead.",
+    Command: "uip ixp labellings get-predictions my-invoices --output json",
     Output: {
       Code: "IxpLabellingsGetPredictions",
       Data: {
         ProjectName: "my-invoices",
-        TotalDocuments: 1,
-        DocumentsWithPredictions: 1,
+        TotalDocuments: 12,
+        DocumentsWithPredictions: 10,
         Predictions: []
       }
     }
   }
 ];
+var PROJECT_WIDE_DEPRECATION_WARNING = "[WARN] Omitting <document-id> is deprecated and will be removed in the next release. " + "Pass a document id; use `uip ixp documents list` to enumerate them.\n";
 var LIST_PAGE_SIZE = 100;
 async function listAllDocumentIds(config, projectName) {
   const ids = [];
@@ -7616,7 +7843,10 @@ async function listAllDocumentIds(config, projectName) {
 }
 var registerLabellingsCommand = (program2) => {
   const labelling = program2.command("labellings").description("Manage IXP labellings and predictions");
-  labelling.command("confirm").description("Confirm IXP-generated predictions as ground truth. Confirms all documents, or a single document if document-id is provided. For a repeatable field group, narrow with --group: alone it confirms every occurrence; add --occurrence to confirm ONE occurrence (the ergonomic single-line form); or use --updates to confirm SEVERAL occurrences in one atomic call (one request). --updates is the superset — --occurrence <N> equals --updates with a single entry — so reach for --occurrence for one line and --updates when several lines need confirming together (or with different per-line fields/corrections).").argument("<project-name>", "Project name").argument("[document-id]", "Document ID — confirm only this document (omit to confirm all)").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-f, --fields <field-ids>", "Comma-separated field IDs to confirm (omit to confirm all predicted fields). Without --group, confirms each field_id across every occurrence it appears in. With --group + --occurrence, confirms only within that specific occurrence.").option("-c, --corrections <json>", 'Override predicted values while keeping references: [{"field_id":"...","value":"corrected"}]. Applies across every occurrence the field appears in (or just the targeted occurrence when --group + --occurrence are given).').option("--group <name>", 'Target field group (label_def). Must be the FULL label path exactly as shown in the "Name" field of `get-predictions` (e.g. "Invoice > Line Items"), not just the leaf name. On its own, confirms every occurrence of the group as-is. Add --occurrence to target a single occurrence, or --updates to batch specific occurrences in one call. Combine with --fields to limit to specific fields within the group.').option("--occurrence <index>", "Single-occurrence form: 0-based index of ONE occurrence within --group to confirm. Use --fields to limit to specific fields in that occurrence; omit --fields to confirm every predicted field there. Requires --group. Mutually exclusive with --updates — for several occurrences in one call, use --updates instead.").option("--updates <json>", 'Batched form: confirm SEVERAL occurrences of --group in one atomic call. JSON array of {"occurrence":<0-based-index>,"fields"?:["<field_id>",...],"corrections"?:{"<field_id>":"<value>"}}. Per entry: omit "fields" to confirm every predicted field in that occurrence (same default as --occurrence without --fields), or list specific ones. Un-selected fields in a selected occurrence carry forward their existing annotation; occurrences not listed are left as-is. Equivalent to running --occurrence once per entry, but in a single request. Mutually exclusive with --fields, --corrections, and --occurrence.').examples(LABELLINGS_CONFIRM_EXAMPLES).trackedAction(processContext, async (projectName, documentUid, options) => {
+  labelling.command("confirm").description("Confirm IXP-generated predictions as ground truth. Confirms all documents, or a single document if document-id is provided. For a repeatable field group, narrow with --group: alone it confirms every occurrence; add --occurrence to confirm ONE occurrence (the ergonomic single-line form); or use --updates to confirm SEVERAL occurrences in one atomic call (one request). --updates is the superset — --occurrence <N> equals --updates with a single entry — so reach for --occurrence for one line and --updates when several lines need confirming together (or with different per-line fields/corrections).").argument("<project-name>", "Project name").argument("[document-id]", "Document ID — confirm only this document (omit to confirm all)").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-f, --fields <field-ids>", "Comma-separated field IDs to confirm (omit to confirm all predicted fields). Without --group, confirms each field_id across every occurrence it appears in. With --group + --occurrence, confirms only within that specific occurrence.").option("-c, --corrections <json>", 'Override predicted values while keeping references: [{"field_id":"...","value":"corrected"}]. Applies across every occurrence the field appears in (or just the targeted occurrence when --group + --occurrence are given).').option("--group <name>", 'Target field group (label_def). Must be the FULL label path exactly as shown in the "Name" field of `get-predictions` (e.g. "Invoice > Line Items"), not just the leaf name. On its own, confirms every occurrence of the group as-is. Add --occurrence to target a single occurrence, or --updates to batch specific occurrences in one call. Combine with --fields to limit to specific fields within the group.').option("--occurrence <index>", "Single-occurrence form: 0-based index of ONE occurrence within --group to confirm. Use --fields to limit to specific fields in that occurrence; omit --fields to confirm every predicted field there. Requires --group. Mutually exclusive with --updates — for several occurrences in one call, use --updates instead.").option("--updates <json>", 'Batched form: confirm SEVERAL occurrences of --group in one atomic call. JSON array of {"occurrence":<0-based-index>,"fields"?:["<field_id>",...],"corrections"?:{"<field_id>":"<value>"}}. Per entry: omit "fields" to confirm every predicted field in that occurrence (same default as --occurrence without --fields), or list specific ones. Un-selected fields in a selected occurrence carry forward their existing annotation; occurrences not listed are left as-is. Equivalent to running --occurrence once per entry, but in a single request. Mutually exclusive with --fields, --corrections, and --occurrence.').option("-m, --model-version <version>", "Optimistic-concurrency guard: the model version (from `get-predictions`' ModelVersion) the predictions being confirmed were reviewed against. If a retrain has produced a newer version since, the confirm is rejected instead of stamping drifted values as ground truth — re-read predictions and review again. Omit to skip the check.", (raw) => parseBoundedInt(raw, "--model-version", {
+    min: 0,
+    max: Number.MAX_SAFE_INTEGER
+  })).examples(LABELLINGS_CONFIRM_EXAMPLES).trackedAction(processContext, async (projectName, documentUid, options) => {
     const [err, result] = await catchError2((async () => {
       validateConfirmMode(documentUid, options);
       const config = await createIxpConfig({
@@ -7706,7 +7936,10 @@ var registerLabellingsCommand = (program2) => {
       }
     }, { preserveDataKeys: true });
   });
-  labelling.command("get-predictions").description("Get IXP model predictions for documents in a project. Returns predicted labels and field values, plus the ModelVersion that produced them (null when a document has no predictions yet).").argument("<project-name>", "Project name").argument("[document-id]", "Document ID — get predictions for only this document (omit for all)").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).examples(LABELLINGS_GET_PREDICTIONS_EXAMPLES).trackedAction(processContext, async (projectName, documentUid, options) => {
+  labelling.command("get-predictions").description("Get IXP model predictions for documents in a project. Returns predicted labels and field values, plus the ModelVersion that produced them (null when a document has no predictions yet).").argument("<project-name>", "Project name").argument("[document-id]", "Document ID. Omitting it fans out across every document in the project — deprecated, and removed in the next release.").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).examples(LABELLINGS_GET_PREDICTIONS_EXAMPLES).trackedAction(processContext, async (projectName, documentUid, options) => {
+    if (!documentUid) {
+      getOutputSink().writeErr(PROJECT_WIDE_DEPRECATION_WARNING);
+    }
     const [err, result] = await catchError2((async () => {
       const config = await createIxpConfig({
         tenant: options.tenant
@@ -7950,12 +8183,49 @@ var PROJECTS_GET_METRICS_EXAMPLES = [
     Output: {
       Code: "IxpProjectsGetMetrics",
       Data: {
-        Metrics: {
-          ModelVersion: 4,
-          NumValidatedDocuments: 12,
-          ProjectScore: 0.87,
-          ProjectScoreQuality: "Good"
-        }
+        ModelVersion: 35,
+        ValidatedDocuments: 8,
+        ProjectScore: 0.8662574291229248,
+        ProjectScoreQuality: "excellent",
+        FieldGroups: [
+          {
+            FieldGroup: "Invoice",
+            F1: 0.8939051628112793,
+            Precision: 0.824999988079071,
+            Recall: 0.9753694534301758,
+            ErrorRate: 0.1621621549129486,
+            Documents: 8
+          }
+        ],
+        Fields: [
+          {
+            FieldGroup: "Invoice",
+            FieldId: "1e8eadeac608df18",
+            Name: "Invoice Number",
+            F1: 0.875,
+            Precision: 0.875,
+            Recall: 0.875,
+            ErrorRate: 0.125,
+            Documents: 8,
+            Annotations: 8,
+            Quality: "good"
+          }
+        ]
+      }
+    }
+  },
+  {
+    Description: "Get metrics for a specific model version",
+    Command: "uip ixp projects get-metrics my-invoices --model-version 32 --output json",
+    Output: {
+      Code: "IxpProjectsGetMetrics",
+      Data: {
+        ModelVersion: 32,
+        ValidatedDocuments: 2,
+        ProjectScore: 0.8385416865348816,
+        ProjectScoreQuality: "good",
+        FieldGroups: [],
+        Fields: []
       }
     }
   }
@@ -8570,4 +8840,4 @@ var registerCommands = async (program2) => {
 
 export { package_default, Command, metadata, registerCommands };
 
-//# debugId=BE77515DFEEBC05764756E2164756E21
+//# debugId=602E75D2CA2C538164756E2164756E21

package/dist/tool.js

@@ -1,7 +1,7 @@
 import {
   metadata,
   registerCommands
-} from "./tool-jb4q26s4.js";
+} from "./tool-0fw76nep.js";
 import"./tool-9qecd4wb.js";
 import"./tool-7eva0peq.js";
 import"./tool-5arsyj36.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/ixp-tool",
   "license": "MIT",
-  "version": "1.201.0-preview.115",
+  "version": "1.201.0-preview.121",
   "description": "Manage UiPath IXP projects, prompts, predictions, and model publishing.",
   "private": false,
   "repository": {
@@ -26,5 +26,5 @@
   "files": [
     "dist"
   ],
-  "gitHead": "f1086b73654d7728cb71f280588b3e0c77d535fc"
+  "gitHead": "c70ccfc0b12e637441d67df1d212b71d7784b5f8"
 }