@uipath/common 1.201.0-preview.133 → 1.202.0-preview.134

package/dist/formatter.d.ts

@@ -1,5 +1,13 @@
 import { type CommandErrorClass, type TerminalOutcome } from "./telemetry/command-terminal.js";
 export type OutputFormat = "table" | "json" | "yaml" | "plain";
+/**
+ * Per-row highlight for interactive TABLE output only. Applied line-level
+ * AFTER column padding, so width math never sees escape bytes; json/yaml/plain
+ * and piped output never receive it (the gate lives in `logOutput`).
+ */
+export type TableRowStyle = "red" | "dim";
+/** Chooses a highlight for a (PascalCase-normalized) table row, or none. */
+export type TableRowStyleFn = (row: Record<string, unknown>) => TableRowStyle | undefined;
 export type ResultType = "Success" | "Failure" | "ConfigError" | "AuthenticationError" | "ValidationError" | "TimeoutError";
 export type FailureResultType = Exclude<ResultType, "Success">;
 export declare const CLI_ERROR_CODES: readonly ["invalid_argument", "authentication_required", "permission_denied", "local_permission_denied", "not_found", "rate_limited", "network_error", "timeout", "server_error", "method_not_allowed", "configuration_error", "unknown_error"];
@@ -87,6 +95,11 @@ export interface ErrorContext {
     method?: string;
     /** Distributed-tracing id parsed from the backend error body when present. */
     traceId?: string;
+    /** How many times the CLI tried the failing request before giving up
+     *  (1 = single attempt). Set by commands that retry internally, so a caller
+     *  can tell a one-off blip from a sustained outage without re-running the
+     *  command N times itself. UV-15707. */
+    attempts?: number;
     /** Local filesystem path the OS refused access to. Set only for
      *  `local_permission_denied` failures — it is the one datum a caller
      *  needs to decide which permission to grant. */
@@ -219,16 +232,32 @@ export declare namespace OutputFormatter {
      * receives `InputString` while its schema requires `inputString`). With
      * this flag the `Data` payload keeps its original casing; the envelope
      * keys (`Result`/`Code`/`Data`/`Log`/…) are still PascalCased.
+     *
+     * Pass an **array of field names** instead when only part of the payload is
+     * user data — `{ preserveDataKeys: ["arguments"] }` PascalCases the DTO's
+     * own field names as usual but copies the contents of every `arguments`
+     * field through untouched, at any depth and whatever the caller's casing.
+     * Use it for maps whose keys the user chose (pipeline argument names):
+     * those are values that happen to sit in key position, so renaming them
+     * corrupts data rather than tidying a field name. Preserved subtrees survive
+     * `--output-filter` too, including a projection that lifts one out of the
+     * field that named it (`--output-filter Arguments`).
+     *
+     * Pass `{ tableRowStyle }` to highlight rows in interactive TABLE output
+     * (e.g. `uip tools list` marking off-line tools). The hook receives each
+     * normalized (PascalCase) row; it is ignored for json/yaml/plain and
+     * whenever output is piped, so structured output stays byte-clean.
      */
     function success(data: SuccessOutput, options?: {
-        preserveDataKeys?: boolean;
+        preserveDataKeys?: boolean | readonly string[];
+        tableRowStyle?: TableRowStyleFn;
     }): void;
     /**
-     * Format and display an error, then set {@link process.exitCode} to the
-     * value from {@link EXIT_CODES} for `data.Result` (falls back to 1).
+     * Format and display an error, then record the exit code from
+     * {@link EXIT_CODES} for `data.Result` (falls back to 1).
      *
-     * **Side-effect:** sets `process.exitCode` so the process exits with a
-     * non-zero status even if no explicit `process.exit()` call follows.
+     * **Side-effect:** records the exit code through {@link setExitCode}, so a
+     * printed failure exits non-zero even when no `context.exit()` follows.
      */
     function error(data: FailureOutput): void;
     /** Emit a list result. Always uses `Result: "Success"` — an empty list is not an error. */

package/dist/index.browser.d.ts

@@ -6,9 +6,11 @@ export * from "./completer";
 export { installConsoleGuard, restoreConsole } from "./console-guard";
 export * from "./constants";
 export * from "./content-hash";
+export * from "./entity-name-rules";
 export * from "./env-reference";
 export * from "./error-handler";
 export * from "./error-instructions";
+export * from "./exit-code";
 export * from "./guid";
 export * from "./logger";
 export * from "./option-validators";
@@ -31,4 +33,5 @@ export * from "./telemetry/telemetry-events.js";
 export type { ITelemetryProvider } from "./telemetry/telemetry-provider.js";
 export type { ITelemetryService, TelemetryContext, TelemetryProperties, } from "./telemetry/telemetry-service.js";
 export { TelemetryService } from "./telemetry/telemetry-service.js";
+export * from "./timings";
 export * from "./tool-provider";