node-autotask 0.15.0 → 0.17.0

package/dist/{chunk-Z7YT72SS.cjs → chunk-4RJG73GY.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6;
 
-var _chunkEWMG3HHUcjs = require('./chunk-EWMG3HHU.cjs');
+var _chunk5ZGXWS4Ecjs = require('./chunk-5ZGXWS4E.cjs');
 
 // src/auth.ts
 var AUTH_HEADERS = {
@@ -171,6 +171,7 @@ var AutotaskError = class extends Error {
   
   
   
+  /** Legacy unlabeled id list (issue #116) — see `AutotaskErrorOptions.resourceIds`; the labeled companion rides on `details.idRefs`. */
   
   
   
@@ -1532,6 +1533,8 @@ var DEFAULT_PAGE_SIZE = 10;
 var MAX_PAGE_SIZE = 500;
 var DEFAULT_TIMEOUT_MS = 3e4;
 var DEFAULT_MAX_RETRIES = 3;
+var DEFAULT_MAINTENANCE_MAX_WAIT_MS = 36e5;
+var DEFAULT_MAINTENANCE_POLL_MS = 3e4;
 var DEFAULT_MAX_CONCURRENT = 10;
 var DEFAULT_MAX_RESPONSE_BYTES = 64 * 1024 * 1024;
 var DEFAULT_MAX_SCAN_RECORDS = 500;
@@ -1689,6 +1692,14 @@ function resolveConfig(config) {
   if (!Number.isInteger(maxRetries) || maxRetries < 0) {
     throw new AutotaskConfigError("maxRetries must be a non-negative integer");
   }
+  const maintenanceMaxWaitMs = _nullishCoalesce(config.maintenanceMaxWaitMs, () => ( DEFAULT_MAINTENANCE_MAX_WAIT_MS));
+  if (!Number.isInteger(maintenanceMaxWaitMs) || maintenanceMaxWaitMs < 0) {
+    throw new AutotaskConfigError("maintenanceMaxWaitMs must be a non-negative integer");
+  }
+  const maintenancePollMs = _nullishCoalesce(config.maintenancePollMs, () => ( DEFAULT_MAINTENANCE_POLL_MS));
+  if (!Number.isInteger(maintenancePollMs) || maintenancePollMs <= 0) {
+    throw new AutotaskConfigError("maintenancePollMs must be a positive integer");
+  }
   const maxConcurrent = _nullishCoalesce(config.maxConcurrent, () => ( (agent ? AGENT_PROFILE.maxConcurrent : DEFAULT_MAX_CONCURRENT)));
   if (!Number.isInteger(maxConcurrent) || maxConcurrent <= 0) {
     throw new AutotaskConfigError("maxConcurrent must be a positive integer");
@@ -1822,6 +1833,8 @@ function resolveConfig(config) {
     pageSize: pageSizeCapped,
     timeoutMs,
     maxRetries,
+    maintenanceMaxWaitMs,
+    maintenancePollMs,
     maxConcurrent,
     maxResponseBytes,
     logger,
@@ -14755,6 +14768,10 @@ function backoffDelay(attempt) {
   const exp = Math.min(BACKOFF_CAP_MS, BACKOFF_BASE_MS * 2 ** attempt);
   return Math.floor(exp / 2 + Math.random() * (exp / 2));
 }
+function isMaintenancePage(err) {
+  const snippet = typeof _optionalChain([err, 'access', _57 => _57.details, 'optionalAccess', _58 => _58.bodySnippet]) === "string" ? err.details.bodySnippet : "";
+  return /maintenance|temporarily unavailable|service unavailable|outage|downtime|down for/i.test(snippet);
+}
 function parseRetryAfter(value) {
   if (value === null || value.length === 0) return void 0;
   const trimmed = value.trim();
@@ -14771,7 +14788,7 @@ function isAbortLike(err) {
   return typeof err === "object" && err !== null && "name" in err && err.name === "AbortError";
 }
 function isJsonMediaType(header) {
-  const mediaType = _nullishCoalesce(_optionalChain([header, 'access', _57 => _57.split, 'call', _58 => _58(";"), 'access', _59 => _59[0], 'optionalAccess', _60 => _60.trim, 'call', _61 => _61(), 'access', _62 => _62.toLowerCase, 'call', _63 => _63()]), () => ( ""));
+  const mediaType = _nullishCoalesce(_optionalChain([header, 'access', _59 => _59.split, 'call', _60 => _60(";"), 'access', _61 => _61[0], 'optionalAccess', _62 => _62.trim, 'call', _63 => _63(), 'access', _64 => _64.toLowerCase, 'call', _65 => _65()]), () => ( ""));
   return mediaType.startsWith("application/json") || mediaType.endsWith("+json");
 }
 function bodySnippet(text, redactPersonalData) {
@@ -14851,6 +14868,9 @@ var HttpClient = (_class6 = class {
   
   
   
+  /** Maintenance-window auto-retry budget + poll (issue #112 follow-up; see config). */
+  
+  
   
   
   /** The resolved profile (issue #4) — the agent profile changes the
@@ -14921,8 +14941,10 @@ var HttpClient = (_class6 = class {
       impersonationResourceId: config.impersonationResourceId
     };
     this.maxRetries = config.maxRetries;
+    this.maintenanceMaxWaitMs = config.maintenanceMaxWaitMs;
+    this.maintenancePollMs = config.maintenancePollMs;
     this.maxResponseBytes = config.maxResponseBytes;
-    this.perHour = _optionalChain([config, 'access', _64 => _64.rateLimit, 'optionalAccess', _65 => _65.perHour]);
+    this.perHour = _optionalChain([config, 'access', _66 => _66.rateLimit, 'optionalAccess', _67 => _67.perHour]);
     this.tenantKey = buildTenantKey(config.userName, config.baseUrl);
     this.cooldownStore = config.cooldown.enabled ? _nullishCoalesce(config.cooldown.store, () => ( defaultCooldownStore())) : void 0;
     this.cooldownMaxMs = config.cooldown.maxMs;
@@ -14983,7 +15005,7 @@ var HttpClient = (_class6 = class {
     };
     if (next.successes >= breaker.successesToClose) {
       breaker.store.delete(key);
-      _optionalChain([this, 'access', _66 => _66.logger, 'access', _67 => _67.warn, 'optionalCall', _68 => _68(
+      _optionalChain([this, 'access', _68 => _68.logger, 'access', _69 => _69.warn, 'optionalCall', _70 => _70(
         `[autotask] circuit breaker CLOSED for ${key} (${next.successes} probe successes)`,
         void 0
       )]);
@@ -15013,7 +15035,7 @@ var HttpClient = (_class6 = class {
       const failures = [...st.failures.filter((t) => t > now - breaker.failureWindowMs), now];
       if (failures.length >= breaker.failureThreshold) {
         breaker.store.set(key, { failures, openedAt: now, successes: 0, probes: 0 });
-        _optionalChain([this, 'access', _69 => _69.logger, 'access', _70 => _70.warn, 'optionalCall', _71 => _71(
+        _optionalChain([this, 'access', _71 => _71.logger, 'access', _72 => _72.warn, 'optionalCall', _73 => _73(
           `[autotask] circuit breaker OPEN for ${key} (${failures.length} counted failures in ${Math.round(breaker.failureWindowMs / 1e3)}s) \u2014 refusing locally for ${Math.round(breaker.openTimeoutMs / 1e3)}s`,
           correlationId
         )]);
@@ -15128,7 +15150,7 @@ var HttpClient = (_class6 = class {
       return void 0;
     }
     if (res.status < 200 || res.status >= 300) {
-      await _optionalChain([res, 'access', _72 => _72.body, 'optionalAccess', _73 => _73.cancel, 'call', _74 => _74(), 'access', _75 => _75.catch, 'call', _76 => _76(() => void 0)]);
+      await _optionalChain([res, 'access', _74 => _74.body, 'optionalAccess', _75 => _75.cancel, 'call', _76 => _76(), 'access', _77 => _77.catch, 'call', _78 => _78(() => void 0)]);
       return void 0;
     }
     let text;
@@ -15164,7 +15186,7 @@ var HttpClient = (_class6 = class {
     this.liveBaseUrl = to;
     this.tenantKey = buildTenantKey(this.auth.userName, to);
     this.breakerKey = buildBreakerKey(to);
-    _optionalChain([this, 'access', _77 => _77.logger, 'access', _78 => _78.warn, 'optionalCall', _79 => _79(
+    _optionalChain([this, 'access', _79 => _79.logger, 'access', _80 => _80.warn, 'optionalCall', _81 => _81(
       `[autotask] zone re-point ${from} -> ${to} (a 401 on the stale zone base; the vendor's unauthenticated zone discovery named the tenant's current zone) \u2014 retrying the request once against the new base`,
       void 0
     )]);
@@ -15180,11 +15202,21 @@ var HttpClient = (_class6 = class {
     const correlationId = newCorrelationId();
     const timeoutMs = _nullishCoalesce(opts.timeoutMs, () => ( this.timeoutMs));
     const maxRetries = _nullishCoalesce(opts.maxRetries, () => ( this.maxRetries));
+    const maintenanceMaxWaitMs = _nullishCoalesce(opts.maintenanceMaxWaitMs, () => ( this.maintenanceMaxWaitMs));
+    const maintenancePollMs = _nullishCoalesce(opts.maintenancePollMs, () => ( this.maintenancePollMs));
+    let firstMaintenanceAt;
+    let maintenanceWaits = 0;
     const started = Date.now();
-    const deadlineAt = started + timeoutMs;
+    let deadlineAt = started + timeoutMs;
     const callerSignal = _nullishCoalesce(opts.signal, () => ( ambientSignal.getStore()));
+    const deadline = new AbortController();
+    let deadlineTimer = setTimeout(() => deadline.abort(), timeoutMs);
+    const armDeadline = (ms) => {
+      clearTimeout(deadlineTimer);
+      deadlineTimer = setTimeout(() => deadline.abort(), Math.max(0, ms));
+    };
     const signal = AbortSignal.any(
-      callerSignal === void 0 ? [AbortSignal.timeout(timeoutMs)] : [AbortSignal.timeout(timeoutMs), callerSignal]
+      callerSignal === void 0 ? [deadline.signal] : [deadline.signal, callerSignal]
     );
     const auditBody = opts.body !== void 0 ? redactAuditBody(opts.body) : void 0;
     const retriable = _nullishCoalesce(opts.idempotent, () => ( IDEMPOTENT_METHODS.includes(method)));
@@ -15192,7 +15224,7 @@ var HttpClient = (_class6 = class {
     const expectBody = _nullishCoalesce(opts.expectBody, () => ( method !== "DELETE"));
     const ctx = { operation: opts.operation, url, correlationId };
     let lastStatus;
-    const interrupted = () => _optionalChain([callerSignal, 'optionalAccess', _80 => _80.aborted]) ? new AutotaskAbortError(`Request aborted: ${method} ${opts.path}`, { ...ctx, suggestedAction: "The caller aborted; re-issue the call if still needed." }) : new AutotaskTimeoutError(`Request timed out after ${timeoutMs}ms: ${method} ${opts.path}`, ctx);
+    const interrupted = () => _optionalChain([callerSignal, 'optionalAccess', _82 => _82.aborted]) ? new AutotaskAbortError(`Request aborted: ${method} ${opts.path}`, { ...ctx, suggestedAction: "The caller aborted; re-issue the call if still needed." }) : new AutotaskTimeoutError(`Request timed out after ${timeoutMs}ms: ${method} ${opts.path}`, ctx);
     const canWait = (delay) => delay <= MAX_RETRY_DELAY_MS && delay < deadlineAt - Date.now();
     const pause = async (delay) => {
       try {
@@ -15202,11 +15234,11 @@ var HttpClient = (_class6 = class {
       }
     };
     if (this.cooldownStore !== void 0 && !opts.bypassCooldown) {
-      const deadline = this.cooldownStore.get(this.tenantKey);
-      if (deadline !== void 0) {
-        const remainingMs = deadline - Date.now();
+      const deadline2 = this.cooldownStore.get(this.tenantKey);
+      if (deadline2 !== void 0) {
+        const remainingMs = deadline2 - Date.now();
         if (remainingMs > 0) {
-          if (_optionalChain([callerSignal, 'optionalAccess', _81 => _81.aborted])) throw interrupted();
+          if (_optionalChain([callerSignal, 'optionalAccess', _83 => _83.aborted])) throw interrupted();
           const seconds = Math.ceil(remainingMs / 1e3);
           const err = new RateLimitError(
             `Tenant is in a rate-limit cooldown; the call was NOT sent. ${seconds}s remain \u2014 do not retry before then, and narrow the query (filter/includeFields) before retrying.`,
@@ -15237,7 +15269,7 @@ var HttpClient = (_class6 = class {
     let breakerProbe = false;
     let breakerProbeKey;
     if (this.breaker !== void 0 && !opts.bypassCircuitBreaker) {
-      if (_optionalChain([callerSignal, 'optionalAccess', _82 => _82.aborted])) throw interrupted();
+      if (_optionalChain([callerSignal, 'optionalAccess', _84 => _84.aborted])) throw interrupted();
       const now = Date.now();
       const st = this.breaker.store.get(this.breakerKey);
       if (st !== void 0 && st.openedAt !== null) {
@@ -15295,7 +15327,7 @@ var HttpClient = (_class6 = class {
         breakerProbeKey = this.breakerKey;
       }
     }
-    _optionalChain([this, 'access', _83 => _83.logger, 'access', _84 => _84.debug, 'optionalCall', _85 => _85(`[autotask] ${method} ${opts.path}`, correlationId)]);
+    _optionalChain([this, 'access', _85 => _85.logger, 'access', _86 => _86.debug, 'optionalCall', _87 => _87(`[autotask] ${method} ${opts.path}`, correlationId)]);
     try {
       let attempt = 0;
       let outcome = null;
@@ -15315,7 +15347,7 @@ var HttpClient = (_class6 = class {
           if (signal.aborted || isAbortLike(err2)) throw interrupted();
           const delay = backoffDelay(attempt);
           if (attempt < maxRetries && retriable5xx && canWait(delay)) {
-            _optionalChain([this, 'access', _86 => _86.logger, 'access', _87 => _87.warn, 'optionalCall', _88 => _88(
+            _optionalChain([this, 'access', _88 => _88.logger, 'access', _89 => _89.warn, 'optionalCall', _90 => _90(
               `[autotask] network error on ${method} ${opts.path}; retrying in ${delay}ms (attempt ${attempt + 1}/${maxRetries})`,
               correlationId
             )]);
@@ -15333,7 +15365,7 @@ var HttpClient = (_class6 = class {
         try {
           status = res.status;
           if (status >= 300 && status < 400) {
-            await _optionalChain([res, 'access', _89 => _89.body, 'optionalAccess', _90 => _90.cancel, 'call', _91 => _91(), 'access', _92 => _92.catch, 'call', _93 => _93(() => void 0)]);
+            await _optionalChain([res, 'access', _91 => _91.body, 'optionalAccess', _92 => _92.cancel, 'call', _93 => _93(), 'access', _94 => _94.catch, 'call', _95 => _95(() => void 0)]);
             throw new ResponseRejectedError(
               `Refused to follow a ${status} redirect for ${method} ${opts.path}`,
               { ...ctx, code: "REDIRECT_BLOCKED", httpStatus: status, suggestedAction: "Check the configured zone/baseUrl; the API does not redirect." }
@@ -15394,11 +15426,28 @@ var HttpClient = (_class6 = class {
               httpStatus: status,
               suggestedAction: "The zone returned a non-JSON 2xx body; verify baseUrl points at the REST API."
             });
+            if (err2.code === "UNEXPECTED_CONTENT_TYPE" && maintenanceMaxWaitMs > 0 && isMaintenancePage(err2)) {
+              const now = Date.now();
+              firstMaintenanceAt ??= now;
+              const remaining = maintenanceMaxWaitMs - (now - firstMaintenanceAt);
+              if (remaining > 0) {
+                const wait = Math.min(maintenancePollMs, remaining);
+                maintenanceWaits += 1;
+                _optionalChain([this, 'access', _96 => _96.logger, 'access', _97 => _97.warn, 'optionalCall', _98 => _98(
+                  `[autotask] maintenance window on ${method} ${opts.path}; waiting ${Math.round(wait / 1e3)}s (retry ${maintenanceWaits}, up to ${Math.round(maintenanceMaxWaitMs / 6e4)} min)`,
+                  correlationId
+                )]);
+                deadlineAt = Date.now() + wait + timeoutMs;
+                armDeadline(deadlineAt - Date.now());
+                await pause(wait);
+                continue;
+              }
+            }
             if (err2.code === "UNEXPECTED_CONTENT_TYPE" && retriable5xx && attempt < maxRetries) {
               const retryAfter = parseRetryAfter(res.headers.get("Retry-After"));
               const delay = retryAfter !== void 0 ? retryAfter * 1e3 : backoffDelay(attempt);
               if (canWait(delay)) {
-                _optionalChain([this, 'access', _94 => _94.logger, 'access', _95 => _95.warn, 'optionalCall', _96 => _96(
+                _optionalChain([this, 'access', _99 => _99.logger, 'access', _100 => _100.warn, 'optionalCall', _101 => _101(
                   `[autotask] non-JSON 2xx on ${method} ${opts.path}; retrying in ${delay}ms (attempt ${attempt + 1}/${maxRetries})`,
                   correlationId
                 )]);
@@ -15407,6 +15456,18 @@ var HttpClient = (_class6 = class {
                 continue;
               }
             }
+            if (maintenanceWaits > 0 && err2.code === "UNEXPECTED_CONTENT_TYPE") {
+              err2.details = {
+                ..._nullishCoalesce(err2.details, () => ( {})),
+                maintenance: {
+                  waits: maintenanceWaits,
+                  waitedMs: Date.now() - (_nullishCoalesce(firstMaintenanceAt, () => ( Date.now()))),
+                  maxWaitMs: maintenanceMaxWaitMs,
+                  exhausted: true
+                }
+              };
+              err2.suggestedAction = `The zone stayed in a maintenance window for ${Math.round(maintenanceMaxWaitMs / 6e4)} min \u2014 the SDK waited and retried ${maintenanceWaits} time(s) and gave up. Re-run after the window (typically under 30 min), or raise maintenanceMaxWaitMs.`;
+            }
             attachEmptyReasonDetails(err2);
             throw err2;
           }
@@ -15430,7 +15491,7 @@ var HttpClient = (_class6 = class {
           const retryAfter = parseRetryAfter(res.headers.get("Retry-After"));
           const delay = retryAfter !== void 0 ? retryAfter * 1e3 : backoffDelay(attempt);
           if (canWait(delay)) {
-            _optionalChain([this, 'access', _97 => _97.logger, 'access', _98 => _98.warn, 'optionalCall', _99 => _99(
+            _optionalChain([this, 'access', _102 => _102.logger, 'access', _103 => _103.warn, 'optionalCall', _104 => _104(
               `[autotask] ${status} on ${method} ${opts.path}; retrying in ${delay}ms (attempt ${attempt + 1}/${maxRetries})`,
               correlationId
             )]);
@@ -15443,7 +15504,7 @@ var HttpClient = (_class6 = class {
           const target = await this.discoverZoneBase(signal, ctx);
           const targetViolation = target === void 0 || this.hostPolicy === void 0 ? null : decideHostPolicy(target, this.hostPolicy);
           if (targetViolation !== null) {
-            _optionalChain([this, 'access', _100 => _100.logger, 'access', _101 => _101.warn, 'optionalCall', _102 => _102(
+            _optionalChain([this, 'access', _105 => _105.logger, 'access', _106 => _106.warn, 'optionalCall', _107 => _107(
               `[autotask] zone re-point refused by hostPolicy (${targetViolation.bound}): ${targetViolation.origin} \u2014 the original 401 propagates, zero wire to the refused host`,
               void 0
             )]);
@@ -15481,7 +15542,7 @@ var HttpClient = (_class6 = class {
             threadThreshold
           });
           this.cooldownStore.set(this.tenantKey, Date.now() + durationMs);
-          _optionalChain([this, 'access', _103 => _103.logger, 'access', _104 => _104.warn, 'optionalCall', _105 => _105(
+          _optionalChain([this, 'access', _108 => _108.logger, 'access', _109 => _109.warn, 'optionalCall', _110 => _110(
             `[autotask] 429 on ${method} ${opts.path} surfaces after ${attempt + 1} attempt(s); tenant cooldown armed for ${Math.round(durationMs / 1e3)}s`,
             correlationId
           )]);
@@ -15526,7 +15587,7 @@ var HttpClient = (_class6 = class {
       if (this.fieldCache !== void 0 && err instanceof AutotaskError) {
         const op = typeof opts.operation === "string" ? opts.operation : void 0;
         const verb = op !== void 0 ? op.slice(op.lastIndexOf(".") + 1) : "";
-        const drift = _optionalChain([err, 'access', _106 => _106.details, 'optionalAccess', _107 => _107.deterministic]) === true || err.code === "INVALID_RESPONSE" && META_TRIO_VERBS.has(verb);
+        const drift = _optionalChain([err, 'access', _111 => _111.details, 'optionalAccess', _112 => _112.deterministic]) === true || err.code === "INVALID_RESPONSE" && META_TRIO_VERBS.has(verb);
         if (drift && op !== void 0) {
           const dot = op.indexOf(".");
           if (dot > 0) this.fieldCache.invalidate(op.slice(0, dot));
@@ -15534,8 +15595,9 @@ var HttpClient = (_class6 = class {
       }
       throw err;
     } finally {
+      clearTimeout(deadlineTimer);
       if (!(method === "GET" || opts.idempotent === true)) {
-        _optionalChain([this, 'access', _108 => _108.readCache, 'optionalAccess', _109 => _109.clear, 'call', _110 => _110()]);
+        _optionalChain([this, 'access', _113 => _113.readCache, 'optionalAccess', _114 => _114.clear, 'call', _115 => _115()]);
         const nameOp = typeof opts.operation === "string" ? opts.operation : void 0;
         const nameDot = nameOp !== void 0 ? nameOp.indexOf(".") : -1;
         if (this.resourceNameCache !== void 0 && nameOp !== void 0 && nameDot > 0 && nameOp.slice(0, nameDot) === "resources") {
@@ -15555,7 +15617,7 @@ function attachEmptyReasonDetails(err) {
   const resource = err.operation.slice(0, dot);
   const op = err.operation.slice(dot + 1);
   const surface = err.operation;
-  const stamp = _optionalChain([EMPTY_REASON_STAMPS, 'access', _111 => _111[resource], 'optionalAccess', _112 => _112[op]]);
+  const stamp = _optionalChain([EMPTY_REASON_STAMPS, 'access', _116 => _116[resource], 'optionalAccess', _117 => _117[op]]);
   const pointer = POINTER_NOTES[surface];
   const isGetMiss = err instanceof NotFoundError && op === "get";
   if (stamp === void 0 && pointer === void 0 && !isGetMiss) return;
@@ -15594,7 +15656,7 @@ function unwrapItems(body, operation) {
   }
   return { items: body.items, pageDetails: body.pageDetails };
 }
-function unwrapItem(body, id, operation) {
+function unwrapItem(body, id, operation, entity) {
   if (!isRecord2(body) || !("item" in body)) {
     throw new AutotaskError("Expected the item envelope { item }; got a different shape", {
       code: "INVALID_RESPONSE",
@@ -15610,6 +15672,7 @@ function unwrapItem(body, id, operation) {
       {
         httpStatus: 200,
         resourceIds: id !== void 0 ? [id] : void 0,
+        ...id !== void 0 && entity !== void 0 ? { details: { idRefs: [{ entity, id }] } } : {},
         operation,
         suggestedAction: "Verify the id, or resolve the record by name first."
       }
@@ -15844,7 +15907,7 @@ async function expandResourceNames(client, ids, opts = {}) {
         continue;
       }
     }
-    const epoch = _nullishCoalesce(_optionalChain([cache, 'optionalAccess', _113 => _113.epoch]), () => ( 0));
+    const epoch = _nullishCoalesce(_optionalChain([cache, 'optionalAccess', _118 => _118.epoch]), () => ( 0));
     const work = (async () => {
       try {
         const record = await holder.get(id, { fresh });
@@ -15930,7 +15993,7 @@ function capabilitySets() {
   const fieldOps = /* @__PURE__ */ new Map();
   const udfOps = /* @__PURE__ */ new Map();
   const resources = /* @__PURE__ */ new Set();
-  for (const rec of _chunkEWMG3HHUcjs.CAPABILITIES) {
+  for (const rec of _chunk5ZGXWS4Ecjs.CAPABILITIES) {
     if (rec.resource === "operations") continue;
     resources.add(rec.resource);
     if (rec.operation === "getFieldInfo") fieldOps.set(rec.resource, rec);
@@ -15963,7 +16026,7 @@ async function fieldCatalog(client, opts) {
     }
   }
   const { fieldOps, udfOps, resources: allResources } = capabilitySets();
-  const includeRaw = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _114 => _114.include]), () => ( ["fields"]));
+  const includeRaw = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _119 => _119.include]), () => ( ["fields"]));
   if (!Array.isArray(includeRaw) || includeRaw.length === 0) {
     throw new AutotaskConfigError("fieldCatalog: opts.include must be a non-empty array of (info|fields|udf)");
   }
@@ -15977,7 +16040,7 @@ async function fieldCatalog(client, opts) {
     }
     if (!include.includes(kind)) include.push(kind);
   }
-  const resourcesRaw = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _115 => _115.resources]), () => ( WORKFLOW_RESOURCES));
+  const resourcesRaw = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _120 => _120.resources]), () => ( WORKFLOW_RESOURCES));
   if (!Array.isArray(resourcesRaw) || resourcesRaw.length === 0) {
     throw new AutotaskConfigError("fieldCatalog: opts.resources must be a non-empty array of plan resource keys");
   }
