@uipath/insights-tool 1.202.0 → 1.203.0-preview.160

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   Command,
   metadata,
   registerCommands
-} from "./tool-3p5c7e1f.js";
+} from "./tool-fbe8qp2e.js";
 import"./tool-1de529jm.js";
 
 // src/index.ts

package/dist/{tool-3p5c7e1f.js → tool-fbe8qp2e.js}

@@ -2099,8 +2099,9 @@ var require_commander = __commonJS(function(exports) {
 // package.json
 var package_default = {
   name: "@uipath/insights-tool",
+  author: "UiPath",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.202.0",
+  version: "1.203.0-preview.160",
   description: "Query UiPath Insights data — jobs, failures, and performance metrics.",
   private: false,
   repository: {
@@ -2653,7 +2654,7 @@ var UUID_PATTERN = /\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{1
 var EMAIL_PATTERN = /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/g;
 var JWT_PATTERN = /\beyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/g;
 var LONG_TOKEN_PATTERN = /\b[A-Za-z0-9_-]{40,}\b/g;
-var PADDED_BASE64_PATTERN = /[A-Za-z0-9+/]{16,}={1,2}(?![A-Za-z0-9+/=])/g;
+var PADDED_BASE64_PATTERN = /(?<![A-Za-z0-9+/])[A-Za-z0-9+/]{16,}={1,2}(?![A-Za-z0-9+/=])/g;
 var BASE64_WITH_PLUS_PATTERN = /[A-Za-z0-9+/]{40,}/g;
 var USER_HOME_PATTERN = /(?<![A-Za-z0-9._-])([/\\])(Users|home|Profiles)([/\\])([^/\\]+)/gi;
 var UNC_PATH_PATTERN = /(^|[\s"'<>|=,;([{])(\\\\[^\s"'<>|]+)/g;
@@ -2700,7 +2701,7 @@ var QUOTED_LITERAL_PATTERN = new RegExp([
   `(?<![A-Za-z0-9])"(?:[^\\
 ]|\\.){2,${QUOTED_LITERAL_MAX_SPAN}}?"(?![A-Za-z0-9])`
 ].join("|"), "g");
-var JSON_BODY_PATTERN = /[{[][^{}[\]]*[:,][^{}[\]]*[\]}]/g;
+var JSON_BODY_PATTERN = /[{[][^{}[\]:,]*[:,][^{}[\]]*[\]}]/g;
 var COLLAPSED_BODY = "{…}";
 var COLLAPSED_BODY_MARKER = "\x01body\x01";
 var MAX_BODY_NESTING = 8;
@@ -2715,10 +2716,13 @@ function collapseJsonBodies(text) {
   }
   return out.split(COLLAPSED_BODY_MARKER).join(COLLAPSED_BODY);
 }
-var TRAILING_PROSE_PUNCT = /[.,;:!?)\]}>'"]+$/;
+var TRAILING_PROSE_PUNCT = `.,;:!?)]}>'"`;
 function peelTrailingPunctuation(match) {
-  const trailing = match.match(TRAILING_PROSE_PUNCT)?.[0] ?? "";
-  return trailing ? [match.slice(0, -trailing.length), trailing] : [match, ""];
+  let end = match.length;
+  while (end > 0 && TRAILING_PROSE_PUNCT.includes(match[end - 1])) {
+    end -= 1;
+  }
+  return [match.slice(0, end), match.slice(end)];
 }
 function redactUrl(raw) {
   try {
@@ -3462,7 +3466,8 @@ function readRegistryValue(keyPath, valueName) {
   }
   const [error, output] = catchError(() => execFileSync("reg", ["query", keyPath, "/v", valueName], {
     encoding: "utf-8",
-    stdio: ["pipe", "pipe", "pipe"]
+    stdio: ["pipe", "pipe", "pipe"],
+    windowsHide: true
   }));
   if (error) {
     return "";
@@ -4177,28 +4182,32 @@ function isPlainRecord(value) {
   const prototype = Object.getPrototypeOf(value);
   return prototype === Object.prototype || prototype === null;
 }
-function extractPagedRows(value) {
+function splitPagedEnvelope(value) {
   if (Array.isArray(value) || !isPlainRecord(value))
     return null;
-  const entries = Object.values(value);
+  const entries = Object.entries(value);
   if (entries.length === 0)
     return null;
-  let rows = null;
-  let hasScalarSibling = false;
-  for (const entry of entries) {
+  let found = null;
+  const meta = Object.create(null);
+  for (const [key, entry] of entries) {
     if (Array.isArray(entry)) {
-      if (rows !== null)
+      if (found !== null)
         return null;
-      rows = entry;
+      found = { key, rows: entry };
     } else if (entry !== null && typeof entry === "object") {
       return null;
     } else {
-      hasScalarSibling = true;
+      meta[key] = entry;
     }
   }
-  if (rows === null || !hasScalarSibling)
+  if (found === null || Object.keys(meta).length === 0)
     return null;
-  return rows;
+  return { ...found, meta };
+}
+function extractPagedRows(value) {
+  const paged = splitPagedEnvelope(value);
+  return paged === null ? null : paged.rows;
 }
 function toLowerCamelCaseKey(key) {
   if (!key)
@@ -4302,6 +4311,9 @@ function printOutput(data, format = "json", logFn, asciiSafe = false, tableRowSt
       }
       break;
     }
+    case "markdown":
+      logFn(renderMarkdown(data));
+      break;
     default: {
       const hasData = "Data" in data && data.Data != null;
       const pagedRows = hasData ? extractPagedRows(data.Data) : null;
@@ -4326,6 +4338,10 @@ function logOutput(data, format = "json", tableRowStyle) {
   printOutput(data, format, (msg) => sink.writeOut(`${msg}
 `), needsAsciiSafeJson(sink), styleFn);
 }
+var PLUMBING_KEYS = new Set(["code", "log"]);
+function isPlumbingKey(key) {
+  return PLUMBING_KEYS.has(key.toLowerCase());
+}
 function cellToString(val) {
   return val != null && typeof val === "object" ? JSON.stringify(val) : String(val ?? "");
 }
@@ -4341,7 +4357,7 @@ function wrapText(text, width) {
 function printTable(data, logFn, externalLogValue, tableRowStyle) {
   if (data.length === 0)
     return;
-  const keys = Object.keys(data[0]).filter((key) => !["code", "log"].includes(key.toLowerCase()));
+  const keys = Object.keys(data[0]).filter((key) => !isPlumbingKey(key));
   const maxWidths = keys.map((key) => Math.max(key.length, ...data.map((item) => cellToString(item[key]).length)));
   const header = keys.map((key, i) => key.padEnd(maxWidths[i])).join(" | ");
   logFn(header);
@@ -4363,7 +4379,7 @@ function isNonEmptyPlainObject(value) {
 }
 var NESTED_INDENT = "  ";
 function printVerticalTable(data, logFn = console.log, externalLogValue) {
-  const keys = Object.keys(data).filter((key) => !["code", "log"].includes(key.toLowerCase()));
+  const keys = Object.keys(data).filter((key) => !isPlumbingKey(key));
   if (keys.length === 0)
     return;
   const isBlockValue = (value) => isPlainObjectArray(value) || isNonEmptyPlainObject(value);
@@ -4394,7 +4410,7 @@ function printVerticalTable(data, logFn = console.log, externalLogValue) {
 function printResizableTable(data, logFn = console.log, externalLogValue, availableWidth, tableRowStyle) {
   if (data.length === 0)
     return;
-  const keys = Object.keys(data[0]).filter((key) => !["code", "log"].includes(key.toLowerCase()));
+  const keys = Object.keys(data[0]).filter((key) => !isPlumbingKey(key));
   if (keys.length === 0)
     return;
   if (!process.stdout.isTTY) {
@@ -4468,6 +4484,220 @@ function printResizableTable(data, logFn = console.log, externalLogValue, availa
     logFn(`Log: ${externalLogValue}`);
   }
 }
+var MARKDOWN_MAX_CELL = 200;
+var MARKDOWN_MAX_DEPTH = 3;
+function markdownHeading(depth) {
+  return "#".repeat(Math.min(3 + depth, 6));
+}
+var BACKTICK_RUN = /`+/g;
+function fencedBlock(text) {
+  const first = text.trimStart()[0];
+  const language = first === "<" ? "xml" : first === "{" || first === "[" ? "json" : "";
+  const longestRun = Math.max(0, ...Array.from(text.matchAll(BACKTICK_RUN), (match) => match[0].length));
+  const fence = "`".repeat(Math.max(3, longestRun + 1));
+  return `${fence}${language}
+${text}
+${fence}`;
+}
+function collapseNewlineRuns(text) {
+  return text.split(/(\s+)/).map((part, index) => index % 2 === 1 && part.includes(`
+`) ? " " : part).join("");
+}
+function markdownCell(value) {
+  const text = value instanceof Date ? value.toISOString() : cellToString(value);
+  return collapseNewlineRuns(text).replace(/\|/g, "\\|");
+}
+function markdownLabel(key) {
+  return collapseNewlineRuns(key).replace(/[\\`*|]/g, "\\$&");
+}
+function withoutPlumbing(record) {
+  const kept = Object.create(null);
+  for (const [key, value] of Object.entries(record)) {
+    if (!isPlumbingKey(key))
+      kept[key] = value;
+  }
+  return kept;
+}
+function rowsWithoutPlumbing(rows) {
+  return rows.map((row) => isPlainRecord(row) ? withoutPlumbing(row) : row);
+}
+function markdownTable(rows) {
+  const columns = [];
+  const seen = new Set;
+  for (const row of rows) {
+    for (const key of Object.keys(row)) {
+      if (!seen.has(key)) {
+        seen.add(key);
+        columns.push(key);
+      }
+    }
+  }
+  if (columns.length === 0)
+    return null;
+  const cells = rows.map((row) => columns.map((key) => markdownCell(row[key])));
+  if (cells.some((row) => row.some((c) => c.length > MARKDOWN_MAX_CELL))) {
+    return null;
+  }
+  return [
+    `| ${columns.map(markdownLabel).join(" | ")} |`,
+    `| ${columns.map(() => "---").join(" | ")} |`,
+    ...cells.map((row) => `| ${row.join(" | ")} |`)
+  ].join(`
+`);
+}
+function extractMessageSequence(rows) {
+  const messages = [];
+  for (const row of rows) {
+    const message = extractSingleMessage(row);
+    if (message === null)
+      return null;
+    messages.push(message);
+  }
+  return messages.join(`
+
+`);
+}
+function markdownRows(rows, depth) {
+  if (rows.length === 0)
+    return "(none)";
+  if (!isPlainObjectArray(rows)) {
+    return rows.map((item) => `- ${markdownCell(item)}`).join(`
+`);
+  }
+  const prose = extractMessageSequence(rows);
+  if (prose !== null)
+    return prose;
+  const table = markdownTable(rows);
+  if (table !== null)
+    return table;
+  if (depth >= MARKDOWN_MAX_DEPTH) {
+    return fencedBlock(JSON.stringify(rows, null, 2));
+  }
+  return rows.map((row, index) => [
+    `${markdownHeading(depth)} ${index + 1}`,
+    markdownObject(row, depth + 1)
+  ].join(`
+
+`)).join(`
+
+`);
+}
+function markdownObject(obj, depth) {
+  const scalars = [];
+  const blocks = [];
+  for (const [key, value] of Object.entries(obj)) {
+    if (value === undefined)
+      continue;
+    const label = markdownLabel(key);
+    if (Array.isArray(value)) {
+      blocks.push(`${markdownHeading(depth)} ${label}
+
+${markdownRows(value, depth + 1)}`);
+    } else if (isNonEmptyPlainObject(value)) {
+      const nested = depth < MARKDOWN_MAX_DEPTH ? markdownObject(value, depth + 1) : fencedBlock(JSON.stringify(value, null, 2));
+      if (nested !== "") {
+        blocks.push(`${markdownHeading(depth)} ${label}
+
+${nested}`);
+      }
+    } else if (typeof value === "string" && value.includes(`
+`)) {
+      blocks.push(`**${label}:**
+
+${fencedBlock(value)}`);
+    } else {
+      scalars.push(`**${label}:** ${markdownCell(value)}`);
+    }
+  }
+  const sections = scalars.length > 0 ? [scalars.join(`
+`)] : [];
+  sections.push(...blocks);
+  return sections.join(`
+
+`);
+}
+function extractSingleMessage(payload) {
+  if (!isPlainRecord(payload))
+    return null;
+  const keys = Object.keys(payload);
+  if (keys.length !== 1 || keys[0].toLowerCase() !== "message")
+    return null;
+  const value = payload[keys[0]];
+  return typeof value === "string" ? value : null;
+}
+function markdownPayload(payload) {
+  const message = extractSingleMessage(payload);
+  if (message !== null)
+    return message;
+  if (Array.isArray(payload)) {
+    return markdownRows(rowsWithoutPlumbing(payload), 0);
+  }
+  const visible = withoutPlumbing(payload);
+  const paged = splitPagedEnvelope(visible);
+  if (paged !== null) {
+    const meta = markdownObject(paged.meta, 0);
+    const rows = `${markdownHeading(0)} ${markdownLabel(paged.key)}
+
+${markdownRows(rowsWithoutPlumbing(paged.rows), 1)}`;
+    return meta === "" ? rows : `${meta}
+
+${rows}`;
+  }
+  return markdownObject(visible, 0);
+}
+function isPaginationWorthShowing(value) {
+  if (typeof value !== "object" || value === null)
+    return false;
+  const page = value;
+  return page.HasMore === true || typeof page.Offset === "number" && page.Offset > 0;
+}
+function markdownEnvelopeNotes(data) {
+  const envelope = data;
+  const notes = [];
+  const warning = envelope.Warning;
+  if (typeof warning === "string" && warning !== "") {
+    notes.push(`> **Warning:** ${warning}`);
+  }
+  const instructions = envelope.Instructions;
+  if (typeof instructions === "string" && instructions !== "") {
+    notes.push(`> ${instructions}`);
+  }
+  const pagination = envelope.Pagination;
+  if (isPaginationWorthShowing(pagination)) {
+    const body = markdownObject(pagination, 1);
+    if (body !== "") {
+      notes.push(`${markdownHeading(0)} Pagination
+
+${body}`);
+    }
+  }
+  const log = envelope.Log;
+  if (typeof log === "string" && log !== "") {
+    notes.push(`**Log:** ${log}`);
+  }
+  return notes;
+}
+function renderMarkdown(data) {
+  if (data.Result !== RESULTS.Success) {
+    const failure = data;
+    const sections = [`**Failed:** ${failure.Message}`];
+    if (failure.Data != null) {
+      sections.push(markdownPayload(failure.Data));
+    }
+    if (failure.Instructions) {
+      sections.push(`> ${failure.Instructions}`);
+    }
+    return sections.filter((section) => section !== "").join(`
+
+`);
+  }
+  if (!("Data" in data) || data.Data == null) {
+    return markdownObject(withoutPlumbing(data), 0);
+  }
+  return [markdownPayload(data.Data), ...markdownEnvelopeNotes(data)].filter((section) => section !== "").join(`
+
+`);
+}
 function toYaml(data) {
   const codec = getYamlCodec();
   if (!codec) {
@@ -5346,6 +5576,11 @@ var RESERVED_KEYWORDS_LOWER = new Set([
   "writeonly",
   "xor"
 ]);
+// ../common/src/guid.ts
+var GUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isGuid(value) {
+  return GUID_REGEX.test(value);
+}
 // ../common/src/host-global-options.ts
 var HOST_GLOBAL_OPTIONS_WITH_VALUE = [
   "--output",
@@ -5512,8 +5747,9 @@ class InsightsProtocolError extends Error {
 // ../insights-sdk/package.json
 var package_default2 = {
   name: "@uipath/insights-sdk",
+  author: "UiPath",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.202.0",
+  version: "1.203.0-preview.160",
   description: "SDK for the UiPath Insights API — jobs, failures, and performance metrics.",
   repository: {
     type: "git",
@@ -6635,16 +6871,7 @@ var resolveEnvFilePathAsync = async (envFilePath = DEFAULT_ENV_FILENAME, opts) =
     errorMessage: location.source === "absolute" ? `Environment file not found: ${envFilePath}` : `Unable to locate environment file: ${envFilePath}. Run 'uip login' to authenticate.`
   };
 };
-var loadEnvFileAsync = async ({ envPath }) => {
-  const fs2 = getFileSystem();
-  const absolutePath = fs2.path.isAbsolute(envPath) ? envPath : fs2.path.join(fs2.env.cwd(), envPath);
-  if (!await fs2.exists(absolutePath)) {
-    throw new Error(`Environment file not found: ${envPath}`);
-  }
-  const content = await fs2.readFile(absolutePath, "utf-8");
-  if (content === null) {
-    throw new Error(`Environment file not found: ${envPath}`);
-  }
+var parseEnvContent = (content) => {
   const env = {};
   for (const line of content.split(`
 `)) {
@@ -6665,6 +6892,18 @@ var loadEnvFileAsync = async ({ envPath }) => {
   }
   return env;
 };
+var loadEnvFileAsync = async ({ envPath }) => {
+  const fs2 = getFileSystem();
+  const absolutePath = fs2.path.isAbsolute(envPath) ? envPath : fs2.path.join(fs2.env.cwd(), envPath);
+  if (!await fs2.exists(absolutePath)) {
+    throw new Error(`Environment file not found: ${envPath}`);
+  }
+  const content = await fs2.readFile(absolutePath, "utf-8");
+  if (content === null) {
+    throw new Error(`Environment file not found: ${envPath}`);
+  }
+  return parseEnvContent(content);
+};
 var saveEnvFileAsync = async ({
   envPath,
   data,
@@ -7305,6 +7544,27 @@ async function listMachineFilters(config) {
 async function listUsers(config) {
   return requestInsightsRoute(config, "usersList");
 }
+async function getUser(config, userId) {
+  return requestInsightsRoute(config, "usersGet", {
+    pathParams: { userId }
+  });
+}
+async function listRoles(config) {
+  return requestInsightsRoute(config, "rolesList");
+}
+async function getRole(config, roleId) {
+  return requestInsightsRoute(config, "rolesGet", {
+    pathParams: { roleId }
+  });
+}
+async function listGroups(config) {
+  return requestInsightsRoute(config, "groupsList");
+}
+async function getGroup(config, groupId) {
+  return requestInsightsRoute(config, "groupsGet", {
+    pathParams: { groupId }
+  });
+}
 // src/utils/output.ts
 function fail(message, instructions) {
   OutputFormatter.error({
@@ -8256,111 +8516,6 @@ function registerFilterQueuesCommand(program2) {
   });
 }
 
-// src/commands/jobs.ts
-function collect(val, prev) {
-  return prev ? [...prev, val] : [val];
-}
-function parseIntOption(name) {
-  return (val) => {
-    const n = Number.parseInt(val, 10);
-    if (Number.isNaN(n)) {
-      throw new Error(`--${name} must be a number, got: ${val}`);
-    }
-    return n;
-  };
-}
-function addJobsFilterOptions(cmd) {
-  return cmd.addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--time-range <minutes>", "Relative time range in minutes (e.g. 1440 for 1 day, 43200 for 30 days)", parseIntOption("time-range")).option("--started-after <epoch-ms>", "Absolute start time as Unix epoch milliseconds", parseIntOption("started-after")).option("--started-before <epoch-ms>", "Absolute end time as Unix epoch milliseconds", parseIntOption("started-before")).option("--folder-key <guid>", "Folder key filter (repeatable)", collect).option("--process-name <name>", "Process name filter (repeatable)", collect).option("--machine-name <name>", "Machine name filter (repeatable)", collect).option("--timezone-offset <minutes>", "Client timezone offset in minutes from UTC", parseIntOption("timezone-offset"));
-}
-function buildRequestBody(tenantId, options) {
-  const request = { tenantId };
-  if (options.timeRange !== undefined) {
-    request.relativeTimeRange = options.timeRange;
-  }
-  if (options.startedAfter !== undefined) {
-    request.absoluteStartTime = options.startedAfter;
-  }
-  if (options.startedBefore !== undefined) {
-    request.absoluteEndTime = options.startedBefore;
-  }
-  if (options.folderKey) {
-    request.folderFilter = options.folderKey;
-  }
-  if (options.processName) {
-    request.processFilter = options.processName;
-  }
-  if (options.machineName) {
-    request.machineFilter = options.machineName;
-  }
-  if (options.timezoneOffset !== undefined) {
-    request.timezoneOffsetInMinutes = options.timezoneOffset;
-  }
-  return request;
-}
-async function executeJobsEndpoint(options, endpointPath, code) {
-  const hasRelative = options.timeRange !== undefined;
-  const hasAbsolute = options.startedAfter !== undefined && options.startedBefore !== undefined;
-  if (!hasRelative && !hasAbsolute) {
-    OutputFormatter.error({
-      Result: RESULTS.Failure,
-      Message: "A time range is required. Provide --time-range <minutes>, or both --started-after <epoch-ms> and --started-before <epoch-ms>.",
-      Instructions: "Example: --time-range 1440 (last 24 hours) or --time-range 43200 (last 30 days)."
-    });
-    processContext.exit(1);
-    return;
-  }
-  const [configErr, config] = await catchError(createInsightsConfig(options.tenant));
-  if (configErr) {
-    OutputFormatter.error({
-      Result: RESULTS.Failure,
-      Message: configErr.message,
-      Instructions: "Run 'uip login' to authenticate first."
-    });
-    processContext.exit(1);
-    return;
-  }
-  const body = buildRequestBody(config.tenantId, options);
-  const [apiErr, result] = await catchError(insightsPost(config, endpointPath, body));
-  if (apiErr) {
-    OutputFormatter.error({
-      Result: RESULTS.Failure,
-      Message: apiErr.message,
-      Instructions: "Check your authentication, tenant, and filter parameters."
-    });
-    processContext.exit(1);
-    return;
-  }
-  OutputFormatter.success({
-    Result: "Success",
-    Code: code,
-    Data: result
-  });
-}
-function registerJobsCommand(program2) {
-  const jobsCmd = program2.command("jobs").description("Query Insights job execution data");
-  addJobsFilterOptions(jobsCmd.command("summary").description("Get jobs summary: total count, successful count, and average processing time")).trackedAction(processContext, async (options) => {
-    await executeJobsEndpoint(options, "/summary", "InsightsJobsSummary");
-  });
-  addJobsFilterOptions(jobsCmd.command("completed-timeline").description("Get completed jobs over time, grouped by job state")).trackedAction(processContext, async (options) => {
-    await executeJobsEndpoint(options, "/completed-timeline", "InsightsJobsCompletedTimeline");
-  });
-  addJobsFilterOptions(jobsCmd.command("uncompleted-timeline").description("Get uncompleted (running/pending) jobs over time")).trackedAction(processContext, async (options) => {
-    await executeJobsEndpoint(options, "/uncompleted-timeline", "InsightsJobsUncompletedTimeline");
-  });
-  addJobsFilterOptions(jobsCmd.command("top-failures").description("Get processes with the most job failures")).trackedAction(processContext, async (options) => {
-    await executeJobsEndpoint(options, "/top-failures", "InsightsJobsTopFailures");
-  });
-  addJobsFilterOptions(jobsCmd.command("failures-by-reason").description("Get job failures grouped by exception reason")).trackedAction(processContext, async (options) => {
-    await executeJobsEndpoint(options, "/failures-by-reason", "InsightsJobsFailuresByReason");
-  });
-  addJobsFilterOptions(jobsCmd.command("process-details").description("Get detailed per-process job breakdown with counts by state")).trackedAction(processContext, async (options) => {
-    await executeJobsEndpoint(options, "/process-details", "InsightsJobsProcessDetails");
-  });
-  addJobsFilterOptions(jobsCmd.command("failure-details").description("Get detailed failure information for drill-down investigation")).trackedAction(processContext, async (options) => {
-    await executeJobsEndpoint(options, "/failure-details", "InsightsJobsFailureDetails");
-  });
-}
-
 // src/utils/rbac.ts
 class RbacContractError extends Error {
   constructor(message) {
@@ -8370,10 +8525,11 @@ class RbacContractError extends Error {
 }
 var { requireArrayField: requireArrayField2, requireKnownShape: requireKnownShape2 } = createContractGuards((message) => new RbacContractError(message));
 var MANAGEMENT_VIEW_NOTE = "Reading Insights RBAC requires the Insights Management View permission in the active tenant. This route also returns 403 for a session with no user identity, such as one signed in with client credentials, and such a session cannot read Insights RBAC at all.";
-function rbacFamily(subject) {
+function rbacFamily(subject, notFoundExtra = "") {
   return {
     subject,
     forbiddenExtra: MANAGEMENT_VIEW_NOTE,
+    notFoundExtra,
     isContractError: (error) => error instanceof RbacContractError
   };
 }
@@ -8392,10 +8548,15 @@ function unwrapPortalBody(raw, subject) {
   return raw;
 }
 var PRINCIPAL_FIELDS = ["id", "name", "roles"];
+var ROLE_FIELDS = ["id", "name", "actions"];
 var PRINCIPAL_WITHHELD_NOTE = "This view omits email and the nested role IDs. Pass --include-email to include them.";
+function addIncludeEmailOption(cmd) {
+  return cmd.option("--include-email", "Include email addresses and nested role IDs in the output");
+}
 function roleName(role) {
   return typeof role === "string" ? role : pickScalar(asRecord(role)?.name);
 }
+var ROLE_WITHHELD_NOTE = "This view omits the role resource string, which can carry the organization and tenant GUIDs. Pass --include-resource to include it.";
 function safeRole(role) {
   return { name: roleName(role) };
 }
@@ -8423,6 +8584,24 @@ function projectPrincipal(raw, subject, full) {
   }
   return row;
 }
+function projectRole(raw, subject, full) {
+  const dto = asRecord(raw);
+  if (!dto) {
+    throw new RbacContractError(`Insights returned a ${subject} that is not an object`);
+  }
+  const noun = `a ${subject}`;
+  requireKnownShape2(dto, ROLE_FIELDS, noun);
+  const actions = requireArrayField2(dto, "actions", noun);
+  const row = {
+    id: pickScalar(dto.id),
+    name: pickScalar(dto.name),
+    actions: actions.map(pickScalar)
+  };
+  if (full) {
+    row.resource = pickScalar(dto.resource);
+  }
+  return row;
+}
 function projectRowAt(row, index, subject, project, full) {
   try {
     return project(row, subject, full);
@@ -8488,11 +8667,16 @@ function buildListInstructions2(spec, total, returned, hasMore, full) {
     hasMore ? truncatedNote(`a ${spec.noun}`) : ""
   ]);
 }
+function writeRbacGetNotFound(error, family, id) {
+  writeInsightsNotFound(error, `${family.subject} ${id} was not found in the active Insights tenant, or is not visible there.`, joinParts([
+    family.notFoundExtra,
+    "If every Insights RBAC command returns 404, the tenant may not have the Insights Portal service provisioned."
+  ]));
+}
 function writeRbacListNotFound(error, subject) {
   writeInsightsNotFound(error, `The Insights ${subject} list returned HTTP 404.`, "This route cannot miss for data reasons; the active tenant likely does not have the Insights Portal service provisioned. Do not retry until the tenant changes.");
 }
-async function executeRbacList(options, fetchList, family, spec) {
-  const full = options.includeEmail === true;
+async function executeRbacList(options, fetchList, family, spec, full) {
   await executeInsightsList(options, fetchList, {
     code: spec.code,
     family,
@@ -8507,22 +8691,223 @@ async function executeRbacList(options, fetchList, family, spec) {
     }
   });
 }
+async function executeRbacGet(id, fetchOne, family, spec, full) {
+  await executeInsightsGet((config) => fetchOne(config, id), {
+    code: spec.code,
+    family,
+    project: (response) => spec.project(unwrapPortalBody(response, family.subject), family.subject, full),
+    instructions: () => joinParts([spec.standingNote, full ? "" : spec.withheldNote]),
+    onHttpError: (error) => {
+      if (error.status !== 404) {
+        return false;
+      }
+      writeRbacGetNotFound(error, family, id);
+      return true;
+    }
+  });
+}
+var requireRbacGuid = (noun, discoveryCommand) => (value) => {
+  if (isGuid(value)) {
+    return true;
+  }
+  failValidation(`${noun}-id must be a GUID.`, `Run '${discoveryCommand}' to find a ${noun} ID.`);
+  return false;
+};
+
+// src/commands/groups.ts
+var requireGroupGuid = requireRbacGuid("group", "uip insights groups list");
+var GROUPS_LIST_NOTE = "Roles shown are the group's Insights roles in the active tenant, by name; 'uip insights roles list' maps a role name to its role GUID and back. Directory filtering can omit unresolved groups, so a missing row is not proof the stored group does not exist. Listing groups resolves each row through the directory, one cached call per group in sequence. 'uip insights groups get' returns the same fields as a row here and can persist refreshed directory name and email fields for the group, so read the row here when it is enough.";
+var GROUPS_EMPTY_NOTE = "Directory filtering can omit unresolved groups, so a missing row is not proof the stored group does not exist. Listing groups resolves each row through the directory, one cached call per group in sequence.";
+var GROUPS_GET_NOTE = "Roles shown are the group's Insights roles in the active tenant, by name; 'uip insights roles list' maps a role name to its role GUID and back. This command can persist refreshed directory name and email fields for the group. It is read-shaped but not a pure read.";
+var GROUPS_NOT_FOUND_EXTRA = "A group the directory cannot resolve also returns 404, so this is not proof the stored group does not exist.";
+var GROUPS_FAMILY = rbacFamily("Group", GROUPS_NOT_FOUND_EXTRA);
+function registerGroupsCommand(program2) {
+  const groupsCmd = program2.command("groups").description("Read the Insights groups of the active tenant");
+  addIncludeEmailOption(addListPaginationOptions(groupsCmd.command("list").description("List tenant groups visible to the current caller, with their Insights role names; directory filtering can omit unresolved groups, and each row costs a cached directory call"))).trackedAction(processContext, async (options) => {
+    await executeRbacList(options, listGroups, GROUPS_FAMILY, {
+      code: "InsightsGroupsList",
+      project: projectPrincipal,
+      standingNote: GROUPS_LIST_NOTE,
+      withheldNote: PRINCIPAL_WITHHELD_NOTE,
+      emptyNote: GROUPS_EMPTY_NOTE,
+      noun: "group"
+    }, options.includeEmail === true);
+  });
+  addIncludeEmailOption(groupsCmd.command("get").description("Get one Insights group by its GUID; this can persist refreshed directory name and email fields").argument("<group-id>", "Group GUID")).trackedAction(processContext, async (groupId, options) => {
+    if (!requireGroupGuid(groupId)) {
+      return;
+    }
+    await executeRbacGet(groupId, getGroup, GROUPS_FAMILY, {
+      code: "InsightsGroupGet",
+      project: projectPrincipal,
+      standingNote: GROUPS_GET_NOTE,
+      withheldNote: PRINCIPAL_WITHHELD_NOTE
+    }, options.includeEmail === true);
+  });
+}
+
+// src/commands/jobs.ts
+function collect(val, prev) {
+  return prev ? [...prev, val] : [val];
+}
+function parseIntOption(name) {
+  return (val) => {
+    const n = Number.parseInt(val, 10);
+    if (Number.isNaN(n)) {
+      throw new Error(`--${name} must be a number, got: ${val}`);
+    }
+    return n;
+  };
+}
+function addJobsFilterOptions(cmd) {
+  return cmd.addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--time-range <minutes>", "Relative time range in minutes (e.g. 1440 for 1 day, 43200 for 30 days)", parseIntOption("time-range")).option("--started-after <epoch-ms>", "Absolute start time as Unix epoch milliseconds", parseIntOption("started-after")).option("--started-before <epoch-ms>", "Absolute end time as Unix epoch milliseconds", parseIntOption("started-before")).option("--folder-key <guid>", "Folder key filter (repeatable)", collect).option("--process-name <name>", "Process name filter (repeatable)", collect).option("--machine-name <name>", "Machine name filter (repeatable)", collect).option("--timezone-offset <minutes>", "Client timezone offset in minutes from UTC", parseIntOption("timezone-offset"));
+}
+function buildRequestBody(tenantId, options) {
+  const request = { tenantId };
+  if (options.timeRange !== undefined) {
+    request.relativeTimeRange = options.timeRange;
+  }
+  if (options.startedAfter !== undefined) {
+    request.absoluteStartTime = options.startedAfter;
+  }
+  if (options.startedBefore !== undefined) {
+    request.absoluteEndTime = options.startedBefore;
+  }
+  if (options.folderKey) {
+    request.folderFilter = options.folderKey;
+  }
+  if (options.processName) {
+    request.processFilter = options.processName;
+  }
+  if (options.machineName) {
+    request.machineFilter = options.machineName;
+  }
+  if (options.timezoneOffset !== undefined) {
+    request.timezoneOffsetInMinutes = options.timezoneOffset;
+  }
+  return request;
+}
+async function executeJobsEndpoint(options, endpointPath, code) {
+  const hasRelative = options.timeRange !== undefined;
+  const hasAbsolute = options.startedAfter !== undefined && options.startedBefore !== undefined;
+  if (!hasRelative && !hasAbsolute) {
+    OutputFormatter.error({
+      Result: RESULTS.Failure,
+      Message: "A time range is required. Provide --time-range <minutes>, or both --started-after <epoch-ms> and --started-before <epoch-ms>.",
+      Instructions: "Example: --time-range 1440 (last 24 hours) or --time-range 43200 (last 30 days)."
+    });
+    processContext.exit(1);
+    return;
+  }
+  const [configErr, config] = await catchError(createInsightsConfig(options.tenant));
+  if (configErr) {
+    OutputFormatter.error({
+      Result: RESULTS.Failure,
+      Message: configErr.message,
+      Instructions: "Run 'uip login' to authenticate first."
+    });
+    processContext.exit(1);
+    return;
+  }
+  const body = buildRequestBody(config.tenantId, options);
+  const [apiErr, result] = await catchError(insightsPost(config, endpointPath, body));
+  if (apiErr) {
+    OutputFormatter.error({
+      Result: RESULTS.Failure,
+      Message: apiErr.message,
+      Instructions: "Check your authentication, tenant, and filter parameters."
+    });
+    processContext.exit(1);
+    return;
+  }
+  OutputFormatter.success({
+    Result: "Success",
+    Code: code,
+    Data: result
+  });
+}
+function registerJobsCommand(program2) {
+  const jobsCmd = program2.command("jobs").description("Query Insights job execution data");
+  addJobsFilterOptions(jobsCmd.command("summary").description("Get jobs summary: total count, successful count, and average processing time")).trackedAction(processContext, async (options) => {
+    await executeJobsEndpoint(options, "/summary", "InsightsJobsSummary");
+  });
+  addJobsFilterOptions(jobsCmd.command("completed-timeline").description("Get completed jobs over time, grouped by job state")).trackedAction(processContext, async (options) => {
+    await executeJobsEndpoint(options, "/completed-timeline", "InsightsJobsCompletedTimeline");
+  });
+  addJobsFilterOptions(jobsCmd.command("uncompleted-timeline").description("Get uncompleted (running/pending) jobs over time")).trackedAction(processContext, async (options) => {
+    await executeJobsEndpoint(options, "/uncompleted-timeline", "InsightsJobsUncompletedTimeline");
+  });
+  addJobsFilterOptions(jobsCmd.command("top-failures").description("Get processes with the most job failures")).trackedAction(processContext, async (options) => {
+    await executeJobsEndpoint(options, "/top-failures", "InsightsJobsTopFailures");
+  });
+  addJobsFilterOptions(jobsCmd.command("failures-by-reason").description("Get job failures grouped by exception reason")).trackedAction(processContext, async (options) => {
+    await executeJobsEndpoint(options, "/failures-by-reason", "InsightsJobsFailuresByReason");
+  });
+  addJobsFilterOptions(jobsCmd.command("process-details").description("Get detailed per-process job breakdown with counts by state")).trackedAction(processContext, async (options) => {
+    await executeJobsEndpoint(options, "/process-details", "InsightsJobsProcessDetails");
+  });
+  addJobsFilterOptions(jobsCmd.command("failure-details").description("Get detailed failure information for drill-down investigation")).trackedAction(processContext, async (options) => {
+    await executeJobsEndpoint(options, "/failure-details", "InsightsJobsFailureDetails");
+  });
+}
+
+// src/commands/roles.ts
+var ROLES_FAMILY = rbacFamily("Role");
+var requireRoleGuid = requireRbacGuid("role", "uip insights roles list");
+var ROLES_LIST_NOTE = "Role names can be entitlement-filtered: a role missing from this list can still exist and 'roles get' can still resolve it. Listing roles can trigger a cached entitlement call to Licensing. 'uip insights users list' and 'uip insights groups list' show these roles by name on each principal's row.";
+var INCLUDE_RESOURCE_DESCRIPTION = "Include the role resource string, which can carry the organization and tenant GUIDs, in the output";
+function registerRolesCommand(program2) {
+  const rolesCmd = program2.command("roles").description("Read the Insights roles of the active tenant");
+  addListPaginationOptions(rolesCmd.command("list").description("List Insights roles visible to the current caller; the list can be entitlement-filtered and can trigger a cached Licensing call")).option("--include-resource", INCLUDE_RESOURCE_DESCRIPTION).trackedAction(processContext, async (options) => {
+    await executeRbacList(options, listRoles, ROLES_FAMILY, {
+      code: "InsightsRolesList",
+      project: projectRole,
+      standingNote: ROLES_LIST_NOTE,
+      withheldNote: ROLE_WITHHELD_NOTE,
+      emptyNote: ROLES_LIST_NOTE,
+      noun: "role"
+    }, options.includeResource === true);
+  });
+  rolesCmd.command("get").description("Get one Insights role by its GUID; the list's entitlement filter does not apply here").argument("<role-id>", "Role GUID").option("--include-resource", INCLUDE_RESOURCE_DESCRIPTION).trackedAction(processContext, async (roleId, options) => {
+    if (!requireRoleGuid(roleId)) {
+      return;
+    }
+    await executeRbacGet(roleId, getRole, ROLES_FAMILY, {
+      code: "InsightsRoleGet",
+      project: projectRole,
+      standingNote: "",
+      withheldNote: ROLE_WITHHELD_NOTE
+    }, options.includeResource === true);
+  });
+}
 
 // src/commands/users.ts
 var USERS_FAMILY = rbacFamily("User");
-var USERS_LIST_NOTE = "Roles shown are the user's Insights roles in the active tenant, by name. A user's row is kept even when directory enrichment fails.";
+var requireUserGuid = requireRbacGuid("user", "uip insights users list");
+var USERS_STANDING_NOTE = "Roles shown are the user's Insights roles in the active tenant, by name; 'uip insights roles list' maps a role name to its role GUID and back. A user's row is kept even when directory enrichment fails.";
 var USERS_EMPTY_NOTE = "A user's row is kept even when directory enrichment fails.";
 function registerUsersCommand(program2) {
   const usersCmd = program2.command("users").description("Read the Insights users of the active tenant");
-  addListPaginationOptions(usersCmd.command("list").description("List tenant users visible to the current caller, with their Insights role names")).option("--include-email", "Include email addresses and nested role IDs in the output").trackedAction(processContext, async (options) => {
+  addIncludeEmailOption(addListPaginationOptions(usersCmd.command("list").description("List tenant users visible to the current caller, with their Insights role names"))).trackedAction(processContext, async (options) => {
     await executeRbacList(options, listUsers, USERS_FAMILY, {
       code: "InsightsUsersList",
       project: projectPrincipal,
-      standingNote: USERS_LIST_NOTE,
+      standingNote: USERS_STANDING_NOTE,
       withheldNote: PRINCIPAL_WITHHELD_NOTE,
       emptyNote: USERS_EMPTY_NOTE,
       noun: "user"
-    });
+    }, options.includeEmail === true);
+  });
+  addIncludeEmailOption(usersCmd.command("get").description("Get one Insights user by its GUID").argument("<user-id>", "User GUID")).trackedAction(processContext, async (userId, options) => {
+    if (!requireUserGuid(userId)) {
+      return;
+    }
+    await executeRbacGet(userId, getUser, USERS_FAMILY, {
+      code: "InsightsUserGet",
+      project: projectPrincipal,
+      standingNote: USERS_STANDING_NOTE,
+      withheldNote: PRINCIPAL_WITHHELD_NOTE
+    }, options.includeEmail === true);
   });
 }
 
@@ -8543,8 +8928,10 @@ var registerCommands = async (program2) => {
   registerAlertHistoryCommand(program2);
   registerAlertDeliveriesCommand(program2);
   registerUsersCommand(program2);
+  registerRolesCommand(program2);
+  registerGroupsCommand(program2);
 };
 
 export { Command, metadata, registerCommands };
 
-//# debugId=E78622C84BE6AF4264756E2164756E21
+//# debugId=25297FC5873E6B7264756E2164756E21

package/dist/tool.js

@@ -1,7 +1,7 @@
 import {
   metadata,
   registerCommands
-} from "./tool-3p5c7e1f.js";
+} from "./tool-fbe8qp2e.js";
 import"./tool-1de529jm.js";
 export {
   metadata,

package/package.json

@@ -1,7 +1,8 @@
 {
     "name": "@uipath/insights-tool",
+    "author": "UiPath",
     "license": "SEE LICENSE IN LICENSE.txt",
-    "version": "1.202.0",
+    "version": "1.203.0-preview.160",
     "description": "Query UiPath Insights data — jobs, failures, and performance metrics.",
     "private": false,
     "repository": {
@@ -26,5 +27,5 @@
     "files": [
         "dist"
     ],
-    "gitHead": "23b5a7038ead7264439af18f8b807c7cc99a29d5"
+    "gitHead": "3a42062ba731afca4595ba9aa8a80afc9667528d"
 }