@uipath/common 1.197.0 → 1.198.0-preview.100

package/dist/error-handler.d.ts

@@ -45,15 +45,19 @@ export interface ConnectivityError {
     /** Actionable, user-facing remediation steps. */
     instructions: string;
 }
+export declare function formatErrorChain(error: unknown): string;
 /**
- * Classify an outbound connectivity failure by walking the `cause` chain.
+ * Classify an outbound connectivity failure by walking the error graph.
  *
  * Node's native `fetch` wraps the real failure (a TLS or socket error) inside
  * a generic `TypeError: fetch failed`, so the useful code/message lives on
- * `error.cause` (sometimes nested deeper). This unwraps that chain and, when
- * it finds a known TLS or network code, returns the specific message plus
- * remediation steps. Returns `undefined` for anything that isn't a recognised
- * connectivity failure so callers can fall back to their normal handling.
+ * `error.cause` (sometimes nested deeper). When fetch races several addresses
+ * (IPv4/IPv6, or proxy fallbacks) it instead collects the per-attempt failures
+ * in an `AggregateError.errors` array — so the code can hide there rather than
+ * on a single `.cause`. This walks both edges and, when it finds a known TLS
+ * or network code, returns the specific message plus remediation steps.
+ * Returns `undefined` for anything that isn't a recognised connectivity
+ * failure so callers can fall back to their normal handling.
  */
 export declare function describeConnectivityError(error: unknown): ConnectivityError | undefined;
 export declare function isHtmlDocument(body: string): boolean;

package/dist/formatter.d.ts