@@ -16009,7 +16072,7 @@ async function fieldCatalog(client, opts) {
     if (!targets.includes(key)) targets.push(key);
   }
   let fieldsFilter;
-  const fieldsRaw = _optionalChain([opts, 'optionalAccess', _116 => _116.fields]);
+  const fieldsRaw = _optionalChain([opts, 'optionalAccess', _121 => _121.fields]);
   if (fieldsRaw !== void 0) {
     if (!Array.isArray(fieldsRaw) || fieldsRaw.length === 0) {
       throw new AutotaskConfigError("fieldCatalog: opts.fields must be a non-empty array of vendor field name strings");
@@ -16031,7 +16094,7 @@ async function fieldCatalog(client, opts) {
       `fieldCatalog: opts.labels must be a boolean (got ${typeof opts.labels})`
     );
   }
-  const labels = _optionalChain([opts, 'optionalAccess', _117 => _117.labels]) === true;
+  const labels = _optionalChain([opts, 'optionalAccess', _122 => _122.labels]) === true;
   const cost = targets.length * include.length;
   if (cost > MAX_FIELD_CATALOG_WIRE) {
     throw new AutotaskConfigError(
@@ -16040,7 +16103,7 @@ async function fieldCatalog(client, opts) {
     );
   }
   const cache = client.http.fieldCache;
-  const fresh = _optionalChain([opts, 'optionalAccess', _118 => _118.fresh]) === true;
+  const fresh = _optionalChain([opts, 'optionalAccess', _123 => _123.fresh]) === true;
   const zone = _nullishCoalesce(client.config.zone, () => ( "unknown"));
   const rows = [];
   let wireUsed = 0;
@@ -16064,11 +16127,11 @@ async function fieldCatalog(client, opts) {
       error: null
     };
     const fetches = {
-      info: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _119 => _119.getEntityInfo, 'optionalCall', _120 => _120()]), () => ( Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getEntityInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" })))),
-      fields: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _121 => _121.getFieldInfo, 'optionalCall', _122 => _122()]), () => ( Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getFieldInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" })))),
-      udf: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _123 => _123.getUdfInfo, 'optionalCall', _124 => _124()]), () => ( Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getUdfInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" }))))
+      info: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _124 => _124.getEntityInfo, 'optionalCall', _125 => _125()]), () => ( Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getEntityInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" })))),
+      fields: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _126 => _126.getFieldInfo, 'optionalCall', _127 => _127()]), () => ( Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getFieldInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" })))),
+      udf: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _128 => _128.getUdfInfo, 'optionalCall', _129 => _129()]), () => ( Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getUdfInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" }))))
     };
