node-autotask 0.39.4 → 0.40.0

package/dist/{chunk-SGKGNJEI.cjs → chunk-FEYVLIHD.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(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await 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; } async function _asyncOptionalChain(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 = await fn(value); } else if (op === 'call' || op === 'optionalCall') { value = await fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6; var _class7; var _class8;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await 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; } async function _asyncOptionalChain(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 = await fn(value); } else if (op === 'call' || op === 'optionalCall') { value = await fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3;
 
-var _chunkVR6RYXTDcjs = require('./chunk-VR6RYXTD.cjs');
+var _chunkEVDVESQMcjs = require('./chunk-EVDVESQM.cjs');
 
 
 var _chunkMJTKK3QGcjs = require('./chunk-MJTKK3QG.cjs');
@@ -181,14 +181,14 @@ var EmptyResponseError = class extends AutotaskError {
     this.name = "EmptyResponseError";
   }
 };
-var CircuitBreakerError = class extends AutotaskError {
-  /** Seconds remaining in the open period (absent when the half-open probe budget is in flight). */
+var MaintenanceError = class extends AutotaskError {
+  /** Seconds until the next probe slot. */
   
-  /** True when the call was refused locally (the circuit is open) and never sent. */
+  /** True on a local refusal (the call was never sent); undefined when the call received the page. */
   
   constructor(message, options = {}) {
-    super(message, { code: "CIRCUIT_BREAKER_OPEN", category: "policy", retryable: true, ...options });
-    this.name = "CircuitBreakerError";
+    super(message, { code: "MAINTENANCE", category: "server", retryable: true, ...options });
+    this.name = "MaintenanceError";
   }
 };
 var HostPolicyDeniedError = class extends AutotaskError {
@@ -588,53 +588,36 @@ var MoveRefusedError = class extends AutotaskError {
 
 // src/cache.ts
 var READ_CACHE_MAX_ENTRIES = 4096;
-var ReadCache = (_class = class {
-  /** The configured TTL in ms (the fallback for resources without an override). */
+var REFERENCE_TTL_MS = 36e5;
+var REFERENCE_ENTITIES = ["BillingCodes", "Countries", "Departments", "Phases", "Roles", "Services"];
+var FIELD_CACHE_KINDS = ["info", "fields", "udf"];
+function fieldKey(resourceKey, kind) {
+  return `${resourceKey}:${kind}`;
+}
+function readTtlFor(key, ttlMs) {
+  const entity = key.split("\0")[0].split("/").at(-2);
+  return entity !== void 0 && REFERENCE_ENTITIES.includes(entity) ? Math.max(ttlMs, REFERENCE_TTL_MS) : ttlMs;
+}
+var TtlCache = (_class = class {
+  
   
-  /** The per-resource TTL overrides (issue #32; absent = every resource uses `ttlMs`). */
   
   __init() {this.store = /* @__PURE__ */ new Map()}
-  __init2() {this.epochCounter = 0}
-  constructor(ttlMs, perResourceTtlMs) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);
+  __init2() {this.inflightMap = /* @__PURE__ */ new Map()}
+  __init3() {this.epochCounter = 0}
+  constructor(ttlMs, options = {}) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);_class.prototype.__init3.call(this);
     if (!Number.isInteger(ttlMs) || ttlMs <= 0) {
-      throw new AutotaskConfigError(`cache.ttlMs must be a positive integer (got ${ttlMs})`);
+      throw new AutotaskConfigError(`cache ttlMs must be a positive integer (got ${String(ttlMs)})`);
     }
-    if (perResourceTtlMs !== void 0) {
-      if (perResourceTtlMs === null || typeof perResourceTtlMs !== "object" || Array.isArray(perResourceTtlMs)) {
-        throw new AutotaskConfigError(
-          `cache.perResourceTtlMs must be an object of resource key -> ms (got ${String(perResourceTtlMs)})`
-        );
-      }
-      for (const [key, value] of Object.entries(perResourceTtlMs)) {
-        if (key === "") {
-          throw new AutotaskConfigError("cache.perResourceTtlMs keys must be non-empty resource keys");
-        }
-        if (!Number.isInteger(value) || value <= 0) {
-          throw new AutotaskConfigError(
-            `cache.perResourceTtlMs.${key} must be a positive integer (got ${String(value)})`
-          );
-        }
-      }
+    const maxEntries = _nullishCoalesce(options.maxEntries, () => ( READ_CACHE_MAX_ENTRIES));
+    if (!Number.isInteger(maxEntries) || maxEntries <= 0) {
+      throw new AutotaskConfigError(`cache maxEntries must be a positive integer (got ${String(maxEntries)})`);
     }
     this.ttlMs = ttlMs;
-    this.perResourceTtlMs = perResourceTtlMs;
-  }
-  /**
-   * The TTL (ms) for a resource plan key: the `perResourceTtlMs` override
-   * when the map is present and names the resource, else the base
-   * `ttlMs` (absent map, absent key, and `undefined` all fall back).
-   */
-  ttlFor(resource) {
-    if (resource !== void 0 && this.perResourceTtlMs !== void 0) {
-      const override = this.perResourceTtlMs[resource];
-      if (override !== void 0) return override;
-    }
-    return this.ttlMs;
+    this.maxEntries = maxEntries;
+    this.ttlFor = _nullishCoalesce(options.ttlFor, () => ( (() => ttlMs)));
   }
-  /**
-   * Read-through lookup: the live entry's value, or `undefined` (absent OR
-   * expired — an expired entry is purged lazily on this read).
-   */
+  /** The live value (a copy), or `undefined` when absent or expired. */
   get(key) {
     const entry = this.store.get(key);
     if (entry === void 0) return void 0;
@@ -644,19 +627,46 @@ var ReadCache = (_class = class {
     }
     return structuredClone(entry.value);
   }
-  /** Store a successful read payload under `key`, live for `ttlFor(resource)`:
-   * the per-resource override (issue #32) when named, else `ttlMs`.
-   * `epoch` is the invalidation epoch the caller captured BEFORE its wire
-   * read: a read that straddled a `clear()` (a write) is dropped, never
-   * re-stored with its pre-write body. */
-  set(key, value, resource, epoch = this.epochCounter) {
+  /** Store `value` under `key`. `epoch` is the value the caller read BEFORE its
+   * wire request: a read that straddled a `clear()` (a write) is dropped. */
+  set(key, value, epoch = this.epochCounter) {
     if (epoch !== this.epochCounter) return;
-    if (this.store.size >= READ_CACHE_MAX_ENTRIES && this.purgeExpired() === 0) {
+    if (!this.store.has(key) && this.store.size >= this.maxEntries && this.purgeExpired() === 0) {
       const oldest = this.store.keys().next();
       if (!oldest.done) this.store.delete(oldest.value);
     }
+    const now = Date.now();
     this.store.delete(key);
-    this.store.set(key, { value: structuredClone(value), expiresAt: Date.now() + this.ttlFor(resource) });
+    this.store.set(key, { value: structuredClone(value), storedAt: now, expiresAt: now + this.ttlFor(key) });
+  }
+  /** `{ hit, age }` without consuming or cloning the entry (age in ms since stored). */
+  peek(key) {
+    const entry = this.store.get(key);
+    if (entry === void 0 || entry.expiresAt <= Date.now()) return { hit: false, age: null };
+    return { hit: true, age: Date.now() - entry.storedAt };
+  }
+  /** The shared in-flight read for `key`, if any. */
+  inflight(key) {
+    return this.inflightMap.get(key);
+  }
+  /** Register an in-flight read so concurrent callers share it; dropped on settle. */
+  track(key, promise) {
+    this.inflightMap.set(key, promise);
+    const drop = () => {
+      if (this.inflightMap.get(key) === promise) this.inflightMap.delete(key);
+    };
+    promise.then(drop, drop);
+    return promise;
+  }
+  /** Drop one key. */
+  delete(key) {
+    this.inflightMap.delete(key);
+    return this.store.delete(key);
+  }
+  /** Drop every stored and in-flight key that starts with `prefix`. */
+  invalidate(prefix) {
+    for (const key of [...this.store.keys()]) if (key.startsWith(prefix)) this.store.delete(key);
+    for (const key of [...this.inflightMap.keys()]) if (key.startsWith(prefix)) this.inflightMap.delete(key);
   }
   /** Drop every expired entry (returns the number removed). */
   purgeExpired() {
@@ -670,24 +680,19 @@ var ReadCache = (_class = class {
     }
     return removed;
   }
-  /** Current entry count (live + not-yet-purged expired). */
+  /** Stored entry count (live + not-yet-purged expired). */
   get size() {
     return this.store.size;
   }
-  /** Drop one key (issue #36: a later positive outcome clears a stale 'absent' marker). */
-  delete(key) {
-    return this.store.delete(key);
-  }
-  /** The invalidation epoch: bumped by `clear()`; capture it before a wire
-   * read and pass it to `set` so a read in flight across a write cannot
-   * re-store its stale answer. */
+  /** Bumped by `clear()`; capture it before a wire read and pass it to `set`. */
   get epoch() {
     return this.epochCounter;
   }
-  /** Drop everything (e.g. a caller that knows the tenant was reset). */
+  /** Drop everything and bump the epoch. */
   clear() {
     this.epochCounter += 1;
     this.store.clear();
+    this.inflightMap.clear();
   }
 }, _class);
 
@@ -790,279 +795,6 @@ var AGENT_PROFILE = {
   resolution: { maxScanRecords: 200, maxScanPages: 2 }
 };
 
-// src/cache-ttl-tables.ts
-var CACHE_TTL_REFERENCE_MS = 36e5;
-var CACHE_TTL_DEFAULT_MS = 3e5;
-var DEFAULT_PER_RESOURCE_TTL_MS = {
-  "appointments": 3e5,
-  "authenticate": 3e5,
-  "billing_codes": 36e5,
-  "billing_item_approval_levels": 3e5,
-  "billing_items": 3e5,
-  "change_request_links": 3e5,
-  "checklist_libraries": 3e5,
-  "checklist_library_checklist_items": 3e5,
-  "classification_icons": 3e5,
-  "companies": 3e5,
-  "company_alerts": 3e5,
-  "company_locations": 3e5,
-  "company_notes": 3e5,
-  "company_site_configurations": 3e5,
-  "company_webhooks": 3e5,
-  "configuration_item_billing_product_associations": 3e5,
-  "configuration_item_categories": 3e5,
-  "configuration_item_category_udf_associations": 3e5,
-  "configuration_item_dns_records": 3e5,
-  "configuration_item_notes": 3e5,
-  "configuration_item_related_items": 3e5,
-  "configuration_item_ssl_subject_alternative_names": 3e5,
-  "configuration_item_types": 3e5,
-  "configuration_item_webhooks": 3e5,
-  "configuration_items": 3e5,
-  "contact_group_contacts": 3e5,
-  "contact_groups": 3e5,
-  "contact_webhooks": 3e5,
-  "contacts": 3e5,
-  "contract_billing_rules": 3e5,
-  "contract_block_hour_factors": 3e5,
-  "contract_blocks": 3e5,
-  "contract_charges": 3e5,
-  "contract_exclusion_billing_codes": 3e5,
-  "contract_exclusion_roles": 3e5,
-  "contract_exclusion_set_excluded_roles": 3e5,
-  "contract_exclusion_set_excluded_work_types": 3e5,
-  "contract_exclusion_sets": 3e5,
-  "contract_milestones": 3e5,
-  "contract_notes": 3e5,
-  "contract_rates": 3e5,
-  "contract_retainers": 3e5,
-  "contract_role_costs": 3e5,
-  "contract_service_adjustments": 3e5,
-  "contract_service_bundle_adjustments": 3e5,
-  "contract_service_bundle_units": 3e5,
-  "contract_service_bundles": 3e5,
-  "contract_service_units": 3e5,
-  "contract_services": 3e5,
-  "contract_ticket_purchases": 3e5,
-  "contracts": 3e5,
-  "countries": 36e5,
-  "currencies": 3e5,
-  "departments": 36e5,
-  "domain_registrars": 3e5,
-  "entity_information": 3e5,
-  "expense_item_attachments": 3e5,
-  "expense_items": 3e5,
-  "expense_reports": 3e5,
-  "holiday_sets": 3e5,
-  "holidays": 3e5,
-  "inventory_products": 3e5,
-  "invoice_templates": 3e5,
-  "invoices": 3e5,
-  "modules": 3e5,
-  "notification_history": 3e5,
-  "opportunities": 3e5,
-  "opportunity_attachments": 3e5,
-  "opportunity_categories": 3e5,
-  "organizational_level1s": 3e5,
-  "organizational_level2s": 3e5,
-  "organizational_level_associations": 3e5,
-  "phases": 36e5,
-  "product_vendors": 3e5,
-  "products": 3e5,
-  "project_charges": 3e5,
-  "project_notes": 3e5,
-  "projects": 3e5,
-  "purchase_approvals": 3e5,
-  "purchase_order_item_receiving": 3e5,
-  "purchase_order_items": 3e5,
-  "purchase_orders": 3e5,
-  "quote_items": 3e5,
-  "quote_locations": 3e5,
-  "quote_templates": 3e5,
-  "quotes": 3e5,
-  "resource_role_queues": 3e5,
-  "resource_roles": 3e5,
-  "resource_skills": 3e5,
-  "resource_time_off_additional": 3e5,
-  "resource_time_off_approvers": 3e5,
-  "resource_time_off_balances": 3e5,
-  "resources": 3e5,
-  "roles": 36e5,
-  "sales_orders": 3e5,
-  "service_call_task_resources": 3e5,
-  "service_call_tasks": 3e5,
-  "service_call_ticket_resources": 3e5,
-  "service_call_tickets": 3e5,
-  "service_calls": 3e5,
-  "service_level_agreement_results": 3e5,
-  "services": 36e5,
-  "skills": 3e5,
-  "subscription_periods": 3e5,
-  "subscriptions": 3e5,
-  "survey_results": 3e5,
-  "surveys": 3e5,
-  "tag_aliases": 3e5,
-  "tag_groups": 3e5,
-  "tags": 3e5,
-  "task_secondary_resources": 3e5,
-  "tasks": 3e5,
-  "tax_regions": 3e5,
-  "threshold_information": 3e5,
-  "ticket_additional_configuration_items": 3e5,
-  "ticket_additional_contacts": 3e5,
-  "ticket_attachments": 3e5,
-  "ticket_categories": 3e5,
-  "ticket_category_field_defaults": 3e5,
-  "ticket_change_request_approvals": 3e5,
-  "ticket_charges": 3e5,
-  "ticket_checklist_items": 3e5,
-  "ticket_checklist_libraries": 3e5,
-  "ticket_history": 3e5,
-  "ticket_note_attachments": 3e5,
-  "ticket_note_webhooks": 3e5,
-  "ticket_notes": 3e5,
-  "ticket_secondary_resources": 3e5,
-  "ticket_webhooks": 3e5,
-  "tickets": 3e5,
-  "time_entries": 3e5,
-  "time_entry_attachments": 3e5,
-  "time_off_requests": 3e5,
-  "version": 3e5,
-  "version_information": 3e5,
-  "zone_information": 3e5
-};
-var RESOURCE_KEY_BY_PATH = {
-  "/V1.0/Appointments": "appointments",
-  "/V1.0/BillingCodes": "billing_codes",
-  "/V1.0/BillingItemApprovalLevels": "billing_item_approval_levels",
-  "/V1.0/BillingItems": "billing_items",
-  "/V1.0/ChangeRequestLinks": "change_request_links",
-  "/V1.0/ChecklistLibraries": "checklist_libraries",
-  "/V1.0/ChecklistLibraryChecklistItems": "checklist_library_checklist_items",
-  "/V1.0/ClassificationIcons": "classification_icons",
-  "/V1.0/Companies": "companies",
-  "/V1.0/CompanyAlerts": "company_alerts",
-  "/V1.0/CompanyLocations": "company_locations",
-  "/V1.0/CompanyNotes": "company_notes",
-  "/V1.0/CompanySiteConfigurations": "company_site_configurations",
-  "/V1.0/CompanyWebhooks": "company_webhooks",
-  "/V1.0/ConfigurationItemBillingProductAssociations": "configuration_item_billing_product_associations",
-  "/V1.0/ConfigurationItemCategories": "configuration_item_categories",
-  "/V1.0/ConfigurationItemCategoryUdfAssociations": "configuration_item_category_udf_associations",
-  "/V1.0/ConfigurationItemDnsRecords": "configuration_item_dns_records",
-  "/V1.0/ConfigurationItemNotes": "configuration_item_notes",
-  "/V1.0/ConfigurationItemRelatedItems": "configuration_item_related_items",
-  "/V1.0/ConfigurationItemSslSubjectAlternativeNames": "configuration_item_ssl_subject_alternative_names",
-  "/V1.0/ConfigurationItemTypes": "configuration_item_types",
-  "/V1.0/ConfigurationItemWebhooks": "configuration_item_webhooks",
-  "/V1.0/ConfigurationItems": "configuration_items",
-  "/V1.0/ContactGroupContacts": "contact_group_contacts",
-  "/V1.0/ContactGroups": "contact_groups",
-  "/V1.0/ContactWebhooks": "contact_webhooks",
-  "/V1.0/Contacts": "contacts",
-  "/V1.0/ContractBillingRules": "contract_billing_rules",
-  "/V1.0/ContractBlockHourFactors": "contract_block_hour_factors",
-  "/V1.0/ContractBlocks": "contract_blocks",
-  "/V1.0/ContractCharges": "contract_charges",
-  "/V1.0/ContractExclusionBillingCodes": "contract_exclusion_billing_codes",
-  "/V1.0/ContractExclusionRoles": "contract_exclusion_roles",
-  "/V1.0/ContractExclusionSetExcludedRoles": "contract_exclusion_set_excluded_roles",
-  "/V1.0/ContractExclusionSetExcludedWorkTypes": "contract_exclusion_set_excluded_work_types",
-  "/V1.0/ContractExclusionSets": "contract_exclusion_sets",
-  "/V1.0/ContractMilestones": "contract_milestones",
-  "/V1.0/ContractNotes": "contract_notes",
-  "/V1.0/ContractRates": "contract_rates",
-  "/V1.0/ContractRetainers": "contract_retainers",
-  "/V1.0/ContractRoleCosts": "contract_role_costs",
-  "/V1.0/ContractServiceAdjustments": "contract_service_adjustments",
-  "/V1.0/ContractServiceBundleAdjustments": "contract_service_bundle_adjustments",
-  "/V1.0/ContractServiceBundleUnits": "contract_service_bundle_units",
-  "/V1.0/ContractServiceBundles": "contract_service_bundles",
-  "/V1.0/ContractServiceUnits": "contract_service_units",
-  "/V1.0/ContractServices": "contract_services",
-  "/V1.0/ContractTicketPurchases": "contract_ticket_purchases",
-  "/V1.0/Contracts": "contracts",
-  "/V1.0/Countries": "countries",
-  "/V1.0/Currencies": "currencies",
-  "/V1.0/Departments": "departments",
-  "/V1.0/DomainRegistrars": "domain_registrars",
-  "/V1.0/ExpenseItemAttachments": "expense_item_attachments",
-  "/V1.0/ExpenseItems": "expense_items",
-  "/V1.0/ExpenseReports": "expense_reports",
-  "/V1.0/HolidaySets": "holiday_sets",
-  "/V1.0/Holidays": "holidays",
-  "/V1.0/InventoryProducts": "inventory_products",
-  "/V1.0/InvoiceTemplates": "invoice_templates",
-  "/V1.0/Invoices": "invoices",
-  "/V1.0/NotificationHistory": "notification_history",
-  "/V1.0/Opportunities": "opportunities",
-  "/V1.0/OpportunityAttachments": "opportunity_attachments",
-  "/V1.0/OpportunityCategories": "opportunity_categories",
-  "/V1.0/OrganizationalLevel1s": "organizational_level1s",
-  "/V1.0/OrganizationalLevel2s": "organizational_level2s",
-  "/V1.0/OrganizationalLevelAssociations": "organizational_level_associations",
-  "/V1.0/Phases": "phases",
-  "/V1.0/ProductVendors": "product_vendors",
-  "/V1.0/Products": "products",
-  "/V1.0/ProjectCharges": "project_charges",
-  "/V1.0/ProjectNotes": "project_notes",
-  "/V1.0/Projects": "projects",
-  "/V1.0/PurchaseApprovals": "purchase_approvals",
-  "/V1.0/PurchaseOrderItemReceiving": "purchase_order_item_receiving",
-  "/V1.0/PurchaseOrderItems": "purchase_order_items",
-  "/V1.0/PurchaseOrders": "purchase_orders",
-  "/V1.0/QuoteItems": "quote_items",
-  "/V1.0/QuoteLocations": "quote_locations",
-  "/V1.0/QuoteTemplates": "quote_templates",
-  "/V1.0/Quotes": "quotes",
-  "/V1.0/ResourceRoleQueues": "resource_role_queues",
-  "/V1.0/ResourceRoles": "resource_roles",
-  "/V1.0/ResourceSkills": "resource_skills",
-  "/V1.0/ResourceTimeOffAdditional": "resource_time_off_additional",
-  "/V1.0/ResourceTimeOffApprovers": "resource_time_off_approvers",
-  "/V1.0/ResourceTimeOffBalances": "resource_time_off_balances",
-  "/V1.0/Resources": "resources",
-  "/V1.0/Roles": "roles",
-  "/V1.0/SalesOrders": "sales_orders",
-  "/V1.0/ServiceCallTaskResources": "service_call_task_resources",
-  "/V1.0/ServiceCallTasks": "service_call_tasks",
-  "/V1.0/ServiceCallTicketResources": "service_call_ticket_resources",
-  "/V1.0/ServiceCallTickets": "service_call_tickets",
-  "/V1.0/ServiceCalls": "service_calls",
-  "/V1.0/ServiceLevelAgreementResults": "service_level_agreement_results",
-  "/V1.0/Services": "services",
-  "/V1.0/Skills": "skills",
-  "/V1.0/SubscriptionPeriods": "subscription_periods",
-  "/V1.0/Subscriptions": "subscriptions",
-  "/V1.0/SurveyResults": "survey_results",
-  "/V1.0/Surveys": "surveys",
-  "/V1.0/TagAliases": "tag_aliases",
-  "/V1.0/TagGroups": "tag_groups",
-  "/V1.0/Tags": "tags",
-  "/V1.0/TaskSecondaryResources": "task_secondary_resources",
-  "/V1.0/Tasks": "tasks",
-  "/V1.0/TaxRegions": "tax_regions",
-  "/V1.0/TicketAdditionalConfigurationItems": "ticket_additional_configuration_items",
-  "/V1.0/TicketAdditionalContacts": "ticket_additional_contacts",
-  "/V1.0/TicketAttachments": "ticket_attachments",
-  "/V1.0/TicketCategories": "ticket_categories",
-  "/V1.0/TicketCategoryFieldDefaults": "ticket_category_field_defaults",
-  "/V1.0/TicketChangeRequestApprovals": "ticket_change_request_approvals",
-  "/V1.0/TicketCharges": "ticket_charges",
-  "/V1.0/TicketChecklistItems": "ticket_checklist_items",
-  "/V1.0/TicketChecklistLibraries": "ticket_checklist_libraries",
-  "/V1.0/TicketHistory": "ticket_history",
-  "/V1.0/TicketNoteAttachments": "ticket_note_attachments",
-  "/V1.0/TicketNoteWebhooks": "ticket_note_webhooks",
-  "/V1.0/TicketNotes": "ticket_notes",
-  "/V1.0/TicketSecondaryResources": "ticket_secondary_resources",
-  "/V1.0/TicketWebhooks": "ticket_webhooks",
-  "/V1.0/Tickets": "tickets",
-  "/V1.0/TimeEntries": "time_entries",
-  "/V1.0/TimeEntryAttachments": "time_entry_attachments",
-  "/V1.0/TimeOffRequests": "time_off_requests"
-};
-
 // src/config/defaults.ts
 var DEFAULT_PAGE_SIZE = 10;
 var MAX_PAGE_SIZE = 500;
@@ -1075,9 +807,8 @@ var DEFAULT_MAX_CONCURRENT = 10;
 var DEFAULT_MAX_RESPONSE_BYTES = 64 * 1024 * 1024;
 var DEFAULT_MAX_SCAN_RECORDS = 500;
 var DEFAULT_MAX_SCAN_PAGES = 4;
-var DEFAULT_READ_CACHE_TTL_MS = CACHE_TTL_DEFAULT_MS;
-var DEFAULT_FIELD_CACHE_TTL_MS = CACHE_TTL_DEFAULT_MS;
-var DEFAULT_RESOURCE_NAME_CACHE_TTL_MS = CACHE_TTL_REFERENCE_MS;
+var DEFAULT_READ_CACHE_TTL_MS = 3e5;
+var DEFAULT_FIELD_CACHE_TTL_MS = 3e5;
 
 // src/credential-shape.ts
 var QUOTE_CHARS = /* @__PURE__ */ new Set(["'", '"']);
@@ -1104,390 +835,105 @@ function credentialValueSummary(value) {
   return value.length >= MIN_PREFIX_SUMMARY_LENGTH ? `len ${value.length}, starts "${value.slice(0, 2)}"` : "short value (length withheld)";
 }
 
-// src/fieldCache.ts
-var FIELD_CACHE_MAX_ENTITIES = 256;
-var FIELD_CACHE_KINDS = ["info", "fields", "udf"];
-var FieldCache = (_class2 = class _FieldCache {
-  /** The configured TTL in ms. */
-  
-  /** The entity bound (the cap applies to STORED entries; inflight never counts). */
-  
-  __init3() {this.store = /* @__PURE__ */ new Map()}
-  __init4() {this.inflightMap = /* @__PURE__ */ new Map()}
-  constructor(ttlMs, maxEntities = FIELD_CACHE_MAX_ENTITIES) {;_class2.prototype.__init3.call(this);_class2.prototype.__init4.call(this);
-    if (!Number.isInteger(ttlMs) || ttlMs <= 0) {
-      throw new AutotaskConfigError(`fieldCache.ttlMs must be a positive integer (got ${ttlMs})`);
-    }
-    if (!Number.isInteger(maxEntities) || maxEntities <= 0) {
-      throw new AutotaskConfigError(`fieldCache.maxEntities must be a positive integer (got ${maxEntities})`);
-    }
-    this.ttlMs = ttlMs;
-    this.maxEntities = maxEntities;
-  }
-  /** The composite key: one entity's catalogs are one key apart. */
-  static key(resourceKey, kind) {
-    return `${resourceKey}:${kind}`;
-  }
-  /**
-   * Read-through lookup: the live entry's value (a copy), or `undefined`
-   * (absent OR expired — an expired entry is purged lazily on this read).
-   */
-  get(resourceKey, kind) {
-    const entry = this.store.get(_FieldCache.key(resourceKey, kind));
-    if (entry === void 0) return void 0;
-    if (entry.expiresAt <= Date.now()) {
-      this.store.delete(_FieldCache.key(resourceKey, kind));
-      return void 0;
-    }
-    return structuredClone(entry.value);
-  }
-  /**
-   * Store a SUCCESSFUL, NON-EMPTY metadata value under (entity, kind),
-   * live for `ttlMs`. An EMPTY value (`[]` / `{}` / null) is refused
-   * silently (never cached — an empty is not an answer): the next call
-   * refetches.
-   */
-  set(resourceKey, kind, value) {
-    if (_FieldCache.isEmpty(value)) return;
-    const key = _FieldCache.key(resourceKey, kind);
-    if (this.store.size >= this.maxEntities && this.purgeExpired() === 0) {
-      const oldest = this.store.keys().next();
-      if (!oldest.done) this.store.delete(oldest.value);
-    }
-    this.store.delete(key);
-    this.store.set(key, { value: structuredClone(value), expiresAt: Date.now() + this.ttlMs });
-  }
-  /** True for the values that must never be cached (an empty is not an answer). */
-  static isEmpty(value) {
-    if (value === null || value === void 0) return true;
-    if (Array.isArray(value)) return value.length === 0;
-    if (typeof value === "object") return Object.keys(value).length === 0;
-    return false;
-  }
-  /**
-   * In-flight de-duplication: the shared in-flight promise for
-   * (entity, kind), or `undefined` (nothing in flight — the caller
-   * issues the request and registers it with `track`).
-   */
-  inflight(resourceKey, kind) {
-    return this.inflightMap.get(_FieldCache.key(resourceKey, kind));
-  }
-  /**
-   * Register an in-flight metadata read: concurrent callers for the same
-   * (entity, kind) await the SAME promise (one wire request). The entry
-   * is dropped on settle — success OR failure (a failure is never
-   * cached; the next caller refetches).
-   */
-  track(resourceKey, kind, promise) {
-    const key = _FieldCache.key(resourceKey, kind);
-    this.inflightMap.set(key, promise);
-    promise.then(
-      () => {
-        this.inflightMap.delete(key);
-      },
-      () => {
-        this.inflightMap.delete(key);
-      }
-    );
-    return promise;
-  }
-  /**
-   * The drift signal: drop the entity's STORED entries AND its in-flight
-   * promise (a refetch must not join a request whose premise just moved).
-   * A no-op when the entity holds nothing.
-   */
-  invalidate(resourceKey) {
-    for (const kind of FIELD_CACHE_KINDS) {
-      const key = _FieldCache.key(resourceKey, kind);
-      this.store.delete(key);
-      this.inflightMap.delete(key);
-    }
-  }
-  /**
-   * A non-mutating probe for the served op's per-row `cache` report:
-   * `hit` = a live (unexpired) entry exists; `age` = ms since that entry
-   * was stored (null when `hit` is false). Never purges, never clones.
-   */
-  peek(resourceKey, kind) {
-    const entry = this.store.get(_FieldCache.key(resourceKey, kind));
-    if (entry === void 0 || entry.expiresAt <= Date.now()) {
-      return { hit: false, age: null };
-    }
-    return { hit: true, age: Date.now() - (entry.expiresAt - this.ttlMs) };
-  }
-  /** Drop every expired entry (returns the number removed). */
-  purgeExpired() {
-    const now = Date.now();
-    let removed = 0;
-    for (const [key, entry] of this.store) {
-      if (entry.expiresAt <= now) {
-        this.store.delete(key);
-        removed += 1;
-      }
-    }
-    return removed;
-  }
-  /** Current entry count (live + not-yet-purged expired). */
-  get size() {
-    return this.store.size;
-  }
-  /** Drop everything (e.g. a caller that knows the tenant was reset). */
-  clear() {
-    this.store.clear();
-    this.inflightMap.clear();
-  }
-}, _class2);
-
-// src/circuit-breaker.ts
-var DEFAULT_CIRCUIT_BREAKER_WINDOW_MS = 1e4;
-var DEFAULT_CIRCUIT_BREAKER_FAILURE_THRESHOLD = 5;
-var DEFAULT_CIRCUIT_BREAKER_OPEN_TIMEOUT_MS = 3e4;
-var DEFAULT_CIRCUIT_BREAKER_SUCCESSES_TO_CLOSE = 2;
-var DEFAULT_CIRCUIT_BREAKER_MAX_ENTRIES = 1024;
-var InMemoryCircuitBreakerStore = (_class3 = class {
-  
-  __init5() {this.states = /* @__PURE__ */ new Map()}
-  constructor(maxEntries = DEFAULT_CIRCUIT_BREAKER_MAX_ENTRIES) {;_class3.prototype.__init5.call(this);
-    if (!Number.isInteger(maxEntries) || maxEntries <= 0) {
-      throw new TypeError(`InMemoryCircuitBreakerStore maxEntries must be a positive integer (got ${String(maxEntries)})`);
-    }
-    this.maxEntries = maxEntries;
-  }
-  get(hostKey) {
-    return this.states.get(hostKey);
-  }
-  set(hostKey, state) {
-    if (this.states.has(hostKey)) {
-      this.states.set(hostKey, state);
-      return;
-    }
-    if (this.states.size >= this.maxEntries) {
-      let victim;
-      let victimActivity = Number.POSITIVE_INFINITY;
-      for (const [key, s] of this.states) {
-        const activity = s.openedAt !== null ? s.openedAt : s.failures.length > 0 ? s.failures[s.failures.length - 1] : 0;
-        if (activity < victimActivity) {
-          victimActivity = activity;
-          victim = key;
-        }
-      }
-      if (victim !== void 0) this.states.delete(victim);
-    }
-    this.states.set(hostKey, state);
-  }
-  delete(hostKey) {
-    this.states.delete(hostKey);
-  }
-  /** Drop every entry (test helper surface; also used by resetDefaultCircuitBreakerStore). */
-  clear() {
-    this.states.clear();
-  }
-}, _class3);
-var defaultStore;
-function defaultCircuitBreakerStore() {
-  if (defaultStore === void 0) defaultStore = new InMemoryCircuitBreakerStore();
-  return defaultStore;
-}
-function resetDefaultCircuitBreakerStore() {
-  _optionalChain([defaultStore, 'optionalAccess', _5 => _5.clear, 'call', _6 => _6()]);
-}
-function buildBreakerKey(baseUrl) {
-  return new URL(baseUrl).host.toLowerCase();
-}
-function isBreakerFailure(err) {
-  if (err.notSent === true) return false;
-  if (err.code === "NETWORK_ERROR" || err.code === "TIMEOUT") return true;
-  const status = err.httpStatus;
-  if (status === void 0) return false;
-  if (status === 429) return true;
-  if (status >= 500 && status < 600) {
-    return _optionalChain([err, 'access', _7 => _7.details, 'optionalAccess', _8 => _8.deterministic]) !== true;
-  }
-  return err.code === "UNEXPECTED_CONTENT_TYPE";
-}
-
-// src/cooldown.ts
+// src/http/gates.ts
 var DEFAULT_COOLDOWN_MAX_MS = 15 * 60 * 1e3;
 var DEFAULT_COOLDOWN_DEFAULT_MS = 6e4;
-var DEFAULT_COOLDOWN_MAX_ENTRIES = 1024;
 var THREAD_THRESHOLD_MAX_MS = 1e4;
 var THREAD_THRESHOLD_DEFAULT_MS = 5e3;
-var InMemoryCooldownStore = (_class4 = class {
-  
-  __init6() {this.deadlines = /* @__PURE__ */ new Map()}
-  constructor(maxEntries = DEFAULT_COOLDOWN_MAX_ENTRIES) {;_class4.prototype.__init6.call(this);
-    if (!Number.isInteger(maxEntries) || maxEntries <= 0) {
-      throw new TypeError(`InMemoryCooldownStore maxEntries must be a positive integer (got ${String(maxEntries)})`);
-    }
-    this.maxEntries = maxEntries;
-  }
-  get(tenantKey) {
-    return this.deadlines.get(tenantKey);
+var cooldowns = /* @__PURE__ */ new Map();
+var maintenance = /* @__PURE__ */ new Map();
+function hostKey(baseUrl) {
+  return new URL(baseUrl).host.toLowerCase();
+}
+function tenantKey(userName, baseUrl) {
+  return `${userName.toLowerCase()}@${hostKey(baseUrl)}`;
+}
+function cooldownRefusal(key, ctx) {
+  const deadline = cooldowns.get(key);
+  if (deadline === void 0) return void 0;
+  const remainingMs = deadline - Date.now();
+  if (remainingMs <= 0) {
+    cooldowns.delete(key);
+    return void 0;
   }
-  set(tenantKey, deadline) {
-    if (this.deadlines.has(tenantKey)) {
-      this.deadlines.set(tenantKey, deadline);
-      return;
-    }
-    if (this.deadlines.size >= this.maxEntries) {
-      let victim;
-      let victimDeadline = Number.POSITIVE_INFINITY;
-      for (const [key, d] of this.deadlines) {
-        if (d < victimDeadline) {
-          victimDeadline = d;
-          victim = key;
-        }
-      }
-      if (victim !== void 0) this.deadlines.delete(victim);
+  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.`,
+    {
+      ...ctx,
+      code: "RATE_LIMITED_COOLDOWN",
+      retryable: false,
+      suggestedAction: `Wait ${seconds}s (per-tenant 429 cooldown) and retry with a narrower query; the call was not sent and consumed no vendor budget.`
     }
-    this.deadlines.set(tenantKey, deadline);
-  }
-  delete(tenantKey) {
-    this.deadlines.delete(tenantKey);
-  }
-  /** Drop every entry (test helper surface; also used by resetDefaultCooldownStore). */
-  clear() {
-    this.deadlines.clear();
-  }
-}, _class4);
-var defaultStore2;
-function defaultCooldownStore() {
-  if (defaultStore2 === void 0) defaultStore2 = new InMemoryCooldownStore();
-  return defaultStore2;
+  );
+  err.retryAfter = seconds;
+  err.notSent = true;
+  return err;
 }
-function resetDefaultCooldownStore() {
-  _optionalChain([defaultStore2, 'optionalAccess', _9 => _9.clear, 'call', _10 => _10()]);
+function armCooldown(key, deadline) {
+  const now = Date.now();
+  for (const [k, d] of cooldowns) if (d <= now) cooldowns.delete(k);
+  cooldowns.set(key, deadline);
 }
-function buildTenantKey(userName, baseUrl) {
-  return `${userName.toLowerCase()}@${new URL(baseUrl).host.toLowerCase()}`;
+function clearCooldown(key) {
+  cooldowns.delete(key);
 }
 function cooldownDurationMs(retryAfterSecs, opts) {
   if (opts.threadThreshold) {
-    const secs = retryAfterSecs !== void 0 ? Math.min(retryAfterSecs, Math.round(THREAD_THRESHOLD_MAX_MS / 1e3)) : Math.round(THREAD_THRESHOLD_DEFAULT_MS / 1e3);
-    return Math.max(0, secs) * 1e3;
+    const ms = retryAfterSecs !== void 0 ? Math.min(retryAfterSecs * 1e3, THREAD_THRESHOLD_MAX_MS) : THREAD_THRESHOLD_DEFAULT_MS;
+    return Math.max(0, ms);
   }
-  const rawMs = retryAfterSecs !== void 0 ? retryAfterSecs * 1e3 : opts.defaultMs;
-  return Math.min(rawMs, opts.maxMs);
+  return Math.min(retryAfterSecs !== void 0 ? retryAfterSecs * 1e3 : opts.defaultMs, opts.maxMs);
 }
-
-// src/resourceNameCache.ts
-var RESOURCE_NAME_CACHE_MAX_ENTRIES = 1024;
-var RESOURCE_NAME_CACHE_BLIND_TTL_MS = 6e4;
-var ResourceNameCache = (_class5 = class _ResourceNameCache {
-  /** The configured TTL in ms. */
-  
-  /** The entry bound (the cap applies to STORED entries; inflight never counts). */
-  
-  __init7() {this.store = /* @__PURE__ */ new Map()}
-  __init8() {this.inflightMap = /* @__PURE__ */ new Map()}
-  __init9() {this.epochCounter = 0}
-  constructor(ttlMs, maxEntries = RESOURCE_NAME_CACHE_MAX_ENTRIES) {;_class5.prototype.__init7.call(this);_class5.prototype.__init8.call(this);_class5.prototype.__init9.call(this);
-    if (!Number.isInteger(ttlMs) || ttlMs <= 0) {
-      throw new AutotaskConfigError(`resourceNameCache.ttlMs must be a positive integer (got ${ttlMs})`);
-    }
-    if (!Number.isInteger(maxEntries) || maxEntries <= 0) {
-      throw new AutotaskConfigError(`resourceNameCache.maxEntries must be a positive integer (got ${maxEntries})`);
-    }
-    this.ttlMs = ttlMs;
-    this.maxEntries = maxEntries;
-  }
-  /** The namespaced key: `resources:<canonical id>` (the namespace
-   * leaves a documented path to future FK tables — v1 serves
-   * `resources` only). */
-  static key(id) {
-    return `resources:${id}`;
-  }
-  /**
-   * Read-through lookup: the live entry (a copy), or `undefined`
-   * (absent OR expired — an expired entry is purged lazily on this
-   * read).
-   */
-  get(id) {
-    const entry = this.store.get(_ResourceNameCache.key(id));
-    if (entry === void 0) return void 0;
-    if (entry.expiresAt <= Date.now()) {
-      this.store.delete(_ResourceNameCache.key(id));
-      return void 0;
-    }
-    return structuredClone(entry.value);
-  }
-  /**
-   * Store a name answer under the id, live for `ttlMs`. ALWAYS stores
-   * (the no-name-part answer `{ name: null, blind: false }` is a stable
-   * fact and is cached — the documented difference from the fieldCache
-   * empty rule); past the cap, purge expired first, then evict the
-   * oldest-inserted (Map insertion order; refreshes re-insert so the
-   * memory guard drops the OLDEST-inserted entries first).
-   */
-  set(id, value, epoch = this.epochCounter) {
-    if (epoch !== this.epochCounter) return;
-    const key = _ResourceNameCache.key(id);
-    if (!this.store.has(key) && this.store.size >= this.maxEntries && this.purgeExpired() === 0) {
-      const oldest = this.store.keys().next();
-      if (!oldest.done) this.store.delete(oldest.value);
-    }
-    this.store.delete(key);
-    this.store.set(key, { value: structuredClone(value), expiresAt: Date.now() + (value.blind ? Math.min(this.ttlMs, RESOURCE_NAME_CACHE_BLIND_TTL_MS) : this.ttlMs) });
-  }
-  /**
-   * In-flight de-duplication: the shared in-flight promise for the id,
-   * or `undefined` (nothing in flight — the caller issues the request
-   * and registers it with `track`).
-   */
-  inflight(id) {
-    return this.inflightMap.get(_ResourceNameCache.key(id));
-  }
-  /**
-   * Register an in-flight name read: concurrent callers for the same id
-   * await the SAME promise (one wire request). The entry is dropped on
-   * settle — success OR failure (a failure is never cached; the next
-   * caller refetches).
-   */
-  track(id, promise) {
-    const key = _ResourceNameCache.key(id);
-    this.inflightMap.set(key, promise);
-    promise.then(
-      () => {
-        this.inflightMap.delete(key);
-      },
-      () => {
-        this.inflightMap.delete(key);
-      }
-    );
-    return promise;
-  }
-  /** Drop every expired entry (returns the number removed). */
-  purgeExpired() {
-    const now = Date.now();
-    let removed = 0;
-    for (const [key, entry] of this.store) {
-      if (entry.expiresAt <= now) {
-        this.store.delete(key);
-        removed += 1;
-      }
+function admitMaintenance(host, ctx) {
+  const gate = maintenance.get(host);
+  if (gate === void 0) return "send";
+  const now = Date.now();
+  if (!gate.probing && now >= gate.nextProbeAt) {
+    gate.probing = true;
+    return gate;
+  }
+  const retryAfterMs = gate.probing ? Math.max(gate.nextProbeAt - now, gate.pollMs) : Math.max(0, gate.nextProbeAt - now);
+  const seconds = Math.max(1, Math.ceil(retryAfterMs / 1e3));
+  const since = new Date(gate.since).toISOString();
+  const err = new MaintenanceError(
+    `Zone ${host} is in a maintenance window (since ${since}); the call was NOT sent. Retry in about ${seconds}s.`,
+    {
+      ...ctx,
+      details: { since, retryAfterMs },
+      suggestedAction: `The Autotask zone is in its maintenance window (since ${since}). The call was not sent; retry later (the next probe is in about ${seconds}s, windows usually last 30-90 min).`
     }
-    return removed;
-  }
-  /** The invalidation epoch: bumped by `clear()`; capture it before a wire
-   * read and pass it to `set` so a stale answer is dropped. */
-  get epoch() {
-    return this.epochCounter;
-  }
-  /** Current entry count (live + not-yet-purged expired). */
-  get size() {
-    return this.store.size;
-  }
-  /**
-   * Drop everything — the SCOPED invalidation target: a real write to
-   * the `resources` resource through the same client (a rename via this
-   * client is always fresh).
-   */
-  clear() {
-    this.epochCounter += 1;
-    this.store.clear();
-    this.inflightMap.clear();
-  }
-}, _class5);
+  );
+  err.retryAfter = seconds;
+  err.notSent = true;
+  return err;
+}
+function openMaintenance(host, pollMs, logger, correlationId) {
+  if (maintenance.has(host)) return;
+  const now = Date.now();
+  maintenance.set(host, { since: now, pollMs, nextProbeAt: now + pollMs, probing: false });
+  _optionalChain([logger, 'access', _5 => _5.warn, 'optionalCall', _6 => _6(`[autotask] maintenance gate OPEN for ${host}: other calls on this zone fail fast (MAINTENANCE) until a probe sees a normal response`, correlationId)]);
+}
+function claimMaintenanceProbe(host) {
+  const gate = maintenance.get(host);
+  if (gate === void 0 || gate.probing) return void 0;
+  gate.probing = true;
+  return gate;
+}
+function releaseMaintenanceProbe(host, gate) {
+  if (maintenance.get(host) !== gate) return;
+  gate.probing = false;
+  gate.nextProbeAt = Date.now() + gate.pollMs;
+}
+function closeMaintenance(host, logger, correlationId) {
+  const gate = maintenance.get(host);
+  if (gate === void 0) return;
+  maintenance.delete(host);
+  _optionalChain([logger, 'access', _7 => _7.warn, 'optionalCall', _8 => _8(`[autotask] maintenance gate CLOSED for ${host} after ${Math.round((Date.now() - gate.since) / 1e3)}s`, correlationId)]);
+}
+function maintenanceSince(host) {
+  return _optionalChain([maintenance, 'access', _9 => _9.get, 'call', _10 => _10(host), 'optionalAccess', _11 => _11.since]);
+}
 
 // src/host-policy.ts
 function canonicalHost(origin) {
@@ -1770,123 +1216,73 @@ function resolveRateLimit(config, agent) {
   return rateLimit;
 }
 function resolveCooldown(config) {
-  const cooldownEnabled = _nullishCoalesce(_optionalChain([config, 'access', _11 => _11.cooldown, 'optionalAccess', _12 => _12.enabled]), () => ( true));
-  const cooldownMaxMs = _nullishCoalesce(_optionalChain([config, 'access', _13 => _13.cooldown, 'optionalAccess', _14 => _14.maxMs]), () => ( DEFAULT_COOLDOWN_MAX_MS));
+  const cooldownEnabled = _nullishCoalesce(_optionalChain([config, 'access', _12 => _12.cooldown, 'optionalAccess', _13 => _13.enabled]), () => ( true));
+  const cooldownMaxMs = _nullishCoalesce(_optionalChain([config, 'access', _14 => _14.cooldown, 'optionalAccess', _15 => _15.maxMs]), () => ( DEFAULT_COOLDOWN_MAX_MS));
   if (!Number.isInteger(cooldownMaxMs) || cooldownMaxMs <= 0) {
     throw new AutotaskConfigError("cooldown.maxMs must be a positive integer (ms)");
   }
-  const cooldownDefaultMs = _nullishCoalesce(_optionalChain([config, 'access', _15 => _15.cooldown, 'optionalAccess', _16 => _16.defaultMs]), () => ( DEFAULT_COOLDOWN_DEFAULT_MS));
+  const cooldownDefaultMs = _nullishCoalesce(_optionalChain([config, 'access', _16 => _16.cooldown, 'optionalAccess', _17 => _17.defaultMs]), () => ( DEFAULT_COOLDOWN_DEFAULT_MS));
   if (!Number.isInteger(cooldownDefaultMs) || cooldownDefaultMs <= 0) {
     throw new AutotaskConfigError("cooldown.defaultMs must be a positive integer (ms)");
   }
-  const cooldownStore = _optionalChain([config, 'access', _17 => _17.cooldown, 'optionalAccess', _18 => _18.store]);
-  if (cooldownStore !== void 0 && (typeof cooldownStore.get !== "function" || typeof cooldownStore.set !== "function" || typeof cooldownStore.delete !== "function")) {
-    throw new AutotaskConfigError("cooldown.store must implement get/set/delete (a CooldownStore)");
-  }
   return {
     enabled: cooldownEnabled,
     maxMs: cooldownMaxMs,
-    defaultMs: cooldownDefaultMs,
-    store: cooldownStore
-  };
-}
-function resolveCircuitBreaker(config) {
-  const breakerEnabled = _nullishCoalesce(_optionalChain([config, 'access', _19 => _19.circuitBreaker, 'optionalAccess', _20 => _20.enabled]), () => ( false));
-  const breakerWindowMs = _nullishCoalesce(_optionalChain([config, 'access', _21 => _21.circuitBreaker, 'optionalAccess', _22 => _22.failureWindowMs]), () => ( DEFAULT_CIRCUIT_BREAKER_WINDOW_MS));
-  if (!Number.isInteger(breakerWindowMs) || breakerWindowMs <= 0) {
-    throw new AutotaskConfigError("circuitBreaker.failureWindowMs must be a positive integer (ms)");
-  }
-  const breakerThreshold = _nullishCoalesce(_optionalChain([config, 'access', _23 => _23.circuitBreaker, 'optionalAccess', _24 => _24.failureThreshold]), () => ( DEFAULT_CIRCUIT_BREAKER_FAILURE_THRESHOLD));
-  if (!Number.isInteger(breakerThreshold) || breakerThreshold <= 0) {
-    throw new AutotaskConfigError("circuitBreaker.failureThreshold must be a positive integer");
-  }
-  const breakerOpenTimeoutMs = _nullishCoalesce(_optionalChain([config, 'access', _25 => _25.circuitBreaker, 'optionalAccess', _26 => _26.openTimeoutMs]), () => ( DEFAULT_CIRCUIT_BREAKER_OPEN_TIMEOUT_MS));
-  if (!Number.isInteger(breakerOpenTimeoutMs) || breakerOpenTimeoutMs <= 0) {
-    throw new AutotaskConfigError("circuitBreaker.openTimeoutMs must be a positive integer (ms)");
-  }
-  const breakerSuccessesToClose = _nullishCoalesce(_optionalChain([config, 'access', _27 => _27.circuitBreaker, 'optionalAccess', _28 => _28.successesToClose]), () => ( DEFAULT_CIRCUIT_BREAKER_SUCCESSES_TO_CLOSE));
-  if (!Number.isInteger(breakerSuccessesToClose) || breakerSuccessesToClose <= 0) {
-    throw new AutotaskConfigError("circuitBreaker.successesToClose must be a positive integer");
-  }
-  const breakerHalfOpenProbes = _nullishCoalesce(_optionalChain([config, 'access', _29 => _29.circuitBreaker, 'optionalAccess', _30 => _30.halfOpenProbes]), () => ( breakerSuccessesToClose));
-  if (!Number.isInteger(breakerHalfOpenProbes) || breakerHalfOpenProbes <= 0) {
-    throw new AutotaskConfigError("circuitBreaker.halfOpenProbes must be a positive integer");
-  }
-  if (breakerHalfOpenProbes < breakerSuccessesToClose) {
-    throw new AutotaskConfigError(
-      `circuitBreaker.halfOpenProbes (${breakerHalfOpenProbes}) must be >= successesToClose (${breakerSuccessesToClose}) \u2014 the breaker could never close`
-    );
-  }
-  const breakerStore = _optionalChain([config, 'access', _31 => _31.circuitBreaker, 'optionalAccess', _32 => _32.store]);
-  if (breakerStore !== void 0 && (typeof breakerStore.get !== "function" || typeof breakerStore.set !== "function" || typeof breakerStore.delete !== "function")) {
-    throw new AutotaskConfigError("circuitBreaker.store must implement get/set/delete (a CircuitBreakerStore)");
-  }
-  const breakerIsFailure = _optionalChain([config, 'access', _33 => _33.circuitBreaker, 'optionalAccess', _34 => _34.isFailure]);
-  if (breakerIsFailure !== void 0 && typeof breakerIsFailure !== "function") {
-    throw new AutotaskConfigError("circuitBreaker.isFailure must be a function");
-  }
-  return {
-    enabled: breakerEnabled,
-    failureWindowMs: breakerWindowMs,
-    failureThreshold: breakerThreshold,
-    openTimeoutMs: breakerOpenTimeoutMs,
-    successesToClose: breakerSuccessesToClose,
-    halfOpenProbes: breakerHalfOpenProbes,
-    store: breakerStore,
-    isFailure: breakerIsFailure
+    defaultMs: cooldownDefaultMs
   };
 }
 function resolveResolution(config, agent) {
-  const maxScanRecords = _nullishCoalesce(_optionalChain([config, 'access', _35 => _35.resolution, 'optionalAccess', _36 => _36.maxScanRecords]), () => ( (agent ? AGENT_PROFILE.resolution.maxScanRecords : DEFAULT_MAX_SCAN_RECORDS)));
+  const maxScanRecords = _nullishCoalesce(_optionalChain([config, 'access', _18 => _18.resolution, 'optionalAccess', _19 => _19.maxScanRecords]), () => ( (agent ? AGENT_PROFILE.resolution.maxScanRecords : DEFAULT_MAX_SCAN_RECORDS)));
   if (!Number.isInteger(maxScanRecords) || maxScanRecords < 1) {
     throw new AutotaskConfigError("resolution.maxScanRecords must be an integer >= 1");
   }
-  const maxScanPages = _nullishCoalesce(_optionalChain([config, 'access', _37 => _37.resolution, 'optionalAccess', _38 => _38.maxScanPages]), () => ( (agent ? AGENT_PROFILE.resolution.maxScanPages : DEFAULT_MAX_SCAN_PAGES)));
+  const maxScanPages = _nullishCoalesce(_optionalChain([config, 'access', _20 => _20.resolution, 'optionalAccess', _21 => _21.maxScanPages]), () => ( (agent ? AGENT_PROFILE.resolution.maxScanPages : DEFAULT_MAX_SCAN_PAGES)));
   if (!Number.isInteger(maxScanPages) || maxScanPages < 1) {
     throw new AutotaskConfigError("resolution.maxScanPages must be an integer >= 1");
   }
-  const scanOnMiss = _optionalChain([config, 'access', _39 => _39.resolution, 'optionalAccess', _40 => _40.scanOnMiss]) === void 0 ? false : config.resolution.scanOnMiss;
+  const scanOnMiss = _optionalChain([config, 'access', _22 => _22.resolution, 'optionalAccess', _23 => _23.scanOnMiss]) === void 0 ? false : config.resolution.scanOnMiss;
   if (typeof scanOnMiss !== "boolean") {
     throw new AutotaskConfigError("resolution.scanOnMiss must be a boolean");
   }
   return { maxScanRecords, maxScanPages, scanOnMiss };
 }
+var FIELD_CACHE_MAX_ENTRIES = 256;
 function resolveCaches(config) {
-  const cacheBlock = config.cache === false || config.cache === void 0 ? void 0 : config.cache;
-  resolveReadCacheStore(cacheBlock);
-  const fieldCacheBlock = config.fieldCache === false || config.fieldCache === void 0 ? void 0 : config.fieldCache;
-  const resourceNameCacheBlock = config.resourceNameCache === false || config.resourceNameCache === void 0 ? void 0 : config.resourceNameCache;
-  const readCache = config.cache === false ? void 0 : _nullishCoalesce(_optionalChain([cacheBlock, 'optionalAccess', _41 => _41.store]), () => ( buildReadCache(config)));
-  const fieldCache = config.fieldCache === false ? void 0 : new FieldCache(
-    _nullishCoalesce(_optionalChain([fieldCacheBlock, 'optionalAccess', _42 => _42.ttlMs]), () => ( DEFAULT_FIELD_CACHE_TTL_MS)),
-    _nullishCoalesce(_optionalChain([fieldCacheBlock, 'optionalAccess', _43 => _43.maxEntities]), () => ( FIELD_CACHE_MAX_ENTITIES))
-  );
-  const resourceNameCache = config.resourceNameCache === false ? void 0 : new ResourceNameCache(
-    _nullishCoalesce(_optionalChain([resourceNameCacheBlock, 'optionalAccess', _44 => _44.ttlMs]), () => ( DEFAULT_RESOURCE_NAME_CACHE_TTL_MS)),
-    _nullishCoalesce(_optionalChain([resourceNameCacheBlock, 'optionalAccess', _45 => _45.maxEntries]), () => ( RESOURCE_NAME_CACHE_MAX_ENTRIES))
-  );
-  return { readCache, fieldCache, resourceNameCache };
-}
-function resolveReadCacheStore(cacheBlock) {
-  if (cacheBlock === void 0 || cacheBlock === false || cacheBlock.store === void 0) return;
-  if (!(cacheBlock.store instanceof ReadCache)) {
-    throw new AutotaskConfigError(
-      "cache.store must be a ReadCache instance (import { ReadCache } from the SDK; the pool supplies its own)"
-    );
+  for (const removed of ["fieldCache", "resourceNameCache"]) {
+    if (removed in config) {
+      throw new AutotaskConfigError(
+        `${removed} was removed in 0.40.0: use cache: false (every channel off) or cache: { ttlMs?, fieldTtlMs? }`
+      );
+    }
   }
-  if (cacheBlock.ttlMs !== void 0 || cacheBlock.perResourceTtlMs !== void 0) {
-    throw new AutotaskConfigError(
-      "cache.store cannot be combined with cache.ttlMs or cache.perResourceTtlMs \u2014 the supplied ReadCache instance owns its TTLs"
-    );
+  const block = config.cache;
+  if (block === false) return {};
+  if (_optionalChain([block, 'optionalAccess', _24 => _24.store]) !== void 0) {
+    if (!(block.store instanceof TtlCache)) {
+      throw new AutotaskConfigError("cache.store must be a TtlCache instance (import { TtlCache } from the SDK; the pool supplies its own)");
+    }
+    if (block.ttlMs !== void 0) {
+      throw new AutotaskConfigError("cache.store cannot be combined with cache.ttlMs: the supplied instance owns its TTL");
+    }
+  }
+  return {
+    readCache: _nullishCoalesce(_optionalChain([block, 'optionalAccess', _25 => _25.store]), () => ( buildReadCache(config))),
+    fieldCache: new TtlCache(ttlOption(_optionalChain([block, 'optionalAccess', _26 => _26.fieldTtlMs]), DEFAULT_FIELD_CACHE_TTL_MS, "cache.fieldTtlMs"), {
+      maxEntries: FIELD_CACHE_MAX_ENTRIES
+    })
+  };
+}
+function ttlOption(value, fallback, name) {
+  const ms = _nullishCoalesce(value, () => ( fallback));
+  if (!Number.isInteger(ms) || ms <= 0) {
+    throw new AutotaskConfigError(`${name} must be a positive integer (got ${String(ms)})`);
   }
+  return ms;
 }
 function buildReadCache(config) {
   if (config.cache === false) return void 0;
-  const cacheBlock = config.cache === void 0 ? void 0 : config.cache;
-  return new ReadCache(
-    _nullishCoalesce(_optionalChain([cacheBlock, 'optionalAccess', _46 => _46.ttlMs]), () => ( DEFAULT_READ_CACHE_TTL_MS)),
-    { ...DEFAULT_PER_RESOURCE_TTL_MS, ..._optionalChain([cacheBlock, 'optionalAccess', _47 => _47.perResourceTtlMs]) }
-  );
+  const ttlMs = ttlOption(_optionalChain([config, 'access', _27 => _27.cache, 'optionalAccess', _28 => _28.ttlMs]), DEFAULT_READ_CACHE_TTL_MS, "cache.ttlMs");
+  return new TtlCache(ttlMs, { ttlFor: (key) => readTtlFor(key, ttlMs) });
 }
 function resolveConfig(config) {
   if (config === null || typeof config !== "object") {
@@ -1899,16 +1295,15 @@ function resolveConfig(config) {
   const limits = resolveLimits(config, agent);
   const rateLimit = resolveRateLimit(config, agent);
   const cooldown = resolveCooldown(config);
-  const circuitBreaker = resolveCircuitBreaker(config);
   const resolution = resolveResolution(config, agent);
   const redactPersonalData = _nullishCoalesce(config.redactPersonalData, () => ( true));
   const caches = resolveCaches(config);
-  const update = { putFallback: _optionalChain([config, 'access', _48 => _48.update, 'optionalAccess', _49 => _49.putFallback]) === true };
+  const update = { putFallback: _optionalChain([config, 'access', _29 => _29.update, 'optionalAccess', _30 => _30.putFallback]) === true };
   const reResolveZoneOn401 = config.reResolveZoneOn401 === true;
   const logger = _nullishCoalesce(config.logger, () => ( NoopLogger));
   if (credentials.baseUrl.startsWith("http:")) {
     const host = new URL(credentials.baseUrl).host;
-    _optionalChain([logger, 'access', _50 => _50.warn, 'optionalCall', _51 => _51(
+    _optionalChain([logger, 'access', _31 => _31.warn, 'optionalCall', _32 => _32(
       `[autotask] cleartext credentials to ${host} \u2014 https recommended (baseUrl uses http:; all catalog zones are https)`
     )]);
   }
@@ -1924,7 +1319,6 @@ function resolveConfig(config) {
     logger,
     rateLimit,
     cooldown,
-    circuitBreaker,
     resolution,
     onAudit: config.onAudit,
     redactPersonalData,
@@ -1989,7 +1383,7 @@ function parseIdentifier(value, label = "id") {
   return parsed;
 }
 function flattenUdfs(record, options) {
-  const prefix = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _52 => _52.prefix]), () => ( "udf_"));
+  const prefix = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _33 => _33.prefix]), () => ( "udf_"));
   const out = { ...record };
   const udfs = record.userDefinedFields;
   if (!Array.isArray(udfs)) return out;
@@ -2311,7 +1705,7 @@ function maintenanceProbe(text) {
   return Buffer.from(text, "utf8").subarray(0, MAINTENANCE_PROBE_BYTES).toString("utf8");
 }
 function looksLikeMaintenanceText(text) {
-  return /maintenance|temporarily unavailable|service unavailable|outage|downtime|down for/i.test(
+  return /maintenance|outage|downtime|down for/i.test(
     maintenanceProbe(text)
   );
 }
@@ -16354,7 +15748,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', _53 => _53[resource], 'optionalAccess', _54 => _54[op]]);
+  const stamp = _optionalChain([EMPTY_REASON_STAMPS, 'access', _34 => _34[resource], 'optionalAccess', _35 => _35[op]]);
   const pointer = POINTER_NOTES[surface];
   const isGetMiss = err instanceof NotFoundError && op === "get";
   if (stamp === void 0 && pointer === void 0 && !isGetMiss) return;
@@ -16438,107 +15832,25 @@ function unwrapOperation(body, operation) {
   if (idValue === void 0) {
     const err = new AutotaskError(
       "Expected OperationResultModel { itemId } (or { id }); got a different shape",
-      { code: "INVALID_RESPONSE", category: "server", operation, suggestedAction: INVALID_SHAPE_ACTION }
-    );
-    attachEmptyReasonDetails(err);
-    throw err;
-  }
-  return { id: idValue };
-}
-function toIdentifierId(value) {
-  if (typeof value === "number" && Number.isInteger(value)) return value;
-  if (typeof value === "string" && /^\d+$/.test(value.trim())) {
-    const trimmed = value.trim();
-    const parsed = Number.parseInt(trimmed, 10);
-    return Number.isSafeInteger(parsed) ? parsed : trimmed;
-  }
-  return void 0;
-}
-function passthrough(body) {
-  return body;
-}
-
-// src/latest-count-cache.ts
-var LATEST_COUNT_CACHE_TTL_MS = 3e4;
-var LATEST_COUNT_CACHE_MAX_ENTRIES = 4096;
-var LatestCountCache = (_class6 = class {
-  /** The TTL in ms. */
-  
-  /** The entry bound (applies to STORED entries). */
-  
-  __init10() {this.store = /* @__PURE__ */ new Map()}
-  /** The invalidation epoch (the `ReadCache` pattern — issue #139): bumped
-   * by `clear()`; capture it before a wire read and pass it to `set` so a
-   * probe in flight across a write cannot re-store its stale answer. */
-  __init11() {this.epochCounter = 0}
-  constructor(ttlMs, maxEntries = LATEST_COUNT_CACHE_MAX_ENTRIES) {;_class6.prototype.__init10.call(this);_class6.prototype.__init11.call(this);
-    if (!Number.isInteger(ttlMs) || ttlMs <= 0) {
-      throw new AutotaskConfigError(`latestCountCache.ttlMs must be a positive integer (got ${String(ttlMs)})`);
-    }
-    if (!Number.isInteger(maxEntries) || maxEntries <= 0) {
-      throw new AutotaskConfigError(`latestCountCache.maxEntries must be a positive integer (got ${String(maxEntries)})`);
-    }
-    this.ttlMs = ttlMs;
-    this.maxEntries = maxEntries;
-  }
-  /** The composite key: (resource plan key, canonical filter serialisation)
-   * — the `\u0000` separator is unencodable in a filter value, so no two
-   * (resource, conditions) pairs collide. */
-  static key(resourceKey, conditions) {
-    return `${resourceKey}\0${JSON.stringify(_nullishCoalesce(conditions, () => ( [])))}`;
-  }
-  /** The live entry's count, or `undefined` (absent OR expired — an expired
-   * entry is purged lazily on this read). */
-  get(key) {
-    const entry = this.store.get(key);
-    if (entry === void 0) return void 0;
-    if (entry.expiresAt <= Date.now()) {
-      this.store.delete(key);
-      return void 0;
-    }
-    return entry.value;
-  }
-  /** The invalidation epoch: bumped by `clear()`; capture it before a wire
-   * read and pass it to `set` so a probe in flight across a write cannot
-   * re-store its stale answer (issue #139, the `ReadCache` pattern). */
-  get epoch() {
-    return this.epochCounter;
-  }
-  /** Store a SUCCESSFUL plain-number count under `key`, live for `ttlMs`.
-   * `epoch` is the invalidation epoch the caller captured BEFORE its wire
-   * read: a probe that straddled a `clear()` (a write) is dropped, never
-   * re-stored with its pre-write body (issue #139). Past the cap: purge
-   * expired entries first, then evict the oldest-inserted (Map iteration
-   * order = insertion order). */
-  set(key, value, epoch = this.epochCounter) {
-    if (epoch !== this.epochCounter) return;
-    if (!Number.isFinite(value)) return;
-    const entry = { value, expiresAt: Date.now() + this.ttlMs };
-    if (!this.store.has(key) && this.store.size >= this.maxEntries) {
-      for (const [k, e] of this.store) {
-        if (e.expiresAt <= Date.now()) this.store.delete(k);
-      }
-      if (this.store.size >= this.maxEntries) {
-        const oldest = this.store.keys().next();
-        if (!oldest.done) this.store.delete(oldest.value);
-      }
-    }
-    this.store.set(key, entry);
-  }
-  /** Drop one entry (absent = no-op). Issue #157: the stale-LOW recovery
-   *  deletes the cached total before its one fresh wire re-probe, so the
-   *  re-probe cannot be served by the entry it is meant to replace. */
-  delete(key) {
-    this.store.delete(key);
+      { code: "INVALID_RESPONSE", category: "server", operation, suggestedAction: INVALID_SHAPE_ACTION }
+    );
+    attachEmptyReasonDetails(err);
+    throw err;
   }
-  /** Clear every entry (a real write through the owning client — the
-   * write-then-read re-fetch rule) and bump the invalidation epoch: a
-   * `set` captured before this `clear` is discarded (issue #139). */
-  clear() {
-    this.epochCounter += 1;
-    this.store.clear();
+  return { id: idValue };
+}
+function toIdentifierId(value) {
+  if (typeof value === "number" && Number.isInteger(value)) return value;
+  if (typeof value === "string" && /^\d+$/.test(value.trim())) {
+    const trimmed = value.trim();
+    const parsed = Number.parseInt(trimmed, 10);
+    return Number.isSafeInteger(parsed) ? parsed : trimmed;
   }
-}, _class6);
+  return void 0;
+}
+function passthrough(body) {
+  return body;
+}
 
 // src/http/body.ts
 async function readBodyText(res, max, what, ctx) {
@@ -16549,7 +15861,7 @@ async function readBodyText(res, max, what, ctx) {
   });
   const declared = Number(res.headers.get("Content-Length"));
   if (Number.isFinite(declared) && declared > max) {
-    await _optionalChain([res, 'access', _55 => _55.body, 'optionalAccess', _56 => _56.cancel, 'call', _57 => _57(), 'access', _58 => _58.catch, 'call', _59 => _59(() => void 0)]);
+    await _optionalChain([res, 'access', _36 => _36.body, 'optionalAccess', _37 => _37.cancel, 'call', _38 => _38(), 'access', _39 => _39.catch, 'call', _40 => _40(() => void 0)]);
     throw tooLarge();
   }
   if (res.body === null) return "";
@@ -16570,7 +15882,7 @@ async function readBodyText(res, max, what, ctx) {
   return text + decoder.decode();
 }
 function isJsonMediaType(header) {
-  const mediaType = _nullishCoalesce(_optionalChain([header, 'access', _60 => _60.split, 'call', _61 => _61(";"), 'access', _62 => _62[0], 'optionalAccess', _63 => _63.trim, 'call', _64 => _64(), 'access', _65 => _65.toLowerCase, 'call', _66 => _66()]), () => ( ""));
+  const mediaType = _nullishCoalesce(_optionalChain([header, 'access', _41 => _41.split, 'call', _42 => _42(";"), 'access', _43 => _43[0], 'optionalAccess', _44 => _44.trim, 'call', _45 => _45(), 'access', _46 => _46.toLowerCase, 'call', _47 => _47()]), () => ( ""));
   return mediaType.startsWith("application/json") || mediaType.endsWith("+json");
 }
 function bodySnippet(text, redactPersonalData) {
@@ -16578,129 +15890,16 @@ function bodySnippet(text, redactPersonalData) {
   return redactResponseBody(bytes, { redactPersonalData });
 }
 
-// src/http/breaker-budget.ts
-function cooldownRefusal(store, tenantKey, ctx) {
-  const deadline = store.get(tenantKey);
-  if (deadline === void 0) return void 0;
-  const remainingMs = deadline - Date.now();
-  if (remainingMs > 0) {
-    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.`,
-      {
-        ...ctx,
-        code: "RATE_LIMITED_COOLDOWN",
-        retryable: false,
-        suggestedAction: `Wait ${seconds}s (per-tenant 429 cooldown) and retry with a narrower query; the call was not sent and consumed no vendor budget.`
-      }
-    );
-    err.retryAfter = seconds;
-    err.notSent = true;
-    return err;
-  }
-  store.delete(tenantKey);
-  return void 0;
-}
-function evaluateBreakerGate(breaker, key, ctx) {
-  const now = Date.now();
-  const st = breaker.store.get(key);
-  if (st !== void 0 && st.openedAt !== null) {
-    const openUntil = st.openedAt + breaker.openTimeoutMs;
-    if (now < openUntil) {
-      const remainingMs = openUntil - now;
-      const seconds = Math.ceil(remainingMs / 1e3);
-      const err = new CircuitBreakerError(
-        `The circuit breaker for ${key} is open; the call was NOT sent. ${seconds}s remain \u2014 retry the same call after the wait (a host-scoped vendor fault, not the request).`,
-        {
-          ...ctx,
-          details: { state: "open", retryAfterMs: remainingMs, failureCount: st.failures.length },
-          suggestedAction: `Wait ${seconds}s (the circuit is open for ${key}) and retry the SAME call; the call was not sent and consumed no vendor budget.`
-        }
-      );
-      err.retryAfter = seconds;
-      err.notSent = true;
-      return { refusal: err };
-    }
-    if (st.probes >= breaker.halfOpenProbes) {
-      const err = new CircuitBreakerError(
-        `The circuit breaker for ${key} is half-open and its probes are in flight; the call was NOT sent \u2014 retry once a probe settles.`,
-        {
-          ...ctx,
-          details: { state: "half-open", retryAfterMs: 0, failureCount: st.failures.length },
-          suggestedAction: "A half-open probe is settling; retry shortly \u2014 the call was not sent and consumed no vendor budget."
-        }
-      );
-      err.notSent = true;
-      return { refusal: err };
-    }
-    const admitted = { ...st, probes: st.probes + 1 };
-    breaker.store.set(key, admitted);
-    return { probe: true, probeWindow: _nullishCoalesce(admitted.windowOpenedAt, () => ( void 0)) };
-  }
-  return { probe: false };
-}
-function recordSuccess(breaker, key, probe, probeWindow, logger) {
-  const st = breaker.store.get(key);
-  if (st === void 0 || st.openedAt === null) return;
-  if (probe && probeWindow !== void 0 && st.windowOpenedAt !== probeWindow) return;
-  const next = {
-    failures: st.failures,
-    openedAt: st.openedAt,
-    successes: st.successes + 1,
-    probes: probe ? Math.max(0, st.probes - 1) : st.probes,
-    windowOpenedAt: st.windowOpenedAt
-    // a success never moves the window identity
-  };
-  if (next.successes >= breaker.successesToClose) {
-    breaker.store.delete(key);
-    _optionalChain([logger, 'access', _67 => _67.warn, 'optionalCall', _68 => _68(
-      `[autotask] circuit breaker CLOSED for ${key} (${next.successes} probe successes)`,
-      void 0
-    )]);
-    return;
-  }
-  breaker.store.set(key, next);
-}
-function recordFailure(breaker, key, probe, probeWindow, logger, correlationId) {
-  const now = Date.now();
-  const st = _nullishCoalesce(breaker.store.get(key), () => ( { failures: [], openedAt: null, successes: 0, probes: 0, windowOpenedAt: null }));
-  if (probe && probeWindow !== void 0 && st.openedAt !== null && st.windowOpenedAt !== probeWindow) return;
-  if (st.openedAt === null) {
-    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, windowOpenedAt: now });
-      _optionalChain([logger, 'access', _69 => _69.warn, 'optionalCall', _70 => _70(
-        `[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
-      )]);
-      return;
-    }
-    breaker.store.set(key, { ...st, failures });
-    return;
-  }
-  breaker.store.set(key, {
-    failures: st.failures,
-    openedAt: now,
-    successes: 0,
-    probes: probe ? Math.max(0, st.probes - 1) : st.probes,
-    windowOpenedAt: st.windowOpenedAt
-  });
-}
-function settleProbe(breaker, key, probeWindow) {
-  const st = breaker.store.get(key);
-  if (st === void 0 || st.openedAt === null || st.probes === 0) return;
-  if (probeWindow !== void 0 && st.windowOpenedAt !== probeWindow) return;
-  breaker.store.set(key, { ...st, probes: st.probes - 1 });
-}
-var HourlyBudget = (_class7 = class {
-  constructor(perHour, profile) {;_class7.prototype.__init12.call(this);
+// src/http/limits.ts
+var HourlyBudget = (_class2 = class {
+  constructor(perHour, profile) {;_class2.prototype.__init4.call(this);
     this.perHour = perHour;
     this.profile = profile;
   }
   
   
   /** Request timestamps inside the trailing hour. */
-  __init12() {this.stamps = []}
+  __init4() {this.stamps = []}
   prune(now) {
     while (this.stamps.length > 0 && this.stamps[0] <= now - HOUR_MS) this.stamps.shift();
   }
@@ -16729,14 +15928,14 @@ var HourlyBudget = (_class7 = class {
       await sleep(waitMs, signal);
     }
   }
-}, _class7);
-var Semaphore = (_class8 = class {
-  constructor(maxConcurrent) {;_class8.prototype.__init13.call(this);_class8.prototype.__init14.call(this);
+}, _class2);
+var Semaphore = (_class3 = class {
+  constructor(maxConcurrent) {;_class3.prototype.__init5.call(this);_class3.prototype.__init6.call(this);
     this.maxConcurrent = maxConcurrent;
   }
   
-  __init13() {this.inFlight = 0}
-  __init14() {this.waitQueue = []}
+  __init5() {this.inFlight = 0}
+  __init6() {this.waitQueue = []}
   acquire() {
     if (this.inFlight < this.maxConcurrent) {
       this.inFlight += 1;
@@ -16754,7 +15953,7 @@ var Semaphore = (_class8 = class {
     const next = this.waitQueue.shift();
     if (next !== void 0) next();
   }
-}, _class8);
+}, _class3);
 
 // src/http/credentials.ts
 var CREDENTIAL_HEADER_NAMES2 = /* @__PURE__ */ new Set([
@@ -16831,7 +16030,7 @@ async function discoverZoneBase(userName, maxResponseBytes, signal, ctx) {
     return void 0;
   }
   if (res.status < 200 || res.status >= 300) {
-    await _optionalChain([res, 'access', _71 => _71.body, 'optionalAccess', _72 => _72.cancel, 'call', _73 => _73(), 'access', _74 => _74.catch, 'call', _75 => _75(() => void 0)]);
+    await _optionalChain([res, 'access', _48 => _48.body, 'optionalAccess', _49 => _49.cancel, 'call', _50 => _50(), 'access', _51 => _51.catch, 'call', _52 => _52(() => void 0)]);
     return void 0;
   }
   let text;
@@ -16878,16 +16077,9 @@ var HttpClient = class {
   
   /** Bounded client-scan caps for resolution (section 19.2; per-client). */
   
-  /** Single-record read cache (issue #80: the default instance when `cache` is absent; undefined only when the user set `false` explicitly). */
-  
-  /** Field-metadata cache for the entityInformation trio (issue #80: the default instance when `fieldCache` is absent; undefined only when the user set `false` explicitly). */
+  /** Record-read cache (absent only for `cache: false`; issue #286). */
   
-  /** Resource-name cache for `operations.expandResourceNames` (issue #80: the default instance when `resourceNameCache` is absent; undefined only when the user set `false` explicitly, issue #65). */
-  
-  /** The `latest` walk's count-probe cache (issue #127: the short-TTL
-   * per-client count cache — ALWAYS on, process-internal: no config
-   * surface, no served keys; the plain `count` op and `operations.aggregate`
-   * bypass it by construction and promise fresh totals). */
+  /** Field-metadata cache for the entityInformation trio (absent only for `cache: false`). */
   
   /** Resolved update fallback gate (issue #34; OFF by default). */
   
@@ -16901,7 +16093,7 @@ var HttpClient = class {
   
   /** FIFO semaphore bounding in-flight requests to `maxConcurrent`. */
   
-  /** Tenant 429 cooldown gate store (undefined when the gate is disabled). */
+  /** Tenant 429 cooldown gate (issue #6; ON by default). */
   
   
   
@@ -16921,17 +16113,8 @@ var HttpClient = class {
    * Gates the issue-#43 re-point target: a refused host is a discovery
    * fault (the original 401 propagates byte-identically, zero wire). */
   
-  /** The gate key for this client's tenant (lowercased userName + host).
-   * Re-derived on a zone re-point (issue #43 — the re-pointed host starts
-   * with fresh per-host state). */
-  
-  /** The host circuit breaker settings (issue #26; undefined when the
-   * breaker is off — the default, in which case the gate/recording sites
-   * are skipped and no store entry is ever written). */
+  /** The cooldown key (`user@host`) and the maintenance-gate key (host); re-derived on a zone re-point (issue #43). */
   
-  /** The breaker key for this client's host (lowercased host of the base
-   * URL — host-only: vendor health is host-scoped, issue #26). Re-derived
-   * on a zone re-point (issue #43). */
   
   
   /** Response redaction policy (the INV-A1 hotfix; PII/CONFIDENTIAL default on, SECRET always).
@@ -16949,8 +16132,6 @@ var HttpClient = class {
     this.resolution = config.resolution;
     this.readCache = config.readCache;
     this.fieldCache = config.fieldCache;
-    this.resourceNameCache = config.resourceNameCache;
-    this.latestCountCache = new LatestCountCache(LATEST_COUNT_CACHE_TTL_MS);
     this.update = config.update;
     this.zone = config.zone;
     this.reResolveZoneOn401 = config.reResolveZoneOn401;
@@ -16966,21 +16147,12 @@ var HttpClient = class {
     this.maintenanceMaxWaitMs = config.maintenanceMaxWaitMs;
     this.maintenancePollMs = config.maintenancePollMs;
     this.maxResponseBytes = config.maxResponseBytes;
-    this.hourly = _optionalChain([config, 'access', _76 => _76.rateLimit, 'optionalAccess', _77 => _77.perHour]) === void 0 ? void 0 : new HourlyBudget(config.rateLimit.perHour, config.profile);
-    this.tenantKey = buildTenantKey(config.userName, config.baseUrl);
-    this.cooldownStore = config.cooldown.enabled ? _nullishCoalesce(config.cooldown.store, () => ( defaultCooldownStore())) : void 0;
+    this.hourly = _optionalChain([config, 'access', _53 => _53.rateLimit, 'optionalAccess', _54 => _54.perHour]) === void 0 ? void 0 : new HourlyBudget(config.rateLimit.perHour, config.profile);
+    this.tenantKey = tenantKey(config.userName, config.baseUrl);
+    this.hostKey = hostKey(config.baseUrl);
+    this.cooldownEnabled = config.cooldown.enabled;
     this.cooldownMaxMs = config.cooldown.maxMs;
     this.cooldownDefaultMs = config.cooldown.defaultMs;
-    this.breakerKey = buildBreakerKey(config.baseUrl);
-    this.breaker = config.circuitBreaker.enabled ? {
-      failureWindowMs: config.circuitBreaker.failureWindowMs,
-      failureThreshold: config.circuitBreaker.failureThreshold,
-      openTimeoutMs: config.circuitBreaker.openTimeoutMs,
-      successesToClose: config.circuitBreaker.successesToClose,
-      halfOpenProbes: config.circuitBreaker.halfOpenProbes,
-      store: _nullishCoalesce(config.circuitBreaker.store, () => ( defaultCircuitBreakerStore())),
-      isFailure: _nullishCoalesce(config.circuitBreaker.isFailure, () => ( isBreakerFailure))
-    } : void 0;
     this.maxConcurrent = config.maxConcurrent;
     this.semaphore = new Semaphore(config.maxConcurrent);
     this.timeoutMs = config.timeoutMs;
@@ -16996,7 +16168,7 @@ var HttpClient = class {
    * `thresholdInformation.get()`.
    */
   hourlyBudget() {
-    return _optionalChain([this, 'access', _78 => _78.hourly, 'optionalAccess', _79 => _79.snapshot, 'call', _80 => _80()]);
+    return _optionalChain([this, 'access', _55 => _55.hourly, 'optionalAccess', _56 => _56.snapshot, 'call', _57 => _57()]);
   }
   /**
    * One audit event per settled request (section 19.3): the correlation id,
@@ -17012,11 +16184,9 @@ var HttpClient = class {
   }
   /**
    * Issue #43: re-point the client to the tenant's newly resolved zone
-   * base. The transport's PER-HOST state is RE-DERIVED, so the re-pointed
-   * host starts FRESH: no cooldown/breaker/tenant-rate inheritance from
-   * the stale host (conservative — the stale host's armed entries stay in
-   * the shared stores for the other clients that still talk to it; nothing
-   * is copied across). The configured base (config.baseUrl) is untouched;
+   * base. The gate keys are RE-DERIVED, so the re-pointed host starts
+   * fresh: no cooldown/maintenance inheritance from the stale host (its
+   * entries stay for the other clients that still talk to it). The configured base (config.baseUrl) is untouched;
    * the LIVE base is `baseUrl` (the getter over liveBaseUrl), and the
    * re-point is logged (a transport fact — the success path is unchanged,
    * no envelope change).
@@ -17024,58 +16194,18 @@ var HttpClient = class {
   repointZoneBase(to) {
     const from = this.liveBaseUrl;
     this.liveBaseUrl = to;
-    this.tenantKey = buildTenantKey(this.auth.userName, to);
-    this.breakerKey = buildBreakerKey(to);
-    _optionalChain([this, 'access', _81 => _81.logger, 'access', _82 => _82.warn, 'optionalCall', _83 => _83(
+    this.tenantKey = tenantKey(this.auth.userName, to);
+    this.hostKey = hostKey(to);
+    _optionalChain([this, 'access', _58 => _58.logger, 'access', _59 => _59.warn, 'optionalCall', _60 => _60(
       `[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
     )]);
   }
-  /**
-   * Breaker success recording (issue #26). A probe admitted on one host must
-   * never record onto another: if the call re-pointed (issue #43) the
-   * outcome was measured on a different host — void the probe (the admitted
-   * budget on the original host dangles for the rest of the open period;
-   * bounded, conservative, nothing crosses hosts).
-   */
-  recordBreakerSuccess(s) {
-    const { breakerProbe: probe, breakerProbeKey: probeKey, breakerProbeWindow: probeWindow } = s;
-    const breaker = this.breaker;
-    if (breaker === void 0) return;
-    if (probe && (probeKey === void 0 || probeKey !== this.breakerKey)) return;
-    recordSuccess(breaker, probe && probeKey !== void 0 ? probeKey : this.breakerKey, probe, probeWindow, this.logger);
-  }
-  /** Breaker failure recording (issue #26); same host-pinning as the success recorder (issue #43). */
-  recordBreakerFailure(s) {
-    const { breakerProbe: probe, breakerProbeKey: probeKey, breakerProbeWindow: probeWindow, correlationId } = s;
-    const breaker = this.breaker;
-    if (breaker === void 0) return;
-    if (probe && (probeKey === void 0 || probeKey !== this.breakerKey)) return;
-    recordFailure(breaker, probe && probeKey !== void 0 ? probeKey : this.breakerKey, probe, probeWindow, this.logger, correlationId);
-  }
-  /**
-   * Breaker probe settlement for a NON-COUNTED outcome (issue #262): the
-   * failure predicate said the outcome is not a service failure (any 4xx,
-   * ABORTED, EMPTY_RESPONSE, INVALID_RESPONSE, REDIRECT_BLOCKED, the
-   * deterministic validation 500), so nothing is counted and the open
-   * period is NOT re-armed — but the probe SETTLED, so its admitted
-   * half-open slot is released (the contract in `circuit-breaker.ts`: every
-   * probe completion decrements `probes`). Same host-pinning as the
-   * recorders (issue #43): a re-pointed probe is voided, never settled
-   * cross-host.
-   */
-  settleBreakerProbe(s) {
-    const { breakerProbe: probe, breakerProbeKey: probeKey, breakerProbeWindow: probeWindow } = s;
-    const breaker = this.breaker;
-    if (breaker === void 0 || !probe) return;
-    if (probeKey === void 0 || probeKey !== this.breakerKey) return;
-    settleProbe(breaker, probeKey, probeWindow);
-  }
   // ---- per-call helpers ---------------------------------------------------
   /** The caller's signal wins over the deadline when both fired. */
   interrupted(s) {
     const { method, opts, ctx } = s;
-    return _optionalChain([s, 'access', _84 => _84.callerSignal, 'optionalAccess', _85 => _85.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 ${s.timeoutMs}ms: ${method} ${opts.path}`, ctx);
+    return _optionalChain([s, 'access', _61 => _61.callerSignal, 'optionalAccess', _62 => _62.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 ${s.timeoutMs}ms: ${method} ${opts.path}`, ctx);
   }
   /** A retry only runs when its wait fits inside what is left of the call budget. */
   canWait(s, delay) {
@@ -17096,7 +16226,7 @@ var HttpClient = class {
   /** If the retry's wait fits the budget: log, count the attempt, pause, and report true (loop again). */
   async retryAfterDelay(s, delay, what) {
     if (!this.canWait(s, delay)) return false;
-    _optionalChain([this, 'access', _86 => _86.logger, 'access', _87 => _87.warn, 'optionalCall', _88 => _88(
+    _optionalChain([this, 'access', _63 => _63.logger, 'access', _64 => _64.warn, 'optionalCall', _65 => _65(
       `[autotask] ${what}; retrying in ${delay}ms (attempt ${s.attempt + 1}/${s.maxRetries})`,
       s.correlationId
     )]);
@@ -17109,10 +16239,18 @@ var HttpClient = class {
    * `maintenanceMaxWaitMs` from the FIRST such response (one budget shared
    * by the 2xx-page and any-status sites), polling `maintenancePollMs`, a
    * fresh per-attempt deadline after each wait; does not consume
-   * `maxRetries`. True when a wait happened (loop again); false when the
-   * budget is spent (`maintenanceBudgetSpent` is set).
+   * `maxRetries`. Only the call that owns the zone's probe slot waits (one
+   * prober per zone); any other call gets false at once. True when a wait
+   * happened (loop again); false when the budget is spent
+   * (`maintenanceBudgetSpent` is set) or another call owns the slot.
    */
   async waitOutMaintenance(s, statusLabel) {
+    if (s.maintenanceMaxWaitMs <= 0) return false;
+    if (s.maintenanceProbe === void 0) {
+      const gate = claimMaintenanceProbe(this.hostKey);
+      if (gate === void 0) return false;
+      s.maintenanceProbe = { host: this.hostKey, gate };
+    }
     const now = Date.now();
     s.firstMaintenanceAt ??= now;
     const remaining = s.maintenanceMaxWaitMs - (now - s.firstMaintenanceAt);
@@ -17120,7 +16258,7 @@ var HttpClient = class {
       const wait = Math.min(s.maintenancePollMs, remaining);
       if (wait >= remaining) s.maintenanceBudgetSpent = true;
       s.maintenanceWaits += 1;
-      _optionalChain([this, 'access', _89 => _89.logger, 'access', _90 => _90.warn, 'optionalCall', _91 => _91(
+      _optionalChain([this, 'access', _66 => _66.logger, 'access', _67 => _67.warn, 'optionalCall', _68 => _68(
         `[autotask] maintenance window on ${s.method} ${s.opts.path}${statusLabel}; waiting ${Math.round(wait / 1e3)}s (retry ${s.maintenanceWaits}, up to ${Math.round(s.maintenanceMaxWaitMs / 6e4)} min)`,
         s.correlationId
       )]);
@@ -17148,6 +16286,41 @@ var HttpClient = class {
       err.suggestedAction = maintenanceExhaustedAction(s.maintenanceMaxWaitMs, s.maintenanceWaits);
     }
   }
+  /**
+   * Issue #285: the call itself received the maintenance page and will not
+   * (or may not) wait it out — the same typed `MAINTENANCE` the gate's
+   * refusals carry, so a consumer maps one code. Unlike a refusal the call
+   * WAS sent (`httpStatus` set, no `notSent`). A mutation answered at a
+   * non-2xx status (review F1) is not retryable: a proxy can serve that page
+   * after forwarding the write, so the outcome is unknown.
+   */
+  maintenancePageError(s, status, contentType, text) {
+    const { method, opts, ctx } = s;
+    const since = new Date(_nullishCoalesce(maintenanceSince(this.hostKey), () => ( Date.now()))).toISOString();
+    const unknownWrite = (status < 200 || status >= 300) && !s.retriable5xx;
+    const err = new MaintenanceError(
+      `Zone ${this.hostKey} answered ${method} ${opts.path} with its maintenance page (HTTP ${status}; window since ${since})`,
+      {
+        ...ctx,
+        httpStatus: status,
+        retryable: !unknownWrite,
+        details: {
+          since,
+          retryAfterMs: s.maintenancePollMs,
+          httpStatus: status,
+          contentType,
+          bodySnippet: bodySnippet(text, this.redactPersonalData),
+          maintenanceDetected: true
+        },
+        suggestedAction: unknownWrite ? `A maintenance-shaped page answered ${method} ${opts.path} (HTTP ${status}); it was NOT waited out or re-sent \u2014 a non-2xx edge page can arrive after the request was forwarded, so verify the record before re-issuing (only a GET or an explicitly idempotent-flagged call waits this window out).` : `The Autotask zone is in its maintenance window (since ${since}); retry after the window (windows usually last 30-90 min).`
+      }
+    );
+    err.retryAfter = Math.max(1, Math.ceil(s.maintenancePollMs / 1e3));
+    const action = err.suggestedAction;
+    this.stampMaintenance(s, err);
+    if (unknownWrite) err.suggestedAction = action;
+    return err;
+  }
   // ---- pre-send gates -----------------------------------------------------
   auditNotSent(s, errorCode) {
     this.emitAudit({
@@ -17162,39 +16335,23 @@ var HttpClient = class {
     });
   }
   /**
-   * Tenant 429 cooldown gate (issue #6): a 429 armed the gate for this
-   * tenant — fail LOCALLY (before the semaphore, the hourly limiter and
-   * fetch: zero upstream calls) until the deadline passes.
-   */
-  gateCooldown(s) {
-    if (this.cooldownStore === void 0 || s.opts.bypassCooldown) return;
-    const err = cooldownRefusal(this.cooldownStore, this.tenantKey, s.ctx);
-    if (err === void 0) return;
-    if (_optionalChain([s, 'access', _92 => _92.callerSignal, 'optionalAccess', _93 => _93.aborted])) throw this.interrupted(s);
-    this.auditNotSent(s, "RATE_LIMITED_COOLDOWN");
-    throw err;
-  }
-  /**
-   * Host circuit breaker gate (issue #26): the SAME pre-send slot as the
-   * #6 cooldown gate (cooldown first): OUTSIDE the retry loop, before the
-   * hourly limiter, the semaphore and fetch — a refusal makes zero fetches,
-   * consumes no hourly stamp and no concurrency slot.
-   * `thresholdInformation.get()` bypasses the REFUSAL
-   * (`bypassCircuitBreaker`) but its outcome is still recorded.
+   * The pre-send gates (OUTSIDE the retry loop, before the hourly limiter,
+   * the semaphore and fetch: a refusal makes zero fetches). The tenant 429
+   * cooldown (issue #6; `thresholdInformation.get()` bypasses it), then the
+   * zone maintenance gate (issue #285), which admits one probe per poll
+   * interval while open. An already-aborted caller still gets the abort error.
    */
-  gateBreaker(s) {
-    if (this.breaker === void 0 || s.opts.bypassCircuitBreaker) return;
-    if (_optionalChain([s, 'access', _94 => _94.callerSignal, 'optionalAccess', _95 => _95.aborted])) throw this.interrupted(s);
-    const verdict = evaluateBreakerGate(this.breaker, this.breakerKey, s.ctx);
-    if (verdict.refusal !== void 0) {
-      this.auditNotSent(s, "CIRCUIT_BREAKER_OPEN");
-      throw verdict.refusal;
-    }
-    if (verdict.probe) {
-      s.breakerProbe = true;
-      s.breakerProbeKey = this.breakerKey;
-      s.breakerProbeWindow = verdict.probeWindow;
+  gate(s) {
+    const cooldown = this.cooldownEnabled && !s.opts.bypassCooldown ? cooldownRefusal(this.tenantKey, s.ctx) : void 0;
+    const verdict = _nullishCoalesce(cooldown, () => ( admitMaintenance(this.hostKey, s.ctx)));
+    if (verdict === "send") return;
+    if (!(verdict instanceof AutotaskError)) {
+      s.maintenanceProbe = { host: this.hostKey, gate: verdict };
+      return;
     }
+    if (_optionalChain([s, 'access', _69 => _69.callerSignal, 'optionalAccess', _70 => _70.aborted])) throw this.interrupted(s);
+    this.auditNotSent(s, verdict.code);
+    throw verdict;
   }
   // ---- the attempt --------------------------------------------------------
   /**
@@ -17205,7 +16362,7 @@ var HttpClient = class {
   async sendOnce(s) {
     const { method, opts, ctx } = s;
     try {
-      await _optionalChain([this, 'access', _96 => _96.hourly, 'optionalAccess', _97 => _97.take, 'call', _98 => _98(s.deadlineAt, s.signal, ctx)]);
+      await _optionalChain([this, 'access', _71 => _71.hourly, 'optionalAccess', _72 => _72.take, 'call', _73 => _73(s.deadlineAt, s.signal, ctx)]);
     } catch (err) {
       if (s.signal.aborted) throw this.interrupted(s);
       throw err;
@@ -17231,7 +16388,7 @@ var HttpClient = class {
     try {
       status = res.status;
       if (status >= 300 && status < 400) {
-        await _optionalChain([res, 'access', _99 => _99.body, 'optionalAccess', _100 => _100.cancel, 'call', _101 => _101(), 'access', _102 => _102.catch, 'call', _103 => _103(() => 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)]);
         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." }
@@ -17254,7 +16411,7 @@ var HttpClient = class {
   /** Classify a 2xx: empty body, JSON (redacted), or a non-JSON page (maintenance wait / retry / typed error). */
   async handleSuccess(s, res, status, text) {
     const { method, opts, ctx } = s;
-    if (this.cooldownStore !== void 0) this.cooldownStore.delete(this.tenantKey);
+    if (this.cooldownEnabled) clearCooldown(this.tenantKey);
     if (text.length === 0) {
       if (s.expectBody) {
         const err = new EmptyResponseError(`Empty ${status} response for ${method} ${opts.path}`, {
@@ -17305,19 +16462,19 @@ var HttpClient = class {
       httpStatus: status,
       suggestedAction: "The zone returned a non-JSON 2xx body; verify baseUrl points at the REST API."
     });
-    if (err.code === "UNEXPECTED_CONTENT_TYPE" && s.maintenanceMaxWaitMs > 0 && looksLikeMaintenanceText(text)) {
+    if (s.maintenancePage) {
       if (await this.waitOutMaintenance(s, "")) return RETRY;
-    }
-    if (err.code === "UNEXPECTED_CONTENT_TYPE" && retriable5xx && s.attempt < s.maxRetries) {
+      throw this.maintenancePageError(s, status, res.headers.get("Content-Type"), text);
+    } else if (err.code === "UNEXPECTED_CONTENT_TYPE" && retriable5xx && s.attempt < s.maxRetries) {
       const retryAfter = parseRetryAfter(res.headers.get("Retry-After"));
       const delay = retryAfter !== void 0 ? retryAfter * 1e3 : backoffDelay(s.attempt);
       if (await this.retryAfterDelay(s, delay, `non-JSON 2xx on ${method} ${opts.path}`)) return RETRY;
     }
-    const pageSnippet = typeof _optionalChain([err, 'access', _104 => _104.details, 'optionalAccess', _105 => _105.bodySnippet]) === "string" ? err.details.bodySnippet : "";
+    const pageSnippet = typeof _optionalChain([err, 'access', _79 => _79.details, 'optionalAccess', _80 => _80.bodySnippet]) === "string" ? err.details.bodySnippet : "";
     this.stampMaintenance(s, err);
-    if (err.code === "UNEXPECTED_CONTENT_TYPE" && !looksLikeMaintenanceText(text) && isHtmlLike(res.headers.get("Content-Type"), text)) {
+    if (err.code === "UNEXPECTED_CONTENT_TYPE" && !s.maintenancePage && isHtmlLike(res.headers.get("Content-Type"), text)) {
       err.details = { ..._nullishCoalesce(err.details, () => ( {})), maintenancePatternMiss: true };
-      _optionalChain([this, 'access', _106 => _106.logger, 'access', _107 => _107.debug, 'optionalCall', _108 => _108(
+      _optionalChain([this, 'access', _81 => _81.logger, 'access', _82 => _82.debug, 'optionalCall', _83 => _83(
         `[autotask] non-JSON body did not match the maintenance vocabulary on ${method} ${opts.path}: ${pageSnippet}`,
         s.correlationId
       )]);
@@ -17343,15 +16500,15 @@ var HttpClient = class {
       }
     }
     const nonJsonSnippet = nonJsonBody === void 0 ? void 0 : bodySnippet(nonJsonBody, this.redactPersonalData);
-    const nonJsonIsMaintenance = nonJsonBody !== void 0 && looksLikeMaintenanceText(nonJsonBody);
+    const nonJsonIsMaintenance = s.maintenancePage;
     const nonJsonIsHtmlCandidate = nonJsonBody !== void 0 && isHtmlLike(res.headers.get("Content-Type"), nonJsonBody);
-    const nonJsonMaintenanceMayWait = nonJsonIsMaintenance && s.retriable5xx;
-    if (nonJsonBody !== void 0 && s.maintenanceMaxWaitMs > 0 && nonJsonMaintenanceMayWait) {
-      if (await this.waitOutMaintenance(s, ` (HTTP ${status})`)) return RETRY;
+    if (nonJsonIsMaintenance) {
+      if (s.retriable5xx && await this.waitOutMaintenance(s, ` (HTTP ${status})`)) return RETRY;
+      throw this.maintenancePageError(s, status, res.headers.get("Content-Type"), text);
     }
     const deterministic500 = status >= 500 && isDeterministicVendor500(parseVendorErrors(body));
     const retryableStatus = status === 429 || status >= 500;
-    if (retryableStatus && !deterministic500 && s.attempt < s.maxRetries && (status === 429 ? s.retriable : s.retriable5xx)) {
+    if (retryableStatus && !deterministic500 && !nonJsonIsMaintenance && s.attempt < s.maxRetries && (status === 429 ? s.retriable : s.retriable5xx)) {
       const retryAfter = parseRetryAfter(res.headers.get("Retry-After"));
       const delay = retryAfter !== void 0 ? retryAfter * 1e3 : backoffDelay(s.attempt);
       if (await this.retryAfterDelay(s, delay, `${status} on ${method} ${opts.path}`)) return RETRY;
@@ -17360,7 +16517,7 @@ var HttpClient = class {
       const target = await discoverZoneBase(this.userName, this.maxResponseBytes, s.signal, s.ctx);
       const targetViolation = target === void 0 || this.hostPolicy === void 0 ? null : decideHostPolicy(target, this.hostPolicy);
       if (targetViolation !== null) {
-        _optionalChain([this, 'access', _109 => _109.logger, 'access', _110 => _110.warn, 'optionalCall', _111 => _111(
+        _optionalChain([this, 'access', _84 => _84.logger, 'access', _85 => _85.warn, 'optionalCall', _86 => _86(
           `[autotask] zone re-point refused by hostPolicy (${targetViolation.bound}): ${targetViolation.origin} \u2014 the original 401 propagates, zero wire to the refused host`,
           void 0
         )]);
@@ -17384,12 +16541,9 @@ var HttpClient = class {
     err.correlationId = s.correlationId;
     this.stampMaintenance(s, err);
     if (nonJsonBody !== void 0) {
-      if (nonJsonIsMaintenance && !s.retriable5xx) {
-        err.details = { ..._nullishCoalesce(err.details, () => ( {})), maintenanceDetected: true };
-        err.suggestedAction = `A maintenance-shaped page answered ${method} ${opts.path} (HTTP ${status}); it was NOT waited out or re-sent \u2014 a non-2xx edge page can arrive after the request was forwarded, so verify the record before re-issuing (only a GET or an explicitly idempotent-flagged call waits this window out).`;
-      } else if (!nonJsonIsMaintenance && nonJsonIsHtmlCandidate) {
+      if (nonJsonIsHtmlCandidate) {
         err.details = { ..._nullishCoalesce(err.details, () => ( {})), maintenancePatternMiss: true };
-        _optionalChain([this, 'access', _112 => _112.logger, 'access', _113 => _113.debug, 'optionalCall', _114 => _114(
+        _optionalChain([this, 'access', _87 => _87.logger, 'access', _88 => _88.debug, 'optionalCall', _89 => _89(
           `[autotask] non-JSON body did not match the maintenance vocabulary on ${method} ${opts.path}: ${nonJsonSnippet}`,
           s.correlationId
         )]);
@@ -17403,15 +16557,15 @@ var HttpClient = class {
     }
     attachEmptyReasonDetails(err);
     if (err instanceof RateLimitError && retryAfterSecs !== void 0) err.retryAfter = retryAfterSecs;
-    if (status === 429 && this.cooldownStore !== void 0) {
+    if (status === 429 && this.cooldownEnabled) {
       const threadThreshold = err.code.toLowerCase() === "itgenatr005";
       const durationMs = cooldownDurationMs(retryAfterSecs, {
         maxMs: this.cooldownMaxMs,
         defaultMs: this.cooldownDefaultMs,
         threadThreshold
       });
-      this.cooldownStore.set(this.tenantKey, Date.now() + durationMs);
-      _optionalChain([this, 'access', _115 => _115.logger, 'access', _116 => _116.warn, 'optionalCall', _117 => _117(
+      armCooldown(this.tenantKey, Date.now() + durationMs);
+      _optionalChain([this, 'access', _90 => _90.logger, 'access', _91 => _91.warn, 'optionalCall', _92 => _92(
         `[autotask] 429 on ${method} ${opts.path} surfaces after ${s.attempt + 1} attempt(s); tenant cooldown armed for ${Math.round(durationMs / 1e3)}s`,
         s.correlationId
       )]);
@@ -17429,25 +16583,9 @@ var HttpClient = class {
       durationMs: Date.now() - s.started,
       body: s.auditBody
     });
-    if (this.breaker !== void 0) {
-      try {
-        this.recordBreakerSuccess(s);
-      } catch (e14) {
-      }
-    }
   }
   onFailure(s, err) {
     const { opts } = s;
-    if (this.breaker !== void 0 && err instanceof AutotaskError && err.notSent !== true) {
-      try {
-        if (this.breaker.isFailure(err)) {
-          this.recordBreakerFailure(s);
-        } else if (s.breakerProbe) {
-          this.settleBreakerProbe(s);
-        }
-      } catch (e15) {
-      }
-    }
     this.emitAudit({
       correlationId: s.correlationId,
       operation: opts.operation,
@@ -17461,23 +16599,17 @@ var HttpClient = 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', _118 => _118.details, 'optionalAccess', _119 => _119.deterministic]) === true || err.code === "INVALID_RESPONSE" && META_TRIO_VERBS.has(verb);
+      const drift = _optionalChain([err, 'access', _93 => _93.details, 'optionalAccess', _94 => _94.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));
+        if (dot > 0) this.fieldCache.invalidate(`${op.slice(0, dot)}:`);
       }
     }
   }
   /** A real write (even a failed one — it may have partly applied) voids cached reads. */
   invalidateAfterWrite(opts) {
     if (opts.method === "GET" || opts.idempotent === true && /\/query(\/|\?|$)/.test(opts.path)) return;
-    _optionalChain([this, 'access', _120 => _120.readCache, 'optionalAccess', _121 => _121.clear, 'call', _122 => _122()]);
-    this.latestCountCache.clear();
-    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") {
-      this.resourceNameCache.clear();
-    }
+    _optionalChain([this, 'access', _95 => _95.readCache, 'optionalAccess', _96 => _96.clear, 'call', _97 => _97()]);
   }
   /**
    * One request: build URL/headers, apply the whole-call deadline, retry
@@ -17544,22 +16676,23 @@ var HttpClient = class {
       lastStatus: void 0,
       zoneRetry: void 0,
       attempt: 0,
-      breakerProbe: false,
-      breakerProbeKey: void 0,
-      breakerProbeWindow: void 0,
+      maintenanceProbe: void 0,
+      maintenancePage: false,
       // Armed LAST in the literal: nothing after this can throw, and the single
       // try/finally below clears it on every exit path (#190).
       deadlineTimer: setTimeout(() => deadline.abort(), timeoutMs)
     };
     try {
-      this.gateCooldown(s);
-      this.gateBreaker(s);
-      _optionalChain([this, 'access', _123 => _123.logger, 'access', _124 => _124.debug, 'optionalCall', _125 => _125(`[autotask] ${method} ${opts.path}`, correlationId)]);
+      this.gate(s);
+      _optionalChain([this, 'access', _98 => _98.logger, 'access', _99 => _99.debug, 'optionalCall', _100 => _100(`[autotask] ${method} ${opts.path}`, correlationId)]);
       try {
         for (; ; ) {
           const sent = await this.sendOnce(s);
           if (sent.retry) continue;
           const { res, status, text } = sent;
+          s.maintenancePage = isMaintenancePage(status, res.headers.get("Content-Type"), text);
+          if (s.maintenancePage) openMaintenance(this.hostKey, s.maintenancePollMs, this.logger, correlationId);
+          else closeMaintenance(this.hostKey, this.logger, correlationId);
           const step = status >= 200 && status < 300 ? await this.handleSuccess(s, res, status, text) : await this.handleFailureStatus(s, res, status, text);
           if (step.done) {
             this.onSuccess(s, step.status);
@@ -17574,19 +16707,30 @@ var HttpClient = class {
       }
     } finally {
       clearTimeout(s.deadlineTimer);
+      if (s.maintenanceProbe !== void 0) releaseMaintenanceProbe(s.maintenanceProbe.host, s.maintenanceProbe.gate);
     }
   }
 };
+function isMaintenancePage(status, contentType, text) {
+  if (text.length === 0 || !looksLikeMaintenanceText(text)) return false;
+  if (status >= 200 && status < 300 && (contentType === null || contentType === "" || isJsonMediaType(contentType))) return false;
+  try {
+    JSON.parse(text);
+    return false;
+  } catch (e14) {
+    return true;
+  }
+}
 function assertNoQueryRelationLeaf(opts) {
   const operation = _nullishCoalesce(opts.operation, () => ( opts.path));
   const body = opts.body;
   if (body !== null && typeof body === "object") assertNoRelationLeaf(body.filter, operation);
-  const search = _optionalChain([opts, 'access', _126 => _126.query, 'optionalAccess', _127 => _127["search"]]);
+  const search = _optionalChain([opts, 'access', _101 => _101.query, 'optionalAccess', _102 => _102["search"]]);
   if (typeof search !== "string") return;
   let parsed;
   try {
     parsed = JSON.parse(search);
-  } catch (e16) {
+  } catch (e15) {
     return;
   }
   if (parsed !== null && typeof parsed === "object") assertNoRelationLeaf(parsed.filter, operation);
@@ -17594,23 +16738,23 @@ function assertNoQueryRelationLeaf(opts) {
 
 // src/operations/requiredFields.ts
 function effectiveRequiredFields(record, zoneFacts) {
-  const guidance = _optionalChain([zoneFacts, 'optionalAccess', _128 => _128.createGuidance]);
-  const prefix = _optionalChain([guidance, 'optionalAccess', _129 => _129.liveProvenPrefix]);
+  const guidance = _optionalChain([zoneFacts, 'optionalAccess', _103 => _103.createGuidance]);
+  const prefix = _optionalChain([guidance, 'optionalAccess', _104 => _104.liveProvenPrefix]);
   if (Array.isArray(prefix) && prefix.length > 0) {
-    const gates = _optionalChain([guidance, 'optionalAccess', _130 => _130.requiresByValue]);
+    const gates = _optionalChain([guidance, 'optionalAccess', _105 => _105.requiresByValue]);
     const gated = new Set((_nullishCoalesce(gates, () => ( []))).flatMap((g) => [..._nullishCoalesce(g.requires.allOf, () => ( [])), ..._nullishCoalesce(g.requires.anyOf, () => ( []))]));
     return {
       fields: prefix.filter((f) => !gated.has(f)),
       from: "live-proven",
-      unproven: _optionalChain([guidance, 'optionalAccess', _131 => _131.unproven]) === true,
+      unproven: _optionalChain([guidance, 'optionalAccess', _106 => _106.unproven]) === true,
       ...Array.isArray(gates) && gates.length > 0 ? { conditional: gates } : {}
     };
   }
-  const zoneSet = _optionalChain([zoneFacts, 'optionalAccess', _132 => _132.createRequiredSet]);
+  const zoneSet = _optionalChain([zoneFacts, 'optionalAccess', _107 => _107.createRequiredSet]);
   if (Array.isArray(zoneSet) && zoneSet.length > 0) {
-    return { fields: [...zoneSet], from: "zone", unproven: _optionalChain([guidance, 'optionalAccess', _133 => _133.unproven]) === true };
+    return { fields: [...zoneSet], from: "zone", unproven: _optionalChain([guidance, 'optionalAccess', _108 => _108.unproven]) === true };
   }
-  const spec = _optionalChain([record, 'optionalAccess', _134 => _134.requiredFields]);
+  const spec = _optionalChain([record, 'optionalAccess', _109 => _109.requiredFields]);
   return { fields: Array.isArray(spec) ? [...spec] : [], from: "spec", unproven: true };
 }
 
@@ -17694,25 +16838,178 @@ var FIELD_PRESETS = {
     ]
   }
 };
-var FIELD_PRESET_NAMES = Object.keys(FIELD_PRESETS);
-function resolveFieldsPreset(name, resourceKey, explicitIncludeFields) {
-  if (explicitIncludeFields !== void 0 && explicitIncludeFields !== null && explicitIncludeFields.length > 0) {
-    throw new AutotaskConfigError(
-      `fieldsPreset: "${name}" cannot be combined with an explicit includeFields \u2014 the bag is closed (pass ONE of the two: the preset name OR the field list)`
-    );
-  }
-  const preset = Object.hasOwn(FIELD_PRESETS, name) ? FIELD_PRESETS[name] : void 0;
-  if (preset === void 0) {
-    throw new AutotaskConfigError(
-      `fieldsPreset: unknown preset "${name}" \u2014 the preset list is closed (valid names: ${FIELD_PRESET_NAMES.join(", ")})`
-    );
-  }
-  if (preset.resource !== resourceKey) {
-    throw new AutotaskConfigError(
-      `fieldsPreset: "${name}" is a ${preset.resource} preset \u2014 it cannot be resolved on ${resourceKey} (the preset names its resource; the valid names are: ${FIELD_PRESET_NAMES.join(", ")})`
-    );
+var FIELD_PRESET_NAMES = Object.keys(FIELD_PRESETS);
+function resolveFieldsPreset(name, resourceKey, explicitIncludeFields) {
+  if (explicitIncludeFields !== void 0 && explicitIncludeFields !== null && explicitIncludeFields.length > 0) {
+    throw new AutotaskConfigError(
+      `fieldsPreset: "${name}" cannot be combined with an explicit includeFields \u2014 the bag is closed (pass ONE of the two: the preset name OR the field list)`
+    );
+  }
+  const preset = Object.hasOwn(FIELD_PRESETS, name) ? FIELD_PRESETS[name] : void 0;
+  if (preset === void 0) {
+    throw new AutotaskConfigError(
+      `fieldsPreset: unknown preset "${name}" \u2014 the preset list is closed (valid names: ${FIELD_PRESET_NAMES.join(", ")})`
+    );
+  }
+  if (preset.resource !== resourceKey) {
+    throw new AutotaskConfigError(
+      `fieldsPreset: "${name}" is a ${preset.resource} preset \u2014 it cannot be resolved on ${resourceKey} (the preset names its resource; the valid names are: ${FIELD_PRESET_NAMES.join(", ")})`
+    );
+  }
+  return [...preset.fields];
+}
+
+// src/resources/base/helpers.ts
+function describeResponseShape(body) {
+  if (body === null) return "null";
+  if (Array.isArray(body)) return `array(len=${body.length})`;
+  if (typeof body !== "object") return typeof body;
+  const rec = body;
+  const keys = Object.keys(rec).sort();
+  const typeOf = (v) => v === null ? "null" : Array.isArray(v) ? "array" : typeof v;
+  const parts = keys.slice(0, 16).map((k) => `${k}:${typeOf(rec[k])}`);
+  const more = keys.length > 16 ? `, +${keys.length - 16} more` : "";
+  return `{ ${parts.join(", ")}${more} }`;
+}
+function defaultMarkerToken(data) {
+  for (const field of ["name", "title"]) {
+    const v = data[field];
+    if (typeof v === "string" && v.trim() !== "") return v.trim();
+  }
+  return null;
+}
+var CONTEXT_ABSENT_MARKER = "#context-absent";
+function contextAbsentKey(path) {
+  return path + "\0context-absent";
+}
+function noteCharsTruncationMarker(charsRemoved) {
+  return `\u2026 [+${charsRemoved} chars truncated]`;
+}
+function truncateNoteChars(items, cap, fields) {
+  let truncated = 0;
+  const out = items.map((item) => {
+    if (!isRecord2(item)) return item;
+    let changed = false;
+    const copy = { ...item };
+    for (const field of fields) {
+      const v = copy[field];
+      if (typeof v === "string" && v.length > cap) {
+        const end = cap > 0 && (v.charCodeAt(cap - 1) & 64512) === 55296 ? cap - 1 : cap;
+        copy[field] = v.slice(0, end) + noteCharsTruncationMarker(v.length - end);
+        truncated += 1;
+        changed = true;
+      }
+    }
+    return changed ? copy : item;
+  });
+  return [out, truncated];
+}
+function blindEmptyReason(stamp) {
+  return {
+    surface: stamp.surface,
+    kind: "blind-surface",
+    note: stamp.note,
+    authority: stamp.authority,
+    remedy: "the note is the remedy \u2014 the authority op answers for a record"
+  };
+}
+function attachUpdateTargetMissReason(err, key) {
+  const pinned = _optionalChain([EMPTY_REASON_STAMPS, 'access', _110 => _110[key], 'optionalAccess', _111 => _111.update]);
+  if (pinned === void 0) return;
+  err.details = { ..._nullishCoalesce(err.details, () => ( {})), emptyReason: pinned };
+}
+function buildDryRunResult(spec, policy = { redactPersonalData: true }) {
+  if (spec.operation === "") {
+    throw new AutotaskConfigError("dry-run: the operation name is required");
+  }
+  const wouldApply = spec.checks.every((check) => check.ok);
+  const resource = _nullishCoalesce(spec.operation.split(".")[0], () => ( spec.operation));
+  const diffPart = spec.diff !== void 0 ? {
+    diff: spec.diff.map((entry) => {
+      if (entry.to === void 0) return entry;
+      const to = isRedactedFieldName(entry.field, policy) ? REDACTED : redactResponseBody(entry.to, policy);
+      return { ...entry, to };
+    })
+  } : {};
+  const dataPart = spec.data !== void 0 ? { data: redactResponseBody(spec.data, policy) } : {};
+  return {
+    operation: spec.operation,
+    wouldApply,
+    target: { resource, ids: spec.ids },
+    request: { method: spec.method, path: spec.path },
+    ...diffPart,
+    checks: spec.checks,
+    impact: spec.impact,
+    simulated: true,
+    warnings: _nullishCoalesce(spec.warnings, () => ( [])),
+    ...dataPart,
+    ...spec.emptyReason !== void 0 ? { emptyReason: spec.emptyReason } : {}
+  };
+}
+function computeFieldDiff(current, data) {
+  const out = [];
+  for (const [field, to] of Object.entries(data)) {
+    if (field === "id" || to === void 0) continue;
+    const from = current[field];
+    if (from !== void 0 && JSON.stringify(from) === JSON.stringify(to)) continue;
+    out.push({ field, from: from === void 0 ? null : from, to });
+  }
+  return out;
+}
+function mergePartialBody(current, data) {
+  const merged = { ...current };
+  for (const [key, value] of Object.entries(data)) {
+    if (value === void 0) continue;
+    merged[key] = value;
+  }
+  return merged;
+}
+function normalizeUdfInput(value) {
+  if (Array.isArray(value)) {
+    return value.map((entry) => {
+      if (!isRecord2(entry) || typeof entry.name !== "string" || entry.name === "") {
+        throw new AutotaskConfigError("userDefinedFields array entries must be { name, value } objects");
+      }
+      return { name: entry.name, value: entry.value };
+    });
+  }
+  if (isRecord2(value)) {
+    return Object.entries(value).map(([name, entryValue]) => ({ name, value: entryValue }));
+  }
+  throw new AutotaskConfigError("userDefinedFields must be an array of { name, value } entries or a name-to-value map");
+}
+function blindStampFor(stamp, filter) {
+  if (stamp === void 0) return void 0;
+  if (stamp.kind !== "unfiltered-blind") return stamp;
+  const conditions = normalizedConditions(filter);
+  return conditions === void 0 || conditions.length === 0 ? stamp : void 0;
+}
+function decodeFileData(body) {
+  if (isRecord2(body)) {
+    const data = body.data;
+    if (typeof data === "string") return Buffer.from(data, "base64");
+    if (Array.isArray(data) && data.every((b) => typeof b === "number")) {
+      return Buffer.from(data);
+    }
+  }
+  if (typeof body === "string") return Buffer.from(body, "base64");
+  throw new AutotaskError(
+    "Expected the file envelope FileQueryResultModel { data } (or a base64 string); got a different shape",
+    { 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 [...preset.fields];
+  return snake;
 }
 
 // src/operations/expandResourceNames.ts
@@ -17749,7 +17046,7 @@ async function expandResourceNames(client, ids2, opts = {}) {
     const raw = ids2[i];
     try {
       canonical[i] = parseIdentifier(raw, at);
-    } catch (e17) {
+    } catch (e16) {
       if (typeof raw === "string") {
         problems.push(`${at}: "${raw}" is not a vendor numeric resource id \u2014 non-numeric string identifiers are operations.resolveAny territory (the resource's findBy* helpers)`);
       } else if (typeof raw === "number") {
@@ -17775,54 +17072,35 @@ async function expandResourceNames(client, ids2, opts = {}) {
     }
   }
   const holder = client.resources;
-  const cache = client.http.resourceNameCache;
+  const cache = client.http.readCache;
   const fresh = opts.fresh === true;
   const byId = /* @__PURE__ */ new Map();
   for (const id of unique) {
     const k = String(id);
-    if (cache !== void 0 && !fresh) {
-      const shared = cache.inflight(id);
-      if (shared !== void 0) {
-        let joined;
-        try {
-          joined = await shared;
-        } catch (err) {
-          if (!isAutotaskError(err) || err.code !== "ABORTED") throw err;
-        }
-        if (joined !== void 0) {
-          byId.set(k, joined);
-          continue;
-        }
+    const absentKey = contextAbsentKey(`/V1.0/Resources/${k}`);
+    if (cache !== void 0 && !fresh && cache.get(absentKey) !== void 0) {
+      byId.set(k, { name: null, blind: true });
+      continue;
+    }
+    const epoch = _nullishCoalesce(_optionalChain([cache, 'optionalAccess', _112 => _112.epoch]), () => ( 0));
+    try {
+      const record = await holder.get(id, { fresh });
+      _optionalChain([cache, 'optionalAccess', _113 => _113.delete, 'call', _114 => _114(absentKey)]);
+      byId.set(k, { name: composeName(record), blind: false });
+    } catch (err) {
+      if (err instanceof NotFoundError) {
+        _optionalChain([cache, 'optionalAccess', _115 => _115.set, 'call', _116 => _116(absentKey, CONTEXT_ABSENT_MARKER, epoch)]);
+        byId.set(k, { name: null, blind: true });
+        continue;
       }
-      const hit = cache.get(id);
-      if (hit !== void 0) {
-        byId.set(k, { name: hit.name, blind: hit.blind });
+      if (isAutotaskError(err) && err.code !== "ABORTED") {
+        const e = { code: err.code, message: err.message };
+        if (err.httpStatus !== void 0) e.httpStatus = err.httpStatus;
+        byId.set(k, { name: null, blind: false, error: e });
         continue;
       }
+      throw err;
     }
-    const epoch = _nullishCoalesce(_optionalChain([cache, 'optionalAccess', _135 => _135.epoch]), () => ( 0));
-    const work = (async () => {
-      try {
-        const record = await holder.get(id, { fresh });
-        const name = composeName(record);
-        if (cache !== void 0 && name !== null) cache.set(id, { name, blind: false }, epoch);
-        return { name, blind: false };
-      } catch (err) {
-        if (err instanceof NotFoundError) {
-          const entry = { name: null, blind: true };
-          if (cache !== void 0) cache.set(id, entry, epoch);
-          return { name: null, blind: true };
-        }
-        if (isAutotaskError(err) && err.code !== "ABORTED") {
-          const e = { code: err.code, message: err.message };
-          if (err.httpStatus !== void 0) e.httpStatus = err.httpStatus;
-          return { name: null, blind: false, error: e };
-        }
-        throw err;
-      }
-    })();
-    const settled = cache !== void 0 ? await cache.track(id, work) : await work;
-    byId.set(k, settled);
   }
   const results = [];
   for (const id of canonical) {
@@ -17854,7 +17132,7 @@ function buildEntityTypeMap() {
 }
 var ENTITY_TYPE_TO_RESOURCE = buildEntityTypeMap();
 var ENUMERABLE_RESOURCES = new Set(
-  _chunkVR6RYXTDcjs.CAPABILITIES.filter((rec) => rec.resource !== "operations" && (rec.operation === "query" || rec.operation === "get")).map(
+  _chunkEVDVESQMcjs.CAPABILITIES.filter((rec) => rec.resource !== "operations" && (rec.operation === "query" || rec.operation === "get")).map(
     (rec) => rec.resource
   )
 );
@@ -17942,7 +17220,7 @@ function capabilitySets() {
   const fieldOps = /* @__PURE__ */ new Map();
   const udfCapable = /* @__PURE__ */ new Set();
   const resources = /* @__PURE__ */ new Set();
-  for (const rec of _chunkVR6RYXTDcjs.CAPABILITIES) {
+  for (const rec of _chunkEVDVESQMcjs.CAPABILITIES) {
     if (rec.resource === "operations") continue;
     resources.add(rec.resource);
     if (rec.operation === "getFieldInfo") fieldOps.set(rec.resource, rec);
@@ -17954,12 +17232,12 @@ var derivedIndex = null;
 function derivedFieldsFor(resource) {
   if (derivedIndex === null) {
     derivedIndex = /* @__PURE__ */ new Map();
-    for (const rec of _chunkVR6RYXTDcjs.CAPABILITIES) {
-      const declared = _optionalChain([rec, 'access', _136 => _136.metadata, 'optionalAccess', _137 => _137.derivedFields]);
+    for (const rec of _chunkEVDVESQMcjs.CAPABILITIES) {
+      const declared = _optionalChain([rec, 'access', _117 => _117.metadata, 'optionalAccess', _118 => _118.derivedFields]);
       if (!Array.isArray(declared) || derivedIndex.has(rec.resource)) continue;
       const rows = [];
       for (const row of declared) {
-        if (typeof _optionalChain([row, 'optionalAccess', _138 => _138.field]) !== "string" || typeof row.rule !== "string") continue;
+        if (typeof _optionalChain([row, 'optionalAccess', _119 => _119.field]) !== "string" || typeof row.rule !== "string") continue;
         rows.push({
           field: row.field,
           rule: row.rule,
@@ -17997,7 +17275,7 @@ function validateCatalogOptsShape(opts) {
   }
 }
 function resolveInclude(opts) {
-  const includeRaw = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _139 => _139.include]), () => ( ["fields"]));
+  const includeRaw = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _120 => _120.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)");
   }
@@ -18014,7 +17292,7 @@ function resolveInclude(opts) {
   return include;
 }
 function resolveTargets(opts, fieldOps, allResources) {
-  const resourcesRaw = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _140 => _140.resources]), () => ( WORKFLOW_RESOURCES));
+  const resourcesRaw = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _121 => _121.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");
   }
@@ -18048,7 +17326,7 @@ function resolveTargets(opts, fieldOps, allResources) {
   return targets;
 }
 function resolveFieldsFilter(opts) {
-  const fieldsRaw = _optionalChain([opts, 'optionalAccess', _141 => _141.fields]);
+  const fieldsRaw = _optionalChain([opts, 'optionalAccess', _122 => _122.fields]);
   if (fieldsRaw === void 0) return 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");
@@ -18071,19 +17349,19 @@ function resolveLabels(opts) {
       `fieldCatalog: opts.labels must be a boolean (got ${typeof opts.labels})`
     );
   }
-  return _optionalChain([opts, 'optionalAccess', _142 => _142.labels]) === true;
+  return _optionalChain([opts, 'optionalAccess', _123 => _123.labels]) === true;
 }
 function resolveSizeOpts(opts) {
-  if (_optionalChain([opts, 'optionalAccess', _143 => _143.compact]) !== void 0 && typeof opts.compact !== "boolean") {
+  if (_optionalChain([opts, 'optionalAccess', _124 => _124.compact]) !== void 0 && typeof opts.compact !== "boolean") {
     throw new AutotaskConfigError(`fieldCatalog: opts.compact must be a boolean (got ${typeof opts.compact})`);
   }
-  const maxBytes = _optionalChain([opts, 'optionalAccess', _144 => _144.maxBytes]);
+  const maxBytes = _optionalChain([opts, 'optionalAccess', _125 => _125.maxBytes]);
   if (maxBytes !== void 0 && (typeof maxBytes !== "number" || !Number.isInteger(maxBytes) || maxBytes < MIN_FIELD_CATALOG_MAX_BYTES)) {
     throw new AutotaskConfigError(
       `fieldCatalog: opts.maxBytes must be an integer >= ${MIN_FIELD_CATALOG_MAX_BYTES} (got ${String(maxBytes)})`
     );
   }
-  return { compact: _optionalChain([opts, 'optionalAccess', _145 => _145.compact]) === true, maxBytes };
+  return { compact: _optionalChain([opts, 'optionalAccess', _126 => _126.compact]) === true, maxBytes };
 }
 var jsonBytes = (v) => Buffer.byteLength(JSON.stringify(v), "utf8");
 var TRIM_KINDS = ["udf", "fields", "picklistFields", "queryable", "readOnly", "required"];
@@ -18139,9 +17417,9 @@ function assertWithinWireCap(targetCount, kindCount) {
 }
 function kindFetches(holder, resource) {
   return {
-    info: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _146 => _146.getEntityInfo, 'optionalCall', _147 => _147()]), () => ( Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getEntityInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" })))),
-    fields: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _148 => _148.getFieldInfo, 'optionalCall', _149 => _149()]), () => ( Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getFieldInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" })))),
-    udf: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _150 => _150.getUdfInfo, 'optionalCall', _151 => _151()]), () => ( Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getUdfInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" }))))
+    info: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _127 => _127.getEntityInfo, 'optionalCall', _128 => _128()]), () => ( Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getEntityInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" })))),
+    fields: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _129 => _129.getFieldInfo, 'optionalCall', _130 => _130()]), () => ( Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getFieldInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" })))),
+    udf: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _131 => _131.getUdfInfo, 'optionalCall', _132 => _132()]), () => ( Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getUdfInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" }))))
   };
 }
 async function sweepResource(ctx, resource, tally) {
@@ -18167,7 +17445,7 @@ async function sweepResource(ctx, resource, tally) {
     error: null
   };
   const fetches = kindFetches(holder, resource);
-  if (fresh) _optionalChain([cache, 'optionalAccess', _152 => _152.invalidate, 'call', _153 => _153(resource)]);
+  if (fresh) _optionalChain([cache, 'optionalAccess', _133 => _133.invalidate, 'call', _134 => _134(`${resource}:`)]);
   const projectList = (kind, list) => {
     const projected = list.map((f) => projectFieldRow(f, labels, kind === "udf"));
     if (kind === "fields") applyFieldsFilter(projected, fieldsFilter, row);
@@ -18177,10 +17455,10 @@ async function sweepResource(ctx, resource, tally) {
   let allCached = true;
   const ages = [];
   for (const kind of include) {
-    const peek = cache !== void 0 && !fresh ? cache.peek(resource, kind) : { hit: false, age: null };
+    const peek = cache !== void 0 && !fresh ? cache.peek(fieldKey(resource, kind)) : { hit: false, age: null };
     if (peek.hit !== true) allCached = false;
     if (peek.hit === true && cache !== void 0) {
-      const value2 = cache.get(resource, kind);
+      const value2 = cache.get(fieldKey(resource, kind));
       if (kind === "info") row.info = _nullishCoalesce(value2, () => ( null));
       else projectList(kind, Array.isArray(value2) ? value2 : []);
       if (peek.age !== null) ages.push(peek.age);
@@ -18242,7 +17520,7 @@ async function fieldCatalog(client, opts) {
   const zone = _nullishCoalesce(client.config.zone, () => ( "unknown"));
   const rows = [];
   const tally = { wireUsed: 0, anyPicklistValues: false };
-  const ctx = { client, include, fieldsFilter, labels, compact, fresh: _optionalChain([opts, 'optionalAccess', _154 => _154.fresh]) === true, fieldOps, udfCapable };
+  const ctx = { client, include, fieldsFilter, labels, compact, fresh: _optionalChain([opts, 'optionalAccess', _135 => _135.fresh]) === true, fieldOps, udfCapable };
   for (const resource of targets) {
     const row = await sweepResource(ctx, resource, tally);
     if (row !== void 0) rows.push(row);
@@ -18253,7 +17531,7 @@ async function fieldCatalog(client, opts) {
     cached: cache !== void 0,
     labels,
     compact,
-    ttlMs: _nullishCoalesce(_optionalChain([cache, 'optionalAccess', _155 => _155.ttlMs]), () => ( null)),
+    ttlMs: _nullishCoalesce(_optionalChain([cache, 'optionalAccess', _136 => _136.ttlMs]), () => ( null)),
     fetchedAt: (/* @__PURE__ */ new Date()).toISOString(),
     rows,
     wireUsed: tally.wireUsed,
@@ -18471,159 +17749,6 @@ var BOUNDED_QUERY_MAX_LIMIT = 2500;
 var LATEST_MAX_COUNT_PROBES = 64;
 var MARKER_RECOVERY_LIMIT = 5;
 
-// src/resources/base/helpers.ts
-function describeResponseShape(body) {
-  if (body === null) return "null";
-  if (Array.isArray(body)) return `array(len=${body.length})`;
-  if (typeof body !== "object") return typeof body;
-  const rec = body;
-  const keys = Object.keys(rec).sort();
-  const typeOf = (v) => v === null ? "null" : Array.isArray(v) ? "array" : typeof v;
-  const parts = keys.slice(0, 16).map((k) => `${k}:${typeOf(rec[k])}`);
-  const more = keys.length > 16 ? `, +${keys.length - 16} more` : "";
-  return `{ ${parts.join(", ")}${more} }`;
-}
-function defaultMarkerToken(data) {
-  for (const field of ["name", "title"]) {
-    const v = data[field];
-    if (typeof v === "string" && v.trim() !== "") return v.trim();
-  }
-  return null;
-}
-var CONTEXT_ABSENT_MARKER = "#context-absent";
-function contextAbsentKey(path) {
-  return path + "\0context-absent";
-}
-function noteCharsTruncationMarker(charsRemoved) {
-  return `\u2026 [+${charsRemoved} chars truncated]`;
-}
-function truncateNoteChars(items, cap, fields) {
-  let truncated = 0;
-  const out = items.map((item) => {
-    if (!isRecord2(item)) return item;
-    let changed = false;
-    const copy = { ...item };
-    for (const field of fields) {
-      const v = copy[field];
-      if (typeof v === "string" && v.length > cap) {
-        const end = cap > 0 && (v.charCodeAt(cap - 1) & 64512) === 55296 ? cap - 1 : cap;
-        copy[field] = v.slice(0, end) + noteCharsTruncationMarker(v.length - end);
-        truncated += 1;
-        changed = true;
-      }
-    }
-    return changed ? copy : item;
-  });
-  return [out, truncated];
-}
-function blindEmptyReason(stamp) {
-  return {
-    surface: stamp.surface,
-    kind: "blind-surface",
-    note: stamp.note,
-    authority: stamp.authority,
-    remedy: "the note is the remedy \u2014 the authority op answers for a record"
-  };
-}
-function attachUpdateTargetMissReason(err, key) {
-  const pinned = _optionalChain([EMPTY_REASON_STAMPS, 'access', _156 => _156[key], 'optionalAccess', _157 => _157.update]);
-  if (pinned === void 0) return;
-  err.details = { ..._nullishCoalesce(err.details, () => ( {})), emptyReason: pinned };
-}
-function buildDryRunResult(spec, policy = { redactPersonalData: true }) {
-  if (spec.operation === "") {
-    throw new AutotaskConfigError("dry-run: the operation name is required");
-  }
-  const wouldApply = spec.checks.every((check) => check.ok);
-  const resource = _nullishCoalesce(spec.operation.split(".")[0], () => ( spec.operation));
-  const diffPart = spec.diff !== void 0 ? {
-    diff: spec.diff.map((entry) => {
-      if (entry.to === void 0) return entry;
-      const to = isRedactedFieldName(entry.field, policy) ? REDACTED : redactResponseBody(entry.to, policy);
-      return { ...entry, to };
-    })
-  } : {};
-  const dataPart = spec.data !== void 0 ? { data: redactResponseBody(spec.data, policy) } : {};
-  return {
-    operation: spec.operation,
-    wouldApply,
-    target: { resource, ids: spec.ids },
-    request: { method: spec.method, path: spec.path },
-    ...diffPart,
-    checks: spec.checks,
-    impact: spec.impact,
-    simulated: true,
-    warnings: _nullishCoalesce(spec.warnings, () => ( [])),
-    ...dataPart,
-    ...spec.emptyReason !== void 0 ? { emptyReason: spec.emptyReason } : {}
-  };
-}
-function computeFieldDiff(current, data) {
-  const out = [];
-  for (const [field, to] of Object.entries(data)) {
-    if (field === "id" || to === void 0) continue;
-    const from = current[field];
-    if (from !== void 0 && JSON.stringify(from) === JSON.stringify(to)) continue;
-    out.push({ field, from: from === void 0 ? null : from, to });
-  }
-  return out;
-}
-function mergePartialBody(current, data) {
-  const merged = { ...current };
-  for (const [key, value] of Object.entries(data)) {
-    if (value === void 0) continue;
-    merged[key] = value;
-  }
-  return merged;
-}
-function normalizeUdfInput(value) {
-  if (Array.isArray(value)) {
-    return value.map((entry) => {
-      if (!isRecord2(entry) || typeof entry.name !== "string" || entry.name === "") {
-        throw new AutotaskConfigError("userDefinedFields array entries must be { name, value } objects");
-      }
-      return { name: entry.name, value: entry.value };
-    });
-  }
-  if (isRecord2(value)) {
-    return Object.entries(value).map(([name, entryValue]) => ({ name, value: entryValue }));
-  }
-  throw new AutotaskConfigError("userDefinedFields must be an array of { name, value } entries or a name-to-value map");
-}
-function blindStampFor(stamp, filter) {
-  if (stamp === void 0) return void 0;
-  if (stamp.kind !== "unfiltered-blind") return stamp;
-  const conditions = normalizedConditions(filter);
-  return conditions === void 0 || conditions.length === 0 ? stamp : void 0;
-}
-function decodeFileData(body) {
-  if (isRecord2(body)) {
-    const data = body.data;
-    if (typeof data === "string") return Buffer.from(data, "base64");
-    if (Array.isArray(data) && data.every((b) => typeof b === "number")) {
-      return Buffer.from(data);
-    }
-  }
-  if (typeof body === "string") return Buffer.from(body, "base64");
-  throw new AutotaskError(
-    "Expected the file envelope FileQueryResultModel { data } (or a base64 string); got a different shape",
-    { 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;
-}
-
 // src/resources/special/_shared/bounded-part.ts
 async function boundedPart(http, path, conditions, limit, operation, includeFields) {
   const body = { MaxRecords: limit, filter: conditions };
@@ -18829,7 +17954,7 @@ var QueryBase = class {
   }
   /** @internal */
   walkPageSize(params) {
-    return clampPageSize(_nullishCoalesce(_optionalChain([params, 'optionalAccess', _158 => _158.maxRecords]), () => ( this.defaultPageSize)));
+    return clampPageSize(_nullishCoalesce(_optionalChain([params, 'optionalAccess', _137 => _137.maxRecords]), () => ( this.defaultPageSize)));
   }
   /** Issue #281: relation filters (`ticket.<field>` …) resolve before a walk,
    *  through the same rewrite as queryBounded / count. `undefined` = no parent
@@ -18837,7 +17962,7 @@ var QueryBase = class {
   async relationWalkParams(params, op) {
     const p = _nullishCoalesce(params, () => ( {}));
     const relation = await rewriteRelationFilters(this.http, this.config.key, normalizedConditions(p.filter), op);
-    if (_optionalChain([relation, 'optionalAccess', _159 => _159.never]) === true) return void 0;
+    if (_optionalChain([relation, 'optionalAccess', _138 => _138.never]) === true) return void 0;
     return relation === void 0 ? p : { ...p, filter: relation.conditions };
   }
   /**
@@ -18912,19 +18037,19 @@ var QueryBase = 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', _160 => _160.limit]), () => ( BOUNDED_QUERY_DEFAULT_LIMIT));
+    const limit = _nullishCoalesce(_optionalChain([params, 'optionalAccess', _139 => _139.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', _161 => _161.noteChars]);
+    const noteChars = _optionalChain([params, 'optionalAccess', _140 => _140.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)`
       );
     }
-    let walkParams = _optionalChain([params, 'optionalAccess', _162 => _162.fieldsPreset]) !== void 0 ? { ...params, includeFields: resolveFieldsPreset(params.fieldsPreset, this.config.key, params.includeFields) } : _nullishCoalesce(params, () => ( {}));
+    let walkParams = _optionalChain([params, 'optionalAccess', _141 => _141.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) {
@@ -18932,14 +18057,14 @@ var QueryBase = 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', _163 => _163.limit]) !== void 0 && limit < latest) {
+      if (_optionalChain([params, 'optionalAccess', _142 => _142.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`
         );
       }
     }
     const relation = await rewriteRelationFilters(this.http, this.config.key, normalizedConditions(walkParams.filter), `${this.config.key}.query`);
-    if (_optionalChain([relation, 'optionalAccess', _164 => _164.never]) === true) return { items: [], fetched: 0, hasMore: false, pagesWalked: 0, relationNote: relation.note };
+    if (_optionalChain([relation, 'optionalAccess', _143 => _143.never]) === true) return { items: [], fetched: 0, hasMore: false, pagesWalked: 0, relationNote: relation.note };
     if (relation !== void 0) walkParams = { ...walkParams, filter: relation.conditions };
     if (latest !== void 0) {
       return this.applyNoteChars(await this.latestWalk(walkParams, Math.max(limit, latest), latest), noteChars);
@@ -19023,8 +18148,8 @@ var QueryBase = class {
    * @internal */
   stampEmptyQueryResult(result, params) {
     if (result.items.length !== 0) return;
-    result.blindSurface = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _165 => _165[this.config.key], 'optionalAccess', _166 => _166.query]), _optionalChain([params, 'optionalAccess', _167 => _167.filter]));
-    const pinnedReason = normalizedConditions(_optionalChain([params, 'optionalAccess', _168 => _168.filter])) === void 0 ? _optionalChain([EMPTY_REASON_STAMPS, 'access', _169 => _169[this.config.key], 'optionalAccess', _170 => _170.query]) : void 0;
+    result.blindSurface = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _144 => _144[this.config.key], 'optionalAccess', _145 => _145.query]), _optionalChain([params, 'optionalAccess', _146 => _146.filter]));
+    const pinnedReason = normalizedConditions(_optionalChain([params, 'optionalAccess', _147 => _147.filter])) === void 0 ? _optionalChain([EMPTY_REASON_STAMPS, 'access', _148 => _148[this.config.key], 'optionalAccess', _149 => _149.query]) : void 0;
     if (result.blindSurface !== void 0 || pinnedReason !== void 0) {
       result.emptyReason = result.blindSurface !== void 0 ? blindEmptyReason(result.blindSurface) : pinnedReason;
     }
@@ -19039,59 +18164,18 @@ var QueryBase = class {
     const bigB = typeof b === "number" ? BigInt(String(b)) : BigInt(b);
     return bigA < bigB ? -1 : bigA > bigB ? 1 : 0;
   }
-  /** Issue #127: the `latest` walk's count probes through the per-client
-   *  short-TTL count cache (`LatestCountCache` — fixed 30 s TTL, the
-   *  memory guard; cleared on every real write through this client, the
-   *  write-then-read re-fetch rule). Only a SUCCESSFUL plain-number vendor
-   *  count answer is stored: the blind-surface / pinned-empty sentinels are
-   *  RECORDS and pass through un-stored (the plan-pinned stamps stay fresh
-   *  and re-derive on every call), and an error rejects before any store.
-   *  The key is (resource plan key, canonical filter serialisation — the
-   *  normalised conditions' JSON): the initial `count(F)` probe and every
-   *  `id gt T` threshold probe are separate entries, and a re-asked
-   *  "top N" within the TTL makes ZERO extra count calls for every CACHED
-   *  probe (the bracket/search sequence is deterministic given the counts);
-   *  a probe that answered 0 is never cached, so it re-wires (issue #157).
-   *  Issue #157: two corrections to the snapshot trade. (1) A total of 0 is
-   *  NEVER stored — a 0 is rare and cheap to re-probe, and a cached 0 fed
-   *  the false-empty branch (a repeat after an out-of-band insert returned
-   *  no rows without walking). (2) `fresh: true` DELETES the entry before
-   *  the wire read and re-stores the fresh answer — the ONE re-probe the
-   *  stale-LOW recovery in `latestWalk` is allowed. Counts are snapshots,
-   *  not contracts: the truncation guard covers the growth-of-total
-   *  direction; a stale-LOW total within the TTL is resolved by that one
-   *  fresh re-probe (never by the guard alone). The plain `count` op and
-   *  `operations.aggregate` call `countGlobal` directly and promise fresh
-   *  totals — this wrapper is used ONLY on the latest-walk probe path.
-   * @internal
-   */
-  async latestProbeCount(filter, opts = {}) {
-    const cache = this.http.latestCountCache;
-    const key = LatestCountCache.key(this.config.key, normalizedConditions(filter));
-    if (opts.fresh === true) {
-      cache.delete(key);
-    } else {
-      const hit = cache.get(key);
-      if (hit !== void 0) return { value: hit, cached: true };
-    }
-    const epoch = cache.epoch;
-    const res = await this.countGlobal({ filter });
-    const value = res;
-    if (typeof value === "number" && value !== 0) cache.set(key, value, epoch);
-    return { value, cached: false };
-  }
   /** Issue #59: one `latest` threshold count probe — a ROWLESS
    *  `count(F ∧ id gt T)` call (the vendor caps — ≤500 OR-conditions,
    *  8000 chars serialised — leave a single `gt` condition room on any
-   *  filter). Issue #127: it rides the per-client short-TTL count cache — the same (resource, conditions) probe within the 30 s window is reused (zero vendor calls); a sentinel answer is never cached. The `BlindCountResult` sentinel (a record, not a number —
+   *  filter). Counts are never cached. The `BlindCountResult` sentinel (a record, not a number —
    *  the declared `number` return is the documented under-type) unwraps to
    *  its `count` value (always 0): at or above the max matching id the
    *  count is 0, which is exactly the bracket-termination signal.
    * @internal */
   async countAboveId(baseConds, t) {
     const value = t <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(t) : t.toString();
-    const probed = await this.latestProbeCount([...baseConds, { op: "gt", field: "id", value }]);
-    return typeof probed.value === "object" && probed.value !== null && "count" in probed.value ? probed.value.count : probed.value;
+    const probed = await this.countGlobal({ filter: [...baseConds, { op: "gt", field: "id", value }] });
+    return typeof probed === "object" && probed !== null && "count" in probed ? probed.count : probed;
   }
   /**
    * Issue #59: the `latest: N` mechanism — the N highest-`id` rows,
@@ -19109,10 +18193,7 @@ var QueryBase = class {
    *      1 + ceil(C/500) <= 6, independent of table size. A truncated walk
    *      (the vendor's rows disagree with its own count) is
    *      LATEST_WINDOW_INCOMPLETE — the top-N of a truncated set is
-   *      unprovable — EXCEPT issue #157: when `C` came from the CACHE, the
-   *      total is re-probed ONCE fresh (the stale-LOW recovery: a larger
-   *      fresh total continues the walk against it; the refusal stands only
-   *      when the fresh probe confirms the cached value). Sort
+   *      unprovable. Sort
    *      id-descending; return the top N (a set of C < N returns itself).
    *    - `C > 2500` → THRESHOLD mode: find the smallest id threshold `T`
    *      with `count(F ∧ id gt T) <= N` by exponential bracketing
@@ -19140,30 +18221,15 @@ var QueryBase = class {
    *    answer.
    * `includeFields` always carries `id` (the P1 id-append,
    * `buildQueryRequest`), which `latest` sorts on. Pure read; no mutation
-   * paths involved. Issue #127: every count probe of this walk (the
-   * initial `count(F)` + the `id gt T` threshold probes) rides the
-   * per-client short-TTL count cache (30 s; a real write through this
-   * client clears it) — a re-asked "top N" within the window reuses every
-   * CACHED probe (zero extra vendor count calls); sentinel answers are
-   * never cached (the plan-pinned stamps stay fresh), and a 0 total is
-   * never cached either (issue #157: a 0 is cheap to re-probe and a cached
-   * 0 would shadow an out-of-band insert), so a 0-answering probe re-wires.
-   * The stale-LOW direction is closed by the ONE fresh re-probe above. The
-   * stale-HIGH direction is the documented snapshot trade, NOT "safe by
-   * construction": the threshold probes are cache-served like every other
-   * probe (no fresh re-probe exists on that path), so a cached threshold
-   * count higher than reality can under-report the ROW COUNT within the
-   * TTL — the returned top-N stays correct, and full-set mode ends when the
-   * cursor exhausts. The plain `count` op and
-   * `operations.aggregate` bypass the cache by construction and promise
-   * fresh totals.
+   * paths involved; every count probe goes to the wire (counts are never
+   * cached).
    * @internal
    */
   async latestWalk(params, limit, latest) {
     const baseConds = _nullishCoalesce(normalizedConditions(params.filter), () => ( []));
-    const probe = await this.latestProbeCount(params.filter);
-    if (typeof probe.value === "object" && probe.value !== null) {
-      const rec = probe.value;
+    const total = await this.countGlobal({ filter: params.filter });
+    if (typeof total === "object" && total !== null) {
+      const rec = total;
       if (rec.blindSurface !== void 0) {
         return this.latestBlindWalk(params, limit, latest);
       }
@@ -19171,60 +18237,46 @@ var QueryBase = class {
       this.stampEmptyQueryResult(result, params);
       return result;
     }
-    let total = probe.value;
-    let cacheSourced = probe.cached;
-    let reProbed = false;
-    for (; ; ) {
-      if (total === 0) {
-        const result = { items: [], fetched: 0, hasMore: false, pagesWalked: 0 };
-        this.stampEmptyQueryResult(result, params);
-        return result;
-      }
-      if (total <= BOUNDED_QUERY_MAX_LIMIT) {
-        const { items: items2, pages: pages2, guard: guard2, sliced: sliced2, cursor: cursor2 } = await this.walkBounded(params, total);
-        if (this.walkTruncated(total, { itemsLength: items2.length, guard: guard2, sliced: sliced2, cursor: cursor2 })) {
-          if (cacheSourced && !reProbed) {
-            reProbed = true;
-            const fresh = await this.latestProbeCount(params.filter, { fresh: true });
-            if (typeof fresh.value === "number" && fresh.value > total) {
-              total = fresh.value;
-              cacheSourced = false;
-              continue;
-            }
-          }
-          throw this.latestWindowIncompleteError(total);
-        }
-        return this.finishLatest(items2, latest, pages2);
-      }
-      let probes = reProbed ? 2 : 1;
-      const spend = () => {
-        probes += 1;
-        if (probes > LATEST_MAX_COUNT_PROBES) throw this.latestThresholdUnresolvedError();
-      };
-      let lo = 0n;
-      let hi = 0n;
-      for (let t = 1n; ; t = t << 1n) {
-        spend();
-        if (await this.countAboveId(baseConds, t) <= latest) {
-          hi = t;
-          break;
-        }
-        lo = t;
-      }
-      while (hi - lo > 1n) {
-        const mid = lo + hi >> 1n;
-        spend();
-        if (await this.countAboveId(baseConds, mid) <= latest) hi = mid;
-        else lo = mid;
+    if (total === 0) {
+      const result = { items: [], fetched: 0, hasMore: false, pagesWalked: 0 };
+      this.stampEmptyQueryResult(result, params);
+      return result;
+    }
+    if (total <= BOUNDED_QUERY_MAX_LIMIT) {
+      const { items: items2, pages: pages2, guard: guard2, sliced: sliced2, cursor: cursor2 } = await this.walkBounded(params, total);
+      if (this.walkTruncated(total, { itemsLength: items2.length, guard: guard2, sliced: sliced2, cursor: cursor2 })) {
+        throw this.latestWindowIncompleteError(total);
       }
-      const windowValue = hi <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(hi) : hi.toString();
-      const window = [...baseConds, { op: "gte", field: "id", value: windowValue }];
-      const { items, pages, guard, sliced, cursor } = await this.walkBounded({ ...params, filter: window }, latest + 1);
-      if (this.walkTruncated(latest + 1, { itemsLength: items.length, guard, sliced, cursor })) {
-        throw this.latestWindowIncompleteError(latest + 1);
+      return this.finishLatest(items2, latest, pages2);
+    }
+    let probes = 1;
+    const spend = () => {
+      probes += 1;
+      if (probes > LATEST_MAX_COUNT_PROBES) throw this.latestThresholdUnresolvedError();
+    };
+    let lo = 0n;
+    let hi = 0n;
+    for (let t = 1n; ; t = t << 1n) {
+      spend();
+      if (await this.countAboveId(baseConds, t) <= latest) {
+        hi = t;
+        break;
       }
-      return this.finishLatest(items, latest, pages);
+      lo = t;
+    }
+    while (hi - lo > 1n) {
+      const mid = lo + hi >> 1n;
+      spend();
+      if (await this.countAboveId(baseConds, mid) <= latest) hi = mid;
+      else lo = mid;
+    }
+    const windowValue = hi <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(hi) : hi.toString();
+    const window = [...baseConds, { op: "gte", field: "id", value: windowValue }];
+    const { items, pages, guard, sliced, cursor } = await this.walkBounded({ ...params, filter: window }, latest + 1);
+    if (this.walkTruncated(latest + 1, { itemsLength: items.length, guard, sliced, cursor })) {
+      throw this.latestWindowIncompleteError(latest + 1);
     }
+    return this.finishLatest(items, latest, pages);
   }
   /** The shared `latest` completion: the (provably complete or
    *  stamp-scoped) set sorted id-descending, top N taken. `hasMore: false`
@@ -19253,7 +18305,7 @@ var QueryBase = class {
     if (result.items.length === 0) {
       this.stampEmptyQueryResult(result, params);
     } else {
-      result.blindSurface = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _171 => _171[this.config.key], 'optionalAccess', _172 => _172.query]), params.filter);
+      result.blindSurface = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _150 => _150[this.config.key], 'optionalAccess', _151 => _151.query]), params.filter);
     }
     return result;
   }
@@ -19294,9 +18346,9 @@ var QueryBase = class {
    *  or, on a plan-pinned blind surface, the `{ count: 0, blindSurface }`
    *  typed sentinel (S12-C T10; see `BlindCountResult`). */
   async countGlobal(params) {
-    const relation = await rewriteRelationFilters(this.http, this.config.key, normalizedConditions(_optionalChain([params, 'optionalAccess', _173 => _173.filter])), `${this.config.key}.count`);
-    if (_optionalChain([relation, 'optionalAccess', _174 => _174.never]) === true) return 0;
-    const conditions = relation !== void 0 ? relation.conditions : normalizedConditions(_optionalChain([params, 'optionalAccess', _175 => _175.filter]));
+    const relation = await rewriteRelationFilters(this.http, this.config.key, normalizedConditions(_optionalChain([params, 'optionalAccess', _152 => _152.filter])), `${this.config.key}.count`);
+    if (_optionalChain([relation, 'optionalAccess', _153 => _153.never]) === true) return 0;
+    const conditions = relation !== void 0 ? relation.conditions : normalizedConditions(_optionalChain([params, 'optionalAccess', _154 => _154.filter]));
     const body = {};
     body.filter = conditions === void 0 ? [] : buildFilter(conditions).filter;
     const res = await this.http.request({
@@ -19307,9 +18359,9 @@ var QueryBase = class {
       idempotent: true
     });
     const count = unwrapQueryCount(res, `${this.config.key}.count`);
-    const stamp = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _176 => _176[this.config.key], 'optionalAccess', _177 => _177.count]), _optionalChain([params, 'optionalAccess', _178 => _178.filter]));
+    const stamp = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _155 => _155[this.config.key], 'optionalAccess', _156 => _156.count]), _optionalChain([params, 'optionalAccess', _157 => _157.filter]));
     if (count === 0) {
-      const pinnedReason = conditions === void 0 ? _optionalChain([EMPTY_REASON_STAMPS, 'access', _179 => _179[this.config.key], 'optionalAccess', _180 => _180.count]) : void 0;
+      const pinnedReason = conditions === void 0 ? _optionalChain([EMPTY_REASON_STAMPS, 'access', _158 => _158[this.config.key], 'optionalAccess', _159 => _159.count]) : void 0;
       if (stamp !== void 0 || pinnedReason !== void 0) {
         return {
           count,
@@ -19335,19 +18387,17 @@ var MetaBase = class extends QueryBase {
    *  other callers): mutation-path reads (stale-object guard, dry-run diff)
    *  and the composite ROOT read of a hot resource (issue #36 — the
    *  ticket-composite root) must see the live record, never a snapshot.
-   *  `resource` (issue #32) is the plan key of the entity this path
-   *  points to: the stored entry's TTL is the per-resource override for
-   *  that key when `cache.perResourceTtlMs` names it, else `ttlMs`.
+   *  The entry's TTL follows the path (`readTtlFor`: reference tables 1 h).
    * @internal */
-  async cachedGet(path, operation, fresh = false, resource) {
+  async cachedGet(path, operation, fresh = false) {
     const cache = this.http.readCache;
     if (cache !== void 0 && !fresh) {
       const hit = cache.get(path);
       if (hit !== void 0) return hit;
     }
-    const epoch = _optionalChain([cache, 'optionalAccess', _181 => _181.epoch]);
+    const epoch = _optionalChain([cache, 'optionalAccess', _160 => _160.epoch]);
     const res = await this.http.request({ method: "GET", path, operation });
-    _optionalChain([cache, 'optionalAccess', _182 => _182.set, 'call', _183 => _183(path, res, resource, epoch)]);
+    _optionalChain([cache, 'optionalAccess', _161 => _161.set, 'call', _162 => _162(path, res, epoch)]);
     return res;
   }
   /**
@@ -19374,29 +18424,29 @@ var MetaBase = class extends QueryBase {
       const res = await this.http.request({ method: "GET", path, operation });
       return unwrap(res);
     }
-    const key = this.config.key;
+    const key = fieldKey(this.config.key, kind);
     if (!fresh) {
-      const shared = cache.inflight(key, kind);
+      const shared = cache.inflight(key);
       if (shared !== void 0) return shared;
-      const hit = cache.get(key, kind);
+      const hit = cache.get(key);
       if (hit !== void 0) return hit;
     }
     const work = this.http.request({ method: "GET", path, operation }).then((body) => {
       const value = unwrap(body);
-      cache.set(key, kind, value);
+      if (!isEmpty(value)) cache.set(key, value);
       return value;
     });
     work.catch((err) => {
-      if (err instanceof AutotaskError && (err.code === "INVALID_RESPONSE" || _optionalChain([err, 'access', _184 => _184.details, 'optionalAccess', _185 => _185.deterministic]) === true)) {
-        cache.invalidate(key);
+      if (err instanceof AutotaskError && (err.code === "INVALID_RESPONSE" || _optionalChain([err, 'access', _163 => _163.details, 'optionalAccess', _164 => _164.deterministic]) === true)) {
+        cache.invalidate(`${this.config.key}:`);
       }
     });
-    return cache.track(key, kind, work);
+    return cache.track(key, work);
   }
   /** `GET /V1.0/<E>/{id}` → `{ item }` unwrapped (`item: null` → NotFoundError). */
   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);
+    const res = await this.cachedGet(`${this.resourcePath}/${numeric}`, `${this.config.key}.get`, fresh);
     return unwrapItem(res, numeric, `${this.config.key}.get`, this.entityName);
   }
   /**
@@ -19417,7 +18467,7 @@ var MetaBase = class extends QueryBase {
       path: `${this.resourcePath}/${numeric}`,
       operation: `${this.config.key}.get`,
       skipResponseRedaction: true,
-      maxRetries: _optionalChain([readOpts, 'optionalAccess', _186 => _186.maxRetries])
+      maxRetries: _optionalChain([readOpts, 'optionalAccess', _165 => _165.maxRetries])
     });
     return unwrapItem(res, numeric, `${this.config.key}.get`, this.entityName);
   }
@@ -19436,14 +18486,14 @@ var MetaBase = class extends QueryBase {
       path: this.scopedItemPath(parentId, numeric),
       operation: `${this.config.key}.get`,
       skipResponseRedaction: true,
-      maxRetries: _optionalChain([readOpts, 'optionalAccess', _187 => _187.maxRetries])
+      maxRetries: _optionalChain([readOpts, 'optionalAccess', _166 => _166.maxRetries])
     });
     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);
+    const res = await this.cachedGet(this.scopedItemPath(parentId, id), `${this.config.key}.get`, fresh);
     return unwrapItem(res, numeric, `${this.config.key}.get`, this.entityName);
   }
   /**
@@ -19453,7 +18503,7 @@ var MetaBase = class extends QueryBase {
    */
   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);
+    const res = await this.cachedGet(this.scopedItemPath(parentId, id), `${this.config.key}.get`, fresh);
     return this.unwrapModelLike(res, numeric, this.entityName);
   }
   /** @internal */
@@ -19492,7 +18542,7 @@ var MetaBase = class extends QueryBase {
   // ------------------------------------------------------------------
   /** `GET /V1.0/<E>/entityInformation` → `{ info }` unwrapped.
    *  Goes through the field cache when it is present (issue #80:
-   *  default-on; `fieldCache: false` = the bit-for-bit uncached wire
+   *  default-on; `cache: false` = the bit-for-bit uncached wire
    *  path). A fresh
    *  (bypass + refresh) metadata read is the caller's act: drop the
    *  entity's entries via the fieldCache's `invalidate` first — the trio
@@ -19516,7 +18566,7 @@ var MetaBase = class extends QueryBase {
   }
   /** `GET /V1.0/<E>/entityInformation/fields` → `{ fields }` unwrapped.
    *  Goes through the field cache when it is present (issue #80:
-   *  default-on; `fieldCache: false` = the bit-for-bit uncached wire
+   *  default-on; `cache: false` = the bit-for-bit uncached wire
    *  path). A fresh
    *  (bypass + refresh) metadata read is the caller's act: drop the
    *  entity's entries via the fieldCache's `invalidate` first — the trio
@@ -19531,7 +18581,7 @@ var MetaBase = class extends QueryBase {
   }
   /** `GET /V1.0/<E>/entityInformation/userDefinedFields` → `{ fields }` unwrapped.
    *  Goes through the field cache when it is present (issue #80:
-   *  default-on; `fieldCache: false` = the bit-for-bit uncached wire
+   *  default-on; `cache: false` = the bit-for-bit uncached wire
    *  path). A fresh
    *  (bypass + refresh) metadata read is the caller's act: drop the
    *  entity's entries via the fieldCache's `invalidate` first — the trio
@@ -19598,8 +18648,7 @@ var MetaBase = class extends QueryBase {
    *  record, never a snapshot. */
   async fetchRecordRaw(entityPath, id, fresh = false) {
     const numeric = parseIdentifier(id, "id");
-    const resource = RESOURCE_KEY_BY_PATH[entityPath];
-    const res = await this.cachedGet(`${entityPath}/${numeric}`, `${this.config.key}.fetchRecord`, fresh, resource);
+    const res = await this.cachedGet(`${entityPath}/${numeric}`, `${this.config.key}.fetchRecord`, fresh);
     if (this.config.attachmentGet) {
       return this.unwrapModelLike(res, numeric, entityNameFromPath(entityPath));
     }
@@ -19613,16 +18662,16 @@ var MetaBase = class extends QueryBase {
    *
    *  Issue #36 (negative caching, the pinned hazard): the vendor's true
    *  not-found (the HTTP 404 or the 200 `item: null` signal — both surface
-   *  as `NotFoundError`) is stored as an ABSENT marker in the SAME ReadCache
+   *  as `NotFoundError`) is stored as an ABSENT marker in the SAME read cache
    *  under a namespaced key the positive get path never constructs, so a
    *  repeat composite call serves 'absent' with zero wire for that part.
-   *  The marker expires on the READ entity's TTL (the #32 per-resource
-   *  table / `perResourceTtlMs` override, via `set`'s resource key) and is
-   *  cleared by any real write through the client (the ReadCache clear).
+   *  The marker expires on the READ entity's TTL (the key carries the read
+   *  path, so `readTtlFor` applies) and is
+   *  cleared by any real write through the client (the read cache clear).
    *  A transient fault (5xx, shape drift, network) is NEVER stored as an
    *  ABSENT marker — it propagates and the next call re-wires (no
    *  poisoning; a malformed 200 body may still land under the POSITIVE
-   *  key — pre-existing ReadCache behaviour, out of this mechanism's
+   *  key — pre-existing read cache behaviour, out of this mechanism's
    *  scope). The marker is consulted BEFORE the positive lookup, but a
    *  POSITIVE entry that exists alongside a live marker means a newer
    *  positive outcome (this client read/created the record after the
@@ -19645,12 +18694,12 @@ var MetaBase = class extends QueryBase {
         return null;
       }
     }
-    const epoch = _optionalChain([cache, 'optionalAccess', _188 => _188.epoch]);
+    const epoch = _optionalChain([cache, 'optionalAccess', _167 => _167.epoch]);
     try {
       return await this.fetchRecordRaw(entityPath, referenceId);
     } catch (err) {
       if (err instanceof NotFoundError) {
-        _optionalChain([cache, 'optionalAccess', _189 => _189.set, 'call', _190 => _190(absentKey, CONTEXT_ABSENT_MARKER, RESOURCE_KEY_BY_PATH[entityPath], epoch)]);
+        _optionalChain([cache, 'optionalAccess', _168 => _168.set, 'call', _169 => _169(absentKey, CONTEXT_ABSENT_MARKER, epoch)]);
         return null;
       }
       throw err;
@@ -19767,7 +18816,7 @@ var MetaBase = class extends QueryBase {
   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', _191 => _191[key], 'optionalAccess', _192 => _192.query]), probe);
+    const blind = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _170 => _170[key], 'optionalAccess', _171 => _171.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.`);
@@ -19895,6 +18944,11 @@ var MetaBase = class extends QueryBase {
     });
   }
 };
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (Array.isArray(value)) return value.length === 0;
+  return typeof value === "object" && Object.keys(value).length === 0;
+}
 
 // src/resources/base/mutations.ts
 var MutationBase = class extends MetaBase {
@@ -20400,7 +19454,7 @@ var MutationBase = class extends MetaBase {
       }
     }
     if (isRecord2(data)) {
-      const eff = effectiveRequiredFields(void 0, _nullishCoalesce(_optionalChain([RELATIONSHIP_MAP, 'access', _193 => _193[this.config.key], 'optionalAccess', _194 => _194.zoneFacts]), () => ( null)));
+      const eff = effectiveRequiredFields(void 0, _nullishCoalesce(_optionalChain([RELATIONSHIP_MAP, 'access', _172 => _172[this.config.key], 'optionalAccess', _173 => _173.zoneFacts]), () => ( null)));
       const missing = eff.fields.filter((f) => f !== this.config.parentField && data[f] === void 0);
       if (missing.length > 0) {
         warnings.push(`required field(s) not in the data: ${missing.join(", ")} (${eff.from}); the vendor would likely reject the create`);
@@ -20440,7 +19494,7 @@ var MutationBase = class extends MetaBase {
       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', _195 => _195[this.config.key], 'optionalAccess', _196 => _196.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,
@@ -20714,15 +19768,14 @@ async function resolveCompositeNames(http, plan, opts = {}) {
     throw new AutotaskConfigError("composite names: the transport is not wired to an AutotaskClient (the composite must run through the client)");
   }
   const readCache = http.readCache;
-  const nameCache = http.resourceNameCache;
   const section = { truncated: false, rows: {}, reasons: {} };
   let remaining = budget;
   let contractLobPointer;
   let contractLobUnread;
   const coldResource = [];
   for (const id of plan.resourceIds) {
-    if (nameCache !== void 0 && nameCache.get(id) !== void 0) continue;
-    if (readCache !== void 0 && readCache.get(`/V1.0/Resources/${id}`) !== void 0) continue;
+    const path = `/V1.0/Resources/${id}`;
+    if (readCache !== void 0 && (readCache.peek(path).hit || readCache.peek(contextAbsentKey(path)).hit)) continue;
     coldResource.push(id);
   }
   const withinBudget = coldResource.slice(0, remaining);
@@ -20800,11 +19853,11 @@ async function resolveCompositeNames(http, plan, opts = {}) {
       const row = catalog.rows.find((r) => r.resource === labelResource);
       if (row === void 0 || row.error !== null || row.fields === void 0) {
         usable = false;
-        failure = _nullishCoalesce(_optionalChain([row, 'optionalAccess', _197 => _197.error]), () => ( { code: "INVALID_RESPONSE", message: `fieldCatalog: no ${labelResource} row` }));
+        failure = _nullishCoalesce(_optionalChain([row, 'optionalAccess', _176 => _176.error]), () => ( { code: "INVALID_RESPONSE", message: `fieldCatalog: no ${labelResource} row` }));
       } else {
         for (const f of plan.labelFields) {
           const frow = row.fields.find((x) => x.name === f);
-          picklists[f] = _optionalChain([frow, 'optionalAccess', _198 => _198.picklistValues]);
+          picklists[f] = _optionalChain([frow, 'optionalAccess', _177 => _177.picklistValues]);
         }
       }
     } catch (err) {
@@ -20843,8 +19896,8 @@ async function resolveCompositeNames(http, plan, opts = {}) {
   return {
     section,
     lineOfBusiness: lineOfBusiness2,
-    resourceName: (id) => _nullishCoalesce(_optionalChain([section, 'access', _199 => _199.rows, 'access', _200 => _200[`resource:${id}`], 'optionalAccess', _201 => _201.name]), () => ( null)),
-    recordName: (table, id) => _nullishCoalesce(_optionalChain([section, 'access', _202 => _202.rows, 'access', _203 => _203[`${table}:${id}`], 'optionalAccess', _204 => _204.name]), () => ( null)),
+    resourceName: (id) => _nullishCoalesce(_optionalChain([section, 'access', _178 => _178.rows, 'access', _179 => _179[`resource:${id}`], 'optionalAccess', _180 => _180.name]), () => ( null)),
+    recordName: (table, id) => _nullishCoalesce(_optionalChain([section, 'access', _181 => _181.rows, 'access', _182 => _182[`${table}:${id}`], 'optionalAccess', _183 => _183.name]), () => ( null)),
     labelFor: (field, value) => {
       if (value === null || value === void 0) return null;
       const values = picklists[field];
@@ -20897,11 +19950,11 @@ async function labelRows(client, resourceKey, rows, resourceKeyedReasons = false
     const row = catalog.rows.find((r) => r.resource === resourceKey);
     const known = _nullishCoalesce(lastPicklists.get(client), () => ( /* @__PURE__ */ new Map()));
     lastPicklists.set(client, known);
-    if (_optionalChain([row, 'optionalAccess', _205 => _205.fields]) === void 0) {
+    if (_optionalChain([row, 'optionalAccess', _184 => _184.fields]) === void 0) {
       const last = known.get(resourceKey);
       unavailable = (_nullishCoalesce(last, () => ( []))).filter((f) => candidates.includes(f));
       if (last === void 0 || unavailable.length > 0) {
-        catalogError = _nullishCoalesce(_optionalChain([row, 'optionalAccess', _206 => _206.error]), () => ( { code: "INVALID_RESPONSE", message: `fieldCatalog: no ${resourceKey} row` }));
+        catalogError = _nullishCoalesce(_optionalChain([row, 'optionalAccess', _185 => _185.error]), () => ( { code: "INVALID_RESPONSE", message: `fieldCatalog: no ${resourceKey} row` }));
       }
     } else {
       const all = row.fields.filter((f) => f.isPickList).map((f) => f.name);
@@ -20924,7 +19977,7 @@ async function labelRows(client, resourceKey, rows, resourceKeyedReasons = false
   }
   const plan = builder.plan();
   const names = plan.resourceIds.length === 0 && plan.recordFks.length === 0 && picklistFields.length === 0 ? void 0 : await resolveCompositeNames(client.http, plan);
-  const secondReadFailed = _optionalChain([names, 'optionalAccess', _207 => _207.section, 'access', _208 => _208.catalogError]);
+  const secondReadFailed = _optionalChain([names, 'optionalAccess', _186 => _186.section, 'access', _187 => _187.catalogError]);
   if (secondReadFailed !== void 0) {
     catalogError ??= secondReadFailed;
     unavailable = [.../* @__PURE__ */ new Set([...unavailable, ...picklistFields])];
@@ -20944,8 +19997,8 @@ async function labelRows(client, resourceKey, rows, resourceKeyedReasons = false
     return r;
   });
   const capped = names === void 0 ? 0 : Object.values(names.section.rows).filter((row) => row.capped).length;
-  const unresolved = Object.keys(_nullishCoalesce(_optionalChain([names, 'optionalAccess', _209 => _209.section, 'access', _210 => _210.reasons]), () => ( {})));
-  const reasons = { ..._optionalChain([names, 'optionalAccess', _211 => _211.section, 'access', _212 => _212.reasons]) };
+  const unresolved = Object.keys(_nullishCoalesce(_optionalChain([names, 'optionalAccess', _188 => _188.section, 'access', _189 => _189.reasons]), () => ( {})));
+  const reasons = { ..._optionalChain([names, 'optionalAccess', _190 => _190.section, 'access', _191 => _191.reasons]) };
   for (const f of unavailable) reasons[f] = PICKLIST_CATALOG_UNAVAILABLE_NOTE;
   if (capped === 0 && unresolved.length === 0 && catalogError === void 0) return { rows: out };
   const parts = [];
@@ -21024,7 +20077,7 @@ var BillingCodesResource = class extends BaseResource {
   }
   /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
   async get(id, opts = {}) {
-    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _213 => _213.fresh]) === true);
+    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _192 => _192.fresh]) === true);
   }
   /** Resolve a BillingCode from a numeric id (or, where the vendor indexes a primary text field,
    * from an exact match on name). A numeric id miss throws NOT_FOUND; a complete
@@ -21039,7 +20092,7 @@ var BillingCodesResource = class extends BaseResource {
   /** Search BillingCode records: bounded contains on name (no vendor free-text search exists);
    * limit defaults to 25, max 500. */
   async search(query, opts) {
-    return this.searchBase(query, { limit: _optionalChain([opts, 'optionalAccess', _214 => _214.limit]) });
+    return this.searchBase(query, { limit: _optionalChain([opts, 'optionalAccess', _193 => _193.limit]) });
   }
 };
 
@@ -21130,7 +20183,7 @@ function validateZone(tz, opName = "dateWindow") {
   }
   try {
     new Intl.DateTimeFormat("en-US", { timeZone: tz });
-  } catch (e18) {
+  } catch (e17) {
     throw new AutotaskConfigError(
       `${opName}: tz is not a valid IANA timezone (${JSON.stringify(tz)}; e.g. 'Australia/Sydney' \u2014 omitted tz = UTC)`,
       { operation: opName }
@@ -21343,28 +20396,28 @@ async function customRangeQuery(http, path, field, from, to, limit, operation, z
 
 // src/resources/special/billing_items.ts
 async function windowQuery(_resource, kind, http, opts) {
-  const now = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _215 => _215.now]), () => ( /* @__PURE__ */ new Date()));
-  const tz = _optionalChain([opts, 'optionalAccess', _216 => _216.tz]) === void 0 ? void 0 : validateZone(opts.tz, `billing_items.${kind}`);
+  const now = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _194 => _194.now]), () => ( /* @__PURE__ */ new Date()));
+  const tz = _optionalChain([opts, 'optionalAccess', _195 => _195.tz]) === void 0 ? void 0 : validateZone(opts.tz, `billing_items.${kind}`);
   return dateWindowQuery(
     http,
     "/V1.0/BillingItems/query",
     "itemDate",
     kind,
-    clampWindowLimit(_optionalChain([opts, 'optionalAccess', _217 => _217.limit])),
+    clampWindowLimit(_optionalChain([opts, 'optionalAccess', _196 => _196.limit])),
     `billing_items.${kind}`,
     now,
     tz
   );
 }
 async function customRange(_resource, from, to, http, opts) {
-  const zone = _optionalChain([opts, 'optionalAccess', _218 => _218.tz]) === void 0 ? void 0 : validateZone(opts.tz, "billing_items.customRange");
+  const zone = _optionalChain([opts, 'optionalAccess', _197 => _197.tz]) === void 0 ? void 0 : validateZone(opts.tz, "billing_items.customRange");
   return customRangeQuery(
     http,
     "/V1.0/BillingItems/query",
     "itemDate",
     from,
     to,
-    clampWindowLimit(_optionalChain([opts, 'optionalAccess', _219 => _219.limit])),
+    clampWindowLimit(_optionalChain([opts, 'optionalAccess', _198 => _198.limit])),
     "billing_items.customRange",
     zone
   );
@@ -21396,7 +20449,7 @@ var BillingItemsResource = class extends BaseResource {
   }
   /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
   async get(id, opts = {}) {
-    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _220 => _220.fresh]) === true);
+    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _199 => _199.fresh]) === true);
   }
   /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
    * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
@@ -21588,9 +20641,9 @@ async function searchByDomain(_resource, domain, opts = {}, http) {
   return fetchCompanies(http, ids2, limit);
 }
 async function searchByIdentity(_resource, identity, opts = {}, http) {
-  const name = _nullishCoalesce(_optionalChain([identity, 'access', _221 => _221.companyName, 'optionalAccess', _222 => _222.trim, 'call', _223 => _223()]), () => ( ""));
-  const email = _nullishCoalesce(_optionalChain([identity, 'access', _224 => _224.email, 'optionalAccess', _225 => _225.trim, 'call', _226 => _226()]), () => ( ""));
-  const website = _nullishCoalesce(_optionalChain([identity, 'access', _227 => _227.website, 'optionalAccess', _228 => _228.trim, 'call', _229 => _229()]), () => ( ""));
+  const name = _nullishCoalesce(_optionalChain([identity, 'access', _200 => _200.companyName, 'optionalAccess', _201 => _201.trim, 'call', _202 => _202()]), () => ( ""));
+  const email = _nullishCoalesce(_optionalChain([identity, 'access', _203 => _203.email, 'optionalAccess', _204 => _204.trim, 'call', _205 => _205()]), () => ( ""));
+  const website = _nullishCoalesce(_optionalChain([identity, 'access', _206 => _206.website, 'optionalAccess', _207 => _207.trim, 'call', _208 => _208()]), () => ( ""));
   if (name === "" && email === "" && website === "") {
     throw new AutotaskConfigError("searchByIdentity: at least one of companyName / email / website is required");
   }
@@ -21729,7 +20782,7 @@ function validateUpsertInput(companyName, params) {
   if (typeof companyName !== "string" || companyName.trim() === "") {
     throw new AutotaskConfigError("upsertByName: companyName is required (a non-empty string)", { operation: OP_UPSERT_NAME });
   }
-  if (typeof _optionalChain([params, 'optionalAccess', _230 => _230.phone]) !== "string" || params.phone.trim() === "") {
+  if (typeof _optionalChain([params, 'optionalAccess', _209 => _209.phone]) !== "string" || params.phone.trim() === "") {
     throw new AutotaskConfigError("upsertByName: params.phone is required (a non-empty string \u2014 the ww29 live-required set is { companyName, companyType, phone, ownerResourceID })", { operation: OP_UPSERT_NAME });
   }
   const companyType = _nullishCoalesce(params.companyType, () => ( DEFAULT_COMPANY_TYPE));
@@ -21954,7 +21007,7 @@ function readIncludeNames(record, includeFields) {
 function resolveAuthority(record, live) {
   if (live !== null) return { known: live, authority: "the tenant's live entity field metadata" };
   const vendored = MODEL_FIELD_SETS[record.resource];
-  const liveOnlyExempt = Array.isArray(_optionalChain([record, 'access', _231 => _231.metadata, 'optionalAccess', _232 => _232.liveOnlyFields])) ? record.metadata.liveOnlyFields : [];
+  const liveOnlyExempt = Array.isArray(_optionalChain([record, 'access', _210 => _210.metadata, 'optionalAccess', _211 => _211.liveOnlyFields])) ? record.metadata.liveOnlyFields : [];
   if (vendored === void 0) return void 0;
   return {
     known: [...vendored, ...liveOnlyExempt],
@@ -22010,11 +21063,11 @@ var CLOSED_STATUS_LABELS = ["complete", "completed", "closed", "cancelled", "can
 var OP = "tickets.statusSemantics";
 function picklistOf(fields) {
   if (!Array.isArray(fields)) return [];
-  const status = fields.find((f) => typeof _optionalChain([f, 'optionalAccess', _233 => _233.name]) === "string" && f.name.toLowerCase() === "status");
+  const status = fields.find((f) => typeof _optionalChain([f, 'optionalAccess', _212 => _212.name]) === "string" && f.name.toLowerCase() === "status");
   if (status === void 0 || status.isPickList !== true || !Array.isArray(status.picklistValues)) return [];
   const out = [];
   for (const v of status.picklistValues) {
-    const id = Number(_optionalChain([v, 'optionalAccess', _234 => _234.value]));
+    const id = Number(_optionalChain([v, 'optionalAccess', _213 => _213.value]));
     if (!Number.isSafeInteger(id)) continue;
     out.push({ id, label: typeof v.label === "string" ? v.label : "" });
   }
@@ -22022,19 +21075,19 @@ function picklistOf(fields) {
 }
 async function readFields(http, fresh) {
   const cache = http.fieldCache;
-  const key = "tickets";
+  const key = fieldKey("tickets", "fields");
   if (!fresh && cache !== void 0) {
-    const shared = cache.inflight(key, "fields");
+    const shared = cache.inflight(key);
     if (shared !== void 0) return await shared;
-    const hit = cache.get(key, "fields");
+    const hit = cache.get(key);
     if (hit !== void 0) return hit;
   }
   const res = await http.request({ method: "GET", path: "/V1.0/Tickets/entityInformation/fields", operation: OP, maxRetries: 0 });
-  const fields = _optionalChain([res, 'optionalAccess', _235 => _235.fields]);
+  const fields = _optionalChain([res, 'optionalAccess', _214 => _214.fields]);
   if (!Array.isArray(fields)) {
     throw new AutotaskError("Expected the FieldInformationResultModel envelope { fields: [] }; got a different shape", { code: "INVALID_RESPONSE", category: "server" });
   }
-  _optionalChain([cache, 'optionalAccess', _236 => _236.set, 'call', _237 => _237(key, "fields", fields)]);
+  if (fields.length > 0) _optionalChain([cache, 'optionalAccess', _215 => _215.set, 'call', _216 => _216(key, fields)]);
   return fields;
 }
 function assumed(allowAssumed, operation) {
@@ -22186,7 +21239,7 @@ async function readOpenTickets(http, companyID, ticketLimit, includeFields, stat
     closedStatus
   };
   if (openRows.length === 0) {
-    const stamp = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _238 => _238["tickets"], 'optionalAccess', _239 => _239.query]), [{ field: "companyID", op: "eq", value: companyID }, openLeaf]);
+    const stamp = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _217 => _217["tickets"], 'optionalAccess', _218 => _218.query]), [{ field: "companyID", op: "eq", value: companyID }, openLeaf]);
     if (stamp !== void 0) {
       openTickets = {
         items: openRows,
@@ -22356,7 +21409,7 @@ async function prepareCrmWrite(resource, input, http) {
     const rows = await readRows(http, "/V1.0/CompanyLocations/query", [{ field: "companyID", op: "eq", value: companyID }]);
     const items = rows.map((r) => ({ id: r.id, name: str(r.name), isPrimary: bool(r.isPrimary), isActive: bool(r.isActive), city: str(r.city), state: str(r.state), postalCode: str(r.postalCode) }));
     const active = items.filter((l) => l.isActive !== false);
-    const m = active.filter((l) => has(ct.city) && _optionalChain([l, 'access', _240 => _240.city, 'optionalAccess', _241 => _241.toLowerCase, 'call', _242 => _242()]) === String(ct.city).toLowerCase() || has(ct.postalCode) && l.postalCode === String(ct.postalCode));
+    const m = active.filter((l) => has(ct.city) && _optionalChain([l, 'access', _219 => _219.city, 'optionalAccess', _220 => _220.toLowerCase, 'call', _221 => _221()]) === String(ct.city).toLowerCase() || has(ct.postalCode) && l.postalCode === String(ct.postalCode));
     const pick = has(ct.companyLocationID) ? { rule: "matched", locationID: ct.companyLocationID } : active.length === 1 ? { rule: "single", locationID: active[0].id } : active.length > 1 && m.length === 1 ? { rule: "matched", locationID: m[0].id } : active.length > 1 ? { rule: "ask", locationID: null } : { rule: "none", locationID: null };
     locations = { items, pick };
     if (input.intent === "add_contact" && pick.locationID === null) {
@@ -22391,7 +21444,7 @@ async function prepareCrmWrite(resource, input, http) {
     }
   }
   if (input.intent === "create_company" && status !== "matched") {
-    const eff = effectiveRequiredFields(null, _optionalChain([RELATIONSHIP_MAP, 'access', _243 => _243.companies, 'optionalAccess', _244 => _244.zoneFacts]));
+    const eff = effectiveRequiredFields(null, _optionalChain([RELATIONSHIP_MAP, 'access', _222 => _222.companies, 'optionalAccess', _223 => _223.zoneFacts]));
     const research = (f) => ["companyType", "ownerResourceID", "countryID"].includes(f) ? "lookup" : "web_if_available_else_ask";
     const lookups = {
       companyType: { via: "operations.fieldCatalog", resource: "companies", field: "companyType", labels: true, note: "map the user wording to one returned label; never hardcode ids" },
@@ -22413,16 +21466,16 @@ async function prepareCrmWrite(resource, input, http) {
   }
   let next = null;
   const isInactive = (d) => d.isActive === false || d.isActive === 0;
-  const dups = _nullishCoalesce(_optionalChain([contacts, 'optionalAccess', _245 => _245.duplicates]), () => ( []));
+  const dups = _nullishCoalesce(_optionalChain([contacts, 'optionalAccess', _224 => _224.duplicates]), () => ( []));
   const sameCompany = companyID === null ? dups : dups.filter((d) => d.companyID === companyID);
   const elsewhere = companyID === null ? [] : dups.filter((d) => d.companyID !== companyID && !isInactive(d));
   if (input.intent === "add_contact" && sameCompany.length === 0 && elsewhere.length > 0) {
-    needsInput.push({ field: "contact", why: `a contact with this ${_nullishCoalesce(_optionalChain([contacts, 'optionalAccess', _246 => _246.matchedBy]), () => ( "identity"))} is active at another company: update it, move it with contacts.moveToCompany, or confirm a second record`, source: "policy", lookup: { duplicates: elsewhere }, research: "ask" });
+    needsInput.push({ field: "contact", why: `a contact with this ${_nullishCoalesce(_optionalChain([contacts, 'optionalAccess', _225 => _225.matchedBy]), () => ( "identity"))} is active at another company: update it, move it with contacts.moveToCompany, or confirm a second record`, source: "policy", lookup: { duplicates: elsewhere }, research: "ask" });
   }
   if (needsInput.length === 0) {
     const dup = sameCompany[0];
     if (input.intent === "create_company") next = status === "matched" ? { operation: "companies.update", note: "the company already exists: update it instead of creating" } : { operation: "companies.create", note: 'then re-run with intent add_contact: the vendor auto-creates a "Primary Address" location (rename it with company_locations.update; locations cannot be deleted via the API)' };
-    else if (input.intent === "add_contact") next = dup ? { operation: "contacts.update", note: `a contact already matches by ${_nullishCoalesce(_optionalChain([contacts, 'optionalAccess', _247 => _247.matchedBy]), () => ( "id"))} (id ${String(dup.id)}): update it, or move it with contacts.moveToCompany if it belongs to another company` } : { operation: "contacts.create", note: `set companyID ${String(companyID)} and companyLocationID ${String(_optionalChain([locations, 'optionalAccess', _248 => _248.pick, 'access', _249 => _249.locationID]))}` };
+    else if (input.intent === "add_contact") next = dup ? { operation: "contacts.update", note: `a contact already matches by ${_nullishCoalesce(_optionalChain([contacts, 'optionalAccess', _226 => _226.matchedBy]), () => ( "id"))} (id ${String(dup.id)}): update it, or move it with contacts.moveToCompany if it belongs to another company` } : { operation: "contacts.create", note: `set companyID ${String(companyID)} and companyLocationID ${String(_optionalChain([locations, 'optionalAccess', _227 => _227.pick, 'access', _228 => _228.locationID]))}` };
     else if (input.intent === "update_contact") next = { operation: "contacts.update", note: "send only the changed fields" };
     else next = { operation: "companies.update", note: "send only the changed fields" };
   }
@@ -22542,7 +21595,7 @@ function validateUnbilledWorkOptions(companyId, opts) {
 var OP3 = "companies.unbilledWork";
 function unbilledWorkPartStatus(key, conditions, items) {
   if (items.length !== 0) return { status: "ok" };
-  const stamp = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _250 => _250[key], 'optionalAccess', _251 => _251.query]), conditions);
+  const stamp = blindStampFor(_optionalChain([BLIND_SURFACE_STAMPS, 'access', _229 => _229[key], 'optionalAccess', _230 => _230.query]), conditions);
   if (stamp !== void 0) return { status: "blind", blindSurface: stamp, note: stamp.note };
   return {
     status: "ok",
@@ -22792,7 +21845,7 @@ var CompaniesResource = class extends BaseResource {
   }
   /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
   async get(id, opts = {}) {
-    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _252 => _252.fresh]) === true);
+    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _231 => _231.fresh]) === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -22930,7 +21983,7 @@ function validateFetchManyItems(items, cap, opName = "fetchMany", capRef = `FETC
     }
     try {
       parseIdentifier(item.id, `${at}.id`);
-    } catch (e19) {
+    } catch (e18) {
       if (typeof item.id === "string") {
         problems.push(
           `${at}.id: "${item.id}" is not a vendor numeric id \u2014 non-numeric string identifiers are operations.resolveAny territory (the resource's findBy* helpers)`
@@ -22949,8 +22002,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', _253 => _253.fieldCheck]) !== false) {
-        const authoritative = _nullishCoalesce(_optionalChain([validation, 'optionalAccess', _254 => _254.fieldSetsByResource, 'optionalAccess', _255 => _255.get, 'call', _256 => _256(resourceKey)]), () => ( fields));
+      if (_optionalChain([validation, 'optionalAccess', _232 => _232.fieldCheck]) !== false) {
+        const authoritative = _nullishCoalesce(_optionalChain([validation, 'optionalAccess', _233 => _233.fieldSetsByResource, 'optionalAccess', _234 => _234.get, 'call', _235 => _235(resourceKey)]), () => ( fields));
         for (const f of item.fields) {
           if (!authoritative.includes(f)) {
             problems.push(
@@ -23056,7 +22109,7 @@ function project3(value, fields) {
   return out;
 }
 function resourcePathOf(key, holder) {
-  const path = _optionalChain([holder, 'optionalAccess', _257 => _257.resourcePath]);
+  const path = _optionalChain([holder, 'optionalAccess', _236 => _236.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)."
@@ -23669,7 +22722,7 @@ var stampPart = (key, raw, conditions, extraNotes) => {
     status: st.status,
     blindSurface: st.blindSurface,
     note: [st.note, ..._nullishCoalesce(extraNotes, () => ( []))].filter(Boolean).join(" | ") || void 0,
-    emptyReason: raw.items.length === 0 && st.status === "ok" ? _optionalChain([EMPTY_REASON_STAMPS, 'access', _258 => _258[key], 'optionalAccess', _259 => _259.query]) : void 0
+    emptyReason: raw.items.length === 0 && st.status === "ok" ? _optionalChain([EMPTY_REASON_STAMPS, 'access', _237 => _237[key], 'optionalAccess', _238 => _238.query]) : void 0
   };
 };
 function appendWiresNote(wires, note) {
@@ -23734,7 +22787,7 @@ async function resolveContractType(ctx, contractType) {
   if (contractType > 0) {
     ctx.wires.issued += 1;
     try {
-      contractTypeLabel = await _asyncNullishCoalesce(await _asyncOptionalChain([(await readPicklists(ctx.http, "/V1.0/Contracts", ctx.OP)), 'access', async _260 => _260.get, 'call', async _261 => _261("contractType"), 'optionalAccess', async _262 => _262.get, 'call', async _263 => _263(contractType)]), async () => ( null));
+      contractTypeLabel = await _asyncNullishCoalesce(await _asyncOptionalChain([(await readPicklists(ctx.http, "/V1.0/Contracts", ctx.OP)), 'access', async _239 => _239.get, 'call', async _240 => _240("contractType"), 'optionalAccess', async _241 => _241.get, 'call', async _242 => _242(contractType)]), async () => ( null));
     } catch (err) {
       if (!(err instanceof AutotaskError)) throw err;
     }
@@ -23745,7 +22798,7 @@ async function resolveContractType(ctx, contractType) {
   return { contractTypeLabel, contractTypeKnown, isBlockHours, isTimeAndMaterials };
 }
 async function fetchRoot(ctx, resource) {
-  const contractCached = _optionalChain([ctx, 'access', _264 => _264.rawHttp, 'access', _265 => _265.readCache, 'optionalAccess', _266 => _266.get, 'call', _267 => _267(`/V1.0/Contracts/${ctx.id}`)]) !== void 0;
+  const contractCached = _optionalChain([ctx, 'access', _243 => _243.rawHttp, 'access', _244 => _244.readCache, 'optionalAccess', _245 => _245.get, 'call', _246 => _246(`/V1.0/Contracts/${ctx.id}`)]) !== void 0;
   const contract = await resource.get(ctx.id);
   ctx.wires.issued += 1;
   if (!contractCached) ctx.wires.requests += 1;
@@ -23960,10 +23013,10 @@ async function fetchSubscriptions(ctx, cis) {
   const labels = await readSubscriptionLabels(ctx, subscriptions);
   for (const x of subscriptions) {
     const sid = num(x["id"]);
-    const periodLabel = _optionalChain([labels, 'optionalAccess', _268 => _268.get, 'call', _269 => _269("periodType"), 'optionalAccess', _270 => _270.get, 'call', _271 => _271(num(x["periodType"]))]);
+    const periodLabel = _optionalChain([labels, 'optionalAccess', _247 => _247.get, 'call', _248 => _248("periodType"), 'optionalAccess', _249 => _249.get, 'call', _250 => _250(num(x["periodType"]))]);
     subFactor.set(sid, periodMonthlyFactor(x["periodType"], periodLabel));
     if (isOneTimePeriod(x["periodType"], periodLabel)) oneTimeSubs.add(sid);
-    const statusLabel = _optionalChain([labels, 'optionalAccess', _272 => _272.get, 'call', _273 => _273("status"), 'optionalAccess', _274 => _274.get, 'call', _275 => _275(num(x["status"]))]);
+    const statusLabel = _optionalChain([labels, 'optionalAccess', _251 => _251.get, 'call', _252 => _252("status"), 'optionalAccess', _253 => _253.get, 'call', _254 => _254(num(x["status"]))]);
     const notActive = statusLabel !== void 0 ? NOT_ACTIVE_LABEL_RE.test(statusLabel) : labels === null && SUBSCRIPTION_NOT_ACTIVE_STATUS_IDS.has(num(x["status"]));
     if (notActive) cancelledSubs.add(sid);
   }
@@ -24664,7 +23717,7 @@ var ContractsResource = class extends BaseResource {
   }
   /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
   async get(id, opts = {}) {
-    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _276 => _276.fresh]) === true);
+    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _255 => _255.fresh]) === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -24700,7 +23753,7 @@ var ContractsResource = class extends BaseResource {
   /** Search Contract records: bounded contains on contractName (no vendor free-text search exists);
    * limit defaults to 25, max 500. */
   async search(query, opts) {
-    return this.searchBase(query, { limit: _optionalChain([opts, 'optionalAccess', _277 => _277.limit]) });
+    return this.searchBase(query, { limit: _optionalChain([opts, 'optionalAccess', _256 => _256.limit]) });
   }
   /** Node-parity special op (hand-written in src/resources/special/contracts.ts). */
   profitability(id, opts) {
@@ -24740,28 +23793,28 @@ async function pdf(_resource, id, http) {
   return decodeFileData(res);
 }
 async function windowQuery2(_resource, kind, http, opts) {
-  const now = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _278 => _278.now]), () => ( /* @__PURE__ */ new Date()));
-  const tz = _optionalChain([opts, 'optionalAccess', _279 => _279.tz]) === void 0 ? void 0 : validateZone(opts.tz, `invoices.${kind}`);
+  const now = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _257 => _257.now]), () => ( /* @__PURE__ */ new Date()));
+  const tz = _optionalChain([opts, 'optionalAccess', _258 => _258.tz]) === void 0 ? void 0 : validateZone(opts.tz, `invoices.${kind}`);
   return dateWindowQuery(
     http,
     "/V1.0/Invoices/query",
     "invoiceDateTime",
     kind,
-    clampWindowLimit(_optionalChain([opts, 'optionalAccess', _280 => _280.limit])),
+    clampWindowLimit(_optionalChain([opts, 'optionalAccess', _259 => _259.limit])),
     `invoices.${kind}`,
     now,
     tz
   );
 }
 async function customRange2(_resource, from, to, http, opts) {
-  const zone = _optionalChain([opts, 'optionalAccess', _281 => _281.tz]) === void 0 ? void 0 : validateZone(opts.tz, "invoices.customRange");
+  const zone = _optionalChain([opts, 'optionalAccess', _260 => _260.tz]) === void 0 ? void 0 : validateZone(opts.tz, "invoices.customRange");
   return customRangeQuery(
     http,
     "/V1.0/Invoices/query",
     "invoiceDateTime",
     from,
     to,
-    clampWindowLimit(_optionalChain([opts, 'optionalAccess', _282 => _282.limit])),
+    clampWindowLimit(_optionalChain([opts, 'optionalAccess', _261 => _261.limit])),
     "invoices.customRange",
     zone
   );
@@ -24793,7 +23846,7 @@ var InvoicesResource = class extends BaseResource {
   }
   /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
   async get(id, opts = {}) {
-    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _283 => _283.fresh]) === true);
+    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _262 => _262.fresh]) === true);
   }
   /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
    * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
@@ -24907,7 +23960,7 @@ var OrganizationalLevel1sResource = class extends BaseResource {
   }
   /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
   async get(id, opts = {}) {
-    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _284 => _284.fresh]) === true);
+    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _263 => _263.fresh]) === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -24958,7 +24011,7 @@ var OrganizationalLevel2sResource = class extends BaseResource {
   }
   /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
   async get(id, opts = {}) {
-    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _285 => _285.fresh]) === true);
+    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _264 => _264.fresh]) === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -25009,7 +24062,7 @@ var OrganizationalLevelAssociationsResource = class extends BaseResource {
   }
   /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
   async get(id, opts = {}) {
-    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _286 => _286.fresh]) === true);
+    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _265 => _265.fresh]) === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -25081,7 +24134,7 @@ async function transferOwnership(_resource, companyIds, destinationResourceId, h
   if (typeof destination === "number" && destination < 1) {
     throw new AutotaskConfigError("transferOwnership: destinationResourceId must be a positive integer");
   }
-  const dryRun = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _287 => _287.dryRun]), () => ( true));
+  const dryRun = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _266 => _266.dryRun]), () => ( true));
   const changes = [];
   const applied = [];
   for (const id of ids2) {
@@ -25090,7 +24143,7 @@ async function transferOwnership(_resource, companyIds, destinationResourceId, h
         method: "GET",
         path: `/V1.0/Companies/${id}`,
         operation: "resources.transferOwnership",
-        maxRetries: _optionalChain([opts, 'optionalAccess', _288 => _288.maxRetries])
+        maxRetries: _optionalChain([opts, 'optionalAccess', _267 => _267.maxRetries])
       });
       const company = unwrapItem(res, id, void 0, "company");
       const current = typeof company.ownerResourceID === "number" ? company.ownerResourceID : null;
@@ -25101,7 +24154,7 @@ async function transferOwnership(_resource, companyIds, destinationResourceId, h
           path: "/V1.0/Companies",
           body: { id, ownerResourceID: destination },
           operation: "resources.transferOwnership",
-          maxRetries: _optionalChain([opts, 'optionalAccess', _289 => _289.maxRetries])
+          maxRetries: _optionalChain([opts, 'optionalAccess', _268 => _268.maxRetries])
         });
         unwrapOperation(update);
         applied.push(id);
@@ -25170,7 +24223,7 @@ var ResourcesResource = class extends BaseResource {
   }
   /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
   async get(id, opts = {}) {
-    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _290 => _290.fresh]) === true);
+    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _269 => _269.fresh]) === true);
   }
   /** Update a record (PUT on the COLLECTION — the vendored spec's item path is GET-only; the vendor
    * keys the record by the id in the body). The vendor validates the FULL model on this route (V2), so a
@@ -25198,7 +24251,7 @@ var ResourcesResource = class extends BaseResource {
   /** Search Resource records: bounded contains on firstName + lastName (no vendor free-text search exists);
    * limit defaults to 25, max 500. */
   async search(query, opts) {
-    return this.searchBase(query, { limit: _optionalChain([opts, 'optionalAccess', _291 => _291.limit]) });
+    return this.searchBase(query, { limit: _optionalChain([opts, 'optionalAccess', _270 => _270.limit]) });
   }
   /** Node-parity special op (hand-written in src/resources/special/resources.ts). */
   transferOwnership(sourceResourceIds, destinationResourceId, opts = {}) {
@@ -25230,10 +24283,10 @@ function uiHostFromBase(baseUrl) {
   let hostname;
   try {
     hostname = new URL(baseUrl).hostname.toLowerCase();
-  } catch (e20) {
+  } catch (e19) {
     return void 0;
   }
-  const n = _optionalChain([REST_HOST, 'access', _292 => _292.exec, 'call', _293 => _293(hostname), 'optionalAccess', _294 => _294[1]]);
+  const n = _optionalChain([REST_HOST, 'access', _271 => _271.exec, 'call', _272 => _272(hostname), 'optionalAccess', _273 => _273[1]]);
   return n === void 0 ? void 0 : `ww${n}.autotask.net`;
 }
 function buildUiLink(input) {
@@ -25286,7 +24339,7 @@ async function postedStateOf(http, entries, op, beforeRequest) {
   let incomplete = false;
   for (let c = 0; c < ids2.length; c += FETCH_BY_IDS_CHUNK_SIZE) {
     const chunk = ids2.slice(c, c + FETCH_BY_IDS_CHUNK_SIZE);
-    _optionalChain([beforeRequest, 'optionalCall', _295 => _295()]);
+    _optionalChain([beforeRequest, 'optionalCall', _274 => _274()]);
     const res = await http.request({
       method: "POST",
       idempotent: true,
@@ -25333,11 +24386,11 @@ async function queryTimeEntries(_resource, filter, limit, operation, http, curso
   return { items, hasMore: pageDetails.nextPageUrl != null, nextCursor: _nullishCoalesce(pageDetails.nextPageUrl, () => ( null)) };
 }
 function pagingOpts(opts, OP9) {
-  if (_optionalChain([opts, 'optionalAccess', _296 => _296.countOnly]) !== void 0 && typeof opts.countOnly !== "boolean") {
+  if (_optionalChain([opts, 'optionalAccess', _275 => _275.countOnly]) !== void 0 && typeof opts.countOnly !== "boolean") {
     throw new AutotaskConfigError(`${OP9}: countOnly must be a boolean`, { operation: OP9 });
   }
-  const countOnly = _optionalChain([opts, 'optionalAccess', _297 => _297.countOnly]) === true;
-  const cursor = _optionalChain([opts, 'optionalAccess', _298 => _298.cursor]);
+  const countOnly = _optionalChain([opts, 'optionalAccess', _276 => _276.countOnly]) === true;
+  const cursor = _optionalChain([opts, 'optionalAccess', _277 => _277.cursor]);
   if (cursor !== void 0 && (typeof cursor !== "string" || cursor.trim() === "")) {
     throw new AutotaskConfigError(`${OP9}: cursor must be the non-empty nextCursor of a previous call`, { operation: OP9 });
   }
@@ -25347,9 +24400,9 @@ function pagingOpts(opts, OP9) {
   if (cursor !== void 0 && countOnly) {
     throw new AutotaskConfigError(`${OP9}: cursor does not apply with countOnly (countOnly reads every page itself)`, { operation: OP9 });
   }
-  const budget = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _299 => _299.maxVendorCalls]), () => ( COUNT_BUDGET_DEFAULT));
+  const budget = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _278 => _278.maxVendorCalls]), () => ( COUNT_BUDGET_DEFAULT));
   if (!Number.isInteger(budget) || budget < 1 || budget > COUNT_BUDGET_MAX) {
-    throw new AutotaskConfigError(`${OP9}: maxVendorCalls must be an integer 1-${COUNT_BUDGET_MAX} (got ${String(_optionalChain([opts, 'optionalAccess', _300 => _300.maxVendorCalls]))})`, { operation: OP9 });
+    throw new AutotaskConfigError(`${OP9}: maxVendorCalls must be an integer 1-${COUNT_BUDGET_MAX} (got ${String(_optionalChain([opts, 'optionalAccess', _279 => _279.maxVendorCalls]))})`, { operation: OP9 });
   }
   return { ...cursor === void 0 ? {} : { cursor }, countOnly, budget };
 }
@@ -25420,18 +24473,18 @@ async function countPostedState(http, filter, OP9, budget, window) {
   return { window, total: states.size, postedCount, unpostedCount: states.size - postedCount, vendorCalls: issued, estimate, budget };
 }
 async function windowQuery3(_resource, kind, http, opts) {
-  const now = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _301 => _301.now]), () => ( /* @__PURE__ */ new Date()));
-  const tz = _optionalChain([opts, 'optionalAccess', _302 => _302.tz]) === void 0 ? void 0 : validateZone(opts.tz, `time_entries.${kind}`);
+  const now = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _280 => _280.now]), () => ( /* @__PURE__ */ new Date()));
+  const tz = _optionalChain([opts, 'optionalAccess', _281 => _281.tz]) === void 0 ? void 0 : validateZone(opts.tz, `time_entries.${kind}`);
   const { from, to } = dateOnlyWindowBounds(kind, now, tz);
   const filter = [
     { field: "dateWorked", op: "gte", value: from },
     { field: "dateWorked", op: "lte", value: to }
   ];
-  const { items } = await queryTimeEntries(_resource, filter, clampWindowLimit(_optionalChain([opts, 'optionalAccess', _303 => _303.limit])), `time_entries.${kind}`, http);
+  const { items } = await queryTimeEntries(_resource, filter, clampWindowLimit(_optionalChain([opts, 'optionalAccess', _282 => _282.limit])), `time_entries.${kind}`, http);
   return items;
 }
 async function customRange3(_resource, from, to, http, opts) {
-  if (_optionalChain([opts, 'optionalAccess', _304 => _304.tz]) !== void 0) validateZone(opts.tz, "time_entries.customRange");
+  if (_optionalChain([opts, 'optionalAccess', _283 => _283.tz]) !== void 0) validateZone(opts.tz, "time_entries.customRange");
   const fromB = customRangeDay(from, "from", void 0, "customRange");
   const toB = customRangeDay(to, "to", void 0, "customRange");
   if (fromB.ms > toB.ms) {
@@ -25442,7 +24495,7 @@ async function customRange3(_resource, from, to, http, opts) {
     { field: "dateWorked", op: "gte", value: iso2(fromB.ms) },
     { field: "dateWorked", op: "lte", value: iso2(toEndMs) }
   ];
-  const { items } = await queryTimeEntries(_resource, filter, clampWindowLimit(_optionalChain([opts, 'optionalAccess', _305 => _305.limit])), "time_entries.customRange", http);
+  const { items } = await queryTimeEntries(_resource, filter, clampWindowLimit(_optionalChain([opts, 'optionalAccess', _284 => _284.limit])), "time_entries.customRange", http);
   return items;
 }
 async function postedStateQuery(_resource, mode, http, opts) {
@@ -25450,16 +24503,16 @@ async function postedStateQuery(_resource, mode, http, opts) {
   const paging = pagingOpts(opts, operation);
   const window = { from: null, to: null };
   const filter = [];
-  const fromB = _optionalChain([opts, 'optionalAccess', _306 => _306.dateFrom]) === void 0 ? void 0 : customRangeDay(opts.dateFrom, "from", void 0, operation);
-  const toB = _optionalChain([opts, 'optionalAccess', _307 => _307.dateTo]) === void 0 ? void 0 : customRangeDay(opts.dateTo, "to", void 0, operation);
+  const fromB = _optionalChain([opts, 'optionalAccess', _285 => _285.dateFrom]) === void 0 ? void 0 : customRangeDay(opts.dateFrom, "from", void 0, operation);
+  const toB = _optionalChain([opts, 'optionalAccess', _286 => _286.dateTo]) === void 0 ? void 0 : customRangeDay(opts.dateTo, "to", void 0, operation);
   if (fromB && toB && fromB.ms > toB.ms) {
     throw new AutotaskConfigError(`${operation}: dateFrom (${iso2(fromB.ms)}) must not be after dateTo (${iso2(toB.ms)})`, { operation });
   }
   if (fromB) filter.push({ field: "dateWorked", op: "gte", value: window.from = iso2(fromB.ms) });
   if (toB) filter.push({ field: "dateWorked", op: "lte", value: window.to = iso2(toB.ms + DAY_MS2 - 1) });
-  if (_optionalChain([opts, 'optionalAccess', _308 => _308.ticketID]) !== void 0) filter.push({ field: "ticketID", op: "eq", value: opts.ticketID });
+  if (_optionalChain([opts, 'optionalAccess', _287 => _287.ticketID]) !== void 0) filter.push({ field: "ticketID", op: "eq", value: opts.ticketID });
   if (paging.countOnly) return countPostedState(http, filter, operation, paging.budget, window);
-  const read = await queryTimeEntries(_resource, filter, clampWindowLimit(_optionalChain([opts, 'optionalAccess', _309 => _309.limit])), operation, http, paging.cursor);
+  const read = await queryTimeEntries(_resource, filter, clampWindowLimit(_optionalChain([opts, 'optionalAccess', _288 => _288.limit])), operation, http, paging.cursor);
   const { states, incomplete } = await postedStateOf(http, read.items, operation);
   const items = read.items.filter((e) => states.get(e.id) === mode);
   const approvedCount = items.filter(isApproved).length;
@@ -25469,7 +24522,7 @@ async function postedStateQuery(_resource, mode, http, opts) {
 async function postedWithin(_resource, from, to, http, opts, opLabel = "time_entries.postedWithin") {
   const OP9 = opLabel;
   const paging = pagingOpts(opts, OP9);
-  if (_optionalChain([opts, 'optionalAccess', _310 => _310.tz]) !== void 0) validateZone(opts.tz, OP9);
+  if (_optionalChain([opts, 'optionalAccess', _289 => _289.tz]) !== void 0) validateZone(opts.tz, OP9);
   const fromB = customRangeDay(from, "from", void 0, OP9);
   const toB = customRangeDay(to, "to", void 0, OP9);
   if (fromB.ms > toB.ms) {
@@ -25480,11 +24533,11 @@ async function postedWithin(_resource, from, to, http, opts, opLabel = "time_ent
     { field: "dateWorked", op: "gte", value: iso2(fromB.ms) },
     { field: "dateWorked", op: "lte", value: iso2(windowToMs) }
   ];
-  if (_optionalChain([opts, 'optionalAccess', _311 => _311.ticketID]) !== void 0) filter.push({ field: "ticketID", op: "eq", value: opts.ticketID });
-  if (_optionalChain([opts, 'optionalAccess', _312 => _312.resourceID]) !== void 0) filter.push({ field: "resourceID", op: "eq", value: opts.resourceID });
+  if (_optionalChain([opts, 'optionalAccess', _290 => _290.ticketID]) !== void 0) filter.push({ field: "ticketID", op: "eq", value: opts.ticketID });
+  if (_optionalChain([opts, 'optionalAccess', _291 => _291.resourceID]) !== void 0) filter.push({ field: "resourceID", op: "eq", value: opts.resourceID });
   const window = { from: iso2(fromB.ms), to: iso2(windowToMs) };
   if (paging.countOnly) return countPostedState(http, filter, OP9, paging.budget, window);
-  const { items, hasMore, nextCursor } = await queryTimeEntries(_resource, filter, clampWindowLimit(_optionalChain([opts, 'optionalAccess', _313 => _313.limit])), OP9, http, paging.cursor);
+  const { items, hasMore, nextCursor } = await queryTimeEntries(_resource, filter, clampWindowLimit(_optionalChain([opts, 'optionalAccess', _292 => _292.limit])), OP9, http, paging.cursor);
   const { states, incomplete } = await postedStateOf(http, items, OP9);
   let postedCount = 0;
   let unpostedCount = 0;
@@ -25492,7 +24545,7 @@ async function postedWithin(_resource, from, to, http, opts, opLabel = "time_ent
     if (state === "posted") postedCount += 1;
     else unpostedCount += 1;
   }
-  const keep = _optionalChain([opts, 'optionalAccess', _314 => _314.posted]) === void 0 ? void 0 : opts.posted ? "posted" : "unposted";
+  const keep = _optionalChain([opts, 'optionalAccess', _293 => _293.posted]) === void 0 ? void 0 : opts.posted ? "posted" : "unposted";
   return {
     items: keep === void 0 ? items : items.filter((e) => states.get(e.id) === keep),
     postedCount,
@@ -25942,7 +24995,7 @@ function sameValue(a, b) {
 async function readTicket(http, id, retries, operation) {
   try {
     const res = await http.request({ method: "GET", path: `/V1.0/Tickets/${id}`, operation, maxRetries: retries });
-    const item = _optionalChain([res, 'optionalAccess', _315 => _315.item]);
+    const item = _optionalChain([res, 'optionalAccess', _294 => _294.item]);
     return _nullishCoalesce(item, () => ( null));
   } catch (e) {
     if (isAutotaskError(e) && (e.httpStatus === 404 || e.code === "NOT_FOUND")) return null;
@@ -25987,7 +25040,7 @@ async function preview(http, spec, sourceId, toTicketId, opts) {
   const facts = {
     closedStatus: { closedIds: closedStatus.closedIds, source: closedStatus.source, note: closedStatus.note },
     sourceTicketId,
-    sourceCompanyID: _nullishCoalesce(_optionalChain([origin, 'optionalAccess', _316 => _316.companyID]), () => ( null)),
+    sourceCompanyID: _nullishCoalesce(_optionalChain([origin, 'optionalAccess', _295 => _295.companyID]), () => ( null)),
     targetCompanyID: _nullishCoalesce(target.companyID, () => ( null)),
     companyChanged: origin === null ? null : origin.companyID !== target.companyID,
     contractChanged: origin === null ? null : (_nullishCoalesce(origin.contractID, () => ( null))) !== (_nullishCoalesce(target.contractID, () => ( null)))
@@ -26105,7 +25158,7 @@ var CONTRACT_SCOPED = ["contractID", "contractServiceID", "contractServiceBundle
 async function readTimeEntry(http, id, retries) {
   try {
     const res = await http.request({ method: "GET", path: `/V1.0/TimeEntries/${id}`, operation: OP6, maxRetries: retries });
-    return _nullishCoalesce(_optionalChain([res, 'optionalAccess', _317 => _317.item]), () => ( null));
+    return _nullishCoalesce(_optionalChain([res, 'optionalAccess', _296 => _296.item]), () => ( null));
   } catch (e) {
     if (isAutotaskError(e) && (e.httpStatus === 404 || e.code === "NOT_FOUND")) return null;
     throw e;
@@ -26122,7 +25175,7 @@ async function checkSource({ http, source, sourceId, toTicketId, retries }) {
   let billing;
   try {
     billing = await queryRows(http, "BillingItems", [{ field: "timeEntryID", op: "eq", value: sourceId }], OP6, retries);
-  } catch (e21) {
+  } catch (e20) {
     throw refuse("MOVE_BLOCKED_BILLED", `${OP6}: the billing items of time entry ${sourceId} could not be read \u2014 refused (fails closed)`, ids2, OP6, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "billing state unreadable" } });
   }
   if (billing.some((b) => b.invoiceID || b.postedDate)) {
@@ -26324,17 +25377,17 @@ async function recentTickets(_resource, from, to, http, opts) {
   for (const [ticketID, g] of groups) {
     const t = tickets.get(ticketID);
     if (t === void 0) unresolvedTicketIDs.push(ticketID);
-    if (companyID !== void 0 && _optionalChain([t, 'optionalAccess', _318 => _318.companyID]) !== companyID) {
+    if (companyID !== void 0 && _optionalChain([t, 'optionalAccess', _297 => _297.companyID]) !== companyID) {
       if (t !== void 0) excludedTickets += 1;
       continue;
     }
     items.push({
       ticketID,
-      ..._optionalChain([t, 'optionalAccess', _319 => _319.ticketNumber]) !== void 0 ? { ticketNumber: t.ticketNumber } : {},
-      ..._optionalChain([t, 'optionalAccess', _320 => _320.title]) !== void 0 ? { title: t.title } : {},
-      ..._optionalChain([t, 'optionalAccess', _321 => _321.status]) !== void 0 ? { status: t.status } : {},
-      ..._optionalChain([t, 'optionalAccess', _322 => _322.assignedResourceID]) !== void 0 ? { assignedResourceID: t.assignedResourceID } : {},
-      ..._optionalChain([t, 'optionalAccess', _323 => _323.companyID]) !== void 0 ? { companyID: t.companyID } : {},
+      ..._optionalChain([t, 'optionalAccess', _298 => _298.ticketNumber]) !== void 0 ? { ticketNumber: t.ticketNumber } : {},
+      ..._optionalChain([t, 'optionalAccess', _299 => _299.title]) !== void 0 ? { title: t.title } : {},
+      ..._optionalChain([t, 'optionalAccess', _300 => _300.status]) !== void 0 ? { status: t.status } : {},
+      ..._optionalChain([t, 'optionalAccess', _301 => _301.assignedResourceID]) !== void 0 ? { assignedResourceID: t.assignedResourceID } : {},
+      ..._optionalChain([t, 'optionalAccess', _302 => _302.companyID]) !== void 0 ? { companyID: t.companyID } : {},
       entryCount: g.entryCount,
       totalHours: Math.round(g.totalHours * 100) / 100,
       lastWorked: g.lastWorked
@@ -26378,7 +25431,7 @@ var TimeEntriesResource = class extends BaseResource {
   }
   /** Get one record by id (item envelope; item: null → NotFoundError). `fresh: true` bypasses the read-cache lookup and refreshes the entry (issue #250). */
   async get(id, opts = {}) {
-    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _324 => _324.fresh]) === true);
+    return this.getGlobal(id, _optionalChain([opts, 'optionalAccess', _303 => _303.fresh]) === true);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -26698,19 +25751,4 @@ var TimeEntriesResource = class extends BaseResource {
 
 
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-exports.AUTH_HEADERS = AUTH_HEADERS; exports.buildAuthHeaders = buildAuthHeaders; exports.withAuthHeaders = withAuthHeaders; exports.AutotaskError = AutotaskError; exports.AutotaskConfigError = AutotaskConfigError; exports.isAutotaskError = isAutotaskError; 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.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.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.MoveRefusedError = MoveRefusedError; exports.READ_CACHE_MAX_ENTRIES = READ_CACHE_MAX_ENTRIES; exports.ReadCache = ReadCache; exports.ZONE_CATALOG = ZONE_CATALOG; exports.ZONES = ZONES; exports.DEFAULT_ZONE = DEFAULT_ZONE; exports.zoneUrl = zoneUrl; exports.resolveBaseUrl = resolveBaseUrl; 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.MAINTENANCE_WINDOW_MAX_MS = MAINTENANCE_WINDOW_MAX_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.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.resolveCredentials = resolveCredentials; exports.buildReadCache = buildReadCache; exports.resolveConfig = resolveConfig; exports.IDEMPOTENT_METHODS = IDEMPOTENT_METHODS; 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.normalizeInValues = normalizeInValues; exports.assertNoRelationLeaf = assertNoRelationLeaf; exports.buildUrl = buildUrl; exports.cursorToPath = cursorToPath; exports.buildQueryBody = buildQueryBody; exports.buildQueryRequest = buildQueryRequest; exports.runWithSignal = runWithSignal; exports.RELATIONSHIP_ZONE = RELATIONSHIP_ZONE; exports.RELATIONSHIP_MAP = RELATIONSHIP_MAP; exports.DELETE_BOUNDARY_NOTES = DELETE_BOUNDARY_NOTES; exports.MARKER_FIELDS = MARKER_FIELDS; exports.BLIND_SURFACE_INVENTORY = BLIND_SURFACE_INVENTORY; exports.REACHABILITY_PROBE_DEFAULTS = REACHABILITY_PROBE_DEFAULTS; exports.CREATE_GUIDANCE = CREATE_GUIDANCE; exports.unwrapItems = unwrapItems; exports.unwrapItem = unwrapItem; exports.unwrapQueryCount = unwrapQueryCount; exports.unwrapOperation = unwrapOperation; exports.passthrough = passthrough; exports.HttpClient = HttpClient; exports.BOUNDED_QUERY_MAX_LIMIT = BOUNDED_QUERY_MAX_LIMIT; exports.buildDryRunResult = buildDryRunResult; exports.mergePartialBody = mergePartialBody; exports.effectiveRequiredFields = effectiveRequiredFields; 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.MODEL_DATE_FIELDS = MODEL_DATE_FIELDS; exports.EXPAND_RESOURCE_NAMES_MAX_IDS = EXPAND_RESOURCE_NAMES_MAX_IDS; exports.expandResourceNames = expandResourceNames; exports.ENTITY_TYPE_TO_RESOURCE = ENTITY_TYPE_TO_RESOURCE; exports.resourceForEntityType = resourceForEntityType; exports.isEnumerableResource = isEnumerableResource; exports.WORKFLOW_RESOURCES = WORKFLOW_RESOURCES; exports.MAX_FIELD_CATALOG_WIRE = MAX_FIELD_CATALOG_WIRE; exports.FIELD_CATALOG_HONESTY_NOTE = FIELD_CATALOG_HONESTY_NOTE; exports.MIN_FIELD_CATALOG_MAX_BYTES = MIN_FIELD_CATALOG_MAX_BYTES; exports.fieldCatalog = fieldCatalog; exports.PICKLIST_VALUE_NOT_SERVED_NOTE = PICKLIST_VALUE_NOT_SERVED_NOTE; exports.PICKLIST_CATALOG_UNAVAILABLE_NOTE = PICKLIST_CATALOG_UNAVAILABLE_NOTE; exports.TICKET_LABEL_FIELDS = TICKET_LABEL_FIELDS; exports.createNamePlan = createNamePlan; exports.addNameSibling = addNameSibling; exports.addLabelSibling = addLabelSibling; exports.vendorId = vendorId; exports.resolveLineOfBusinessChain = resolveLineOfBusinessChain; exports.resolveCompositeNames = resolveCompositeNames; exports.readNamesOpt = readNamesOpt; exports.labelRows = labelRows; exports.BaseResource = BaseResource; exports.BillingCodesResource = BillingCodesResource; exports.BillingItemsResource = BillingItemsResource; exports.isDateYMD = isDateYMD; exports.monthsInWindow = monthsInWindow; exports.dayAfter = dayAfter; exports.num = num; exports.collectFilterFieldNames = collectFilterFieldNames; exports.validateQueryFieldNames = validateQueryFieldNames; exports.findUnknownFieldNames = findUnknownFieldNames; exports.resolveTicketStatusSemantics = resolveTicketStatusSemantics; exports.openStatusFilter = openStatusFilter; exports.isClosedStatus = isClosedStatus; exports.CompaniesResource = CompaniesResource; exports.PROFITABILITY_MAX_WINDOW_MONTHS = PROFITABILITY_MAX_WINDOW_MONTHS; exports.SERVICE_LINE_FKS = SERVICE_LINE_FKS; exports.CHARGE_LINE_FKS = CHARGE_LINE_FKS; exports.billingLineType = billingLineType; exports.internalAmount = internalAmount; 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.readPicklists = readPicklists; exports.ContractsResource = ContractsResource; exports.InvoicesResource = InvoicesResource; exports.OrganizationalLevel1sResource = OrganizationalLevel1sResource; exports.OrganizationalLevel2sResource = OrganizationalLevel2sResource; exports.OrganizationalLevelAssociationsResource = OrganizationalLevelAssociationsResource; exports.ResourcesResource = ResourcesResource; exports.UI_LINK_ENTITIES = UI_LINK_ENTITIES; exports.buildUiLink = buildUiLink; exports.uiLink = uiLink; exports.refuse = refuse; exports.queryRows = queryRows; exports.runMove = runMove; exports.uiLinkFor = uiLinkFor; exports.TimeEntriesResource = TimeEntriesResource;
+exports.AUTH_HEADERS = AUTH_HEADERS; exports.buildAuthHeaders = buildAuthHeaders; exports.withAuthHeaders = withAuthHeaders; exports.AutotaskError = AutotaskError; exports.AutotaskConfigError = AutotaskConfigError; exports.isAutotaskError = isAutotaskError; 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.MaintenanceError = MaintenanceError; exports.HostPolicyDeniedError = HostPolicyDeniedError; exports.ResolutionError = ResolutionError; exports.PaginationLimitError = PaginationLimitError; exports.QueryTooLongError = QueryTooLongError; exports.parseVendorErrors = parseVendorErrors; exports.isDeterministicVendor500 = isDeterministicVendor500; exports.formatVendorDetail = formatVendorDetail; 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.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.MoveRefusedError = MoveRefusedError; exports.READ_CACHE_MAX_ENTRIES = READ_CACHE_MAX_ENTRIES; exports.REFERENCE_TTL_MS = REFERENCE_TTL_MS; exports.REFERENCE_ENTITIES = REFERENCE_ENTITIES; exports.FIELD_CACHE_KINDS = FIELD_CACHE_KINDS; exports.fieldKey = fieldKey; exports.readTtlFor = readTtlFor; exports.TtlCache = TtlCache; exports.ZONE_CATALOG = ZONE_CATALOG; exports.ZONES = ZONES; exports.DEFAULT_ZONE = DEFAULT_ZONE; exports.zoneUrl = zoneUrl; exports.resolveBaseUrl = resolveBaseUrl; 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.MAINTENANCE_WINDOW_MAX_MS = MAINTENANCE_WINDOW_MAX_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.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.resolveCredentials = resolveCredentials; exports.buildReadCache = buildReadCache; exports.resolveConfig = resolveConfig; exports.IDEMPOTENT_METHODS = IDEMPOTENT_METHODS; 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.normalizeInValues = normalizeInValues; exports.assertNoRelationLeaf = assertNoRelationLeaf; exports.buildUrl = buildUrl; exports.cursorToPath = cursorToPath; exports.buildQueryBody = buildQueryBody; exports.buildQueryRequest = buildQueryRequest; exports.runWithSignal = runWithSignal; exports.RELATIONSHIP_ZONE = RELATIONSHIP_ZONE; exports.RELATIONSHIP_MAP = RELATIONSHIP_MAP; exports.DELETE_BOUNDARY_NOTES = DELETE_BOUNDARY_NOTES; exports.MARKER_FIELDS = MARKER_FIELDS; exports.BLIND_SURFACE_INVENTORY = BLIND_SURFACE_INVENTORY; exports.REACHABILITY_PROBE_DEFAULTS = REACHABILITY_PROBE_DEFAULTS; exports.CREATE_GUIDANCE = CREATE_GUIDANCE; exports.unwrapItems = unwrapItems; exports.unwrapItem = unwrapItem; exports.unwrapQueryCount = unwrapQueryCount; exports.unwrapOperation = unwrapOperation; exports.passthrough = passthrough; exports.HttpClient = HttpClient; exports.BOUNDED_QUERY_MAX_LIMIT = BOUNDED_QUERY_MAX_LIMIT; exports.buildDryRunResult = buildDryRunResult; exports.mergePartialBody = mergePartialBody; exports.effectiveRequiredFields = effectiveRequiredFields; 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.MODEL_DATE_FIELDS = MODEL_DATE_FIELDS; exports.EXPAND_RESOURCE_NAMES_MAX_IDS = EXPAND_RESOURCE_NAMES_MAX_IDS; exports.expandResourceNames = expandResourceNames; exports.ENTITY_TYPE_TO_RESOURCE = ENTITY_TYPE_TO_RESOURCE; exports.resourceForEntityType = resourceForEntityType; exports.isEnumerableResource = isEnumerableResource; exports.WORKFLOW_RESOURCES = WORKFLOW_RESOURCES; exports.MAX_FIELD_CATALOG_WIRE = MAX_FIELD_CATALOG_WIRE; exports.FIELD_CATALOG_HONESTY_NOTE = FIELD_CATALOG_HONESTY_NOTE; exports.MIN_FIELD_CATALOG_MAX_BYTES = MIN_FIELD_CATALOG_MAX_BYTES; exports.fieldCatalog = fieldCatalog; exports.PICKLIST_VALUE_NOT_SERVED_NOTE = PICKLIST_VALUE_NOT_SERVED_NOTE; exports.PICKLIST_CATALOG_UNAVAILABLE_NOTE = PICKLIST_CATALOG_UNAVAILABLE_NOTE; exports.TICKET_LABEL_FIELDS = TICKET_LABEL_FIELDS; exports.createNamePlan = createNamePlan; exports.addNameSibling = addNameSibling; exports.addLabelSibling = addLabelSibling; exports.vendorId = vendorId; exports.resolveLineOfBusinessChain = resolveLineOfBusinessChain; exports.resolveCompositeNames = resolveCompositeNames; exports.readNamesOpt = readNamesOpt; exports.labelRows = labelRows; exports.BaseResource = BaseResource; exports.BillingCodesResource = BillingCodesResource; exports.BillingItemsResource = BillingItemsResource; exports.isDateYMD = isDateYMD; exports.monthsInWindow = monthsInWindow; exports.dayAfter = dayAfter; exports.num = num; exports.collectFilterFieldNames = collectFilterFieldNames; exports.validateQueryFieldNames = validateQueryFieldNames; exports.findUnknownFieldNames = findUnknownFieldNames; exports.resolveTicketStatusSemantics = resolveTicketStatusSemantics; exports.openStatusFilter = openStatusFilter; exports.isClosedStatus = isClosedStatus; exports.CompaniesResource = CompaniesResource; exports.PROFITABILITY_MAX_WINDOW_MONTHS = PROFITABILITY_MAX_WINDOW_MONTHS; exports.SERVICE_LINE_FKS = SERVICE_LINE_FKS; exports.CHARGE_LINE_FKS = CHARGE_LINE_FKS; exports.billingLineType = billingLineType; exports.internalAmount = internalAmount; 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.readPicklists = readPicklists; exports.ContractsResource = ContractsResource; exports.InvoicesResource = InvoicesResource; exports.OrganizationalLevel1sResource = OrganizationalLevel1sResource; exports.OrganizationalLevel2sResource = OrganizationalLevel2sResource; exports.OrganizationalLevelAssociationsResource = OrganizationalLevelAssociationsResource; exports.ResourcesResource = ResourcesResource; exports.UI_LINK_ENTITIES = UI_LINK_ENTITIES; exports.buildUiLink = buildUiLink; exports.uiLink = uiLink; exports.refuse = refuse; exports.queryRows = queryRows; exports.runMove = runMove; exports.uiLinkFor = uiLinkFor; exports.TimeEntriesResource = TimeEntriesResource;