@uipath/data-fabric-tool 1.1.0 → 1.195.0

package/dist/tool.js

@@ -667,6 +667,7 @@ var init_open = __esm(() => {
 });
 
 // ../filesystem/src/node.ts
+import { randomUUID } from "node:crypto";
 import { existsSync } from "node:fs";
 import * as fs6 from "node:fs/promises";
 import * as os2 from "node:os";
@@ -748,6 +749,90 @@ class NodeFileSystem {
   async mkdir(dirPath) {
     await fs6.mkdir(dirPath, { recursive: true });
   }
+  async acquireLock(lockPath) {
+    const canonicalPath = await this.canonicalizeLockTarget(lockPath);
+    const lockFile = `${canonicalPath}.lock`;
+    const ownerId = randomUUID();
+    const start = Date.now();
+    while (true) {
+      try {
+        await fs6.writeFile(lockFile, ownerId, { flag: "wx" });
+        return this.createLockRelease(lockFile, ownerId);
+      } catch (error) {
+        if (!this.hasErrnoCode(error, "EEXIST")) {
+          throw error;
+        }
+        const stats = await fs6.stat(lockFile).catch(() => null);
+        if (stats && Date.now() - stats.mtimeMs > LOCK_STALE_MS) {
+          const reclaimed = await fs6.rm(lockFile, { force: true }).then(() => true).catch(() => false);
+          if (reclaimed)
+            continue;
+        }
+        if (Date.now() - start > LOCK_MAX_WAIT_MS) {
+          throw new Error(`ELOCKED: timed out waiting for lock on ${canonicalPath}`);
+        }
+        await new Promise((resolve2) => setTimeout(resolve2, LOCK_RETRY_MIN_MS + Math.random() * LOCK_RETRY_JITTER_MS));
+      }
+    }
+  }
+  async canonicalizeLockTarget(lockPath) {
+    const absolute = path2.resolve(lockPath);
+    const fullReal = await fs6.realpath(absolute).catch(() => null);
+    if (fullReal)
+      return fullReal;
+    const parent = path2.dirname(absolute);
+    const base = path2.basename(absolute);
+    const canonicalParent = await fs6.realpath(parent).catch(() => parent);
+    return path2.join(canonicalParent, base);
+  }
+  createLockRelease(lockFile, ownerId) {
+    const heartbeatStart = Date.now();
+    let heartbeatTimer;
+    let stopped = false;
+    const stopHeartbeat = () => {
+      stopped = true;
+      if (heartbeatTimer)
+        clearTimeout(heartbeatTimer);
+    };
+    const scheduleNextHeartbeat = () => {
+      if (stopped)
+        return;
+      if (Date.now() - heartbeatStart >= LOCK_MAX_HOLD_MS) {
+        stopped = true;
+        return;
+      }
+      heartbeatTimer = setTimeout(() => {
+        runHeartbeat();
+      }, LOCK_HEARTBEAT_MS);
+      heartbeatTimer.unref?.();
+    };
+    const runHeartbeat = async () => {
+      if (stopped)
+        return;
+      const current = await fs6.readFile(lockFile, "utf-8").catch(() => null);
+      if (stopped)
+        return;
+      if (current !== ownerId) {
+        stopped = true;
+        return;
+      }
+      const now = Date.now() / 1000;
+      await fs6.utimes(lockFile, now, now).catch(() => {});
+      scheduleNextHeartbeat();
+    };
+    scheduleNextHeartbeat();
+    let released = false;
+    return async () => {
+      if (released)
+        return;
+      released = true;
+      stopHeartbeat();
+      const current = await fs6.readFile(lockFile, "utf-8").catch(() => null);
+      if (current === ownerId) {
+        await fs6.rm(lockFile, { force: true });
+      }
+    };
+  }
   async rm(filePath) {
     await fs6.rm(filePath, { recursive: true, force: true });
   }
@@ -793,9 +878,13 @@ class NodeFileSystem {
     }
   }
   isEnoent(error) {
-    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+    return this.hasErrnoCode(error, "ENOENT");
+  }
+  hasErrnoCode(error, code) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === code;
   }
 }
+var LOCK_HEARTBEAT_MS = 5000, LOCK_STALE_MS = 15000, LOCK_MAX_WAIT_MS = 20000, LOCK_MAX_HOLD_MS = 60000, LOCK_RETRY_MIN_MS = 100, LOCK_RETRY_JITTER_MS = 200;
 var init_node = __esm(() => {
   init_open();
 });
@@ -2941,7 +3030,7 @@ function isBrowser() {
 
 // ../../node_modules/@uipath/coreipc/index.js
 var require_coreipc = __commonJS((exports, module) => {
-  var __dirname = "/Users/alexandru.oltean/github/cli/node_modules/@uipath/coreipc";
+  var __dirname = "/home/runner/work/cli/cli/node_modules/@uipath/coreipc";
   /*! For license information please see index.js.LICENSE.txt */
   (function(e, t) {
     typeof exports == "object" && typeof module == "object" ? module.exports = t() : typeof define == "function" && define.amd ? define([], t) : typeof exports == "object" ? exports.ipc = t() : e.ipc = t();
@@ -21133,6 +21222,10 @@ var require_dist = __commonJS((exports) => {
   exports.RobotProxyConstructor = RobotProxyConstructor;
   __exportStar(require_agent(), exports);
 });
+// ../auth/src/server.ts
+var init_server = __esm(() => {
+  init_constants();
+});
 
 // ../../node_modules/@opentelemetry/api/build/src/version.js
 var require_version = __commonJS((exports) => {
@@ -22614,7 +22707,7 @@ var require_src = __commonJS((exports) => {
   };
 });
 
-// ../../node_modules/@opentelemetry/api-logs/build/src/types/LogRecord.js
+// ../../node_modules/@opentelemetry/sdk-logs/node_modules/@opentelemetry/api-logs/build/src/types/LogRecord.js
 var require_LogRecord = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.SeverityNumber = undefined;
@@ -22648,7 +22741,7 @@ var require_LogRecord = __commonJS((exports) => {
   })(SeverityNumber = exports.SeverityNumber || (exports.SeverityNumber = {}));
 });
 
-// ../../node_modules/@opentelemetry/api-logs/build/src/NoopLogger.js
+// ../../node_modules/@opentelemetry/sdk-logs/node_modules/@opentelemetry/api-logs/build/src/NoopLogger.js
 var require_NoopLogger = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.NOOP_LOGGER = exports.NoopLogger = undefined;
@@ -22660,7 +22753,7 @@ var require_NoopLogger = __commonJS((exports) => {
   exports.NOOP_LOGGER = new NoopLogger;
 });
 
-// ../../node_modules/@opentelemetry/api-logs/build/src/NoopLoggerProvider.js
+// ../../node_modules/@opentelemetry/sdk-logs/node_modules/@opentelemetry/api-logs/build/src/NoopLoggerProvider.js
 var require_NoopLoggerProvider = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.NOOP_LOGGER_PROVIDER = exports.NoopLoggerProvider = undefined;
@@ -22675,7 +22768,7 @@ var require_NoopLoggerProvider = __commonJS((exports) => {
   exports.NOOP_LOGGER_PROVIDER = new NoopLoggerProvider;
 });
 
-// ../../node_modules/@opentelemetry/api-logs/build/src/ProxyLogger.js
+// ../../node_modules/@opentelemetry/sdk-logs/node_modules/@opentelemetry/api-logs/build/src/ProxyLogger.js
 var require_ProxyLogger = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.ProxyLogger = undefined;
@@ -22706,7 +22799,7 @@ var require_ProxyLogger = __commonJS((exports) => {
   exports.ProxyLogger = ProxyLogger;
 });
 
-// ../../node_modules/@opentelemetry/api-logs/build/src/ProxyLoggerProvider.js
+// ../../node_modules/@opentelemetry/sdk-logs/node_modules/@opentelemetry/api-logs/build/src/ProxyLoggerProvider.js
 var require_ProxyLoggerProvider = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.ProxyLoggerProvider = undefined;
@@ -22733,14 +22826,14 @@ var require_ProxyLoggerProvider = __commonJS((exports) => {
   exports.ProxyLoggerProvider = ProxyLoggerProvider;
 });
 
-// ../../node_modules/@opentelemetry/api-logs/build/src/platform/node/globalThis.js
+// ../../node_modules/@opentelemetry/sdk-logs/node_modules/@opentelemetry/api-logs/build/src/platform/node/globalThis.js
 var require_globalThis = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports._globalThis = undefined;
   exports._globalThis = typeof globalThis === "object" ? globalThis : global;
 });
 
-// ../../node_modules/@opentelemetry/api-logs/build/src/platform/node/index.js
+// ../../node_modules/@opentelemetry/sdk-logs/node_modules/@opentelemetry/api-logs/build/src/platform/node/index.js
 var require_node = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports._globalThis = undefined;
@@ -22750,7 +22843,7 @@ var require_node = __commonJS((exports) => {
   } });
 });
 
-// ../../node_modules/@opentelemetry/api-logs/build/src/platform/index.js
+// ../../node_modules/@opentelemetry/sdk-logs/node_modules/@opentelemetry/api-logs/build/src/platform/index.js
 var require_platform = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports._globalThis = undefined;
@@ -22760,7 +22853,7 @@ var require_platform = __commonJS((exports) => {
   } });
 });
 
-// ../../node_modules/@opentelemetry/api-logs/build/src/internal/global-utils.js
+// ../../node_modules/@opentelemetry/sdk-logs/node_modules/@opentelemetry/api-logs/build/src/internal/global-utils.js
 var require_global_utils2 = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.API_BACKWARDS_COMPATIBILITY_VERSION = exports.makeGetter = exports._global = exports.GLOBAL_LOGS_API_KEY = undefined;
@@ -22774,7 +22867,7 @@ var require_global_utils2 = __commonJS((exports) => {
   exports.API_BACKWARDS_COMPATIBILITY_VERSION = 1;
 });
 
-// ../../node_modules/@opentelemetry/api-logs/build/src/api/logs.js
+// ../../node_modules/@opentelemetry/sdk-logs/node_modules/@opentelemetry/api-logs/build/src/api/logs.js
 var require_logs = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.LogsAPI = undefined;
@@ -22815,7 +22908,7 @@ var require_logs = __commonJS((exports) => {
   exports.LogsAPI = LogsAPI;
 });
 
-// ../../node_modules/@opentelemetry/api-logs/build/src/index.js
+// ../../node_modules/@opentelemetry/sdk-logs/node_modules/@opentelemetry/api-logs/build/src/index.js
 var require_src2 = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.logs = exports.ProxyLoggerProvider = exports.ProxyLogger = exports.NoopLoggerProvider = exports.NOOP_LOGGER_PROVIDER = exports.NoopLogger = exports.NOOP_LOGGER = exports.SeverityNumber = undefined;
