@uipath/insights-sdk 1.204.0 → 1.205.0-preview.258

package/dist/index.browser.js

@@ -287,6 +287,19 @@ var KNOWN_ERROR_LABELS = new Set([
   DASHBOARD_NOT_FOUND_LABEL,
   MODEL_NOT_FOUND_LABEL
 ]);
+var PORTAL_ERROR_CODE = {
+  InvalidUserInput: 6,
+  LookerUnavailableError: 8,
+  PermissionsUserUnauthorized: 10,
+  UnableToGetEmbedLink: 23,
+  UnableToRetrieveDashboards: 26
+};
+var LOOKER_USER_UNAVAILABLE_MESSAGE = "Unable to get Looker userInfo";
+var LOOKER_NO_DASHBOARDS_MESSAGE = "Unable to retrieve dashboards";
+var KNOWN_PORTAL_ERROR_MESSAGES = new Set([
+  LOOKER_USER_UNAVAILABLE_MESSAGE,
+  LOOKER_NO_DASHBOARDS_MESSAGE
+]);
 
 class InsightsHttpError extends Error {
   status;
@@ -385,7 +398,9 @@ var ErrorDimensions = {
   Result: "Result",
   ErrorCode: "ErrorCode",
   Retry: "Retry",
-  ErrorMessage: "ErrorMessage"
+  ErrorMessage: "ErrorMessage",
+  HttpStatus: "HttpStatus",
+  UpstreamErrorCode: "UpstreamErrorCode"
 };
 var AuthDimensions = {
   AuthenticationMethod: "AuthenticationMethod",
@@ -489,7 +504,7 @@ var package_default = {
   name: "@uipath/insights-sdk",
   author: "UiPath",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.204.0",
+  version: "1.205.0-preview.258",
   description: "SDK for the UiPath Insights API — jobs, failures, and performance metrics.",
   repository: {
     type: "git",
@@ -694,6 +709,16 @@ var INSIGHTS_ROUTES = {
     method: "POST",
     template: "Authorization/tenant/insights"
   },
+  lookerDashboardsList: {
+    service: "portal",
+    method: "GET",
+    template: "AllDashboards/folders"
+  },
+  lookerDashboardEmbedUrl: {
+    service: "portal",
+    method: "POST",
+    template: "DashboardUrl"
+  },
   exportConfigurationsList: {
     service: "portal",
     method: "GET",
@@ -795,9 +820,43 @@ function buildServiceHeaders(config, route, hasBody) {
   return headers;
 }
 var MODEL_PATH_PATTERN = /^[A-Za-z0-9_.[\]]{1,200}$/;
+var MAX_PORTAL_ERROR_CODE = 999;
+function isJsonObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readPortalErrorCode(error) {
+  if (!isJsonObject(error)) {
+    return;
+  }
+  const code = error.errorCode;
+  if (typeof code !== "number" || !Number.isInteger(code) || code < 0 || code > MAX_PORTAL_ERROR_CODE) {
+    return;
+  }
+  return code;
+}
+function readPortalErrorMessage(error) {
+  if (!isJsonObject(error)) {
+    return;
+  }
+  const message = error.message;
+  if (typeof message !== "string" || !KNOWN_PORTAL_ERROR_MESSAGES.has(message)) {
+    return;
+  }
+  return message;
+}
+function liftPortalError(hint, error) {
+  const portalErrorCode = readPortalErrorCode(error);
+  if (portalErrorCode !== undefined) {
+    hint.portalErrorCode = portalErrorCode;
+  }
+  const portalErrorMessage = readPortalErrorMessage(error);
+  if (portalErrorMessage !== undefined) {
+    hint.portalErrorMessage = portalErrorMessage;
+  }
+}
 function describeJsonErrorBody(parsed) {
   if (typeof parsed === "string") {
-    return { shape: "string" };
+    return describeStringErrorBody(parsed);
   }
   if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
     return { shape: "other" };
@@ -817,6 +876,19 @@ function describeJsonErrorBody(parsed) {
       hint.firstInvalidField = firstKey;
     }
   }
+  liftPortalError(hint, record.error);
+  return hint;
+}
+function describeStringErrorBody(parsed) {
+  const hint = { shape: "string" };
+  const [parseError, inner] = catchError(() => JSON.parse(parsed));
+  if (parseError) {
+    return hint;
+  }
+  if (!isJsonObject(inner)) {
+    return hint;
+  }
+  liftPortalError(hint, inner.error);
   return hint;
 }
 function describeErrorBody(text) {
@@ -1410,6 +1482,151 @@ async function listQueueFilters(config) {
 async function listMachineFilters(config) {
   return listFilters(config, "filtersAllMachines", isMachineFiltersResponse, "machine filters");
 }
+// src/looker-dashboards.ts
+var TEMPLATE_ID_DELIMITER = "::";
+var INTEGER_ID_PATTERN = /^\d+$/;
+var LOOKER_FOLDERS = [
+  "personal",
+  "tenant",
+  "templates",
+  "organization"
+];
+var LOOKER_THEMES = ["light", "dark"];
+async function listLookerDashboards(config) {
+  return requestInsightsRoute(config, "lookerDashboardsList");
+}
+async function getLookerDashboardEmbedUrl(config, options) {
+  const dashboardId = options.dashboardId.trim();
+  if (dashboardId === "") {
+    throw new Error("Insights Looker dashboard id must not be empty.");
+  }
+  if (!isDashboardId(dashboardId)) {
+    throw new Error("Insights Looker dashboard id must be all digits or contain '::'; resolve a title with resolveLookerDashboard first.");
+  }
+  if (!LOOKER_THEMES.includes(options.theme)) {
+    throw new Error(`Insights Looker theme must be one of ${LOOKER_THEMES.join(", ")}.`);
+  }
+  const locale = options.localization?.trim();
+  if (locale === "") {
+    throw new Error("Insights Looker localization must not be empty.");
+  }
+  return requestInsightsRoute(config, "lookerDashboardEmbedUrl", {
+    body: {
+      dashboardId,
+      theme: options.theme,
+      ...locale === undefined ? {} : { locale }
+    }
+  });
+}
+function parseLookerEnvelope(raw, routeKey) {
+  const endpoint = insightsRouteTemplate(routeKey);
+  if (typeof raw !== "string") {
+    throw new InsightsProtocolError(endpoint, "the body is not the JSON string literal this root answers with");
+  }
+  const [parseError, envelope] = catchError(() => JSON.parse(raw));
+  if (parseError) {
+    throw new InsightsProtocolError(endpoint, "the body string does not hold JSON");
+  }
+  if (!isJsonObject(envelope)) {
+    throw new InsightsProtocolError(endpoint, "the body string does not hold an object");
+  }
+  if (typeof envelope.isSuccess !== "boolean") {
+    throw new InsightsProtocolError(endpoint, "the body carries no boolean isSuccess");
+  }
+  if (envelope.isSuccess !== true) {
+    throw new InsightsProtocolError(endpoint, "the body reports isSuccess false inside a success status");
+  }
+  if (envelope.result === undefined || envelope.result === null) {
+    throw new InsightsProtocolError(endpoint, "the body carries no result");
+  }
+  return envelope.result;
+}
+
+class LookerResolveError extends Error {
+  kind;
+  candidates;
+  constructor(kind, message, candidates = []) {
+    super(message);
+    this.name = "LookerResolveError";
+    this.kind = kind;
+    this.candidates = candidates;
+  }
+}
+function isDashboardId(value) {
+  return INTEGER_ID_PATTERN.test(value) || value.includes(TEMPLATE_ID_DELIMITER);
+}
+function isLookerTemplateDashboardId(id) {
+  return !INTEGER_ID_PATTERN.test(id);
+}
+function readLookerListing(raw) {
+  const endpoint = insightsRouteTemplate("lookerDashboardsList");
+  const folders = parseLookerEnvelope(raw, "lookerDashboardsList");
+  if (!isJsonObject(folders)) {
+    throw new InsightsProtocolError(endpoint, "the result is not an object");
+  }
+  const listing = { rows: [], omittedFolders: [] };
+  for (const folder of LOOKER_FOLDERS) {
+    const group = readFolderGroup(folders[folder], folder, endpoint);
+    if (group === null) {
+      listing.omittedFolders.push(folder);
+      continue;
+    }
+    for (const element of group) {
+      listing.rows.push(readListingRow(element, folder, endpoint));
+    }
+  }
+  return listing;
+}
+function readFolderGroup(group, folder, endpoint) {
+  if (group === undefined) {
+    throw new InsightsProtocolError(endpoint, `the result carries no ${folder} key`);
+  }
+  if (group === null) {
+    return null;
+  }
+  if (!Array.isArray(group)) {
+    throw new InsightsProtocolError(endpoint, `the result's ${folder} is neither an array nor null`);
+  }
+  return group;
+}
+function readListingRow(record, folder, endpoint) {
+  if (!isJsonObject(record)) {
+    throw new InsightsProtocolError(endpoint, `a row in the ${folder} folder is not an object`);
+  }
+  if (typeof record.id !== "string") {
+    throw new InsightsProtocolError(endpoint, `a row in the ${folder} folder has no string id`);
+  }
+  if (record.title !== null && typeof record.title !== "string") {
+    throw new InsightsProtocolError(endpoint, `a row in the ${folder} folder has a title that is neither a string nor null`);
+  }
+  return { folder, id: record.id, title: record.title, record };
+}
+async function resolveLookerDashboard(config, value) {
+  const trimmed = value.trim();
+  if (trimmed === "") {
+    throw new Error("Insights Looker dashboard must not be empty.");
+  }
+  if (isDashboardId(trimmed)) {
+    return { id: trimmed, resolvedFrom: "id" };
+  }
+  const { rows } = readLookerListing(await listLookerDashboards(config));
+  const matches = rows.filter((row) => row.title?.trim() === trimmed);
+  if (matches.length === 0) {
+    throw new LookerResolveError("notFound", "No Looker dashboard with that title is listed for this session.");
+  }
+  for (const match of matches) {
+    requireEmbeddableId(match);
+  }
+  if (matches.length > 1) {
+    throw new LookerResolveError("ambiguous", `${matches.length} Looker dashboards share that title.`, matches.map((row) => ({ folder: row.folder, id: row.id })));
+  }
+  return { id: matches[0].id, resolvedFrom: "title" };
+}
+function requireEmbeddableId(row) {
+  if (!isDashboardId(row.id)) {
+    throw new InsightsProtocolError(insightsRouteTemplate("lookerDashboardsList"), `a row in the ${row.folder} folder has an id that is neither all digits nor contains '::'`);
+  }
+}
 // src/machines.ts
 function isNullish(value) {
   return value === undefined || value === null;
@@ -1667,10 +1884,16 @@ export {
   InsightsHttpError,
   InsightsNetworkError,
   InsightsProtocolError,
+  LOOKER_FOLDERS,
+  LOOKER_NO_DASHBOARDS_MESSAGE,
+  LOOKER_THEMES,
+  LOOKER_USER_UNAVAILABLE_MESSAGE,
+  LookerResolveError,
   MAESTRO_CASE_DASHBOARD_PREFIX,
   MAESTRO_DASHBOARD_SOURCE_TYPE,
   MAESTRO_PROCESS_DASHBOARD_PREFIX,
   MODEL_NOT_FOUND_LABEL,
+  PORTAL_ERROR_CODE,
   UPDATE_BACKEND_FAILURE_LABEL,
   VALIDATION_FAILED_LABEL,
   checkAlertEntitlement,
@@ -1686,6 +1909,7 @@ export {
   getDashboardTemplate,
   getDefaultDelivery,
   getGroup,
+  getLookerDashboardEmbedUrl,
   getMachineAvailabilityTimeline,
   getMachineDetails,
   getMachineRuntimeMix,
@@ -1704,6 +1928,7 @@ export {
   getRole,
   getUser,
   insightsPost,
+  isLookerTemplateDashboardId,
   isTemplateKeyedDashboardId,
   listAgenticAlertDefinitions,
   listAlertDefinitions,
@@ -1712,15 +1937,19 @@ export {
   listExportConfigurations,
   listFolderFilters,
   listGroups,
+  listLookerDashboards,
   listMachineFilters,
   listProcessFilters,
   listQueueFilters,
   listRoles,
   listUsers,
   parseDashboardSlotId,
+  parseLookerEnvelope,
+  readLookerListing,
+  resolveLookerDashboard,
   updateDashboard,
   verifyAllExportDestinations,
   verifyExportDestination
 };
 
-//# debugId=C5DF46655A2261CE64756E2164756E21
+//# debugId=54A108C36D39344C64756E2164756E21

package/dist/index.js

@@ -883,6 +883,16 @@ class NodeFileSystem {
   async rename(oldPath, newPath) {
     await fs6.rename(oldPath, newPath);
   }
+  async isSymbolicLink(filePath) {
+    try {
+      return (await fs6.lstat(filePath)).isSymbolicLink();
+    } catch (error) {
+      if (this.isEnoent(error) || this.hasErrnoCode(error, "ENOTDIR")) {
+        return false;
+      }
+      throw error;
+    }
+  }
   async realpath(filePath) {
     try {
       return await fs6.realpath(filePath);
@@ -1227,6 +1237,19 @@ var KNOWN_ERROR_LABELS = new Set([
   DASHBOARD_NOT_FOUND_LABEL,
   MODEL_NOT_FOUND_LABEL
 ]);
+var PORTAL_ERROR_CODE = {
+  InvalidUserInput: 6,
+  LookerUnavailableError: 8,
+  PermissionsUserUnauthorized: 10,
+  UnableToGetEmbedLink: 23,
+  UnableToRetrieveDashboards: 26
+};
+var LOOKER_USER_UNAVAILABLE_MESSAGE = "Unable to get Looker userInfo";
+var LOOKER_NO_DASHBOARDS_MESSAGE = "Unable to retrieve dashboards";
+var KNOWN_PORTAL_ERROR_MESSAGES = new Set([
+  LOOKER_USER_UNAVAILABLE_MESSAGE,
+  LOOKER_NO_DASHBOARDS_MESSAGE
+]);
 
 class InsightsHttpError extends Error {
   status;
@@ -1325,7 +1348,9 @@ var ErrorDimensions = {
   Result: "Result",
   ErrorCode: "ErrorCode",
   Retry: "Retry",
-  ErrorMessage: "ErrorMessage"
+  ErrorMessage: "ErrorMessage",
+  HttpStatus: "HttpStatus",
+  UpstreamErrorCode: "UpstreamErrorCode"
 };
 var AuthDimensions = {
   AuthenticationMethod: "AuthenticationMethod",
@@ -1429,7 +1454,7 @@ var package_default = {
   name: "@uipath/insights-sdk",
   author: "UiPath",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.204.0",
+  version: "1.205.0-preview.258",
   description: "SDK for the UiPath Insights API — jobs, failures, and performance metrics.",
   repository: {
     type: "git",
@@ -1634,6 +1659,16 @@ var INSIGHTS_ROUTES = {
     method: "POST",
     template: "Authorization/tenant/insights"
   },
+  lookerDashboardsList: {
+    service: "portal",
+    method: "GET",
+    template: "AllDashboards/folders"
+  },
+  lookerDashboardEmbedUrl: {
+    service: "portal",
+    method: "POST",
+    template: "DashboardUrl"
+  },
   exportConfigurationsList: {
     service: "portal",
     method: "GET",
@@ -1735,9 +1770,43 @@ function buildServiceHeaders(config, route, hasBody) {
   return headers;
 }
 var MODEL_PATH_PATTERN = /^[A-Za-z0-9_.[\]]{1,200}$/;
+var MAX_PORTAL_ERROR_CODE = 999;
+function isJsonObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readPortalErrorCode(error) {
+  if (!isJsonObject(error)) {
+    return;
+  }
+  const code = error.errorCode;
+  if (typeof code !== "number" || !Number.isInteger(code) || code < 0 || code > MAX_PORTAL_ERROR_CODE) {
+    return;
+  }
+  return code;
+}
+function readPortalErrorMessage(error) {
+  if (!isJsonObject(error)) {
+    return;
+  }
+  const message = error.message;
+  if (typeof message !== "string" || !KNOWN_PORTAL_ERROR_MESSAGES.has(message)) {
+    return;
+  }
+  return message;
+}
+function liftPortalError(hint, error) {
+  const portalErrorCode = readPortalErrorCode(error);
+  if (portalErrorCode !== undefined) {
+    hint.portalErrorCode = portalErrorCode;
+  }
+  const portalErrorMessage = readPortalErrorMessage(error);
+  if (portalErrorMessage !== undefined) {
+    hint.portalErrorMessage = portalErrorMessage;
+  }
+}
 function describeJsonErrorBody(parsed) {
   if (typeof parsed === "string") {
-    return { shape: "string" };
+    return describeStringErrorBody(parsed);
   }
   if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
     return { shape: "other" };
@@ -1757,6 +1826,19 @@ function describeJsonErrorBody(parsed) {
       hint.firstInvalidField = firstKey;
     }
   }
+  liftPortalError(hint, record.error);
+  return hint;
+}
+function describeStringErrorBody(parsed) {
+  const hint = { shape: "string" };
+  const [parseError, inner] = catchError(() => JSON.parse(parsed));
+  if (parseError) {
+    return hint;
+  }
+  if (!isJsonObject(inner)) {
+    return hint;
+  }
+  liftPortalError(hint, inner.error);
   return hint;
 }
 function describeErrorBody(text) {
@@ -2014,22 +2096,12 @@ var resolveConfigAsync = async ({
     baseUrl = DEFAULT_BASE_URL;
   }
   baseUrl = normalizeAndValidateBaseUrl(baseUrl);
-  let clientId = customClientId;
-  if (!clientId && fileAuth.clientId) {
-    clientId = fileAuth.clientId;
-  }
-  if (!clientId) {
-    clientId = DEFAULT_CLIENT_ID;
-  }
-  let clientSecret = customClientSecret;
-  if (!clientSecret && fileAuth.clientSecret) {
-    clientSecret = fileAuth.clientSecret;
-  }
-  const isExternalAppAuth = clientId !== DEFAULT_CLIENT_ID && (Boolean(clientSecret) || Boolean(customClientAssertion));
+  const clientId = customClientId || DEFAULT_CLIENT_ID;
+  const isExternalAppAuth = clientId !== DEFAULT_CLIENT_ID && (Boolean(customClientSecret) || Boolean(customClientAssertion));
   const scopes = resolveScopes(isExternalAppAuth, customScopes, fileAuth.scopes);
   return {
     clientId,
-    clientSecret,
+    clientSecret: customClientSecret,
     scopes,
     baseUrl,
     authorizationEndpoint: `${baseUrl}/identity_/connect/authorize`,
@@ -2204,6 +2276,16 @@ var resolveIdentityType = (claims, authFlow, email) => {
   }
   return;
 };
+var resolveApplicationSubtype = (claims, authFlow) => {
+  switch (asString(claims?.sub_type)) {
+    case "service.external":
+      return "External";
+    case "service.internal":
+      return "Internal";
+    default:
+      return authFlow === "client_credentials" || authFlow === "federated_credentials" ? "External" : undefined;
+  }
+};
 var looksLikeEmail = (value) => value?.includes("@") ?? false;
 var pickEmail = (claims) => {
   for (const candidate of [claims?.email, claims?.preferred_username]) {
@@ -2245,6 +2327,12 @@ var resolveSessionIdentity = (accessToken, authFlow) => {
   const clientId = asString(claims?.client_id);
   if (clientId)
     identity.clientId = clientId;
+  const subType = asString(claims?.sub_type);
+  if (subType)
+    identity.subType = subType;
+  const applicationSubtype = resolveApplicationSubtype(claims, authFlow);
+  if (applicationSubtype)
+    identity.applicationSubtype = applicationSubtype;
   return identity;
 };
 var readTokenScopes = (accessToken) => accessToken ? pickScopes(decodeClaims(accessToken)) : undefined;
@@ -2539,6 +2627,40 @@ var tryRobotClientFallback = async (options = {}) => {
   }
 };
 
+// ../auth/src/tenantSelection.ts
+var LOGIN_STATUS_HINT = "Run 'uip login status' to see the organization the CLI is signed in to.";
+var organizationHint = (organizationId) => `The request used '${organizationId}' as the organization. ${LOGIN_STATUS_HINT}`;
+var IDENTIFIER_STATUSES = new Set([400, 403, 404]);
+var describeNonJsonResponse = (organizationId, response, parseError) => {
+  if (response.redirected) {
+    return `Could not find organization '${organizationId}': the request was ` + `redirected to a sign-in page instead of the organization's tenant ` + `list. ${LOGIN_STATUS_HINT}`;
+  }
+  const contentType = response.headers.get("content-type") ?? "unknown";
+  return `The organization service returned a '${contentType}' response instead ` + `of JSON: ${parseError.message}. ${organizationHint(organizationId)}`;
+};
+var fetchTenantsAndOrganizations = async (baseUrl, accessToken, organizationId, signal) => {
+  const url = `${baseUrl}/${organizationId}/portal_/api/filtering/leftnav/tenantsAndOrganizationInfo`;
+  const response = await fetch(url, {
+    headers: {
+      Authorization: `Bearer ${accessToken}`
+    },
+    ...signal ? { signal } : {}
+  });
+  if (!response.ok) {
+    if (response.status === 401) {
+      throw new Error(`Unauthorized: the access token was rejected, it was not ` + `issued for organization '${organizationId}', or ` + `'${organizationId}' was not accepted as an organization ` + `URL segment in this environment. ` + LOGIN_STATUS_HINT);
+    }
+    const errorText = await response.text();
+    const message = `Failed to get tenants and organizations: ${response.status} ${errorText}`;
+    throw new Error(IDENTIFIER_STATUSES.has(response.status) ? `${message}. ${organizationHint(organizationId)}` : message);
+  }
+  const [parseError, data] = await catchError2(response.json());
+  if (parseError) {
+    throw new Error(describeNonJsonResponse(organizationId, response, parseError));
+  }
+  return data;
+};
+
 // ../auth/src/tokenRefresh.ts
 var TOKEN_REFRESH_REAUTHENTICATE_MESSAGE = "Token refresh failed. Run 'uip login' to re-authenticate.";
 
@@ -2753,6 +2875,8 @@ var saveEnvFileAsync = async ({
 };
 
 // ../auth/src/loginStatus.ts
+var defaultRobotTenantIdCache = new Map;
+var ROBOT_TENANT_LOOKUP_TIMEOUT_MS = 5000;
 var getLoginStatusAsync = async (options = {}) => {
   return getLoginStatusWithDeps(options);
 };
@@ -2765,12 +2889,20 @@ var getLoginStatusWithDeps = async (options = {}, deps = {}) => {
     refreshToken: refreshTokenFn = refreshAccessToken,
     resolveConfig = resolveConfigAsync,
     robotFallback = tryRobotClientFallback,
+    fetchTenantsAndOrgs = fetchTenantsAndOrganizations,
+    robotTenantIdCache = defaultRobotTenantIdCache,
+    robotTenantLookupTimeoutMs = ROBOT_TENANT_LOOKUP_TIMEOUT_MS,
     loadBreaker = loadRefreshBreaker,
     saveBreaker = saveRefreshBreaker,
     clearBreaker = clearRefreshBreaker
   } = deps;
+  const robotDeps = {
+    fetchTenantsAndOrgs,
+    cache: robotTenantIdCache,
+    lookupTimeoutMs: robotTenantLookupTimeoutMs
+  };
   if (isRobotAuthEnforced()) {
-    return resolveRobotEnforcedStatus(robotFallback);
+    return resolveRobotEnforcedStatus(robotFallback, robotDeps);
   }
   if (isEnvAuthEnabled()) {
     return readAuthFromEnv();
@@ -2788,7 +2920,7 @@ var getLoginStatusWithDeps = async (options = {}, deps = {}) => {
         hint: `No credentials found for profile "${activeProfile}". Run 'uip login --profile ${activeProfile}' to authenticate this profile.`
       };
     }
-    return resolveBorrowedRobotStatus(robotFallback);
+    return resolveBorrowedRobotStatus(robotFallback, robotDeps);
   }
   const loaded = await loadFileCredentials(loadEnvFile, absolutePath);
   if ("status" in loaded) {
@@ -2830,7 +2962,7 @@ var getLoginStatusWithDeps = async (options = {}, deps = {}) => {
   }
   return buildFileStatus(tokens, credentials, globalHint);
 };
-async function resolveRobotEnforcedStatus(robotFallback) {
+async function resolveRobotEnforcedStatus(robotFallback, deps) {
   if (isEnvAuthEnabled()) {
     throw new EnvAuthConfigError(`${ENV_AUTH_ENABLE_VAR}=true and ${ENFORCE_ROBOT_AUTH_VAR}=true ` + `are mutually exclusive. Unset one of them and re-run.`);
   }
@@ -2841,11 +2973,11 @@ async function resolveRobotEnforcedStatus(robotFallback) {
       hint: `${ENFORCE_ROBOT_AUTH_VAR}=true but the UiPath Robot ` + `session is unavailable. Start and sign in to the Assistant, ` + `or unset ${ENFORCE_ROBOT_AUTH_VAR} to fall back to file or ` + `env-var authentication.`
     };
   }
-  return buildRobotStatus(robotCreds);
+  return buildRobotStatus(robotCreds, deps);
 }
-async function resolveBorrowedRobotStatus(robotFallback) {
+async function resolveBorrowedRobotStatus(robotFallback, deps) {
   const robotCreds = await robotFallback();
-  return robotCreds ? buildRobotStatus(robotCreds) : { loginStatus: "Not logged in" };
+  return robotCreds ? buildRobotStatus(robotCreds, deps) : { loginStatus: "Not logged in" };
 }
 async function loadFileCredentials(loadEnvFile, absolutePath) {
   let credentials;
@@ -2980,9 +3112,10 @@ function identityFields(accessToken, credentials) {
     ...scopes ? { scopes } : {}
   };
 }
-function buildRobotStatus(robotCreds) {
+async function buildRobotStatus(robotCreds, deps) {
   const identity = resolveSessionIdentity(robotCreds.accessToken);
   const scopes = readTokenScopes(robotCreds.accessToken);
+  const tenant = robotCreds.tenantId ? { tenantId: robotCreds.tenantId } : await resolveRobotTenantId(robotCreds, deps);
   return {
     loginStatus: "Logged in",
     accessToken: robotCreds.accessToken,
@@ -2990,14 +3123,62 @@ function buildRobotStatus(robotCreds) {
     organizationName: robotCreds.organizationName,
     organizationId: robotCreds.organizationId,
     tenantName: robotCreds.tenantName,
-    tenantId: robotCreds.tenantId,
+    tenantId: tenant.tenantId,
     issuer: robotCreds.issuer,
     expiration: getTokenExpiration(robotCreds.accessToken),
     source: "robot" /* Robot */,
+    ...tenant.hint ? { hint: tenant.hint } : {},
     ...identity ? { identity } : {},
     ...scopes ? { scopes } : {}
   };
 }
+async function resolveRobotTenantId(robotCreds, deps) {
+  const { baseUrl, accessToken, tenantName } = robotCreds;
+  const organization = robotCreds.organizationName ?? robotCreds.organizationId;
+  if (!tenantName || !organization) {
+    return {};
+  }
+  const key = `${baseUrl}|${organization}|${tenantName}|${accessToken}`;
+  let pending = deps.cache.get(key);
+  if (!pending) {
+    pending = catchError2(lookupRobotTenantId({ baseUrl, accessToken, organization, tenantName }, deps)).then(([error, resolution]) => {
+      const settled = error ? { hint: tenantLookupFailureHint(tenantName, error.message) } : resolution;
+      if (!settled.tenantId) {
+        deps.cache.delete(key);
+      }
+      return settled;
+    });
+    deps.cache.set(key, pending);
+  }
+  return pending;
+}
+async function lookupRobotTenantId(target, deps) {
+  const { baseUrl, accessToken, organization, tenantName } = target;
+  const [error, data] = await catchError2(deps.fetchTenantsAndOrgs(baseUrl, accessToken, organization, AbortSignal.timeout(deps.lookupTimeoutMs)));
+  if (error) {
+    const reason = error.name === "TimeoutError" ? `the tenant list did not answer within ${deps.lookupTimeoutMs} ms.` : error.message;
+    return { hint: tenantLookupFailureHint(tenantName, reason) };
+  }
+  const rows = data?.tenants;
+  const tenants = Array.isArray(rows) ? rows.filter((tenant) => typeof tenant?.id === "string" && typeof tenant?.name === "string") : [];
+  const wantedName = decodePathSegment(tenantName);
+  const wanted = wantedName.toLowerCase();
+  const match = tenants.find((tenant) => tenant.name === wantedName) ?? tenants.find((tenant) => tenant.name.toLowerCase() === wanted);
+  if (!match) {
+    const names = tenants.map((tenant) => tenant.name).join(", ");
+    return {
+      hint: `The Robot session targets tenant '${tenantName}', but ` + `organization '${organization}' lists no tenant of that name` + `${names ? ` (available: ${names})` : ""}. Commands that need ` + `the tenant id will fail until it can be resolved.`
+    };
+  }
+  return { tenantId: match.id };
+}
+function tenantLookupFailureHint(tenantName, reason) {
+  return `Could not resolve the id of tenant '${tenantName}' from the ` + `Robot session: ${reason} Commands that need the tenant id will ` + `fail until it can be resolved.`;
+}
+function decodePathSegment(segment) {
+  const [error, decoded] = catchError2(() => decodeURIComponent(segment));
+  return error ? segment : decoded;
+}
 var isFileNotFoundError = (error) => {
   if (!(error instanceof Object))
     return false;
@@ -3274,8 +3455,6 @@ init_constants();
 // ../auth/src/interactive.ts
 init_src();
 init_constants();
-// ../auth/src/tenantSelection.ts
-var IDENTIFIER_STATUSES = new Set([400, 403, 404]);
 
 // ../auth/src/selectTenant.ts
 var TENANT_SELECTION_REQUIRED_CODE = "TENANT_SELECTION_REQUIRED";
@@ -3697,6 +3876,151 @@ async function listQueueFilters(config) {
 async function listMachineFilters(config) {
   return listFilters(config, "filtersAllMachines", isMachineFiltersResponse, "machine filters");
 }
+// src/looker-dashboards.ts
+var TEMPLATE_ID_DELIMITER = "::";
+var INTEGER_ID_PATTERN = /^\d+$/;
+var LOOKER_FOLDERS = [
+  "personal",
+  "tenant",
+  "templates",
+  "organization"
+];
+var LOOKER_THEMES = ["light", "dark"];
+async function listLookerDashboards(config) {
+  return requestInsightsRoute(config, "lookerDashboardsList");
+}
+async function getLookerDashboardEmbedUrl(config, options) {
+  const dashboardId = options.dashboardId.trim();
+  if (dashboardId === "") {
+    throw new Error("Insights Looker dashboard id must not be empty.");
+  }
+  if (!isDashboardId(dashboardId)) {
+    throw new Error("Insights Looker dashboard id must be all digits or contain '::'; resolve a title with resolveLookerDashboard first.");
+  }
+  if (!LOOKER_THEMES.includes(options.theme)) {
+    throw new Error(`Insights Looker theme must be one of ${LOOKER_THEMES.join(", ")}.`);
+  }
+  const locale = options.localization?.trim();
+  if (locale === "") {
+    throw new Error("Insights Looker localization must not be empty.");
+  }
+  return requestInsightsRoute(config, "lookerDashboardEmbedUrl", {
+    body: {
+      dashboardId,
+      theme: options.theme,
+      ...locale === undefined ? {} : { locale }
+    }
+  });
+}
+function parseLookerEnvelope(raw, routeKey) {
+  const endpoint = insightsRouteTemplate(routeKey);
+  if (typeof raw !== "string") {
+    throw new InsightsProtocolError(endpoint, "the body is not the JSON string literal this root answers with");
+  }
+  const [parseError, envelope] = catchError(() => JSON.parse(raw));
+  if (parseError) {
+    throw new InsightsProtocolError(endpoint, "the body string does not hold JSON");
+  }
+  if (!isJsonObject(envelope)) {
+    throw new InsightsProtocolError(endpoint, "the body string does not hold an object");
+  }
+  if (typeof envelope.isSuccess !== "boolean") {
+    throw new InsightsProtocolError(endpoint, "the body carries no boolean isSuccess");
+  }
+  if (envelope.isSuccess !== true) {
+    throw new InsightsProtocolError(endpoint, "the body reports isSuccess false inside a success status");
+  }
+  if (envelope.result === undefined || envelope.result === null) {
+    throw new InsightsProtocolError(endpoint, "the body carries no result");
+  }
+  return envelope.result;
+}
+
+class LookerResolveError extends Error {
+  kind;
+  candidates;
+  constructor(kind, message, candidates = []) {
+    super(message);
+    this.name = "LookerResolveError";
+    this.kind = kind;
+    this.candidates = candidates;
+  }
+}
+function isDashboardId(value) {
+  return INTEGER_ID_PATTERN.test(value) || value.includes(TEMPLATE_ID_DELIMITER);
+}
+function isLookerTemplateDashboardId(id) {
+  return !INTEGER_ID_PATTERN.test(id);
+}
+function readLookerListing(raw) {
+  const endpoint = insightsRouteTemplate("lookerDashboardsList");
+  const folders = parseLookerEnvelope(raw, "lookerDashboardsList");
+  if (!isJsonObject(folders)) {
+    throw new InsightsProtocolError(endpoint, "the result is not an object");
+  }
+  const listing = { rows: [], omittedFolders: [] };
+  for (const folder of LOOKER_FOLDERS) {
+    const group = readFolderGroup(folders[folder], folder, endpoint);
+    if (group === null) {
+      listing.omittedFolders.push(folder);
+      continue;
+    }
+    for (const element of group) {
+      listing.rows.push(readListingRow(element, folder, endpoint));
+    }
+  }
+  return listing;
+}
+function readFolderGroup(group, folder, endpoint) {
+  if (group === undefined) {
+    throw new InsightsProtocolError(endpoint, `the result carries no ${folder} key`);
+  }
+  if (group === null) {
+    return null;
+  }
+  if (!Array.isArray(group)) {
+    throw new InsightsProtocolError(endpoint, `the result's ${folder} is neither an array nor null`);
+  }
+  return group;
+}
+function readListingRow(record, folder, endpoint) {
+  if (!isJsonObject(record)) {
+    throw new InsightsProtocolError(endpoint, `a row in the ${folder} folder is not an object`);
+  }
+  if (typeof record.id !== "string") {
+    throw new InsightsProtocolError(endpoint, `a row in the ${folder} folder has no string id`);
+  }
+  if (record.title !== null && typeof record.title !== "string") {
+    throw new InsightsProtocolError(endpoint, `a row in the ${folder} folder has a title that is neither a string nor null`);
+  }
+  return { folder, id: record.id, title: record.title, record };
+}
+async function resolveLookerDashboard(config, value) {
+  const trimmed = value.trim();
+  if (trimmed === "") {
+    throw new Error("Insights Looker dashboard must not be empty.");
+  }
+  if (isDashboardId(trimmed)) {
+    return { id: trimmed, resolvedFrom: "id" };
+  }
+  const { rows } = readLookerListing(await listLookerDashboards(config));
+  const matches = rows.filter((row) => row.title?.trim() === trimmed);
+  if (matches.length === 0) {
+    throw new LookerResolveError("notFound", "No Looker dashboard with that title is listed for this session.");
+  }
+  for (const match of matches) {
+    requireEmbeddableId(match);
+  }
+  if (matches.length > 1) {
+    throw new LookerResolveError("ambiguous", `${matches.length} Looker dashboards share that title.`, matches.map((row) => ({ folder: row.folder, id: row.id })));
+  }
+  return { id: matches[0].id, resolvedFrom: "title" };
+}
+function requireEmbeddableId(row) {
+  if (!isDashboardId(row.id)) {
+    throw new InsightsProtocolError(insightsRouteTemplate("lookerDashboardsList"), `a row in the ${row.folder} folder has an id that is neither all digits nor contains '::'`);
+  }
+}
 // src/machines.ts
 function isNullish(value) {
   return value === undefined || value === null;
@@ -3954,10 +4278,16 @@ export {
   InsightsHttpError,
   InsightsNetworkError,
   InsightsProtocolError,
+  LOOKER_FOLDERS,
+  LOOKER_NO_DASHBOARDS_MESSAGE,
+  LOOKER_THEMES,
+  LOOKER_USER_UNAVAILABLE_MESSAGE,
+  LookerResolveError,
   MAESTRO_CASE_DASHBOARD_PREFIX,
   MAESTRO_DASHBOARD_SOURCE_TYPE,
   MAESTRO_PROCESS_DASHBOARD_PREFIX,
   MODEL_NOT_FOUND_LABEL,
+  PORTAL_ERROR_CODE,
   UPDATE_BACKEND_FAILURE_LABEL,
   VALIDATION_FAILED_LABEL,
   checkAlertEntitlement,
@@ -3973,6 +4303,7 @@ export {
   getDashboardTemplate,
   getDefaultDelivery,
   getGroup,
+  getLookerDashboardEmbedUrl,
   getMachineAvailabilityTimeline,
   getMachineDetails,
   getMachineRuntimeMix,
@@ -3991,6 +4322,7 @@ export {
   getRole,
   getUser,
   insightsPost,
+  isLookerTemplateDashboardId,
   isTemplateKeyedDashboardId,
   listAgenticAlertDefinitions,
   listAlertDefinitions,
@@ -3999,15 +4331,19 @@ export {
   listExportConfigurations,
   listFolderFilters,
   listGroups,
+  listLookerDashboards,
   listMachineFilters,
   listProcessFilters,
   listQueueFilters,
   listRoles,
   listUsers,
   parseDashboardSlotId,
+  parseLookerEnvelope,
+  readLookerListing,
+  resolveLookerDashboard,
   updateDashboard,
   verifyAllExportDestinations,
   verifyExportDestination
 };
 
-//# debugId=BFA94E9FB55DE0F464756E2164756E21
+//# debugId=29164392C65E2CD564756E2164756E21

package/dist/src/errors.d.ts

@@ -69,6 +69,8 @@ export interface InsightsErrorBodyHint {
      * numbers are at origin/develop 2c5860474, as above.
      */
     problemDetails?: true;
+    portalErrorCode?: number;
+    portalErrorMessage?: string;
 }
 /**
  * The only `error` values `describeJsonErrorBody` lifts into `errorLabel`.
@@ -109,6 +111,16 @@ export declare const VALIDATION_FAILED_LABEL = "Validation failed";
 export declare const CREATE_BACKEND_FAILURE_LABEL = "Failed to create dashboard";
 export declare const UPDATE_BACKEND_FAILURE_LABEL = "Failed to update dashboard";
 export declare const KNOWN_ERROR_LABELS: Set<string>;
+export declare const PORTAL_ERROR_CODE: {
+    readonly InvalidUserInput: 6;
+    readonly LookerUnavailableError: 8;
+    readonly PermissionsUserUnauthorized: 10;
+    readonly UnableToGetEmbedLink: 23;
+    readonly UnableToRetrieveDashboards: 26;
+};
+export declare const LOOKER_USER_UNAVAILABLE_MESSAGE = "Unable to get Looker userInfo";
+export declare const LOOKER_NO_DASHBOARDS_MESSAGE = "Unable to retrieve dashboards";
+export declare const KNOWN_PORTAL_ERROR_MESSAGES: Set<string>;
 interface InsightsHttpErrorInit {
     status: number;
     method: InsightsHttpMethod;

package/dist/src/index.d.ts

@@ -4,10 +4,12 @@ export { createInsightsConfig } from "./client-factory";
 export type { CreateDashboardOptions, DashboardChart, DashboardChartAction, DashboardChartFilter, DashboardChartFilterRange, DashboardCustomLayout, DashboardDefinition, DashboardField, DashboardFieldFormat, DashboardLayout, DashboardLayoutContainer, DashboardMetric, DashboardMetricExpression, DashboardMetricFilter, DashboardSlot, DashboardSlotKind, DashboardTable, DeleteDashboardOptions, GetDashboardOptions, GetDashboardTemplateOptions, ListDashboardFiltersOptions, UpdateDashboardOptions, } from "./dashboards";
 export { composeDashboardSlotId, createDashboard, DASHBOARD_SLOT_DELIMITER, DASHBOARD_TEMPLATE_ID_PREFIX, DashboardRequestError, deleteDashboard, getDashboard, getDashboardTemplate, isTemplateKeyedDashboardId, listDashboardFilters, MAESTRO_CASE_DASHBOARD_PREFIX, MAESTRO_DASHBOARD_SOURCE_TYPE, MAESTRO_PROCESS_DASHBOARD_PREFIX, parseDashboardSlotId, updateDashboard, } from "./dashboards";
 export type { InsightsBodyKind, InsightsErrorBodyHint, InsightsHttpMethod, } from "./errors";
-export { CREATE_BACKEND_FAILURE_LABEL, DASHBOARD_NOT_FOUND_LABEL, InsightsHttpError, InsightsNetworkError, InsightsProtocolError, MODEL_NOT_FOUND_LABEL, UPDATE_BACKEND_FAILURE_LABEL, VALIDATION_FAILED_LABEL, } from "./errors";
+export { CREATE_BACKEND_FAILURE_LABEL, DASHBOARD_NOT_FOUND_LABEL, InsightsHttpError, InsightsNetworkError, InsightsProtocolError, LOOKER_NO_DASHBOARDS_MESSAGE, LOOKER_USER_UNAVAILABLE_MESSAGE, MODEL_NOT_FOUND_LABEL, PORTAL_ERROR_CODE, UPDATE_BACKEND_FAILURE_LABEL, VALIDATION_FAILED_LABEL, } from "./errors";
 export type { ExportDestinationKey, ExportVerifyBody, } from "./export-configurations";
 export { listExportConfigurations, verifyAllExportDestinations, verifyExportDestination, } from "./export-configurations";
 export { listFolderFilters, listMachineFilters, listProcessFilters, listQueueFilters, } from "./filters";
+export type { LookerDashboardRef, LookerEmbedUrlOptions, LookerFolder, LookerListing, LookerListingRow, LookerTheme, } from "./looker-dashboards";
+export { getLookerDashboardEmbedUrl, isLookerTemplateDashboardId, LOOKER_FOLDERS, LOOKER_THEMES, LookerResolveError, listLookerDashboards, parseLookerEnvelope, readLookerListing, resolveLookerDashboard, } from "./looker-dashboards";
 export type { MachineQueryInput, MachinesResponse } from "./machines";
 export { getMachineAvailabilityTimeline, getMachineDetails, getMachineRuntimeMix, getMachineTopFailures, getMachineUtilization, } from "./machines";
 export type { QueueQueryInput, QueuesResponse, QueueWfMetricsRow, } from "./queues";

package/dist/src/looker-dashboards.d.ts

@@ -0,0 +1,42 @@
+import { type InsightsRouteKey } from "./transport";
+import type { InsightsApiConfig } from "./types";
+export declare const LOOKER_FOLDERS: readonly ["personal", "tenant", "templates", "organization"];
+export type LookerFolder = (typeof LOOKER_FOLDERS)[number];
+export declare const LOOKER_THEMES: readonly ["light", "dark"];
+export type LookerTheme = (typeof LOOKER_THEMES)[number];
+export declare function listLookerDashboards(config: InsightsApiConfig): Promise<unknown>;
+export interface LookerEmbedUrlOptions {
+    dashboardId: string;
+    theme: LookerTheme;
+    localization?: string;
+}
+export declare function getLookerDashboardEmbedUrl(config: InsightsApiConfig, options: LookerEmbedUrlOptions): Promise<unknown>;
+export declare function parseLookerEnvelope(raw: unknown, routeKey: InsightsRouteKey): unknown;
+export interface LookerDashboardRef {
+    id: string;
+    resolvedFrom: "id" | "title";
+}
+export declare class LookerResolveError extends Error {
+    readonly kind: "notFound" | "ambiguous";
+    readonly candidates: ReadonlyArray<{
+        folder: LookerFolder;
+        id: string;
+    }>;
+    constructor(kind: "notFound" | "ambiguous", message: string, candidates?: ReadonlyArray<{
+        folder: LookerFolder;
+        id: string;
+    }>);
+}
+export declare function isLookerTemplateDashboardId(id: string): boolean;
+export interface LookerListingRow {
+    folder: LookerFolder;
+    id: string;
+    title: string | null;
+    record: Record<string, unknown>;
+}
+export interface LookerListing {
+    rows: LookerListingRow[];
+    omittedFolders: LookerFolder[];
+}
+export declare function readLookerListing(raw: unknown): LookerListing;
+export declare function resolveLookerDashboard(config: InsightsApiConfig, value: string): Promise<LookerDashboardRef>;

package/dist/src/transport.d.ts

@@ -160,6 +160,16 @@ export declare const INSIGHTS_ROUTES: {
         readonly method: "POST";
         readonly template: "Authorization/tenant/insights";
     };
+    readonly lookerDashboardsList: {
+        readonly service: "portal";
+        readonly method: "GET";
+        readonly template: "AllDashboards/folders";
+    };
+    readonly lookerDashboardEmbedUrl: {
+        readonly service: "portal";
+        readonly method: "POST";
+        readonly template: "DashboardUrl";
+    };
     readonly exportConfigurationsList: {
         readonly service: "portal";
         readonly method: "GET";
@@ -179,6 +189,7 @@ export declare const INSIGHTS_ROUTES: {
 export type InsightsRouteKey = keyof typeof INSIGHTS_ROUTES;
 /** Safe endpoint template for a route, for protocol-error reporting. */
 export declare function insightsRouteTemplate(routeKey: InsightsRouteKey): string;
+export declare function isJsonObject(value: unknown): value is Record<string, unknown>;
 /** Query values a wrapper may set. `undefined` omits the parameter. */
 export type InsightsRouteQuery = Record<string, string | number | boolean | undefined>;
 export interface InsightsRouteRequest {

package/package.json

@@ -2,7 +2,7 @@
     "name": "@uipath/insights-sdk",
     "author": "UiPath",
     "license": "SEE LICENSE IN LICENSE.txt",
-    "version": "1.204.0",
+    "version": "1.205.0-preview.258",
     "description": "SDK for the UiPath Insights API — jobs, failures, and performance metrics.",
     "repository": {
         "type": "git",
@@ -35,5 +35,5 @@
     "files": [
         "dist"
     ],
-    "gitHead": "699c58dabb59414557755a8933bcbe40aa420df3"
+    "gitHead": "8f629ee9fa89abf94f197436a60cb3b9620f8b27"
 }