@uipath/pm-tool 1.198.0 → 1.199.0-preview.104

package/dist/tool.js

@@ -21230,7 +21230,7 @@ var init_server = __esm(() => {
 var package_default = {
   name: "@uipath/pm-tool",
   license: "MIT",
-  version: "1.198.0",
+  version: "1.199.0-preview.104",
   description: "Process Mining — process apps, transformations, and data ingestion.",
   private: false,
   repository: {
@@ -28087,6 +28087,7 @@ var SKILL_ATTRIBUTION = attributionRecord([
 var KNOWN_SKILL_NAMES = new Set(Object.keys(SKILL_ATTRIBUTION));
 var COMMAND_ATTRIBUTION = commandAttribution([
   ["cli", "troubleshoot", ["uip.feedback"]],
+  ["llm-gateway", "operate", ["uip.llm-gateway"]],
   ["llm-gateway", "operate", ["uip.llm-configuration", "uip.model-hub"]],
   ["context-grounding", "build", ["uip.context-grounding"]],
   ["api-workflow", "build", ["uip.api-workflow"]],
@@ -28310,6 +28311,20 @@ Command.prototype.trackedAction = function(context, fn, properties) {
     telemetry.trackRequestResult(telemetryName, durationMs, success, baseProperties, requestContext);
   });
 };
+
+// ../common/src/confirmation.ts
+function requireConfirmation(flags, operation) {
+  if (flags.yes === true || flags.force === true) {
+    return true;
+  }
+  OutputFormatter.error({
+    Result: RESULTS.Failure,
+    Message: `Confirmation required: this will ${operation} and cannot be undone.`,
+    Instructions: "Re-run with --yes to confirm."
+  });
+  processContext.exit(1);
+  return false;
+}
 // ../common/src/console-guard.ts
 var guardInstalledSlot = singleton("ConsoleGuardInstalled");
 var savedOriginalsSlot = singleton("ConsoleGuardOriginals");
@@ -28433,6 +28448,7 @@ var resolveConfigAsync = async ({
   customAuthority,
   customClientId,
   customClientSecret,
+  customClientAssertion,
   customScopes
 } = {}) => {
   const fileAuth = getAuthFileConfig();
@@ -28458,7 +28474,7 @@ var resolveConfigAsync = async ({
   if (!clientSecret && fileAuth.clientSecret) {
     clientSecret = fileAuth.clientSecret;
   }
-  const isExternalAppAuth = clientId !== DEFAULT_CLIENT_ID && Boolean(clientSecret);
+  const isExternalAppAuth = clientId !== DEFAULT_CLIENT_ID && (Boolean(clientSecret) || Boolean(customClientAssertion));
   const scopes = resolveScopes(isExternalAppAuth, customScopes, fileAuth.scopes);
   return {
     clientId,
@@ -29576,7 +29592,6 @@ var getAuthContext = async (options = {}) => {
     tenantName
   };
 };
-
 // ../auth/src/index.ts
 init_constants();
 
@@ -29651,6 +29666,9 @@ async function pmGet(config, path3) {
 async function pmPost(config, path3, body) {
   return pmRequest(config, "POST", path3, body);
 }
+async function pmDelete(config, path3) {
+  return pmRequest(config, "DELETE", path3);
+}
 async function pmGetRaw(config, path3) {
   const response = await fetch(buildPmUrl(config, path3), {
     method: "GET",
@@ -29685,6 +29703,7 @@ async function pmPutRaw(config, path3, content, etag) {
 }
 
 // src/commands/_shared.ts
+init_src();
 function fail(message, instructions) {
   OutputFormatter.error({
     Result: RESULTS.Failure,
@@ -29713,6 +29732,31 @@ function unwrapData(payload) {
   }
   return payload;
 }
+async function resolveJsonBody(file, inline, flag = "body") {
+  const noun = flag === "filters" ? "filter spec" : "request body";
+  const Noun = flag === "filters" ? "Filter spec" : "Request body";
+  const Label = flag === "filters" ? "Filters" : "Body";
+  if (file !== undefined && inline !== undefined) {
+    throw new Error(`Provide only one of --${flag} or --${flag}-json, not both.`);
+  }
+  let raw;
+  if (file !== undefined) {
+    const content = await getFileSystem().readFile(file, "utf-8");
+    if (content === null) {
+      throw new Error(`${Label} file not found: ${file}`);
+    }
+    raw = String(content);
+  } else if (inline !== undefined) {
+    raw = inline;
+  } else {
+    throw new Error(`A ${noun} is required: pass --${flag} <json-file> or --${flag}-json <json>.`);
+  }
+  const [parseErr, parsed] = catchError(() => JSON.parse(raw));
+  if (parseErr) {
+    throw new Error(`${Noun} is not valid JSON: ${parseErr.message}`);
+  }
+  return parsed;
+}
 
 // src/commands/app-types.ts
 var APP_TYPES_LIST_EXAMPLES = [
@@ -29787,6 +29831,16 @@ var APPS_CREATE_EXAMPLES = [
     }
   }
 ];
+var APPS_DELETE_EXAMPLES = [
+  {
+    Description: "Delete a process app by id",
+    Command: "uip pm apps delete 9c46289e --yes",
+    Output: {
+      Code: "PmAppsDelete",
+      Data: { AppId: "9c46289e", Status: "Deleted" }
+    }
+  }
+];
 function registerAppsCommand(program2) {
   const appsCmd = program2.command("apps").description("Manage Process Mining process apps");
   appsCmd.command("list").description("List process apps").addOption(new Option("--stage <stage>", "App stage to list").choices(STAGES).default("dev")).examples(APPS_LIST_EXAMPLES).trackedAction(processContext, async (options) => {
@@ -29819,6 +29873,23 @@ function registerAppsCommand(program2) {
       Data: { AppId: appId, Name: name, Type: options.type }
     });
   });
+  appsCmd.command("delete <app-id>").description("Delete a process app").option("-y, --yes", "Confirm this irreversible operation (required; the CLI never prompts)").examples(APPS_DELETE_EXAMPLES).trackedAction(processContext, async (appId, options) => {
+    if (!requireConfirmation(options, `delete process app '${appId}'`))
+      return;
+    const config = await loadConfigOrExit();
+    if (!config)
+      return;
+    const [err] = await catchError(pmDelete(config, `/apps/${appId}`));
+    if (err) {
+      fail(err.message, "Check the app id (uip pm apps list).");
+      return;
+    }
+    OutputFormatter.success({
+      Result: "Success",
+      Code: "PmAppsDelete",
+      Data: { AppId: appId, Status: "Deleted" }
+    });
+  });
 }
 async function createApp(config, name, options) {
   let version = options.typeVersion;
@@ -30032,9 +30103,180 @@ function registerIngestionsCommand(program2) {
   });
 }
 
+// src/commands/query.ts
+var STAGES4 = ["dev", "published"];
+var LAYOUT_TYPES = ["graph", "process-model"];
+var QUERY_RUN_EXAMPLES = [
+  {
+    Description: "Run an aggregate query from a JSON body (group-by + metrics)",
+    Command: "uip pm query run 9c46289e --body ./query.json",
+    Output: {
+      Code: "PmQueryRun",
+      Data: {
+        Number_of_cases: { Ungrouped: 1043 }
+      }
+    }
+  }
+];
+var QUERY_RCA_EXAMPLES = [
+  {
+    Description: "Root-cause analysis: which attributes explain the selected set",
+    Command: `uip pm query rca 9c46289e --body-json '{"argument":"Case_ID","exploreAttributes":["Case_type"],"selectedSet":[[{"kind":"values","dimension":"Case_status","type":"string","values":["Open"],"invert":false,"displayType":"list"}]]}'`,
+    Output: {
+      Code: "PmQueryRca",
+      Data: { Data: {}, Warnings: null }
+    }
+  }
+];
+var QUERY_INFO_EXAMPLES = [
+  {
+    Description: "Discover the fields, metrics and processes available for query bodies",
+    Command: "uip pm query info 9c46289e",
+    Output: {
+      Code: "PmQueryInfo",
+      Data: { fields: [], processes: [] }
+    }
+  }
+];
+var QUERY_PERCENTILE_EXAMPLES = [
+  {
+    Description: "Compute the 50th/90th/95th percentiles of case throughput time",
+    Command: "uip pm query percentile 9c46289e --field PF__throughput_time --values 0.5,0.9,0.95",
+    Output: {
+      Code: "PmQueryPercentile",
+      Data: { values: [3600, 86400, 172800] }
+    }
+  }
+];
+function registerQueryCommand(program2) {
+  const queryCmd = program2.command("query").description("Query a process app: aggregate data, details, RCA, insights, " + "percentiles, layout and query metadata");
+  registerBodyQuery(queryCmd, {
+    name: "run",
+    subpath: "",
+    code: "PmQueryRun",
+    summary: "Run an aggregate (group-by + metrics) data query",
+    examples: QUERY_RUN_EXAMPLES,
+    withLimit: true
+  });
+  registerBodyQuery(queryCmd, {
+    name: "details",
+    subpath: "/details",
+    code: "PmQueryDetails",
+    summary: "Run a details (raw table rows) data query",
+    withLimit: true
+  });
+  registerBodyQuery(queryCmd, {
+    name: "rca",
+    subpath: "/rca",
+    code: "PmQueryRca",
+    summary: "Run a root-cause analysis query (body needs a non-empty 'selectedSet')",
+    examples: QUERY_RCA_EXAMPLES,
+    withLimit: true
+  });
+  registerBodyQuery(queryCmd, {
+    name: "insights",
+    subpath: "/processInsights",
+    code: "PmQueryInsights",
+    summary: "Run process insights (body needs 'processId' and 1..10 'metrics')",
+    withLimit: true
+  });
+  queryCmd.command("info <app-id>").description("Get query metadata: the fields, metrics and processes available to build query bodies").addOption(new Option("--stage <stage>", "App stage").choices(STAGES4).default("dev")).examples(QUERY_INFO_EXAMPLES).trackedAction(processContext, async (appId, options) => {
+    const config = await loadConfigOrExit();
+    if (!config)
+      return;
+    const [err, result] = await catchError(pmGet(config, `/query/${appId}/${options.stage}/info`));
+    if (err) {
+      fail(err.message, "Check the app id (uip pm apps list) and that the stage has a completed ingestion.");
+      return;
+    }
+    OutputFormatter.success({
+      Result: "Success",
+      Code: "PmQueryInfo",
+      Data: result
+    });
+  });
+  queryCmd.command("layout <app-id>").description("Get the persisted global graph layout of a process app").addOption(new Option("--type <type>", "Layout to read: the process 'graph' or the 'process-model'").choices(LAYOUT_TYPES).default("graph")).addOption(new Option("--stage <stage>", "App stage").choices(STAGES4).default("dev")).trackedAction(processContext, async (appId, options) => {
+    const config = await loadConfigOrExit();
+    if (!config)
+      return;
+    const endpoint = options.type === "process-model" ? "processModelGlobalLayout" : "graphLayout";
+    const [err, result] = await catchError(pmGet(config, `/query/${appId}/${options.stage}/${endpoint}`));
+    if (err) {
+      fail(err.message, "Check the app id (uip pm apps list) and that the stage has a completed ingestion.");
+      return;
+    }
+    OutputFormatter.success({
+      Result: "Success",
+      Code: "PmQueryLayout",
+      Data: result
+    });
+  });
+  queryCmd.command("percentile <app-id>").description("Compute percentiles of a numeric field").requiredOption("--field <field-id>", "Field id to compute percentiles over (uip pm query info)").requiredOption("--values <list>", "Comma-separated percentile points in 0..1, e.g. '0.5,0.9,0.95'").option("--filters <json-file>", "Path to a JSON file with a filter spec (array of AND-ed filter groups)").option("--filters-json <json>", "Inline JSON filter spec").addOption(new Option("--stage <stage>", "App stage").choices(STAGES4).default("dev")).examples(QUERY_PERCENTILE_EXAMPLES).trackedAction(processContext, async (appId, options) => {
+    const config = await loadConfigOrExit();
+    if (!config)
+      return;
+    const [buildErr, body] = await catchError(buildPercentileBody(options));
+    if (buildErr) {
+      fail(buildErr.message, "Pass --values as comma-separated numbers in 0..1 and a valid --filters/--filters-json spec.");
+      return;
+    }
+    const [err, result] = await catchError(pmPost(config, `/query/${appId}/${options.stage}/percentile`, body));
+    if (err) {
+      fail(err.message, "Check the app id, the field id (uip pm query info) and that the stage has a completed ingestion.");
+      return;
+    }
+    OutputFormatter.success({
+      Result: "Success",
+      Code: "PmQueryPercentile",
+      Data: result
+    });
+  });
+}
+function registerBodyQuery(queryCmd, spec) {
+  const cmd = queryCmd.command(`${spec.name} <app-id>`).description(spec.summary).option("--body <json-file>", "Path to a JSON file with the request body").option("--body-json <json>", "Inline JSON request body").addOption(new Option("--stage <stage>", "App stage").choices(STAGES4).default("dev"));
+  if (spec.withLimit) {
+    cmd.option("--limit <n>", "Max rows to return (server clamps to 1..1000)");
+  }
+  if (spec.examples) {
+    cmd.examples(spec.examples);
+  }
+  cmd.trackedAction(processContext, async (appId, options) => {
+    const config = await loadConfigOrExit();
+    if (!config)
+      return;
+    const [bodyErr, body] = await catchError(resolveJsonBody(options.body, options.bodyJson));
+    if (bodyErr) {
+      fail(bodyErr.message, "Pass the request body with --body <json-file> or --body-json <json>. Use 'uip pm query info' to discover field/metric ids.");
+      return;
+    }
+    const query = options.limit === undefined ? "" : `?limit=${encodeURIComponent(options.limit)}`;
+    const [apiErr, result] = await catchError(pmPost(config, `/query/${appId}/${options.stage}${spec.subpath}${query}`, body));
+    if (apiErr) {
+      fail(apiErr.message, "Check the app id (uip pm apps list), that the stage has a completed ingestion, and the request body shape.");
+      return;
+    }
+    OutputFormatter.success({
+      Result: "Success",
+      Code: spec.code,
+      Data: result
+    });
+  });
+}
+async function buildPercentileBody(options) {
+  const values = options.values.split(",").map((s) => s.trim()).filter((s) => s.length > 0).map(Number);
+  if (values.length === 0 || values.some((v) => !Number.isFinite(v))) {
+    throw new Error(`Invalid --values '${options.values}': expected comma-separated numbers.`);
+  }
+  let filters = [];
+  if (options.filters !== undefined || options.filtersJson !== undefined) {
+    filters = await resolveJsonBody(options.filters, options.filtersJson, "filters");
+  }
+  return { field: options.field, values, filters };
+}
+
 // src/commands/transformations.ts
 init_src();
-var STAGES4 = ["dev", "published"];
+var STAGES5 = ["dev", "published"];
 var TRANSFORMATIONS_RUN_EXAMPLES = [
   {
     Description: "Rebuild a single dbt model and its dependents on dev",
@@ -30057,7 +30299,7 @@ var TRANSFORMATIONS_APPLY_EXAMPLES = [
 ];
 function registerTransformationsCommand(program2) {
   const transformationsCmd = program2.command("transformations").description("Work with the dbt SQL transformations of a process app");
-  transformationsCmd.command("list <app-id>").description("List the transformation files of a process app").addOption(new Option("--stage <stage>", "App stage to read from").choices(STAGES4).default("dev")).trackedAction(processContext, async (appId, options) => {
+  transformationsCmd.command("list <app-id>").description("List the transformation files of a process app").addOption(new Option("--stage <stage>", "App stage to read from").choices(STAGES5).default("dev")).trackedAction(processContext, async (appId, options) => {
     const config = await loadConfigOrExit();
     if (!config)
       return;
@@ -30072,7 +30314,7 @@ function registerTransformationsCommand(program2) {
       Data: result
     });
   });
-  transformationsCmd.command("get <app-id> <path>").description("Get the content of a transformation file").addOption(new Option("--stage <stage>", "App stage").choices(STAGES4).default("dev")).option("--destination <local-file>", "Write content to this local file instead of the output envelope").trackedAction(processContext, async (appId, path3, options) => {
+  transformationsCmd.command("get <app-id> <path>").description("Get the content of a transformation file").addOption(new Option("--stage <stage>", "App stage").choices(STAGES5).default("dev")).option("--destination <local-file>", "Write content to this local file instead of the output envelope").trackedAction(processContext, async (appId, path3, options) => {
     const config = await loadConfigOrExit();
     if (!config)
       return;
@@ -30098,7 +30340,7 @@ function registerTransformationsCommand(program2) {
       }
     });
   });
-  transformationsCmd.command("update <app-id> <path>").description("Update a transformation file from a local file (ETag-safe)").requiredOption("--file <local-file>", "Local file with the new content").addOption(new Option("--stage <stage>", "App stage").choices(STAGES4).default("dev")).trackedAction(processContext, async (appId, path3, options) => {
+  transformationsCmd.command("update <app-id> <path>").description("Update a transformation file from a local file (ETag-safe)").requiredOption("--file <local-file>", "Local file with the new content").addOption(new Option("--stage <stage>", "App stage").choices(STAGES5).default("dev")).trackedAction(processContext, async (appId, path3, options) => {
     const config = await loadConfigOrExit();
     if (!config)
       return;
@@ -30131,7 +30373,7 @@ function registerTransformationsCommand(program2) {
       }
     });
   });
-  transformationsCmd.command("apply <app-id>").description("Re-run the full data transformation on already-ingested data " + "(unlike 'run', which builds only changed dev models)").addOption(new Option("--stage <stage>", "App stage").choices(STAGES4).default("dev")).examples(TRANSFORMATIONS_APPLY_EXAMPLES).trackedAction(processContext, async (appId, options) => {
+  transformationsCmd.command("apply <app-id>").description("Re-run the full data transformation on already-ingested data " + "(unlike 'run', which builds only changed dev models)").addOption(new Option("--stage <stage>", "App stage").choices(STAGES5).default("dev")).examples(TRANSFORMATIONS_APPLY_EXAMPLES).trackedAction(processContext, async (appId, options) => {
     const config = await loadConfigOrExit();
     if (!config)
       return;
@@ -30202,6 +30444,7 @@ var registerCommands = async (program2) => {
   registerAppTypesCommand(program2);
   registerFilesCommand(program2);
   registerIngestionsCommand(program2);
+  registerQueryCommand(program2);
   registerTransformationsCommand(program2);
 };
 export {
@@ -30209,4 +30452,4 @@ export {
   metadata
 };
 
-//# debugId=3A4CE4EA79D9034564756E2164756E21
+//# debugId=2913FEAD0FC843D764756E2164756E21

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/pm-tool",
   "license": "MIT",
-  "version": "1.198.0",
+  "version": "1.199.0-preview.104",
   "description": "Process Mining — process apps, transformations, and data ingestion.",
   "private": false,
   "repository": {
@@ -26,5 +26,5 @@
   "files": [
     "dist"
   ],
-  "gitHead": "1fadf03d7a8dd102742571dff569fdac11808afb"
+  "gitHead": "829a8ab8a25bce5b62c284bd1ddc674d2947f647"
 }