@@ -27069,7 +27162,8 @@ var require_src6 = __commonJS((exports) => {
 // package.json
 var package_default = {
   name: "@uipath/data-fabric-tool",
-  version: "1.1.0",
+  license: "MIT",
+  version: "1.195.0",
   description: "Manage Data Fabric entities and records.",
   type: "module",
   main: "./dist/tool.js",
@@ -27092,7 +27186,7 @@ var package_default = {
     "@uipath/common": "workspace:*",
     "@uipath/auth": "workspace:*",
     "@uipath/filesystem": "workspace:*",
-    "@uipath/uipath-typescript": "^1.3.7",
+    "@uipath/uipath-typescript": "^1.3.11",
     "@types/node": "^25.5.2",
     typescript: "^6.0.2"
   }
@@ -27235,10 +27329,15 @@ async function extractErrorDetails(error, options) {
   }
   if (parsedBody?.errorCode && typeof parsedBody.errorCode === "string") {
     context.errorCode = parsedBody.errorCode;
+  } else if (parsedBody?.code && typeof parsedBody.code === "string") {
+    context.errorCode = parsedBody.code;
   }
   if (parsedBody?.requestId && typeof parsedBody.requestId === "string") {
     context.requestId = parsedBody.requestId;
   }
+  if (parsedBody?.traceId && typeof parsedBody.traceId === "string") {
+    context.traceId = parsedBody.traceId;
+  }
   if (status === 429) {
     const resp = response;
     const headersObj = resp?.headers;
@@ -27258,7 +27357,35 @@ async function extractErrorDetails(error, options) {
     }
   }
   const hasContext = Object.keys(context).length > 0;
-  return { result, message, details, ...hasContext ? { context } : {} };
+  let parsedErrors;
+  if (parsedBody?.errors && typeof parsedBody.errors === "object") {
+    const errors = {};
+    for (const [field, raw] of Object.entries(parsedBody.errors)) {
+      if (Array.isArray(raw)) {
+        const messages = raw.map((entry) => {
+          if (typeof entry === "string")
+            return entry;
+          if (entry && typeof entry === "object" && typeof entry.message === "string") {
+            return entry.message;
+          }
+          return String(entry);
+        }).filter(Boolean);
+        if (messages.length > 0)
+          errors[field] = messages;
+      } else if (typeof raw === "string") {
+        errors[field] = [raw];
+      }
+    }
+    if (Object.keys(errors).length > 0)
+      parsedErrors = errors;
+  }
+  return {
+    result,
+    message,
+    details,
+    ...hasContext ? { context } : {},
+    ...parsedErrors ? { parsedErrors } : {}
+  };
 }
 async function extractErrorMessage(error, options) {
   const { message } = await extractErrorDetails(error, options);
@@ -32405,6 +32532,60 @@ function escapeNonAscii(jsonText) {
 function needsAsciiSafeJson(sink) {
   return process.platform === "win32" && !sink.capabilities.isInteractive;
 }
+function isPlainRecord(value) {
+  if (value === null || typeof value !== "object")
+    return false;
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+function toLowerCamelCaseKey(key) {
+  if (!key)
+    return key;
+  if (/[_\-\s]/.test(key)) {
+    const [firstPart, ...restParts] = key.split(/[_\-\s]+/).filter(Boolean);
+    if (!firstPart)
+      return key;
+    return [
+      toLowerCamelCaseSimpleKey(firstPart),
+      ...restParts.map((part) => {
+        const normalized = toLowerCamelCaseSimpleKey(part);
+        return normalized.charAt(0).toUpperCase() + normalized.slice(1);
+      })
+    ].join("");
+  }
+  return toLowerCamelCaseSimpleKey(key);
+}
+function toLowerCamelCaseSimpleKey(key) {
+  if (/^[A-Z0-9]+$/.test(key))
+    return key.toLowerCase();
+  return key.replace(/^[A-Z]+(?=[A-Z][a-z]|\d|$)|^[A-Z]/, (match) => match.toLowerCase());
+}
+function toPascalCaseKey(key) {
+  const lowerCamelKey = toLowerCamelCaseKey(key);
+  return lowerCamelKey ? lowerCamelKey.charAt(0).toUpperCase() + lowerCamelKey.slice(1) : lowerCamelKey;
+}
+function toPascalCaseData(value) {
+  if (Array.isArray(value))
+    return value.map(toPascalCaseData);
+  if (!isPlainRecord(value))
+    return value;
+  const result = {};
+  for (const [key, nestedValue] of Object.entries(value)) {
+    result[toPascalCaseKey(key)] = toPascalCaseData(nestedValue);
+  }
+  return result;
+}
+function normalizeDataKeys(data) {
+  return toPascalCaseData(data);
+}
+function normalizeOutputKeys(data) {
+  const result = {};
+  for (const [key, value] of Object.entries(data)) {
+    const pascalKey = toPascalCaseKey(key);
+    result[pascalKey] = pascalKey === "Data" ? value : toPascalCaseData(value);
+  }
+  return result;
+}
 function printOutput(data, format = "json", logFn, asciiSafe = false) {
   if (!data) {
     logFn("Empty response object. No data to display.");
@@ -32467,7 +32648,7 @@ function wrapText(text, width) {
 function printTable(data, logFn, externalLogValue) {
   if (data.length === 0)
     return;
-  const keys = Object.keys(data[0]).filter((key) => key !== "Code" && key !== "Log");
+  const keys = Object.keys(data[0]).filter((key) => !["code", "log"].includes(key.toLowerCase()));
   const maxWidths = keys.map((key) => Math.max(key.length, ...data.map((item) => cellToString(item[key]).length)));
   const header = keys.map((key, i2) => key.padEnd(maxWidths[i2])).join(" | ");
   logFn(header);
@@ -32482,7 +32663,7 @@ function printTable(data, logFn, externalLogValue) {
   }
 }
 function printVerticalTable(data, logFn = console.log, externalLogValue) {
-  const keys = Object.keys(data).filter((key) => key !== "Code" && key !== "Log");
+  const keys = Object.keys(data).filter((key) => !["code", "log"].includes(key.toLowerCase()));
   if (keys.length === 0)
     return;
   const maxKeyWidth = Math.max(...keys.map((key) => key.length));
@@ -32498,7 +32679,7 @@ function printVerticalTable(data, logFn = console.log, externalLogValue) {
 function printResizableTable(data, logFn = console.log, externalLogValue) {
   if (data.length === 0)
     return;
-  const keys = Object.keys(data[0]).filter((key) => key !== "Code" && key !== "Log");
+  const keys = Object.keys(data[0]).filter((key) => !["code", "log"].includes(key.toLowerCase()));
   if (keys.length === 0)
     return;
   if (!process.stdout.isTTY) {
@@ -32574,8 +32755,26 @@ function printResizableTable(data, logFn = console.log, externalLogValue) {
 function toYaml(data) {
   return dump(data);
 }
+class FilterEvaluationError extends Error {
+  __brand = "FilterEvaluationError";
+  filter;
+  instructions;
+  result = RESULTS.ValidationError;
+  constructor(filter, cause) {
+    const underlying = cause instanceof Error ? cause.message : String(cause);
+    super(`Filter '${filter}' failed to evaluate: ${underlying}`);
+    this.name = "FilterEvaluationError";
+    this.filter = filter;
+    this.instructions = `The --output-filter expression '${filter}' failed at evaluation time. ` + "Note that --output-filter operates on the 'Data' field of the envelope, not the full object. " + "For example, on a list result use 'length(@)' instead of 'Data | length(@)'.";
+  }
+}
 function applyFilter(data, filter) {
-  const result = search(data, filter);
+  let result;
+  try {
+    result = search(data, filter);
+  } catch (err) {
+    throw new FilterEvaluationError(filter, err);
+  }
   if (result == null)
     return [];
   if (Array.isArray(result)) {
@@ -32592,13 +32791,18 @@ function applyFilter(data, filter) {
 }
 var OutputFormatter;
 ((OutputFormatter) => {
-  function success(data) {
+  function success(data, options) {
     data.Log ??= getLogFilePath() || undefined;
+    const normalize = !options?.preserveDataKeys;
+    if (normalize) {
+      data.Data = normalizeDataKeys(data.Data);
+    }
     const filter = getOutputFilter();
     if (filter) {
-      data.Data = applyFilter(data.Data, filter);
+      const filtered = applyFilter(data.Data, filter);
+      data.Data = normalize ? normalizeDataKeys(filtered) : filtered;
     }
-    logOutput(data, getOutputFormat());
+    logOutput(normalizeOutputKeys(data), getOutputFormat());
   }
   OutputFormatter.success = success;
   function error(data) {
@@ -32608,7 +32812,7 @@ var OutputFormatter;
       result: data.Result,
       message: data.Message
     });
-    logOutput(data, getOutputFormat());
+    logOutput(normalizeOutputKeys(data), getOutputFormat());
   }
   OutputFormatter.error = error;
   function emitList(code, items, opts) {
@@ -32629,13 +32833,14 @@ var OutputFormatter;
   function log(data) {
     const format = getOutputFormat();
     const sink = getOutputSink();
+    const normalized = toPascalCaseData(data);
     if (format === "json") {
-      const json2 = JSON.stringify(data);
+      const json2 = JSON.stringify(normalized);
       const safe = needsAsciiSafeJson(sink) ? escapeNonAscii(json2) : json2;
       sink.writeErr(`${safe}
 `);
     } else {
-      for (const [key, value] of Object.entries(data)) {
+      for (const [key, value] of Object.entries(normalized)) {
         sink.writeErr(`${key}: ${value}
 `);
       }
@@ -32644,12 +32849,16 @@ var OutputFormatter;
   OutputFormatter.log = log;
   function formatToString(data) {
     const filter = getOutputFilter();
-    if (filter && "Data" in data && data.Data != null) {
-      data.Data = applyFilter(data.Data, filter);
+    if ("Data" in data && data.Data != null) {
+      data.Data = normalizeDataKeys(data.Data);
+      if (filter) {
+        data.Data = normalizeDataKeys(applyFilter(data.Data, filter));
+      }
     }
+    const output = normalizeOutputKeys(data);
     const lines = [];
     const sink = getOutputSink();
-    printOutput(data, getOutputFormat(), (msg) => {
+    printOutput(output, getOutputFormat(), (msg) => {
       lines.push(msg);
     }, needsAsciiSafeJson(sink));
     return lines.join(`
@@ -34077,6 +34286,22 @@ function warnDeprecatedTenantOption(tenant) {
     return;
   warnDeprecatedOptionAlias("--tenant", TENANT_SWITCH_COMMAND);
 }
+// ../common/src/polling/types.ts
+var PollOutcome = {
+  Completed: "completed",
+  Timeout: "timeout",
+  Interrupted: "interrupted",
+  Aborted: "aborted",
+  Failed: "failed"
+};
+
+// ../common/src/polling/poll-failure-mapping.ts
+var REASON_BY_OUTCOME = {
+  [PollOutcome.Timeout]: "poll_timeout",
+  [PollOutcome.Failed]: "poll_failed",
+  [PollOutcome.Interrupted]: "poll_failed",
+  [PollOutcome.Aborted]: "poll_aborted"
+};
 // ../common/src/polling/terminal-statuses.ts
 var TERMINAL_STATUSES = new Set([
   "completed",
@@ -34104,6 +34329,8 @@ var ScreenLogger;
   }
   ScreenLogger.progress = progress;
 })(ScreenLogger ||= {});
+// ../common/src/sdk-user-agent.ts
+var sdkUserAgentHostToken = singleton("SdkUserAgentHostToken");
 // ../common/src/tool-provider.ts
 var factorySlot = singleton("PackagerFactoryProvider");
 // ../common/src/telemetry/pii-redactor.ts
@@ -34286,13 +34513,17 @@ Command.prototype.trackedAction = function(context, fn, properties) {
     const [error] = await catchError(fn(...args));
     if (error) {
       errorMessage = error instanceof Error ? error.message : String(error);
-      logger.error(`[trackedAction] ${telemetryName} failed: ${errorMessage}`);
+      logger.debug(`[trackedAction] ${telemetryName} failed: ${errorMessage}`);
+      const typed = error;
+      const customInstructions = typeof typed.instructions === "string" ? typed.instructions : undefined;
+      const customResult = typeof typed.result === "string" && typed.result !== RESULTS.Success && Object.values(RESULTS).includes(typed.result) ? typed.result : undefined;
+      const finalResult = customResult ?? RESULTS.Failure;
       OutputFormatter.error({
-        Result: RESULTS.Failure,
+        Result: finalResult,
         Message: errorMessage,
-        Instructions: "An unexpected error occurred. Run with --log-level debug for details."
+        Instructions: customInstructions ?? "An unexpected error occurred. Run with --log-level debug for details."
       });
-      context.exit(1);
+      context.exit(EXIT_CODES[finalResult]);
     }
     const durationMs = performance.now() - startTime;
     const success = !error && (process.exitCode === undefined || process.exitCode === 0);
@@ -34305,16 +34536,26 @@ Command.prototype.trackedAction = function(context, fn, properties) {
     }));
   });
 };
-// src/utils/pagination.ts
-function extractCursorValue(cursor) {
-  if (cursor === undefined || cursor === null)
-    return;
-  if (typeof cursor === "string")
-    return cursor;
-  const c = cursor;
-  if (typeof c.value === "string")
-    return c.value;
-  return;
+// src/utils/output.ts
+function fail(message, instructions) {
+  OutputFormatter.error({
+    Result: RESULTS.Failure,
+    Message: message,
+    Instructions: instructions
+  });
+  processContext.exit(1);
+}
+function requireDestructiveConfirmation(options, reasonInstruction) {
+  if (options.confirm !== true) {
+    fail("Confirmation required for destructive operation", "Pass --confirm to acknowledge this is irreversible.");
+    return null;
+  }
+  const reason = options.reason?.trim();
+  if (reason === undefined || reason === "") {
+    fail("Reason required for destructive operation", reasonInstruction);
+    return null;
+  }
+  return reason;
 }
 
 // ../auth/src/config.ts
@@ -34341,32 +34582,7 @@ class InvalidBaseUrlError extends Error {
     this.name = "InvalidBaseUrlError";
   }
 }
-var DEFAULT_SCOPES = [
-  "offline_access",
-  "ProcessMining",
-  "OrchestratorApiUserAccess",
-  "StudioWebBackend",
-  "IdentityServerApi",
-  "ConnectionService",
-  "DataService",
-  "DataServiceApiUserAccess",
-  "DocumentUnderstanding",
-  "EnterpriseContextService",
-  "Directory",
-  "JamJamApi",
-  "LLMGateway",
-  "LLMOps",
-  "OMS",
-  "RCS.FolderAuthorization",
-  "RCS.TagsManagement",
-  "TestmanagerApiUserAccess",
-  "AutomationSolutions",
-  "StudioWebTypeCacheService",
-  "Docs.GPT.Search",
-  "Insights",
-  "ReferenceToken",
-  "Audit.Read"
-];
+var DEFAULT_SCOPES = ["openid", "profile", "offline_access"];
 var normalizeAndValidateBaseUrl = (rawUrl) => {
   let baseUrl = rawUrl;
   if (baseUrl.endsWith("/identity_/")) {
@@ -34416,7 +34632,8 @@ var resolveConfigAsync = async ({
   if (!clientSecret && fileAuth.clientSecret) {
     clientSecret = fileAuth.clientSecret;
   }
-  const scopes = customScopes && customScopes.length > 0 ? customScopes : fileAuth.scopes && fileAuth.scopes.length > 0 ? fileAuth.scopes : DEFAULT_SCOPES;
+  const isExternalAppAuth = clientId !== DEFAULT_CLIENT_ID && Boolean(clientSecret);
+  const scopes = customScopes && customScopes.length > 0 ? customScopes : fileAuth.scopes && fileAuth.scopes.length > 0 ? fileAuth.scopes : isExternalAppAuth ? [] : DEFAULT_SCOPES;
   return {
     clientId,
     clientSecret,
@@ -34916,6 +35133,129 @@ function normalizeTokenRefreshFailure() {
 function normalizeTokenRefreshUnavailableFailure() {
   return "token refresh failed before authentication completed";
 }
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function computeExpirationThreshold(ensureTokenValidityMinutes) {
+  return new Date(Date.now() + (ensureTokenValidityMinutes ?? 0) * 60 * 1000);
+}
+async function runRefreshLocked(inputs) {
+  const {
+    absolutePath,
+    refreshToken: callerRefreshToken,
+    customAuthority,
+    ensureTokenValidityMinutes,
+    loadEnvFile,
+    saveEnvFile,
+    refreshFn,
+    resolveConfig
+  } = inputs;
+  const expirationThreshold = computeExpirationThreshold(ensureTokenValidityMinutes);
+  let fresh;
+  try {
+    fresh = await loadEnvFile({ envPath: absolutePath });
+  } catch (error) {
+    return {
+      kind: "fail",
+      status: {
+        loginStatus: "Refresh Failed",
+        hint: "Could not read the auth file while refreshing. Retry, or run 'uip login' to re-authenticate.",
+        tokenRefresh: {
+          attempted: false,
+          success: false,
+          errorMessage: `auth file read failed: ${errorMessage(error)}`
+        }
+      }
+    };
+  }
+  const freshAccess = fresh.UIPATH_ACCESS_TOKEN;
+  const freshExp = freshAccess ? getTokenExpiration(freshAccess) : undefined;
+  if (freshAccess && freshExp && freshExp > expirationThreshold) {
+    return {
+      kind: "ok",
+      accessToken: freshAccess,
+      refreshToken: fresh.UIPATH_REFRESH_TOKEN ?? callerRefreshToken,
+      expiration: freshExp,
+      tokenRefresh: { attempted: false, success: true }
+    };
+  }
+  const tokenForIdP = fresh.UIPATH_REFRESH_TOKEN ?? callerRefreshToken;
+  let refreshedAccess;
+  let refreshedRefresh;
+  try {
+    const config = await resolveConfig({ customAuthority });
+    const refreshed = await refreshFn({
+      refreshToken: tokenForIdP,
+      tokenEndpoint: config.tokenEndpoint,
+      clientId: config.clientId,
+      expectedAuthority: customAuthority
+    });
+    refreshedAccess = refreshed.accessToken;
+    refreshedRefresh = refreshed.refreshToken;
+  } catch (error) {
+    const isOAuthFailure = isTokenRefreshOAuthFailure(error);
+    const hint = isOAuthFailure ? "Run 'uip login' to re-authenticate — the stored refresh token is invalid or expired." : "Token refresh failed. Check your network connection, then retry or run 'uip login' to re-authenticate.";
+    const message = isOAuthFailure ? normalizeTokenRefreshFailure() : normalizeTokenRefreshUnavailableFailure();
+    return {
+      kind: "fail",
+      status: {
+        loginStatus: "Refresh Failed",
+        hint,
+        tokenRefresh: {
+          attempted: true,
+          success: false,
+          errorMessage: message
+        }
+      }
+    };
+  }
+  const refreshedExp = getTokenExpiration(refreshedAccess);
+  if (!refreshedExp || refreshedExp <= new Date) {
+    return {
+      kind: "fail",
+      status: {
+        loginStatus: "Refresh Failed",
+        hint: "The identity server returned an unusable token. Run 'uip login' to re-authenticate.",
+        tokenRefresh: {
+          attempted: true,
+          success: false,
+          errorMessage: "refreshed token has no valid expiration claim"
+        }
+      }
+    };
+  }
+  try {
+    await saveEnvFile({
+      envPath: absolutePath,
+      data: {
+        UIPATH_ACCESS_TOKEN: refreshedAccess,
+        UIPATH_REFRESH_TOKEN: refreshedRefresh
+      },
+      merge: true
+    });
+    return {
+      kind: "ok",
+      accessToken: refreshedAccess,
+      refreshToken: refreshedRefresh,
+      expiration: refreshedExp,
+      tokenRefresh: { attempted: true, success: true }
+    };
+  } catch (error) {
+    const msg = errorMessage(error);
+    return {
+      kind: "ok",
+      accessToken: refreshedAccess,
+      refreshToken: refreshedRefresh,
+      expiration: refreshedExp,
+      persistenceWarning: `Access token refreshed in memory but could not be written to ${absolutePath}: ${msg}. The next CLI invocation will fail until the file can be updated — run 'uip login' to re-authenticate.`,
+      tokenRefresh: {
+        attempted: true,
+        success: true,
+        errorMessage: `persistence failed: ${msg}`
+      }
+    };
+  }
+}
 var getLoginStatusWithDeps = async (options = {}, deps = {}) => {
   const {
     resolveEnvFilePath = resolveEnvFilePathAsync,
@@ -34990,73 +35330,103 @@ var getLoginStatusWithDeps = async (options = {}, deps = {}) => {
   let refreshToken = credentials.UIPATH_REFRESH_TOKEN;
   let expiration = getTokenExpiration(accessToken);
   let persistenceWarning;
+  let lockReleaseFailed = false;
   let tokenRefresh;
-  const expirationThreshold = new Date(Date.now() + (ensureTokenValidityMinutes ?? 0) * 60 * 1000);
-  if (expiration && expiration <= expirationThreshold && refreshToken) {
-    let refreshedAccess;
-    let refreshedRefresh;
+  const outerThreshold = computeExpirationThreshold(ensureTokenValidityMinutes);
+  const tryGlobalCredsHint = async () => {
+    const fs7 = getFs();
+    const globalPath = fs7.path.join(fs7.env.homedir(), envFilePath);
+    if (absolutePath === globalPath)
+      return;
+    if (!await fs7.exists(globalPath))
+      return;
     try {
-      const config = await resolveConfig({
-        customAuthority: credentials.UIPATH_URL
-      });
-      const refreshed = await refreshTokenFn({
-        refreshToken,
-        tokenEndpoint: config.tokenEndpoint,
-        clientId: config.clientId,
-        expectedAuthority: credentials.UIPATH_URL
-      });
-      refreshedAccess = refreshed.accessToken;
-      refreshedRefresh = refreshed.refreshToken;
-    } catch (error) {
-      const isOAuthFailure = isTokenRefreshOAuthFailure(error);
-      const hint = isOAuthFailure ? "Run 'uip login' to re-authenticate — the stored refresh token is invalid or expired." : "Token refresh failed. Check your network connection, then retry or run 'uip login' to re-authenticate.";
-      const errorMessage = isOAuthFailure ? normalizeTokenRefreshFailure() : normalizeTokenRefreshUnavailableFailure();
-      return {
-        loginStatus: "Refresh Failed",
-        hint,
-        tokenRefresh: {
-          attempted: true,
-          success: false,
-          errorMessage
-        }
-      };
+      const globalCreds = await loadEnvFile({ envPath: globalPath });
+      if (!globalCreds.UIPATH_ACCESS_TOKEN)
+        return;
+      const globalExp = getTokenExpiration(globalCreds.UIPATH_ACCESS_TOKEN);
+      if (globalExp && globalExp <= new Date)
+        return;
+      return `Local credentials file at ${absolutePath} has expired credentials. Valid credentials exist in ${globalPath}. Remove the local file or run 'uip login' to re-authenticate.`;
+    } catch {
+      return;
     }
-    const refreshedExp = getTokenExpiration(refreshedAccess);
-    if (!refreshedExp || refreshedExp <= new Date) {
+  };
+  if (expiration && expiration <= outerThreshold && refreshToken) {
+    let release;
+    try {
+      release = await getFs().acquireLock(absolutePath);
+    } catch (error) {
+      const msg = errorMessage(error);
+      const globalHint = await tryGlobalCredsHint();
+      if (globalHint) {
+        return {
+          loginStatus: "Expired",
+          accessToken,
+          refreshToken,
+          baseUrl: credentials.UIPATH_URL,
+          organizationName: credentials.UIPATH_ORGANIZATION_NAME,
+          organizationId: credentials.UIPATH_ORGANIZATION_ID,
+          tenantName: credentials.UIPATH_TENANT_NAME,
+          tenantId: credentials.UIPATH_TENANT_ID,
+          expiration,
+          source: "file" /* File */,
+          hint: globalHint,
+          tokenRefresh: {
+            attempted: false,
+            success: false,
+            errorMessage: `lock acquisition failed: ${msg}`
+          }
+        };
+      }
       return {
         loginStatus: "Refresh Failed",
-        hint: "The identity server returned an unusable token. Run 'uip login' to re-authenticate.",
+        hint: "Could not acquire the auth-file lock — too many concurrent `uip` processes, or a permission issue on the auth directory. Retry, or run 'uip login' to re-authenticate.",
         tokenRefresh: {
-          attempted: true,
+          attempted: false,
           success: false,
-          errorMessage: "refreshed token has no valid expiration claim"
+          errorMessage: `lock acquisition failed: ${msg}`
         }
       };
     }
-    accessToken = refreshedAccess;
-    refreshToken = refreshedRefresh;
-    expiration = refreshedExp;
+    let lockedFailure;
     try {
-      await saveEnvFile({
-        envPath: absolutePath,
-        data: {
-          UIPATH_ACCESS_TOKEN: accessToken,
-          UIPATH_REFRESH_TOKEN: refreshToken
-        },
-        merge: true
+      const outcome = await runRefreshLocked({
+        absolutePath,
+        refreshToken,
+        customAuthority: credentials.UIPATH_URL,
+        ensureTokenValidityMinutes,
+        loadEnvFile,
+        saveEnvFile,
+        refreshFn: refreshTokenFn,
+        resolveConfig
       });
-      tokenRefresh = {
-        attempted: true,
-        success: true
-      };
-    } catch (error) {
-      const msg = error instanceof Error ? error.message : String(error);
-      persistenceWarning = `Access token refreshed in memory but could not be written to ${absolutePath}: ${msg}. The next CLI invocation will fail until the file can be updated — run 'uip login' to re-authenticate.`;
-      tokenRefresh = {
-        attempted: true,
-        success: true,
-        errorMessage: `persistence failed: ${msg}`
-      };
+      if (outcome.kind === "fail") {
+        lockedFailure = outcome.status;
+      } else {
+        accessToken = outcome.accessToken;
+        refreshToken = outcome.refreshToken;
+        expiration = outcome.expiration;
+        tokenRefresh = outcome.tokenRefresh;
+        if (outcome.persistenceWarning) {
+          persistenceWarning = outcome.persistenceWarning;
+        }
+      }
+    } finally {
+      try {
+        await release();
+      } catch {
+        lockReleaseFailed = true;
+      }
+    }
+    if (lockedFailure) {
+      const globalHint = await tryGlobalCredsHint();
+      const base = globalHint ? {
+        ...lockedFailure,
+        loginStatus: "Expired",
+        hint: globalHint
+      } : lockedFailure;
+      return lockReleaseFailed ? { ...base, lockReleaseFailed: true } : base;
     }
   }
   const result = {
@@ -35071,23 +35441,13 @@ var getLoginStatusWithDeps = async (options = {}, deps = {}) => {
     expiration,
     source: "file" /* File */,
     ...persistenceWarning ? { hint: persistenceWarning, persistenceFailed: true } : {},
+    ...lockReleaseFailed ? { lockReleaseFailed: true } : {},
     ...tokenRefresh ? { tokenRefresh } : {}
   };
   if (result.loginStatus === "Expired") {
-    const fs7 = getFs();
-    const globalPath = fs7.path.join(fs7.env.homedir(), envFilePath);
-    if (absolutePath !== globalPath && await fs7.exists(globalPath)) {
-      try {
-        const globalCreds = await loadEnvFile({
-          envPath: globalPath
-        });
-        if (globalCreds.UIPATH_ACCESS_TOKEN) {
-          const globalExp = getTokenExpiration(globalCreds.UIPATH_ACCESS_TOKEN);
-          if (!globalExp || globalExp > new Date) {
-            result.hint = `Local credentials file at ${absolutePath} has expired credentials. Valid credentials exist in ${globalPath}. Remove the local file or run 'uip login' to re-authenticate.`;
-          }
-        }
-      } catch {}
+    const globalHint = await tryGlobalCredsHint();
+    if (globalHint) {
+      result.hint = globalHint;
     }
   }
   return result;
@@ -35104,8 +35464,246 @@ var getLoginStatusAsync = async (options = {}) => {
 init_src();
 // ../auth/src/logout.ts
 init_src();
-// ../../node_modules/@uipath/uipath-typescript/dist/index.mjs
+
+// ../auth/src/index.ts
+init_server();
+
+// ../../node_modules/@uipath/core-telemetry/dist/index.mjs
 var import_sdk_logs = __toESM(require_src6(), 1);
+var CONNECTION_STRING = "InstrumentationKey=a6efa11d-1feb-4508-9738-e13e12dcae5e;IngestionEndpoint=https://westeurope-5.in.applicationinsights.azure.com/;LiveEndpoint=https://westeurope.livediagnostics.monitor.azure.com/;ApplicationId=7c58eb1c-9581-4ba6-839e-11725848a037";
+var VERSION = "Version";
+var SERVICE = "Service";
+var CLOUD_ORGANIZATION_NAME = "CloudOrganizationName";
+var CLOUD_TENANT_NAME = "CloudTenantName";
+var CLOUD_URL = "CloudUrl";
+var CLOUD_CLIENT_ID = "CloudClientId";
+var CLOUD_REDIRECT_URI = "CloudRedirectUri";
+var APP_NAME = "ApplicationName";
+var UNKNOWN = "";
+var INSTRUMENTATION_KEY_RE = /InstrumentationKey=([^;]+)/;
+var INGESTION_ENDPOINT_RE = /IngestionEndpoint=([^;]+)/;
+
+class ApplicationInsightsEventExporter {
+  constructor(connectionString, tags) {
+    this.connectionString = connectionString;
+    this.tags = tags;
+  }
+  export(logs, resultCallback) {
+    try {
+      for (const log of logs) {
+        this.sendAsCustomEvent(log);
+      }
+      resultCallback({ code: 0 });
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error(String(error));
+      console.debug("Failed to export logs to Application Insights:", err);
+      resultCallback({ code: 1, error: err });
+    }
+  }
+  shutdown() {
+    return Promise.resolve();
+  }
+  sendAsCustomEvent(logRecord) {
+    const eventName = String(logRecord.body);
+    const payload = {
+      name: "Microsoft.ApplicationInsights.Event",
+      time: new Date().toISOString(),
+      iKey: this.extractInstrumentationKey(),
+      data: {
+        baseType: "EventData",
+        baseData: {
+          ver: 2,
+          name: eventName,
+          properties: this.convertAttributesToProperties(logRecord.attributes)
+        }
+      },
+      tags: {
+        "ai.cloud.role": this.tags.cloudRoleName,
+        "ai.cloud.roleInstance": this.tags.cloudRoleInstance
+      }
+    };
+    this.sendToApplicationInsights(payload);
+  }
+  extractInstrumentationKey() {
+    const match = INSTRUMENTATION_KEY_RE.exec(this.connectionString);
+    return match ? match[1] : "";
+  }
+  convertAttributesToProperties(attributes) {
+    const properties = {};
+    for (const [key, value] of Object.entries(attributes ?? {})) {
+      properties[key] = String(value);
+    }
+    return properties;
+  }
+  async sendToApplicationInsights(payload) {
+    try {
+      const ingestionEndpoint = this.extractIngestionEndpoint();
+      if (!ingestionEndpoint) {
+        console.debug("No ingestion endpoint found in connection string");
+        return;
+      }
+      const url = `${ingestionEndpoint}/v2/track`;
+      const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload)
+      });
+      if (!response.ok) {
+        console.debug(`Failed to send event telemetry: ${response.status} ${response.statusText}`);
+      }
+    } catch (error) {
+      console.debug("Error sending event telemetry to Application Insights:", error);
+    }
+  }
+  extractIngestionEndpoint() {
+    const match = INGESTION_ENDPOINT_RE.exec(this.connectionString);
+    return match ? match[1] : "";
+  }
+}
+
+class TelemetryClient {
+  constructor() {
+    this.isInitialized = false;
+  }
+  initialize(options) {
+    if (this.isInitialized) {
+      console.debug("Telemetry client has already been initialized");
+      return;
+    }
+    this.isInitialized = true;
+    this.options = options;
+    this.telemetryContext = options.context;
+    try {
+      if (!this.isValidConnectionString(CONNECTION_STRING)) {
+        return;
+      }
+      this.setupTelemetryProvider(CONNECTION_STRING);
+    } catch (error) {
+      console.debug("Failed to initialize telemetry:", error);
+    }
+  }
+  track(eventName, name, extraAttributes = {}) {
+    try {
+      if (!this.logger) {
+        return;
+      }
+      const finalDisplayName = name ?? eventName;
+      const attributes = this.getEnrichedAttributes(extraAttributes, eventName);
+      this.logger.emit({
+        body: finalDisplayName,
+        attributes,
+        timestamp: Date.now()
+      });
+    } catch (error) {
+      console.debug("Failed to track telemetry event:", error);
+    }
+  }
+  getDefaultEventName() {
+    return this.options?.defaultEventName;
+  }
+  setupTelemetryProvider(connectionString) {
+    const opts = this.options;
+    const exporter = new ApplicationInsightsEventExporter(connectionString, {
+      cloudRoleName: opts.cloudRoleName,
+      cloudRoleInstance: opts.sdkVersion
+    });
+    const processor = new import_sdk_logs.BatchLogRecordProcessor(exporter);
+    this.logProvider = new import_sdk_logs.LoggerProvider({
+      processors: [processor]
+    });
+    this.logger = this.logProvider.getLogger(opts.loggerName);
+  }
+  isValidConnectionString(connectionString) {
+    return Boolean(connectionString) && !connectionString.startsWith("$");
+  }
+  getEnrichedAttributes(extraAttributes, eventName) {
+    const opts = this.options;
+    return {
+      [APP_NAME]: opts?.serviceName ?? UNKNOWN,
+      [VERSION]: opts?.sdkVersion ?? UNKNOWN,
+      [SERVICE]: eventName,
+      [CLOUD_URL]: this.createCloudUrl(),
+      [CLOUD_ORGANIZATION_NAME]: this.telemetryContext?.orgName ?? UNKNOWN,
+      [CLOUD_TENANT_NAME]: this.telemetryContext?.tenantName ?? UNKNOWN,
+      [CLOUD_REDIRECT_URI]: this.telemetryContext?.redirectUri ?? UNKNOWN,
+      [CLOUD_CLIENT_ID]: this.telemetryContext?.clientId ?? UNKNOWN,
+      ...extraAttributes
+    };
+  }
+  createCloudUrl() {
+    const baseUrl = this.telemetryContext?.baseUrl;
+    const orgId = this.telemetryContext?.orgName;
+    const tenantId = this.telemetryContext?.tenantName;
+    if (!baseUrl || !orgId || !tenantId) {
+      return UNKNOWN;
+    }
+    return `${baseUrl}/${orgId}/${tenantId}`;
+  }
+}
+var REGISTRY_KEY = Symbol.for("@uipath/core-telemetry/clients");
+function getGlobalRegistry() {
+  const holder = globalThis;
+  let registry2 = holder[REGISTRY_KEY];
+  if (!registry2) {
+    registry2 = {};
+    holder[REGISTRY_KEY] = registry2;
+  }
+  return registry2;
+}
+function getOrCreateClient(name) {
+  const registry2 = getGlobalRegistry();
+  if (!registry2[name]) {
+    registry2[name] = new TelemetryClient;
+  }
+  return registry2[name];
+}
+function createTrackedFunction(originalFunction, { client, nameOrOptions, fallbackName, opts }) {
+  const wrapped = function(...args) {
+    let shouldTrack = true;
+    if (opts.condition !== undefined) {
+      shouldTrack = typeof opts.condition === "function" ? opts.condition.apply(this, args) : opts.condition;
+    }
+    if (shouldTrack) {
+      const serviceMethod = typeof nameOrOptions === "string" ? nameOrOptions : fallbackName;
+      client.track(serviceMethod, client.getDefaultEventName(), opts.attributes);
+    }
+    return originalFunction.apply(this, args);
+  };
+  return wrapped;
+}
+function createTrack(client) {
+  function trackFactory(nameOrOptions, options) {
+    const opts = typeof nameOrOptions === "object" ? nameOrOptions : options ?? {};
+    function decoratorImpl(target, propertyKey, descriptor) {
+      if (descriptor && typeof descriptor.value === "function") {
+        const original = descriptor.value;
+        descriptor.value = createTrackedFunction(original, {
+          client,
+          nameOrOptions,
+          fallbackName: typeof propertyKey === "string" ? propertyKey : "unknown_method",
+          opts
+        });
+        return descriptor;
+      }
+      const fn = target;
+      return createTrackedFunction(fn, {
+        client,
+        nameOrOptions,
+        fallbackName: fn.name || "unknown_function",
+        opts
+      });
+    }
+    return decoratorImpl;
+  }
+  return trackFactory;
+}
+function createTrackEvent(client) {
+  return function trackEvent(eventName, name, attributes) {
+    client.track(eventName, name, attributes);
+  };
+}
+
+// ../../node_modules/@uipath/uipath-typescript/dist/index.mjs
 function __decorate(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
@@ -38988,6 +39586,7 @@ var ORCHESTRATOR_BASE = "orchestrator_";
 var PIMS_BASE = "pims_";
 var DATAFABRIC_BASE = "datafabric_";
 var IDENTITY_BASE = "identity_";
+var INSIGHTS_RTM_BASE = "insightsrtm_";
 var TASK_ENDPOINTS = {
   CREATE_GENERIC_TASK: `${ORCHESTRATOR_BASE}/tasks/GenericTasks/CreateTask`,
   GET_TASK_USERS: (folderId) => `${ORCHESTRATOR_BASE}/odata/Tasks/UiPath.Server.Configuration.OData.GetTaskUsers(organizationUnitId=${folderId})`,
@@ -39010,7 +39609,9 @@ var BUCKET_ENDPOINTS = {
   GET_BY_ID: (id) => `${ORCHESTRATOR_BASE}/odata/Buckets(${id})`,
   GET_FILE_META_DATA: (id) => `${ORCHESTRATOR_BASE}/api/Buckets/${id}/ListFiles`,
   GET_READ_URI: (id) => `${ORCHESTRATOR_BASE}/odata/Buckets(${id})/UiPath.Server.Configuration.OData.GetReadUri`,
-  GET_WRITE_URI: (id) => `${ORCHESTRATOR_BASE}/odata/Buckets(${id})/UiPath.Server.Configuration.OData.GetWriteUri`
+  GET_WRITE_URI: (id) => `${ORCHESTRATOR_BASE}/odata/Buckets(${id})/UiPath.Server.Configuration.OData.GetWriteUri`,
+  DELETE_FILE: (id) => `${ORCHESTRATOR_BASE}/odata/Buckets(${id})/UiPath.Server.Configuration.OData.DeleteFile`,
+  GET_FILES: (id) => `${ORCHESTRATOR_BASE}/odata/Buckets(${id})/UiPath.Server.Configuration.OData.GetFiles`
 };
 var PROCESS_ENDPOINTS = {
   GET_ALL: `${ORCHESTRATOR_BASE}/odata/Releases`,
@@ -39061,6 +39662,15 @@ var MAESTRO_ENDPOINTS = {
     GET_CASE_JSON: (instanceId) => `${PIMS_BASE}/api/v1/cases/${instanceId}/case-json`,
     GET_ELEMENT_EXECUTIONS: (instanceId) => `${PIMS_BASE}/api/v1/element-executions/case-instances/${instanceId}`,
     REOPEN: (instanceId) => `${PIMS_BASE}/api/v1/cases/${instanceId}/reopen`
+  },
+  INSIGHTS: {
+    SLA_SUMMARY: `${INSIGHTS_RTM_BASE}/caseManagement/slaSummary`,
+    STAGES_SUMMARY: `${INSIGHTS_RTM_BASE}/caseManagement/stages`,
+    TOP_PROCESSES_BY_RUN_COUNT: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopProcessesByRunCount`,
+    TOP_PROCESSES_WITH_FAILURE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopProcesseswithFailure`,
+    TOP_ELEMENTS_WITH_FAILURE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopElementswithFailure`,
+    INSTANCE_STATUS_BY_DATE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/InstanceStatusByDate`,
+    TOP_PROCESSES_BY_DURATION: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopProcessesByDuration`
   }
 };
 var DATA_FABRIC_TENANT_FOLDER_ID = "00000000-0000-0000-0000-000000000000";
@@ -39087,7 +39697,13 @@ var DATA_FABRIC_ENDPOINTS = {
   },
   CHOICESETS: {
     GET_ALL: `${DATAFABRIC_BASE}/api/Entity/choiceset`,
-    GET_BY_ID: (choiceSetId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${choiceSetId}/query_expansion`
+    GET_BY_ID: (choiceSetId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${choiceSetId}/query_expansion`,
+    CREATE: `${DATAFABRIC_BASE}/api/Entity/choiceset`,
+    UPDATE: (choiceSetId) => `${DATAFABRIC_BASE}/api/Entity/${choiceSetId}/metadata`,
+    DELETE: (choiceSetId) => `${DATAFABRIC_BASE}/api/Entity/${choiceSetId}/delete`,
+    INSERT_BY_NAME: (choiceSetName) => `${DATAFABRIC_BASE}/api/EntityService/${choiceSetName}/choiceset/insert`,
+    UPDATE_BY_NAME: (choiceSetName, valueId) => `${DATAFABRIC_BASE}/api/EntityService/${choiceSetName}/choiceset/${valueId}/update`,
+    DELETE_BY_ID: (choiceSetId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${choiceSetId}/choiceset/delete`
   }
 };
 var IDENTITY_ENDPOINTS = {
@@ -39684,218 +40300,33 @@ function isCompleteConfig(config2) {
 function normalizeBaseUrl(url) {
   return url.endsWith("/") ? url.slice(0, -1) : url;
 }
-var CONNECTION_STRING = "InstrumentationKey=a6efa11d-1feb-4508-9738-e13e12dcae5e;IngestionEndpoint=https://westeurope-5.in.applicationinsights.azure.com/;LiveEndpoint=https://westeurope.livediagnostics.monitor.azure.com/;ApplicationId=7c58eb1c-9581-4ba6-839e-11725848a037";
-var SDK_VERSION = "1.3.7";
-var VERSION = "Version";
-var SERVICE = "Service";
-var CLOUD_ORGANIZATION_NAME = "CloudOrganizationName";
-var CLOUD_TENANT_NAME = "CloudTenantName";
-var CLOUD_URL = "CloudUrl";
-var CLOUD_CLIENT_ID = "CloudClientId";
-var CLOUD_REDIRECT_URI = "CloudRedirectUri";
-var APP_NAME = "ApplicationName";
+var SDK_VERSION = "1.3.11";
 var CLOUD_ROLE_NAME = "uipath-ts-sdk";
 var SDK_SERVICE_NAME = "UiPath.TypeScript.Sdk";
 var SDK_LOGGER_NAME = "uipath-ts-sdk-telemetry";
 var SDK_RUN_EVENT = "Sdk.Run";
-var UNKNOWN$1 = "";
-
-class ApplicationInsightsEventExporter {
-  constructor(connectionString) {
-    this.connectionString = connectionString;
-  }
-  export(logs, resultCallback) {
-    try {
-      logs.forEach((logRecord) => {
-        this.sendAsCustomEvent(logRecord);
-      });
-      resultCallback({ code: 0 });
-    } catch (error) {
-      console.debug("Failed to export logs to Application Insights:", error);
-      resultCallback({ code: 2, error });
-    }
-  }
-  shutdown() {
-    return Promise.resolve();
-  }
-  sendAsCustomEvent(logRecord) {
-    const eventName = logRecord.body || SDK_RUN_EVENT;
-    const payload = {
-      name: "Microsoft.ApplicationInsights.Event",
-      time: new Date().toISOString(),
-      iKey: this.extractInstrumentationKey(),
-      data: {
-        baseType: "EventData",
-        baseData: {
-          ver: 2,
-          name: eventName,
-          properties: this.convertAttributesToProperties(logRecord.attributes || {})
-        }
-      },
-      tags: {
-        "ai.cloud.role": CLOUD_ROLE_NAME,
-        "ai.cloud.roleInstance": SDK_VERSION
-      }
-    };
-    this.sendToApplicationInsights(payload);
-  }
-  extractInstrumentationKey() {
-    const match = this.connectionString.match(/InstrumentationKey=([^;]+)/);
-    return match ? match[1] : "";
-  }
-  convertAttributesToProperties(attributes) {
-    const properties = {};
-    Object.entries(attributes || {}).forEach(([key, value]) => {
-      properties[key] = String(value);
+var sdkClient = getOrCreateClient(CLOUD_ROLE_NAME);
+var track = createTrack(sdkClient);
+var trackEvent = createTrackEvent(sdkClient);
+var telemetryClient = {
+  initialize(context) {
+    sdkClient.initialize({
+      sdkVersion: SDK_VERSION,
+      serviceName: SDK_SERVICE_NAME,
+      cloudRoleName: CLOUD_ROLE_NAME,
+      loggerName: SDK_LOGGER_NAME,
+      defaultEventName: SDK_RUN_EVENT,
+      context
     });
-    return properties;
   }
-  async sendToApplicationInsights(payload) {
-    try {
-      const ingestionEndpoint = this.extractIngestionEndpoint();
-      if (!ingestionEndpoint) {
-        console.debug("No ingestion endpoint found in connection string");
-        return;
-      }
-      const url = `${ingestionEndpoint}/v2/track`;
-      const response = await fetch(url, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify(payload)
-      });
-      if (!response.ok) {
-        console.debug(`Failed to send event telemetry: ${response.status} ${response.statusText}`);
-      }
-    } catch (error) {
-      console.debug("Error sending event telemetry to Application Insights:", error);
-    }
-  }
-  extractIngestionEndpoint() {
-    const match = this.connectionString.match(/IngestionEndpoint=([^;]+)/);
-    return match ? match[1] : "";
-  }
-}
-
-class TelemetryClient {
-  constructor() {
-    this.isInitialized = false;
-  }
-  static getInstance() {
-    if (!TelemetryClient.instance) {
-      TelemetryClient.instance = new TelemetryClient;
-    }
-    return TelemetryClient.instance;
-  }
-  initialize(config2) {
-    if (this.isInitialized) {
-      return;
-    }
-    this.isInitialized = true;
-    if (config2) {
-      this.telemetryContext = config2;
-    }
-    try {
-      const connectionString = this.getConnectionString();
-      if (!connectionString) {
-        return;
-      }
-      this.setupTelemetryProvider(connectionString);
-    } catch (error) {
-      console.debug("Failed to initialize OpenTelemetry:", error);
-    }
-  }
-  getConnectionString() {
-    const connectionString = CONNECTION_STRING;
-    return connectionString;
-  }
-  setupTelemetryProvider(connectionString) {
-    const exporter = new ApplicationInsightsEventExporter(connectionString);
-    const processor = new import_sdk_logs.BatchLogRecordProcessor(exporter);
-    this.logProvider = new import_sdk_logs.LoggerProvider({
-      processors: [processor]
-    });
-    this.logger = this.logProvider.getLogger(SDK_LOGGER_NAME);
-  }
-  track(eventName, name, extraAttributes = {}) {
-    try {
-      if (!this.logger) {
-        return;
-      }
-      const finalDisplayName = name || eventName;
-      const attributes = this.getEnrichedAttributes(extraAttributes, eventName);
-      this.logger.emit({
-        body: finalDisplayName,
-        attributes,
-        timestamp: Date.now()
-      });
-    } catch (error) {
-      console.debug("Failed to track telemetry event:", error);
-    }
-  }
-  getEnrichedAttributes(extraAttributes, eventName) {
-    const attributes = {
-      [APP_NAME]: SDK_SERVICE_NAME,
-      [VERSION]: SDK_VERSION,
-      [SERVICE]: eventName,
-      [CLOUD_URL]: this.createCloudUrl(),
-      [CLOUD_ORGANIZATION_NAME]: this.telemetryContext?.orgName || UNKNOWN$1,
-      [CLOUD_TENANT_NAME]: this.telemetryContext?.tenantName || UNKNOWN$1,
-      [CLOUD_REDIRECT_URI]: this.telemetryContext?.redirectUri || UNKNOWN$1,
-      [CLOUD_CLIENT_ID]: this.telemetryContext?.clientId || UNKNOWN$1,
-      ...extraAttributes
-    };
-    return attributes;
-  }
-  createCloudUrl() {
-    const baseUrl = this.telemetryContext?.baseUrl;
-    const orgId = this.telemetryContext?.orgName;
-    const tenantId = this.telemetryContext?.tenantName;
-    if (!baseUrl || !orgId || !tenantId) {
-      return UNKNOWN$1;
-    }
-    return `${baseUrl}/${orgId}/${tenantId}`;
-  }
-}
-var telemetryClient = TelemetryClient.getInstance();
-function createTrackedFunction(originalFunction, nameOrOptions, fallbackName, opts) {
-  return function(...args) {
-    let shouldTrack = true;
-    if (opts.condition !== undefined) {
-      if (typeof opts.condition === "function") {
-        shouldTrack = opts.condition.apply(this, args);
-      } else {
-        shouldTrack = opts.condition;
-      }
-    }
-    if (shouldTrack) {
-      const serviceMethod = typeof nameOrOptions === "string" ? nameOrOptions : fallbackName;
-      telemetryClient.track(serviceMethod, SDK_RUN_EVENT, opts.attributes);
-    }
-    return originalFunction.apply(this, args);
-  };
-}
-function track(nameOrOptions, options) {
-  return function decorator(_target, propertyKey, descriptor) {
-    const opts = typeof nameOrOptions === "object" ? nameOrOptions : options || {};
-    if (descriptor && typeof descriptor.value === "function") {
-      descriptor.value = createTrackedFunction(descriptor.value, nameOrOptions, propertyKey || "unknown_method", opts);
-      return descriptor;
-    }
-    return (originalFunction) => createTrackedFunction(originalFunction, nameOrOptions, originalFunction.name || "unknown_function", opts);
-  };
-}
-function trackEvent(eventName, name, attributes) {
-  telemetryClient.track(eventName, name, attributes);
-}
-var REGISTRY_KEY = Symbol.for("@uipath/sdk-internals-registry");
+};
+var REGISTRY_KEY2 = Symbol.for("@uipath/sdk-internals-registry");
 var getGlobalStore = () => {
   const globalObj = globalThis;
-  if (!globalObj[REGISTRY_KEY]) {
-    globalObj[REGISTRY_KEY] = new WeakMap;
+  if (!globalObj[REGISTRY_KEY2]) {
+    globalObj[REGISTRY_KEY2] = new WeakMap;
   }
-  return globalObj[REGISTRY_KEY];
+  return globalObj[REGISTRY_KEY2];
 };
 
 class SDKInternalsRegistry {
@@ -39995,8 +40426,8 @@ var UiPath$1 = class UiPath {
         __classPrivateFieldSet(this, _UiPath_initialized, true, "f");
       }
     } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : "An unknown error occurred";
-      throw new Error(`Failed to initialize UiPath SDK: ${errorMessage}`);
+      const errorMessage2 = error instanceof Error ? error.message : "An unknown error occurred";
+      throw new Error(`Failed to initialize UiPath SDK: ${errorMessage2}`);
     }
   }
   setMultiLogin() {
@@ -40025,8 +40456,8 @@ var UiPath$1 = class UiPath {
       }
       return false;
     } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : "An unknown error occurred";
-      throw new Error(`Failed to complete OAuth: ${errorMessage}`);
+      const errorMessage2 = error instanceof Error ? error.message : "An unknown error occurred";
+      throw new Error(`Failed to complete OAuth: ${errorMessage2}`);
     }
   }
   isAuthenticated() {
@@ -40347,7 +40778,17 @@ class ApiClient {
       if (!text) {
         return;
       }
-      return JSON.parse(text);
+      try {
+        return JSON.parse(text);
+      } catch (error) {
+        if (error instanceof SyntaxError) {
+          throw new ServerError({
+            message: `Server returned non-JSON response (${response.status} ${response.url}): ${error.message}`,
+            statusCode: response.status
+          });
+        }
+        throw error;
+      }
     } catch (error) {
       if (error.type && error.type.includes("Error")) {
         throw error;
@@ -40376,6 +40817,22 @@ var PaginationType;
   PaginationType2["OFFSET"] = "offset";
   PaginationType2["TOKEN"] = "token";
 })(PaginationType || (PaginationType = {}));
+function resolveNestedField(data, fieldPath) {
+  if (!data) {
+    return;
+  }
+  if (fieldPath in data) {
+    return data[fieldPath];
+  }
+  if (!fieldPath.includes(".")) {
+    return;
+  }
+  let value = data;
+  for (const part of fieldPath.split(".")) {
+    value = value?.[part];
+  }
+  return value;
+}
 function filterUndefined(obj) {
   const result = {};
   for (const [key, value] of Object.entries(obj)) {
@@ -40490,7 +40947,7 @@ function createHeaders(headersObj) {
   return headers;
 }
 var ODATA_PREFIX = "$";
-var UNKNOWN = "Unknown";
+var UNKNOWN2 = "Unknown";
 var NO_INSTANCE = "no-instance";
 var HTTP_METHODS = {
   GET: "GET",
@@ -40512,6 +40969,15 @@ var BUCKET_PAGINATION = {
   ITEMS_FIELD: "items",
   CONTINUATION_TOKEN_FIELD: "continuationToken"
 };
+var SLA_SUMMARY_PAGINATION = {
+  ITEMS_FIELD: "data",
+  TOTAL_COUNT_FIELD: "pagination.totalCount"
+};
+var SLA_SUMMARY_OFFSET_PARAMS = {
+  PAGE_SIZE_PARAM: "PageSize",
+  OFFSET_PARAM: "PageNumber",
+  COUNT_PARAM: undefined
+};
 var PROCESS_INSTANCE_PAGINATION = {
   ITEMS_FIELD: "instances",
   CONTINUATION_TOKEN_FIELD: "nextPage"
@@ -40534,6 +41000,10 @@ var PROCESS_INSTANCE_TOKEN_PARAMS = {
   PAGE_SIZE_PARAM: "pageSize",
   TOKEN_PARAM: "nextPage"
 };
+function toISOUtc(value) {
+  const date2 = new Date(value + " UTC");
+  return isNaN(date2.getTime()) ? value : date2.toISOString();
+}
 function transformData(data, fieldMapping) {
   if (Array.isArray(data)) {
     return data.map((item) => transformData(item, fieldMapping));
@@ -40734,9 +41204,9 @@ class PaginationHelpers {
     }
   }
   static async getAllPaginated(params) {
-    const { serviceAccess, getEndpoint, folderId, paginationParams, additionalParams, transformFn, method = HTTP_METHODS.GET, options = {} } = params;
+    const { serviceAccess, getEndpoint, folderId, headers: providedHeaders, paginationParams, additionalParams, transformFn, method = HTTP_METHODS.GET, options = {} } = params;
     const endpoint = getEndpoint(folderId);
-    const headers = folderId ? createHeaders({ [FOLDER_ID]: folderId }) : {};
+    const headers = providedHeaders ?? (folderId ? createHeaders({ [FOLDER_ID]: folderId }) : {});
     const paginatedResponse = await serviceAccess.requestWithPagination(method, endpoint, paginationParams, {
       headers,
       params: additionalParams,
@@ -40757,11 +41227,11 @@ class PaginationHelpers {
     };
   }
   static async getAllNonPaginated(params) {
-    const { serviceAccess, getAllEndpoint, getByFolderEndpoint, folderId, additionalParams, transformFn, method = HTTP_METHODS.GET, options = {} } = params;
+    const { serviceAccess, getAllEndpoint, getByFolderEndpoint, folderId, headers: providedHeaders, additionalParams, transformFn, method = HTTP_METHODS.GET, options = {} } = params;
     const itemsField = options.itemsField || DEFAULT_ITEMS_FIELD;
     const totalCountField = options.totalCountField || DEFAULT_TOTAL_COUNT_FIELD;
     const endpoint = folderId ? getByFolderEndpoint : getAllEndpoint;
-    const headers = folderId ? createHeaders({ [FOLDER_ID]: folderId }) : {};
+    const headers = providedHeaders ?? (folderId ? createHeaders({ [FOLDER_ID]: folderId }) : {});
     let response;
     if (method === HTTP_METHODS.POST) {
       response = await serviceAccess.post(endpoint, additionalParams, { headers });
@@ -40772,7 +41242,8 @@ class PaginationHelpers {
       });
     }
     const rawItems = Array.isArray(response.data) ? response.data : response.data?.[itemsField];
-    const totalCount = Array.isArray(response.data) ? undefined : response.data?.[totalCountField];
+    const rawTotalCount = Array.isArray(response.data) ? undefined : resolveNestedField(response.data, totalCountField);
+    const totalCount = typeof rawTotalCount === "number" ? rawTotalCount : undefined;
     const parsedItems = typeof rawItems === "string" ? JSON.parse(rawItems) : rawItems || [];
     const items = transformFn ? parsedItems.map(transformFn) : parsedItems;
     return {
@@ -40802,6 +41273,7 @@ class PaginationHelpers {
         serviceAccess: config2.serviceAccess,
         getEndpoint: config2.getEndpoint,
         folderId,
+        headers: config2.headers,
         paginationParams: cursor ? { cursor, pageSize } : jumpToPage ? { jumpToPage, pageSize } : { pageSize },
         additionalParams: prefixedOptions,
         transformFn: config2.transformFn,
@@ -40818,6 +41290,7 @@ class PaginationHelpers {
       getAllEndpoint: config2.getEndpoint(),
       getByFolderEndpoint: byFolderEndpoint,
       folderId,
+      headers: config2.headers,
       additionalParams: prefixedOptions,
       transformFn: config2.transformFn,
       method: config2.method,
@@ -40927,9 +41400,14 @@ class BaseService {
         const pageSizeParam = paginationParams?.pageSizeParam || ODATA_OFFSET_PARAMS.PAGE_SIZE_PARAM;
         const offsetParam = paginationParams?.offsetParam || ODATA_OFFSET_PARAMS.OFFSET_PARAM;
         const countParam = paginationParams?.countParam || ODATA_OFFSET_PARAMS.COUNT_PARAM;
+        const convertToSkip = paginationParams?.convertToSkip ?? true;
         requestParams[pageSizeParam] = limitedPageSize;
-        if (params.pageNumber && params.pageNumber > 1) {
-          requestParams[offsetParam] = (params.pageNumber - 1) * limitedPageSize;
+        if (convertToSkip) {
+          if (params.pageNumber && params.pageNumber > 1) {
+            requestParams[offsetParam] = (params.pageNumber - 1) * limitedPageSize;
+          }
+        } else {
+          requestParams[offsetParam] = params.pageNumber || 1;
         }
         {
           requestParams[countParam] = true;
@@ -40953,7 +41431,8 @@ class BaseService {
     const totalCountField = fields.totalCountField || "totalRecordCount";
     const continuationTokenField = fields.continuationTokenField || "continuationToken";
     const items = Array.isArray(response.data) ? response.data : response.data[itemsField] || [];
-    const totalCount = Array.isArray(response.data) ? undefined : response.data[totalCountField];
+    const rawTotalCount = Array.isArray(response.data) ? undefined : resolveNestedField(response.data, totalCountField);
+    const totalCount = typeof rawTotalCount === "number" ? rawTotalCount : undefined;
     const continuationToken = response.data[continuationTokenField];
     const hasMore = this.determineHasMorePages(paginationType, {
       totalCount,
@@ -41439,10 +41918,6 @@ class EntityService extends BaseService {
     return this.insertRecordsById(id, data, options);
   }
   async create(name, fields, options) {
-    this.validateName(name, "entity");
-    for (const field of fields) {
-      this.validateName(field.fieldName, "field");
-    }
     const opts = options ?? {};
     const payload = {
       ...opts.description !== undefined && { description: opts.description },
@@ -41514,6 +41989,7 @@ class EntityService extends BaseService {
           ...update.isUnique !== undefined && { isUnique: update.isUnique },
           ...update.isRbacEnabled !== undefined && { isRbacEnabled: update.isRbacEnabled },
           ...update.isEncrypted !== undefined && { isEncrypted: update.isEncrypted },
+          ...update.isHiddenField !== undefined && { isHiddenField: update.isHiddenField },
           ...update.defaultValue !== undefined && { defaultValue: update.defaultValue },
           ...hasConstraintUpdate && f.sqlType && { sqlType: { ...f.sqlType, ...constraintUpdate } }
         };
@@ -41521,9 +41997,6 @@ class EntityService extends BaseService {
     }
     const newFields = [];
     if (options.addFields?.length) {
-      for (const field of options.addFields) {
-        this.validateName(field.fieldName, "field");
-      }
       newFields.push(...options.addFields.map((f) => this.buildSchemaFieldPayload(f)));
     }
     await this.post(DATA_FABRIC_ENDPOINTS.ENTITY.UPSERT, {
@@ -41594,9 +42067,15 @@ class EntityService extends BaseService {
     });
   }
   buildSchemaFieldPayload(field) {
-    this.validateName(field.fieldName, "field");
     const fieldType = field.type ?? EntityFieldDataType.STRING;
     this.validateFieldConstraints(fieldType, field, field.fieldName);
+    const isRelationship = fieldType === EntityFieldDataType.RELATIONSHIP;
+    const isFile = fieldType === EntityFieldDataType.FILE;
+    if ((isRelationship || isFile) && (!field.referenceEntityId || !field.referenceFieldId)) {
+      throw new ValidationError({
+        message: `Field '${field.fieldName}' of type ${fieldType} requires both referenceEntityId and referenceFieldId (UUIDs of the target entity and field).`
+      });
+    }
     const mapping = EntitySchemaFieldTypeMap[fieldType];
     return {
       name: field.fieldName,
@@ -41611,10 +42090,13 @@ class EntityService extends BaseService {
       isUnique: field.isUnique ?? false,
       isRbacEnabled: field.isRbacEnabled ?? false,
       isEncrypted: field.isEncrypted ?? false,
+      isHiddenField: field.isHiddenField ?? false,
       ...field.defaultValue !== undefined && { defaultValue: field.defaultValue },
       ...field.choiceSetId !== undefined && { choiceSetId: field.choiceSetId },
-      ...field.referenceEntityName !== undefined && { referenceEntityName: field.referenceEntityName },
-      ...field.referenceFieldName !== undefined && { referenceFieldName: field.referenceFieldName }
+      ...(isRelationship || isFile) && { isForeignKey: true },
+      ...isRelationship && { referenceType: ReferenceType.ManyToOne },
+      ...field.referenceEntityId !== undefined && { referenceEntity: { id: field.referenceEntityId } },
+      ...field.referenceFieldId !== undefined && { referenceField: { id: field.referenceFieldId } }
     };
   }
   resolveFieldDataType(f) {
@@ -41693,28 +42175,7 @@ class EntityService extends BaseService {
         return {};
     }
   }
-  validateName(name, context) {
-    if (name.length < 3 || name.length > 100 || !/^[a-zA-Z]\w*$/.test(name)) {
-      const suggestion = name.replace(/\W/g, "").replace(/^[0-9_]+/, "");
-      const defaultName = `My${context.charAt(0).toUpperCase() + context.slice(1)}`;
-      throw new ValidationError({
-        message: `Invalid ${context} name '${name}'. Must start with a letter, contain only letters, numbers, and underscores, 3–100 characters (e.g., "${suggestion || defaultName}").`
-      });
-    }
-    if (context === "field" && EntityService.RESERVED_FIELD_NAMES.has(name)) {
-      throw new ValidationError({
-        message: `Field name '${name}' is reserved. Reserved names: ${[...EntityService.RESERVED_FIELD_NAMES].join(", ")}.`
-      });
-    }
-  }
 }
-EntityService.RESERVED_FIELD_NAMES = new Set([
-  "Id",
-  "CreatedBy",
-  "CreateTime",
-  "UpdatedBy",
-  "UpdateTime"
-]);
 __decorate([
   track("Entities.GetById")
 ], EntityService.prototype, "getById", null);
@@ -41798,6 +42259,62 @@ class ChoiceSetService extends BaseService {
       }
     }, options);
   }
+  async create(name, options) {
+    const opts = options ?? {};
+    const payload = {
+      ...opts.description !== undefined && { description: opts.description },
+      ...opts.displayName !== undefined && { displayName: opts.displayName },
+      entityDefinition: {
+        name,
+        fields: [],
+        folderId: opts.folderKey ?? DATA_FABRIC_TENANT_FOLDER_ID
+      }
+    };
+    const response = await this.post(DATA_FABRIC_ENDPOINTS.CHOICESETS.CREATE, payload);
+    return response.data;
+  }
+  async updateById(choiceSetId, options) {
+    if (options.displayName === undefined && options.description === undefined) {
+      throw new ValidationError({
+        message: "updateById requires at least one of displayName or description."
+      });
+    }
+    await this.patch(DATA_FABRIC_ENDPOINTS.CHOICESETS.UPDATE(choiceSetId), {
+      ...options.displayName !== undefined && { displayName: options.displayName },
+      ...options.description !== undefined && { description: options.description }
+    });
+  }
+  async deleteById(choiceSetId) {
+    await this.post(DATA_FABRIC_ENDPOINTS.CHOICESETS.DELETE(choiceSetId), {});
+  }
+  async insertValueById(choiceSetId, name, options) {
+    const choiceSetName = await this.resolveChoiceSetName(choiceSetId);
+    const payload = {
+      Name: name,
+      ...options?.displayName !== undefined && { DisplayName: options.displayName }
+    };
+    const response = await this.post(DATA_FABRIC_ENDPOINTS.CHOICESETS.INSERT_BY_NAME(choiceSetName), payload);
+    const camelCased = pascalToCamelCaseKeys(response.data);
+    return transformData(camelCased, EntityMap);
+  }
+  async updateValueById(choiceSetId, valueId, displayName) {
+    const choiceSetName = await this.resolveChoiceSetName(choiceSetId);
+    const payload = { DisplayName: displayName };
+    const response = await this.post(DATA_FABRIC_ENDPOINTS.CHOICESETS.UPDATE_BY_NAME(choiceSetName, valueId), payload);
+    const camelCased = pascalToCamelCaseKeys(response.data);
+    return transformData(camelCased, EntityMap);
+  }
+  async deleteValuesById(choiceSetId, valueIds) {
+    await this.post(DATA_FABRIC_ENDPOINTS.CHOICESETS.DELETE_BY_ID(choiceSetId), valueIds);
+  }
+  async resolveChoiceSetName(choiceSetId) {
+    const all = await this.getAll();
+    const match = all.find((cs) => cs.id === choiceSetId);
+    if (!match) {
+      throw new NotFoundError({ message: `Choice set with id '${choiceSetId}' not found.` });
+    }
+    return match.name;
+  }
 }
 __decorate([
   track("Choicesets.GetAll")
@@ -41805,6 +42322,24 @@ __decorate([
 __decorate([
   track("Choicesets.GetById")
 ], ChoiceSetService.prototype, "getById", null);
+__decorate([
+  track("Choicesets.Create")
+], ChoiceSetService.prototype, "create", null);
+__decorate([
+  track("Choicesets.UpdateById")
+], ChoiceSetService.prototype, "updateById", null);
+__decorate([
+  track("Choicesets.DeleteById")
+], ChoiceSetService.prototype, "deleteById", null);
+__decorate([
+  track("Choicesets.InsertValueById")
+], ChoiceSetService.prototype, "insertValueById", null);
+__decorate([
+  track("Choicesets.UpdateValueById")
+], ChoiceSetService.prototype, "updateValueById", null);
+__decorate([
+  track("Choicesets.DeleteValuesById")
+], ChoiceSetService.prototype, "deleteValuesById", null);
 function createProcessMethods(processData, service) {
   return {
     async getIncidents() {
@@ -41820,6 +42355,30 @@ function createProcessWithMethods(processData, service) {
   const methods = createProcessMethods(processData, service);
   return Object.assign({}, processData, methods);
 }
+function buildInsightsTopBody(startTime, endTime, isCaseManagement, options) {
+  return {
+    commonParams: {
+      startTime: startTime.getTime(),
+      endTime: endTime.getTime(),
+      isCaseManagement,
+      ...options?.packageId ? { packageId: options.packageId } : {},
+      ...options?.processKey ? { processKey: options.processKey } : {},
+      ...options?.version ? { version: options.version } : {}
+    }
+  };
+}
+async function fetchInstanceStatusTimeline(postFn, startTime, endTime, isCaseManagement, options) {
+  const response = await postFn(MAESTRO_ENDPOINTS.INSIGHTS.INSTANCE_STATUS_BY_DATE, {
+    commonParams: {
+      startTime: startTime.getTime(),
+      endTime: endTime.getTime(),
+      isCaseManagement
+    },
+    timeSliceUnit: options?.groupBy,
+    timezoneOffset: new Date().getTimezoneOffset() * -1
+  });
+  return response.data ?? [];
+}
 var ProcessIncidentMap = {
   errorTimeUtc: "errorTime"
 };
@@ -41895,8 +42454,8 @@ class BpmnHelpers {
     const transformed = transformData(incident, ProcessIncidentMap);
     return {
       ...transformed,
-      incidentElementActivityType: element?.type || UNKNOWN,
-      incidentElementActivityName: element?.name || UNKNOWN
+      incidentElementActivityType: element?.type || UNKNOWN2,
+      incidentElementActivityName: element?.name || UNKNOWN2
     };
   }
 }
@@ -41978,6 +42537,29 @@ var DebugMode;
   DebugMode2["StepByStep"] = "StepByStep";
   DebugMode2["SingleStep"] = "SingleStep";
 })(DebugMode || (DebugMode = {}));
+var SlaSummaryStatus;
+(function(SlaSummaryStatus2) {
+  SlaSummaryStatus2["ON_TRACK"] = "On Track";
+  SlaSummaryStatus2["AT_RISK"] = "At Risk";
+  SlaSummaryStatus2["OVERDUE"] = "Overdue";
+  SlaSummaryStatus2["COMPLETED"] = "Completed";
+  SlaSummaryStatus2["UNKNOWN"] = "Unknown";
+})(SlaSummaryStatus || (SlaSummaryStatus = {}));
+var InstanceStatus;
+(function(InstanceStatus2) {
+  InstanceStatus2["UNKNOWN"] = "";
+  InstanceStatus2["CANCELLED"] = "Cancelled";
+  InstanceStatus2["CANCELING"] = "Canceling";
+  InstanceStatus2["COMPLETED"] = "Completed";
+  InstanceStatus2["FAULTED"] = "Faulted";
+  InstanceStatus2["PAUSED"] = "Paused";
+  InstanceStatus2["PAUSING"] = "Pausing";
+  InstanceStatus2["PENDING"] = "Pending";
+  InstanceStatus2["RESUMING"] = "Resuming";
+  InstanceStatus2["RETRYING"] = "Retrying";
+  InstanceStatus2["RUNNING"] = "Running";
+  InstanceStatus2["UPGRADING"] = "Upgrading";
+})(InstanceStatus || (InstanceStatus = {}));
 var StageTaskType;
 (function(StageTaskType2) {
   StageTaskType2["EXTERNAL_AGENT"] = "external-agent";
@@ -42000,6 +42582,7 @@ var EscalationTriggerType;
 (function(EscalationTriggerType2) {
   EscalationTriggerType2["SLA_BREACHED"] = "sla-breached";
   EscalationTriggerType2["AT_RISK"] = "at-risk";
+  EscalationTriggerType2["NONE"] = "None";
 })(EscalationTriggerType || (EscalationTriggerType = {}));
 var SLADurationUnit;
 (function(SLADurationUnit2) {
@@ -42056,6 +42639,16 @@ function createCaseInstanceMethods(instanceData, service) {
       if (!instanceData.instanceId)
         throw new Error("Case instance ID is undefined");
       return service.getActionTasks(instanceData.instanceId, options);
+    },
+    async getSlaSummary(options) {
+      if (!instanceData.instanceId)
+        throw new Error("Case instance ID is undefined");
+      return service.getSlaSummary({ ...options, caseInstanceId: instanceData.instanceId });
+    },
+    async getStagesSlaSummary() {
+      if (!instanceData.instanceId)
+        throw new Error("Case instance ID is undefined");
+      return service.getStagesSlaSummary({ caseInstanceId: instanceData.instanceId });
     }
   };
 }
@@ -42063,6 +42656,18 @@ function createCaseInstanceWithMethods(instanceData, service) {
   const methods = createCaseInstanceMethods(instanceData, service);
   return Object.assign({}, instanceData, methods);
 }
+var TimeInterval;
+(function(TimeInterval2) {
+  TimeInterval2["Hour"] = "HOUR";
+  TimeInterval2["Day"] = "DAY";
+  TimeInterval2["Week"] = "WEEK";
+})(TimeInterval || (TimeInterval = {}));
+var InstanceFinalStatus;
+(function(InstanceFinalStatus2) {
+  InstanceFinalStatus2["Completed"] = "Completed";
+  InstanceFinalStatus2["Faulted"] = "Faulted";
+  InstanceFinalStatus2["Cancelled"] = "Cancelled";
+})(InstanceFinalStatus || (InstanceFinalStatus = {}));
 var ProcessInstanceMap = {
   startedTimeUtc: "startedTime",
   completedTimeUtc: "completedTime",
@@ -42278,6 +42883,35 @@ class MaestroProcessesService extends BaseService {
     });
     return BpmnHelpers.enrichIncidentsWithBpmnData(rawResponse.data || [], folderKey, this.processInstancesService);
   }
+  async getTopRunCount(startTime, endTime, options) {
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_BY_RUN_COUNT, buildInsightsTopBody(startTime, endTime, false, options));
+    return (data ?? []).map((process10) => ({ ...process10, name: process10.packageId }));
+  }
+  async getTopElementFailedCount(startTime, endTime, options) {
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_ELEMENTS_WITH_FAILURE, buildInsightsTopBody(startTime, endTime, false, options));
+    return (data ?? []).map((item) => ({
+      elementName: item.elementName,
+      elementType: item.elementType,
+      processKey: item.processKey,
+      failedCount: item.count
+    }));
+  }
+  async getInstanceStatusTimeline(startTime, endTime, options) {
+    return fetchInstanceStatusTimeline(this.post.bind(this), startTime, endTime, false, options);
+  }
+  async getTopFaultedCount(startTime, endTime, options) {
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_WITH_FAILURE, buildInsightsTopBody(startTime, endTime, false, options));
+    return (data ?? []).map((item) => ({
+      packageId: item.packageId,
+      processKey: item.processKey,
+      faultedCount: item.runCount,
+      name: item.packageId
+    }));
+  }
+  async getTopExecutionDuration(startTime, endTime, options) {
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_BY_DURATION, buildInsightsTopBody(startTime, endTime, false, options));
+    return (data ?? []).map((process10) => ({ ...process10, name: process10.packageId }));
+  }
 }
 __decorate([
   track("MaestroProcesses.GetAll")
@@ -42285,6 +42919,21 @@ __decorate([
 __decorate([
   track("MaestroProcesses.GetIncidents")
 ], MaestroProcessesService.prototype, "getIncidents", null);
+__decorate([
+  track("MaestroProcesses.GetTopRunCount")
+], MaestroProcessesService.prototype, "getTopRunCount", null);
+__decorate([
+  track("MaestroProcesses.GetTopElementFailedCount")
+], MaestroProcessesService.prototype, "getTopElementFailedCount", null);
+__decorate([
+  track("MaestroProcesses.GetInstanceStatusTimeline")
+], MaestroProcessesService.prototype, "getInstanceStatusTimeline", null);
+__decorate([
+  track("MaestroProcesses.GetTopFaultedCount")
+], MaestroProcessesService.prototype, "getTopFaultedCount", null);
+__decorate([
+  track("MaestroProcesses.GetTopExecutionDuration")
+], MaestroProcessesService.prototype, "getTopExecutionDuration", null);
 
 class ProcessIncidentsService extends BaseService {
   async getAll() {
@@ -42313,6 +42962,35 @@ class CasesService extends BaseService {
       name: this.extractCaseName(caseItem.packageId)
     }));
   }
+  async getTopRunCount(startTime, endTime, options) {
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_BY_RUN_COUNT, buildInsightsTopBody(startTime, endTime, true, options));
+    return (data ?? []).map((process10) => ({ ...process10, name: this.extractCaseName(process10.packageId) }));
+  }
+  async getTopElementFailedCount(startTime, endTime, options) {
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_ELEMENTS_WITH_FAILURE, buildInsightsTopBody(startTime, endTime, true, options));
+    return (data ?? []).map((item) => ({
+      elementName: item.elementName,
+      elementType: item.elementType,
+      processKey: item.processKey,
+      failedCount: item.count
+    }));
+  }
+  async getInstanceStatusTimeline(startTime, endTime, options) {
+    return fetchInstanceStatusTimeline(this.post.bind(this), startTime, endTime, true, options);
+  }
+  async getTopFaultedCount(startTime, endTime, options) {
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_WITH_FAILURE, buildInsightsTopBody(startTime, endTime, true, options));
+    return (data ?? []).map((item) => ({
+      packageId: item.packageId,
+      processKey: item.processKey,
+      faultedCount: item.runCount,
+      name: this.extractCaseName(item.packageId)
+    }));
+  }
+  async getTopExecutionDuration(startTime, endTime, options) {
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_BY_DURATION, buildInsightsTopBody(startTime, endTime, true, options));
+    return (data ?? []).map((process10) => ({ ...process10, name: this.extractCaseName(process10.packageId) }));
+  }
   extractCaseName(packageId) {
     const caseManagementIndex = packageId.indexOf("CaseManagement.");
     if (caseManagementIndex !== -1) {
@@ -42325,6 +43003,21 @@ class CasesService extends BaseService {
 __decorate([
   track("Cases.GetAll")
 ], CasesService.prototype, "getAll", null);
+__decorate([
+  track("Cases.GetTopRunCount")
+], CasesService.prototype, "getTopRunCount", null);
+__decorate([
+  track("Cases.GetTopElementFailedCount")
+], CasesService.prototype, "getTopElementFailedCount", null);
+__decorate([
+  track("Cases.GetInstanceStatusTimeline")
+], CasesService.prototype, "getInstanceStatusTimeline", null);
+__decorate([
+  track("Cases.GetTopFaultedCount")
+], CasesService.prototype, "getTopFaultedCount", null);
+__decorate([
+  track("Cases.GetTopExecutionDuration")
+], CasesService.prototype, "getTopExecutionDuration", null);
 var CaseInstanceMap = {
   startedTimeUtc: "startedTime",
   completedTimeUtc: "completedTime",
@@ -42826,6 +43519,41 @@ class CaseInstancesService extends BaseService {
     };
     return await this.taskService.getAll(enhancedOptions);
   }
+  async getSlaSummary(options) {
+    const apiOptions = options ? {
+      ...options,
+      startTimeUtc: options.startTimeUtc?.toISOString(),
+      endTimeUtc: options.endTimeUtc?.toISOString()
+    } : undefined;
+    return PaginationHelpers.getAll({
+      serviceAccess: this.createPaginationServiceAccess(),
+      getEndpoint: () => MAESTRO_ENDPOINTS.INSIGHTS.SLA_SUMMARY,
+      method: HTTP_METHODS.POST,
+      excludeFromPrefix: ["caseInstanceId", "startTimeUtc", "endTimeUtc"],
+      transformFn: (item) => ({
+        ...item,
+        slaDueTime: toISOUtc(item.slaDueTime),
+        lastModifiedTime: toISOUtc(item.lastModifiedTime)
+      }),
+      pagination: {
+        paginationType: PaginationType.OFFSET,
+        itemsField: SLA_SUMMARY_PAGINATION.ITEMS_FIELD,
+        totalCountField: SLA_SUMMARY_PAGINATION.TOTAL_COUNT_FIELD,
+        paginationParams: {
+          pageSizeParam: SLA_SUMMARY_OFFSET_PARAMS.PAGE_SIZE_PARAM,
+          offsetParam: SLA_SUMMARY_OFFSET_PARAMS.OFFSET_PARAM,
+          countParam: SLA_SUMMARY_OFFSET_PARAMS.COUNT_PARAM,
+          convertToSkip: false
+        }
+      }
+    }, apiOptions);
+  }
+  async getStagesSlaSummary(options) {
+    const response = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.STAGES_SUMMARY, {
+      caseInstanceId: options?.caseInstanceId
+    });
+    return response.data ?? [];
+  }
 }
 __decorate([
   track("CaseInstances.GetAll")
@@ -42854,6 +43582,12 @@ __decorate([
 __decorate([
   track("CaseInstances.GetActionTasks")
 ], CaseInstancesService.prototype, "getActionTasks", null);
+__decorate([
+  track("CaseInstances.GetSlaSummary")
+], CaseInstancesService.prototype, "getSlaSummary", null);
+__decorate([
+  track("CaseInstances.GetStagesSlaSummary")
+], CaseInstancesService.prototype, "getStagesSlaSummary", null);
 function validateName(resourceType, name) {
   if (!name) {
     throw new ValidationError({
@@ -43050,6 +43784,9 @@ class BucketService extends FolderScopedService {
     });
     return pascalToCamelCaseKeys(response.data);
   }
+  async getByName(name, options = {}) {
+    return this.getByNameLookup("Bucket", BUCKET_ENDPOINTS.GET_BY_FOLDER, name, options, (raw) => pascalToCamelCaseKeys(raw));
+  }
   async getAll(options) {
     const transformBucketResponse = (bucket) => pascalToCamelCaseKeys(bucket);
     return PaginationHelpers.getAll({
@@ -43167,6 +43904,56 @@ class BucketService extends FolderScopedService {
     }
     return transformedData;
   }
+  async getFiles(bucketId, options) {
+    if (!bucketId) {
+      throw new ValidationError({ message: "bucketId is required for getFiles" });
+    }
+    const { folderId, folderKey, folderPath, ...restOptions } = options ?? {};
+    const headers = resolveFolderHeaders({
+      folderId,
+      folderKey,
+      folderPath,
+      resourceType: "Buckets.getFiles",
+      fallbackFolderKey: this.config.folderKey
+    });
+    const transformBucketFile = (file) => transformData(pascalToCamelCaseKeys(file), BucketMap);
+    return PaginationHelpers.getAll({
+      serviceAccess: this.createPaginationServiceAccess(),
+      getEndpoint: () => BUCKET_ENDPOINTS.GET_FILES(bucketId),
+      transformFn: transformBucketFile,
+      pagination: {
+        paginationType: PaginationType.OFFSET,
+        itemsField: ODATA_PAGINATION.ITEMS_FIELD,
+        totalCountField: ODATA_PAGINATION.TOTAL_COUNT_FIELD,
+        paginationParams: {
+          pageSizeParam: ODATA_OFFSET_PARAMS.PAGE_SIZE_PARAM,
+          offsetParam: ODATA_OFFSET_PARAMS.OFFSET_PARAM,
+          countParam: ODATA_OFFSET_PARAMS.COUNT_PARAM
+        }
+      },
+      excludeFromPrefix: ["directory", "recursive", "fileNameRegex"],
+      headers
+    }, { ...restOptions, directory: "/", recursive: true });
+  }
+  async deleteFile(bucketId, path3, options) {
+    if (!bucketId) {
+      throw new ValidationError({ message: "bucketId is required for deleteFile" });
+    }
+    if (!path3) {
+      throw new ValidationError({ message: "path is required for deleteFile" });
+    }
+    const headers = resolveFolderHeaders({
+      folderId: options?.folderId,
+      folderKey: options?.folderKey,
+      folderPath: options?.folderPath,
+      resourceType: "Buckets.deleteFile",
+      fallbackFolderKey: this.config.folderKey
+    });
+    await this.delete(BUCKET_ENDPOINTS.DELETE_FILE(bucketId), {
+      params: { path: path3 },
+      headers
+    });
+  }
   async _getWriteUri(options) {
     const { bucketId, folderId, path: path3, expiryInMinutes, ...restOptions } = options;
     const queryOptions = {
@@ -43179,6 +43966,9 @@ class BucketService extends FolderScopedService {
 __decorate([
   track("Buckets.GetById")
 ], BucketService.prototype, "getById", null);
+__decorate([
+  track("Buckets.GetByName")
+], BucketService.prototype, "getByName", null);
 __decorate([
   track("Buckets.GetAll")
 ], BucketService.prototype, "getAll", null);
@@ -43191,6 +43981,12 @@ __decorate([
 __decorate([
   track("Buckets.GetReadUri")
 ], BucketService.prototype, "getReadUri", null);
+__decorate([
+  track("Buckets.GetFiles")
+], BucketService.prototype, "getFiles", null);
+__decorate([
+  track("Buckets.DeleteFile")
+], BucketService.prototype, "deleteFile", null);
 var BucketOptions;
 (function(BucketOptions2) {
   BucketOptions2["None"] = "None";
@@ -43650,14 +44446,34 @@ class ProcessService extends FolderScopedService {
       }
     }, options);
   }
-  async start(request, folderId, options = {}) {
-    const headers = createHeaders({ [FOLDER_ID]: folderId });
+  async start(request, optionsOrFolderId, legacyOptions) {
+    let folderId;
+    let folderKey;
+    let folderPath;
+    let queryOptions;
+    if (typeof optionsOrFolderId === "number") {
+      folderId = optionsOrFolderId;
+      queryOptions = legacyOptions ?? {};
+    } else {
+      const { folderId: fid, folderKey: fkey, folderPath: fpath, ...rest } = optionsOrFolderId ?? {};
+      folderId = fid;
+      folderKey = fkey;
+      folderPath = fpath;
+      queryOptions = rest;
+    }
+    const headers = resolveFolderHeaders({
+      folderId,
+      folderKey,
+      folderPath,
+      resourceType: "processes.start",
+      fallbackFolderKey: this.config.folderKey
+    });
     const apiRequest = transformRequest(request, ProcessMap);
     const requestBody = {
       startInfo: apiRequest
     };
-    const keysToPrefix = Object.keys(options);
-    const apiOptions = addPrefixToKeys(options, ODATA_PREFIX, keysToPrefix);
+    const keysToPrefix = Object.keys(queryOptions);
+    const apiOptions = addPrefixToKeys(queryOptions, ODATA_PREFIX, keysToPrefix);
     const response = await this.post(PROCESS_ENDPOINTS.START_PROCESS, requestBody, {
       params: apiOptions,
       headers
@@ -43947,8 +44763,8 @@ var WordGroupType;
 })(WordGroupType || (WordGroupType = {}));
 var ModelKind;
 (function(ModelKind2) {
-  ModelKind2["Classifier"] = "Classifier";
   ModelKind2["Extractor"] = "Extractor";
+  ModelKind2["Classifier"] = "Classifier";
 })(ModelKind || (ModelKind = {}));
 var ModelType;
 (function(ModelType2) {
@@ -43956,6 +44772,12 @@ var ModelType;
   ModelType2["Modern"] = "Modern";
   ModelType2["Predefined"] = "Predefined";
 })(ModelType || (ModelType = {}));
+var ErrorSeverity;
+(function(ErrorSeverity2) {
+  ErrorSeverity2["Info"] = "Info";
+  ErrorSeverity2["Warning"] = "Warning";
+  ErrorSeverity2["Error"] = "Error";
+})(ErrorSeverity || (ErrorSeverity = {}));
 var ClassifierDocumentTypeType;
 (function(ClassifierDocumentTypeType2) {
   ClassifierDocumentTypeType2["FormsAi"] = "FormsAi";
@@ -43979,6 +44801,13 @@ var GptFieldType;
   GptFieldType2["Number"] = "Number";
   GptFieldType2["Text"] = "Text";
 })(GptFieldType || (GptFieldType = {}));
+var JobStatus;
+(function(JobStatus2) {
+  JobStatus2["Succeeded"] = "Succeeded";
+  JobStatus2["Failed"] = "Failed";
+  JobStatus2["Running"] = "Running";
+  JobStatus2["NotStarted"] = "NotStarted";
+})(JobStatus || (JobStatus = {}));
 var ValidationDisplayMode;
 (function(ValidationDisplayMode2) {
   ValidationDisplayMode2["Classic"] = "Classic";
@@ -44062,25 +44891,43 @@ var createDataFabricClient = async (tenantOverride) => {
     tenantName: tenantOverride ?? status.tenantName
   });
 };
+var connectOrFail = async (tenantOverride) => {
+  const [clientError, sdk] = await catchError(createDataFabricClient(tenantOverride));
+  if (clientError) {
+    fail("Error connecting to Data Fabric", await extractErrorMessage(clientError));
+    return;
+  }
+  return sdk;
+};
 
 // src/commands/choice-sets.ts
+var OUTPUT_CODES = {
+  ChoiceSetList: "ChoiceSetList",
+  ChoiceSetValues: "ChoiceSetValues",
+  ChoiceSetCreated: "ChoiceSetCreated",
+  ChoiceSetUpdated: "ChoiceSetUpdated",
+  ChoiceSetDeleted: "ChoiceSetDeleted",
+  ChoiceSetValueCreated: "ChoiceSetValueCreated",
+  ChoiceSetValueUpdated: "ChoiceSetValueUpdated",
+  ChoiceSetValuesDeleted: "ChoiceSetValuesDeleted"
+};
 var CHOICE_SETS_LIST_EXAMPLES = [
   {
-    Description: "List all Data Fabric choice sets. The returned 'ID' is the value to pass as 'choiceSetId' on a CHOICE_SET_SINGLE/CHOICE_SET_MULTIPLE entity field, or to 'df choice-sets get <id>'.",
+    Description: "List all Data Fabric choice sets. The returned 'id' is the value to pass as 'choiceSetId' on a CHOICE_SET_SINGLE/CHOICE_SET_MULTIPLE entity field, or to 'df choice-sets list-values <id>'.",
     Command: "uip df choice-sets list",
     Output: {
-      Code: "ChoiceSetList",
+      Code: OUTPUT_CODES.ChoiceSetList,
       Data: [
         {
-          ID: "c1d2e3f4-0000-0000-0000-000000000001",
-          Name: "ExpenseTypes",
-          DisplayName: "Expense Types",
-          Description: "Categories of expenses",
-          FolderId: "f1000000-0000-0000-0000-000000000001",
-          CreatedBy: "u1000000-0000-0000-0000-000000000001",
-          UpdatedBy: "u1000000-0000-0000-0000-000000000001",
-          CreatedTime: "2026-01-01T00:00:00Z",
-          UpdatedTime: "2026-01-02T00:00:00Z"
+          id: "c1d2e3f4-0000-0000-0000-000000000001",
+          name: "ExpenseTypes",
+          displayName: "Expense Types",
+          description: "Categories of expenses",
+          folderId: "f1000000-0000-0000-0000-000000000001",
+          createdBy: "u1000000-0000-0000-0000-000000000001",
+          updatedBy: "u1000000-0000-0000-0000-000000000001",
+          createdTime: "2026-01-01T00:00:00Z",
+          updatedTime: "2026-01-02T00:00:00Z"
         }
       ]
     }
@@ -44088,152 +44935,288 @@ var CHOICE_SETS_LIST_EXAMPLES = [
 ];
 var CHOICE_SETS_GET_EXAMPLES = [
   {
-    Description: "Get values for a choice set. The 'NumberId' on each value is the integer to pass when inserting or updating a record into a CHOICE_SET_SINGLE field (or in an array for CHOICE_SET_MULTIPLE).",
-    Command: "uip df choice-sets get c1d2e3f4-0000-0000-0000-000000000001 --limit 2",
+    Description: "List the values of a choice set. The 'numberId' on each value is the integer to pass when inserting or updating a record into a CHOICE_SET_SINGLE field (or in an array for CHOICE_SET_MULTIPLE).",
+    Command: "uip df choice-sets list-values c1d2e3f4-0000-0000-0000-000000000001 --limit 2",
     Output: {
-      Code: "ChoiceSetValues",
+      Code: OUTPUT_CODES.ChoiceSetValues,
       Data: {
-        TotalCount: 2,
-        Values: [
+        items: [
           {
-            Id: "v1000000-0000-0000-0000-000000000001",
-            Name: "travel",
-            DisplayName: "Travel",
-            NumberId: 1
+            id: "v1000000-0000-0000-0000-000000000001",
+            name: "travel",
+            displayName: "Travel",
+            numberId: 0
           },
           {
-            Id: "v1000000-0000-0000-0000-000000000002",
-            Name: "meals",
-            DisplayName: "Meals",
-            NumberId: 2
+            id: "v1000000-0000-0000-0000-000000000002",
+            name: "meals",
+            displayName: "Meals",
+            numberId: 1
           }
         ],
-        HasNextPage: false
+        totalCount: 2,
+        hasNextPage: false
+      }
+    }
+  }
+];
+var CHOICE_SETS_CREATE_EXAMPLES = [
+  {
+    Description: "Create a choice set. The returned 'ID' is used as 'choiceSetId' on CHOICE_SET_SINGLE/CHOICE_SET_MULTIPLE entity fields. Add values with 'df choice-set-values create'.",
+    Command: 'uip df choice-sets create ExpenseTypes --display-name "Expense Types" --description "Categories of expenses"',
+    Output: {
+      Code: OUTPUT_CODES.ChoiceSetCreated,
+      Data: { ID: "c1d2e3f4-0000-0000-0000-000000000001" }
+    }
+  }
+];
+var CHOICE_SETS_UPDATE_EXAMPLES = [
+  {
+    Description: "Update a choice set's display name and/or description. At least one of --display-name or --description is required.",
+    Command: 'uip df choice-sets update c1d2e3f4-0000-0000-0000-000000000001 --display-name "Expense Categories"',
+    Output: {
+      Code: OUTPUT_CODES.ChoiceSetUpdated,
+      Data: { ID: "c1d2e3f4-0000-0000-0000-000000000001" }
+    }
+  }
+];
+var CHOICE_SETS_DELETE_EXAMPLES = [
+  {
+    Description: "Delete a choice set (irreversible — requires --confirm and --reason).",
+    Command: 'uip df choice-sets delete c1d2e3f4-0000-0000-0000-000000000001 --confirm --reason "no longer used"',
+    Output: {
+      Code: OUTPUT_CODES.ChoiceSetDeleted,
+      Data: {
+        ID: "c1d2e3f4-0000-0000-0000-000000000001",
+        Reason: "no longer used"
       }
     }
   }
 ];
 var registerChoiceSetsCommand = (program2) => {
-  const choiceSets = program2.command("choice-sets").description("Browse Data Fabric choice sets. Read-only: choice sets are authored in the Data Fabric web UI and cannot be created, updated, or deleted from the CLI. " + "Use 'list' to find a choice set's ID (used as 'choiceSetId' on CHOICE_SET_SINGLE/CHOICE_SET_MULTIPLE entity fields), and 'get' to inspect its values.");
-  choiceSets.command("list").description("List all Data Fabric choice sets").option("-t, --tenant <tenant-name>", "Tenant name").examples(CHOICE_SETS_LIST_EXAMPLES).trackedAction(processContext, async (options) => {
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+  const choiceSets = program2.command("choice-sets").description("Manage Data Fabric choice sets — the enumerated value lists referenced by CHOICE_SET_SINGLE/CHOICE_SET_MULTIPLE entity fields. " + "Use 'list'/'list-values' to inspect, and 'create'/'update'/'delete' to manage them. Manage individual values with 'df choice-set-values'.");
+  choiceSets.command("list").description("List all Data Fabric choice sets").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).examples(CHOICE_SETS_LIST_EXAMPLES).trackedAction(processContext, async (options) => {
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const [listError, result] = await catchError(sdk.entities.choicesets.getAll());
     if (listError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error listing choice sets",
-        Instructions: await extractErrorMessage(listError)
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error listing choice sets", await extractErrorMessage(listError));
     }
-    const items = (result ?? []).map((cs) => ({
-      ID: cs.id,
-      Name: cs.name,
-      DisplayName: cs.displayName || cs.name,
-      Description: cs.description || "",
-      FolderId: cs.folderId,
-      CreatedBy: cs.createdBy,
-      UpdatedBy: cs.updatedBy,
-      CreatedTime: cs.createdTime,
-      UpdatedTime: cs.updatedTime
-    }));
     OutputFormatter.success({
       Result: RESULTS.Success,
-      Code: "ChoiceSetList",
-      Data: items
+      Code: OUTPUT_CODES.ChoiceSetList,
+      Data: result ?? []
     });
   });
-  choiceSets.command("get").description("Get values for a Data Fabric choice set").argument("<choice-set-id>", "Choice set ID").option("-t, --tenant <tenant-name>", "Tenant name").option("-l, --limit <number>", "Number of values to return per page", "50").option("-o, --offset <number>", "Start from the page containing this record index (rounded down to the nearest page boundary; mutually exclusive with --cursor)").option("--cursor <cursor>", "Pagination cursor from a previous response to fetch the next page").examples(CHOICE_SETS_GET_EXAMPLES).trackedAction(processContext, async (choiceSetId, options) => {
+  choiceSets.command("list-values").description("List the values of a Data Fabric choice set").argument("<choice-set-id>", "Choice set ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-l, --limit <number>", "Number of values to return per page", "50").option("-o, --offset <number>", "Start from the page containing this record index (rounded down to the nearest page boundary; mutually exclusive with --cursor)").option("--cursor <cursor>", "Pagination cursor from a previous response to fetch the next page").examples(CHOICE_SETS_GET_EXAMPLES).trackedAction(processContext, async (choiceSetId, options) => {
     const pageSize = Number(options.limit ?? "50");
     if (Number.isNaN(pageSize) || pageSize < 1) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Invalid --limit value",
-        Instructions: "Provide a positive integer for --limit."
-      });
-      processContext.exit(1);
-      return;
+      return fail("Invalid --limit value", "Provide a positive integer for --limit.");
     }
     if (options.cursor !== undefined && options.offset !== undefined) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "--offset and --cursor are mutually exclusive",
-        Instructions: "Use --offset to jump to a position by record count, or --cursor to continue from a previous response."
-      });
-      processContext.exit(1);
-      return;
+      return fail("--offset and --cursor are mutually exclusive", "Use --offset to jump to a position by record count, or --cursor to continue from a previous response.");
     }
     let jumpToPage;
     if (options.offset !== undefined) {
       const offsetValue = Number(options.offset);
       if (Number.isNaN(offsetValue) || offsetValue < 0) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Invalid --offset value",
-          Instructions: "Provide a non-negative integer for --offset."
-        });
-        processContext.exit(1);
-        return;
+        return fail("Invalid --offset value", "Provide a non-negative integer for --offset.");
       }
       jumpToPage = Math.floor(offsetValue / pageSize) + 1;
     }
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const paginationOptions = options.cursor !== undefined ? { pageSize, cursor: { value: options.cursor } } : jumpToPage !== undefined ? { pageSize, jumpToPage } : { pageSize };
     const [getError, result] = await catchError(sdk.entities.choicesets.getById(choiceSetId, paginationOptions));
     if (getError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: `Error getting choice set '${choiceSetId}'`,
-        Instructions: await extractErrorMessage(getError)
-      });
-      processContext.exit(1);
+      return fail(`Error getting choice set '${choiceSetId}'`, await extractErrorMessage(getError));
+    }
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: OUTPUT_CODES.ChoiceSetValues,
+      Data: result
+    });
+  });
+  choiceSets.command("create").description("Create a new Data Fabric choice set").argument("<name>", "Choice set name (must start with a letter; letters, numbers, and underscores only)").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--display-name <name>", "Human-readable display name").option("--description <text>", "Choice set description").option("--folder-key <uuid>", "UUID of the folder to place the choice set in (defaults to the tenant-level folder)").examples(CHOICE_SETS_CREATE_EXAMPLES).trackedAction(processContext, async (name, options) => {
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
+      return;
+    const createOpts = {
+      ...options.displayName !== undefined && {
+        displayName: options.displayName
+      },
+      ...options.description !== undefined && {
+        description: options.description
+      },
+      ...options.folderKey !== undefined && {
+        folderKey: options.folderKey
+      }
+    };
+    const choiceSetService = sdk.entities.choicesets;
+    const [createError, choiceSetId] = await catchError(choiceSetService.create(name, Object.keys(createOpts).length > 0 ? createOpts : undefined));
+    if (createError) {
+      return fail("Error creating choice set", await extractErrorMessage(createError));
+    }
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: OUTPUT_CODES.ChoiceSetCreated,
+      Data: { ID: choiceSetId }
+    });
+  });
+  choiceSets.command("update").description("Update the metadata of a Data Fabric choice set").argument("<choice-set-id>", "Choice set ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--display-name <name>", "New display name").option("--description <text>", "New description").examples(CHOICE_SETS_UPDATE_EXAMPLES).trackedAction(processContext, async (choiceSetId, options) => {
+    if (options.displayName === undefined && options.description === undefined) {
+      return fail("No update fields provided", "Provide at least one of --display-name or --description.");
+    }
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
+    const updateOpts = {
+      ...options.displayName !== undefined && {
+        displayName: options.displayName
+      },
+      ...options.description !== undefined && {
+        description: options.description
+      }
+    };
+    const choiceSetService = sdk.entities.choicesets;
+    const [updateError] = await catchError(choiceSetService.updateById(choiceSetId, updateOpts));
+    if (updateError) {
+      return fail(`Error updating choice set '${choiceSetId}'`, await extractErrorMessage(updateError));
     }
-    const response = result;
-    const values = (response.items ?? []).map((v) => ({
-      Id: v.id,
-      Name: v.name,
-      DisplayName: v.displayName || v.name,
-      NumberId: v.numberId,
-      CreatedTime: v.createdTime,
-      UpdatedTime: v.updatedTime
-    }));
-    const nextCursor = extractCursorValue(response.nextCursor);
     OutputFormatter.success({
       Result: RESULTS.Success,
-      Code: "ChoiceSetValues",
+      Code: OUTPUT_CODES.ChoiceSetUpdated,
+      Data: { ID: choiceSetId }
+    });
+  });
+  choiceSets.command("delete").description("Delete a Data Fabric choice set (irreversible)").argument("<choice-set-id>", "Choice set ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--confirm", "Acknowledge this is an irreversible operation").option("--reason <reason>", "Reason for the deletion — echoed back in the response so the caller can log it").examples(CHOICE_SETS_DELETE_EXAMPLES).trackedAction(processContext, async (choiceSetId, options) => {
+    const reason = requireDestructiveConfirmation(options, 'Pass --reason "<text>" to record why the choice set is being deleted.');
+    if (reason === null)
+      return;
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
+      return;
+    const choiceSetService = sdk.entities.choicesets;
+    const [deleteError] = await catchError(choiceSetService.deleteById(choiceSetId));
+    if (deleteError) {
+      return fail(`Error deleting choice set '${choiceSetId}'`, await extractErrorMessage(deleteError));
+    }
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: OUTPUT_CODES.ChoiceSetDeleted,
+      Data: { ID: choiceSetId, Reason: reason }
+    });
+  });
+};
+var CHOICE_SET_VALUES_CREATE_EXAMPLES = [
+  {
+    Description: "Add a value to a choice set. The returned 'numberId' is the integer to pass when inserting or updating records into a CHOICE_SET_SINGLE field (or in an array for CHOICE_SET_MULTIPLE).",
+    Command: 'uip df choice-set-values create c1d2e3f4-0000-0000-0000-000000000001 travel --display-name "Travel"',
+    Output: {
+      Code: OUTPUT_CODES.ChoiceSetValueCreated,
       Data: {
-        TotalCount: response.totalCount ?? values.length,
-        Values: values,
-        HasNextPage: response.hasNextPage ?? false,
-        ...nextCursor !== undefined && {
-          NextCursor: nextCursor
-        },
-        ...response.currentPage !== undefined && {
-          CurrentPage: response.currentPage
-        },
-        ...response.totalPages !== undefined && {
-          TotalPages: response.totalPages
-        }
+        id: "v1000000-0000-0000-0000-000000000001",
+        name: "travel",
+        displayName: "Travel",
+        numberId: 0
+      }
+    }
+  }
+];
+var CHOICE_SET_VALUES_UPDATE_EXAMPLES = [
+  {
+    Description: "Update the display name of an existing choice set value. Find value IDs with 'df choice-sets list-values <choice-set-id>'.",
+    Command: 'uip df choice-set-values update c1d2e3f4-0000-0000-0000-000000000001 v1000000-0000-0000-0000-000000000001 "Business Travel"',
+    Output: {
+      Code: OUTPUT_CODES.ChoiceSetValueUpdated,
+      Data: {
+        id: "v1000000-0000-0000-0000-000000000001",
+        name: "travel",
+        displayName: "Business Travel",
+        numberId: 0
+      }
+    }
+  }
+];
+var CHOICE_SET_VALUES_DELETE_EXAMPLES = [
+  {
+    Description: "Delete one or more values from a choice set (irreversible — requires --confirm and --reason). Pass value IDs as a comma-separated list.",
+    Command: 'uip df choice-set-values delete c1d2e3f4-0000-0000-0000-000000000001 --ids v1000000-0000-0000-0000-000000000001,v1000000-0000-0000-0000-000000000002 --confirm --reason "deprecated categories"',
+    Output: {
+      Code: OUTPUT_CODES.ChoiceSetValuesDeleted,
+      Data: {
+        ChoiceSetId: "c1d2e3f4-0000-0000-0000-000000000001",
+        DeletedIds: [
+          "v1000000-0000-0000-0000-000000000001",
+          "v1000000-0000-0000-0000-000000000002"
+        ],
+        Reason: "deprecated categories"
+      }
+    }
+  }
+];
+var registerChoiceSetValuesCommand = (program2) => {
+  const values = program2.command("choice-set-values").description("Manage the individual values of a Data Fabric choice set. " + "Use 'df choice-sets list-values <choice-set-id>' to list existing values and their IDs.");
+  values.command("create").description("Add a value to a Data Fabric choice set").argument("<choice-set-id>", "Choice set ID").argument("<name>", "Value name (must start with a letter; letters, numbers, and underscores only)").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--display-name <name>", "Human-readable display name").examples(CHOICE_SET_VALUES_CREATE_EXAMPLES).trackedAction(processContext, async (choiceSetId, name, options) => {
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
+      return;
+    const insertOpts = {
+      ...options.displayName !== undefined && {
+        displayName: options.displayName
+      }
+    };
+    const choiceSetService = sdk.entities.choicesets;
+    const [createError, result] = await catchError(choiceSetService.insertValueById(choiceSetId, name, Object.keys(insertOpts).length > 0 ? insertOpts : undefined));
+    if (createError) {
+      return fail(`Error creating value in choice set '${choiceSetId}'`, await extractErrorMessage(createError));
+    }
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: OUTPUT_CODES.ChoiceSetValueCreated,
+      Data: result
+    });
+  });
+  values.command("update").description("Update the display name of a choice set value").argument("<choice-set-id>", "Choice set ID").argument("<value-id>", "Choice set value ID").argument("<display-name>", "New display name for the value").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).examples(CHOICE_SET_VALUES_UPDATE_EXAMPLES).trackedAction(processContext, async (choiceSetId, valueId, displayName, options) => {
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
+      return;
+    const choiceSetService = sdk.entities.choicesets;
+    const [updateError, result] = await catchError(choiceSetService.updateValueById(choiceSetId, valueId, displayName));
+    if (updateError) {
+      return fail(`Error updating value '${valueId}' in choice set '${choiceSetId}'`, await extractErrorMessage(updateError));
+    }
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: OUTPUT_CODES.ChoiceSetValueUpdated,
+      Data: result
+    });
+  });
+  values.command("delete").description("Delete values from a Data Fabric choice set (irreversible)").argument("<choice-set-id>", "Choice set ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--ids <ids>", "Comma-separated list of value IDs to delete").option("--confirm", "Acknowledge this is an irreversible operation").option("--reason <reason>", "Reason for the deletion — echoed back in the response so the caller can log it").examples(CHOICE_SET_VALUES_DELETE_EXAMPLES).trackedAction(processContext, async (choiceSetId, options) => {
+    const valueIds = (options.ids ?? "").split(",").map((id) => id.trim()).filter((id) => id.length > 0);
+    if (valueIds.length === 0) {
+      return fail("No value IDs provided", "Pass --ids <id,id,...> with at least one value ID to delete.");
+    }
+    const reason = requireDestructiveConfirmation(options, 'Pass --reason "<text>" to record why the values are being deleted.');
+    if (reason === null)
+      return;
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
+      return;
+    const choiceSetService = sdk.entities.choicesets;
+    const [deleteError] = await catchError(choiceSetService.deleteValuesById(choiceSetId, valueIds));
+    if (deleteError) {
+      return fail(`Error deleting values from choice set '${choiceSetId}'`, await extractErrorMessage(deleteError));
+    }
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: OUTPUT_CODES.ChoiceSetValuesDeleted,
+      Data: {
+        ChoiceSetId: choiceSetId,
+        DeletedIds: valueIds,
+        Reason: reason
       }
     });
   });
@@ -44270,28 +45253,25 @@ async function readJsonInput(filePath, inline, missingMsg = "Provide either --fi
 // src/commands/entities.ts
 var ENTITIES_LIST_EXAMPLES = [
   {
-    Description: "List Data Fabric entities",
+    Description: "List Data Fabric entities.",
     Command: "uip df entities list --native-only",
     Output: {
       Code: "EntityList",
       Data: [
         {
-          Name: "Invoice",
-          DisplayName: "Invoice",
-          ID: "a1b2c3d4-0000-0000-0000-000000000001",
-          Type: "Standard",
-          Source: "Native",
-          Description: "Invoice records",
-          FieldCount: 8
-        },
-        {
-          Name: "Customer",
-          DisplayName: "Customer",
-          ID: "a1b2c3d4-0000-0000-0000-000000000002",
-          Type: "Standard",
-          Source: "Native",
-          Description: "Customer records",
-          FieldCount: 6
+          id: "a1b2c3d4-0000-0000-0000-000000000001",
+          name: "Invoice",
+          displayName: "Invoice",
+          entityType: "Standard",
+          description: "Invoice records",
+          isRbacEnabled: false,
+          fields: [
+            {
+              id: "f1000000-0000-0000-0000-000000000001",
+              name: "amount"
+            }
+          ],
+          externalFields: []
         }
       ]
     }
@@ -44299,34 +45279,35 @@ var ENTITIES_LIST_EXAMPLES = [
 ];
 var ENTITIES_GET_EXAMPLES = [
   {
-    Description: "Get entity schema by ID",
+    Description: "Get entity schema by ID.",
     Command: "uip df entities get a1b2c3d4-0000-0000-0000-000000000001",
     Output: {
       Code: "EntitySchema",
       Data: {
-        Name: "Invoice",
-        DisplayName: "Invoice",
-        ID: "a1b2c3d4-0000-0000-0000-000000000001",
-        Type: "Standard",
-        Description: "Invoice records",
-        Fields: [
-          {
-            ID: "f1000000-0000-0000-0000-000000000001",
-            Name: "id",
-            DisplayName: "ID",
-            Type: "Guid",
-            Required: true,
-            PrimaryKey: true,
-            System: true
-          },
+        id: "a1b2c3d4-0000-0000-0000-000000000001",
+        name: "Invoice",
+        displayName: "Invoice",
+        entityType: "Standard",
+        description: "Invoice records",
+        isRbacEnabled: false,
+        fields: [
           {
-            ID: "f1000000-0000-0000-0000-000000000002",
-            Name: "amount",
-            DisplayName: "Amount",
-            Type: "Decimal",
-            Required: true,
-            PrimaryKey: false,
-            System: false
+            id: "f1000000-0000-0000-0000-000000000002",
+            name: "amount",
+            displayName: "Amount",
+            fieldDataType: { name: "DECIMAL" },
+            sqlType: {
+              name: "DECIMAL",
+              decimalPrecision: 2,
+              minValue: 0,
+              maxValue: 999999
+            },
+            isRequired: true,
+            isUnique: false,
+            isEncrypted: false,
+            isRbacEnabled: false,
+            isPrimaryKey: false,
+            isSystemField: false
           }
         ]
       }
@@ -44348,8 +45329,8 @@ var ENTITIES_DELETE_EXAMPLES = [
 ];
 var ENTITIES_CREATE_EXAMPLES = [
   {
-    Description: "Create an entity with a choice-set field (single-select and multi-select) and a relationship to another entity. " + "CHOICE_SET_SINGLE/CHOICE_SET_MULTIPLE require 'choiceSetId' (from 'df choice-sets list'). " + "RELATIONSHIP requires 'referenceEntityName' (target entity) and 'referenceFieldName' (the field used to resolve joins on read; e.g. 'Id' or a unique key like 'Email'). " + "Note: regardless of 'referenceFieldName', a relationship column on a record always stores the target record's UUID 'Id' — see 'df records insert' for how to write the value.",
-    Command: `uip df entities create Expense --body '{"displayName":"Expense","fields":[{"fieldName":"category","type":"CHOICE_SET_SINGLE","choiceSetId":"c1d2e3f4-0000-0000-0000-000000000001","isRequired":true},{"fieldName":"tags","type":"CHOICE_SET_MULTIPLE","choiceSetId":"c1d2e3f4-0000-0000-0000-000000000002"},{"fieldName":"submitter","type":"RELATIONSHIP","referenceEntityName":"Employee","referenceFieldName":"Id","isRequired":true}]}'`,
+    Description: "Create an entity with choice-set, relationship, and file fields. " + "CHOICE_SET_SINGLE/CHOICE_SET_MULTIPLE require 'choiceSetId' (from 'df choice-sets list'). " + "RELATIONSHIP and FILE both require 'referenceEntityId' (UUID of the target entity, from 'df entities list') and 'referenceFieldId' (UUID of the field on the target entity, from 'df entities get <target-id>'). " + "Note: a RELATIONSHIP column on a record always stores the target record's UUID 'Id' (regardless of which 'referenceFieldId' configured the join) — see 'df records insert' for how to write the value.",
+    Command: `uip df entities create Expense --body '{"displayName":"Expense","fields":[{"fieldName":"category","type":"CHOICE_SET_SINGLE","choiceSetId":"c1d2e3f4-0000-0000-0000-000000000001","isRequired":true},{"fieldName":"tags","type":"CHOICE_SET_MULTIPLE","choiceSetId":"c1d2e3f4-0000-0000-0000-000000000002"},{"fieldName":"submitter","type":"RELATIONSHIP","referenceEntityId":"a1b2c3d4-0000-0000-0000-000000000010","referenceFieldId":"f1000000-0000-0000-0000-000000000100","isRequired":true},{"fieldName":"receipt","type":"FILE","referenceEntityId":"a1b2c3d4-0000-0000-0000-000000000099","referenceFieldId":"f1000000-0000-0000-0000-000000000199"}]}'`,
     Output: {
       Code: "EntityCreated",
       Data: { ID: "a1b2c3d4-0000-0000-0000-000000000004" }
@@ -44383,41 +45364,20 @@ function pickKnownUpdateKeys(input) {
 var registerEntitiesCommand = (program2) => {
   const entities = program2.command("entities").description("Browse Data Fabric entity schemas");
   entities.command("list").description("List all Data Fabric entities").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--native-only", "Show only native entities (exclude federated entities with external connections)").examples(ENTITIES_LIST_EXAMPLES).trackedAction(processContext, async (options) => {
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const [listError, result] = await catchError(sdk.entities.getAll());
     if (listError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error listing entities",
-        Instructions: await extractErrorMessage(listError)
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error listing entities", await extractErrorMessage(listError));
     }
-    const entityList = (result ?? []).map((e) => {
+    const entityList = (result ?? []).filter((e) => {
+      if (!options.nativeOnly)
+        return true;
       const entity = e;
       const externalFields = entity.externalFields ?? [];
-      const isNative = externalFields.length === 0;
-      const connectorName = externalFields[0]?.externalConnectionDetail?.connectorName;
-      return {
-        Name: entity.name,
-        DisplayName: entity.displayName || entity.name,
-        ID: entity.id,
-        Type: entity.entityType,
-        Source: isNative ? "Native" : `Federated${connectorName ? ` (${connectorName})` : ""}`,
-        Description: entity.description || "",
-        FieldCount: entity.fields.length
-      };
-    }).filter((e) => !options.nativeOnly || e.Source === "Native");
+      return externalFields.length === 0;
+    });
     OutputFormatter.success({
       Result: RESULTS.Success,
       Code: "EntityList",
@@ -44425,117 +45385,45 @@ var registerEntitiesCommand = (program2) => {
     });
   });
   entities.command("get").description("Get schema details of a Data Fabric entity").argument("<id>", "Entity ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).examples(ENTITIES_GET_EXAMPLES).trackedAction(processContext, async (id, options) => {
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const [getError, entity] = await catchError(sdk.entities.getById(id));
     if (getError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: `Error getting entity schema '${id}'`,
-        Instructions: await extractErrorMessage(getError)
-      });
-      processContext.exit(1);
-      return;
+      return fail(`Error getting entity schema '${id}'`, await extractErrorMessage(getError));
     }
     const e = entity;
     if (!e?.fields) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: `Entity '${id}' not found`,
-        Instructions: "Verify the entity ID exists. Use 'df entities list' to see available entities."
-      });
-      processContext.exit(1);
-      return;
+      return fail(`Entity '${id}' not found`, "Verify the entity ID exists. Use 'df entities list' to see available entities.");
     }
-    const fields = e.fields.map((field) => ({
-      ID: field.id,
-      Name: field.name,
-      DisplayName: field.displayName,
-      Type: field.fieldDataType?.name,
-      Required: field.isRequired,
-      PrimaryKey: field.isPrimaryKey,
-      System: field.isSystemField
-    }));
     OutputFormatter.success({
       Result: RESULTS.Success,
       Code: "EntitySchema",
-      Data: {
-        Name: e.name,
-        DisplayName: e.displayName || e.name,
-        ID: e.id,
-        Type: e.entityType,
-        Description: e.description || "",
-        Fields: fields
-      }
+      Data: e
     });
   });
   entities.command("create").description("Create a new Data Fabric entity").argument("<name>", "Entity name (must start with a letter; letters, numbers, and underscores only)").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-f, --file <path>", "Path to JSON file with entity definition (fields array required; displayName, description, isRbacEnabled optional)").option("--body <json>", "Inline JSON entity definition").examples(ENTITIES_CREATE_EXAMPLES).trackedAction(processContext, async (name, options) => {
     const [parseError, parsed] = await catchError(readJsonInput(options.file, options.body, "Provide entity definition via --file or --body."));
     if (parseError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error parsing entity definition",
-        Instructions: parseError.message
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error parsing entity definition", parseError.message);
     }
     if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Entity definition must be a JSON object",
-        Instructions: "Provide a JSON object with a 'fields' array and optional displayName, description, isRbacEnabled."
-      });
-      processContext.exit(1);
-      return;
+      return fail("Entity definition must be a JSON object", "Provide a JSON object with a 'fields' array and optional displayName, description, isRbacEnabled.");
     }
     const definition = parsed;
     if (!Array.isArray(definition.fields)) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Entity definition must include a 'fields' array",
-        Instructions: "Provide a JSON object with a 'fields' array containing field definitions."
-      });
-      processContext.exit(1);
-      return;
+      return fail("Entity definition must include a 'fields' array", "Provide a JSON object with a 'fields' array containing field definitions.");
     }
     const hasInvalidField = definition.fields.some((f) => typeof f !== "object" || f === null || typeof f.fieldName !== "string");
     if (hasInvalidField) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Each field must include a 'fieldName' string",
-        Instructions: 'Example: {"fieldName":"title","type":"STRING"}'
-      });
-      processContext.exit(1);
-      return;
+      return fail("Each field must include a 'fieldName' string", 'Example: {"fieldName":"title","type":"STRING"}');
     }
     if (hasInvalidFieldType(definition.fields)) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Invalid field type in fields",
-        Instructions: `Valid types: ${VALID_FIELD_TYPES_LIST}`
-      });
-      processContext.exit(1);
-      return;
+      return fail("Invalid field type in fields", `Valid types: ${VALID_FIELD_TYPES_LIST}`);
     }
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const createOpts = {
       ...definition.displayName !== undefined && {
         displayName: definition.displayName
@@ -44550,13 +45438,7 @@ var registerEntitiesCommand = (program2) => {
     const entityService = sdk.entities;
     const [createError, entityId] = await catchError(entityService.create(name, definition.fields, Object.keys(createOpts).length > 0 ? createOpts : undefined));
     if (createError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error creating entity",
-        Instructions: await extractErrorMessage(createError)
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error creating entity", await extractErrorMessage(createError));
     }
     OutputFormatter.success({
       Result: RESULTS.Success,
@@ -44567,50 +45449,20 @@ var registerEntitiesCommand = (program2) => {
   entities.command("update").description("Update schema or metadata of a Data Fabric entity").argument("<id>", "Entity ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-f, --file <path>", "Path to JSON file with update options (addFields, updateFields, removeFields, displayName, description, isRbacEnabled)").option("--body <json>", "Inline JSON update options").option("--confirm", "Required when 'removeFields' is non-empty — acknowledges the field deletion is irreversible").option("--reason <reason>", "Required when 'removeFields' is non-empty — echoed back in the response so the caller can log it").trackedAction(processContext, async (id, options) => {
     const [parseError, parsed] = await catchError(readJsonInput(options.file, options.body, "Provide update options via --file or --body."));
     if (parseError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error parsing update options",
-        Instructions: parseError.message
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error parsing update options", parseError.message);
     }
     if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Update options must be a JSON object",
-        Instructions: "Provide a JSON object with addFields, updateFields, removeFields, displayName, description, or isRbacEnabled."
-      });
-      processContext.exit(1);
-      return;
+      return fail("Update options must be a JSON object", "Provide a JSON object with addFields, updateFields, removeFields, displayName, description, or isRbacEnabled.");
     }
     const input = parsed;
     if (input.addFields !== undefined && !Array.isArray(input.addFields)) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "'addFields' must be an array",
-        Instructions: 'Example: {"addFields":[{"fieldName":"title","type":"STRING"}]}'
-      });
-      processContext.exit(1);
-      return;
+      return fail("'addFields' must be an array", 'Example: {"addFields":[{"fieldName":"title","type":"STRING"}]}');
     }
     if (input.updateFields !== undefined && !Array.isArray(input.updateFields)) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "'updateFields' must be an array",
-        Instructions: 'Example: {"updateFields":[{"id":"<fieldId>","displayName":"New Name"}]}'
-      });
-      processContext.exit(1);
-      return;
+      return fail("'updateFields' must be an array", 'Example: {"updateFields":[{"id":"<fieldId>","displayName":"New Name"}]}');
     }
     if (input.removeFields !== undefined && !Array.isArray(input.removeFields)) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "'removeFields' must be an array",
-        Instructions: 'Example: {"removeFields":[{"fieldName":"old_field"}]}'
-      });
-      processContext.exit(1);
-      return;
+      return fail("'removeFields' must be an array", 'Example: {"removeFields":[{"fieldName":"old_field"}]}');
     }
     let trimmedReason;
     let removedFieldNames = [];
@@ -44624,33 +45476,12 @@ var registerEntitiesCommand = (program2) => {
         return typeof fn !== "string" || fn.trim() === "";
       });
       if (hasInvalidRemove) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Each field in removeFields must include a non-empty 'fieldName' string",
-          Instructions: 'Example: {"removeFields":[{"fieldName":"old_field"}]}'
-        });
-        processContext.exit(1);
-        return;
+        return fail("Each field in removeFields must include a non-empty 'fieldName' string", 'Example: {"removeFields":[{"fieldName":"old_field"}]}');
       }
-      if (options.confirm !== true) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Confirmation required for destructive operation",
-          Instructions: "Pass --confirm to acknowledge field deletion is irreversible."
-        });
-        processContext.exit(1);
-        return;
-      }
-      trimmedReason = options.reason?.trim();
-      if (trimmedReason === undefined || trimmedReason === "") {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Reason required for destructive operation",
-          Instructions: 'Pass --reason "<text>" to record why fields are being removed.'
-        });
-        processContext.exit(1);
+      const reason = requireDestructiveConfirmation(options, 'Pass --reason "<text>" to record why fields are being removed.');
+      if (reason === null)
         return;
-      }
+      trimmedReason = reason;
       removedFieldNames = removeFields.map((f) => f.fieldName);
     }
     if (Array.isArray(input.addFields)) {
@@ -44661,44 +45492,20 @@ var registerEntitiesCommand = (program2) => {
         return typeof fn !== "string" || fn.trim() === "";
       });
       if (hasInvalidField) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Each field in addFields must include a non-empty 'fieldName' string",
-          Instructions: 'Example: {"fieldName":"title","type":"STRING"}'
-        });
-        processContext.exit(1);
-        return;
+        return fail("Each field in addFields must include a non-empty 'fieldName' string", 'Example: {"fieldName":"title","type":"STRING"}');
       }
       if (hasInvalidFieldType(input.addFields)) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Invalid field type in addFields",
-          Instructions: `Valid types: ${VALID_FIELD_TYPES_LIST}`
-        });
-        processContext.exit(1);
-        return;
+        return fail("Invalid field type in addFields", `Valid types: ${VALID_FIELD_TYPES_LIST}`);
       }
       const addNames = input.addFields.map((f) => f.fieldName);
       const duplicateAdd = addNames.find((name, i2) => addNames.indexOf(name) !== i2);
       if (duplicateAdd !== undefined) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: `Duplicate fieldName '${duplicateAdd}' in addFields`,
-          Instructions: "Each entry in addFields must have a unique fieldName."
-        });
-        processContext.exit(1);
-        return;
+        return fail(`Duplicate fieldName '${duplicateAdd}' in addFields`, "Each entry in addFields must have a unique fieldName.");
       }
       if (removedFieldNames.length > 0) {
         const conflict = addNames.find((name) => removedFieldNames.includes(name));
         if (conflict !== undefined) {
-          OutputFormatter.error({
-            Result: RESULTS.Failure,
-            Message: `Field '${conflict}' appears in both addFields and removeFields`,
-            Instructions: "A single update cannot add and remove the same field. Split into two calls if you need to recreate it."
-          });
-          processContext.exit(1);
-          return;
+          return fail(`Field '${conflict}' appears in both addFields and removeFields`, "A single update cannot add and remove the same field. Split into two calls if you need to recreate it.");
         }
       }
     }
@@ -44710,35 +45517,16 @@ var registerEntitiesCommand = (program2) => {
         return typeof fid !== "string" || fid.trim() === "";
       });
       if (hasInvalidField) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Each field in updateFields must include a non-empty 'id' string",
-          Instructions: `Use 'df entities get <entityId>' to find field IDs. Example: {"id":"<fieldId>","displayName":"Total Amount","isRequired":true}`
-        });
-        processContext.exit(1);
-        return;
+        return fail("Each field in updateFields must include a non-empty 'id' string", `Use 'df entities get <entityId>' to find field IDs. Example: {"id":"<fieldId>","displayName":"Total Amount","isRequired":true}`);
       }
     }
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const entityService = sdk.entities;
     const [updateError] = await catchError(entityService.updateById(id, pickKnownUpdateKeys(input)));
     if (updateError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error updating entity",
-        Instructions: await extractErrorMessage(updateError)
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error updating entity", await extractErrorMessage(updateError));
     }
     OutputFormatter.success({
       Result: RESULTS.Success,
@@ -44753,45 +45541,16 @@ var registerEntitiesCommand = (program2) => {
     });
   });
   entities.command("delete").description("Delete a Data Fabric entity (irreversible)").argument("<id>", "Entity ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--confirm", "Acknowledge this is an irreversible operation").option("--reason <reason>", "Reason for the deletion — echoed back in the response so the caller can log it").examples(ENTITIES_DELETE_EXAMPLES).trackedAction(processContext, async (id, options) => {
-    if (options.confirm !== true) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Confirmation required for destructive operation",
-        Instructions: "Pass --confirm to acknowledge this is irreversible."
-      });
-      processContext.exit(1);
+    const reason = requireDestructiveConfirmation(options, 'Pass --reason "<text>" to record why the entity is being deleted.');
+    if (reason === null)
       return;
-    }
-    const reason = options.reason?.trim();
-    if (reason === undefined || reason === "") {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Reason required for destructive operation",
-        Instructions: 'Pass --reason "<text>" to record why the entity is being deleted.'
-      });
-      processContext.exit(1);
-      return;
-    }
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const entityService = sdk.entities;
     const [deleteError] = await catchError(entityService.deleteById(id));
     if (deleteError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: `Error deleting entity '${id}'`,
-        Instructions: await extractErrorMessage(deleteError)
-      });
-      processContext.exit(1);
-      return;
+      return fail(`Error deleting entity '${id}'`, await extractErrorMessage(deleteError));
     }
     OutputFormatter.success({
       Result: RESULTS.Success,
@@ -44851,45 +45610,20 @@ var registerFilesCommand = (program2) => {
   const files = program2.command("files").description("Manage file attachments on Data Fabric entity records");
   files.command("upload").description("Upload a file to a field on an entity record").argument("<entity-id>", "Entity ID").argument("<record-id>", "Record ID").argument("<field-name>", "Name of the file field (case-sensitive)").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-f, --file <path>", "Path to the file to upload").examples(FILES_UPLOAD_EXAMPLES).trackedAction(processContext, async (entityId, recordId, fieldName, options) => {
     if (!options.file) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "A file path is required",
-        Instructions: "Provide a file path via --file."
-      });
-      processContext.exit(1);
-      return;
+      return fail("A file path is required", "Provide a file path via --file.");
     }
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const [readError, fileContent] = await catchError(readFileBinary(options.file));
     if (readError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error reading file",
-        Instructions: readError.message
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error reading file", readError.message);
     }
     const fsInst = getFileSystem();
     const fileName = fsInst.path.basename(options.file) || "upload";
     const [uploadError] = await catchError(sdk.entities.uploadAttachment(entityId, recordId, fieldName, new File([fileContent], fileName)));
     if (uploadError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: `Error uploading file to field '${fieldName}'`,
-        Instructions: await extractErrorMessage(uploadError)
-      });
-      processContext.exit(1);
-      return;
+      return fail(`Error uploading file to field '${fieldName}'`, await extractErrorMessage(uploadError));
     }
     OutputFormatter.success({
       Result: RESULTS.Success,
@@ -44903,46 +45637,21 @@ var registerFilesCommand = (program2) => {
     });
   });
   files.command("download").description("Download a file from a field on an entity record").argument("<entity-id>", "Entity ID").argument("<record-id>", "Record ID").argument("<field-name>", "Name of the file field (case-sensitive)").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--destination <path>", "Output file path (defaults to <record-id>_<field-name>.bin)").examples(FILES_DOWNLOAD_EXAMPLES).trackedAction(processContext, async (entityId, recordId, fieldName, options) => {
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const [downloadError, blob] = await catchError(sdk.entities.downloadAttachment(entityId, recordId, fieldName));
     if (downloadError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: `Error downloading file from field '${fieldName}'`,
-        Instructions: await extractErrorMessage(downloadError)
-      });
-      processContext.exit(1);
-      return;
+      return fail(`Error downloading file from field '${fieldName}'`, await extractErrorMessage(downloadError));
     }
     const outputPath = options.destination ?? `${recordId}_${fieldName}.bin`;
     const [bufferError, arrayBuffer] = await catchError(blob.arrayBuffer());
     if (bufferError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error reading downloaded file content",
-        Instructions: bufferError.message
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error reading downloaded file content", bufferError.message);
     }
     const [writeError] = await catchError(writeFileBinary(outputPath, new Uint8Array(arrayBuffer)));
     if (writeError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error writing downloaded file",
-        Instructions: writeError.message
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error writing downloaded file", writeError.message);
     }
     OutputFormatter.success({
       Result: RESULTS.Success,
@@ -44956,25 +45665,12 @@ var registerFilesCommand = (program2) => {
     });
   });
   files.command("delete").description("Delete a file from a field on an entity record").argument("<entity-id>", "Entity ID").argument("<record-id>", "Record ID").argument("<field-name>", "Name of the file field (case-sensitive)").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).examples(FILES_DELETE_EXAMPLES).trackedAction(processContext, async (entityId, recordId, fieldName, options) => {
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const [deleteError] = await catchError(sdk.entities.deleteAttachment(entityId, recordId, fieldName));
     if (deleteError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: `Error deleting file from field '${fieldName}'`,
-        Instructions: await extractErrorMessage(deleteError)
-      });
-      processContext.exit(1);
-      return;
+      return fail(`Error deleting file from field '${fieldName}'`, await extractErrorMessage(deleteError));
     }
     OutputFormatter.success({
       Result: RESULTS.Success,
@@ -44996,13 +45692,12 @@ async function writeFileBinary(filePath, data) {
 init_src();
 var RECORDS_LIST_EXAMPLES = [
   {
-    Description: "List records in an entity",
+    Description: "List records in an entity.",
     Command: "uip df records list a1b2c3d4-0000-0000-0000-000000000001 --limit 2",
     Output: {
       Code: "RecordList",
       Data: {
-        TotalCount: 2,
-        Records: [
+        items: [
           {
             Id: "b2c3d4e5-0000-0000-0000-000000000001",
             amount: 1500
@@ -45012,7 +45707,8 @@ var RECORDS_LIST_EXAMPLES = [
             amount: 2750
           }
         ],
-        HasNextPage: false
+        totalCount: 2,
+        hasNextPage: false
       }
     }
   }
@@ -45045,7 +45741,7 @@ var RECORDS_INSERT_EXAMPLES = [
     }
   },
   {
-    Description: "Insert a record into an entity that has choice-set and relationship fields. " + "CHOICE_SET_SINGLE → pass the choice value's 'NumberId' (integer, NOT the Name string — look it up via 'df choice-sets get <id>'). " + "CHOICE_SET_MULTIPLE → pass an array of NumberId integers. " + "RELATIONSHIP → always pass the target record's Id (UUID), even if the field was declared with a 'referenceFieldName' other than 'Id' (the referenceFieldName configures the join, not the stored value).",
+    Description: "Insert a record into an entity that has choice-set and relationship fields. " + "CHOICE_SET_SINGLE → pass the choice value's 'numberId' (integer, NOT the name string — look it up via 'df choice-sets list-values <id>'). " + "CHOICE_SET_MULTIPLE → pass an array of numberId integers. " + "RELATIONSHIP → always pass the target record's Id (UUID), regardless of which 'referenceFieldId' the schema uses for the join (the referenceFieldId configures the join, not the stored value).",
     Command: `uip df records insert a1b2c3d4-0000-0000-0000-000000000004 --body '{"category":0,"tags":[1,3],"submitter":"e1f2a3b4-0000-0000-0000-000000000001","amount":250}'`,
     Output: {
       Code: "RecordInserted",
@@ -45094,47 +45790,22 @@ var registerRecordsCommand = (program2) => {
   records.command("list").description("List records in a Data Fabric entity").argument("<id>", "Entity ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-l, --limit <number>", "Number of records to return per page", "50").option("-o, --offset <number>", "Start from the page containing this record index (rounded down to nearest page boundary; (mutually exclusive with --cursor)").option("--cursor <cursor>", "Pagination cursor from a previous response to fetch the next page").examples(RECORDS_LIST_EXAMPLES).trackedAction(processContext, async (entityId, options) => {
     const pageSize = Number(options.limit);
     if (Number.isNaN(pageSize) || pageSize < 1) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Invalid --limit value",
-        Instructions: "Provide a positive integer for --limit."
-      });
-      processContext.exit(1);
-      return;
+      return fail("Invalid --limit value", "Provide a positive integer for --limit.");
     }
     if (options.cursor !== undefined && options.offset !== undefined) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "--offset and --cursor are mutually exclusive",
-        Instructions: "Use --offset to jump to a position by record count, or --cursor to continue from a previous response."
-      });
-      processContext.exit(1);
-      return;
+      return fail("--offset and --cursor are mutually exclusive", "Use --offset to jump to a position by record count, or --cursor to continue from a previous response.");
     }
     let jumpToPage;
     if (options.offset !== undefined) {
       const offsetValue = Number(options.offset);
       if (Number.isNaN(offsetValue) || offsetValue < 0) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Invalid --offset value",
-          Instructions: "Provide a non-negative integer for --offset."
-        });
-        processContext.exit(1);
-        return;
+        return fail("Invalid --offset value", "Provide a non-negative integer for --offset.");
       }
       jumpToPage = Math.floor(offsetValue / pageSize) + 1;
     }
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const [listError, result] = await catchError(sdk.entities.getAllRecords(entityId, {
       pageSize,
       ...options.cursor !== undefined && {
@@ -45143,64 +45814,24 @@ var registerRecordsCommand = (program2) => {
       ...jumpToPage !== undefined && { jumpToPage }
     }));
     if (listError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error listing records",
-        Instructions: await extractErrorMessage(listError)
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error listing records", await extractErrorMessage(listError));
     }
-    const r = result;
-    const nextCursor = extractCursorValue(r.nextCursor);
     OutputFormatter.success({
       Result: RESULTS.Success,
       Code: "RecordList",
-      Data: {
-        TotalCount: r.totalCount ?? r.items.length,
-        Records: r.items,
-        HasNextPage: r.hasNextPage ?? false,
-        ...nextCursor !== undefined && {
-          NextCursor: nextCursor
-        },
-        ...r.currentPage !== undefined && {
-          CurrentPage: r.currentPage
-        },
-        ...r.totalPages !== undefined && {
-          TotalPages: r.totalPages
-        }
-      }
+      Data: result
     });
   });
   records.command("get").description("Get a single record by ID").argument("<id>", "Entity ID").argument("<key>", "Record ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).examples(RECORDS_GET_EXAMPLES).trackedAction(processContext, async (entityId, recordId, options) => {
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const [getError, record] = await catchError(sdk.entities.getRecordById(entityId, recordId));
     if (getError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: `Error getting record '${recordId}'`,
-        Instructions: await extractErrorMessage(getError)
-      });
-      processContext.exit(1);
-      return;
+      return fail(`Error getting record '${recordId}'`, await extractErrorMessage(getError));
     }
     if (!record) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: `Record '${recordId}' not found in entity '${entityId}'`,
-        Instructions: "Verify the record ID exists. Use 'df records list' to see available records."
-      });
-      processContext.exit(1);
-      return;
+      return fail(`Record '${recordId}' not found in entity '${entityId}'`, "Verify the record ID exists. Use 'df records list' to see available records.");
     }
     OutputFormatter.success({
       Result: RESULTS.Success,
@@ -45211,36 +45842,17 @@ var registerRecordsCommand = (program2) => {
   records.command("insert").description("Insert records into a Data Fabric entity").argument("<id>", "Entity ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-f, --file <path>", "Path to JSON file with record data (object or array of objects)").option("--body <json>", "Inline JSON record data (object or array of objects)").examples(RECORDS_INSERT_EXAMPLES).trackedAction(processContext, async (entityId, options) => {
     const [parseError, rawData] = await catchError(resolveJsonInput(options.file, options.body));
     if (parseError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error parsing input data",
-        Instructions: parseError.message
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error parsing input data", parseError.message);
     }
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const data = rawData;
     const recordsList = Array.isArray(data) ? data : [data];
     if (recordsList.length === 1) {
       const [insertError, result] = await catchError(sdk.entities.insertRecordById(entityId, recordsList[0]));
       if (insertError) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Error inserting record",
-          Instructions: await extractErrorMessage(insertError)
-        });
-        processContext.exit(1);
-        return;
+        return fail("Error inserting record", await extractErrorMessage(insertError));
       }
       OutputFormatter.success({
         Result: RESULTS.Success,
@@ -45250,13 +45862,7 @@ var registerRecordsCommand = (program2) => {
     } else {
       const [insertError, result] = await catchError(sdk.entities.insertRecordsById(entityId, recordsList));
       if (insertError) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Error inserting records",
-          Instructions: await extractErrorMessage(insertError)
-        });
-        processContext.exit(1);
-        return;
+        return fail("Error inserting records", await extractErrorMessage(insertError));
       }
       const r = result;
       const failureCount = r.failureRecords?.length ?? 0;
@@ -45278,47 +45884,22 @@ var registerRecordsCommand = (program2) => {
   records.command("update").description("Update records in a Data Fabric entity").argument("<id>", "Entity ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-f, --file <path>", "Path to JSON file with record data (must include Id field)").option("--body <json>", "Inline JSON record data (must include Id field)").examples(RECORDS_UPDATE_EXAMPLES).trackedAction(processContext, async (entityId, options) => {
     const [parseError, rawData] = await catchError(resolveJsonInput(options.file, options.body));
     if (parseError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error parsing input data",
-        Instructions: parseError.message
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error parsing input data", parseError.message);
     }
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const data = rawData;
     const recordsList = Array.isArray(data) ? data : [data];
     if (recordsList.length === 1) {
       const record = recordsList[0];
       const recordId = record.Id !== undefined ? record.Id : record.id;
       if (recordId === undefined || recordId === null) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Record must include an 'Id' field",
-          Instructions: "Provide the record ID in the JSON data."
-        });
-        processContext.exit(1);
-        return;
+        return fail("Record must include an 'Id' field", "Provide the record ID in the JSON data.");
       }
       const [updateError, result] = await catchError(sdk.entities.updateRecordById(entityId, String(recordId), record));
       if (updateError) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Error updating record",
-          Instructions: await extractErrorMessage(updateError)
-        });
-        processContext.exit(1);
-        return;
+        return fail("Error updating record", await extractErrorMessage(updateError));
       }
       OutputFormatter.success({
         Result: RESULTS.Success,
@@ -45328,23 +45909,11 @@ var registerRecordsCommand = (program2) => {
     } else {
       const missingId = recordsList.find((r2) => r2.Id == null && r2.id == null);
       if (missingId) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "All records must include an 'Id' field",
-          Instructions: "Provide the record ID in each JSON object."
-        });
-        processContext.exit(1);
-        return;
+        return fail("All records must include an 'Id' field", "Provide the record ID in each JSON object.");
       }
       const [updateError, result] = await catchError(sdk.entities.updateRecordsById(entityId, recordsList));
       if (updateError) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Error updating records",
-          Instructions: await extractErrorMessage(updateError)
-        });
-        processContext.exit(1);
-        return;
+        return fail("Error updating records", await extractErrorMessage(updateError));
       }
       const r = result;
       const failureCount = r.failureRecords?.length ?? 0;
@@ -45366,34 +45935,16 @@ var registerRecordsCommand = (program2) => {
   records.command("query").description("Query records in a Data Fabric entity with filters, sorting, and aggregates. " + "Provide a JSON object via --body or --file with optional keys: " + "filterGroup, sortOptions (use isDescending: true/false), selectedFields, " + "aggregates (function: COUNT/SUM/AVG/MIN/MAX, field, alias?), groupBy.").argument("<id>", "Entity ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-f, --file <path>", "Path to JSON file with query options (filterGroup, selectedFields, sortOptions, aggregates, groupBy)").option("--body <json>", "Inline JSON query options (filterGroup, selectedFields, sortOptions, aggregates, groupBy)").option("-l, --limit <number>", "Number of records to return per page", "50").option("-o, --offset <number>", "Start from the page containing this record index (rounded down to nearest page boundary;(mutually exclusive with --cursor)").option("--cursor <cursor>", "Pagination cursor from a previous response to fetch the next page").trackedAction(processContext, async (entityId, options) => {
     const pageSize = Number(options.limit);
     if (Number.isNaN(pageSize) || pageSize < 1) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Invalid --limit value",
-        Instructions: "Provide a positive integer for --limit."
-      });
-      processContext.exit(1);
-      return;
+      return fail("Invalid --limit value", "Provide a positive integer for --limit.");
     }
     if (options.cursor !== undefined && options.offset !== undefined) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "--offset and --cursor are mutually exclusive",
-        Instructions: "Use --offset to jump to a position by record count, or --cursor to continue from a previous response."
-      });
-      processContext.exit(1);
-      return;
+      return fail("--offset and --cursor are mutually exclusive", "Use --offset to jump to a position by record count, or --cursor to continue from a previous response.");
     }
     let jumpToPage;
     if (options.offset !== undefined) {
       const offsetValue = Number(options.offset);
       if (Number.isNaN(offsetValue) || offsetValue < 0) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Invalid --offset value",
-          Instructions: "Provide a non-negative integer for --offset."
-        });
-        processContext.exit(1);
-        return;
+        return fail("Invalid --offset value", "Provide a non-negative integer for --offset.");
       }
       jumpToPage = Math.floor(offsetValue / pageSize) + 1;
     }
@@ -45401,35 +45952,16 @@ var registerRecordsCommand = (program2) => {
     if (options.file !== undefined || options.body !== undefined) {
       const [parseError, parsed] = await catchError(readJsonInput(options.file, options.body, "Provide a JSON object with query options via --file or --body."));
       if (parseError) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Error parsing query options",
-          Instructions: parseError.message
-        });
-        processContext.exit(1);
-        return;
+        return fail("Error parsing query options", parseError.message);
       }
       if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Query options must be a JSON object",
-          Instructions: "Provide a JSON object (not an array) with filterGroup, selectedFields, sortOptions, aggregates, or groupBy."
-        });
-        processContext.exit(1);
-        return;
+        return fail("Query options must be a JSON object", "Provide a JSON object (not an array) with filterGroup, selectedFields, sortOptions, aggregates, or groupBy.");
       }
       queryBody = parsed;
     }
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const [queryError, result] = await catchError(sdk.entities.queryRecordsById(entityId, {
       ...queryBody !== null && queryBody,
       pageSize,
@@ -45439,77 +45971,31 @@ var registerRecordsCommand = (program2) => {
       ...jumpToPage !== undefined && { jumpToPage }
     }));
     if (queryError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error querying records",
-        Instructions: await extractErrorMessage(queryError)
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error querying records", await extractErrorMessage(queryError));
     }
-    const r = result;
-    const nextCursor = extractCursorValue(r.nextCursor);
     OutputFormatter.success({
       Result: RESULTS.Success,
       Code: "RecordQuery",
-      Data: {
-        TotalCount: r.totalCount ?? r.items.length,
-        Records: r.items,
-        HasNextPage: r.hasNextPage ?? false,
-        ...nextCursor !== undefined && {
-          NextCursor: nextCursor
-        },
-        ...r.currentPage !== undefined && {
-          CurrentPage: r.currentPage
-        },
-        ...r.totalPages !== undefined && {
-          TotalPages: r.totalPages
-        }
-      }
+      Data: result
     });
   });
   records.command("import").description("Import records from a CSV file into a Data Fabric entity").argument("<id>", "Entity ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-f, --file <path>", "Path to the CSV file to import").trackedAction(processContext, async (entityId, options) => {
     if (options.file === undefined) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "A CSV file path is required",
-        Instructions: "Provide a CSV file path via --file."
-      });
-      processContext.exit(1);
-      return;
+      return fail("A CSV file path is required", "Provide a CSV file path via --file.");
     }
     const [readError, fileContent] = await catchError(readFileBinary(options.file));
     if (readError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error reading CSV file",
-        Instructions: readError.message
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error reading CSV file", readError.message);
     }
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const fs7 = getFileSystem();
     const fileName = fs7.path.basename(options.file) || "import.csv";
     const csvFile = new File([fileContent], fileName, { type: "text/csv" });
     const [importError, result] = await catchError(sdk.entities.importRecordsById(entityId, csvFile));
     if (importError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error importing records",
-        Instructions: await extractErrorMessage(importError)
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error importing records", await extractErrorMessage(importError));
     }
     const r = result;
     OutputFormatter.success({
@@ -45525,25 +46011,12 @@ var registerRecordsCommand = (program2) => {
     });
   });
   records.command("delete").description("Delete records from a Data Fabric entity").argument("<id>", "Entity ID").argument("<key...>", "Record IDs to delete").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).examples(RECORDS_DELETE_EXAMPLES).trackedAction(processContext, async (entityId, recordIds, options) => {
-    const [clientError, sdk] = await catchError(createDataFabricClient(options.tenant));
-    if (clientError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error connecting to Data Fabric",
-        Instructions: await extractErrorMessage(clientError)
-      });
-      processContext.exit(1);
+    const sdk = await connectOrFail(options.tenant);
+    if (!sdk)
       return;
-    }
     const [deleteError, result] = await catchError(sdk.entities.deleteRecordsById(entityId, recordIds));
     if (deleteError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error deleting records",
-        Instructions: await extractErrorMessage(deleteError)
-      });
-      processContext.exit(1);
-      return;
+      return fail("Error deleting records", await extractErrorMessage(deleteError));
     }
     const r = result;
     const failureCount = r.failureRecords?.length ?? 0;
@@ -45583,6 +46056,7 @@ var registerCommands = async (program2) => {
   registerRecordsCommand(program2);
   registerFilesCommand(program2);
   registerChoiceSetsCommand(program2);
+  registerChoiceSetValuesCommand(program2);
 };
 export {
   registerCommands,