@@ -179,6 +179,7 @@ export declare namespace OutputFormatter {
     function emitList<T extends DataRecord>(code: string, items: T[], opts?: {
         emptyInstructions?: string;
         warning?: string;
+        pagination?: Pagination;
     }): void;
     /**
      * Log an informational/progress message to stderr.

package/dist/index.browser.js

@@ -21051,9 +21051,47 @@ var TLS_ERROR_CODES = new Set([
 ]);
 var TLS_INSTRUCTIONS = "The server's TLS certificate could not be verified. Most often a " + "corporate proxy/firewall re-signs HTTPS with a root CA that Node does " + "not trust — set NODE_EXTRA_CA_CERTS to that CA's PEM file (and HTTPS_PROXY " + "if you connect through a proxy). If the certificate is instead expired or " + "its hostname does not match, fix the endpoint URL or the system clock. " + "Then retry.";
 var NETWORK_INSTRUCTIONS = "Could not reach the UiPath service. Check your network connection and " + "VPN, confirm any HTTP_PROXY/HTTPS_PROXY/NO_PROXY settings are correct, " + "then retry.";
+function formatErrorChain(error) {
+  const lines = [];
+  const seen = new Set;
+  const visit = (value, depth) => {
+    if (lines.length >= 32)
+      return;
+    const indent = "  ".repeat(depth);
+    if (value === null || typeof value !== "object") {
+      lines.push(`${indent}${String(value)}`);
+      return;
+    }
+    if (seen.has(value))
+      return;
+    seen.add(value);
+    const cur = value;
+    const name = typeof cur.name === "string" ? cur.name : "Error";
+    const message = typeof cur.message === "string" ? cur.message : String(value);
+    const code2 = typeof cur.code === "string" ? ` [${cur.code}]` : "";
+    lines.push(`${indent}${name}: ${message}${code2}`);
+    if (cur.cause !== undefined)
+      visit(cur.cause, depth + 1);
+    if (Array.isArray(cur.errors)) {
+      for (const nested of cur.errors) {
+        visit(nested, depth + 1);
+      }
+    }
+  };
+  visit(error, 0);
+  return lines.join(`
+`);
+}
 function describeConnectivityError(error) {
-  let current = error;
-  for (let depth = 0;depth < 5 && current !== null && typeof current === "object"; depth++) {
+  const queue2 = [error];
+  const seen = new Set;
+  for (let steps = 0;queue2.length > 0 && steps < 32; steps++) {
+    const current = queue2.shift();
+    if (current === null || typeof current !== "object")
+      continue;
+    if (seen.has(current))
+      continue;
+    seen.add(current);
     const cur = current;
     const code2 = typeof cur.code === "string" ? cur.code : undefined;
     const message = typeof cur.message === "string" ? cur.message : undefined;
@@ -21073,7 +21111,10 @@ function describeConnectivityError(error) {
         instructions: NETWORK_INSTRUCTIONS
       };
     }
-    current = cur.cause;
+    if (cur.cause !== undefined)
+      queue2.push(cur.cause);
+    if (Array.isArray(cur.errors))
+      queue2.push(...cur.errors);
   }
   return;
 }
@@ -21668,6 +21709,7 @@ function buildActionCenterTaskUrl(baseUrl, org, tenant, taskId) {
 // src/output-format-context.ts
 var formatSlot = singleton("OutputFormat");
 var formatExplicitSlot = singleton("OutputFormatExplicit");
+var helpRequestedSlot = singleton("HelpRequested");
 var filterSlot = singleton("OutputFilter");
 function setOutputFormat(format4) {
   formatSlot.set(format4);
@@ -21681,6 +21723,12 @@ function setOutputFormatExplicit(explicit) {
 function getOutputFormatExplicit() {
   return formatExplicitSlot.get(false) ?? false;
 }
+function setHelpRequested(requested) {
+  helpRequestedSlot.set(requested);
+}
+function getHelpRequested() {
+  return helpRequestedSlot.get(false) ?? false;
+}
 function setOutputFilter(filter) {
   filterSlot.set(filter);
 }
@@ -22761,11 +22809,36 @@ class ConsoleTelemetryProvider {
     console.debug(`[Telemetry] Dependency: ${name} [${type}] (${duration}ms, ${success ? "ok" : "fail"})`);
   }
 }
+// src/telemetry/trace-context.ts
+var TELEMETRY_TRACEPARENT_ENV = "TRACEPARENT";
+var TRACEPARENT_PATTERN = /^00-([0-9a-f]{32})-([0-9a-f]{16})-[0-9a-f]{2}$/;
+function getProcessEnv() {
+  return globalThis.process?.env;
+}
+function parseInboundTraceparent(value) {
+  if (!value) {
+    return;
+  }
+  const match = TRACEPARENT_PATTERN.exec(value.trim().toLowerCase());
+  if (!match) {
+    return;
+  }
+  const [, traceId, parentSpanId] = match;
+  if (/^0+$/.test(traceId) || /^0+$/.test(parentSpanId)) {
+    return;
+  }
+  return { traceId, parentSpanId };
+}
+function getInboundTraceContext() {
+  return parseInboundTraceparent(getProcessEnv()?.[TELEMETRY_TRACEPARENT_ENV]);
+}
+
 // src/telemetry/session-id.ts
 var TELEMETRY_SESSION_ID_ENV = "UIPATH_SESSION_ID";
 var TELEMETRY_SESSION_ID_PROPERTY = "session_id";
 var telemetrySessionIdSlot = singleton("TelemetrySessionId");
-function getProcessEnv() {
+var telemetryOperationIdSlot = singleton("TelemetryOperationId");
+function getProcessEnv2() {
   return globalThis.process?.env;
 }
 function normalizeSessionId(value) {
@@ -22776,7 +22849,7 @@ function normalizeSessionId(value) {
   return trimmed || undefined;
 }
 function getConfiguredTelemetrySessionId() {
-  return normalizeSessionId(getProcessEnv()?.[TELEMETRY_SESSION_ID_ENV]);
+  return normalizeSessionId(getProcessEnv2()?.[TELEMETRY_SESSION_ID_ENV]);
 }
 function getTelemetrySessionId() {
   const envSessionId = getConfiguredTelemetrySessionId();
@@ -22794,6 +22867,16 @@ function getTelemetrySessionId() {
 function resolveTelemetrySessionId(existingSessionId) {
   return getConfiguredTelemetrySessionId() ?? normalizeSessionId(existingSessionId);
 }
+function getTelemetryOperationId() {
+  const existing = telemetryOperationIdSlot.get();
+  if (existing) {
+    return existing;
+  }
+  const inboundTraceId = getInboundTraceContext()?.traceId;
+  const generated = inboundTraceId ?? crypto.randomUUID().replaceAll("-", "");
+  telemetryOperationIdSlot.set(generated);
+  return generated;
+}
 // src/telemetry/telemetry-events.ts
 var CommonTelemetryEvents = {
   Error: "uip.error",
@@ -22929,7 +23012,144 @@ function getExecutionContextTelemetryProperties() {
   };
 }
 
+// src/telemetry/pii-redactor.ts
+var REDACTED = "[REDACTED]";
+var MAX_VALUE_LENGTH = 200;
+var SENSITIVE_NAME_TOKENS = new Set([
+  "token",
+  "tokens",
+  "secret",
+  "secrets",
+  "password",
+  "passwords",
+  "pwd",
+  "credential",
+  "credentials",
+  "auth",
+  "authentication",
+  "authorization",
+  "authority",
+  "cert",
+  "certificate",
+  "certificates"
+]);
+var SENSITIVE_KEY_PREFIXES = new Set([
+  "api",
+  "access",
+  "client",
+  "private",
+  "public",
+  "signing",
+  "encryption",
+  "session",
+  "master",
+  "shared",
+  "root",
+  "ssh",
+  "rsa",
+  "aes",
+  "hmac",
+  "oauth"
+]);
+var UUID_PATTERN = /\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi;
+var EMAIL_PATTERN = /\b[^\s@]+@[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 USER_HOME_PATTERN = /([/\\])(Users|home)([/\\])([^/\\]+)/gi;
+var URL_PATTERN = /\bhttps?:\/\/[^\s,;]+/gi;
+var URL_TRAILING_PUNCT = /[.,;:!?)\]}>'"]+$/;
+function shortHash(input) {
+  let hash = 2166136261;
+  for (let i2 = 0;i2 < input.length; i2++) {
+    hash ^= input.charCodeAt(i2);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+}
+function redactUrl(raw) {
+  try {
+    const url = new URL(raw);
+    return `${url.protocol}//${url.host}`;
+  } catch {
+    return `url#${shortHash(raw)}`;
+  }
+}
+function redactValueDetectors(value) {
+  let out = value;
+  out = out.replace(JWT_PATTERN, () => REDACTED);
+  out = out.replace(URL_PATTERN, (match) => {
+    const trailing = match.match(URL_TRAILING_PUNCT)?.[0] ?? "";
+    const core = trailing ? match.slice(0, -trailing.length) : match;
+    return `${redactUrl(core)}${trailing}`;
+  });
+  out = out.replace(USER_HOME_PATTERN, (_match, sep1, folder, sep2) => `${sep1}${folder}${sep2}<user>`);
+  out = out.replace(EMAIL_PATTERN, (match) => `email#${shortHash(match)}`);
+  out = out.replace(UUID_PATTERN, (match) => `uuid#${shortHash(match)}`);
+  out = out.replace(LONG_TOKEN_PATTERN, () => REDACTED);
+  if (out.length > MAX_VALUE_LENGTH) {
+    out = `${out.slice(0, MAX_VALUE_LENGTH)}…`;
+  }
+  return out;
+}
+function redactValue(value) {
+  return redactValueDetectors(value);
+}
+function redactError(error) {
+  const safe = new Error(redactValueDetectors(error.message ?? ""));
+  safe.name = error.name;
+  safe.stack = typeof error.stack === "string" ? redactValueDetectors(error.stack) : undefined;
+  return safe;
+}
+function nameTokens(name) {
+  return name.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").split(/[\s._-]+/).map((t) => t.toLowerCase()).filter(Boolean);
+}
+function isSensitiveName(name) {
+  const tokens = nameTokens(name);
+  for (let i2 = 0;i2 < tokens.length; i2++) {
+    const token = tokens[i2];
+    if (SENSITIVE_NAME_TOKENS.has(token)) {
+      return true;
+    }
+    if (token === "key" || token === "keys") {
+      const prev = tokens[i2 - 1];
+      if (prev && SENSITIVE_KEY_PREFIXES.has(prev)) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function redactProperty(name, value) {
+  if (value === undefined || value === null) {
+    return;
+  }
+  if (isSensitiveName(name)) {
+    return REDACTED;
+  }
+  if (typeof value === "boolean" || typeof value === "number") {
+    return value;
+  }
+  if (typeof value !== "string") {
+    return "[OBJECT]";
+  }
+  return redactValueDetectors(value);
+}
+function redactProperties(properties) {
+  const out = {};
+  for (const [name, value] of Object.entries(properties)) {
+    const redacted = redactProperty(name, value);
+    if (redacted !== undefined) {
+      out[name] = redacted;
+    }
+  }
+  return out;
+}
+
 // src/telemetry/telemetry-service.ts
+var TELEMETRY_OPERATION_ID_PROPERTY = "uip.trace.operation_id";
+var TELEMETRY_PARENT_ID_PROPERTY = "uip.trace.parent_id";
+var TELEMETRY_SPAN_ID_PROPERTY = "uip.trace.span_id";
+
 class TelemetryService {
   telemetryProvider;
   contextStorage;
@@ -22956,11 +23176,15 @@ class TelemetryService {
   trackException(error, properties) {
     const context = this.getCurrentContext();
     const enrichedProperties = this.enrichPropertiesWithContext(properties, context);
-    this.telemetryProvider.trackException(error, enrichedProperties);
+    this.telemetryProvider.trackException(redactError(error), enrichedProperties);
   }
   async trackRequest(name, fn, properties) {
+    const parentContext = this.getCurrentContext();
+    const operationId = parentContext?.operationId ?? this.operationId ?? getTelemetryOperationId();
+    const parentId = parentContext ? parentContext.id : this.inboundParentIdFor(operationId);
     const context = {
-      operationId: this.operationId ?? this.generateId(),
+      operationId,
+      ...parentId !== undefined ? { parentId } : {},
       id: this.generateId()
     };
     const startTime = performance.now();
@@ -22978,6 +23202,45 @@ class TelemetryService {
       throw error;
     }
   }
+  trackRequestResult(name, durationMs, success, properties, context) {
+    const requestContext = context ?? {
+      operationId: this.operationId ?? getTelemetryOperationId(),
+      id: this.generateId()
+    };
+    const enrichedProperties = this.enrichPropertiesWithContext(properties, requestContext);
+    this.telemetryProvider.trackRequest(name, durationMs, success, enrichedProperties);
+  }
+  createRequestContext() {
+    const operationId = this.operationId ?? getTelemetryOperationId();
+    const parentId = this.inboundParentIdFor(operationId);
+    return {
+      operationId,
+      ...parentId !== undefined ? { parentId } : {},
+      id: this.generateId()
+    };
+  }
+  inboundParentIdFor(operationId) {
+    const inbound = getInboundTraceContext();
+    return inbound && inbound.traceId === operationId ? inbound.parentSpanId : undefined;
+  }
+  runWithContext(context, fn) {
+    return this.contextStorage.run(context, fn);
+  }
+  createDependencyContext() {
+    const parentContext = this.getCurrentContext();
+    if (!parentContext) {
+      return;
+    }
+    return {
+      operationId: parentContext.operationId,
+      parentId: parentContext.id,
+      id: this.generateId()
+    };
+  }
+  trackDependencyResult(name, type, durationMs, success, properties, context, resultCode) {
+    const enrichedProperties = this.enrichPropertiesWithContext(properties, context);
+    this.telemetryProvider.trackDependency(redactValue(name), type, durationMs, success, enrichedProperties, resultCode);
+  }
   async trackDependencyOperation(name, type, fn, properties) {
     const parentContext = this.getCurrentContext();
     if (!parentContext) {
@@ -23014,8 +23277,12 @@ class TelemetryService {
       ...getExecutionContextTelemetryProperties(),
       ...globalProperties,
       ...this.defaultProperties,
-      ...properties,
-      ...context
+      ...redactProperties(properties ?? {}),
+      ...context ? {
+        [TELEMETRY_OPERATION_ID_PROPERTY]: context.operationId,
+        ...context.parentId !== undefined ? { [TELEMETRY_PARENT_ID_PROPERTY]: context.parentId } : {},
+        [TELEMETRY_SPAN_ID_PROPERTY]: context.id
+      } : {}
     };
     if (sessionId === undefined) {
       delete enriched[TELEMETRY_SESSION_ID_PROPERTY];
@@ -23025,7 +23292,16 @@ class TelemetryService {
     return enriched;
   }
   generateId() {
-    return crypto.randomUUID().replaceAll("-", "");
+    const bytes = new Uint8Array(8);
+    let hex = "";
+    do {
+      crypto.getRandomValues(bytes);
+      hex = "";
+      for (const byte of bytes) {
+        hex += byte.toString(16).padStart(2, "0");
+      }
+    } while (/^0+$/.test(hex));
+    return hex;
   }
 }
 // src/tool-provider.ts
@@ -23049,6 +23325,7 @@ export {
   setOutputFormatExplicit,
   setOutputFormat,
   setOutputFilter,
+  setHelpRequested,
   setGlobalSink,
   setGlobalLogFilePath,
   runWithSink,
@@ -23087,10 +23364,12 @@ export {
   getOutputFormat,
   getOutputFilter,
   getLogFilePath,
+  getHelpRequested,
   getGlobalLogFilePath,
   getConfiguredTelemetrySessionId,
   getCompleter,
   getCommandExamples,
+  formatErrorChain,
   extractFormatFromArgs,
   extractErrorMessageSync,
   extractErrorMessage,
@@ -23135,4 +23414,4 @@ export {
   AUTH_FILENAME
 };
 
-//# debugId=ACC353BBF445886C64756E2164756E21
+//# debugId=A8F9E8E6B48366FF64756E2164756E21

package/dist/index.d.ts

@@ -35,7 +35,7 @@ export * from "./telemetry/command-terminal.js";
 export { ConsoleTelemetryProvider } from "./telemetry/console-telemetry-provider.js";
 export * from "./telemetry/node.js";
 export { setGlobalTelemetryProperties } from "./telemetry/node-appinsights-telemetry-provider.js";
-export { redactProperties, redactProperty } from "./telemetry/pii-redactor.js";
+export { redactError, redactProperties, redactProperty, redactValue, } from "./telemetry/pii-redactor.js";
 export { type ShipSucceededTelemetryPayload, trackShipSucceeded, } from "./telemetry/ship-succeeded.js";
 export * from "./telemetry/telemetry-events.js";
 export * from "./telemetry/telemetry-init.js";