-    if (fresh) _optionalChain([cache, 'optionalAccess', _125 => _125.invalidate, 'call', _126 => _126(resource)]);
+    if (fresh) _optionalChain([cache, 'optionalAccess', _130 => _130.invalidate, 'call', _131 => _131(resource)]);
     let allCached = true;
     const ages = [];
     for (const kind of include) {
@@ -16121,7 +16184,7 @@ async function fieldCatalog(client, opts) {
     label: zone,
     cached: cache !== void 0,
     labels,
-    ttlMs: _nullishCoalesce(_optionalChain([cache, 'optionalAccess', _127 => _127.ttlMs]), () => ( null)),
+    ttlMs: _nullishCoalesce(_optionalChain([cache, 'optionalAccess', _132 => _132.ttlMs]), () => ( null)),
     fetchedAt: (/* @__PURE__ */ new Date()).toISOString(),
     rows,
     wireUsed,
@@ -16286,7 +16349,7 @@ async function resolveCompositeNames(http, plan, opts = {}) {
       } else {
         for (const f of plan.labelFields) {
           const frow = row.fields.find((x) => x.name === f);
-          picklists[f] = _optionalChain([frow, 'optionalAccess', _128 => _128.picklistValues]);
+          picklists[f] = _optionalChain([frow, 'optionalAccess', _133 => _133.picklistValues]);
         }
       }
     } catch (err) {
@@ -16297,8 +16360,8 @@ async function resolveCompositeNames(http, plan, opts = {}) {
   }
   return {
     section,
-    resourceName: (id) => _nullishCoalesce(_optionalChain([section, 'access', _129 => _129.rows, 'access', _130 => _130[`resource:${id}`], 'optionalAccess', _131 => _131.name]), () => ( null)),
-    recordName: (table, id) => _nullishCoalesce(_optionalChain([section, 'access', _132 => _132.rows, 'access', _133 => _133[`${table}:${id}`], 'optionalAccess', _134 => _134.name]), () => ( null)),
+    resourceName: (id) => _nullishCoalesce(_optionalChain([section, 'access', _134 => _134.rows, 'access', _135 => _135[`resource:${id}`], 'optionalAccess', _136 => _136.name]), () => ( null)),
+    recordName: (table, id) => _nullishCoalesce(_optionalChain([section, 'access', _137 => _137.rows, 'access', _138 => _138[`${table}:${id}`], 'optionalAccess', _139 => _139.name]), () => ( null)),
     labelFor: (field, value) => {
       if (value === null || value === void 0) return null;
       const values = picklists[field];
@@ -16569,8 +16632,8 @@ function validateFetchManyItems(items, cap, opName = "fetchMany", capRef = `FETC
         problems.push(`${at}.fields: must be an array of exact vendor field names (discover them via operations.fieldCatalog)`);
         continue;
       }
-      if (_optionalChain([validation, 'optionalAccess', _135 => _135.fieldCheck]) !== false) {
-        const authoritative = _nullishCoalesce(_optionalChain([validation, 'optionalAccess', _136 => _136.fieldSetsByResource, 'optionalAccess', _137 => _137.get, 'call', _138 => _138(resourceKey)]), () => ( fields));
+      if (_optionalChain([validation, 'optionalAccess', _140 => _140.fieldCheck]) !== false) {
+        const authoritative = _nullishCoalesce(_optionalChain([validation, 'optionalAccess', _141 => _141.fieldSetsByResource, 'optionalAccess', _142 => _142.get, 'call', _143 => _143(resourceKey)]), () => ( fields));
         for (const f of item.fields) {
           if (!authoritative.includes(f)) {
             problems.push(
@@ -16674,7 +16737,7 @@ function project2(value, fields) {
   return out;
 }
 function resourcePathOf(key, holder) {
-  const path = _optionalChain([holder, 'optionalAccess', _139 => _139.resourcePath]);
+  const path = _optionalChain([holder, 'optionalAccess', _144 => _144.resourcePath]);
   if (typeof path !== "string" || path === "") {
     throw new AutotaskConfigError(`fetchByIds: the client exposes no ${key} resource path (registry drift)`, {
       suggestedAction: "Rebuild the client from the SDK build that ships this registry (the resource set is pinned by the plan)."
@@ -16846,7 +16909,7 @@ function blindEmptyReason(stamp) {
   };
 }
 function attachUpdateTargetMissReason(err, key) {
-  const pinned = _optionalChain([EMPTY_REASON_STAMPS, 'access', _140 => _140[key], 'optionalAccess', _141 => _141.update]);
+  const pinned = _optionalChain([EMPTY_REASON_STAMPS, 'access', _145 => _145[key], 'optionalAccess', _146 => _146.update]);
   if (pinned === void 0) return;
   err.details = { ..._nullishCoalesce(err.details, () => ( {})), emptyReason: pinned };
 }
@@ -16930,6 +16993,19 @@ function decodeFileData(body) {
     { code: "INVALID_RESPONSE", category: "server" }
   );
 }
+var DEPLURAL_EXCEPTIONS = {
+  tag_aliase: "tag_alias"
+};
+function entityNameFromPath(resourcePath) {
+  const segment = resourcePath.slice(resourcePath.lastIndexOf("/") + 1);
+  const snake = segment.replace(/([A-Z])/g, (_m, c, i) => (i > 0 ? `_` : "") + c.toLowerCase()).replace(/_{2,}/g, "_");
+  if (snake.endsWith("ies")) return `${snake.slice(0, -3)}y`;
+  if (snake.endsWith("s")) {
+    const stripped = snake.slice(0, -1);
+    return _nullishCoalesce(DEPLURAL_EXCEPTIONS[stripped], () => ( stripped));
+  }
+  return snake;
+}
 var BaseResource = class {
   
   
@@ -16939,6 +17015,10 @@ var BaseResource = class {
   get resourcePath() {
     return this.config.resourcePath;
   }
+  /** The vendor entity this resource's ids identify (issue #116 — the `details.idRefs` label, e.g. `company`). */
+  get entityName() {
+    return entityNameFromPath(this.resourcePath);
+  }
   /** Parent-scoped template (from the config); undefined for top-level resources. */
   get parentScopedPath() {
     return this.config.parentScopedPath;
@@ -17011,7 +17091,7 @@ var BaseResource = class {
     return (page, pageSize) => this.fetchPage(p, page, pageSize, state);
   }
   walkPageSize(params) {
-    return clampPageSize(_nullishCoalesce(_optionalChain([params, 'optionalAccess', _142 => _142.maxRecords]), () => ( this.defaultPageSize)));
+    return clampPageSize(_nullishCoalesce(_optionalChain([params, 'optionalAccess', _147 => _147.maxRecords]), () => ( this.defaultPageSize)));
   }
   /** Stream items across pages (the resource `query` surface). */
   queryItems(params) {
@@ -17023,7 +17103,7 @@ var BaseResource = class {
   }
   /** Collect every item across all pages (the resource `queryAll` surface; 1000-page guarded). */
   async queryAllItems(params) {
-    return collectAll(this.pageFetcher(params), { pageSize: this.walkPageSize(params), maxRecords: _optionalChain([params, 'optionalAccess', _143 => _143.maxTotalRecords]) });
+    return collectAll(this.pageFetcher(params), { pageSize: this.walkPageSize(params), maxRecords: _optionalChain([params, 'optionalAccess', _148 => _148.maxTotalRecords]) });
   }
   /**
    * `queryBounded` — server-side pagination (the MCP query surface): ONE call
@@ -17058,19 +17138,19 @@ var BaseResource = class {
         "queryBounded: params must be an object { filter?, limit?, latest?, includeFields? } \u2014 a bare conditions array is not accepted (wrap it: { filter: [...] })"
       );
     }
-    const limit = _nullishCoalesce(_optionalChain([params, 'optionalAccess', _144 => _144.limit]), () => ( BOUNDED_QUERY_DEFAULT_LIMIT));
+    const limit = _nullishCoalesce(_optionalChain([params, 'optionalAccess', _149 => _149.limit]), () => ( BOUNDED_QUERY_DEFAULT_LIMIT));
     if (!Number.isInteger(limit) || limit < 1 || limit > BOUNDED_QUERY_MAX_LIMIT) {
       throw new AutotaskConfigError(
         `queryBounded: limit must be an integer 1..${BOUNDED_QUERY_MAX_LIMIT} (got ${String(limit)}) \u2014 it is the TOTAL record cap, not a page size`
       );
     }
-    const noteChars = _optionalChain([params, 'optionalAccess', _145 => _145.noteChars]);
+    const noteChars = _optionalChain([params, 'optionalAccess', _150 => _150.noteChars]);
     if (noteChars !== void 0 && (!Number.isInteger(noteChars) || noteChars < 1)) {
       throw new AutotaskConfigError(
         `queryBounded: noteChars must be an integer >= 1 (got ${String(noteChars)}) \u2014 it is the per-field char cap on the untrusted-class free-text fields (absent = the raw, untruncated result)`
       );
     }
-    const walkParams = _optionalChain([params, 'optionalAccess', _146 => _146.fieldsPreset]) !== void 0 ? { ...params, includeFields: resolveFieldsPreset(params.fieldsPreset, this.config.key, params.includeFields) } : _nullishCoalesce(params, () => ( {}));
+    const walkParams = _optionalChain([params, 'optionalAccess', _151 => _151.fieldsPreset]) !== void 0 ? { ...params, includeFields: resolveFieldsPreset(params.fieldsPreset, this.config.key, params.includeFields) } : _nullishCoalesce(params, () => ( {}));
     const latest = walkParams.latest;
     if (latest !== void 0) {
       if (!Number.isInteger(latest) || latest < 1 || latest > BOUNDED_QUERY_MAX_LIMIT) {
@@ -17078,7 +17158,7 @@ var BaseResource = class {
           `queryBounded: latest must be an integer 1..${BOUNDED_QUERY_MAX_LIMIT} (got ${String(latest)}) \u2014 it is the count of the highest-id rows to return`
         );
       }
-      if (_optionalChain([params, 'optionalAccess', _147 => _147.limit]) !== void 0 && limit < latest) {
+      if (_optionalChain([params, 'optionalAccess', _152 => _152.limit]) !== void 0 && limit < latest) {
         throw new AutotaskConfigError(
           `queryBounded: limit (${String(limit)}) must be >= latest (${String(latest)}) \u2014 latest governs the returned count and limit is the walk window`
         );
@@ -17160,8 +17240,8 @@ var BaseResource = class {
    *  speculation). */
   stampEmptyQueryResult(result, params) {
     if (result.items.length !== 0) return;
-    result.blindSurface = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _148 => _148[this.config.key], 'optionalAccess', _149 => _149.query]), _optionalChain([params, 'optionalAccess', _150 => _150.filter]));
-    const pinnedReason = normalizedConditions(_optionalChain([params, 'optionalAccess', _151 => _151.filter])) === void 0 ? _optionalChain([EMPTY_REASON_STAMPS, 'access', _152 => _152[this.config.key], 'optionalAccess', _153 => _153.query]) : void 0;
+    result.blindSurface = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _153 => _153[this.config.key], 'optionalAccess', _154 => _154.query]), _optionalChain([params, 'optionalAccess', _155 => _155.filter]));
+    const pinnedReason = normalizedConditions(_optionalChain([params, 'optionalAccess', _156 => _156.filter])) === void 0 ? _optionalChain([EMPTY_REASON_STAMPS, 'access', _157 => _157[this.config.key], 'optionalAccess', _158 => _158.query]) : void 0;
     if (result.blindSurface !== void 0 || pinnedReason !== void 0) {
       result.emptyReason = result.blindSurface !== void 0 ? blindEmptyReason(result.blindSurface) : pinnedReason;
     }
@@ -17312,7 +17392,7 @@ var BaseResource = class {
     if (result.items.length === 0) {
       this.stampEmptyQueryResult(result, params);
     } else {
-      result.blindSurface = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _154 => _154[this.config.key], 'optionalAccess', _155 => _155.query]), params.filter);
+      result.blindSurface = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _159 => _159[this.config.key], 'optionalAccess', _160 => _160.query]), params.filter);
     }
     return result;
   }
@@ -17351,7 +17431,7 @@ var BaseResource = class {
    *  or, on a plan-pinned blind surface, the `{ count: 0, blindSurface }`
    *  typed sentinel (S12-C T10; see `BlindCountResult`). */
   async countGlobal(params) {
-    const conditions = normalizedConditions(_optionalChain([params, 'optionalAccess', _156 => _156.filter]));
+    const conditions = normalizedConditions(_optionalChain([params, 'optionalAccess', _161 => _161.filter]));
     const body = {};
     body.filter = conditions === void 0 ? [] : buildFilter(conditions).filter;
     const res = await this.http.request({
@@ -17362,9 +17442,9 @@ var BaseResource = class {
       idempotent: true
     });
     const count = unwrapQueryCount(res, `${this.config.key}.count`);
-    const stamp = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _157 => _157[this.config.key], 'optionalAccess', _158 => _158.count]), _optionalChain([params, 'optionalAccess', _159 => _159.filter]));
+    const stamp = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _162 => _162[this.config.key], 'optionalAccess', _163 => _163.count]), _optionalChain([params, 'optionalAccess', _164 => _164.filter]));
     if (count === 0) {
-      const pinnedReason = conditions === void 0 ? _optionalChain([EMPTY_REASON_STAMPS, 'access', _160 => _160[this.config.key], 'optionalAccess', _161 => _161.count]) : void 0;
+      const pinnedReason = conditions === void 0 ? _optionalChain([EMPTY_REASON_STAMPS, 'access', _165 => _165[this.config.key], 'optionalAccess', _166 => _166.count]) : void 0;
       if (stamp !== void 0 || pinnedReason !== void 0) {
         return {
           count,
@@ -17395,9 +17475,9 @@ var BaseResource = class {
       const hit = cache.get(path);
       if (hit !== void 0) return hit;
     }
-    const epoch = _optionalChain([cache, 'optionalAccess', _162 => _162.epoch]);
+    const epoch = _optionalChain([cache, 'optionalAccess', _167 => _167.epoch]);
     const res = await this.http.request({ method: "GET", path, operation });
-    _optionalChain([cache, 'optionalAccess', _163 => _163.set, 'call', _164 => _164(path, res, resource, epoch)]);
+    _optionalChain([cache, 'optionalAccess', _168 => _168.set, 'call', _169 => _169(path, res, resource, epoch)]);
     return res;
   }
   /**
@@ -17436,7 +17516,7 @@ var BaseResource = class {
       return value;
     });
     work.catch((err) => {
-      if (err instanceof AutotaskError && (err.code === "INVALID_RESPONSE" || _optionalChain([err, 'access', _165 => _165.details, 'optionalAccess', _166 => _166.deterministic]) === true)) {
+      if (err instanceof AutotaskError && (err.code === "INVALID_RESPONSE" || _optionalChain([err, 'access', _170 => _170.details, 'optionalAccess', _171 => _171.deterministic]) === true)) {
         cache.invalidate(key);
       }
     });
@@ -17446,7 +17526,7 @@ var BaseResource = class {
   async getGlobal(id, fresh = false) {
     const numeric = parseIdentifier(id, "id");
     const res = await this.cachedGet(`${this.resourcePath}/${numeric}`, `${this.config.key}.get`, fresh, this.config.key);
-    return unwrapItem(res, numeric, `${this.config.key}.get`);
+    return unwrapItem(res, numeric, `${this.config.key}.get`, this.entityName);
   }
   /**
    * V2 merge read: a FRESH single-record GET that skips response redaction
@@ -17466,9 +17546,9 @@ var BaseResource = class {
       path: `${this.resourcePath}/${numeric}`,
       operation: `${this.config.key}.get`,
       skipResponseRedaction: true,
-      maxRetries: _optionalChain([readOpts, 'optionalAccess', _167 => _167.maxRetries])
+      maxRetries: _optionalChain([readOpts, 'optionalAccess', _172 => _172.maxRetries])
     });
-    return unwrapItem(res, numeric, `${this.config.key}.get`);
+    return unwrapItem(res, numeric, `${this.config.key}.get`, this.entityName);
   }
   /**
    * Issue #34 fallback merge read: a FRESH parent-scoped single-record GET
@@ -17485,15 +17565,15 @@ var BaseResource = class {
       path: this.scopedItemPath(parentId, numeric),
       operation: `${this.config.key}.get`,
       skipResponseRedaction: true,
-      maxRetries: _optionalChain([readOpts, 'optionalAccess', _168 => _168.maxRetries])
+      maxRetries: _optionalChain([readOpts, 'optionalAccess', _173 => _173.maxRetries])
     });
-    return unwrapItem(res, numeric, `${this.config.key}.get`);
+    return unwrapItem(res, numeric, `${this.config.key}.get`, this.entityName);
   }
   /** Parent-scoped `GET .../{parentId}/<Child>/{id}` → `{ item }` unwrapped. */
   async getScopedRaw(parentId, id, fresh = false) {
     const numeric = parseIdentifier(id, "id");
     const res = await this.cachedGet(this.scopedItemPath(parentId, id), `${this.config.key}.get`, fresh, this.config.key);
-    return unwrapItem(res, numeric, `${this.config.key}.get`);
+    return unwrapItem(res, numeric, `${this.config.key}.get`, this.entityName);
   }
   /**
    * Attachment single-read: the vendor answers the model DIRECTLY (swagger),
@@ -17503,23 +17583,23 @@ var BaseResource = class {
   async getScopedModel(parentId, id, fresh = false) {
     const numeric = parseIdentifier(id, "id");
     const res = await this.cachedGet(this.scopedItemPath(parentId, id), `${this.config.key}.get`, fresh, this.config.key);
-    return this.unwrapModelLike(res, numeric);
+    return this.unwrapModelLike(res, numeric, this.entityName);
   }
-  unwrapModelLike(body, id) {
+  unwrapModelLike(body, id, entity) {
     if (!isRecord2(body)) {
       throw new AutotaskError(
         `Expected an attachment model (or { item } / { items }) envelope for ID ${id}; got a different shape`,
-        { code: "INVALID_RESPONSE", category: "server", resourceIds: [id] }
+        { code: "INVALID_RESPONSE", category: "server", resourceIds: [id], details: { idRefs: [{ entity, id }] } }
       );
     }
     if (Object.keys(body).length === 0) {
-      throw new NotFoundError(`The record with ID ${id} was not found`, { httpStatus: 200, resourceIds: [id] });
+      throw new NotFoundError(`The record with ID ${id} was not found`, { httpStatus: 200, resourceIds: [id], details: { idRefs: [{ entity, id }] } });
     }
-    if ("item" in body) return unwrapItem(body, id);
+    if ("item" in body) return unwrapItem(body, id, void 0, entity);
     if (Array.isArray(body.items)) {
       const first = body.items[0];
       if (first === null || first === void 0) {
-        throw new NotFoundError(`The record with ID ${id} was not found`, { httpStatus: 200, resourceIds: [id] });
+        throw new NotFoundError(`The record with ID ${id} was not found`, { httpStatus: 200, resourceIds: [id], details: { idRefs: [{ entity, id }] } });
       }
       return first;
     }
@@ -17867,7 +17947,7 @@ var BaseResource = class {
     if (!isRecord2(res)) {
       throw new AutotaskError(
         `Expected the deleted attachment model for ID ${numeric}; got a different shape`,
-        { code: "INVALID_RESPONSE", category: "server", resourceIds: [numeric] }
+        { code: "INVALID_RESPONSE", category: "server", resourceIds: [numeric], details: { idRefs: [{ entity: this.entityName, id: numeric }] } }
       );
     }
     return res;
@@ -18144,7 +18224,7 @@ var BaseResource = class {
       current = parentId === void 0 ? await this.getGlobal(id, true) : this.config.attachmentGet ? await this.getScopedModel(parentId, id, true) : await this.getScopedRaw(parentId, id, true);
     } catch (err) {
       if (err instanceof NotFoundError) {
-        const updateReason = _optionalChain([EMPTY_REASON_STAMPS, 'access', _169 => _169[this.config.key], 'optionalAccess', _170 => _170.update]);
+        const updateReason = _optionalChain([EMPTY_REASON_STAMPS, 'access', _174 => _174[this.config.key], 'optionalAccess', _175 => _175.update]);
         checks.push({
           name: "current-record-exists",
           ok: false,
@@ -18258,9 +18338,9 @@ var BaseResource = class {
     const resource = RESOURCE_KEY_BY_PATH[entityPath];
     const res = await this.cachedGet(`${entityPath}/${numeric}`, `${this.config.key}.fetchRecord`, fresh, resource);
     if (this.config.attachmentGet) {
-      return this.unwrapModelLike(res, numeric);
+      return this.unwrapModelLike(res, numeric, entityNameFromPath(entityPath));
     }
-    return unwrapItem(res, numeric, `${this.config.key}.fetchRecord`);
+    return unwrapItem(res, numeric, `${this.config.key}.fetchRecord`, entityNameFromPath(entityPath));
   }
   /**
    * `getContext` part fetch: a single-record read that degrades to `null`
@@ -18302,12 +18382,12 @@ var BaseResource = class {
         return null;
       }
     }
-    const epoch = _optionalChain([cache, 'optionalAccess', _171 => _171.epoch]);
+    const epoch = _optionalChain([cache, 'optionalAccess', _176 => _176.epoch]);
     try {
       return await this.fetchRecordRaw(entityPath, referenceId);
     } catch (err) {
       if (err instanceof NotFoundError) {
-        _optionalChain([cache, 'optionalAccess', _172 => _172.set, 'call', _173 => _173(absentKey, CONTEXT_ABSENT_MARKER, RESOURCE_KEY_BY_PATH[entityPath], epoch)]);
+        _optionalChain([cache, 'optionalAccess', _177 => _177.set, 'call', _178 => _178(absentKey, CONTEXT_ABSENT_MARKER, RESOURCE_KEY_BY_PATH[entityPath], epoch)]);
         return null;
       }
       throw err;
@@ -18367,6 +18447,7 @@ var BaseResource = class {
         {
           code: "RESOLUTION_AMBIGUOUS",
           resourceIds: ids,
+          details: { idRefs: ids.map((cid) => ({ entity: this.entityName, id: cid })) },
           // issue #59 PR-B: the miss-channel pointer (the generic floor names
           // the resource's own search op — reachable only where searchFields
           // is non-empty, so the named op always exists here).
@@ -18423,7 +18504,7 @@ var BaseResource = class {
   missDetail(operator, fields) {
     const key = this.config.key;
     const probe = fields.map((field) => ({ field, op: operator, value: "" }));
-    const blind = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _174 => _174[key], 'optionalAccess', _175 => _175.query]), probe);
+    const blind = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _179 => _179[key], 'optionalAccess', _180 => _180.query]), probe);
     const next = [];
     if (blind !== void 0) {
       next.push(`This surface is blind to records the API user does not own, so a miss is not proof of absence: ${blind.authority} returns the record when the id is known.`);
@@ -18503,7 +18584,7 @@ var BaseResource = class {
       const ids = matches.map((m) => m.id).filter((id) => typeof id === "number");
       throw new ResolutionError(
         `findBy${field}: "${value}" is ambiguous on ${this.config.key} (matched ${matches.length} records)`,
-        { code: "RESOLUTION_AMBIGUOUS", resourceIds: ids }
+        { code: "RESOLUTION_AMBIGUOUS", resourceIds: ids, details: { idRefs: ids.map((cid) => ({ entity: this.entityName, id: cid })) } }
       );
     }
     return matches[0];
@@ -18696,4 +18777,6 @@ var BaseResource = class {
 
 
 
-exports.AUTH_HEADERS = AUTH_HEADERS; exports.buildAuthHeaders = buildAuthHeaders; exports.withAuthHeaders = withAuthHeaders; exports.NoopLogger = NoopLogger; exports.REDACTED = REDACTED; exports.CREDENTIAL_HEADER_NAMES = CREDENTIAL_HEADER_NAMES; exports.isCredentialHeaderName = isCredentialHeaderName; exports.redactRecord = redactRecord; exports.SECRET_RESPONSE_FIELDS = SECRET_RESPONSE_FIELDS; exports.PERSONAL_RESPONSE_FIELDS = PERSONAL_RESPONSE_FIELDS; exports.CONFIDENTIAL_RESPONSE_FIELDS = CONFIDENTIAL_RESPONSE_FIELDS; exports.isRedactedFieldName = isRedactedFieldName; exports.redactResponseBody = redactResponseBody; exports.AutotaskError = AutotaskError; exports.AutotaskConfigError = AutotaskConfigError; exports.AutotaskNetworkError = AutotaskNetworkError; exports.AutotaskTimeoutError = AutotaskTimeoutError; exports.AutotaskAbortError = AutotaskAbortError; exports.ResponseRejectedError = ResponseRejectedError; exports.BadRequestError = BadRequestError; exports.UnauthorizedError = UnauthorizedError; exports.ForbiddenError = ForbiddenError; exports.NotFoundError = NotFoundError; exports.ConflictError = ConflictError; exports.UnprocessableEntityError = UnprocessableEntityError; exports.RateLimitError = RateLimitError; exports.ServerError = ServerError; exports.UnexpectedContentTypeError = UnexpectedContentTypeError; exports.EmptyResponseError = EmptyResponseError; exports.CircuitBreakerError = CircuitBreakerError; exports.HostPolicyDeniedError = HostPolicyDeniedError; exports.ResolutionError = ResolutionError; exports.PaginationLimitError = PaginationLimitError; exports.QueryTooLongError = QueryTooLongError; exports.parseVendorErrors = parseVendorErrors; exports.isDeterministicVendor500 = isDeterministicVendor500; exports.formatVendorDetail = formatVendorDetail; exports.CREDENTIAL_SHAPE_POINTER = CREDENTIAL_SHAPE_POINTER; exports.mergeDetails = mergeDetails; exports.errorFromStatus = errorFromStatus; exports.StaleObjectError = StaleObjectError; exports.ConfirmationRequiredError = ConfirmationRequiredError; exports.DeleteBoundaryError = DeleteBoundaryError; exports.MarkerUnsafeIdError = MarkerUnsafeIdError; exports.RecoveryTruncatedError = RecoveryTruncatedError; exports.isAutotaskError = isAutotaskError; exports.hasSurroundingQuotes = hasSurroundingQuotes; exports.credentialShapeProblem = credentialShapeProblem; exports.CREDENTIAL_ENV_LOAD_ACTION = CREDENTIAL_ENV_LOAD_ACTION; exports.MIN_PREFIX_SUMMARY_LENGTH = MIN_PREFIX_SUMMARY_LENGTH; exports.credentialValueSummary = credentialValueSummary; exports.FIELD_CACHE_KINDS = FIELD_CACHE_KINDS; exports.DEFAULT_CIRCUIT_BREAKER_WINDOW_MS = DEFAULT_CIRCUIT_BREAKER_WINDOW_MS; exports.DEFAULT_CIRCUIT_BREAKER_FAILURE_THRESHOLD = DEFAULT_CIRCUIT_BREAKER_FAILURE_THRESHOLD; exports.DEFAULT_CIRCUIT_BREAKER_OPEN_TIMEOUT_MS = DEFAULT_CIRCUIT_BREAKER_OPEN_TIMEOUT_MS; exports.DEFAULT_CIRCUIT_BREAKER_SUCCESSES_TO_CLOSE = DEFAULT_CIRCUIT_BREAKER_SUCCESSES_TO_CLOSE; exports.DEFAULT_CIRCUIT_BREAKER_MAX_ENTRIES = DEFAULT_CIRCUIT_BREAKER_MAX_ENTRIES; exports.InMemoryCircuitBreakerStore = InMemoryCircuitBreakerStore; exports.defaultCircuitBreakerStore = defaultCircuitBreakerStore; exports.resetDefaultCircuitBreakerStore = resetDefaultCircuitBreakerStore; exports.buildBreakerKey = buildBreakerKey; exports.isBreakerFailure = isBreakerFailure; exports.DEFAULT_COOLDOWN_MAX_MS = DEFAULT_COOLDOWN_MAX_MS; exports.DEFAULT_COOLDOWN_DEFAULT_MS = DEFAULT_COOLDOWN_DEFAULT_MS; exports.DEFAULT_COOLDOWN_MAX_ENTRIES = DEFAULT_COOLDOWN_MAX_ENTRIES; exports.InMemoryCooldownStore = InMemoryCooldownStore; exports.defaultCooldownStore = defaultCooldownStore; exports.resetDefaultCooldownStore = resetDefaultCooldownStore; exports.buildTenantKey = buildTenantKey; exports.cooldownDurationMs = cooldownDurationMs; exports.ZONE_CATALOG = ZONE_CATALOG; exports.ZONES = ZONES; exports.DEFAULT_ZONE = DEFAULT_ZONE; exports.AGENT_PROFILE = AGENT_PROFILE; exports.DEFAULT_PAGE_SIZE = DEFAULT_PAGE_SIZE; exports.MAX_PAGE_SIZE = MAX_PAGE_SIZE; exports.DEFAULT_TIMEOUT_MS = DEFAULT_TIMEOUT_MS; exports.DEFAULT_MAX_RETRIES = DEFAULT_MAX_RETRIES; exports.DEFAULT_MAX_CONCURRENT = DEFAULT_MAX_CONCURRENT; exports.DEFAULT_MAX_RESPONSE_BYTES = DEFAULT_MAX_RESPONSE_BYTES; exports.DEFAULT_MAX_SCAN_RECORDS = DEFAULT_MAX_SCAN_RECORDS; exports.DEFAULT_MAX_SCAN_PAGES = DEFAULT_MAX_SCAN_PAGES; exports.DEFAULT_READ_CACHE_TTL_MS = DEFAULT_READ_CACHE_TTL_MS; exports.DEFAULT_FIELD_CACHE_TTL_MS = DEFAULT_FIELD_CACHE_TTL_MS; exports.DEFAULT_RESOURCE_NAME_CACHE_TTL_MS = DEFAULT_RESOURCE_NAME_CACHE_TTL_MS; exports.zoneUrl = zoneUrl; exports.resolveBaseUrl = resolveBaseUrl; exports.resolveCredentials = resolveCredentials; exports.resolveConfig = resolveConfig; exports.isRecord = isRecord2; exports.assertRecord = assertRecord; exports.deepMergeParams = deepMergeParams; exports.isIdentifierCandidate = isIdentifierCandidate; exports.parseIdentifier = parseIdentifier; exports.flattenUdfs = flattenUdfs; exports.newCorrelationId = newCorrelationId; exports.redactAuditBody = redactAuditBody; exports.camelKey = camelKey; exports.FILTER_OPERATORS = FILTER_OPERATORS; exports.GROUPING_OPERATORS = GROUPING_OPERATORS; exports.MAX_OR_CONDITIONS = MAX_OR_CONDITIONS; exports.MAX_UDF_PER_QUERY = MAX_UDF_PER_QUERY; exports.MAX_QUERY_LENGTH = MAX_QUERY_LENGTH; exports.MAX_GET_LENGTH = MAX_GET_LENGTH; exports.MAX_FIELD_LENGTH = MAX_FIELD_LENGTH; exports.isFilterOperator = isFilterOperator; exports.serializeFilter = serializeFilter; exports.validateFilter = validateFilter; exports.buildFilter = buildFilter; exports.normalizedConditions = normalizedConditions; exports.RELATIONSHIP_ZONE = RELATIONSHIP_ZONE; exports.RELATIONSHIP_MAP = RELATIONSHIP_MAP; exports.BLIND_SURFACE_STAMPS = BLIND_SURFACE_STAMPS; exports.DELETE_BOUNDARY_NOTES = DELETE_BOUNDARY_NOTES; exports.MARKER_FIELDS = MARKER_FIELDS; exports.EMPTY_REASON_STAMPS = EMPTY_REASON_STAMPS; exports.BLIND_SURFACE_INVENTORY = BLIND_SURFACE_INVENTORY; exports.REACHABILITY_PROBE_DEFAULTS = REACHABILITY_PROBE_DEFAULTS; exports.CREATE_GUIDANCE = CREATE_GUIDANCE; exports.UNTRUSTED_FIELDS_BY_RESOURCE = UNTRUSTED_FIELDS_BY_RESOURCE; exports.IDEMPOTENT_METHODS = IDEMPOTENT_METHODS; exports.buildUrl = buildUrl; exports.cursorToPath = cursorToPath; exports.buildQueryRequest = buildQueryRequest; exports.runWithSignal = runWithSignal; exports.HttpClient = HttpClient; exports.unwrapItems = unwrapItems; exports.unwrapItem = unwrapItem; exports.unwrapQueryCount = unwrapQueryCount; exports.unwrapOperation = unwrapOperation; exports.passthrough = passthrough; exports.MAX_PAGES = MAX_PAGES; exports.clampPageSize = clampPageSize; exports.totalPagesFor = totalPagesFor; exports.paginate = paginate; exports.paginateItems = paginateItems; exports.collectAll = collectAll; exports.toArray = toArray; exports.FIELD_PRESETS = FIELD_PRESETS; exports.FIELD_PRESET_NAMES = FIELD_PRESET_NAMES; exports.resolveFieldsPreset = resolveFieldsPreset; exports.BOUNDED_QUERY_MAX_LIMIT = BOUNDED_QUERY_MAX_LIMIT; exports.truncateNoteChars = truncateNoteChars; exports.buildDryRunResult = buildDryRunResult; exports.mergePartialBody = mergePartialBody; exports.blindStampFor = blindStampFor; exports.decodeFileData = decodeFileData; exports.BaseResource = BaseResource; exports.EXPAND_RESOURCE_NAMES_MAX_IDS = EXPAND_RESOURCE_NAMES_MAX_IDS; exports.expandResourceNames = expandResourceNames; exports.WORKFLOW_RESOURCES = WORKFLOW_RESOURCES; exports.MAX_FIELD_CATALOG_WIRE = MAX_FIELD_CATALOG_WIRE; exports.FIELD_CATALOG_HONESTY_NOTE = FIELD_CATALOG_HONESTY_NOTE; exports.fieldCatalog = fieldCatalog; exports.PICKLIST_VALUE_NOT_SERVED_NOTE = PICKLIST_VALUE_NOT_SERVED_NOTE; exports.TICKET_LABEL_FIELDS = TICKET_LABEL_FIELDS; exports.createNamePlan = createNamePlan; exports.addNameSibling = addNameSibling; exports.addLabelSibling = addLabelSibling; exports.resolveCompositeNames = resolveCompositeNames; exports.MODEL_FIELD_SETS = MODEL_FIELD_SETS; exports.MODEL_DATE_FIELDS = MODEL_DATE_FIELDS; exports.FETCH_MANY_MAX_ITEMS = FETCH_MANY_MAX_ITEMS; exports.validateFetchManyItems = validateFetchManyItems; exports.fetchMany = fetchMany; exports.FETCH_BY_IDS_MAX_ITEMS = FETCH_BY_IDS_MAX_ITEMS; exports.FETCH_BY_IDS_CHUNK_SIZE = FETCH_BY_IDS_CHUNK_SIZE; exports.fetchByIds = fetchByIds;
+
+
+exports.AUTH_HEADERS = AUTH_HEADERS; exports.buildAuthHeaders = buildAuthHeaders; exports.withAuthHeaders = withAuthHeaders; exports.NoopLogger = NoopLogger; exports.REDACTED = REDACTED; exports.CREDENTIAL_HEADER_NAMES = CREDENTIAL_HEADER_NAMES; exports.isCredentialHeaderName = isCredentialHeaderName; exports.redactRecord = redactRecord; exports.SECRET_RESPONSE_FIELDS = SECRET_RESPONSE_FIELDS; exports.PERSONAL_RESPONSE_FIELDS = PERSONAL_RESPONSE_FIELDS; exports.CONFIDENTIAL_RESPONSE_FIELDS = CONFIDENTIAL_RESPONSE_FIELDS; exports.isRedactedFieldName = isRedactedFieldName; exports.redactResponseBody = redactResponseBody; exports.AutotaskError = AutotaskError; exports.AutotaskConfigError = AutotaskConfigError; exports.AutotaskNetworkError = AutotaskNetworkError; exports.AutotaskTimeoutError = AutotaskTimeoutError; exports.AutotaskAbortError = AutotaskAbortError; exports.ResponseRejectedError = ResponseRejectedError; exports.BadRequestError = BadRequestError; exports.UnauthorizedError = UnauthorizedError; exports.ForbiddenError = ForbiddenError; exports.NotFoundError = NotFoundError; exports.ConflictError = ConflictError; exports.UnprocessableEntityError = UnprocessableEntityError; exports.RateLimitError = RateLimitError; exports.ServerError = ServerError; exports.UnexpectedContentTypeError = UnexpectedContentTypeError; exports.EmptyResponseError = EmptyResponseError; exports.CircuitBreakerError = CircuitBreakerError; exports.HostPolicyDeniedError = HostPolicyDeniedError; exports.ResolutionError = ResolutionError; exports.PaginationLimitError = PaginationLimitError; exports.QueryTooLongError = QueryTooLongError; exports.parseVendorErrors = parseVendorErrors; exports.isDeterministicVendor500 = isDeterministicVendor500; exports.formatVendorDetail = formatVendorDetail; exports.CREDENTIAL_SHAPE_POINTER = CREDENTIAL_SHAPE_POINTER; exports.mergeDetails = mergeDetails; exports.errorFromStatus = errorFromStatus; exports.StaleObjectError = StaleObjectError; exports.ConfirmationRequiredError = ConfirmationRequiredError; exports.DeleteBoundaryError = DeleteBoundaryError; exports.MarkerUnsafeIdError = MarkerUnsafeIdError; exports.RecoveryTruncatedError = RecoveryTruncatedError; exports.isAutotaskError = isAutotaskError; exports.hasSurroundingQuotes = hasSurroundingQuotes; exports.credentialShapeProblem = credentialShapeProblem; exports.CREDENTIAL_ENV_LOAD_ACTION = CREDENTIAL_ENV_LOAD_ACTION; exports.MIN_PREFIX_SUMMARY_LENGTH = MIN_PREFIX_SUMMARY_LENGTH; exports.credentialValueSummary = credentialValueSummary; exports.FIELD_CACHE_KINDS = FIELD_CACHE_KINDS; exports.DEFAULT_CIRCUIT_BREAKER_WINDOW_MS = DEFAULT_CIRCUIT_BREAKER_WINDOW_MS; exports.DEFAULT_CIRCUIT_BREAKER_FAILURE_THRESHOLD = DEFAULT_CIRCUIT_BREAKER_FAILURE_THRESHOLD; exports.DEFAULT_CIRCUIT_BREAKER_OPEN_TIMEOUT_MS = DEFAULT_CIRCUIT_BREAKER_OPEN_TIMEOUT_MS; exports.DEFAULT_CIRCUIT_BREAKER_SUCCESSES_TO_CLOSE = DEFAULT_CIRCUIT_BREAKER_SUCCESSES_TO_CLOSE; exports.DEFAULT_CIRCUIT_BREAKER_MAX_ENTRIES = DEFAULT_CIRCUIT_BREAKER_MAX_ENTRIES; exports.InMemoryCircuitBreakerStore = InMemoryCircuitBreakerStore; exports.defaultCircuitBreakerStore = defaultCircuitBreakerStore; exports.resetDefaultCircuitBreakerStore = resetDefaultCircuitBreakerStore; exports.buildBreakerKey = buildBreakerKey; exports.isBreakerFailure = isBreakerFailure; exports.DEFAULT_COOLDOWN_MAX_MS = DEFAULT_COOLDOWN_MAX_MS; exports.DEFAULT_COOLDOWN_DEFAULT_MS = DEFAULT_COOLDOWN_DEFAULT_MS; exports.DEFAULT_COOLDOWN_MAX_ENTRIES = DEFAULT_COOLDOWN_MAX_ENTRIES; exports.InMemoryCooldownStore = InMemoryCooldownStore; exports.defaultCooldownStore = defaultCooldownStore; exports.resetDefaultCooldownStore = resetDefaultCooldownStore; exports.buildTenantKey = buildTenantKey; exports.cooldownDurationMs = cooldownDurationMs; exports.ZONE_CATALOG = ZONE_CATALOG; exports.ZONES = ZONES; exports.DEFAULT_ZONE = DEFAULT_ZONE; exports.AGENT_PROFILE = AGENT_PROFILE; exports.DEFAULT_PAGE_SIZE = DEFAULT_PAGE_SIZE; exports.MAX_PAGE_SIZE = MAX_PAGE_SIZE; exports.DEFAULT_TIMEOUT_MS = DEFAULT_TIMEOUT_MS; exports.DEFAULT_MAX_RETRIES = DEFAULT_MAX_RETRIES; exports.DEFAULT_MAINTENANCE_MAX_WAIT_MS = DEFAULT_MAINTENANCE_MAX_WAIT_MS; exports.DEFAULT_MAINTENANCE_POLL_MS = DEFAULT_MAINTENANCE_POLL_MS; exports.DEFAULT_MAX_CONCURRENT = DEFAULT_MAX_CONCURRENT; exports.DEFAULT_MAX_RESPONSE_BYTES = DEFAULT_MAX_RESPONSE_BYTES; exports.DEFAULT_MAX_SCAN_RECORDS = DEFAULT_MAX_SCAN_RECORDS; exports.DEFAULT_MAX_SCAN_PAGES = DEFAULT_MAX_SCAN_PAGES; exports.DEFAULT_READ_CACHE_TTL_MS = DEFAULT_READ_CACHE_TTL_MS; exports.DEFAULT_FIELD_CACHE_TTL_MS = DEFAULT_FIELD_CACHE_TTL_MS; exports.DEFAULT_RESOURCE_NAME_CACHE_TTL_MS = DEFAULT_RESOURCE_NAME_CACHE_TTL_MS; exports.zoneUrl = zoneUrl; exports.resolveBaseUrl = resolveBaseUrl; exports.resolveCredentials = resolveCredentials; exports.resolveConfig = resolveConfig; exports.isRecord = isRecord2; exports.assertRecord = assertRecord; exports.deepMergeParams = deepMergeParams; exports.isIdentifierCandidate = isIdentifierCandidate; exports.parseIdentifier = parseIdentifier; exports.flattenUdfs = flattenUdfs; exports.newCorrelationId = newCorrelationId; exports.redactAuditBody = redactAuditBody; exports.camelKey = camelKey; exports.FILTER_OPERATORS = FILTER_OPERATORS; exports.GROUPING_OPERATORS = GROUPING_OPERATORS; exports.MAX_OR_CONDITIONS = MAX_OR_CONDITIONS; exports.MAX_UDF_PER_QUERY = MAX_UDF_PER_QUERY; exports.MAX_QUERY_LENGTH = MAX_QUERY_LENGTH; exports.MAX_GET_LENGTH = MAX_GET_LENGTH; exports.MAX_FIELD_LENGTH = MAX_FIELD_LENGTH; exports.isFilterOperator = isFilterOperator; exports.serializeFilter = serializeFilter; exports.validateFilter = validateFilter; exports.buildFilter = buildFilter; exports.normalizedConditions = normalizedConditions; exports.RELATIONSHIP_ZONE = RELATIONSHIP_ZONE; exports.RELATIONSHIP_MAP = RELATIONSHIP_MAP; exports.BLIND_SURFACE_STAMPS = BLIND_SURFACE_STAMPS; exports.DELETE_BOUNDARY_NOTES = DELETE_BOUNDARY_NOTES; exports.MARKER_FIELDS = MARKER_FIELDS; exports.EMPTY_REASON_STAMPS = EMPTY_REASON_STAMPS; exports.BLIND_SURFACE_INVENTORY = BLIND_SURFACE_INVENTORY; exports.REACHABILITY_PROBE_DEFAULTS = REACHABILITY_PROBE_DEFAULTS; exports.CREATE_GUIDANCE = CREATE_GUIDANCE; exports.UNTRUSTED_FIELDS_BY_RESOURCE = UNTRUSTED_FIELDS_BY_RESOURCE; exports.IDEMPOTENT_METHODS = IDEMPOTENT_METHODS; exports.buildUrl = buildUrl; exports.cursorToPath = cursorToPath; exports.buildQueryRequest = buildQueryRequest; exports.runWithSignal = runWithSignal; exports.HttpClient = HttpClient; exports.unwrapItems = unwrapItems; exports.unwrapItem = unwrapItem; exports.unwrapQueryCount = unwrapQueryCount; exports.unwrapOperation = unwrapOperation; exports.passthrough = passthrough; exports.MAX_PAGES = MAX_PAGES; exports.clampPageSize = clampPageSize; exports.totalPagesFor = totalPagesFor; exports.paginate = paginate; exports.paginateItems = paginateItems; exports.collectAll = collectAll; exports.toArray = toArray; exports.FIELD_PRESETS = FIELD_PRESETS; exports.FIELD_PRESET_NAMES = FIELD_PRESET_NAMES; exports.resolveFieldsPreset = resolveFieldsPreset; exports.BOUNDED_QUERY_MAX_LIMIT = BOUNDED_QUERY_MAX_LIMIT; exports.truncateNoteChars = truncateNoteChars; exports.buildDryRunResult = buildDryRunResult; exports.mergePartialBody = mergePartialBody; exports.blindStampFor = blindStampFor; exports.decodeFileData = decodeFileData; exports.BaseResource = BaseResource; exports.EXPAND_RESOURCE_NAMES_MAX_IDS = EXPAND_RESOURCE_NAMES_MAX_IDS; exports.expandResourceNames = expandResourceNames; exports.WORKFLOW_RESOURCES = WORKFLOW_RESOURCES; exports.MAX_FIELD_CATALOG_WIRE = MAX_FIELD_CATALOG_WIRE; exports.FIELD_CATALOG_HONESTY_NOTE = FIELD_CATALOG_HONESTY_NOTE; exports.fieldCatalog = fieldCatalog; exports.PICKLIST_VALUE_NOT_SERVED_NOTE = PICKLIST_VALUE_NOT_SERVED_NOTE; exports.TICKET_LABEL_FIELDS = TICKET_LABEL_FIELDS; exports.createNamePlan = createNamePlan; exports.addNameSibling = addNameSibling; exports.addLabelSibling = addLabelSibling; exports.resolveCompositeNames = resolveCompositeNames; exports.MODEL_FIELD_SETS = MODEL_FIELD_SETS; exports.MODEL_DATE_FIELDS = MODEL_DATE_FIELDS; exports.FETCH_MANY_MAX_ITEMS = FETCH_MANY_MAX_ITEMS; exports.validateFetchManyItems = validateFetchManyItems; exports.fetchMany = fetchMany; exports.FETCH_BY_IDS_MAX_ITEMS = FETCH_BY_IDS_MAX_ITEMS; exports.FETCH_BY_IDS_CHUNK_SIZE = FETCH_BY_IDS_CHUNK_SIZE; exports.fetchByIds = fetchByIds;